ftrattr(1C) FTAM 3.00 ftrattr(1C)
NAME
ftrattr - FTAM read file attributes program
SYNOPSIS
ftrattr [ [ options ] ftam-file-spec ]
DESCRIPTION
Ftrattr displays the FTAM file attributes of the file
specified on the command line. Attributes are listed a line
at a time. The general format is attribute name, colon,
attribute value. Not every filestore supports every FTAM
attribute. Ftrattr queries the specified filestore for all
attributes and prints the values of any attributes returned.
If you invoke ftrattr without arguments, you are prompted
for the target file specification and output format.
Options may be grouped behind the - 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.
Licensed material--property of copyright holder(s) Page 1
ftrattr(1C) FTAM 3.00 ftrattr(1C)
-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 Print attributes in a ls(1) like format. A
warning message is printed if the connection
is not to a FTAM for AViiON Systems
responder.
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. See the Filename section
of the ftam man page for details on 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
Licensed material--property of copyright holder(s) Page 2
ftrattr(1C) FTAM 3.00 ftrattr(1C)
an initiator identity and password on the command line, they
are resolved 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, .ftamdb is not searched. Entering
just NEWLINE at any prompt in prompt mode indicates NULL for
that field. You are not prompted for initiator identity and
password if you enter NEWLINE at the filestore prompt since
a NULL filestore means local filestore. Initiator identity
and password are not used for local requests.
EXAMPLES
% ftrattr /home/xtc/textfile
Filename: /home/xtc/textfile
Filesize: 1216
Contents Type:
- Document Type: FTAM-1
- Universal Class: IA5String(22)
- String Significance: Not-Significant
- Maximum String Length: 1024
Permitted Actions: Rd Rp Er Ex Ra Ca Df
Access Control: OWNER Rd - Rp Er Ex Ra Ca Df
GROUP Rd - - - - Ra - -
OTHER Rd - - - - Ra - -
ftamtest Rd - Rp Er Ex Ra Ca Df
File Availability: Immediate
Date/Time
Modification: 04-Feb-92 21:15:55 [+05:00]
Reader: 13-Apr-92 18:23:39 [+05:00]
Attribute Modification: 04-Feb-92 21:15:55 [+05:00]
Identity
Creator: ftamtest
Read the FTAM attributes of the file /home/xtc/textfile on
the local filestore.
% ftrattr -dg rhost#/usr/include/stdio.h#felix#flea
Filename: /usr/include/stdio.h
Permissions: -rw-rw-r--
User-id: bin
Group-id: bin
Filesize: 18294
Time last accessed: Jun 28 19:35
Time last modified: Apr 17 12:35
Read the DG/UX attributes of the file /usr/include/stdio.h
on the FTAM for AViiON systems filestore rhost. The
initiator identity felix and password flea are specified on
Licensed material--property of copyright holder(s) Page 3
ftrattr(1C) FTAM 3.00 ftrattr(1C)
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), ftcattr(1C), ftcp(1C), ftfs(1C), ftls(1C),
ftmv(1C), ftrm(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