Mercurial > hg > Members > kono > nitros9-code

comparison docs/nitros9guide/ident.refentry @ 138:d9631713b7cd

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Split up the commands into individual files.
author roug
date Sun, 07 Jul 2002 08:58:56 +0000
parents
children c565a4700689
comparison
equal deleted inserted replaced
137:a6eb496dbc1e 138:d9631713b7cd
1 <refentry id="ident">
2 <refnamediv>
3 <refname>IDENT</refname>
4 <refpurpose>Print OS-9 module identification</refpurpose>
5 </refnamediv>
6
7 <refsynopsisdiv>
8 <cmdsynopsis>
9 <command>IDENT</command>
10 <arg choice="opt">
11 <option>-opts</option>
12 </arg>
13 <arg choice="plain">
14 &replstart;path&replend;
15 </arg>
16 <arg choice="opt">
17 <option>-opts</option>
18 </arg>
19 </cmdsynopsis>
20 </refsynopsisdiv>
21
22 <refsect1><title>Description</title>
23 <para>
24 This command is used to display header information from OS-9 memory
25 modules. IDENT displays the module size, CRC bytes (with verification), and for
26 program and device driver modules, the execution
27 offset and the permanent storage requirement bytes. IDENT will
28 print and interpret the type/language and attribute/revision bytes.
29 In addition, IDENT displays the byte immediately following the
30 module name since most Microware-supplied modules set this byte to
31 indicate the module edition.
32 </para>
33 <para>
34 IDENT will display all modules contained in a disk file. If the
35 &quot;-m&quot; option appears, &replstart;path&replend; is assumed to be a module in memory.
36 </para>
37 <para>
38 If the &quot;-v&quot; option is specified, the module CRC is not verified.
39 </para>
40 <para>
41 The &quot;-x&quot; option implies the pathlist begins in the execution
42 directory.
43 </para>
44 <para>
45 The &quot;-s&quot; option causes IDENT to display the. following module
46 information on a single line:
47 </para>
48 <simplelist>
49 <member>
50 Edition byte (first byte after module name)
51 </member>
52 <member>
53 Type/Language byte
54 </member>
55 <member>
56 Module CRC
57 </member>
58 <member>
59 A &quot;.&quot; if the CRC verifies correctly, &quot;?&quot; if incorrect.
60 (IDENT will leave this field blank if the &quot;-v&quot; option appears.)
61 </member>
62 <member>
63 Module name
64 </member>
65 </simplelist>
66 </refsect1>
67
68 <refsect1><title>Examples</title>
69 <screen>
70 OS9: ident -m ident
71 Header for: Ident &lt;Module name&gt;
72 Module size: $06A5 #1701 &lt;Module size&gt;
73 Module CRC: $1CE78A (Good) &lt;Good or Bad&gt;
74 Hdr parity: $8B &lt;Header parity&gt;
75 Exec. off: $0222 #546 &lt;Execution offset&gt;
76 Data size: $0CA1 #3233 &lt;Permanent storage requirement&gt;
77 Edition: $05 #5 &lt;First byte after module name&gt;
78 Ty/La At/Rv: $11 $81 &lt;Type/Language Attribute/Revision&gt;
79 Prog mod, 6809 obj, re-en &lt;Module type, Language, Attribute&gt;
80 </screen>
81 <screen>
82 OS9: ident /d0/os9boot -s
83 1 $C0 $A366DC . OS9p2
84 83 $C0 $7FC336 . Init
85 1 $11 $39BA94 . SysGo
86 1 $C1 $402573 . IOMan
87 3 $D1 $EE937A . REF
88 82 $F1 $526268 . D0
89 82 $F1 $D65245 . D1
90 82 $F1 $E32FFE . D2
91 1 $D1 $F944D7 . SCF
92 2 $E1 $F9FE37 . ACIA
93 83 $F1 $765270 . TERM
94 83 $F1 $B4396C . T1
95 83 $F1 $63B73B . T2
96 83 $F1 $0F9B78 . T3
97 83 $F1 $F83EB9 . T4
98 83 $F1 $D6DD9A . T5
99 3 $E1 $3EE015 . PIA
100 83 $F1 $12A43B . P
101 2 $D1 $BBC1EE . PipeMan
102 2 $E1 $5B2B56 . Piper
103 80 $F1 $CC06AF . Pipe
104 2 $C1 $248B2C . Clock
105 ^ ^ ^ ^ ^
106 | | | | |
107 | | | | Module name
108 | | | CRC check &quot; &quot; if -v, &quot;.&quot; if OK, &quot;?&quot; if bad
109 | | CRC value
110 | Type/Language byte
111 Edition byte (first byte after name)
112 </screen>
113 </refsect1>
114 </refentry>
115