Return to ftam.1c CVS log

Up to [CSRG BSD Unix] / 43BSDReno / contrib / isode-beta / ftam2

Annotation of 43BSDReno/contrib/isode-beta/ftam2/ftam.1c, revision 1.1

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.