view docs/nitros9guide/verify.refentry @ 2798:b70d93f8d7ce lwtools-port

Updated coco1/modules/makefile and coco3/modules/makefile to help resolve issues with i(x) and s(x) descriptors. Updated level1/coco1/modules/makefile & level2/coco3/modules/makefile so that correct values would be sent to assembler when building superdesc.asm for s(x).dd and i(x).dd descriptors.
author drencor-xeen
date Mon, 28 Jan 2013 16:13:05 -0600
parents 4dae346c4969
children
line wrap: on
line source

<refentry id="verify">
<refnamediv>
<refname>VERIFY</refname>
<refpurpose>Verify or update module header and CRC</refpurpose>
</refnamediv>

<refsynopsisdiv>
<cmdsynopsis>
<command>verify</command>
<arg choice="opt">
  <option>-u</option>
</arg>
</cmdsynopsis>
</refsynopsisdiv>

<refsect1><title>Description</title>

<para>
This command is used to verify that module header parity and CRC
value of one or more modules on a file (standard input) are correct.
Module(s) are read from standard input, and messages will be sent to
the standard error path.
</para>
<para>
If the -u (update) option is specified, the module(s) will be copied
to the standard output path with the module's header parity and CRC
values replaced with the computed values. A message will be
displayed to indicate whether or not the module's values matched
those computed by <command>verify</command>.
</para>
<para>
If the option is NOT specified, the module will not be copied to
standard output. <command>Verify</command> will only display a message to indicate
whether or not the module's header parity and CRC matched those
which were computed.
</para>
</refsect1>
<refsect1><title>Examples</title>
<screen>
OS9: verify &lt;EDIT &gt;NEWEDIT

Module's header parity is correct.
Calculated CRC matches module's.

OS9: verify &lt;myprograml &gt;myprogram2

Module's header parity is correct.
CRC does not match.

OS9: verify &lt;myprogram2

Module's header parity is correct.
Calculated CRC matches module's.

OS9: verify -u &lt;module &gt;temp
</screen>
</refsect1>
</refentry>