doscp(1)                                                           doscp(1)
                               TO BE OBSOLETED



 NAME    [Toc]    [Back]
      doscp - copy to or from DOS files

 SYNOPSIS    [Toc]    [Back]
      doscp [-fmvu] file1 file2

      doscp [-fmvu] file1 [file2 ...] directory

 DESCRIPTION    [Toc]    [Back]
      The doscp command is targeted for removal from HP-UX; see the WARNINGS
      below.

      doscp is the DOS counterpart of cp (see cp(1)).  doscp copies a DOS
      file to a DOS or HP-UX file, an HP-UX file to an HP-UX or DOS file, or
      HP-UX or DOS files to an HP-UX or DOS directory.  The last name in the
      argument list is the destination file or directory.

      A DOS file name is recognized by the presence of an embedded colon (:)
      delimiter; see dosif(4) for DOS file naming conventions.

      Metacharacters *, ?, and [ ... ] can be used when specifying both HPUX
 and DOS file names.  These must be quoted when specifying a DOS
      file name, because file name expansion must be performed by the DOS
      utilities, not by the shell.  DOS utilities expand file names as
      described in regexp(5) under PATTERN MATCHING NOTATION.

      The file name - (dash) is interpreted to mean standard input or
      standard output depending upon its position in the argument list.

    Options    [Toc]    [Back]
      doscp recognizes the following options:

           -f     Unconditionally write over an existing file.  In the
                  absence of this option, doscp asks permission to overwrite
                  an existing HP-UX file.

           -v     Verbose mode.  doscp prints the source name.

           -u     Disable argument case conversion.  In the absence of this
                  option, all DOS file names are converted to upper case.

           -m     In this case you may have a filename same as DOS volume
                  label.

 RETURN VALUE    [Toc]    [Back]
      doscp returns 0 if all files are copied successfully.  Otherwise, it
      prints a message to standard error and returns with a non-zero value.

 EXAMPLES    [Toc]    [Back]
      Copy the files in the HP-UX directory abc to the DOS volume stored as
      HP-UX file hard_disk:



 Hewlett-Packard Company            - 1 -   HP-UX 11i Version 2: August 2003






 doscp(1)                                                           doscp(1)
                               TO BE OBSOLETED



           doscp abc/* hard_disk:

      Copy DOS file /backup/log through the HP-UX special file /dev/rfd9127
      to HP-UX file logcopy located in the current directory:

           doscp /dev/rfd9127:/backup/log  logcopy

      Copy DOS file zulu on the volume stored as HP-UX file bb to standard
      output:

           doscp bb:zulu -

      Copy all files in directory /dameron with extension txt in the DOS
      volume /dev/rdsk/c1t2d0 to the HP-UX directory abacus located in the
      current directory:

           doscp '/dev/rdsk/c1t2d0:/dameron/*.txt' abacus

 WARNINGS    [Toc]    [Back]
      Use of doscp is discouraged because it is targeted for removal from
      HP-UX.  Use dos2ux(1) instead.

      doscp works more reliably if you use a raw device special file
      (/dev/rdsk/) than a block device special file.

      To use SCSI floppy disk devices, the sflop device driver must be
      configured into the kernel.  (You can use the ioscan command to verify
      the configuration.)

 SEE ALSO    [Toc]    [Back]
      cp(1), dos2ux(1), doschmod(1), dosdf(1), dosls(1), dosmkdir(1),
      dosrm(1), ioscan(1M) dosif(4).


 Hewlett-Packard Company            - 2 -   HP-UX 11i Version 2: August 2003