ftcp(1C) FTAM 3.00 ftcp(1C)
NAME
ftcp - FTAM file copy program
SYNOPSIS
ftcp [ [ options ] src-ftam-file-spec dst-ftam-file-spec ]
DESCRIPTION
Ftcp copies a file from one filestore to another.
If you invoke ftcp without arguments, you are prompted for
the source and destination file specifications.
You may group options behind the - character provided that
not more than one option takes the next word as an argument.
-v1|v2|v3 Verbosity level. Print network event
information. Default is no network event
reporting.
-v1 Connection level. Report the creation and
termination of connections to local and
remote filestores as they occur.
-v2 PDU (packet) identification level. Identify
request and response PDUs as they are sent or
received. Connection information is also
printed.
-v3 PDU dump level. Print a textual
representation of each PDU that is sent or
received. A large amount of useful
information is printed. Connection
information and packet identification are
also printed.
-z num Specify an association timeout value. Num is
the maximum number of seconds to wait for a
network event to complete before returning an
error. Making the association timeout small
prevents unnecessary delays when there are
communications problems. If this option is
not specified or if num equals zero,
associations do not timeout.
Lower layers of the protocol stack may
timeout network events even if an FTAM
association timeout is not set.
-i Prompt for missing filestore information. If
the ftam-file-spec does not specify the
initiator identity and/or password for a
Licensed material--property of copyright holder(s) Page 1
ftcp(1C) FTAM 3.00 ftcp(1C)
remote filestore, prompt the user for the
missing information. The password is not
echoed.
-w Prompt for FTAM file passwords. Most FTAM
responders do not support file passwords.
This option prompts for all eight FTAM file
passwords and is independent of the FTAM
operation specified.
-f1|f2|f3|fg Transfer the source file as a particular
contents type. The source file must be on
the local filestore. Revision 3.00 FTAM for
AViiON Systems temporarily overrides the
current values of the file's contents type
attributes and uses the specified contents
type with default document type parameters.
-f1 Transfer the source file as an unstructured
text file (FTAM-1 file).
-f2 Transfer the source file as a sequential text
file (FTAM-2 file).
-f3 Transfer the source file as an unstructured
binary file (FTAM-3 file).
-fg Make a 'best guess' of the source file
contents type. Ftcp examines the first 128
bytes of the source file. If it finds non-
text characters, it transfers the file as an
FTAM-3 file; otherwise, it transfers the file
as an FTAM-1 file.
CAUTION Using the -f option can have unforeseen
consequences. If a binary (FTAM-3) file is
transferred as a text file, the contents of
the destination file may not be as expected
since the transfer of FTAM-1 files involves
interpretation of carriage-returns and new-
lines. Transferring a text file (FTAM-1) as
a binary file (FTAM-3) results in the
contents of the destination file being
exactly the same as the source file since
FTAM-3 files are transferred without
interpreting file contents.
-dd|dr|da This option indicates the action to perform
upon the destination file.
-dd Delete the destination file if it exists. If
Licensed material--property of copyright holder(s) Page 2
ftcp(1C) FTAM 3.00 ftcp(1C)
this option is not specified, an error is
returned if the destination file already
exists.
-dr Delete the destination file if the source
file is more recent than the destination
file. If the destination file does not exist,
it is created.
-da Append the source file to the destination
file. If the destination file does not
exist, an error is reported and the copy
operation is not performed.
-p create-file-password
Specify the create-file-password for the
destination filestore. Some FTAM responders
require a create file password before they
allow creation of files in their filestores.
An ftam-file-spec may refer to either a file on the local
file system or to a file on a virtual filestore. You
specify a file using the following syntax:
local-filename
or
filestore#filename[#initiator-identity[#password]]
where braces, [ ], indicate optional fields.
The FTAM for AViiON Systems user interface delimits fields
in an ftam-file-spec with the pound character (#). If you
want the pound character to be a part of a field value (a
filename that contains a pound character for example),
precede the pound character with a backslash (\). To
include the backslash character itself in a field value, use
two backslashes (\\). Take into account that the pound and
backslash characters are also significant under most DG/UX
shells.
Filestore is the name of an FTAM service provider whose
presentation service access point (PSAP) is maintained by
the OSI/P for AViiON Systems software. The initiator-
identity and password are used to control access to the
virtual filestore. Each FTAM responder treats filename in
an operating system specific way. The Filename section of
the ftam man page describes the FTAM for AViiON Systems
specific interpretation.
You may store initiator identities and passwords for
Licensed material--property of copyright holder(s) Page 3
ftcp(1C) FTAM 3.00 ftcp(1C)
frequently used filestores in the filestore database file,
.ftamdb, located in your home directory. If you include a
filestore in an FTAM file specification and you do not give
an initiator identity and password on the command line, the
initiator resolves them by searching .ftamdb. Use the
utility ftfs(1C) to update this file. If the filestore does
not exist in .ftamdb, initiator-identity and password are
set to NULL.
When you use prompt mode, the initiator does not search
.ftamdb. To indicate NULL for a field value, press just
NEWLINE at the prompt. You are not prompted for initiator
identity and password if you enter just NEWLINE at the
filestore prompt since a NULL filestore means local
filestore. Initiator identity and password are not used for
local requests.
EXAMPLES
% ftcp srcfs#/usr/dgf/foo#name#passwd foo-new
Copy the file /usr/dgf/foo on filestore srcfs to foo-new on
the local filestore in the current working directory. The
initiator identity name and password passwd for filestore
srcfs are taken from the command line.
% ftcp srcfs#/usr/dgf/foo#name#passwd dstfs#/fooled
Copy the file /usr/dgf/foo on filestore srcfs to /fooled on
filestore dstfs. Initiator identity and password for
filestore srcfs are specified on the command line. The
initiator identity and password for dstfs are obtained from
$HOME/.ftamdb.
FILES
$HOME/.ftamdb
FTAM attribute files
Note that Revision 3.00 FTAM for AViiON Systems stores FTAM
attribute information for a file in either system space
(where supported by the revision of DG/UX(TM) on the system)
or in a separate file located in the same directory as the
FTAM file. The attribute file has a name of the form
.ftam.filename where filename is the name of the file
associated with the attributes.
Licensed material--property of copyright holder(s) Page 4
ftcp(1C) FTAM 3.00 ftcp(1C)
SEE ALSO
ftam(1C), ftmv(1C), ftls(1C), ftfs(1C), ftrm(1C),
ftcattr(1C), ftrattr(1C).
"Using FTAM for AViiON(R) Systems".
BUGS
The FTAM for AViiON Systems executables use the '#'
character as a delimiter in the source and destination file
specifications. Some command processors use this character
as the delete character. This can cause the FTAM for AViiON
Systems executables to receive incorrect command lines from
the command interpreter. Use the appropriate escape
character for your processor to ensure that the '#'
character gets passed to the program.
Licensed material--property of copyright holder(s) Page 5