Annotation of coherent/a/usr/man/COHERENT/dos, revision 1.1.1.1

1.1       root        1: 
                      2: 
                      3: dos                          Command                          dos
                      4: 
                      5: 
                      6: 
                      7: 
                      8: Transfer files to/from an MS-DOS file system
                      9: 
                     10: ddooss [-]ddFFllrrttxx[_f_l_a_g_s] [_d_e_v_i_c_e] [_f_i_l_e ...]
                     11: 
                     12: The command ddooss allows  the COHERENT user to manipulate an MS-DOS
                     13: file  system, which  may  be either  a hard-disk  partition or  a
                     14: floppy disk.  It can build an empty MS-DOS file system, label it,
                     15: list the files in it,  transfer files between it and COHERENT, or
                     16: delete files from it.
                     17: 
                     18: The given _d_e_v_i_c_e must be  a special file that specifies an MS-DOS
                     19: file  system, such  as floppy-disk  drive /ddeevv/ffhhaa00  or hard-disk
                     20: partition /ddeevv/aatt00aa.   The default _d_e_v_i_c_e is  /ddeevv/ddooss, which the
                     21: system administrator should link to the most commonly used device
                     22: name.
                     23: 
                     24: ddooss  converts  between  the  differing file-name  conventions  of
                     25: COHERENT and MS-DOS.  An MS-DOS _f_i_l_e argument may be specified in
                     26: lower or upper case,  using `/' as the path-name separator.  When
                     27: transferring files  from MS-DOS to COHERENT,  ddooss converts an MS-
                     28: DOS file name to a COHERENT file name in lower case only.  If the
                     29: MS-DOS file  name contains no  extension, the COHERENT  file name
                     30: contains no  `.'.  When transferring  files from COHERENT  to MS-
                     31: DOS, ddooss  converts all alphabetic  characters in a  COHERENT file
                     32: name to upper  case; if a period `.' appears  at the beginning or
                     33: end of  a file name, ddooss  converts it to `_'.   ddooss truncates the
                     34: part of the  file name before the last `.'  to a maximum of eight
                     35: characters  and truncates  the extension  to  a maximum  of three
                     36: characters.
                     37: 
                     38: The  command  line  must specify  exactly  one  of the  following
                     39: _f_u_n_c_t_i_o_n_s.
                     40: 
                     41: dd    Delete each  _f_i_l_e from the MS-DOS  file system.  This option
                     42:      also allows the user to delete empty directories.
                     43: 
                     44: FF    Create an empty  MS-DOS file system on a formatted diskette.
                     45:      This option is  analogous to the COHERENT command /eettcc/mmkkffss.
                     46:      The COHERENT commands /eettcc/ffddffoorrmmaatt and /eettcc/mmkkffss initialize
                     47:      a COHERENT diskette in two steps.  The MS-DOS command ffoorrmmaatt
                     48:      initializes  an  MS-DOS  diskette  by  performing  both  the
                     49:      physical and logical formatting operations with one command.
                     50:      To  initialize an  MS-DOS diskette  under COHERENT,  use the
                     51:      command /eettcc/ffddffoorrmmaatt -vv _d_e_v_i_c_e_n_a_m_e, followed by the command
                     52:      ddooss FF  _d_e_v_i_c_e_n_a_m_e.  If _f_i_l_e  is named, ddooss copies  it to the
                     53:      boot block of the file system.  The ddooss command cannot build
                     54:      a file system on a hard-disk partition.
                     55: 
                     56: ll    Label the MS-DOS file system.  The command line must specify
                     57:      exactly one _f_i_l_e argument, which gives the label.
                     58: 
                     59: rr    Replace  each  _f_i_l_e  on  the  MS-DOS  file system  with  the
                     60:      COHERENT file  of the same  name.  If a  given _f_i_l_e argument
                     61:      specifies   a   COHERENT   directory,   ddooss   replaces   its
                     62: 
                     63: 
                     64: COHERENT Lexicon                                           Page 1
                     65: 
                     66: 
                     67: 
                     68: 
                     69: dos                          Command                          dos
                     70: 
                     71: 
                     72: 
                     73:      subdirectories recursively to  the MS-DOS file system unless
                     74:      the ss flag is used.  If no _f_i_l_e is specified, ddooss copies all
                     75:      files in the current directory to the MS-DOS file system.
                     76: 
                     77: tt    List  the  files on  the  MS-DOS file  system.   If no  _f_i_l_e
                     78:      argument is given,  ddooss lists the entire MS-DOS file system;
                     79:      otherwise, it lists each _f_i_l_e.  If a _f_i_l_e argument specifies
                     80:      an MS-DOS  subdirectory, ddooss lists its  contents.  ddooss lists
                     81:      directories first in alphabetical order, then ordinary files
                     82:      in alphabetical order.
                     83: 
                     84: xx    Extract each _f_i_l_e from  the MS-DOS file system to a COHERENT
                     85:      file of  the same name.  If a  given _f_i_l_e argument specifies
                     86:      an   MS-DOS   subdirectory,   ddooss  extracts   its   contents
                     87:      recursively unless the ss flag is used.  If no _f_i_l_e is given,
                     88:      ddooss extracts  all files from  the MS-DOS file  system to the
                     89:      current COHERENT directory.
                     90: 
                     91: The following _f_l_a_g_s are available.
                     92: 
                     93: aa    Perform  ASCII newline  conversion on  file  transfer.  When
                     94:      moving files  from COHERENT to MS-DOS,  this option converts
                     95:      each COHERENT newline character `\n' (ASCII LLFF) to an MS-DOS
                     96:      end-of-line (ASCII CCRR and LLFF); when moving files from MS-DOS
                     97:      to COHERENT, it does the opposite.  By default, ddooss performs
                     98:      binary file transfer, without newline conversion.
                     99: 
                    100: kk    Keep  the  file modification  time  (mtime)  on extract  and
                    101:      replace  operations.   By default,  ddooss  gives extracted  or
                    102:      replaced  files the  current  time.  With  this option,  ddooss
                    103:      gives the  extracted or replaced  file the same  time as the
                    104:      original file.
                    105: 
                    106: nn    List files  in order of  creation (newest file  last) rather
                    107:      than in alphabetical order.  This option applies only to the
                    108:      table-of-contents  function.  ddooss  always lists  directories
                    109:      before files, with or without the nn option.
                    110: 
                    111: pp    Perform a  piped extract or replace  (for use in pipelines).
                    112:      The  command line  must specify  exactly one  _f_i_l_e argument.
                    113:      For extract,  ddooss reads the given _f_i_l_e and  writes it to the
                    114:      standard output.  For  replace, ddooss reads the standard input
                    115:      and writes it to the given _f_i_l_e.
                    116: 
                    117: ss    Suppress  extraction or  replacement of  subdirectories.  By
                    118:      default,   ddooss    extracts   or    replaces   subdirectories
                    119:      recursively.
                    120: 
                    121: vv    Verbose option.   Provide additional information  about each
                    122:      function performed.
                    123: 
                    124: [11-99]
                    125:      A digit specifies a  logical drive number on an extended MS-
                    126:      DOS  partition.  For  example, ddooss  ttvv22 /ddeevv/aatt00cc  lists the
                    127:      directory  of the  second logical  drive on  extended MS-DOS
                    128: 
                    129: 
                    130: COHERENT Lexicon                                           Page 2
                    131: 
                    132: 
                    133: 
                    134: 
                    135: dos                          Command                          dos
                    136: 
                    137: 
                    138: 
                    139:      partition /ddeevv/aatt00cc.
                    140: 
                    141: ***** Examples *****
                    142: 
                    143: The first example copies all files located in directories ssoouurrcceess
                    144: and  iinncclluuddee, as  well as any  subdirectories, from  floppy drive
                    145: /ddeevv/ffvvaa11 to correspondingly  named subdirectories in the current
                    146: COHERENT directory:
                    147: 
                    148: 
                    149:         dos xavk /dev/fva1 sources include
                    150: 
                    151: 
                    152: Note that ffvvaa11 is a high-density, 3.5-inch floppy disk in floppy-
                    153: disk drive  1 (a.k.a., drive B:).  The files  will be copied with
                    154: ASCII newline  conversion and will retain the  time and date that
                    155: they had under MS-DOS.
                    156: 
                    157: The next  example copies a file from an  MS-DOS partition on your
                    158: hard disk.   Suppose that CC:  is the primary  MS-DOS partition on
                    159: your  first  hard  drive.   The  following  command  copies  file
                    160: CC:\AAUUTTOOEEXXEECC.BBAATT to /aauuttooeexxeecc.bbaatt in your COHERENT root partition:
                    161: 
                    162: 
                    163:         dos xa /dev/at0a /autoexec.bat
                    164: 
                    165: 
                    166: You will want to use the aa switch any time you are transferring a
                    167: text file.
                    168: 
                    169: Suppose  that  the  second partition  on  your  first hard  drive
                    170: (COHERENT device /ddeevv/aatt00bb)  is an extended MS-DOS partition with
                    171: two  logical drives,  DD: and  EE:.  To copy  a COHERENT  text file
                    172: /ttmmpp/ffoooo to DD:\TTMMPP\FFOOOO, use the command
                    173: 
                    174: 
                    175:         dos ra1 /dev/at0b /tmp/foo
                    176: 
                    177: 
                    178: To copy non-text file  ffrroottzz in the current COHERENT directory to
                    179: MS-DOS file EE:\DDBBFF\AAXX\FFRROOTTZZ, use the command
                    180: 
                    181: 
                    182:         dos rp2 /dev/at0b dbf/ax/frotz < frotz
                    183: 
                    184: 
                    185: ***** See Also *****
                    186: 
                    187: ccoommmmaannddss, ffddffoorrmmaatt, mmkkffss
                    188: 
                    189: ***** Notes *****
                    190: 
                    191: ddooss does  not work with  MS-DOS hard-disk file  systems that hold
                    192: more  than  64,000 clusters  (i.e.,  with  four-byte FAT  entries
                    193: rather  than   1.5-byte  or  two-byte  FAT   entries).   It  does
                    194: 
                    195: 
                    196: COHERENT Lexicon                                           Page 3
                    197: 
                    198: 
                    199: 
                    200: 
                    201: dos                          Command                          dos
                    202: 
                    203: 
                    204: 
                    205: understand MS-DOS  3.3 extended  disk partitions (where  a single
                    206: partition  contains more  than one MS-DOS  file system),  but you
                    207: must know whether  a partition contains a normal MS-DOS partition
                    208: or an extended partition.
                    209: 
                    210: ddooss does not check for unusual characters in a COHERENT file name
                    211: or for file names that differ from other file names only in case.
                    212: 
                    213: 
                    214: 
                    215: 
                    216: 
                    217: 
                    218: 
                    219: 
                    220: 
                    221: 
                    222: 
                    223: 
                    224: 
                    225: 
                    226: 
                    227: 
                    228: 
                    229: 
                    230: 
                    231: 
                    232: 
                    233: 
                    234: 
                    235: 
                    236: 
                    237: 
                    238: 
                    239: 
                    240: 
                    241: 
                    242: 
                    243: 
                    244: 
                    245: 
                    246: 
                    247: 
                    248: 
                    249: 
                    250: 
                    251: 
                    252: 
                    253: 
                    254: 
                    255: 
                    256: 
                    257: 
                    258: 
                    259: 
                    260: 
                    261: 
                    262: COHERENT Lexicon                                           Page 4
                    263: 
                    264: 

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.