NAME

dcp − DECnet file transfer

SYNTAX

dcp [ options ] input output

DESCRIPTION

The dcp command allows you to transfer files to or from other DECnet nodes.  The dcp command supports the transfer of ASCII text and binary image files; however, foreign files having additional attributes will lose those attributes when transferred to an ULTRIX system. 

When you use the dcp command to transfer a file to another DECnet-ULTRIX system, you need not specify a mode of transfer, since conversions are not necessary.  Image mode is the default transfer mode for all file transfers between DECnet-ULTRIX systems.  For non-ULTRIX systems, you need specify a mode of transfer only for image files. 

File protection modes are preserved in file transfers between DECnet-ULTRIX systems, except for set-group-id and set-user-id permissions.  For file transfers to and from non-DECnet-ULTRIX systems, the resulting output file protection modes are defined by the remote system’s file protection defaults. 

The input argument is one or more input file specifications.  The format for an input file spec varies with the operating system on which the input file is located.  See the DECnet-ULTRIX documentation for a description of all DECnet file specifications. 

The output argument is an output file specification, a directory, or a device to which the specified input file(s) are copied.  The format for an output file spec varies with the operating system on which the output file is created.  See the DECnet-ULTRIX documentation for a description of all DECnet file specifications. 

You can specify wildcard characters in a file specification.  You must enclose in quotes those portions of a file specification that you do not want the local shell to interpret, such as the portions of a file specification that contain foreign wildcard characters.  See the DECnet-ULTRIX documentation for more information. 

You can also specify a dash (−) in place of input and output file specifications.  When specified in place of an input file, a dash (−) causes the dcp command to read from the standard input until an end-of-file (EOF).  When specified in place of an output file, a dash (−) causes the dcp command to direct output to the standard output. 

When input files are copied to a directory or a device, the resulting output files retain the input file names.  When output file names are generated from input file names, the resulting output file names are identical to the input file names. 

OPTIONS

−A
Appends the input files to a specified output file. The output file to which input files are appended must already exist. This option will not create an output file.

−P
Prints one or more remote output files on close. This option directs each specified file to the default printer on the remote system.

−S
Submits one or more remote output files for execution, on close. On ULTRIX systems, this option submits output files to the shell on close and creates a log file in the log-in directory that has the name filename.log.  The filename portion is the name of the specified output file. 

−a
Transfers a file in ASCII record mode. ASCII mode transfers perform necessary format conversions between heterogeneous systems. ASCII mode is the default transfer mode to and from non-ULTRIX systems.

−d
Prints debugging information in the form of Data Access Protocol (DAP) message traces to stderr. 

−i
Transfers a file in image mode. Image mode transfers retain a file’s current format. This option is useful only for transferring files between homogeneous systems or for transferring nonprintable data files. Image mode transfers are generally faster than ASCII mode transfers but do not perform data format conversions between heterogeneous systems. Image mode is the default transfer mode to and from other ULTRIX systems.

−v
Logs the names of the files being copied to stderr (verbose mode). 

EXAMPLES

dcp -i terri::’[buckley.data]*.dat’ /data_dir <RET>

This command transfers all files having the file type .dat that are located in the user file directory [buckley.data] on DECnet-VAX node Terri to the local DECnet-ULTRIX node, and stores the files in the directory /data_dir.  The resulting output file names are generated from the input file names.

DIAGNOSTICS

This section defines the format for dcp diagnostic messages.  For further information, read the DECnet-ULTRIX documentation. 

dcp: unknown command flag, (flag)

You have specified a flag option, defined by the flag variable, which dcp does not recognize. 

dcp: can’t open "filename", message

dcp is unable to open the file specified by the filename variable.  A secondary error message, specified by the message variable, defines the reason for the open error. 

dcp: error writing "filename", message

dcp is unable to write to the file specified by the filename variable.  A secondary error message, specified by the message variable, defines the reason for the write error. 

dcp: error reading "filename", message

dcp is unable to read the file specified by the filename variable.  A secondary error message, specified by the message variable, defines the reason for the read error. 

dcp: close error "filename", message

dcp is unable to close the file specified by the filename variable.  A secondary error message, specified by the message variable, defines the reason for the close error. 

SEE ALSO

dcat(1d), dlogin(1d), dls(1d), drm(1d)
DECnet-ULTRIX documentation