---
name: "dxftp"
section: "1"
platform: "linux"
package: "dxftp"
version: "0.4-3"
release: "Debian 2.2 (Potato)"
platforms: ["linux"]
url: "https://new.carta.tech/dxftp"
---

# dxftp(1)

Darxite-based command-line FTP client

## 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 \<hell@ukgateway.net\>

## 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/