Mercurial > hg > Members > kono > nitros9-code
annotate docs/nitros9guide/ident.refentry @ 3116:174eb9eda7b1
New port "mc09" for Multicomp09, an FPGA-based 6809 machine
Include new commands/descriptor for mc09 clock and SD controller
| author | Neal Crook <foofoobedoo@gmail.com> |
|---|---|
| date | Sat, 17 Oct 2015 21:21:11 +0100 |
| parents | b00cf13c9f61 |
| children |
| rev | line source |
|---|---|
| 138 | 1 <refentry id="ident"> |
| 2 <refnamediv> | |
| 3 <refname>IDENT</refname> | |
| 1500 | 4 <refpurpose>Print NitrOS-9 module identification</refpurpose> |
| 138 | 5 </refnamediv> |
| 6 | |
| 7 <refsynopsisdiv> | |
| 8 <cmdsynopsis> | |
| 1093 | 9 <command>ident</command> |
| 138 | 10 <arg choice="opt"> |
| 11 <option>-opts</option> | |
| 12 </arg> | |
| 13 <arg choice="plain"> | |
|
975
c565a4700689
The entitity replstart was replaced with <replaceable>
roug
parents:
138
diff
changeset
|
14 <replaceable>path</replaceable> |
| 138 | 15 </arg> |
| 16 <arg choice="opt"> | |
| 17 <option>-opts</option> | |
| 18 </arg> | |
| 19 </cmdsynopsis> | |
| 20 </refsynopsisdiv> | |
| 21 | |
| 22 <refsect1><title>Description</title> | |
| 23 <para> | |
| 1500 | 24 This command is used to display header information from NitrOS-9 memory |
|
1053
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
975
diff
changeset
|
25 modules. <command>Ident</command> displays the module size, CRC bytes (with verification), and for |
| 138 | 26 program and device driver modules, the execution |
|
1053
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
975
diff
changeset
|
27 offset and the permanent storage requirement bytes. <command>ident</command> will |
| 138 | 28 print and interpret the type/language and attribute/revision bytes. |
|
1053
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
975
diff
changeset
|
29 In addition, <command>ident</command> displays the byte immediately following the |
| 138 | 30 module name since most Microware-supplied modules set this byte to |
| 31 indicate the module edition. | |
| 32 </para> | |
| 33 <para> | |
|
1053
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
975
diff
changeset
|
34 <command>Ident</command> will display all modules contained in a disk file. If the |
|
975
c565a4700689
The entitity replstart was replaced with <replaceable>
roug
parents:
138
diff
changeset
|
35 "-m" option appears, <replaceable>path</replaceable> is assumed to be a module in memory. |
| 138 | 36 </para> |
| 37 <para> | |
| 38 If the "-v" option is specified, the module CRC is not verified. | |
| 39 </para> | |
| 40 <para> | |
| 41 The "-x" option implies the pathlist begins in the execution | |
| 42 directory. | |
| 43 </para> | |
| 44 <para> | |
|
1053
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
975
diff
changeset
|
45 The "-s" option causes <command>ident</command> to display the. following module |
| 138 | 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 "." if the CRC verifies correctly, "?" if incorrect. | |
|
1053
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
975
diff
changeset
|
60 (<command>Ident</command> will leave this field blank if the "-v" option appears.) |
| 138 | 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 <Module name> | |
| 72 Module size: $06A5 #1701 <Module size> | |
| 73 Module CRC: $1CE78A (Good) <Good or Bad> | |
| 74 Hdr parity: $8B <Header parity> | |
| 75 Exec. off: $0222 #546 <Execution offset> | |
| 76 Data size: $0CA1 #3233 <Permanent storage requirement> | |
| 77 Edition: $05 #5 <First byte after module name> | |
| 78 Ty/La At/Rv: $11 $81 <Type/Language Attribute/Revision> | |
| 79 Prog mod, 6809 obj, re-en <Module type, Language, Attribute> | |
| 80 </screen> | |
| 81 <screen> | |
| 82 OS9: ident /d0/os9boot -s | |
| 1500 | 83 1 $C0 $A366DC . KernelP2 |
| 138 | 84 83 $C0 $7FC336 . Init |
| 85 1 $11 $39BA94 . SysGo | |
| 86 1 $C1 $402573 . IOMan | |
| 1500 | 87 3 $D1 $EE937A . RBF |
| 88 82 $F1 $526268 . DD | |
| 138 | 89 82 $F1 $526268 . D0 |
| 90 82 $F1 $D65245 . D1 | |
| 91 82 $F1 $E32FFE . D2 | |
| 92 1 $D1 $F944D7 . SCF | |
| 1500 | 93 2 $E1 $F9FE37 . VDGInt |
| 94 83 $F1 $765270 . Term | |
| 138 | 95 2 $D1 $BBC1EE . PipeMan |
| 96 2 $E1 $5B2B56 . Piper | |
| 97 80 $F1 $CC06AF . Pipe | |
| 98 2 $C1 $248B2C . Clock | |
| 1500 | 99 2 $C1 $248B2C . Clock2 |
| 138 | 100 ^ ^ ^ ^ ^ |
| 101 | | | | | | |
| 102 | | | | Module name | |
| 103 | | | CRC check " " if -v, "." if OK, "?" if bad | |
| 104 | | CRC value | |
| 105 | Type/Language byte | |
| 106 Edition byte (first byte after name) | |
| 107 </screen> | |
| 108 </refsect1> | |
| 109 </refentry> | |
| 110 |