DSCOPY(1) DSCOPY(1)
NAME
dscopy - network file copy
SYNOPSIS
dscopy [ -p -s -d -L -r -P -F -B ] source_file target_file
dscopy -i
HP-UX COMPATIBILITY
Level: HP-UX/NON-STANDARD
Origin: HP
DESCRIPTION
Dscopy copies the file source_file to the file target_file
on a local network. Files can be copied within a system,
between local and remote systems, or between remote systems
under the control of the local system. The file transfer can
span any AdvanceNet nodes on the network.
If one of the AdvanceNet nodes is a VAX computer connected
to DECnet, dscopy can copy to or from all AdvanceNet and
DECnet nodes as long as the request is initiated from an
AdvanceNet node.
The format of a file argument is:
node_name#login:password#file_path_name
Node_name is the path name of a remote node that is known to
the local system. Login:password is a login and optional
password valid on the node node_name.
If a password for an HP-UX node is to be specified, a colon
must separate the login name from the password. If no
password is required, omit the colon after the login name. A
null string is assigned to the password. A slash separates
the login name from the password on HP 3000 computers; a
colon separates the login name from the password on VAX
computers.
The default for node_name#login:password# is the current
user login on the local system.
For remote files, the file_path_name specifies the file to
be transferred relative to the home directory of login, or
to the remote root directory if file_path_name begins with a
slash. For local files, the file_path_name specifies the
file to be transferred relative to your current working
directory, or to the local root directory if file_path_name
begins with a slash.
The maximum file_path_name length accepted by dscopy is 256
Hewlett-Packard - 1 - (printed 7/16/86)
DSCOPY(1) DSCOPY(1)
bytes.
To use a C-shell or Bourne-shell metacharacter in a
file_path_name, the character must be escaped (with a
backslash or enclosed in quotes). Wild card characters are
not allowed in remote file arguments. You must use an escape
with any character that might otherwise be taken literally.
If you use the # character in an argument, you must escape
it twice if you are in non-interactive mode (i.e. \\#) and
once if you are in the interactive mode (i.e. \#).
Password security can be established by requesting a prompt
for your remote password. If you observe the following
rules, your system prompts for passwords with the local echo
turned off.
If the remote file system is an HP-UX system, enter the
login name and a colon, but do not enter the password.
The system recognizes the colon as a key to prompt the
user for the password. The login name and password are
passed to the remote system as two separate entities.
If the remote file system is not an HP-UX system, enter
the login name and two colons, but do not enter the
password. The system recognizes the two colons as a key
to prompt for a password. The password is substituted
for the two-colon key and the resulting string is
passed to the remote system as a single entity.
Use a key for each password in the command that must be
prompted for. Dscopy prompts for a password for each
double colon key it encounters.
File passwords (lockwords) can also be specified with
the local echo turned off. Use a two-colon key in place
of the password and specify the -P option. (See the
description of the -P option.)
If the source and target nodes have different file systems,
the source file must be translated to an interchange format
before it is transferred to the target computer. The target
computer then translates the file from the interchange
format. Interchange mode transfers occur automatically when
file systems are different.
The HP-UX signals quit and interrupt can be used during
dscopy operations. The quit signal aborts any transfer in
progress. The target file is incomplete or non-existent.
HP3000 computers purge incomplete files. The interrupt (the
BREAK key) reports the percentage completed of the current
file transfer without aborting the transfer.
Hewlett-Packard - 2 - (printed 7/16/86)
DSCOPY(1) DSCOPY(1)
Dscopy options can be specified in any order, but they
cannot be concatenated because some options require value or
character information.
The options are:
-i Copy files in interactive mode. Maintains the
connection to a remote system. This option is useful if
you have more than one file to copy to the same node.
Enter dscopy -i to use dscopy interactively. When you
get the "dscopy >" prompt, enter any desired options
and the source and target file arguments. After each
file is transferred, dscopy prompts for new files to
copy. Enter the next source and target file names. If
the node name and login name are not specified, they
are assumed to be the same as in the previous file
transfer. If a new node name and login are specified,
the old connection is severed and a new one is created.
To change the connection from a remote node specifier
to the local node, prefix the local file_path_name with
the # character.
The other dscopy options can be used in individual
transfers once you enter the interactive mode and
receive the "dscopy >" prompt.
-p Print the results of the transfer upon completion. The
number of bytes transferred is displayed for successful
transfers. If the transfer was an interchange mode
transfer, the number of records transferred is
displayed instead.
-r Replace an existing target file with the source file.
For file transfers between HP-UX systems, if the target
file exists before the transfer and the -r option is
not specified, the target file is overwritten and the
file mode and ownership are unchanged. If the target
file did not exist or the -r option is specified, the
target file mode is the same as the mode of the source
file, and the target file ownership is determined by
the login that was specified to access the target
system.
For file transfers between heterogeneous systems, if
the target file exists before the transfer, the target
file is not overwritten. An error message results. The
-r option must be used for the target file to be
replaced by the source file. If the -r option is used,
the file mode and ownership of the new file are the
same as those of the source file.
-s Define an ASCII search character literally or in its
Hewlett-Packard - 3 - (printed 7/16/86)
DSCOPY(1) DSCOPY(1)
decimal ASCII code value. The ASCII code value must be
prefixed with zero. Some non-HP-UX systems require
logical record boundaries. The search character
specified after -s is used to divide an HP-UX file into
logical records for a file transfer to a non-HP-UX
node. Use of -s forces an interchange mode transfer.
(e.g. -s014 creates a new logical record every time a
FORMFEED character is encountered.) The default search
character is NEWLINE.
The -s option is ignored if specified for a 3000
producer. The option is also ignored by a VAX producer
because the file system has record formats that
correspond to specific record delimiters.
-d Define an ASCII delimiter character literally or in its
decimal ASCII code value. The ASCII code value must be
prefixed with zero. The delimiter character specified
after the -d is inserted at the end of each logical
record stored on an HP-UX system. Use of -d forces an
interchange mode transfer. (e.g. -d012 inserts a
LINEFEED character after each record in the target
file.) The default delimiter for an HP-UX system is the
NEWLINE character.
The -d option is ignored by a VAX consumer if the -F
option is specified.
-L Specifies the maximum record length in bytes of
variable length records in the target file. (e.g. -L80)
Use of -L forces an interchange mode transfer. A
warning is given if records are being truncated during
a transfer. The default record length is producer-
consumer dependent. Truncation depends on the maximum
record length, which is usually determined by the
source file's maximum record length. But, for a 9000
producer, the maximum record length is negotiated
between the producer and consumer.
-F Transfer fixed length records. Use of -F forces an
interchange mode transfer. Specify the fixed record
length with -L. If you do not specify a -L value, the
default length is 160 bytes for ASCII file transfers
and 256 bytes for binary file transfers. If the file is
an ASCII file, each LINEFEED delimited record is
truncated if it is longer than the specified fixed
length, or padded with SPACE characters if it is
shorter than the specified fixed length. If the file is
a binary file (-B option), it is assumed there are no
record delimiters and every set of x sequential bytes
in the source file constitutes a new target record of
length x. The last record is padded with NULL
Hewlett-Packard - 4 - (printed 7/16/86)
DSCOPY(1) DSCOPY(1)
characters if necessary. On 3000 consumers, padding
creates a fixed-record file type, ASCII or binary
depending on the file. If -F is specified for a VAX
consumer, the target file is always a fixed-record file
type.
-B Transfer a binary file. Use of -B forces an interchange
mode transfer. If -s is specified, it is ignored. If -d
is specified for a VAX node, the delimiter character is
only used to determine the stream file type of the
target file. The -d option is ignored by all other
non-HP-UX nodes. Binary file transfers can occur with
or without the -F option.
If you do not use the -F option:
With an HP-UX producer, the system reads the
source file like a fixed binary file, but forms
the target file with a variable-length record
format.
With a 3000 producer, the data is simply extracted
from each record and transferred.
With an HP-UX consumer, each binary record is
stored one after the other without a record
terminator between records.
With a 3000 consumer, a binary file is created.
Each record is then stored as an individual record
in the binary file.
If you do use the -F option:
The system assumes the records are fixed-length
with no record delimiters. All characters are
considered to be data. Padding occurs at the end
of he file if the total number of bytes in the
file cannot be evenly divided by the record
length.
Binary data transfers on a VAX computer are defined
such that data is read and written in block mode I/O,
with no attention to record structure. When a VAX
computer receives a file, it writes the blocks directly
to the target file. When a VAX computer sends a file,
it reads the blocks directly and send them to the
consumer. Any required padding is done with the ASCII
NULL character.
-P Prompt for individual file passwords marked with two-
colon keys. Dscopy prompts for the password(s) with the
Hewlett-Packard - 5 - (printed 7/16/86)
DSCOPY(1) DSCOPY(1)
local echo turned off. If a two-colon key is used for a
file password, and -P is not specified, the key is
interpreted as part of the file name.
Before running fsck(1), the NFT daemon (/etc/nftdaemon) must
be killed. If the NFT daemon has been killed, it can be
restarted by manually executing /etc/nftdaemon. (Super-user
only.) If an attempt is made to execute /etc/nftdaemon when
the NFT daemon is already running, the attempt fails. Only
one NFT daemon can run at a time.
EXAMPLES
1. Local HP-UX to Remote HP-UX:
dscopy abc rem_node1#bob:cat#def
Copy file abc to file def in the home directory of
remote node rem_node1.
2. Local HP-UX to Remote HP-UX:
dscopy src_file rem_node1#mike:#/users/mike/dst_file
target password >
Prompt for the target node login password, and copy
file src_file to file dst_file on remote node
rem_node1.
3. Remote HP 3000 to Local HP-UX
dscopy rsc#john/::.lab/setter,grads/pass#source target
source password >
Prompt for the source node login password, and copy
file source on the remote node rsc to file target on
the local node.
4. Local HP-UX to Remote VAX
dscopy a_file decnode#maryann:#b_file
target password >
Prompt for the target node login password, and copy
file a_file to file b_file on remote node decnode.
FILES
/usr/bin/dscopy
SEE ALSO
cp(1), uucp(1C).
Hewlett-Packard - 6 - (printed 7/16/86)
DSCOPY(1) DSCOPY(1)
DIAGNOSTICS
Exit Status:
0 Requested transfer has successfully completed.
1 Source file or node in inaccessible.
2 Target file or node is inaccessible.
3 Syntax error.
4 Transfer did not complete successfully.
5 Internal error.
Error messages are sent to the file transfer user's standard
error device when a dscopy aborts prematurely.
Hewlett-Packard - 7 - (printed 7/16/86)