ftls(1C) FTAM 3.00 ftls(1C)
NAME
ftls - FTAM file list program
SYNOPSIS
ftls [ [ options ] ftam-file-spec ]
DESCRIPTION
Ftls produces a list of files in a specified directory.
If you invoke ftls without arguments, you are prompted for
the target file specification and output format.
The default output format is one filename per line. Most
FTAM responders guarantee that a special directory file
named DIRLIS exists and is always readable. The FTAM for
AViiON Systems responder maps DIRLIS to the initiator
identity's home directory.
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
Licensed material--property of copyright holder(s) Page 1
ftls(1C) FTAM 3.00 ftls(1C)
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
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.
-dg List the DG/UX access control, owner of file,
group to which owner belongs, filesize, date
of modification, and filename on one line for
each file. This option is analogous to the
DG/UX ls(1) command with the '-l' option. If
ftam-file-spec does not specify a DG/UX
filestore running FTAM for AViiON Systems
responder, a warning message is printed and,
if the responder supports NBS-9 files
(directories), any attributes returned are
printed one per line.
-l List of the filesize, FTAM contents type,
FTAM access control, and filename on one line
for each file in the directory. Note that
complete pathnames are printed.
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
Licensed material--property of copyright holder(s) Page 2
ftls(1C) FTAM 3.00 ftls(1C)
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.
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
% ftls -l srcfs#/var/cron#jockey#horses
NBS-9 Rd Ra Ca Df 512 /var/cron/.
NBS-9 Rd Ra Ca Df 512 /var/cron/..
FTAM-3 Rd Rp Er Ex Ra Ca Df 556497 /var/cron/log
Generate a long listing with FTAM attributes of files in
directory /var/cron on filestore srcfs. The initiator
identity jockey and password horses are specified on the
command line.
% ftls -dg fs2#/tmp
-rwxrwxrwx ? mickey disney 4878 Jul 2 17:54 magic.c
-rwxrwxrwx ? donald disney 239 Jun 18 17:27 temp.file
-rw-rw-rw- ? mickey disney 8571400 Jun 26 18:44 core
Generate a listing with DG/UX attributes of files in
Licensed material--property of copyright holder(s) Page 3
ftls(1C) FTAM 3.00 ftls(1C)
directory /tmp on filestore fs2. The initiator identity and
password for fs2 are obtained from $HOME/.ftamdb.
% ftls /usr
/usr/lands
/usr/future
Generate a short listing of just filenames in directory /usr
on the local filestore.
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), ftrm(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 4