![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to ftam.1c CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [CSRG BSD Unix] / 43BSDReno / contrib / isode-beta / ftam2|
Return to ftam.1c CVS log | Up to [CSRG BSD Unix] / 43BSDReno / contrib / isode-beta / ftam2 |
1.1 root 1: .TH FTAM 1C "01 Mar 1987"
2: .\" $Header: /f/osi/ftam2/RCS/ftam.1c,v 7.1 90/01/11 18:35:47 mrose Exp $
3: .\"
4: .\"
5: .\" $Log: ftam.1c,v $
6: .\" Revision 7.1 90/01/11 18:35:47 mrose
7: .\" real-sync
8: .\"
9: .\" Revision 7.0 89/11/23 21:54:26 mrose
10: .\" Release 6.0
11: .\"
12: .SH NAME
13: ftam \- interactive ftam initiator
14: .SH SYNOPSIS
15: .in +.5i
16: .ti -.5i
17: .B ftam
18: \%[options]
19: \%[host]
20: \%[command\0arguments\0...]
21: .in -.5i
22: .SH DESCRIPTION
23: The \fIftam\fR program implements the initiator side of
24: the File Transfer, Access, and Management (FTAM) service.
25: .PP
26: Currently, implementations for Berkeley and AT&T UNIX exist.
27: Supported are:
28: the no-recovery FTAM-QoS;
29: any of
30: the transfer, management, and transfer and management service classes;
31: the kernel, read, write, limited file management, enhanced file management, and
32: grouping functional units;
33: and, the kernel and storage attribute groups.
34: Only three document types are supported as of this writing:
35: unstructured text files (FTAM\-1),
36: unstructured binary files (FTAM\-3),
37: and filedirectory files (NBS\-9).
38: .PP
39: Typing INTR at the top\-level does nothing,
40: but typing it twice in a row at the top\-level terminates \fIftam\fR;
41: typing INTR during additional prompting causes \fIftam\fR to abort the command;
42: typing INTR during file transfer causes the transfer to be aborted.
43: .PP
44: On start-up, \fIftam\fR will read a file called \fB\&.ftamrc\fR in the
45: user's home directory.
46: This file, if present, contains user-preference commands.
47: .SH COMMANDS
48: .TP
49: .B append\fR\0source\0destination
50: Appends to a file in the filestore.
51: .TP
52: .B cd\fR\0\%[dir]
53: Changes the working directory on the virtual filestore.
54: This requires the \fBrealstore\fR variable to be set appropriately.
55: .TP
56: .B chgrp\fR\0group\0file\0...
57: Changes the account attribute of the named files.
58: .TP
59: .B close
60: Terminates the association with the virtual filestore.
61: .TP
62: .B dir\fR\0\%[file]
63: Prints a long directory listing.
64: .TP
65: .B echo\fR\0file\0...
66: Simply echoes any arguments.
67: Useful for seeing how globbed expressions will evaluate.
68: .TP
69: .B fdir\fR\0stream\0\%[file]
70: Prints a long directory listing to a file or program.
71: If \*(lqstream\*(rq starts with a vertical bar \*(lq|\*(rq,
72: then the named program is invoked;
73: otherwise the named file is written.
74: .TP
75: .B fls\fR\0stream\0\%[file]
76: Prints a directory listing to a file or program.
77: If \*(lqstream\*(rq starts with a vertical bar \*(lq|\*(rq,
78: then the named program is invoked;
79: otherwise the named file is written.
80: .TP
81: .B get\fR\0source\0destination
82: Retrieves a file.
83: .TP
84: .B help\fR\0\%[command]
85: Prints help information.
86: For detailed information, try \*(lqhelp\0?\*(rq.
87: .TP
88: .B lcd\fR\0\%[file]
89: Changes the working directory on the local system.
90: .TP
91: .B ls\fR\0\%[file]
92: Prints a directory listing.
93: .TP
94: .B mkdir\fR\0dir\0...
95: Creates a directory.
96: .TP
97: .B mv\fR\0source\0destination
98: Renames a file.
99: .TP
100: .B open\fR\0host\0user\0\%[account]
101: Associates with the virtual filestore.
102: .TP
103: .B put\fR\0source\0destination
104: Stores a file.
105: .TP
106: .B pwd
107: Prints the working directories.
108: .TP
109: .B quit
110: Terminates the association with the virtual filestore and exits.
111: .TP
112: .B rm\fR\0file\0...
113: Deletes a file.
114: .TP
115: .B set\fR\0variable\0value
116: Displays or changes variables.
117: For detailed information, try \*(lqset\0?\*(rq.
118: .TP
119: .B status
120: Shows the current status.
121: .SH VARIABLES
122: .TP
123: .B bell
124: Rings the bell after each command terminates.
125: Useful for long file transfers when you want to attend to other matters and
126: be notified when you can type another command.
127: Boolean (values: \fBon\fR or \fBoff\fR).
128: .TP
129: .B debug
130: This enables voluminous output during file transfers,
131: among other things. Boolean.
132: .TP
133: .B glob
134: This enables the expansion of shell meta\-characters.
135: Operations which perform globbing
136: require the \fBrealstore\fR variable to be set appropriately.
137: Boolean.
138: .TP
139: .B hash
140: This enables the printing of hash marks during file transfers.
141: Values: \fIoff\fR; \fIon\fR; \fItotal\fR.
142: .TP
143: .B override
144: This sets the creation override mode for files being written to the virtual
145: filestore.
146: Values:
147: \fBfail\fR,
148: the creation operation;
149: \fBselect\fR,
150: use the existing file with its old contents and attributes
151: (i.e., the put command acts like the append command);
152: \fBwrite\fR,
153: zero-truncate if it already exists, and use the existing file with its old
154: attributes;
155: \fBdelete\fR,
156: if it already exists, then create a new file with new attributes.
157: This defaults to \*(lqwrite\*(rq.
158: .TP
159: .B qualifier
160: This sets the \*(lqqualifier\*(rq portion of the service which
161: \fIftam\fR will associate with.
162: It is needed when using the current implementation of the MITRE
163: FTAM/FTP gateway.
164: This defaults to \*(lqfilestore\*(rq.
165: .TP
166: .B query
167: This determines if \fIftam\fR should ask the user to confirm operations
168: involving globbing that expand to more than one filename.
169: Boolean.
170: This defaults to \*(lqon\*(rq.
171: .TP
172: .B realstore
173: Sets the type of remote realstore associated with the virtual filestore.
174: This is used to help \fIftam\fR act friendlier to the user!
175: Values: \fBunix\fR, \fBunknown\fR.
176: Note well: the concept of a \fBrealstore\fR is contrary to the notion of
177: open systems as it is an N*M (not N+M) method.
178: .TP
179: .B trace
180: This enables the tracing of FTAM PDUs. Boolean.
181: .TP
182: .B tracefile
183: This defines the file where tracing information is appended.
184: Note that the pathname of this file is interpreted relatively to the
185: ISODE logging area.
186: To have tracing information written to a file in the current
187: directory,
188: start the filename with \*(lq./\*(rq.
189: .TP
190: .B type
191: This defines the file transfer mode to use.
192: Values: \fBdefault\fR, \fBbinary\fR, \fBtext\fR.
193: .TP
194: .B verbose
195: This enables printing of informative diagnostics during operation. Boolean.
196: .TP
197: .B watch
198: This enables watch mode,
199: something in between debug mode (too voluminous),
200: and verbose mode (not informative enough). Boolean.
201: .TP
202: .B \fIx\fBsapfile
203: This defines the file where \fIx\fRPDU tracing information is appended.
204: Value: any filename, or \*(lq\-\*(rq for the diagnostic output.
205: .TP
206: .B \fIx\fBsaplevel
207: This enables tracing of the \fIx\fR module.
208: Values: \fBnone\fR, \fBfatal\fR, \fBexceptions\fR, \fBnotice\fR,
209: \fBpdus\fR, \fBtrace\fR, \fBdebug\fR, and \fBall\fR.
210: .SH OPTIONS
211: .TP
212: .B \-a\0\fIacct\fR
213: Sets the account to be used on the virtual filestore.
214: .TP
215: .B \-d
216: Sets \fBdebug\fR.
217: .TP
218: .B \-f
219: Inhibits reading of the user's \fB\&.ftamrc\fR on startup.
220: .TP
221: .B \-h
222: Sets \fBhash\fR.
223: .TP
224: .B \-o\0\fImode\fR
225: Sets \fBoverride\fR.
226: .TP
227: .B \-t
228: Sets \fBtrace\fR.
229: .TP
230: .B \-u\0\fIuser\fR
231: Sets the initiator identity to be used on the virtual filestore.
232: .TP
233: .B \-v
234: Sets \fBverbose\fR (default for interactive use).
235: .TP
236: .B \-w
237: Sets \fBwatch\fR.
238: .SH FILES
239: .nf
240: .ta \w'\*(EDisodocuments 'u
241: \*(EDisodocuments ISODE FTAM document types database
242: \*(EDisoentities ISODE entities database
243: $HOME/\&.ftamrc runcom file
244: .re
245: .fi
246: .SH "SEE ALSO"
247: libftam(3n), ftamd(8c),
248: .br
249: \fIThe ISO Development Environment: User's Manual\fR,
250: .br
251: ISO 8571:
252: \fIInformation Processing Systems \-\-
253: File Transfer, Access, and Management\fR
254: .SH DIAGNOSTICS
255: All obvious.
256: .SH AUTHOR
257: Marshall T. Rose
258: .br
259: This program is based heavily on the \fIftp\fR(1c) program supplied with
260: Berkeley UNIX.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.