Xtp

Contents

Synopsis

xtp [ -options ... ] <uniform resource locator>

Back to Contents

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 functions as the ftp(1) program, but does not require any interactive commands. You simply specify the file transfer task on the command line and xtp performs the task automatically.

Back to Contents

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 public/documents from host wizard.dupont.com, use: 
   xtp -retrieve ftp://wizard.dupont.com/documents/public/

Back to Contents

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 processed 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 command. 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.

-ident password
Supply a password required by a remote system. This defaults to your username and hostname.

-port number
If no port number is specified, xtp attempts to contact a FTP server at the default port. Otherwise, the specified port number is used.

-proxy hostname
access the remote host via a proxy ftpd client running on this host.

The default value of this option can be set with the environment variable xtp_proxy. See Environment for more details. Use +proxy to prevent proxy connections.

-print
print files that match the filename component of the uniform resource locator. The filename component 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 command. 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 documents/xtp.man on the remote FTP server, it will appear in your remote directory as documents/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 terminates if one tenth of this value is exceeded while logging onto the remote FTP server.

Back to Contents

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 pattern 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 character not from the rest of the sequence. If two characters 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.

Back to Contents

Environment

xtp_proxy
Specifies that the remote site should be contacted by proxy. See -proxy.

Back to Contents

Copyright

Copyright 1995 E. I. du Pont de Nemours and 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. du Pont de Nemours and Company not be used in advertising or publicity pertaining to distribution of the software without specific, written prior permission. E. I. du Pont de Nemours and 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. du Pont de Nemours and Company disclaims all warranties with regard to this software, including all implied warranties of merchantability and fitness, in no event shall E. I. du Pont de Nemours and Company be liable for any special, 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 tortuous action, arising out of or in connection with the use or performance of this software.

Back to Contents

Acknowledgements

Steve Singles, University of Delaware, for the initial implementation of this program. Henry Spencer, University of Toronto, for the implementation of the regular expression interpreter and the text in Regular Expressions.

Back to Contents

Authors

John Cristy, cristy@dupont.com E.I. du Pont de Nemours and Company Incorporated.

Back to Contents

[home page]