Mercurial > hg > Members > kono > nitros9-code
annotate docs/nitros9guide/xmode.refentry @ 2624:b8c7b7fbf3c9
Major changes:
o os9defs, rbfdefs, scfdefs now os9.d, rbf.d, and scf.d
o vtiodefs now broken into cocovtio.d (for coco and dragon) and atarivtio.d
o systype now broken into coco.d, dragon.d and atari.d
o all references to the above in other files have changed
| author | Boisy Pitre <boisy.pitre@nuance.com> |
|---|---|
| date | Fri, 24 Feb 2012 08:51:08 -0600 |
| parents | 4dae346c4969 |
| children |
| rev | line source |
|---|---|
| 141 | 1 <refentry id="xmode"> |
| 2 <refnamediv> | |
| 3 <refname>XMODE</refname> | |
| 4 <refpurpose>Examine or Change Device Initialization Mode</refpurpose> | |
| 5 </refnamediv> | |
| 6 | |
| 7 <refsynopsisdiv> | |
| 8 <cmdsynopsis> | |
| 1093 | 9 <command>xmode</command> |
|
975
c565a4700689
The entitity replstart was replaced with <replaceable>
roug
parents:
648
diff
changeset
|
10 <arg choice="plain"><replaceable>devname</replaceable></arg> |
|
c565a4700689
The entitity replstart was replaced with <replaceable>
roug
parents:
648
diff
changeset
|
11 <arg choice="opt"><replaceable>arglist</replaceable></arg> |
| 141 | 12 </cmdsynopsis> |
| 13 </refsynopsisdiv> | |
| 14 | |
| 15 <refsect1><title>Description</title> | |
| 16 <para> | |
| 17 This command is used to display or change the initialization | |
| 18 parameters of any SCF-type device such as the video display, | |
| 19 printer, RS232 port, etc. A common use is to change baud rates, | |
| 20 control key definitions, etc. | |
| 21 </para> | |
| 22 <para> | |
|
1053
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
975
diff
changeset
|
23 <command>Xmode</command> is very similar to the <command>tmode</command> command. |
|
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
975
diff
changeset
|
24 <command>Tmode</command> only operates on |
|
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
975
diff
changeset
|
25 open paths so its effect is temporary. <command>Xmode</command> actually updates the |
| 141 | 26 device descriptor so the change persists as long as the computer is |
| 27 running, even if paths to the device are repetitively opened and | |
| 1093 | 28 closed. If <command>xmode</command> is used to change parameter(s) and the <command>cobbler</command> |
| 141 | 29 program is used to make a new system disk, the changed parameter |
| 30 will be permanently reflected on the new system disk. | |
| 31 </para> | |
| 32 <para> | |
|
1053
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
975
diff
changeset
|
33 <command>Xmode</command> requires a device name to be given. If no arguments are |
| 141 | 34 given, the present values for each parameter are displayed, |
| 35 otherwise, the parameter(s) given in the argument list are | |
| 36 processed. Any number of parameters can be given, and are separated | |
| 37 by spaces or commas. | |
| 38 </para> | |
| 39 | |
| 40 </refsect1> | |
| 41 <refsect1><title>XMODE Parameter Names</title> | |
| 42 | |
| 43 <informaltable frame="none"> | |
| 44 <tgroup cols="2"> | |
| 648 | 45 <colspec colwidth="1in"/> |
| 46 <colspec colwidth="4in"/> | |
| 141 | 47 <tbody> |
| 48 <row> | |
| 49 <entry>upc</entry> | |
| 50 <entry>Upper case only. Lower case characters are automatically | |
| 51 converted to upper case.</entry> | |
| 52 </row> | |
| 53 <row> | |
| 54 <entry>-upc</entry> | |
| 55 <entry>Upper case and lower case characters permitted (default).</entry> | |
| 56 </row> | |
| 57 <row> | |
| 58 <entry>bsb</entry> | |
| 59 <entry>Erase on backspace: backspace characters echoed as a | |
| 60 backspace-space-backspace sequence (default).</entry> | |
| 61 </row> | |
| 62 <row> | |
| 63 <entry>-bsb</entry> | |
| 64 <entry>no erase on backspace: echoes single backspace only</entry> | |
| 65 </row> | |
| 66 <row> | |
| 67 <entry>bsl</entry> | |
| 68 <entry>Backspace over line: lines are "deleted" by sending | |
| 69 backspace-space-backspace sequences to erase the same | |
| 70 line (for video terminals) (default).</entry> | |
| 71 </row> | |
| 72 <row> | |
| 73 <entry>-bsl</entry> | |
| 74 <entry>No backspace over line: lines are "deleted" by printing | |
| 75 a new line sequence (for hard-copy terminals). | |
| 76 echo Input characters "echoed" back to terminal (default)</entry> | |
| 77 </row> | |
| 78 <row> | |
| 79 <entry>-echo</entry> | |
| 80 <entry>No echo</entry> | |
| 81 </row> | |
| 82 <row> | |
| 83 <entry>lf</entry> | |
| 84 <entry>Auto line feed on: line feeds automatically echoed to | |
| 85 terminal on input and output carriage returns (default).</entry> | |
| 86 </row> | |
| 87 <row> | |
| 88 <entry>-lf</entry> | |
| 89 <entry>Auto line feed off.</entry> | |
| 90 </row> | |
| 91 <row> | |
| 92 <entry>pause</entry> | |
| 93 <entry>Screen pause on: output suspended upon full screen. See | |
| 94 "pag" parameter for definition of screen size. Output | |
| 95 can be resumed by typing any key.</entry> | |
| 96 </row> | |
| 97 <row> | |
| 98 <entry>-pause</entry> | |
| 99 <entry>Screen pause mode off.</entry> | |
| 100 </row> | |
| 101 <row> | |
| 102 <entry>null=n</entry> | |
| 103 <entry>Set null count: number of null ($00) characters | |
| 104 transmitted after carriage returns for return delay. | |
| 105 The number is decimal, default = 0.</entry> | |
| 106 </row> | |
| 107 <row> | |
| 108 <entry>pag=n</entry> | |
| 109 <entry>Set video display page length to n (decimal) lines. | |
| 110 Used for "pause" mode, see above.</entry> | |
| 111 </row> | |
| 112 <row> | |
| 113 <entry>bsp=h</entry> | |
| 114 <entry>Set input backspace character. Numeric value of | |
| 115 character in hexadecimal. Default = 08.</entry> | |
| 116 </row> | |
| 117 <row> | |
| 118 <entry>bse=h</entry> | |
| 119 <entry>Set output backspace character. Numeric value of | |
| 120 character in hexadecimal. Default = 08.</entry> | |
| 121 </row> | |
| 122 <row> | |
| 123 <entry>del=h</entry> | |
| 124 <entry>Set input delete line character. Numeric value of | |
| 125 character in hexadecimal. Default = 18.</entry> | |
| 126 </row> | |
| 127 <row> | |
| 128 <entry>bell=h</entry> | |
| 129 <entry>Set bell (alert) output character. Numeric value of | |
| 130 character in hexadecimal. Default = 07</entry> | |
| 131 </row> | |
| 132 <row> | |
| 133 <entry>eor=h</entry> | |
| 134 <entry>Set end-of-record (carriage return) input character. | |
| 135 Numeric value of character in hexadecimal. Default = 0D</entry> | |
| 136 </row> | |
| 137 <row> | |
| 138 <entry>eof=h</entry> | |
| 139 <entry>Set end-of-file input character. Numeric value of | |
| 140 character in hexadecimal. Default 1B.</entry> | |
| 141 </row> | |
| 142 <row> | |
| 143 <entry>type=h</entry> | |
| 144 <entry>ACIA initialization value: sets parity, word size, etc. | |
| 145 Value in hexadecimal. Default 15</entry> | |
| 146 </row> | |
| 147 <row> | |
| 148 <entry>reprint=h</entry> | |
| 149 <entry>Reprint line character. Numeric value of character | |
| 150 in hexadecimal.</entry> | |
| 151 </row> | |
| 152 <row> | |
| 153 <entry>dup=h</entry> | |
| 154 <entry>Duplicate last input line character. Numeric value of | |
| 155 character in hexadecimal.</entry> | |
| 156 </row> | |
| 157 <row> | |
| 158 <entry>psc=h</entry> | |
| 159 <entry>Pause character. Numeric value of character in | |
| 160 hexadecimal.</entry> | |
| 161 </row> | |
| 162 <row> | |
| 163 <entry>abort=h</entry> | |
| 1092 | 164 <entry>Abort character (normally <keycombo action="simul"><keycap>Control</keycap> |
| 165 <keycap>C</keycap></keycombo>). Numeric value | |
| 141 | 166 of character in hexadecimal.</entry> |
| 167 </row> | |
| 168 <row> | |
| 169 <entry>quit=h</entry> | |
| 1092 | 170 <entry>Quit character (normally <keycombo action="simul"><keycap>Control</keycap> |
| 171 <keycap>E</keycap></keycombo>). Numeric value | |
| 141 | 172 of character in hexadecimal.</entry> |
| 173 </row> | |
| 174 <row> | |
| 175 <entry>baud=d</entry> | |
| 176 <entry>Set baud rate for software-controllable interface. Numeric | |
| 177 code for baud rate: 0=110 1=300 2=600 3=1200 4=2400 5=4800 | |
| 178 6=9600 7=19200</entry> | |
| 179 </row> | |
| 180 </tbody> | |
| 181 </tgroup> | |
| 182 </informaltable> | |
| 183 </refsect1> | |
| 184 <refsect1><title>Examples</title> | |
| 185 <screen> | |
| 186 xmode /TERM -upc lf null=4 bse=1F pause | |
| 187 | |
| 188 xmode /T1 pag=24 pause bsl -echo bsp=8 bsl=C | |
| 189 | |
| 190 xmode /P baud=3 -if | |
| 191 </screen> | |
| 192 </refsect1> | |
| 193 </refentry> |