Return to dos CVS log

Up to [MW Coherent from dump] / coherent / a / usr / man / COHERENT

coherent

dos                          Command                          dos




Transfer files to/from an MS-DOS file system

ddooss [-]ddFFllrrttxx[_f_l_a_g_s] [_d_e_v_i_c_e] [_f_i_l_e ...]

The command ddooss allows  the COHERENT user to manipulate an MS-DOS
file  system, which  may  be either  a hard-disk  partition or  a
floppy disk.  It can build an empty MS-DOS file system, label it,
list the files in it,  transfer files between it and COHERENT, or
delete files from it.

The given _d_e_v_i_c_e must be  a special file that specifies an MS-DOS
file  system, such  as floppy-disk  drive /ddeevv/ffhhaa00  or hard-disk
partition /ddeevv/aatt00aa.   The default _d_e_v_i_c_e is  /ddeevv/ddooss, which the
system administrator should link to the most commonly used device
name.

ddooss  converts  between  the  differing file-name  conventions  of
COHERENT and MS-DOS.  An MS-DOS _f_i_l_e argument may be specified in
lower or upper case,  using `/' as the path-name separator.  When
transferring files  from MS-DOS to COHERENT,  ddooss converts an MS-
DOS file name to a COHERENT file name in lower case only.  If the
MS-DOS file  name contains no  extension, the COHERENT  file name
contains no  `.'.  When transferring  files from COHERENT  to MS-
DOS, ddooss  converts all alphabetic  characters in a  COHERENT file
name to upper  case; if a period `.' appears  at the beginning or
end of  a file name, ddooss  converts it to `_'.   ddooss truncates the
part of the  file name before the last `.'  to a maximum of eight
characters  and truncates  the extension  to  a maximum  of three
characters.

The  command  line  must specify  exactly  one  of the  following
_f_u_n_c_t_i_o_n_s.

dd    Delete each  _f_i_l_e from the MS-DOS  file system.  This option
     also allows the user to delete empty directories.

FF    Create an empty  MS-DOS file system on a formatted diskette.
     This option is  analogous to the COHERENT command /eettcc/mmkkffss.
     The COHERENT commands /eettcc/ffddffoorrmmaatt and /eettcc/mmkkffss initialize
     a COHERENT diskette in two steps.  The MS-DOS command ffoorrmmaatt
     initializes  an  MS-DOS  diskette  by  performing  both  the
     physical and logical formatting operations with one command.
     To  initialize an  MS-DOS diskette  under COHERENT,  use the
     command /eettcc/ffddffoorrmmaatt -vv _d_e_v_i_c_e_n_a_m_e, followed by the command
     ddooss FF  _d_e_v_i_c_e_n_a_m_e.  If _f_i_l_e  is named, ddooss copies  it to the
     boot block of the file system.  The ddooss command cannot build
     a file system on a hard-disk partition.

ll    Label the MS-DOS file system.  The command line must specify
     exactly one _f_i_l_e argument, which gives the label.

rr    Replace  each  _f_i_l_e  on  the  MS-DOS  file system  with  the
     COHERENT file  of the same  name.  If a  given _f_i_l_e argument
     specifies   a   COHERENT   directory,   ddooss   replaces   its


COHERENT Lexicon                                           Page 1




dos                          Command                          dos



     subdirectories recursively to  the MS-DOS file system unless
     the ss flag is used.  If no _f_i_l_e is specified, ddooss copies all
     files in the current directory to the MS-DOS file system.

tt    List  the  files on  the  MS-DOS file  system.   If no  _f_i_l_e
     argument is given,  ddooss lists the entire MS-DOS file system;
     otherwise, it lists each _f_i_l_e.  If a _f_i_l_e argument specifies
     an MS-DOS  subdirectory, ddooss lists its  contents.  ddooss lists
     directories first in alphabetical order, then ordinary files
     in alphabetical order.

xx    Extract each _f_i_l_e from  the MS-DOS file system to a COHERENT
     file of  the same name.  If a  given _f_i_l_e argument specifies
     an   MS-DOS   subdirectory,   ddooss  extracts   its   contents
     recursively unless the ss flag is used.  If no _f_i_l_e is given,
     ddooss extracts  all files from  the MS-DOS file  system to the
     current COHERENT directory.

The following _f_l_a_g_s are available.

aa    Perform  ASCII newline  conversion on  file  transfer.  When
     moving files  from COHERENT to MS-DOS,  this option converts
     each COHERENT newline character `\n' (ASCII LLFF) to an MS-DOS
     end-of-line (ASCII CCRR and LLFF); when moving files from MS-DOS
     to COHERENT, it does the opposite.  By default, ddooss performs
     binary file transfer, without newline conversion.

kk    Keep  the  file modification  time  (mtime)  on extract  and
     replace  operations.   By default,  ddooss  gives extracted  or
     replaced  files the  current  time.  With  this option,  ddooss
     gives the  extracted or replaced  file the same  time as the
     original file.

nn    List files  in order of  creation (newest file  last) rather
     than in alphabetical order.  This option applies only to the
     table-of-contents  function.  ddooss  always lists  directories
     before files, with or without the nn option.

pp    Perform a  piped extract or replace  (for use in pipelines).
     The  command line  must specify  exactly one  _f_i_l_e argument.
     For extract,  ddooss reads the given _f_i_l_e and  writes it to the
     standard output.  For  replace, ddooss reads the standard input
     and writes it to the given _f_i_l_e.

ss    Suppress  extraction or  replacement of  subdirectories.  By
     default,   ddooss    extracts   or    replaces   subdirectories
     recursively.

vv    Verbose option.   Provide additional information  about each
     function performed.

[11-99]
     A digit specifies a  logical drive number on an extended MS-
     DOS  partition.  For  example, ddooss  ttvv22 /ddeevv/aatt00cc  lists the
     directory  of the  second logical  drive on  extended MS-DOS


COHERENT Lexicon                                           Page 2




dos                          Command                          dos



     partition /ddeevv/aatt00cc.

***** Examples *****

The first example copies all files located in directories ssoouurrcceess
and  iinncclluuddee, as  well as any  subdirectories, from  floppy drive
/ddeevv/ffvvaa11 to correspondingly  named subdirectories in the current
COHERENT directory:


        dos xavk /dev/fva1 sources include


Note that ffvvaa11 is a high-density, 3.5-inch floppy disk in floppy-
disk drive  1 (a.k.a., drive B:).  The files  will be copied with
ASCII newline  conversion and will retain the  time and date that
they had under MS-DOS.

The next  example copies a file from an  MS-DOS partition on your
hard disk.   Suppose that CC:  is the primary  MS-DOS partition on
your  first  hard  drive.   The  following  command  copies  file
CC:\AAUUTTOOEEXXEECC.BBAATT to /aauuttooeexxeecc.bbaatt in your COHERENT root partition:


        dos xa /dev/at0a /autoexec.bat


You will want to use the aa switch any time you are transferring a
text file.

Suppose  that  the  second partition  on  your  first hard  drive
(COHERENT device /ddeevv/aatt00bb)  is an extended MS-DOS partition with
two  logical drives,  DD: and  EE:.  To copy  a COHERENT  text file
/ttmmpp/ffoooo to DD:\TTMMPP\FFOOOO, use the command


        dos ra1 /dev/at0b /tmp/foo


To copy non-text file  ffrroottzz in the current COHERENT directory to
MS-DOS file EE:\DDBBFF\AAXX\FFRROOTTZZ, use the command


        dos rp2 /dev/at0b dbf/ax/frotz < frotz


***** See Also *****

ccoommmmaannddss, ffddffoorrmmaatt, mmkkffss

***** Notes *****

ddooss does  not work with  MS-DOS hard-disk file  systems that hold
more  than  64,000 clusters  (i.e.,  with  four-byte FAT  entries
rather  than   1.5-byte  or  two-byte  FAT   entries).   It  does


COHERENT Lexicon                                           Page 3




dos                          Command                          dos



understand MS-DOS  3.3 extended  disk partitions (where  a single
partition  contains more  than one MS-DOS  file system),  but you
must know whether  a partition contains a normal MS-DOS partition
or an extended partition.

ddooss does not check for unusual characters in a COHERENT file name
or for file names that differ from other file names only in case.


















































COHERENT Lexicon                                           Page 4

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