qftp(1)

Commands

All commands have an single letter shortcuts, and you need only to type enough letters to distinguish between the commands.

ie: G, getm and getmarked are all the same command, this is for saving unneccessary typing.

There is only one set of options, and each command uses a subset of them, se below for a description of the options. You can use the set command to set an option globally (set -b will put all downloads in the background).

o - open [options] [host][:][dir][file]

Opens a connection to host. It can retry a number of times and sleep a specified time between (the -y option).

It takes login information from the following places:
The -a option (anonymous login)
The -u option (specified user and password)
The .netrc file (except if you provide the -n switch)
and at last, it will ask you.

It will change to a directory either if you specify one or if it finds the hosts in the .qftprc file. If you specify a file will it retrieve it.

x - close

Closes the connection.

l - ls [options] [path]

Lists the files in path, or in the current directory if you omit the path.

If you provide the -l switch you will get a "long" list, with permission, user, group, size, date and name (Like a normal ls -l). It's normally sorted by name, -r reverses it. -s sorts by size.

Each line begins with a number, you can use this number as a shortcut for the filename (g #42 instead of get this_is_a_very_long_filename)

If the q (quiet) option is unset will ls wait for <enter> after a screenfull of lines, and the short ls will print multiple columns.

The listings are cached.

d - dir [options] [path]

Like ls -l

c - cd [path]

Changes remote working directory to path.

C - lcd [path]

Changes local working directory to path.

m - mark [options] [path]

Marks a file or directory for later retrieval. Useful if you're on a slow link and don't want to wait for every file before you can continue browsing the site.

G - getmarked [options]

Retrieves the files you have marked. It takes the same options as get.

Q - quote [ftp-command]

Sends and arbitrary command to the server and shows the result.

Use quote HELP to get help from the server with the commands.

g - get [options] [paths...]

Retrieves one or more files or directories.

Available options:

-b forks(2) and opens a new connection and retrieves the file in the background.

-e retrieves whole directory structures (it doesn't handle links yet)

-f forces overwrite of local files.

-c continues downloading of an existing file (aka reget)

p - put [file]

Uploads files to the remote site. Doesn't handle any options yet.

h - help

Shows a summary over available commands and options.

s - set [option [argument]]

Set an option or shows the values of all options if invoked without option.

v - view [options]

Views a file using $PAGER (or "more" if $PAGER is unset). Can optionally (-z option) decompress files on the fly (using gzip, make sure it's in your path).

Options

Most options can be invoked either in lowercase or uppercase. Lowercase to set or enable and uppercase to unset or disable.

-a anonymous login

-b Background operation

-c Continuation mode (reget)

-e Recursive get

-f Force overwrite

-l Long Listings

-n Don't use username and password from .netrc

-q Quiet operation

-r Reverse listings

-s Sort by size

-t Sort by time (doesn't work yet)

-u Set default user and password, the password is optional and is separated from the username with a ":"

-y Set number of retries and optionally the sleeping time between, separated by a ":"

-z Decompress files on the fly before viewing.