Provided by: wput_0.6.2+git20130413-11_amd64 
NAME
wput - A wget-like ftp-uploader
SYNOPSIS
wput [options] file [file ...] URL
DESCRIPTION
Wput is a free utility that is able to upload files to a ftp-server.
Wput is non-interactive and background-capable. It can upload files or whole directories
and is meant to be a robust client even for unstable connections and will therefore retry
to upload a file, if the connection broke.
Wput supports resuming, so it automatically continues uploading from the point where the
previous upload stopped, meaning that you can kill Wput anytime and it will (if the remote
ftp-server supports this, being most likely the case) finish the partial uploaded file.
Wput supports connections through proxies, allowing you to use it in an environment that
can access the internet only via a proxy or to provide anonymity by hiding your ip-address
to the server. For SOCKSv5-proxies Wput supports also listening mode, allowing you to use
port-mode ftp through a proxy (useful if the remote ftp is behind a firewall or a
gateway).
Wput supports timestamping, so it will (in the ideal case and if timestamping is enabled)
only upload files, that are newer than the remote-file.
The upload-rate of Wput can be restricted, so that Wput won't eat all available bandwidth.
URL-Input-Handling
URLs are recognized by the ftp://-prefix
Wput first reads the URLs from command-line, and associates the first file with the first
URL, the second file with the second URL etc. It then transmits the file/URL combinations
that are already complete. Afterwards, Wput uses the --input-file (if any) and reads the
URLs using the same sheme as above. In situations where more URLs than files are
specified, Wput tries to guess the local filename from the URL. In case there are more
files that URLs remaining, Wput uses the last known URL for each of the files.
So you can specify e.g. one URL and read all filenames from a file. Or use wput *.txt
ftp://host, to transfer all *.txt-files. See doc/USAGE.examples for further examples.
To be on the safe side, it is recommended to supply the files before the URLs.
Guessing Local File
If Wput has an URL without a corresponding filename, Wput tries to guess the local file's
location. e.g. using wput ftp://host/directory/path/file, Wput will look out for
/directory/path/file. If not found, Wput looks for ./directory/path/file, ./path/file and
./file.
OPTIONS
Logging and Input File Options
-a logfile, --append-output=logfile
Append all logged messages to logfile.
--basename=path
This option causes Wput to snip path from all input-files when they are connected
to the URL. wput /usr/share/doc.tgz ftp://host/ would create
ftp://host//usr/share/doc.tgz, whereas specifying /usr/share/ as basename will
result in ftp://host/doc.tgz being created.
-i file, --input-file=file
Reads URLs and filenames from file. If there are URLs on the command-line too,
these will be retrieved first, unless sorting is enabled. See also the URL-Input-
Handling section.
If file is -, the URLs will be read from stdin. If you want to pipe the contents
of the file that shall be uploaded to stdin, this cannot be done (yet). But you can
use the --input-pipe flag and read the contents a) from a named pipe -I "cat
named.pipe; echo > /dev/null" or b) directly from the command, that outputs the
data. (See --input-pipe)
Do not do things like find | wput ftp://host/ -i -! Wput would upload all files
from the current directory (since the first output of find will be '.') and
afterwards each file again (since find postes its name to Wput. And further
problematic is that Wput will upload each directory that is given by find and since
find itself recurses all directories, the files would be uploaded three times (or
even more often for further subdirectories). Use wput ftp://host/ to upload
everything from the local directory. Or use find ! -type d | wput ftp://host/ -i -
to tell find, not to output directories.
-I command, --input-pipe=command
If no file/directory can be "guessed" (see "Guessing Local File") from the URL, the
output of command is taken as file-input. command is invoked as follows:
command ftp "username" "ip/hostname" port "remote_directory"
"remote_filename"
The hostname is only supplied if the ip cannot be resolved. If you do not want
these parameters to confuse the program from which you read the contents, use
something like '-I "cat file; echo > /dev/null"' so that these parameters are
passed to echo and to /dev/null afterwards. Since the progressbar is not capable
of handling unknown filesizes, the filesize is set to 1 GiB. Therefore the ETA
shows a wrong value.
-nv, --less-verbose
Be less verbose. That means reducing Wput's output to a minimum. Specifying this
flag more often is equal to the --quiet flag. Some people also like combining the
-v and -nv flags, being quite senseless.
-o logfile, --output-file=logfile
Log all messages to logfile.
-q, --quiet
Turn off Wput's output.
-R, --remove-source-files
Unlinks/deletes files that have been successfully transmitted.
-s, --sort
If sorting is enabled Wput first reads all URLs from any input-devices available
and will sort them before transmitting each file.
The sorting order is: ip/hostname, port, username, password, directory, filename.
Sorting requires a bit more memory since all data needs to be held there.
-v, --verbose
Turn on verbose output. This gives some more information about what Wput does. If
you specify this flag twice, you get debug output.
Upload Options
-A, --ascii
Wput automatically determines which transfer-format to use, by looking at the file-
extensions. Certain files are recognized as ASCII. These are: txt, c, java, cpp,
sh, f, f90, f77, f95, bas, pro, csh, ksh, conf, htm, html, php, pl, cgi, ing, js,
asp, bat, cfm, css, dhtml, diz, h, hpp, ini, mak, nfo, shtml, shtm, tcl, pas
Specifying this flag forces Wput to use ASCII mode file transfers.
-b, --background
Go to background immediately after startup. If no output file is given, wput will
redirect its output to "./wputlog"
-B, --binary
Specifying this flag forces Wput to use BINARY mode file transfers.
--bind-address=address
When making client TCP/IP connections, bind() to address to address on the local
machine. address may br specified as a hostname or IP address. This option can be
useful if your machine is bound to multiple IPs. --force-tls If this flag is
specified and Wput is linked with the OpenSSL-library, the flag enforces the usage
of TLS: If no TLS-connection can be established the process will cancel and not try
to go on with an unencrypted connection.
Basic Startup Options
-l rate, --limit-rate=rate
If you don't want Wput to eat up all available bandwidth, specify this flag. rate
is a numeric value. The units 'K' (for KiB) and 'M' (for MiB) are understood.
The upload rate is limited on average, meaning that if you limit the rate to 10K
and Wput was just able to send with 5K for the first seconds, it will send (if
possible) afterwards more than 10K until the average rate of 10K is fulfilled.
-m, --chmod
This will change the access mode of the transferred files. The format is the three-
digit octal unix mode, e.g. 644 means rw-r--r--.
-nc, --dont-continue
If this flag is specified, resuming will be turned off, meaning that a remote file
being smaller than the local one will be overwritten. To skip this file, you have
to enable --skip-existing.
See also doc/USAGE.resumehandling
-N, --timestamping
If timestamping is enabled, Wput will retrieve a directory list and parse it to
determine the remote file-date. If the local file is newer than the remote one
(there is a default allowed timevariance of 5 seconds, which can be adjusted in the
wputrc-file) it is uploaded, otherwise skipped.
The local date is dermined by the mtime (time of last modification), using the
current time-zone. This should be equal to the output of ls -l.
Since you usually do not want to resume existing files, you should employ the
--reupload --dont-continue flags as well.
-p, --port-mode
Per default, Wput uses passive mode ftp, which works well for most configurations.
If passive mode fails, Wput automatically falls back to port mode.
If you want Wput to start using port mode ftp, specify this flag.
--proxy=mode
Alias is option -Y. The mode can be either http for http-based proxies (such as
SQUID), socks for SOCKSv5 proxies or off to disable the proxy.
--proxy-user=name
If the proxy-server requires authentication, use NAME as user-name. You need to
specify --proxy-pass too. These information can also be stored in the wputrc-file.
--proxy-pass=password
Specifies the password to use for the proxy.
FTP Options
--no-directories
If Wput is unable to CWD into a directory, it will try to create it. If this is not
the desired behaviour specify this flag to force Wput not to create any
directories.
-t number, --tries=number
Set number of retries to number. Specify -1 for infinite retrying, which is
default, too.
-u, --reupload
If this flag is specified, a remote file having the same size as the local one is
to be uploaded. Skipping is default.
--skip-larger
If this flag is specified, a remote file being larger than the local one will be
skipped. Default is reuploading it.
--skip-existing
If this flag is specified, the upload of a file will be skipped if the remote file
already exists.
General options
-V, --version
Display the version of wput.
-h, --help
Print a help screen, with a short description of wput's command-line options.
DIAGNOSTICS
Normally, the exit status is 0 if either everything went fine or there was nothing to do.
If some files were skipped during the upload (due to timestamping or resume-rules) the
exit status is set to 1. If some files failed to be transmitted due to an remote error,
exit status is 2. If some files failed and some others were skipped, exit status is 3. For
general problems like failure of some system-functions the exit status is 4.
BUGS
You are welcome to send bug reports and suggestions about Wput through the Sourceforge
Bugtracking System: http://sourceforge.net/tracker/?group_id=141519
Please send all available information that might concern this bug (e.g. Operating System
and what can be done to reproduce the error). Supply also the debug-output (but remove
confidential data if any), which helps a lot analysing the problem. If you use a wputrc
file, it might also be useful to provide the relevant parts of it.
If there is a crash due to a segfault or similar, try to run it in a debugger, e.g. gdb
/usr/bin/wput core and type where to get the backtrace. It would also be great help if you
could recompile wput with memory-debugging support (make clean; make memdbg; [make
install]) and use this debug-dump.
SEE ALSO
Many options can be set in a wputrc file. For its documentation consult the sample file
provided by Wput. There are some USAGE.* files in the doc/ directory of Wput. These
contain further information and samples on how to use Wput.
AUTHOR
Wput is written by Hagen Fritsch <fritsch+wput-man@in.tum.de>