dosread

PURPOSE

     Copies a DOS file.

SYNOPSIS
     dosread [ -av ] [ -Ddosdev ] DOSfile [ AIXfile ]


DESCRIPTION

     The  dosread command  copies the  specified DOS  file1 to
     standard output or to the specified AIX file2 (by default
     the root directory).  Unless otherwise specified, dosread
     copies as  many bytes as  are specified in  the directory
     entry for file1.  This means, in particular, that copying
     directories does  not work, since directories  by conven-
     tion have a record size of 0.

     File-naming conventions are those of DOS, with one excep-
     tion.  dosread replaces the  \ (backslash) character used
     to  separate components  of  a  DOS path  name  with a  /
     (slash) because the backslash can have special meaning to
     the  AIX Operating  System.   dosread converts  lowercase
     characters  in  the file1  name  to  uppercase before  it
     checks the disk.   Because all file names  are assumed to
     be full (not  relative) path names, you need  not add the
     initial / (slash).

     Notes:

     1.  Wild card characters ("*" and "?") are not treated in
         a special way  by this command (although  they are by
         the shell).   If, for example,  you do not  specify a
         file-name extension,  the file name is  matched as if
         you had specified a blank extension.

     2.  This command must be named dosread.

FLAGS

     -a         Replaces the  sequence CRLF  (carriage return-
                line  feed) with  NL (new-line  character) and
                interprets a Ctrl-Z (ASCII SUB) as the end-of-
                file character.
     -D device  Specifies the  name of the DOS  device or file
                system.  The default device is /dev/fd0.  This
                device must have the DOS-disk format.
     -v         Writes  information  to  the  standard  output
                about the  format of the disk.   Use this flag
                to verify  that a device  or file system  is a
                DOS disk.

EXAMPLES

     1.  To copy  a text file from  a DOS diskette to  the AIX
         file system:

           dosread -a chap1.doc chap1

         This  copies  the  DOS   text  file  "\CHAP1.DOC"  on
         /dev/fd0  to  the AIX  file  "chap1"  in the  current
         directory.
     2.  To  copy a  binary file  from a  fixed-disk DOS  file
         system to the AIX file system:

           dosread -D/dev/hd1 /survey/test.dta /u/fran/testdata

         This copies  the DOS data file  "\SURVEY\TEST.DTA" on
         /dev/hd1 to the AIX file "/u/fran/testdata".

FILES

     /dev/fd0  Device name for diskette drive.

RELATED INFORMATION

     The   following  commands:    "dosdel,"   "dosdir,"   and
     "doswrite."

     The pcdos  subroutine in  AIX Operating  System Technical
     Reference.