Annotation of coherent/a/usr/man/COHERENT/dos, revision 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.