dxftp(1)

NAME

dxftp - Darxite-based command-line FTP client

SYNOPSIS

dxftp [OPTIONS] [[ftp://]host/path]

DESCRIPTION

dxftp is a pretty full-featured command-line FTP client. It is based on the Darxite system and uses GNU readline for command-reading. It can (almost!) be used as a drop-in replacement for clients like ftp and ncftp, with the caveat that (with the current version of Darxite), you can't upload files.

OPTIONS

-v, --version

Shows the program's version and exits.

-h, --help

Shows some usage information and exits.

-c<host>:<port>, --connect <host>:<port>

Connects to the Darxite daemon running on <host>, listening on <port>. If run with this option, the first thing the program will do is ask for a password.

-u<user>, --user <user>

Log into the FTP site with login name <user>. The program will ask for a password before the file starts being transferred.

BASIC USAGE

You can pass dxftp a URL on the command-line and it will try to get it immediately. You can also pass it a Darxite alias. Once you're logged into an FTP server, you can execute commands and transfer files. There is a command-line history, so you can use the up and down keys to scroll through a list of commands you've entered. There is also tab-completion for local files, and simple tab-completion for remote files once the directory has been listed.

GENERAL COMMANDS

help

Displays a list of commands and what they do.

open [-u] <server>

Connects to an FTP server. If the "-u" flag is passed, the program will ask you for a username and password before connecting. If a connection is currently open, it will automatically be closed.

bye, exit, quit

Any of these commands will close the program. You may also type "Control-D" (end of file) to close it.

REMOTE COMMANDS

cd <dir>

Changes the current working directory on the remote host to <dir>.

close

Closes the connection to the remote host.

get [-r] <file>

Gets a file, which can be an absolute path or one relative to the current directory. If you include the option "-r", and <file> is a directory, Darxite will get the directory recursively. To change the directory files are downloaded to, use the "lcd" command.

ls [-l] [path]

Gets a list of the files in [path], or the current directory if [path] is not specified. The "-l" option will produce a more detailed list. Note that you must do some kind of list in the current directory before remote tab-completion will work.

mkdir <dir1> <dir2>...

Creates the directories specified.

mv <src> <dest>

Moves a file. This command is the same as "rename" with one exception: if <dest> is a directory (ends with a '/'), <src> will be moved into it.

pwd

Prints the current working directory on the remote host.

quote <cmd>

Sends a raw FTP command to the server. For example, you might type "quote syst" to find out what OS the server is running.

rename <old> <new>

Renames <old> to <new>.

rm [-f] <file1> <file2>...

Deletes the files specified. If the "-f" option is not passed, the program will ask for confirmation before deleting each file.

rmdir [-f] <dir1> <dir2>...

Deletes the directories specified. If the "-f" option is not passed, the program will ask for confirmation before deleting each directory. Note that directories must be empty before they can be deleted.

site <cmd>

Executes a site-specific FTP command. One useful command is 'site "chmod <mode> <file>"' to change a file's permissions.

LOCAL COMMANDS

lcd <dir>

Changes the local current working directory - ie. the directory that files will be downloaded into.

lls [-la] [path]

Lists [path], or the current directory if [path] is not given. The "-l" option produces a detailed list, and the "-a" option makes the list show hidden files - ie. files whose names begin with ".".

lmkdir <dir1> <dir2>...

Creates the directories specified.

lmv <src> <dest>

Moves <src> to <dest>. The same as the command "lrename".

lpwd

Prints the local current working directory.

lrename <old> <new>

Renames <old> to <new>.

lrm [-f] <file1> <file2>...

Deletes the files specified. If the "-f" option is not passed, the program will ask for confirmation before deleting each file.

lrmdir [-f] <dir1> <dir2>...

Deletes the directories specified. If the "-f" option is not passed, the program will ask for confirmation before deleting each directory. Note that directories must be empty before they can be deleted.

FILES

/usr/bin/dxftp Default executable

BUGS

Probably.

AUTHOR

Ashley Montanaro <[email protected]>

BUG REPORTS

When you find a bug or feel the need for a feature, e-mail a bug report to Ashley.

WWW

http://darxite.cjb.net/