XTP(1) XTP(1)
NAME
xtp - file transfer program
SYNOPSIS
xtp [ -options ... ] <host/ip address> [ <home directory>
]
DESCRIPTION
Xtp is a utility for retrieving, listing, or printing
files from a remote network site, or sending files to a
remote network site. Xtp performs most of the same func-
tions as the ftp program, but does not require any inter-
active commands. You simply specify the file transfer
task on the command line and xtp performs the task auto-
matically.
EXAMPLES
To retrieve file display.tar.Z from host wiz-
ard.dupont.com, use:
xtp -binary -retrieve display.tar.Z wizard.dupont.com
To retrieve all the files from directory public/documents
from host wizard.dupont.com, use:
xtp -binary -retrieve documents/ wizard.dupont.com
public
OPTIONS
-binary
retrieve files as binary.
-exclude expression
exclude files that match the regular expression.
-directory expression
list the names of files and their attributes that
match the regular expression.
-ident password
specifies password.
-port number
If no port number is specified, xtp attempts to
contact a FTP server at the default port. Other-
wise, the specfied port number is used.
-print expression
print files that match the regular expression.
-prune do not recursively search for files.
10 October 1992 1
XTP(1) XTP(1)
-retrieve expression
retrieve files that match the regular expression.
Retrieved files are stored on your local host
directory as the full name of the retrieved file.
For example, if the retrieved file is named docu-
ments/xtp.man on the remote FTP server, it will
appear in your home directory as documents/xtp.man.
-send expression
send files that match the regular expression.
-timeout seconds
specifies the maximum seconds to complete your
remote FTP server request. If this time expires,
the program terminates. The program also termi-
nates if one tenth of this value is exceeded while
logging onto the remote FTP server.
-user name
identify yourself to the remote FTP server.
If -user is specified but not -ident, the password is
obtained from you interactively.
-verbose
show all responses from the remote server.
If neither -print, -retrieve, or -send are specified on
the command line, a directory of files is listed for the
remote network host.
xtp recursively descends the directory hierarchy from the
home directory. Some remote hosts may have thousands of
files causing a significant delay satisfying your request.
This can be wasteful if the files you are interested in
reside in a known directory. You can reduce the searching
required by specifying <home directory> on the command
line. This limits the filename search to the specified
directory and any of its subdirectories. Alternatively,
-prune restricts the search to the home directory only.
If only the program name is specified on the command line,
the program command syntax and options are listed.
REGULAR EXPRESSIONS
A regular expression is zero or more branches, separated
by |. It matches anything that matches one of the
branches.
A branch is zero or more pieces, concatenated. It matches
a match for the first, followed by a match for the second,
etc.
10 October 1992 2
XTP(1) XTP(1)
A piece is an atom possibly followed by *, +, or ?. An
atom followed by * matches a sequence of 0 or more matches
of the atom. An atom followed by + matches a sequence of
1 or more matches of the atom. An atom followed by ?
matches a match of the atom, or the null pattern.
An atom is a regular expression in parentheses (matching a
match for the regular expression), a range (see below), .
(matching any single character), ^ (matching the null pat-
tern at the beginning of the input pattern), $ (matching
the null pattern at the end of the input pattern), a '
followed by a single character (matching that character),
or a single character with no other significance (matching
that character).
A range is a sequence of characters enclosed in []. It
normally matches any single character from the sequence.
If the sequence begins with ^, it matches any single char-
acter not from the rest of the sequence. If two charac-
ters in the sequence are separated by -, this is shorthand
for the full list of ASCII characters between them (e.g.
[0-9] matches any decimal digit). To include a literal ]
in the sequence, make it the first character (following a
possible ^). To include a literal -, make it the first or
last character.
SEE ALSO
ftp(1C)
COPYRIGHT
Copyright 1990 E. I. Dupont de Nemours & Company
Permission to use, copy, modify, distribute, and sell this
software and its documentation for any purpose is hereby
granted without fee, provided that the above copyright
notice appear in all copies and that both that copyright
notice and this permission notice appear in supporting
documentation, and that the name of E. I. Dupont de
Nemours & Company not be used in advertising or publicity
pertaining to distribution of the software without spe-
cific, written prior permission. E. I. Dupont de Nemours
& Company makes no representations about the suitability
of this software for any purpose. It is provided "as is"
without express or implied warranty.
E. I. Dupont de Nemours & Company disclaims all warranties
with regard to this software, including all implied war-
ranties of merchantability and fitness, in no event shall
E. I. Dupont de Nemours & Company be liable for any spe-
cial, indirect or consequential damages or any damages
whatsoever resulting from loss of use, data or profits,
whether in an action of contract, negligence or other tor-
tious action, arising out of or in connection with the use
or performance of this software.
10 October 1992 3
XTP(1) XTP(1)
ACKNOWLEDGEMENTS
Steve Singles, University of Delaware, for the initial
implementation of this program.
Henry Spencer, University of Toronto, for the implementa-
tion of the regular expression interpreter and the text in
REGULAR EXPRESSIONS.
AUTHOR
John Cristy, E.I. DuPont De Nemours & Company Incorporated
10 October 1992 4