XTP(1)
NAME
xtp - file transfer program
SYNOPSIS
xtp [ -options ... ] <uniform resource locator>
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(1) program, but does not require any
interactive commands. You simply specify the file trans-
fer task on the command line and xtp performs the task
automatically.
EXAMPLES
To retrieve the file bird.jpg in directory images from
host wizard.dupont.com, use:
xtp ftp://wizard.dupont.com/images/bird.jpg
To retrieve all the files from directory images as user
cristy from host wizard.dupont.com, use:
xtp -retrieve ftp://cristy@wizard.dupont.com/images
You will be prompted for a password.
To retrieve all the files from directory images as user
cristy and password magick from host wizard.dupont.com,
use:
xtp -retrieve ftp://cristy:magick@wiz-
ard.dupont.com/images
OPTIONS
-account password
Supply a supplemental password required by a remote
system for access to resources.
-binary
retrieve files as binary. This is the default.
Use +binary to retrieve files as text.
-directory
list the names of files and their attributes that
match the filename component of the uniform
resource locator. The filename component is pro-
cessed as a regular expression.
-exclude expression
exclude files that match the regular expression.
This option applies to the -directory, -print, or
-retrieve options.
-file name
store the file with this name.
Refer to the -get and -put option for more details.
-get get files that match the filename component of the
uniform resource locator. The filename component
is expanded by passing it to csh(1).
This option is equivalent to using the ftp get com-
mand. However, if the filename contains globbing
characters this option is equivalent to the ftp
mget command. Without globbing characters, you can
store the file locally with a different name by
using the -file option.
-port number
If no port number is specified, xtp attempts to
contact a FTP server at the default port. Other-
wise, the specified port number is used.
-proxy hostname
access the remote host via a proxy ftpd client run-
ning on this host.
The default value of this option can be set with
the environment variable xtp_proxy. See ENVIRON-
MENT for more details. Use +proxy to prevent proxy
connections.
-print print files that match the filename component of
the uniform resource locator. The filename compo-
nent is processed as a regular expression.
-prune process files in the remote directory specified by
the directory component of the uniform resource
locator. Do not recursively search for files.
-put put files that match the filename component of the
uniform resource locator. The filename component
is expanded by passing it to csh(1).
This option is equivalent to using the ftp put com-
mand. However, if the filename contains globbing
characters this option is equivalent to the ftp
mput command. Without globbing characters, you can
store the file remotely with a different name by
using the -file option.
-retrieve
retrieve files that match the filename component of
the uniform resource locator. The filename
component is processed as a 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 remote directory as docu-
ments/xtp.man.
-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.
-type name
identify the remote system type: UNIX, VMS, or
other.
The system type is determined automatically, how-
ever, you can override the system type with this
option.
-verbose
show all responses from the remote server.
If only the program name is specified on the command line,
the program command syntax and options are listed.
If neither -directory, -print, -put, or -retrieve are
specified on the command line, the file or files specified
by the uniform resource locator is retrieved from the
remote network host (as if -get was specified).
<uniform resource locator> has the format:
protocol://host/[directory/[filename]]
where protocol is ftp and host is [user[:password]]@host-
name. User defaults to anonymous and password defaults to
host.domain. Note that directory/[filename] is inter-
preted relative to the home directory for user, thus an
absolute pathname must be specified with the leading /:
ftp://host//tmp/anyfile
As an extension, the filename part of the locator is
expanded by the shell for options -get or -put, otherwise
it is processed as a regular expression. For convenience,
the protocol component of the uniform resource locator
(ftp://) may be omitted.
Xtp retrieves files from the remote directory for -get and
puts files in the remote directory for -put. Otherwise,
xtp looks for a file of the form ls-lls-l([Rt])+([Rt])*
and assumes it contains a recursive directory listing. If
none is found, xtp recursively descends the directory
hierarchy from the remote 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
<remote 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 remote directory only.
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.
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.
ENVIRONMENT
xtp_proxy
Specifies that the remote site should be contacted
by proxy. See -proxy.
FILES
~/.netrc
SEE ALSO
ftp(1C) Mosaic(1)
COPYRIGHT
Copyright 1998 E. I. du Pont de Nemours and Company
Permission is hereby granted, free of charge, to any per-
son obtaining a copy of this software and associated docu-
mentation files ("ImageMagick"), to deal in ImageMagick
without restriction, including without limitation the
rights to use, copy, modify, merge, publish, distribute,
sublicense, and/or sell copies of ImageMagick, and to per-
mit persons to whom the ImageMagick is furnished to do so,
subject to the following conditions:
The above copyright notice and this permission notice
shall be included in all copies or substantial portions of
ImageMagick.
The software is provided "as is", without warranty of any
kind, express or implied, including but not limited to the
warranties of merchantability, fitness for a particular
purpose and noninfringement. In no event shall E. I. du
Pont de Nemours and Company be liable for any claim, dam-
ages or other liability, whether in an action of contract,
tort or otherwise, arising from, out of or in connection
with ImageMagick or the use or other dealings in ImageMag-
ick.
Except as contained in this notice, the name of the E. I.
du Pont de Nemours and Company shall not be used in adver-
tising or otherwise to promote the sale, use or other
dealings in ImageMagick without prior written authoriza-
tion from the E. I. du Pont de Nemours and Company.
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 and Company Incorpo-
rated