=J 4 H C ImageMagick - Image Processing and Display Package; E
H ImageMagick

 
Ú
>Contents





Ú
>Synopsis




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

*Back to Contents




Ý
>Description





GXtp is a utility for retrieving, listing, or printing files fromLa remote network site, or sending files to a remote network site. xtpJperforms most of the same functions as the ftp(1) program, but doesJnot require any interactive commands. You simply specify the file transferMtask on the command line and xtp performs the task automatically.

*Back to Contents




Ú
>Examples




ITo retrieve the file bird.jpg in directory images from host#wizard.wizards.dupont.com, use:





Axtp ftp://wizard.wizards.dupont.com/images/bird.jpg





dTo retrieve all the files from directory images from host wizard.wizards.dupont.com, use:





Cxtp -retrieve ftp://wizard.wizards.dupont.com/images/





$You will be prompted for a password.
 

LTo retrieve all the files from directory images as user magick$and password magick from host#wizard.wizards.dupont.com, use:







Qxtp -retrieve ftp://magick:magick@wizard.wizards.dupont.com/images/


*Back to Contents




Ù
>Options




FOptions are processed in command line order. Any option you specify onOthe command line remains in effect until it is explicitly changed by specifying.the option again with a different effect.
 
Ã
>-account-password

HSupply a supplemental password required by a remote system for access toresources.





à
>-binary

2retrieve files as binary. This is the default. Use+binary to retrievefiles as text.





ã
>-directory

Nlist the names of files and their attributes that match the filename componentGof the uniform resource locator. The filename component is processed asa 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.




FRefer to the -get and -put option for more details.





Ý
>-get

Lget files that match the filename component of the uniform resource locator.GThe filename component is expanded by passing it to csh(1).




NThis option is equivalent to using the ftp get command. However,Fif the filename contains globbing characters this option is equivalentGto the ftp mget command. Without globbing characters, youJcan store the file locally with a different name by using the -file option.





Á
>-ident-password

MSupply a password required by a remote system. This defaults to your usernameand hostname.





À
>-port+number

KIf no port number is specified, xtp attempts to contact a FTP serverGat the default port. Otherwise, the specified port number is used.





Á
>-proxy-hostname

Paccess the remote host via a proxy ftpd client running on this host.




IThe default value of this option can be set with the environment variableNxtp_proxy. See Environment for more details.4Use +proxy to prevent proxy connections.





ß
>-print

Nprint files that match the filename component of the uniform resource locator.AThe filename component is processed as a regular expression.





ß
>-prune

Jprocess files in the remote directory specified by the directory componentJof the uniform resource locator. Do not recursively search for files.





Ý
>-put

Lput files that match the filename component of the uniform resource locator.GThe filename component is expanded by passing it to csh(1).




NThis option is equivalent to using the ftp put command. However,Gif the filename contains globbing characters, this option is equivalent$to the ftp mput command.




MWithout globbing characters, you can store the file remotely with a different+name by using the -file option.





â
>-retrieve

Hretrieve files that match the filename component of the uniform resourceJlocator. The filename component is processed as a regular expression.




HRetrieved 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.mancon the remote FTP server, it will appear in your remote directory as documents/xtp.man.





Ã
>-timeout,seconds

Ispecifies the maximum seconds to complete your remote FTP server request.IIf this time expires, the program terminates. The program also terminatesHif 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.

FThe system type is determined automatically, however, you can override&the system type with this option.





á
>-verbose

/show all responses from the remote server.


 


FIf only the program name is specified on the command line, the program+command syntax and options are listed.

<If neither -directory, -print, -put, or-retrieveEare specified on the command line, the file or files specified by theKuniform resource locator is retrieved from the remote network host'(as if -get was specified).




-Uniform resource locator has the format:
D
    protocol://host/[directory/[filename]]

*where protocol is ftp and host is$[user[:password]]@hostname.RUser defaults to anonymous and password defaults to host.domain. Note that<directory/[filename] is interpreted relative to theMhome directory for user, thus an absolute pathname must be specified!with the leading /;
5
    ftp://host//tmp/anyfile

JAs an extension, the filename part of the locator is expanded by the shellFfor options -get or -put, otherwise it is processed as aJregular expression. For convenience, the protocol component of the uniform7resource locator (ftp://) may be omitted.




HXtp retrieves files from the remote directory for -get andIputs files in the remote directory for -put. Otherwise, xtpHlooks for a file of the form ls-lls-l([Rt])+([Rt])* and assumesGit contains a recursive directory listing. If none is found, xtpGrecursively descends the directory hierarchy from the remote directory.ISome remote hosts may have thousands of files causing a significant delayMsatisfying your request. This can be wasteful if the files you are interestedHin reside in a known directory. You can reduce the searching required byGspecifying remote directory on the command line. This limits theIfilename search to the specified directory and any of its subdirectories.IAlternatively, -prune restricts the search to the remote directory only.

*Back to Contents




»
>Regular)Expressions




FA regular expression is zero or more branches, separatedGby |. It matches anything that matches one of the branches.




IA branch is zero or more pieces, concatenated. It matches a match for the4first, followed by a match for the second, etc.




>A piece is an atom possibly followed by *, +, or ?.GAn atom followed by * matches a sequence of 0 or more matches ofFthe atom. An atom followed by + matches a sequence of 1 or moreHmatches of the atom. An atom followed by ? matches a match of theatom, or the null pattern.




FAn atom is a regular expression in parentheses (matchingGa match for the regular expression), a range (see below),M. (matching any single character), ^ (matching the null patternKat the beginning of the input pattern), $ (matching the null patternKat the end of the input pattern), a ' followed by a single characterK(matching that character), or a single character with no other significance(matching that character).




FA range is a sequence of characters enclosed in []. It normallyFmatches any single character from the sequence. If the sequence beginsGwith ^, it matches any single character not from the rest of theFsequence. If two characters in the sequence are separated by -,Jthis is shorthand for the full list of ASCII characters between them (e.g.F[0-9] matches any decimal digit). To include a literal ]Min the sequence, make it the first character (following a possible ^).HTo include a literal -, make it the first or last character.


*Back to Contents






×
>Files
 

ê
>~/.netrc


*Back to Contents




Ý
>Environment
 
â
>xtp_proxy

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


*Back to Contents




â
>Acknowledgements





SSteve Singles, University of Delaware, for the initial implementationof this program.





JHenry Spencer, University of Toronto, for the implementationCof the regular expression interpreter and the text inRegularExpressions.

#Back to Contents




Ù
>Authors





cJohn Cristy, magick@wizards.dupont.comImageMagick Studio.

#Back to Contents




Û
>Copyright




1Copyright (C) 2000 ImageMagick Studio








HPermission is hereby granted, free of charge, to any person obtainingKa copy of this software and associated documentation files ("ImageMagick"),Hto deal in ImageMagick without restriction, including without limitationHthe rights to use, copy, modify, merge, publish, distribute, sublicense,Pand/or sell copies of ImageMagick, and to permit persons to whom the ImageMagickDis furnished to do so, subject to the following conditions:




JThe above copyright notice and this permission notice shall be included>in all copies or substantial portions of ImageMagick.





JThe software is provided "as is", without warranty of any kind, expressKor implied, including but not limited to the warranties of merchantability,Ffitness for a particular purpose and noninfringement.In no event shall6ImageMagick Studio be liable for any claim, damages orMother liability, whether in an action of contract, tort or otherwise, arisingKfrom, out of or in connection with ImageMagick or the use or other dealingsin ImageMagick.





GExcept as contained in this notice, the name of the E. I. du Pont deLNemours and Company shall not be used in advertising or otherwise to promoteRthe sale, use or other dealings in ImageMagick without prior written authorization%from the ImageMagick Studio.

*Back to Contents




Home Page  9Image manipulation software that works like magic.