1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
|
.\" You can view this file with:
.\" man ./dxftp.1
.\" Written by Ashley Montanaro
.\"
.TH dxftp 1 "23 June 1999" "Darxite 0.3"
.SH NAME
dxftp - Darxite-based command-line FTP client
.SH SYNOPSIS
.B dxftp [OPTIONS] [[ftp://]host/path]
.SH DESCRIPTION
.B 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.
.SH OPTIONS
.IP "-v, --version"
Shows the program's version and exits.
.IP "-h, --help"
Shows some usage information and exits.
.IP "-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.
.IP "-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.
.SH 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.
.SH GENERAL COMMANDS
.IP "help"
Displays a list of commands and what they do.
.IP "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.
.IP "bye, exit, quit"
Any of these commands will close the program. You may also type
"Control-D" (end of file) to close it.
.SH REMOTE COMMANDS
.IP "cd <dir>"
Changes the current working directory on the remote host to <dir>.
.IP "close"
Closes the connection to the remote host.
.IP "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.
.IP "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.
.IP "mkdir <dir1> <dir2>..."
Creates the directories specified.
.IP "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.
.IP "pwd"
Prints the current working directory on the remote host.
.IP "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.
.IP "rename <old> <new>"
Renames <old> to <new>.
.IP "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.
.IP "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.
.IP "site <cmd>"
Executes a site-specific FTP command. One useful command is 'site
"chmod <mode> <file>"' to change a file's permissions.
.SH LOCAL COMMANDS
.IP "lcd <dir>"
Changes the local current working directory - ie. the directory that
files will be downloaded into.
.IP "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 ".".
.IP "lmkdir <dir1> <dir2>..."
Creates the directories specified.
.IP "lmv <src> <dest>"
Moves <src> to <dest>. The same as the command "lrename".
.IP "lpwd"
Prints the local current working directory.
.IP "lrename <old> <new>"
Renames <old> to <new>.
.IP "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.
.IP "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.
.SH FILES
.I /usr/bin/dxftp
Default executable
.SH BUGS
Probably.
.SH AUTHOR
Ashley Montanaro <hell@ukgateway.net>
.SH "BUG REPORTS"
When you find a bug or feel the need for a feature, e-mail a bug report to
Ashley.
.SH WWW
http://darxite.cjb.net/
|