ftrm(1C) FTAM 3.00 ftrm(1C)
NAME
ftrm - FTAM file delete program
SYNOPSIS
ftrm [ [ options ] ftam-file-spec ]
DESCRIPTION
Ftrm deletes a file. You can use FTAM for AViiON Systems to
delete empty directories (NBS-9 files); however, other FTAM
implementations may not support this.
If you invoke ftrm without arguments, you are prompted for
the target file specification.
You may group options behind the - character provided that
at most 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 and 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 a FTAM
association timeout is not set.
-i Prompt for missing filestore information. If
Licensed material--property of copyright holder(s) Page 1
ftrm(1C) FTAM 3.00 ftrm(1C)
the ftam-file-spec does not specify the
initiator identity and/or password for a
remote filestore, prompt the user for the
missing information. The password is not
echoed.
-p delete-file-password
Specify the delete-file-password for the
target file. A delete file password may be
required by some FTAM responders before the
file can actually be deleted.
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
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.
Licensed material--property of copyright holder(s) Page 2
ftrm(1C) FTAM 3.00 ftrm(1C)
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
% ftrm srcfs#/usr/dgf/foo#tuna#fish
Delete the file /usr/dgf/foo on the filestore srcfs. The
initiator identity tuna and password fish for srcfs are
specified on the command line.
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.
SEE ALSO
ftam(1C), ftcp(1C), ftmv(1C), ftls(1C), ftfs(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 3