SYNOPSIS

DESCRIPTION

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

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

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

AUTHOR