Blame doc/lftp.1

Packit 8f70b4
.\"
Packit 8f70b4
.\" lftp.1 - Sophisticated file transfer program
Packit 8f70b4
.\"
Packit 8f70b4
.\" This file is part of lftp.
Packit 8f70b4
.\"
Packit 8f70b4
.\" This program is free software; you can redistribute it and/or modify
Packit 8f70b4
.\" it under the terms of the GNU General Public License as published by
Packit 8f70b4
.\" the Free Software Foundation; either version 3 of the License, or
Packit 8f70b4
.\" (at your option) any later version.
Packit 8f70b4
.\"
Packit 8f70b4
.\" This program is distributed in the hope that it will be useful,
Packit 8f70b4
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
Packit 8f70b4
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
Packit 8f70b4
.\" GNU General Public License for more details.
Packit 8f70b4
.\"
Packit 8f70b4
.\" You should have received a copy of the GNU General Public License
Packit 8f70b4
.\" along with this program.  If not, see <http://www.gnu.org/licenses/>.
Packit 8f70b4
.\"
Packit 8f70b4
.\"-------
Packit 8f70b4
.\" Sp  space down the interparagraph distance
Packit 8f70b4
.\"-------
Packit 8f70b4
.de Sp
Packit 8f70b4
.sp \\n(Ddu
Packit 8f70b4
..
Packit 8f70b4
.\"-------
Packit 8f70b4
.\" Ds  begin a display, indented .5 inches from the surrounding text.
Packit 8f70b4
.\"
Packit 8f70b4
.\" Note that uses of Ds and De may NOT be nested.
Packit 8f70b4
.\"-------
Packit 8f70b4
.de Ds
Packit 8f70b4
.Sp
Packit 8f70b4
.in +0.5i
Packit 8f70b4
.nf
Packit 8f70b4
..
Packit 8f70b4
.\"-------
Packit 8f70b4
.\" De  end a display (no trailing vertical spacing)
Packit 8f70b4
.\"-------
Packit 8f70b4
.de De
Packit 8f70b4
.fi
Packit 8f70b4
.in
Packit 8f70b4
..
Packit 8f70b4
.TH lftp 1 "10 Aug 2017"
Packit 8f70b4
.SH NAME
Packit 8f70b4
lftp \- Sophisticated file transfer program
Packit 8f70b4
.SH SYNTAX
Packit 8f70b4
.B lftp
Packit 8f70b4
[\fB\-d\fR] [\fB\-e \fIcmd\fR] [\fB\-p \fIport\fR]
Packit 8f70b4
[\fB\-u \fIuser\fR[\fB,\fIpass\fR]] [\fIsite\fR]
Packit 8f70b4
.br
Packit 8f70b4
.BI "lftp \-f " script_file
Packit 8f70b4
.br
Packit 8f70b4
.BI "lftp \-c " commands
Packit 8f70b4
.br
Packit 8f70b4
.B lftp \-\-version
Packit 8f70b4
.br
Packit 8f70b4
.B lftp \-\-help
Packit 8f70b4
Packit 8f70b4
.SH VERSION
Packit 8f70b4
This man page documents lftp version 4.8.1.
Packit 8f70b4
Packit 8f70b4
.SH "DESCRIPTION"
Packit 8f70b4
\fBlftp\fR is a file transfer program that allows sophisticated FTP, HTTP
Packit 8f70b4
and other connections to other hosts. If \fIsite\fR is specified then lftp
Packit 8f70b4
will connect to that site otherwise a connection has to be established with
Packit 8f70b4
the open command.
Packit 8f70b4
.PP
Packit 8f70b4
\fBlftp\fP can handle several file access methods - FTP, FTPS, HTTP, HTTPS,
Packit 8f70b4
HFTP, FISH, SFTP and file (HTTPS and FTPS are only available when lftp is
Packit 8f70b4
compiled with GNU TLS or OpenSSL library). You can specify the method to use in `open
Packit 8f70b4
URL' command, e.g. `open http://www.us.kernel.org/pub/linux'. HFTP is
Packit 8f70b4
ftp-over-http-proxy protocol. It can be used automatically instead of FTP
Packit 8f70b4
if ftp:proxy is set to `http://proxy[:port]'. Fish is a protocol working
Packit 8f70b4
over an ssh connection to a unix account. SFtp is a protocol implemented
Packit 8f70b4
in SSH2 as SFTP subsystem.
Packit 8f70b4
.PP
Packit 8f70b4
Besides FTP-like protocols, lftp has support for BitTorrent protocol
Packit 8f70b4
as `torrent' command. Seeding is also supported.
Packit 8f70b4
Packit 8f70b4
.PP
Packit 8f70b4
Every operation in \fBlftp\fP is reliable, that is any non-fatal error is
Packit 8f70b4
handled properly and the operation is repeated. So if downloading breaks, it
Packit 8f70b4
will be restarted from the point automatically. Even if FTP server
Packit 8f70b4
does not support the REST command, \fBlftp\fP will try to retrieve the file from
Packit 8f70b4
the very beginning until the file is transferred completely.
Packit 8f70b4
Packit 8f70b4
\fBlftp\fP has shell-like command syntax allowing you to launch several
Packit 8f70b4
commands in parallel in background (&). It is also possible to group
Packit 8f70b4
commands within () and execute them in background. All background jobs
Packit 8f70b4
are executed in the same single process. You can bring a foreground
Packit 8f70b4
job to background with ^Z (c-z) and back with command `wait' (or `fg' which
Packit 8f70b4
is alias to `wait'). To list running jobs, use command `jobs'. Some
Packit 8f70b4
commands allow redirecting their output (cat, ls, ...) to file or via
Packit 8f70b4
pipe to external command. Commands can be executed conditionally based
Packit 8f70b4
on termination status of previous command (&&, ||).
Packit 8f70b4
.PP
Packit 8f70b4
If you exit \fBlftp\fP before all jobs are not finished yet, \fBlftp\fP will move
Packit 8f70b4
itself to nohup mode in background. The same thing happens with a
Packit 8f70b4
real modem hangup or when you close an xterm.
Packit 8f70b4
.PP
Packit 8f70b4
\fBlftp\fP has built-in mirror which can download or update a whole directory
Packit 8f70b4
tree. There is also reverse mirror (mirror \-R) which uploads or
Packit 8f70b4
updates a directory tree on server. Mirror can also synchronize directories
Packit 8f70b4
between two remote servers, using FXP if available.
Packit 8f70b4
.PP
Packit 8f70b4
There is command `at' to launch a job at specified time in current
Packit 8f70b4
context, command `queue' to queue commands for sequential execution
Packit 8f70b4
for current server, and much more.
Packit 8f70b4
.PP
Packit 8f70b4
On startup, \fBlftp\fP executes \fI/etc/lftp.conf\fP and then \fI~/.lftprc\fP and
Packit 8f70b4
\fI~/.lftp/rc\fP (or \fI~/.config/lftp/rc\fP if \fI~/.lftp\fP does not exist).
Packit 8f70b4
You can place aliases and `set' commands there. Some
Packit 8f70b4
people prefer to see full protocol debug, use `debug' to turn the
Packit 8f70b4
debug on. Use `debug 3' to see only greeting messages and error
Packit 8f70b4
messages.
Packit 8f70b4
.PP
Packit 8f70b4
\fBlftp\fP has a number of settable variables. You can use `set \-a' to see
Packit 8f70b4
all variables and their values or `set \-d' to see list of defaults.
Packit 8f70b4
Variable names can be abbreviated and prefix can be omitted unless the
Packit 8f70b4
rest becomes ambiguous.
Packit 8f70b4
.PP
Packit 8f70b4
If lftp was compiled with OpenSSL (configure \-\-with\-openssl) it includes software developed
Packit 8f70b4
by the OpenSSL Project for use in the OpenSSL Toolkit. (http://www.openssl.org/)
Packit 8f70b4
Packit 8f70b4
.SS Commands
Packit 8f70b4
.PP
Packit 8f70b4
Packit 8f70b4
.BI ! " shell command"
Packit 8f70b4
.PP
Packit 8f70b4
Launch shell or shell command.
Packit 8f70b4
.PP
Packit 8f70b4
.Ds
Packit 8f70b4
!ls
Packit 8f70b4
.De
Packit 8f70b4
.PP
Packit 8f70b4
To do a directory listing of the local host.
Packit 8f70b4
Packit 8f70b4
.B alias
Packit 8f70b4
.RI " [" name " [" value ]]
Packit 8f70b4
.PP
Packit 8f70b4
Define or undefine alias \fIname\fP. If \fIvalue\fP is omitted, the alias is
Packit 8f70b4
undefined, else it takes the value \fIvalue\fP. If no argument is given
Packit 8f70b4
the current aliases are listed.
Packit 8f70b4
.PP
Packit 8f70b4
.Ds
Packit 8f70b4
alias dir ls \-lF
Packit 8f70b4
alias less zmore
Packit 8f70b4
.De
Packit 8f70b4
Packit 8f70b4
.BR at " \fItime\fP [ \-\- \fIcommand\fP ] "
Packit 8f70b4
.PP
Packit 8f70b4
Wait until the given time and execute given (optional) command. See also \fBat\fR(1).
Packit 8f70b4
Packit 8f70b4
.B attach
Packit 8f70b4
.RI " [" PID ]
Packit 8f70b4
.PP
Packit 8f70b4
Attach the terminal to specified backgrounded lftp process.
Packit 8f70b4
Packit 8f70b4
.B bookmark
Packit 8f70b4
.RI " [" subcommand ]
Packit 8f70b4
.PP
Packit 8f70b4
The bookmark command controls bookmarks.
Packit 8f70b4
Packit 8f70b4
Site names can be used in the \fIopen\fP command directly as-is or in
Packit 8f70b4
any command that accepts input URLs using the \fIbm:site/path\fP format.
Packit 8f70b4
.Sp
Packit 8f70b4
.in +0.5i
Packit 8f70b4
.TS
Packit 8f70b4
l	lx	.
Packit 8f70b4
add <name> [<loc>]	T{
Packit 8f70b4
add current place or given location to bookmarks and bind to given name
Packit 8f70b4
T}
Packit 8f70b4
del <name>	remove bookmark with name
Packit 8f70b4
edit	start editor on bookmarks file
Packit 8f70b4
import <type>	import foreign bookmarks
Packit 8f70b4
list	list bookmarks (default)
Packit 8f70b4
.TE
Packit 8f70b4
.in
Packit 8f70b4
.P
Packit 8f70b4
.B cache
Packit 8f70b4
.RI " [" subcommand ]
Packit 8f70b4
.PP
Packit 8f70b4
The cache command controls local memory cache.
Packit 8f70b4
The following subcommands are recognized:
Packit 8f70b4
.Sp
Packit 8f70b4
.in +0.5i
Packit 8f70b4
.TS
Packit 8f70b4
l	lx	.
Packit 8f70b4
stat	print cache status (default)
Packit 8f70b4
on|off	turn on/off caching
Packit 8f70b4
flush	flush cache
Packit 8f70b4
size \fIlim\fP	set memory limit, -1 means unlimited
Packit 8f70b4
expire \fINx\fP	T{
Packit 8f70b4
set cache expiration time to \fIN\fP seconds (\fIx\fP=s) minutes (\fIx\fP=m) hours (\fIx\fP=h) or days (\fIx\fP=d)
Packit 8f70b4
T}
Packit 8f70b4
.TE
Packit 8f70b4
.in
Packit 8f70b4
.P
Packit 8f70b4
.BR cat " \fIfiles\fP"
Packit 8f70b4
.PP
Packit 8f70b4
cat outputs the remote file(s) to stdout.  (See also \fBmore\fR,
Packit 8f70b4
\fBzcat\fR and \fBzmore\fR)
Packit 8f70b4
Packit 8f70b4
.BR cd " rdir"
Packit 8f70b4
.PP
Packit 8f70b4
Change current remote directory.  The previous remote directory is
Packit 8f70b4
stored as `\-'. You can do `cd \-' to change the directory back.
Packit 8f70b4
The previous directory for each site is also stored on disk,
Packit 8f70b4
so you can do `open site; cd \-' even after lftp restart.
Packit 8f70b4
Packit 8f70b4
.BR chmod " [" OPTS "] " "\fImode files...\fP"
Packit 8f70b4
.PP
Packit 8f70b4
Change permission mask on remote files. The mode can be an octal number or a symbolic mode (see chmod(1)).
Packit 8f70b4
.PP
Packit 8f70b4
.Sp
Packit 8f70b4
.in +0.5i
Packit 8f70b4
.TS
Packit 8f70b4
l1	l	lx	.
Packit 8f70b4
-c,	--changes	like verbose but report only when a change is made
Packit 8f70b4
-f,	--quiet	suppress most error messages
Packit 8f70b4
-v,	--verbose	output a diagnostic for every file processed
Packit 8f70b4
-R,	--recursive	change files and directories recursively
Packit 8f70b4
.TE
Packit 8f70b4
.in
Packit 8f70b4
.P
Packit 8f70b4
.BR close " [" \-a "]"
Packit 8f70b4
.PP
Packit 8f70b4
Close idle connections.  By default only with the current server, use
Packit 8f70b4
\-a to close all idle connections.
Packit 8f70b4
Packit 8f70b4
.BR cls " [" OPTS "] " \fIfiles...\fP
Packit 8f70b4
.PP
Packit 8f70b4
`cls' tries to retrieve information about specified files or directories
Packit 8f70b4
and outputs the information according to format options. The difference between
Packit 8f70b4
`ls' and `cls' is that `ls' requests the server to format file listing, and
Packit 8f70b4
`cls' formats it itself, after retrieving all the needed information.
Packit 8f70b4
.PP
Packit 8f70b4
.Sp
Packit 8f70b4
.in +0.5i
Packit 8f70b4
.TS
Packit 8f70b4
l1	l	lx	.
Packit 8f70b4
\-1		single-column output
Packit 8f70b4
\-a,	\-\-all	show dot files
Packit 8f70b4
\-B,	\-\-basename	show basename of files only
Packit 8f70b4
	\-\-block\-size=SIZ	use SIZ-byte blocks
Packit 8f70b4
\-d,	\-\-directory	T{
Packit 8f70b4
list directory entries instead of contents
Packit 8f70b4
T}
Packit 8f70b4
\-F,	\-\-classify	T{
Packit 8f70b4
append indicator (one of /@) to entries
Packit 8f70b4
T}
Packit 8f70b4
\-h,	\-\-human\-readable	T{
Packit 8f70b4
print sizes in human readable format (e.g., 1K)
Packit 8f70b4
T}
Packit 8f70b4
	\-\-si	T{
Packit 8f70b4
likewise, but use powers of 1000 not 1024
Packit 8f70b4
T}
Packit 8f70b4
\-k,	\-\-kilobytes	T{
Packit 8f70b4
like \-\-block\-size=1024
Packit 8f70b4
T}
Packit 8f70b4
\-l,	\-\-long	T{
Packit 8f70b4
use a long listing format
Packit 8f70b4
T}
Packit 8f70b4
\-q,	\-\-quiet	don't show status
Packit 8f70b4
\-s,	\-\-size	print size of each file
Packit 8f70b4
	\-\-filesize	T{
Packit 8f70b4
if printing size, only print size for files
Packit 8f70b4
T}
Packit 8f70b4
\-i,	\-\-nocase	T{
Packit 8f70b4
case-insensitive pattern matching
Packit 8f70b4
T}
Packit 8f70b4
\-I,	\-\-sortnocase	T{
Packit 8f70b4
sort names case-insensitively
Packit 8f70b4
T}
Packit 8f70b4
\-D,	\-\-dirsfirst	T{
Packit 8f70b4
list directories first
Packit 8f70b4
T}
Packit 8f70b4
	\-\-sort=OPT	T{
Packit 8f70b4
"name", "size", "date"
Packit 8f70b4
T}
Packit 8f70b4
\-S		sort by file size
Packit 8f70b4
	\-\-user, \-\-group,
Packit 8f70b4
	\-\-perms, \-\-date,
Packit 8f70b4
	\-\-linkcount, \-\-links	show individual fields
Packit 8f70b4
	\-\-time\-style=STYLE	T{
Packit 8f70b4
use specified time format
Packit 8f70b4
T}
Packit 8f70b4
.TE
Packit 8f70b4
.in
Packit 8f70b4
.P
Packit 8f70b4
.BR command " \fIcmd args...\fP
Packit 8f70b4
.PP
Packit 8f70b4
execute given command ignoring aliases.
Packit 8f70b4
Packit 8f70b4
.BR debug " [" OPTS "] " \fIlevel\fP | off
Packit 8f70b4
.PP
Packit 8f70b4
Switch debugging to \fIlevel\fP or turn it off. Options:
Packit 8f70b4
.Sp
Packit 8f70b4
.in +0.5i
Packit 8f70b4
.TS
Packit 8f70b4
l1	l	lx	.
Packit 8f70b4
\-T	truncate output file
Packit 8f70b4
\-o <file>	redirect debug output to the file
Packit 8f70b4
\-c	show message context
Packit 8f70b4
\-p	show PID
Packit 8f70b4
\-t	show timestamps
Packit 8f70b4
.TE
Packit 8f70b4
.in
Packit 8f70b4
.P
Packit 8f70b4
.BR echo " [" \-n "] \fIstring\fR"
Packit 8f70b4
.PP
Packit 8f70b4
Prints (echos) the given string to the display.
Packit 8f70b4
Packit 8f70b4
.BR edit " [" OPTS "] " \fIfile\fP
Packit 8f70b4
.PP
Packit 8f70b4
Retrieve remote file to a temporary location, run a local editor on it
Packit 8f70b4
and upload the file back if changed. Options:
Packit 8f70b4
.Sp
Packit 8f70b4
.in +0.5i
Packit 8f70b4
.TS
Packit 8f70b4
l1	l	lx	.
Packit 8f70b4
\-k	keep the temporary file
Packit 8f70b4
\-o <temp>	explicit temporary file location
Packit 8f70b4
.TE
Packit 8f70b4
.in
Packit 8f70b4
.P
Packit 8f70b4
.BR eval " [" -f " \fIformat\fR ] " \fIargs...\fR
Packit 8f70b4
.PP
Packit 8f70b4
without -f it executes given arguments as a command. With -f, arguments
Packit 8f70b4
are transformed into a new command. The format can contain plain text and
Packit 8f70b4
placeholders $0...$9 and $@, corresponding to the arguments.
Packit 8f70b4
Packit 8f70b4
.BR exit " [" bg "]"
Packit 8f70b4
.RB [ top ]
Packit 8f70b4
.RB [ parent ]
Packit 8f70b4
.RB [ kill ]
Packit 8f70b4
.RI [ code ]
Packit 8f70b4
.PP
Packit 8f70b4
exit will exit from lftp or move to background if there are active jobs. If
Packit 8f70b4
no job is active, \fIcode\fP is passed to operating system as lftp's
Packit 8f70b4
termination status. If \fIcode\fP is omitted, the exit code of last
Packit 8f70b4
command is used.
Packit 8f70b4
.PP
Packit 8f70b4
`exit bg' forces moving to background when cmd:move-background is false.
Packit 8f70b4
`exit top' makes top level `shell' (internal lftp command executor) terminate.
Packit 8f70b4
`exit parent' terminates the parent shell when running a nested script.
Packit 8f70b4
`exit kill' kills all numbered jobs before exiting. The options can be combined, e.g.
Packit 8f70b4
`at 08:00 \-\- exit top kill &' kills all jobs and makes lftp exit at specified time.
Packit 8f70b4
Packit 8f70b4
.B fg
Packit 8f70b4
.PP
Packit 8f70b4
Alias for `wait'.
Packit 8f70b4
Packit 8f70b4
.BR find " [" OPTS "] " \fIdirectory...\fP
Packit 8f70b4
.PP
Packit 8f70b4
List files in the directory (current directory by default) recursively.
Packit 8f70b4
This can help with servers lacking ls \-R support. You can redirect output
Packit 8f70b4
of this command. Options:
Packit 8f70b4
.Sp
Packit 8f70b4
.in +0.5i
Packit 8f70b4
.TS
Packit 8f70b4
l1	l	lx	.
Packit 8f70b4
\-d \fIMD\fP,	\-\-max\-depth=\fIMD\fP	specify maximum scan depth
Packit 8f70b4
\-l,	\-\-ls 	use long listing format
Packit 8f70b4
.TE
Packit 8f70b4
.in
Packit 8f70b4
.P
Packit 8f70b4
.BR ftpcopy
Packit 8f70b4
.PP
Packit 8f70b4
Obsolete. Use one of the following instead:
Packit 8f70b4
.Ds
Packit 8f70b4
get ftp://... \-o ftp://...
Packit 8f70b4
get \-O ftp://... file1 file2...
Packit 8f70b4
put ftp://...
Packit 8f70b4
mput ftp://.../*
Packit 8f70b4
mget \-O ftp://... ftp://.../*
Packit 8f70b4
.De
Packit 8f70b4
or other combinations to get FXP transfer (directly between two FTP servers).
Packit 8f70b4
lftp would fallback to plain copy (via client) if FXP transfer cannot be
Packit 8f70b4
initiated or ftp:use-fxp is false.
Packit 8f70b4
Packit 8f70b4
.BR get " [" \-E ]
Packit 8f70b4
.RB [ \-a "] [" \-c "] [" \-e ]
Packit 8f70b4
.RB [ \-P " \fIN\fP]"
Packit 8f70b4
.RB [ \-O " \fIbase\fP]"
Packit 8f70b4
.RB "\fIrfile\fP [" \-o " \fIlfile\fP] ..."
Packit 8f70b4
.PP
Packit 8f70b4
Retrieve the remote file \fIrfile\fP and store it as the local file
Packit 8f70b4
\fIlfile\fP.  If \-o is omitted, the file is stored to local file named as
Packit 8f70b4
base name of \fIrfile\fP. You can get multiple files by specifying multiple
Packit 8f70b4
instances of \fIrfile\fP (and \-o \fIlfile\fP). Does not expand wildcards, use
Packit 8f70b4
\fBmget\fR for that.
Packit 8f70b4
.Sp
Packit 8f70b4
.in +0.5i
Packit 8f70b4
.TS
Packit 8f70b4
l	lx	.
Packit 8f70b4
\-c	continue, reget
Packit 8f70b4
\-E	delete source files after successful transfer
Packit 8f70b4
\-e	delete target file before the transfer
Packit 8f70b4
\-a	use ascii mode (binary is the default)
Packit 8f70b4
\-P \fIN\fP	download \fIN\fP files in parallel
Packit 8f70b4
\-O <base>	T{
Packit 8f70b4
specifies base directory or URL where files should be placed
Packit 8f70b4
T}
Packit 8f70b4
.TE
Packit 8f70b4
.in
Packit 8f70b4
.PP
Packit 8f70b4
Examples:
Packit 8f70b4
.Ds
Packit 8f70b4
get README
Packit 8f70b4
get README \-o debian.README
Packit 8f70b4
get README README.mirrors
Packit 8f70b4
get README \-o debian.README README.mirrors \-o debian.mirrors
Packit 8f70b4
get README \-o ftp://some.host.org/debian.README
Packit 8f70b4
get README \-o ftp://some.host.org/debian-dir/ \ \ \fB(end slash is important)\fP
Packit 8f70b4
.De
Packit 8f70b4
Packit 8f70b4
.BR get1
Packit 8f70b4
.RI [ OPTS "] " rfile
Packit 8f70b4
.PP
Packit 8f70b4
Transfer a single file. Options:
Packit 8f70b4
.Sp
Packit 8f70b4
.in +0.5i
Packit 8f70b4
.TS
Packit 8f70b4
l	lx	.
Packit 8f70b4
\-o <lfile>	T{
Packit 8f70b4
destination file name (default - basename of rfile)
Packit 8f70b4
T}
Packit 8f70b4
\-c	continue, reget
Packit 8f70b4
\-E	T{
Packit 8f70b4
delete source files after successful transfer
Packit 8f70b4
T}
Packit 8f70b4
\-a	use ascii mode (binary is the default)
Packit 8f70b4
\-d	create the directory of the target file
Packit 8f70b4
\-\-source\-region=<from-to>	T{
Packit 8f70b4
transfer specified region of source file
Packit 8f70b4
T}
Packit 8f70b4
\-\-target\-position=<pos>	T{
Packit 8f70b4
position in target file to write data at
Packit 8f70b4
T}
Packit 8f70b4
.TE
Packit 8f70b4
.in
Packit 8f70b4
.P
Packit 8f70b4
.B glob
Packit 8f70b4
.RI " [" OPTS "] "
Packit 8f70b4
.RI [ command "] " patterns
Packit 8f70b4
.PP
Packit 8f70b4
Glob given patterns containing metacharacters and pass result to given command or return appropriate exit code.
Packit 8f70b4
.Sp
Packit 8f70b4
.in +0.5i
Packit 8f70b4
.TS
Packit 8f70b4
l	lx	.
Packit 8f70b4
\-f	plain files (default)
Packit 8f70b4
\-d	directories
Packit 8f70b4
\-a	all types
Packit 8f70b4
\-\-exist	return zero exit code when the patterns expand to non-empty list
Packit 8f70b4
\-\-not\-exist	return zero exit code when the patterns expand to an empty list
Packit 8f70b4
.TE
Packit 8f70b4
.in
Packit 8f70b4
.PP
Packit 8f70b4
Examples:
Packit 8f70b4
.Ds
Packit 8f70b4
glob echo *
Packit 8f70b4
glob --exist *.csv && echo "There are *.csv files"
Packit 8f70b4
.De
Packit 8f70b4
Packit 8f70b4
.B help
Packit 8f70b4
[\fIcmd\fP]
Packit 8f70b4
.PP
Packit 8f70b4
Print help for \fIcmd\fP or if no \fIcmd\fP was specified print a list of
Packit 8f70b4
available commands.
Packit 8f70b4
Packit 8f70b4
.B jobs
Packit 8f70b4
.RI [ OPTS ]
Packit 8f70b4
.RI [ job_no... ]
Packit 8f70b4
.PP
Packit 8f70b4
List running jobs. If \fIjob_no\fP is specified, only list a job with that number.
Packit 8f70b4
Options:
Packit 8f70b4
.Sp
Packit 8f70b4
.in +0.5i
Packit 8f70b4
.TS
Packit 8f70b4
l	lx	.
Packit 8f70b4
\-v	verbose, several \-v increase verbosity
Packit 8f70b4
\-r	list just one specified job without recursion
Packit 8f70b4
.TE
Packit 8f70b4
.in
Packit 8f70b4
.P
Packit 8f70b4
.B kill
Packit 8f70b4
all|\fIjob_no\fP
Packit 8f70b4
.PP
Packit 8f70b4
Delete specified job with \fIjob_no\fP or all jobs.
Packit 8f70b4
(For \fIjob_no\fP see \fBjobs\fP)
Packit 8f70b4
Packit 8f70b4
.B lcd
Packit 8f70b4
\fIldir\fP
Packit 8f70b4
.PP
Packit 8f70b4
Change current local directory \fIldir\fP. The previous local
Packit 8f70b4
directory is stored as `\-'. You can do `lcd \-' to change the directory back.
Packit 8f70b4
Packit 8f70b4
.B ln
Packit 8f70b4
.RB [ \-s ]
Packit 8f70b4
\fIexisting-file\fP \fInew-link\fP
Packit 8f70b4
.PP
Packit 8f70b4
Make a hard/symbolic link to an existing file.
Packit 8f70b4
Option \-s selects creation of a symbolic link.
Packit 8f70b4
Packit 8f70b4
.B local
Packit 8f70b4
\fIcommand\fP
Packit 8f70b4
.PP
Packit 8f70b4
Run specified command with local directory file:// session instead of
Packit 8f70b4
remote session. Examples:
Packit 8f70b4
.Ds
Packit 8f70b4
local pwd
Packit 8f70b4
local ls
Packit 8f70b4
local mirror /dir1 /dir2
Packit 8f70b4
.De
Packit 8f70b4
Packit 8f70b4
.B lpwd
Packit 8f70b4
.PP
Packit 8f70b4
Print current working directory on local machine.
Packit 8f70b4
Packit 8f70b4
.B ls
Packit 8f70b4
\fIparams\fP
Packit 8f70b4
.PP
Packit 8f70b4
List remote files. You can redirect output of this command to file or
Packit 8f70b4
via pipe to external command.  By default, ls output is cached, to see
Packit 8f70b4
new listing use
Packit 8f70b4
.B rels
Packit 8f70b4
or
Packit 8f70b4
.B "cache flush."
Packit 8f70b4
Packit 8f70b4
.BR mget " [" \-c "] [" \-d "]"
Packit 8f70b4
.RB [ \-a "] [" \-E "]"
Packit 8f70b4
.RB [ \-e ]
Packit 8f70b4
.RB [ \-P " \fIN\fP]"
Packit 8f70b4
.RB [ \-O " \fIbase\fP] \fIfiles\fP"
Packit 8f70b4
.PP
Packit 8f70b4
Gets selected files with expanded wildcards.
Packit 8f70b4
.PP
Packit 8f70b4
.Sp
Packit 8f70b4
.in +0.5i
Packit 8f70b4
.TS
Packit 8f70b4
l	lx	.
Packit 8f70b4
\-c	continue, reget.
Packit 8f70b4
\-d	T{
Packit 8f70b4
create directories the same as file names and get the files into them instead of current directory.
Packit 8f70b4
T}
Packit 8f70b4
\-E	delete source files after successful transfer
Packit 8f70b4
\-e	delete target file before the transfer
Packit 8f70b4
\-a	use ascii mode (binary is the default)
Packit 8f70b4
\-P \fIN\fP	download \fIN\fP files in parallel
Packit 8f70b4
\-O <base>	T{
Packit 8f70b4
specifies base directory or URL where files should be placed
Packit 8f70b4
T}
Packit 8f70b4
.TE
Packit 8f70b4
.in
Packit 8f70b4
.P
Packit 8f70b4
.B mirror
Packit 8f70b4
.RI [ OPTS "] [" source
Packit 8f70b4
.RI "[" target "]]"
Packit 8f70b4
.PP
Packit 8f70b4
Mirror specified source directory to the target directory.
Packit 8f70b4
.PP
Packit 8f70b4
By default the source is remote and the target is a local directory.
Packit 8f70b4
When using \-R, the source directory is local and the target is remote.
Packit 8f70b4
If the target directory is omitted, base name of the source directory is used.
Packit 8f70b4
If both directories are omitted, current local and remote directories are used.
Packit 8f70b4
.PP
Packit 8f70b4
The source and/or the target may be URLs pointing to directories.
Packit 8f70b4
.PP
Packit 8f70b4
If the target directory ends with a slash (except the root directory) then base
Packit 8f70b4
name of the source directory is appended.
Packit 8f70b4
.PP
Packit 8f70b4
.Sp
Packit 8f70b4
.in +0.5i
Packit 8f70b4
.TS
Packit 8f70b4
l1	l	lx	.
Packit 8f70b4
\-c,	\-\-continue	T{
Packit 8f70b4
continue a mirror job if possible
Packit 8f70b4
T}
Packit 8f70b4
\-e,	\-\-delete	T{
Packit 8f70b4
delete files not present at the source
Packit 8f70b4
T}
Packit 8f70b4
	\-\-delete-excluded	T{
Packit 8f70b4
delete files excluded at the target
Packit 8f70b4
T}
Packit 8f70b4
	\-\-delete\-first	T{
Packit 8f70b4
delete old files before transferring new ones
Packit 8f70b4
T}
Packit 8f70b4
	\-\-depth\-first	T{
Packit 8f70b4
descend into subdirectories before transferring files
Packit 8f70b4
T}
Packit 8f70b4
	\-\-scan\-all\-first	T{
Packit 8f70b4
scan all directories recursively before transferring files
Packit 8f70b4
T}
Packit 8f70b4
\-s,	\-\-allow\-suid	T{
Packit 8f70b4
set suid/sgid bits according to the source
Packit 8f70b4
T}
Packit 8f70b4
	\-\-allow\-chown	T{
Packit 8f70b4
try to set owner and group on files
Packit 8f70b4
T}
Packit 8f70b4
	\-\-ascii	T{
Packit 8f70b4
use ascii mode transfers (implies \-\-ignore\-size)
Packit 8f70b4
T}
Packit 8f70b4
	\-\-ignore\-time	T{
Packit 8f70b4
ignore time when deciding whether to download
Packit 8f70b4
T}
Packit 8f70b4
	\-\-ignore\-size	T{
Packit 8f70b4
ignore size when deciding whether to download
Packit 8f70b4
T}
Packit 8f70b4
	\-\-only\-missing	T{
Packit 8f70b4
download only missing files
Packit 8f70b4
T}
Packit 8f70b4
	\-\-only\-existing	T{
Packit 8f70b4
download only files already existing at target
Packit 8f70b4
T}
Packit 8f70b4
\-n,	\-\-only\-newer	T{
Packit 8f70b4
download only newer files (\-c won't work)
Packit 8f70b4
T}
Packit 8f70b4
	\-\-upload\-older	T{
Packit 8f70b4
upload even files older than the target ones
Packit 8f70b4
T}
Packit 8f70b4
	\-\-transfer\-all	T{
Packit 8f70b4
transfer all files, even seemingly the same at the target site
Packit 8f70b4
T}
Packit 8f70b4
	\-\-no\-empty\-dirs	T{
Packit 8f70b4
don't create empty directories (implies \-\-depth\-first)
Packit 8f70b4
T}
Packit 8f70b4
\-r,	\-\-no\-recursion	T{
Packit 8f70b4
don't go to subdirectories
Packit 8f70b4
T}
Packit 8f70b4
	\-\-recursion=\fIMODE\fP	T{
Packit 8f70b4
go to subdirectories on a condition
Packit 8f70b4
T}
Packit 8f70b4
	\-\-no\-symlinks	T{
Packit 8f70b4
don't create symbolic links
Packit 8f70b4
T}
Packit 8f70b4
\-p,	\-\-no\-perms	T{
Packit 8f70b4
don't set file permissions
Packit 8f70b4
T}
Packit 8f70b4
	\-\-no\-umask	T{
Packit 8f70b4
don't apply umask to file modes
Packit 8f70b4
T}
Packit 8f70b4
\-R,	\-\-reverse	T{
Packit 8f70b4
reverse mirror (put files)
Packit 8f70b4
T}
Packit 8f70b4
\-L,	\-\-dereference	T{
Packit 8f70b4
download symbolic links as files
Packit 8f70b4
T}
Packit 8f70b4
	\-\-overwrite	T{
Packit 8f70b4
overwrite plain files without removing them first
Packit 8f70b4
T}
Packit 8f70b4
	\-\-no\-overwrite	T{
Packit 8f70b4
remove and re-create plain files instead of overwriting
Packit 8f70b4
T}
Packit 8f70b4
\-N,	\-\-newer\-than=\fISPEC\fP	T{
Packit 8f70b4
download only files newer than specified time
Packit 8f70b4
T}
Packit 8f70b4
	\-\-older\-than=\fISPEC\fP	T{
Packit 8f70b4
download only files older than specified time
Packit 8f70b4
T}
Packit 8f70b4
	\-\-size\-range=\fIRANGE\fP	T{
Packit 8f70b4
download only files with size in specified range
Packit 8f70b4
T}
Packit 8f70b4
\-P,	\-\-parallel[=\fIN\fP]	T{
Packit 8f70b4
download N files in parallel
Packit 8f70b4
T}
Packit 8f70b4
	\-\-use-pget[\-n=\fIN\fP]	T{
Packit 8f70b4
use pget to transfer every single file
Packit 8f70b4
T}
Packit 8f70b4
	\-\-on\-change=\fICMD\fP	T{
Packit 8f70b4
execute the command if anything has been changed
Packit 8f70b4
T}
Packit 8f70b4
	\-\-loop	T{
Packit 8f70b4
repeat mirror until no changes found
Packit 8f70b4
T}
Packit 8f70b4
\-i \fIRX\fP,	\-\-include=\fIRX\fP	T{
Packit 8f70b4
include matching files
Packit 8f70b4
T}
Packit 8f70b4
\-x \fIRX\fP,	\-\-exclude=\fIRX\fP	T{
Packit 8f70b4
exclude matching files
Packit 8f70b4
T}
Packit 8f70b4
\-I \fIGP\fP,	\-\-include\-glob=\fIGP\fP	T{
Packit 8f70b4
include matching files
Packit 8f70b4
T}
Packit 8f70b4
\-X \fIGP\fP,	\-\-exclude\-glob=\fIGP\fP	T{
Packit 8f70b4
exclude matching files
Packit 8f70b4
T}
Packit 8f70b4
	\-\-include\-rx\-from=\fIFILE\fP	T{
Packit 8f70b4
T}
Packit 8f70b4
	\-\-exclude\-rx\-from=\fIFILE\fP	T{
Packit 8f70b4
T}
Packit 8f70b4
	\-\-include\-glob\-from=\fIFILE\fP	T{
Packit 8f70b4
T}
Packit 8f70b4
	\-\-exclude\-glob\-from=\fIFILE\fP	T{
Packit 8f70b4
load include/exclude patterns from the file, one per line
Packit 8f70b4
T}
Packit 8f70b4
\-f \fIFILE\fP,	\-\-file=\fIFILE\fP	T{
Packit 8f70b4
mirror a single file or globbed group (e.g. /path/to/*.txt)
Packit 8f70b4
T}
Packit 8f70b4
\-F \fIDIR\fP,	\-\-directory=\fIDIR\fP	T{
Packit 8f70b4
mirror a single directory or globbed group (e.g. /path/to/dir*)
Packit 8f70b4
T}
Packit 8f70b4
\-O \fIDIR\fP,	\-\-target-directory=\fIDIR\fP	T{
Packit 8f70b4
target base path or URL
Packit 8f70b4
T}
Packit 8f70b4
\-v,	\-\-verbose[=level]	T{
Packit 8f70b4
verbose operation
Packit 8f70b4
T}
Packit 8f70b4
	\-\-log=\fIFILE\fP	T{
Packit 8f70b4
write lftp commands being executed to FILE
Packit 8f70b4
T}
Packit 8f70b4
	\-\-script=\fIFILE\fP	T{
Packit 8f70b4
write lftp commands to FILE, but don't execute them
Packit 8f70b4
T}
Packit 8f70b4
	\-\-just-print, \-\-dry-run	T{
Packit 8f70b4
same as \-\-script=\-
Packit 8f70b4
T}
Packit 8f70b4
	\-\-max\-errors=\fIN\fP	T{
Packit 8f70b4
stop after this number of errors
Packit 8f70b4
T}
Packit 8f70b4
	\-\-skip\-noaccess	T{
Packit 8f70b4
don't try to transfer files with no read access.
Packit 8f70b4
T}
Packit 8f70b4
	\-\-use-cache	T{
Packit 8f70b4
use cached directory listings
Packit 8f70b4
T}
Packit 8f70b4
	\-\-Remove\-source\-files	T{
Packit 8f70b4
remove source files after transfer (use with caution)
Packit 8f70b4
T}
Packit 8f70b4
	\-\-Remove\-source\-dirs	T{
Packit 8f70b4
remove source files and directories after transfer (use with caution).
Packit 8f70b4
Top level directory is not removed if it's name ends with a slash.
Packit 8f70b4
T}
Packit 8f70b4
	\-\-Move	T{
Packit 8f70b4
same as \-\-Remove\-source\-dirs
Packit 8f70b4
T}
Packit 8f70b4
\-a		T{
Packit 8f70b4
same as \-\-allow-chown \-\-allow-suid \-\-no-umask
Packit 8f70b4
T}
Packit 8f70b4
.TE
Packit 8f70b4
.in
Packit 8f70b4
\fIRX\fP is an extended regular expression, just like in \fBegrep\fR(1).
Packit 8f70b4
.PP
Packit 8f70b4
\fIGP\fP is a glob pattern, e.g. `*.zip'.
Packit 8f70b4
.PP
Packit 8f70b4
Include and exclude options can be specified multiple times. It means that
Packit 8f70b4
a file or directory would be mirrored if it matches an include and does
Packit 8f70b4
not match to excludes after the include, or does not match anything
Packit 8f70b4
and the first check is exclude. Directories are matched with a slash appended.
Packit 8f70b4
.PP
Packit 8f70b4
Note that symbolic links are not created when uploading to remote server,
Packit 8f70b4
because FTP protocol cannot do it. To upload files the links refer
Packit 8f70b4
to, use `mirror \-RL' command (treat symbolic links as files).
Packit 8f70b4
.PP
Packit 8f70b4
For options \-\-newer\-than and \-\-older\-than you can either specify a
Packit 8f70b4
file or time specification like that used by \fBat\fR(1) command, e.g.
Packit 8f70b4
`now-7days' or `week ago'. If you specify a file, then modification time of
Packit 8f70b4
that file will be used.
Packit 8f70b4
.PP
Packit 8f70b4
Verbosity level can be selected using \-\-verbose=level option or by several
Packit 8f70b4
\-v options, e.g. \-vvv. Levels are:
Packit 8f70b4
.Ds
Packit 8f70b4
0 - no output (default)
Packit 8f70b4
1 - print actions
Packit 8f70b4
2 - +print not deleted file names (when \-e is not specified)
Packit 8f70b4
3 - +print directory names which are mirrored
Packit 8f70b4
.De
Packit 8f70b4
.PP
Packit 8f70b4
\-\-only\-newer turns off file size comparison and uploads/downloads
Packit 8f70b4
only newer files even if size is different. By default older files are transferred and replace newer ones.
Packit 8f70b4
.PP
Packit 8f70b4
\-\-upload\-older allows replacing newer remote files with older ones (when
Packit 8f70b4
the target side is remote). Some remote back-ends cannot preserve timestamps
Packit 8f70b4
so the default is to keep newer files.
Packit 8f70b4
.PP
Packit 8f70b4
Recursion mode can be one of `always', `never', `missing', `newer'. With
Packit 8f70b4
the option `newer' mirror compares timestamps of directories and enters a
Packit 8f70b4
directory only if it is older or missing on the target side. Be aware that
Packit 8f70b4
when a file changes the directory timestamp may stay the same, so mirror
Packit 8f70b4
won't process that directory.
Packit 8f70b4
.PP
Packit 8f70b4
The options \-\-file and \-\-directory may be used multiple times and even
Packit 8f70b4
mixed provided that base directories of the paths are the same.
Packit 8f70b4
.PP
Packit 8f70b4
You can mirror between two servers if you specify URLs instead of directories.
Packit 8f70b4
FXP is automatically used for transfers between FTP servers, if possible.
Packit 8f70b4
.PP
Packit 8f70b4
Some FTP servers hide dot-files by default (e.g. \fI.htaccess\fP), and show
Packit 8f70b4
them only when LIST command is used with \-a option. In such case try to use
Packit 8f70b4
`set ftp:list-options \-a'.
Packit 8f70b4
.PP The recursion modes `newer' and `missing' conflict with \-\-scan\-all\-first,
Packit 8f70b4
\-\-depth\-first, \-\-no\-empty\-dirs and setting mirror:no\-empty\-dirs=true.
Packit 8f70b4
Packit 8f70b4
.B mkdir
Packit 8f70b4
.RB "[" \-p "] "
Packit 8f70b4
.RB "[" \-f "] "
Packit 8f70b4
.I dir(s)
Packit 8f70b4
.PP
Packit 8f70b4
Make remote directories. If \-p is used, make all components of paths.
Packit 8f70b4
The \-f option makes mkdir quiet and suppresses messages.
Packit 8f70b4
Packit 8f70b4
.B module
Packit 8f70b4
.IR "module " [ " args " ]
Packit 8f70b4
.PP
Packit 8f70b4
Load given module using \fBdlopen\fR(3) function. If module name does not contain
Packit 8f70b4
a slash, it is searched in directories specified by module:path variable.
Packit 8f70b4
Arguments are passed to module_init function. See README.modules for technical
Packit 8f70b4
details.
Packit 8f70b4
Packit 8f70b4
.B more
Packit 8f70b4
\fIfiles\fP
Packit 8f70b4
.PP
Packit 8f70b4
Same as `cat \fIfiles\fP | more'. if \fBPAGER\fP is set, it is used as filter.
Packit 8f70b4
(See also \fBcat\fR, \fBzcat\fR and \fBzmore\fR)
Packit 8f70b4
Packit 8f70b4
.BR mput " [" \-c "] [" \-d "]"
Packit 8f70b4
.RB [ \-a "] [" \-E "]"
Packit 8f70b4
.RB [ \-e ]
Packit 8f70b4
.RB [ \-P " \fIN\fP]"
Packit 8f70b4
.RB [ \-O " \fIbase\fP] \fIfiles\fP"
Packit 8f70b4
.PP
Packit 8f70b4
Upload files with wildcard expansion. By default it uses the base name of
Packit 8f70b4
local name as remote one. This can be changed by `\-d' option.
Packit 8f70b4
.Sp
Packit 8f70b4
.in +0.5i
Packit 8f70b4
.TS
Packit 8f70b4
l	lx	.
Packit 8f70b4
\-c	continue, reput
Packit 8f70b4
\-d	T{
Packit 8f70b4
create directories the same as in file names and put the files into them instead of current directory
Packit 8f70b4
T}
Packit 8f70b4
\-E	T{
Packit 8f70b4
delete source files after successful transfer (dangerous)
Packit 8f70b4
T}
Packit 8f70b4
\-e	delete target file before the transfer
Packit 8f70b4
\-a	use ascii mode (binary is the default)
Packit 8f70b4
\-P \fIN\fP	upload \fIN\fP files in parallel
Packit 8f70b4
\-O <base>	T{
Packit 8f70b4
specifies base directory or URL where files should be placed
Packit 8f70b4
T}
Packit 8f70b4
.TE
Packit 8f70b4
.in
Packit 8f70b4
.P
Packit 8f70b4
.B mrm
Packit 8f70b4
\fIfile(s)\fP
Packit 8f70b4
.PP
Packit 8f70b4
Same as `glob rm'. Removes specified file(s) with wildcard expansion.
Packit 8f70b4
Packit 8f70b4
.B mmv
Packit 8f70b4
.RB [ \-O " \fIdirectory\fP]"
Packit 8f70b4
.RB "\fIfile(s)\fP \fIdirectory\fP"
Packit 8f70b4
.PP
Packit 8f70b4
Move specified files to a target directory. The target directory can be
Packit 8f70b4
specified after \-O option or as the last argument.
Packit 8f70b4
.PP
Packit 8f70b4
.Sp
Packit 8f70b4
.in +0.5i
Packit 8f70b4
.TS
Packit 8f70b4
l	lx	.
Packit 8f70b4
\-O <dir>	T{
Packit 8f70b4
specifies the target directory where files should be placed
Packit 8f70b4
T}
Packit 8f70b4
.TE
Packit 8f70b4
.in
Packit 8f70b4
.P
Packit 8f70b4
.B mv
Packit 8f70b4
.RB "\fIfile1\fP \fIfile2\fP"
Packit 8f70b4
.PP
Packit 8f70b4
Rename \fIfile1\fP to \fIfile2\fP. No wildcard exmapsion is performed.
Packit 8f70b4
If you give more than two arguments, or the last argument ends with a slash,
Packit 8f70b4
then \fBmmv\fP command is executed instead.
Packit 8f70b4
Packit 8f70b4
.B nlist
Packit 8f70b4
.RB "[\fIargs\fP]"
Packit 8f70b4
.PP
Packit 8f70b4
List remote file names
Packit 8f70b4
Packit 8f70b4
.B open
Packit 8f70b4
.RI [ OPTS ]
Packit 8f70b4
.I site
Packit 8f70b4
.PP
Packit 8f70b4
Select a server by host name, URL or bookmark. When an URL or bookmark is
Packit 8f70b4
given, automatically change the current working directory to the directory
Packit 8f70b4
of the URL.
Packit 8f70b4
Options:
Packit 8f70b4
.Sp
Packit 8f70b4
.in +0.5i
Packit 8f70b4
.TS
Packit 8f70b4
l	lx	.
Packit 8f70b4
\-e \fIcmd\fP	execute the command just after selecting the server
Packit 8f70b4
\-u \fIuser\fP[,\fIpass\fP]	use the user/password for authentication
Packit 8f70b4
\-p \fIport\fP	use the port for connection
Packit 8f70b4
\-s \fIslot\fP	assign the connection to this slot
Packit 8f70b4
\-d	enable debug
Packit 8f70b4
\-B	don't look up bookmarks
Packit 8f70b4
\-\-user \fIuser\fP	use the user for authentication
Packit 8f70b4
\-\-password \fIpass\fP	use the password for authentication
Packit 8f70b4
\-\-env\-password	take password from \fBLFTP_PASSWORD\fP environment variable
Packit 8f70b4
\fIsite\fP	host name, URL or bookmark name
Packit 8f70b4
.TE
Packit 8f70b4
.in
Packit 8f70b4
.P
Packit 8f70b4
.B pget
Packit 8f70b4
.RI [ OPTS ]
Packit 8f70b4
.I rfile
Packit 8f70b4
.RI [ "\fB-o\fP lfile" ]
Packit 8f70b4
Packit 8f70b4
Gets the specified file using several connections. This can speed up
Packit 8f70b4
transfer, but loads the net and server heavily impacting other users. Use only if
Packit 8f70b4
you really have to transfer the file ASAP.
Packit 8f70b4
Options:
Packit 8f70b4
.Sp
Packit 8f70b4
.in +0.5i
Packit 8f70b4
.TS
Packit 8f70b4
l	lx	.
Packit 8f70b4
\-c	T{
Packit 8f70b4
continue transfer. Requires \fIlfile.lftp-pget-status\fP file.
Packit 8f70b4
T}
Packit 8f70b4
\-n \fImaxconn\fP	T{
Packit 8f70b4
set maximum number of connections (default is taken from \fBpget:default-n\fP setting)
Packit 8f70b4
T}
Packit 8f70b4
.TE
Packit 8f70b4
.in
Packit 8f70b4
.P
Packit 8f70b4
.B put
Packit 8f70b4
.RB [ \-E ]
Packit 8f70b4
.RB [ \-a ]
Packit 8f70b4
.RB [ \-c ]
Packit 8f70b4
.RB [ \-e ]
Packit 8f70b4
.RB [ \-P " \fIN\fP]"
Packit 8f70b4
.RB [ "\-O \fIbase\fP" ]
Packit 8f70b4
.I lfile
Packit 8f70b4
.RB [ "\-o \fIrfile\fP" ]
Packit 8f70b4
.PP
Packit 8f70b4
Upload \fIlfile\fP with remote name \fIrfile\fP. If \-o omitted, the base name
Packit 8f70b4
of \fIlfile\fP is used as remote name. Does not expand wildcards, use \fBmput\fR for that.
Packit 8f70b4
.Sp
Packit 8f70b4
.in +0.5i
Packit 8f70b4
.TS
Packit 8f70b4
l	lx	.
Packit 8f70b4
\-o <rfile>	T{
Packit 8f70b4
specifies remote file name (default - basename of lfile)
Packit 8f70b4
T}
Packit 8f70b4
\-c	T{
Packit 8f70b4
continue, reput. It requires permission to overwrite remote files
Packit 8f70b4
T}
Packit 8f70b4
\-E	T{
Packit 8f70b4
delete source files after successful transfer (dangerous)
Packit 8f70b4
T}
Packit 8f70b4
\-e	delete target file before the transfer
Packit 8f70b4
\-a	use ascii mode (binary is the default)
Packit 8f70b4
\-P \fIN\fP	upload \fIN\fP files in parallel
Packit 8f70b4
\-O <base>	T{
Packit 8f70b4
specifies base directory or URL where files should be placed
Packit 8f70b4
T}
Packit 8f70b4
.TE
Packit 8f70b4
.in
Packit 8f70b4
.P
Packit 8f70b4
.B pwd
Packit 8f70b4
.RB [ \-p ]
Packit 8f70b4
.PP
Packit 8f70b4
Print current remote URL. Use `\-p' option to show password in the URL.
Packit 8f70b4
Packit 8f70b4
.B queue
Packit 8f70b4
.RB [ \-n " \fInum\fP ] \fIcmd\fP"
Packit 8f70b4
.PP
Packit 8f70b4
Add the given command to queue for sequential execution. Each site has its own
Packit 8f70b4
queue. `\-n' adds the command before the given item in the queue. Don't try to
Packit 8f70b4
queue `cd' or `lcd' commands, it may confuse lftp. Instead
Packit 8f70b4
do the cd/lcd before `queue' command, and it will remember the place in which
Packit 8f70b4
the command is to be done. It is possible to queue up an already running job
Packit 8f70b4
by `queue wait <jobno>', but the job will continue execution even if it is not
Packit 8f70b4
the first in queue.
Packit 8f70b4
.PP
Packit 8f70b4
`queue stop' will stop the queue, it will not execute any new commands,
Packit 8f70b4
but already running jobs will continue to run. You can use `queue stop' to
Packit 8f70b4
create an empty stopped queue. `queue start' will resume queue execution.
Packit 8f70b4
When you exit lftp, it will start all stopped queues automatically.
Packit 8f70b4
.PP
Packit 8f70b4
`queue' with no arguments will either create a stopped queue or print queue
Packit 8f70b4
status.
Packit 8f70b4
Packit 8f70b4
.B queue
Packit 8f70b4
.BR "\-\-delete|-d " "[\fIindex or wildcard expression\fP]"
Packit 8f70b4
.PP
Packit 8f70b4
Delete one or more items from the queue. If no argument is given, the last
Packit 8f70b4
entry in the queue is deleted.
Packit 8f70b4
Packit 8f70b4
.B queue
Packit 8f70b4
.BR "\-\-move|-m " "<\fIindex or wildcard expression\fP> [\fIindex\fP]"
Packit 8f70b4
.PP
Packit 8f70b4
Move the given items before the given queue index, or to the end if no
Packit 8f70b4
destination is given.
Packit 8f70b4
.PP
Packit 8f70b4
.Sp
Packit 8f70b4
.in +0.5i
Packit 8f70b4
.TS
Packit 8f70b4
l	lx	.
Packit 8f70b4
\-q	Be quiet.
Packit 8f70b4
\-v	Be verbose.
Packit 8f70b4
\-Q	T{
Packit 8f70b4
Output in a format that can be used to re-queue. Useful with \-\-delete.
Packit 8f70b4
T}
Packit 8f70b4
.TE
Packit 8f70b4
.in
Packit 8f70b4
.PP
Packit 8f70b4
Examples:
Packit 8f70b4
.Ds
Packit 8f70b4
> get file &
Packit 8f70b4
[1] get file
Packit 8f70b4
> queue wait 1
Packit 8f70b4
> queue get another_file
Packit 8f70b4
> cd a_directory
Packit 8f70b4
> queue get yet_another_file
Packit 8f70b4
.De
Packit 8f70b4
.PP
Packit 8f70b4
.Sp
Packit 8f70b4
.in +0.5i
Packit 8f70b4
.TS
Packit 8f70b4
l	lx	.
Packit 8f70b4
queue \-d 3	Delete the third item in the queue.
Packit 8f70b4
queue \-m 6 4	T{
Packit 8f70b4
Move the sixth item in the queue before the fourth.
Packit 8f70b4
T}
Packit 8f70b4
queue \-m "get*zip" 1	T{
Packit 8f70b4
Move all commands matching "get*zip" to the beginning of the queue.  (The order of the items is preserved.)
Packit 8f70b4
T}
Packit 8f70b4
queue \-d "get*zip"	T{
Packit 8f70b4
Delete all commands matching "get*zip".
Packit 8f70b4
T}
Packit 8f70b4
.TE
Packit 8f70b4
.in
Packit 8f70b4
.P
Packit 8f70b4
.B quote
Packit 8f70b4
\fIcmd\fP
Packit 8f70b4
.PP
Packit 8f70b4
For FTP - send the command uninterpreted. Use with caution - it can lead to
Packit 8f70b4
unknown remote state and thus will cause reconnect. You cannot
Packit 8f70b4
be sure that any change of remote state because of quoted command
Packit 8f70b4
is solid - it can be reset by reconnect at any time.
Packit 8f70b4
.PP
Packit 8f70b4
For HTTP - specific to HTTP action. Syntax: ``quote <command> [<args>]''.
Packit 8f70b4
Command may be ``set-cookie'' or ``post''.
Packit 8f70b4
.Ds
Packit 8f70b4
open http://www.site.net
Packit 8f70b4
quote set-cookie "variable=value; othervar=othervalue"
Packit 8f70b4
set http:post-content-type application/x-www-form-urlencoded
Packit 8f70b4
quote post /cgi-bin/script.cgi "var=value&othervar=othervalue" > local_file
Packit 8f70b4
.De
Packit 8f70b4
.PP
Packit 8f70b4
For FISH - send the command uninterpreted. This can be used to execute
Packit 8f70b4
arbitrary commands on server. The command must not take input or print ###
Packit 8f70b4
at new line beginning. If it does, the protocol will become out of sync.
Packit 8f70b4
.Ds
Packit 8f70b4
open fish://server
Packit 8f70b4
quote find \-name \\*.zip
Packit 8f70b4
.De
Packit 8f70b4
Packit 8f70b4
.BR "reget \fIrfile\fP " [ \-o " \fIlfile\fP]"
Packit 8f70b4
.PP
Packit 8f70b4
Same as `get \-c'.
Packit 8f70b4
Packit 8f70b4
.B rels
Packit 8f70b4
[\fIargs\fP]
Packit 8f70b4
.PP
Packit 8f70b4
Same as `ls', but ignores the cache.
Packit 8f70b4
Packit 8f70b4
.B renlist
Packit 8f70b4
[\fIargs\fP]
Packit 8f70b4
.PP
Packit 8f70b4
Same as `nlist', but ignores the cache.
Packit 8f70b4
Packit 8f70b4
.B repeat
Packit 8f70b4
[\fIOPTS\fP]
Packit 8f70b4
[[\fB\-d\fP] \fIdelay\fP]
Packit 8f70b4
[\fIcommand\fP]
Packit 8f70b4
.PP
Packit 8f70b4
Repeat specified command with a delay between iterations.
Packit 8f70b4
Default delay is one second, default command is empty.
Packit 8f70b4
.PP
Packit 8f70b4
.Sp
Packit 8f70b4
.in +0.5i
Packit 8f70b4
.TS
Packit 8f70b4
l	lx	.
Packit 8f70b4
\-c <count>	maximum number of iterations
Packit 8f70b4
\-d <delay>	delay between iterations
Packit 8f70b4
\-\-while\-ok	stop when command exits with non-zero code
Packit 8f70b4
\-\-until\-ok	stop when command exits with zero code
Packit 8f70b4
\-\-weak     	stop when lftp moves to background.
Packit 8f70b4
.TE
Packit 8f70b4
.in
Packit 8f70b4
.PP
Packit 8f70b4
Examples:
Packit 8f70b4
.Ds
Packit 8f70b4
repeat at tomorrow \-\- mirror
Packit 8f70b4
repeat 1d mirror
Packit 8f70b4
.De
Packit 8f70b4
Packit 8f70b4
.BR reput " \fIlfile\fP [" \-o " \fIrfile\fP]"
Packit 8f70b4
.PP
Packit 8f70b4
Same as `put \-c'.
Packit 8f70b4
Packit 8f70b4
.BR rm " [" \-r "] [" \-f ]
Packit 8f70b4
\fIfiles\fP
Packit 8f70b4
.PP
Packit 8f70b4
Remove remote files.  Does not expand wildcards, use \fBmrm\fR for
Packit 8f70b4
that. \-r is for recursive directory remove. Be careful, if something goes
Packit 8f70b4
wrong you can lose files. \-f suppress error messages.
Packit 8f70b4
Packit 8f70b4
.B rmdir
Packit 8f70b4
\fIdir(s)\fP
Packit 8f70b4
.PP
Packit 8f70b4
Remove remote directories.
Packit 8f70b4
Packit 8f70b4
.B scache
Packit 8f70b4
[\fIsession\fP]
Packit 8f70b4
.PP
Packit 8f70b4
List cached sessions or switch to specified session.
Packit 8f70b4
Packit 8f70b4
.B set
Packit 8f70b4
[\fIvar\fP [\fIval\fP]]
Packit 8f70b4
.PP
Packit 8f70b4
Set variable to given value. If the value is omitted, unset the variable.
Packit 8f70b4
Variable name has format ``name/closure'', where closure can specify
Packit 8f70b4
exact application of the setting. See below for details.
Packit 8f70b4
If set is called with no variable then only altered settings are listed.
Packit 8f70b4
It can be changed by options:
Packit 8f70b4
.PP
Packit 8f70b4
.Sp
Packit 8f70b4
.in +0.5i
Packit 8f70b4
.TS
Packit 8f70b4
l	lx	.
Packit 8f70b4
\-a	list all settings, including default values
Packit 8f70b4
\-d	list only default values, not necessary current ones
Packit 8f70b4
.TE
Packit 8f70b4
.in
Packit 8f70b4
.P
Packit 8f70b4
.B site
Packit 8f70b4
\fIsite_cmd\fP
Packit 8f70b4
.PP
Packit 8f70b4
Execute site command \fIsite_cmd\fP and output the result.
Packit 8f70b4
You can redirect its output.
Packit 8f70b4
Packit 8f70b4
.BR sleep " \fIinterval\fP "
Packit 8f70b4
.PP
Packit 8f70b4
Sleep given time interval and exit. Interval is in seconds by default, but
Packit 8f70b4
can be suffixed with 'm', 'h', 'd' for minutes, hours and days respectively.
Packit 8f70b4
See also \fBat\fP.
Packit 8f70b4
Packit 8f70b4
.BR slot " [\fIname\fP]"
Packit 8f70b4
.PP
Packit 8f70b4
Select specified slot or list all slots allocated. A slot is a connection
Packit 8f70b4
to a server, somewhat like a virtual console. You can create multiple slots
Packit 8f70b4
connected to different servers and switch between them. You can also use
Packit 8f70b4
\fIslot:name\fP as a pseudo-URL evaluating to that slot location.
Packit 8f70b4
.PP
Packit 8f70b4
Default readline binding allows quick switching between slots named 0-9 using
Packit 8f70b4
Meta-0 - Meta-9 keys (often you can use Alt instead of Meta).
Packit 8f70b4
Packit 8f70b4
.B source
Packit 8f70b4
\fIfile\fP
Packit 8f70b4
.br
Packit 8f70b4
.B source \-e
Packit 8f70b4
\fIcommand\fP
Packit 8f70b4
.PP
Packit 8f70b4
Execute commands recorded in file \fIfile\fP or returned by specified external command.
Packit 8f70b4
.Ds
Packit 8f70b4
source ~/.lftp/rc
Packit 8f70b4
source \-e echo help
Packit 8f70b4
.De
Packit 8f70b4
Packit 8f70b4
.B suspend
Packit 8f70b4
.PP
Packit 8f70b4
Stop lftp process. Note that transfers will be also stopped until you
Packit 8f70b4
continue the process with shell's fg or bg commands.
Packit 8f70b4
Packit 8f70b4
.BR torrent " [" OPTS "] " \fItorrent-files...\fP
Packit 8f70b4
.PP
Packit 8f70b4
Start BitTorrent process for the given \fItorrent-files\fP, which can be a
Packit 8f70b4
local file, URL, magnet link or plain \fIinfo_hash\fP written in hex or base32.
Packit 8f70b4
Local wildcards are expanded. Existing files are first
Packit 8f70b4
validated unless \fI\-\-force\-valid\fP option is given. Missing pieces are
Packit 8f70b4
downloaded. Files are stored in specified \fIdirectory\fP or current
Packit 8f70b4
working directory by default. Seeding continues until ratio reaches
Packit 8f70b4
\fItorrent:stop-on-ratio\fP setting or time of \fItorrent:seed-max-time\fP
Packit 8f70b4
runs out.
Packit 8f70b4
.PP
Packit 8f70b4
Options:
Packit 8f70b4
.Sp
Packit 8f70b4
.in +0.5i
Packit 8f70b4
.TS
Packit 8f70b4
l	lx	.
Packit 8f70b4
\-O <directory>	T{
Packit 8f70b4
specifies base directory where files should be placed
Packit 8f70b4
T}
Packit 8f70b4
\-\-force\-valid	T{
Packit 8f70b4
skip file validation (if you are sure they are ok).
Packit 8f70b4
T}
Packit 8f70b4
\-\-only\-new	T{
Packit 8f70b4
stop if the metadata is known already or the torrent is complete.
Packit 8f70b4
T}
Packit 8f70b4
\-\-only\-incomplete	T{
Packit 8f70b4
stop if the torrent is already complete.
Packit 8f70b4
T}
Packit 8f70b4
\-\-dht\-bootstrap=<node>	T{
Packit 8f70b4
bootstrap DHT by sending a query to specified \fInode\fP.
Packit 8f70b4
This option should be used just once to fill the local node cache.
Packit 8f70b4
Port number may be given after colon, default is 6881.
Packit 8f70b4
Here are some nodes for bootstrapping: dht.transmissionbt.com,
Packit 8f70b4
router.utorrent.com, router.bittorrent.com.
Packit 8f70b4
T}
Packit 8f70b4
\-\-share	T{
Packit 8f70b4
share specified file or directory using BitTorrent protocol. Magnet link
Packit 8f70b4
is printed when it's ready.
Packit 8f70b4
T}
Packit 8f70b4
.TE
Packit 8f70b4
.in
Packit 8f70b4
.P
Packit 8f70b4
.B user
Packit 8f70b4
\fIuser\fP [\fIpass\fP]
Packit 8f70b4
.br
Packit 8f70b4
.B user
Packit 8f70b4
\fIURL\fP [\fIpass\fP]
Packit 8f70b4
.PP
Packit 8f70b4
Use specified info for remote login. If you specify an URL with user name,
Packit 8f70b4
the entered password will be cached so that future URL references can use it.
Packit 8f70b4
Packit 8f70b4
.B version
Packit 8f70b4
.PP
Packit 8f70b4
Print \fBlftp\fR version.
Packit 8f70b4
Packit 8f70b4
.B wait
Packit 8f70b4
[\fIjobno\fP]
Packit 8f70b4
.br
Packit 8f70b4
.B wait all
Packit 8f70b4
.PP
Packit 8f70b4
Wait for specified job to terminate. If jobno is omitted, wait for last
Packit 8f70b4
backgrounded job.
Packit 8f70b4
.PP
Packit 8f70b4
`wait all' waits for all jobs to terminate.
Packit 8f70b4
Packit 8f70b4
.B zcat
Packit 8f70b4
\fIfiles\fP
Packit 8f70b4
.PP
Packit 8f70b4
Same as cat, but filter each file through zcat. (See also \fBcat\fR,
Packit 8f70b4
\fBmore\fR and \fBzmore\fR)
Packit 8f70b4
Packit 8f70b4
.B zmore
Packit 8f70b4
\fIfiles\fP
Packit 8f70b4
.PP
Packit 8f70b4
Same as more, but filter each file through zcat. (See also \fBcat\fR,
Packit 8f70b4
\fBzcat\fR and \fBmore\fR)
Packit 8f70b4
Packit 8f70b4
.SS Settings
Packit 8f70b4
.PP
Packit 8f70b4
On startup, lftp executes \fI~/.lftprc\fP and \fI~/.lftp/rc\fP (or
Packit 8f70b4
\fI~/.config/lftp/rc\fP if \fI~/.lftp\fP does not exist).
Packit 8f70b4
You can place aliases
Packit 8f70b4
and `set' commands there. Some people prefer to see full protocol
Packit 8f70b4
debug, use `debug' to turn the debug on.
Packit 8f70b4
.PP
Packit 8f70b4
There is also a system-wide startup file in
Packit 8f70b4
.IR /etc/lftp.conf .
Packit 8f70b4
It can be in different directory, see FILES section.
Packit 8f70b4
.PP
Packit 8f70b4
.B lftp
Packit 8f70b4
has the following settable variables (you can also use
Packit 8f70b4
`set \-a' to see all variables and their values):
Packit 8f70b4
.TP
Packit 8f70b4
.BR bmk:save-passwords \ (boolean)
Packit 8f70b4
save plain text passwords in \fI~/.local/share/lftp/bookmarks\fP or \fI~/.lftp/bookmarks\fP on `bookmark add' command.
Packit 8f70b4
Off by default.
Packit 8f70b4
.TP
Packit 8f70b4
.BR cache:cache-empty-listings \ (boolean)
Packit 8f70b4
When false, empty listings are not cached.
Packit 8f70b4
.TP
Packit 8f70b4
.BR cache:enable \ (boolean)
Packit 8f70b4
When false, cache is disabled.
Packit 8f70b4
.TP
Packit 8f70b4
.BR cache:expire " (time interval)"
Packit 8f70b4
Positive cache entries expire in this time interval.
Packit 8f70b4
.TP
Packit 8f70b4
.BR cache:expire-negative " (time interval)"
Packit 8f70b4
Negative cache entries expire in this time interval.
Packit 8f70b4
.TP
Packit 8f70b4
.BR cache:size " (number)"
Packit 8f70b4
Maximum cache size. When exceeded, oldest cache entries will be removed from cache.
Packit 8f70b4
.TP
Packit 8f70b4
.BR cmd:at-exit \ (string)
Packit 8f70b4
the commands in string are executed before lftp exits or moves to background.
Packit 8f70b4
.TP
Packit 8f70b4
.BR cmd:at-exit-bg \ (string)
Packit 8f70b4
the commands in string are executed before backgrounded lftp exits.
Packit 8f70b4
.TP
Packit 8f70b4
.BR cmd:at-exit-fg \ (string)
Packit 8f70b4
the commands in string are executed before foreground lftp exits.
Packit 8f70b4
.TP
Packit 8f70b4
.BR cmd:at-background \ (string)
Packit 8f70b4
the commands in string are executed before lftp moves to background.
Packit 8f70b4
.TP
Packit 8f70b4
.BR cmd:at-terminate \ (string)
Packit 8f70b4
the commands in string are executed before lftp terminates (either backgrounded or foreground).
Packit 8f70b4
.TP
Packit 8f70b4
.BR cmd:at-finish \ (string)
Packit 8f70b4
the commands in string are executed once when all jobs are done.
Packit 8f70b4
.TP
Packit 8f70b4
.BR cmd:at-queue-finish \ (string)
Packit 8f70b4
the commands in string are executed once when all jobs in a queue are done.
Packit 8f70b4
.TP
Packit 8f70b4
.BR cmd:cls-completion-default \ (string)
Packit 8f70b4
default \fBcls\fR options for displaying completion choices. For example,
Packit 8f70b4
to make completion listings show file sizes, set cmd:cls-completion-default
Packit 8f70b4
to `-s'.
Packit 8f70b4
.TP
Packit 8f70b4
.BR cmd:cls-default \ (string)
Packit 8f70b4
default \fBcls\fR command options. They can be overridden by explicitly given
Packit 8f70b4
options.
Packit 8f70b4
.TP
Packit 8f70b4
.BR cmd:cls-exact-time \ (boolean)
Packit 8f70b4
when true, \fBcls\fR would try to get exact file modification time even if
Packit 8f70b4
it means more requests to the server.
Packit 8f70b4
.TP
Packit 8f70b4
.BR cmd:csh-history \ (boolean)
Packit 8f70b4
enables csh-like history expansion.
Packit 8f70b4
.TP
Packit 8f70b4
.BR cmd:default-protocol \ (string)
Packit 8f70b4
The value is used when `open' is used
Packit 8f70b4
with just host name without protocol. Default is `ftp'.
Packit 8f70b4
.TP
Packit 8f70b4
.BR cmd:fail-exit \ (boolean)
Packit 8f70b4
if true, exit when a command fails and the following command is
Packit 8f70b4
unconditional (i.e. does not begin with || or &&). lftp exits
Packit 8f70b4
after the unconditional command is issued without executing it.
Packit 8f70b4
.TP
Packit 8f70b4
.BR cmd:interactive \ (tri-boolean)
Packit 8f70b4
when true, lftp acts interactively, handles terminal signals and outputs
Packit 8f70b4
some extra messages. Default is auto and depends on stdin being a terminal.
Packit 8f70b4
.TP
Packit 8f70b4
.BR cmd:long-running \ (seconds)
Packit 8f70b4
time of command execution, which is
Packit 8f70b4
considered as `long' and a beep is done before next prompt. 0
Packit 8f70b4
means off.
Packit 8f70b4
.TP
Packit 8f70b4
.BR cmd:ls-default \ (string)
Packit 8f70b4
default ls argument
Packit 8f70b4
.TP
Packit 8f70b4
.BR cmd:move-background " (boolean)"
Packit 8f70b4
when false, lftp refuses to go to background when exiting. To force it, use `exit bg'.
Packit 8f70b4
.TP
Packit 8f70b4
.BR cmd:move-background-detach " (boolean)"
Packit 8f70b4
when true (default), lftp detaches itself from the control terminal when
Packit 8f70b4
moving to background, it is possible to attach back using `attach' command;
Packit 8f70b4
when false, lftp tricks the shell to move lftp to background process group
Packit 8f70b4
and continues to run, then fg shell command brings lftp back to foreground
Packit 8f70b4
unless it has done all jobs and terminated.
Packit 8f70b4
.TP
Packit 8f70b4
.BR cmd:prompt \ (string)
Packit 8f70b4
The prompt. lftp recognizes the following backslash-escaped special
Packit 8f70b4
characters that are decoded as follows:
Packit 8f70b4
.RS
Packit 8f70b4
.PD 0
Packit 8f70b4
.TP
Packit 8f70b4
.B \e@
Packit 8f70b4
insert @ if the current remote site user is not default
Packit 8f70b4
.TP
Packit 8f70b4
.B \ea
Packit 8f70b4
an ASCII bell character (07)
Packit 8f70b4
.TP
Packit 8f70b4
.B \ee
Packit 8f70b4
an ASCII escape character (033)
Packit 8f70b4
.TP
Packit 8f70b4
.B \eh
Packit 8f70b4
the remote hostname you are connected to
Packit 8f70b4
.TP
Packit 8f70b4
.B \en
Packit 8f70b4
newline
Packit 8f70b4
.TP
Packit 8f70b4
.B \es
Packit 8f70b4
the name of the client (lftp)
Packit 8f70b4
.TP
Packit 8f70b4
.B \eS
Packit 8f70b4
current slot name
Packit 8f70b4
.TP
Packit 8f70b4
.B \eu
Packit 8f70b4
the username of the remote site user you are logged in as
Packit 8f70b4
.TP
Packit 8f70b4
.B \eU
Packit 8f70b4
the URL of the remote site (e.g., ftp://g437.ub.gu.se/home/james/src/lftp)
Packit 8f70b4
.TP
Packit 8f70b4
.B \ev
Packit 8f70b4
the version of \fBlftp\fP (e.g., 2.0.3)
Packit 8f70b4
.TP
Packit 8f70b4
.B \ew
Packit 8f70b4
the current working directory at the remote site
Packit 8f70b4
.TP
Packit 8f70b4
.B \eW
Packit 8f70b4
the base name of the current working directory at the remote site
Packit 8f70b4
.TP
Packit 8f70b4
.B \el
Packit 8f70b4
the current working directory at the local site
Packit 8f70b4
.TP
Packit 8f70b4
.B \eL
Packit 8f70b4
the base name of the current working directory at the local site
Packit 8f70b4
.TP
Packit 8f70b4
.B \e\fInnn\fP
Packit 8f70b4
the character corresponding to the octal number \fInnn\fP
Packit 8f70b4
.TP
Packit 8f70b4
.B \e\e
Packit 8f70b4
a backslash
Packit 8f70b4
.TP
Packit 8f70b4
.B \e?
Packit 8f70b4
skips next character if previous substitution was empty.
Packit 8f70b4
.TP
Packit 8f70b4
.B \e[
Packit 8f70b4
begin a sequence of non-printing characters, which could be used to
Packit 8f70b4
embed a terminal control sequence into the prompt
Packit 8f70b4
.TP
Packit 8f70b4
.B \e]
Packit 8f70b4
end a sequence of non-printing characters
Packit 8f70b4
.PD
Packit 8f70b4
.RE
Packit 8f70b4
Packit 8f70b4
.TP
Packit 8f70b4
.BR cmd:parallel \ (number)
Packit 8f70b4
Number of jobs run in parallel in non-interactive mode. For example,
Packit 8f70b4
this may be useful for scripts with multiple `get' commands. Note that setting
Packit 8f70b4
this to a value greater than 1 changes conditional execution behaviour, basically
Packit 8f70b4
makes it inconsistent.
Packit 8f70b4
.TP
Packit 8f70b4
.BR cmd:queue-parallel \ (number)
Packit 8f70b4
Number of jobs run in parallel in a queue.
Packit 8f70b4
.TP
Packit 8f70b4
.BR cmd:remote-completion \ (boolean)
Packit 8f70b4
a boolean to control whether or not lftp uses remote completion. When true,
Packit 8f70b4
\fBTab\fP key guesses if the word being completed should be a remote file
Packit 8f70b4
name. \fBMeta-Tab\fP does remote completion always. So you can force remote
Packit 8f70b4
completion with \fBMeta-Tab\fP when \fBcmd:remote-completion\fP is false or
Packit 8f70b4
when the guess is wrong.
Packit 8f70b4
.TP
Packit 8f70b4
.BR cmd:save-cwd-history \ (boolean)
Packit 8f70b4
when true, lftp saves last CWD of each site to \fI~/.local/share/lftp/cwd_history\fR or \fI~/.lftp/cwd_history\fR,
Packit 8f70b4
allowing to do ``cd -'' after lftp restart. Default is true.
Packit 8f70b4
.TP
Packit 8f70b4
.BR cmd:save-rl-history \ (boolean)
Packit 8f70b4
when true, lftp saves readline history to \fI~/.local/share/lftp/rl_history\fR or \fI~/.lftp/rl_history\fR on exit.
Packit 8f70b4
Default is true.
Packit 8f70b4
.TP
Packit 8f70b4
.BR cmd:show-status \ (boolean)
Packit 8f70b4
when false, lftp does not show status line on terminal. Default is true.
Packit 8f70b4
.TP
Packit 8f70b4
.BR cmd:set-term-status \ (boolean)
Packit 8f70b4
when true, lftp updates terminal status if supported (e.g. xterm). The closure
Packit 8f70b4
for this setting is the terminal type from TERM environment variable.
Packit 8f70b4
.TP
Packit 8f70b4
.BR cmd:status-interval \ (time interval)
Packit 8f70b4
the time interval between status updates.
Packit 8f70b4
.TP
Packit 8f70b4
.BR cmd:stifle-rl-history \ (number)
Packit 8f70b4
the number of lines to keep in readline history.
Packit 8f70b4
.TP
Packit 8f70b4
.BR cmd:term-status \ (string)
Packit 8f70b4
the format string to use to display terminal status. The closure for this
Packit 8f70b4
setting is the terminal type from TERM environment variable. Default uses
Packit 8f70b4
``tsl'' and ``fsl'' termcap values.
Packit 8f70b4
Packit 8f70b4
The following escapes are supported:
Packit 8f70b4
.Sp
Packit 8f70b4
.in +0.5i
Packit 8f70b4
.TS
Packit 8f70b4
l	lx	.
Packit 8f70b4
\\a	bell
Packit 8f70b4
\\e	escape
Packit 8f70b4
\\n	new line
Packit 8f70b4
\\s	"lftp"
Packit 8f70b4
\\v	lftp version
Packit 8f70b4
\\T	the status string
Packit 8f70b4
.TE
Packit 8f70b4
.TP
Packit 8f70b4
.BR cmd:time-style \ (string)
Packit 8f70b4
This setting is the default value for cls \-\-time\-style option.
Packit 8f70b4
.TP
Packit 8f70b4
.BR cmd:trace \ (boolean)
Packit 8f70b4
when true, lftp prints the commands it executes (like sh \-x).
Packit 8f70b4
.TP
Packit 8f70b4
.BR cmd:verify-host \ (boolean)
Packit 8f70b4
if true, lftp resolves host name immediately in `open' command.
Packit 8f70b4
It is also possible to skip the check for a single `open' command if `&' is given,
Packit 8f70b4
or if ^Z is pressed during the check.
Packit 8f70b4
.TP
Packit 8f70b4
.BR cmd:verify-path \ (boolean)
Packit 8f70b4
if true, lftp checks the path given in `cd' command.
Packit 8f70b4
It is also possible to skip the check for a single `cd' command if `&' is given,
Packit 8f70b4
or if ^Z is pressed during the check.
Packit 8f70b4
Examples:
Packit 8f70b4
.Ds
Packit 8f70b4
set cmd:verify-path/hftp://* false
Packit 8f70b4
cd directory &
Packit 8f70b4
.De
Packit 8f70b4
.TP
Packit 8f70b4
.BR cmd:verify-path-cached \ (boolean)
Packit 8f70b4
When false, `cd' to a directory known from cache as existent will succeed immediately.
Packit 8f70b4
Otherwise the verification will depend on cmd:verify-path setting.
Packit 8f70b4
.TP
Packit 8f70b4
.BR color:use-color " (tri-boolean)"
Packit 8f70b4
when true, cls command and completion output colored file listings according to color:dir-colors setting.
Packit 8f70b4
When set to auto, colors are used when output is a terminal.
Packit 8f70b4
.TP
Packit 8f70b4
.BR color:dir-colors " (string)"
Packit 8f70b4
file listing color description. By default the value of LS_COLORS environment variable is used. See dircolors(1).
Packit 8f70b4
.TP
Packit 8f70b4
.BR dns:SRV-query \ (boolean)
Packit 8f70b4
query for SRV records and use them before gethostbyname. The SRV records
Packit 8f70b4
are only used if port is not explicitly specified. See RFC2052 for details.
Packit 8f70b4
.TP
Packit 8f70b4
.BR dns:cache-enable \ (boolean)
Packit 8f70b4
enable DNS cache. If it is off, lftp resolves host name each time it reconnects.
Packit 8f70b4
.TP
Packit 8f70b4
.BR dns:cache-expire " (time interval)"
Packit 8f70b4
time to live for DNS cache entries. It has format <number><unit>+, e.g.
Packit 8f70b4
1d12h30m5s or just 36h. To disable expiration, set it to `inf' or `never'.
Packit 8f70b4
.TP
Packit 8f70b4
.BR dns:cache-size \ (number)
Packit 8f70b4
maximum number of DNS cache entries.
Packit 8f70b4
.TP
Packit 8f70b4
.BR dns:fatal-timeout " (time interval)"
Packit 8f70b4
limit the time for DNS queries. If DNS server is unavailable too long, lftp
Packit 8f70b4
will fail to resolve a given host name. Set to `never' to disable.
Packit 8f70b4
.TP
Packit 8f70b4
.BR dns:order " (list of protocol names)"
Packit 8f70b4
sets the order of DNS queries. Default is ``inet6 inet'' which means first
Packit 8f70b4
look up address in inet6 family, then inet and use them in that order.
Packit 8f70b4
To disable inet6 (AAAA) lookup, set this variable to ``inet''.
Packit 8f70b4
.TP
Packit 8f70b4
.BR dns:use-fork \ (boolean)
Packit 8f70b4
if true, lftp will fork before resolving host address. Default is true.
Packit 8f70b4
.TP
Packit 8f70b4
.BR dns:max-retries \ (number)
Packit 8f70b4
If zero, there is no limit on the number of times lftp will try
Packit 8f70b4
to lookup an address.
Packit 8f70b4
If > 0, lftp will try only this number of times to look up an address of each
Packit 8f70b4
address family in dns:order.
Packit 8f70b4
.TP
Packit 8f70b4
.BR dns:name \ (string)
Packit 8f70b4
This setting can be used to substitute a host name alias with another name
Packit 8f70b4
or IP address. The host name alias is used as the setting closure, the
Packit 8f70b4
substituted name or IP address is in the value. Multiple names or IP
Packit 8f70b4
addresses can be separated by comma.
Packit 8f70b4
.TP
Packit 8f70b4
.BR file:charset \ (string)
Packit 8f70b4
local character set. It is set from current locale initially.
Packit 8f70b4
.TP
Packit 8f70b4
.BR file:use-lock \ (boolean)
Packit 8f70b4
when true, lftp uses advisory locking on local files when opening them.
Packit 8f70b4
.TP
Packit 8f70b4
.BR file:use-fallocate \ (boolean)
Packit 8f70b4
when true, lftp uses fallocate(2) or posix_fallocate(3) to pre-allocate
Packit 8f70b4
storage space and reduce file fragmentation in pget and torrent commands.
Packit 8f70b4
.TP
Packit 8f70b4
.BR fish:auto-confirm \ (boolean)
Packit 8f70b4
when true, lftp answers ``yes'' to all ssh questions, in particular to the
Packit 8f70b4
question about a new host key. Otherwise it answers ``no''.
Packit 8f70b4
.TP
Packit 8f70b4
.BR fish:charset \ (string)
Packit 8f70b4
the character set used by fish server in requests, replies and file listings.
Packit 8f70b4
Default is empty which means the same as local.
Packit 8f70b4
.TP
Packit 8f70b4
.BR fish:connect-program \ (string)
Packit 8f70b4
the program to use for connecting to remote server. It should support `\-l' option
Packit 8f70b4
for user name, `\-p' for port number. Default is `ssh \-a \-x'. You can set it to
Packit 8f70b4
`rsh', for example. For private key authentication add `\-i' option with the key file.
Packit 8f70b4
.TP
Packit 8f70b4
.BR fish:shell \ (string)
Packit 8f70b4
use specified shell on server side. Default is /bin/sh. On some systems,
Packit 8f70b4
/bin/sh exits when doing cd to a non-existent directory. lftp can handle
Packit 8f70b4
that but it has to reconnect. Set it to /bin/bash for such systems if
Packit 8f70b4
bash is installed.
Packit 8f70b4
.TP
Packit 8f70b4
.BR ftp:acct \ (string)
Packit 8f70b4
Send this string in ACCT command after login. The result is ignored.
Packit 8f70b4
The closure for this setting has format \fIuser@host\fP.
Packit 8f70b4
.TP
Packit 8f70b4
.BR ftp:anon-pass \ (string)
Packit 8f70b4
sets the password used for anonymous FTP access authentication.
Packit 8f70b4
Default is "lftp@".
Packit 8f70b4
.TP
Packit 8f70b4
.BR ftp:anon-user \ (string)
Packit 8f70b4
sets the user name used for anonymous FTP access authentication.
Packit 8f70b4
Default is "anonymous".
Packit 8f70b4
.TP
Packit 8f70b4
.BR ftp:auto-sync-mode \ (regex)
Packit 8f70b4
if first server message matches this regex, turn on sync mode for that host.
Packit 8f70b4
.TP
Packit 8f70b4
.BR ftp:catch-size \ (boolean)
Packit 8f70b4
when there is no support for SIZE command, try to catch file size from the
Packit 8f70b4
"150 Opening data connection" reply.
Packit 8f70b4
.TP
Packit 8f70b4
.BR ftp:charset \ (string)
Packit 8f70b4
the character set used by FTP server in requests, replies and file listings.
Packit 8f70b4
Default is empty which means the same as local. This setting is only used
Packit 8f70b4
when the server does not support UTF8.
Packit 8f70b4
.TP
Packit 8f70b4
.BR ftp:client \ (string)
Packit 8f70b4
the name of FTP client to send with CLNT command, if supported by server.
Packit 8f70b4
If it is empty, then no CLNT command will be sent.
Packit 8f70b4
.TP
Packit 8f70b4
.BR ftp:compressed-re \ (regex)
Packit 8f70b4
files with matching name will be considered compressed and "MODE Z" will
Packit 8f70b4
not be used for them.
Packit 8f70b4
.TP
Packit 8f70b4
.BR ftp:bind-data-socket \ (boolean)
Packit 8f70b4
bind data socket to the interface of control connection (in passive mode).
Packit 8f70b4
Default is true, exception is the loopback interface.
Packit 8f70b4
.TP
Packit 8f70b4
.BR ftp:fix-pasv-address \ (boolean)
Packit 8f70b4
if true, lftp will try to correct address returned by server for PASV command
Packit 8f70b4
in case when server address is in public network and PASV returns an address
Packit 8f70b4
from a private network. In this case lftp would substitute server address
Packit 8f70b4
instead of the one returned by PASV command, port number would not be changed.
Packit 8f70b4
Default is true.
Packit 8f70b4
.TP
Packit 8f70b4
.BR ftp:fxp-passive-source \ (boolean)
Packit 8f70b4
if true, lftp will try to set up source FTP server in passive mode first,
Packit 8f70b4
otherwise destination one. If first attempt fails, lftp tries to set them up
Packit 8f70b4
the other way. If the other disposition fails too, lftp falls back to plain
Packit 8f70b4
copy. See also ftp:use-fxp.
Packit 8f70b4
.TP
Packit 8f70b4
.BR ftp:home \ (string)
Packit 8f70b4
Initial directory. Default is empty string which means auto. Set this to `/'
Packit 8f70b4
if you don't like the look of %2F in FTP URLs. The closure for this setting
Packit 8f70b4
has format \fIuser@host\fP.
Packit 8f70b4
.TP
Packit 8f70b4
.BR ftp:ignore-pasv-address \ (boolean)
Packit 8f70b4
If true, lftp uses control connection address instead of the one returned in
Packit 8f70b4
PASV reply for data connection. This can be useful for broken NATs.
Packit 8f70b4
Default is false.
Packit 8f70b4
.TP
Packit 8f70b4
.BR ftp:list-empty-ok \ (boolean)
Packit 8f70b4
if set to false, empty lists from LIST command will be treated as incorrect,
Packit 8f70b4
and another method (NLST) will be used.
Packit 8f70b4
.TP
Packit 8f70b4
.BR ftp:list-options \ (string)
Packit 8f70b4
sets options which are always appended to LIST command. It can be
Packit 8f70b4
useful to set this to `\-a' if server does not show dot (hidden) files by default.
Packit 8f70b4
Default is empty.
Packit 8f70b4
.TP
Packit 8f70b4
.BR ftp:mode-z-level \ (number)
Packit 8f70b4
compression level (0-9) for uploading with MODE Z.
Packit 8f70b4
.TP
Packit 8f70b4
.BR ftp:nop-interval \ (seconds)
Packit 8f70b4
delay between NOOP commands when downloading tail of a file. This is useful
Packit 8f70b4
for FTP servers which send "Transfer complete" message before flushing
Packit 8f70b4
data transfer. In such cases NOOP commands can prevent connection timeout.
Packit 8f70b4
.TP
Packit 8f70b4
.BR ftp:passive-mode \ (boolean)
Packit 8f70b4
sets passive FTP mode. This can be useful if you are behind a firewall or a
Packit 8f70b4
dumb masquerading router. In passive mode lftp uses PASV command, not the
Packit 8f70b4
PORT command which is used in active mode. In passive mode lftp itself
Packit 8f70b4
makes the data connection to the server; in active mode the server connects
Packit 8f70b4
to lftp for data transfer. Passive mode is the default.
Packit 8f70b4
.TP
Packit 8f70b4
.BR ftp:port-ipv4 " (ipv4 address)"
Packit 8f70b4
specifies an IPv4 address to send with PORT command. Default is empty which
Packit 8f70b4
means to send the address of local end of control connection.
Packit 8f70b4
.TP
Packit 8f70b4
.BR ftp:port-range \ (from-to)
Packit 8f70b4
allowed port range for the local side of the data connection.
Packit 8f70b4
Format is min-max, or `full' or `any' to indicate any port. Default is `full'.
Packit 8f70b4
.TP
Packit 8f70b4
.BR ftp:prefer-epsv \ (boolean)
Packit 8f70b4
use EPSV as preferred passive mode. Default is `false'.
Packit 8f70b4
.TP
Packit 8f70b4
.BR ftp:proxy \ (URL)
Packit 8f70b4
specifies FTP proxy to use.
Packit 8f70b4
To disable proxy set this to empty string. Note that it is a FTP proxy which
Packit 8f70b4
uses FTP protocol, not FTP over HTTP. Default value is taken from environment
Packit 8f70b4
variable \fBftp_proxy\fP if it starts with ``ftp://''. If your FTP proxy
Packit 8f70b4
requires authentication, specify user name and password in the URL.
Packit 8f70b4
If ftp:proxy starts with http:// then hftp protocol (FTP over HTTP proxy) is used instead
Packit 8f70b4
of FTP automatically.
Packit 8f70b4
.TP
Packit 8f70b4
.BR ftp:proxy-auth-type \ (string)
Packit 8f70b4
When set to ``joined'', lftp sends ``user@proxy_user@ftp.example.org'' as
Packit 8f70b4
user name to proxy, and ``password@proxy_password'' as password.
Packit 8f70b4
.IP
Packit 8f70b4
When set to ``joined-acct'', lftp sends ``user@ftp.example.org
Packit 8f70b4
proxy_user'' (with space) as user name to proxy. The site password is sent as
Packit 8f70b4
usual and the proxy password is expected in the following ACCT command.
Packit 8f70b4
.IP
Packit 8f70b4
When set to ``open'', lftp first sends proxy user and
Packit 8f70b4
proxy password and then ``OPEN ftp.example.org'' followed by ``USER user''.
Packit 8f70b4
The site password is then sent as usual.
Packit 8f70b4
.IP
Packit 8f70b4
When set to ``user'' (default), lftp first sends proxy user and
Packit 8f70b4
proxy password and then ``user@ftp.example.org'' as user name.
Packit 8f70b4
The site password is then sent as usual.
Packit 8f70b4
.IP
Packit 8f70b4
When set to ``proxy-user@host'', lftp first sends ``USER proxy_user@ftp.example.org'',
Packit 8f70b4
then proxy password. The site user and password are then sent as usual.
Packit 8f70b4
.TP
Packit 8f70b4
.BR ftp:rest-list \ (boolean)
Packit 8f70b4
allow usage of REST command before LIST command. This might be useful for
Packit 8f70b4
large directories, but some FTP servers silently ignore REST before LIST.
Packit 8f70b4
.TP
Packit 8f70b4
.BR ftp:rest-stor \ (boolean)
Packit 8f70b4
if false, lftp will not try to use REST before STOR. This can be useful
Packit 8f70b4
for some buggy servers which corrupt (fill with zeros) the file if REST followed
Packit 8f70b4
by STOR is used.
Packit 8f70b4
.TP
Packit 8f70b4
.BR ftp:retry-530 \ (regex)
Packit 8f70b4
Retry on server reply 530 for PASS command if text matches this regular expression.
Packit 8f70b4
This setting should be useful to distinguish between overloaded server
Packit 8f70b4
(temporary condition) and incorrect password (permanent condition).
Packit 8f70b4
.TP
Packit 8f70b4
.BR ftp:retry-530-anonymous \ (regex)
Packit 8f70b4
Additional regular expression for anonymous login, like ftp:retry-530.
Packit 8f70b4
.TP
Packit 8f70b4
.BR ftp:site-group \ (string)
Packit 8f70b4
Send this string in SITE GROUP command after login. The result is ignored.
Packit 8f70b4
The closure for this setting has format \fIuser@host\fP.
Packit 8f70b4
.TP
Packit 8f70b4
.BR ftp:skey-allow \ (boolean)
Packit 8f70b4
allow sending skey/opie reply if server appears to support it. On by default.
Packit 8f70b4
.TP
Packit 8f70b4
.BR ftp:skey-force \ (boolean)
Packit 8f70b4
do not send plain text password over the network, use skey/opie instead. If
Packit 8f70b4
skey/opie is not available, assume failed login. Off by default.
Packit 8f70b4
.TP
Packit 8f70b4
.BR ftp:ssl-allow \ (boolean)
Packit 8f70b4
if true, try to negotiate SSL connection with FTP server for non-anonymous
Packit 8f70b4
access. Default is true. This and other SSL settings are only available if lftp was compiled
Packit 8f70b4
with an ssl/tls library.
Packit 8f70b4
.TP
Packit 8f70b4
.BR ftp:ssl-auth \ (string)
Packit 8f70b4
the argument for AUTH command, can be one of SSL, TLS, TLS-P, TLS-C.
Packit 8f70b4
See RFC4217 for explanations. By default TLS or SSL will be used, depending on FEAT reply.
Packit 8f70b4
.TP
Packit 8f70b4
.BR ftp:ssl-data-use-keys \ (boolean)
Packit 8f70b4
if true, lftp loads ssl:key-file for protected data connection too. When false,
Packit 8f70b4
it does not, and the server can match data and control connections by session ID.
Packit 8f70b4
Default is true.
Packit 8f70b4
.TP
Packit 8f70b4
.BR ftp:ssl-force \ (boolean)
Packit 8f70b4
if true, refuse to send password in clear when server does not support SSL.
Packit 8f70b4
Default is false.
Packit 8f70b4
.TP
Packit 8f70b4
.BR ftp:ssl-protect-data \ (boolean)
Packit 8f70b4
if true, request SSL connection for data transfers. This is cpu-intensive
Packit 8f70b4
but provides privacy. Default is false.
Packit 8f70b4
.TP
Packit 8f70b4
.BR ftp:ssl-protect-fxp \ (boolean)
Packit 8f70b4
if true, request SSL connection for data transfer between two FTP servers
Packit 8f70b4
in FXP mode. CPSV or SSCN command will be used in that case. If SSL connection
Packit 8f70b4
fails for some reason, lftp would try unprotected FXP transfer unless
Packit 8f70b4
ftp:ssl-force is set for any of the two servers. Default is false.
Packit 8f70b4
.TP
Packit 8f70b4
.BR ftp:ssl-protect-list \ (boolean)
Packit 8f70b4
if true, request SSL connection for file list transfers. Default is true.
Packit 8f70b4
.TP
Packit 8f70b4
.BR ftp:ssl-use-ccc \ (boolean)
Packit 8f70b4
if true, lftp would issue CCC command after logon, thus disable
Packit 8f70b4
ssl protection layer on control connection.
Packit 8f70b4
.TP
Packit 8f70b4
.BR ftp:stat-interval " (time interval)"
Packit 8f70b4
interval between STAT commands. Default is 1 second.
Packit 8f70b4
.TP
Packit 8f70b4
.BR ftp:strict-multiline \ (boolean)
Packit 8f70b4
when true, lftp strictly checks for multiline reply format (expects it to
Packit 8f70b4
end with the same code as it started with). When false, this check is
Packit 8f70b4
relaxed.
Packit 8f70b4
.TP
Packit 8f70b4
.BR ftp:sync-mode \ (boolean)
Packit 8f70b4
if true, lftp will send one command at a time and wait for
Packit 8f70b4
response. This might be useful if you are using a buggy FTP server or
Packit 8f70b4
router. When it is off, lftp sends a pack of commands and waits for
Packit 8f70b4
responses - it speeds up operation when round trip time is significant.
Packit 8f70b4
Unfortunately it does not work with all FTP servers and some routers have
Packit 8f70b4
troubles with it, so it is on by default.
Packit 8f70b4
.TP
Packit 8f70b4
.BR ftp:timezone \ (string)
Packit 8f70b4
Assume this timezone for time in listings returned by LIST command.
Packit 8f70b4
This setting can be GMT offset [+|-]HH[:MM[:SS]] or any valid TZ value
Packit 8f70b4
(e.g. Europe/Moscow or MSK-3MSD,M3.5.0,M10.5.0/3). The default is GMT.
Packit 8f70b4
Set it to an empty value to assume local timezone specified by environment
Packit 8f70b4
variable TZ.
Packit 8f70b4
.TP
Packit 8f70b4
.BR ftp:too-many-re \ (regexp)
Packit 8f70b4
Decrease the dynamic connection limit when 421 reply line matches this
Packit 8f70b4
regular expression.
Packit 8f70b4
.TP
Packit 8f70b4
.BR ftp:trust-feat \ (string)
Packit 8f70b4
When true, assume that FEAT returned data are correct and don't use
Packit 8f70b4
common protocol extensions like SIZE, MDTM, REST if they are not listed.
Packit 8f70b4
Default is false.
Packit 8f70b4
.TP
Packit 8f70b4
.BR ftp:use-abor \ (boolean)
Packit 8f70b4
if false, lftp does not send ABOR command but closes data connection
Packit 8f70b4
immediately.
Packit 8f70b4
.TP
Packit 8f70b4
.BR ftp:use-allo \ (boolean)
Packit 8f70b4
when true (default), lftp sends ALLO command before uploading a file.
Packit 8f70b4
.TP
Packit 8f70b4
.BR ftp:use-feat \ (boolean)
Packit 8f70b4
when true (default), lftp uses FEAT command to determine extended features of
Packit 8f70b4
ftp server.
Packit 8f70b4
.TP
Packit 8f70b4
.BR ftp:use-fxp \ (boolean)
Packit 8f70b4
if true, lftp will try to set up direct connection between two ftp servers.
Packit 8f70b4
.TP
Packit 8f70b4
.BR ftp:use-hftp \ (boolean)
Packit 8f70b4
when ftp:proxy points to an http proxy, this setting selects hftp method (GET,
Packit 8f70b4
HEAD) when true, and CONNECT method when false. Default is true.
Packit 8f70b4
.TP
Packit 8f70b4
.BR ftp:use-ip-tos \ (boolean)
Packit 8f70b4
when true, lftp uses IPTOS_LOWDELAY for control connection and IPTOS_THROUGHPUT
Packit 8f70b4
for data connections.
Packit 8f70b4
.TP
Packit 8f70b4
.BR ftp:lang \ (boolean)
Packit 8f70b4
the language selected with LANG command, if supported as indicated by FEAT
Packit 8f70b4
response. Default is empty which means server default.
Packit 8f70b4
.TP
Packit 8f70b4
.BR ftp:use-mdtm \ (boolean)
Packit 8f70b4
when true (default), lftp uses MDTM command to determine file modification
Packit 8f70b4
time.
Packit 8f70b4
.TP
Packit 8f70b4
.BR ftp:use-mdtm-overloaded \ (boolean)
Packit 8f70b4
when true, lftp uses two argument MDTM command to set file modification
Packit 8f70b4
time on uploaded files. Default is false.
Packit 8f70b4
.TP
Packit 8f70b4
.BR ftp:use-mlsd \ (boolean)
Packit 8f70b4
when true, lftp will use MLSD command for directory listing if supported by the server.
Packit 8f70b4
.TP
Packit 8f70b4
.BR ftp:use-mode-z \ (boolean)
Packit 8f70b4
when true, lftp will use "MODE Z" if supported by the server to perform
Packit 8f70b4
compressed transfers.
Packit 8f70b4
.TP
Packit 8f70b4
.BR ftp:use-site-idle \ (boolean)
Packit 8f70b4
when true, lftp sends `SITE IDLE' command with net:idle argument. Default
Packit 8f70b4
is false.
Packit 8f70b4
.TP
Packit 8f70b4
.BR ftp:use-site-utime \ (boolean)
Packit 8f70b4
when true, lftp sends 5-argument `SITE UTIME' command to set file modification time
Packit 8f70b4
on uploaded files. Default is true.
Packit 8f70b4
.TP
Packit 8f70b4
.BR ftp:use-site-utime2 \ (boolean)
Packit 8f70b4
when true, lftp sends 2-argument `SITE UTIME' command to set file modification time
Packit 8f70b4
on uploaded files. Default is true.
Packit 8f70b4
If 5-argument `SITE UTIME' is also enabled, 2-argument command is tried first.
Packit 8f70b4
.TP
Packit 8f70b4
.BR ftp:use-size \ (boolean)
Packit 8f70b4
when true (default), lftp uses SIZE command to determine file size.
Packit 8f70b4
.TP
Packit 8f70b4
.BR ftp:use-stat \ (boolean)
Packit 8f70b4
if true, lftp sends STAT command in FXP mode transfer to know how much
Packit 8f70b4
data has been transferred. See also ftp:stat-interval. Default is true.
Packit 8f70b4
.TP
Packit 8f70b4
.BR ftp:use-stat-for-list \ (boolean)
Packit 8f70b4
when true, lftp uses STAT instead of LIST command. By default `.' is used
Packit 8f70b4
as STAT argument. Using STAT, lftp avoids creating data connection for directory
Packit 8f70b4
listing. Some servers require special options for STAT, use ftp:list-options
Packit 8f70b4
to specify them (e.g. \fB\-la\fP).
Packit 8f70b4
.TP
Packit 8f70b4
.BR ftp:use-telnet-iac \ (boolean)
Packit 8f70b4
when true (default), lftp uses TELNET IAC command and follows TELNET protocol
Packit 8f70b4
as specified in RFC959. When false, it does not follow TELNET protocol and
Packit 8f70b4
thus does not double 255 (0xFF, 0377) character and does not prefix ABOR and
Packit 8f70b4
STAT commands with TELNET IP+SYNCH signal.
Packit 8f70b4
.TP
Packit 8f70b4
.BR ftp:use-tvfs " (tri-boolean)"
Packit 8f70b4
When set to auto, usage of TVFS feature depends on FEAT server reply. Otherwise
Packit 8f70b4
this setting tells whether use it or not. In short, if a server supports TVFS
Packit 8f70b4
feature then it uses unix-like paths.
Packit 8f70b4
.TP
Packit 8f70b4
.BR ftp:use-utf8 \ (boolean)
Packit 8f70b4
if true, lftp sends `OPTS UTF8 ON' to the server to activate UTF-8 encoding
Packit 8f70b4
(if supported). Disable it if the file names have a different encoding and
Packit 8f70b4
the server has a trouble with it.
Packit 8f70b4
.TP
Packit 8f70b4
.BR ftp:use-quit " (boolean)"
Packit 8f70b4
if true, lftp sends QUIT before disconnecting from ftp server. Default is true.
Packit 8f70b4
.TP
Packit 8f70b4
.BR ftp:verify-address \ (boolean)
Packit 8f70b4
verify that data connection comes from the network address of control
Packit 8f70b4
connection peer. This can possibly prevent data connection spoofing
Packit 8f70b4
which can lead to data corruption. Unfortunately, this can fail
Packit 8f70b4
for certain ftp servers with several network interfaces,
Packit 8f70b4
when they do not set outgoing address on data socket, so it is disabled by default.
Packit 8f70b4
.TP
Packit 8f70b4
.BR ftp:verify-port \ (boolean)
Packit 8f70b4
verify that data connection has port 20 (ftp-data) on its remote end.
Packit 8f70b4
This can possibly prevent data connection spoofing by users of remote
Packit 8f70b4
host. Unfortunately, too many windows and even unix ftp servers forget
Packit 8f70b4
to set proper port on data connection, thus this check is off by default.
Packit 8f70b4
.TP
Packit 8f70b4
.BR ftp:web-mode \ (boolean)
Packit 8f70b4
disconnect after closing data connection. This can be useful for totally
Packit 8f70b4
broken ftp servers. Default is false.
Packit 8f70b4
.TP
Packit 8f70b4
.BR ftps:initial-prot \ (string)
Packit 8f70b4
specifies initial PROT setting for FTPS connections. Should be one of: C, S,
Packit 8f70b4
E, P, or empty. Default is empty which means unknown, so that lftp will use
Packit 8f70b4
PROT command unconditionally. If PROT command turns out to be unsupported,
Packit 8f70b4
then Clear mode would be assumed.
Packit 8f70b4
.TP
Packit 8f70b4
.BR hftp:cache \ (boolean)
Packit 8f70b4
allow server/proxy side caching for ftp-over-http protocol.
Packit 8f70b4
.TP
Packit 8f70b4
.BR hftp:cache-control \ (string)
Packit 8f70b4
specify corresponding HTTP request header.
Packit 8f70b4
.TP
Packit 8f70b4
.BR hftp:decode \ (boolean)
Packit 8f70b4
when true, lftp automatically decodes the entity in hftp protocol when Content-Encoding
Packit 8f70b4
header value matches deflate, gzip, compress, x-gzip or x-compress.
Packit 8f70b4
.TP
Packit 8f70b4
.BR hftp:proxy \ (URL)
Packit 8f70b4
specifies HTTP proxy for FTP-over-HTTP protocol (hftp). The protocol hftp
Packit 8f70b4
cannot work without a HTTP proxy, obviously.
Packit 8f70b4
Default value is taken from environment
Packit 8f70b4
variable \fBftp_proxy\fP if it starts with ``http://'', otherwise from
Packit 8f70b4
environment variable \fBhttp_proxy\fP.  If your FTP proxy
Packit 8f70b4
requires authentication, specify user name and password in the URL.
Packit 8f70b4
.TP
Packit 8f70b4
.BR hftp:use-allprop \ (boolean)
Packit 8f70b4
if true, lftp will send `<allprop/>' request body in `PROPFIND' requests,
Packit 8f70b4
otherwise it will send an empty request body.
Packit 8f70b4
.TP
Packit 8f70b4
.BR hftp:use-authorization \ (boolean)
Packit 8f70b4
if set to off, lftp will send password as part of URL to the proxy. This
Packit 8f70b4
may be required for some proxies (e.g. M-soft). Default is on, and lftp
Packit 8f70b4
will send password as part of Authorization header.
Packit 8f70b4
.TP
Packit 8f70b4
.BR hftp:use-head \ (boolean)
Packit 8f70b4
if set to off, lftp will try to use `GET' instead of `HEAD' for hftp protocol.
Packit 8f70b4
While this is slower, it may allow lftp to work with some proxies which
Packit 8f70b4
don't understand or mishandle ``HEAD ftp://'' requests.
Packit 8f70b4
.TP
Packit 8f70b4
.BR hftp:use-mkcol \ (boolean)
Packit 8f70b4
if set to off, lftp will try to use `PUT' instead of `MKCOL' to create
Packit 8f70b4
directories with hftp protocol. Default is off.
Packit 8f70b4
.TP
Packit 8f70b4
.BR hftp:use-propfind \ (boolean)
Packit 8f70b4
if set to off, lftp will not try to use `PROPFIND' to get directory contents
Packit 8f70b4
with hftp protocol and use `GET' instead. Default is off. When enabled, lftp
Packit 8f70b4
will also use PROPPATCH to set file modification time after uploading.
Packit 8f70b4
.TP
Packit 8f70b4
.BR hftp:use-range \ (boolean)
Packit 8f70b4
when true, lftp will use Range header for transfer restart.
Packit 8f70b4
.TP
Packit 8f70b4
.BR hftp:use-type \ (boolean)
Packit 8f70b4
If set to off, lftp won't try to append `;type=' to URLs passed to proxy.
Packit 8f70b4
Some broken proxies don't handle it correctly. Default is on.
Packit 8f70b4
.TP
Packit 8f70b4
.BR "http:accept, http:accept-charset, http:accept-encoding, http:accept-language" " (string)"
Packit 8f70b4
specify corresponding HTTP request headers.
Packit 8f70b4
.TP
Packit 8f70b4
.BR http:authorization \ (string)
Packit 8f70b4
the authorization to use by default, when no user is specified. The format
Packit 8f70b4
is ``user:password''. Default is empty which means no authorization.
Packit 8f70b4
.TP
Packit 8f70b4
.BR http:cache \ (boolean)
Packit 8f70b4
allow server/proxy side caching.
Packit 8f70b4
.TP
Packit 8f70b4
.BR http:cache-control \ (string)
Packit 8f70b4
specify corresponding HTTP request header.
Packit 8f70b4
.TP
Packit 8f70b4
.BR http:cookie \ (string)
Packit 8f70b4
send this cookie to server. A closure is useful here:
Packit 8f70b4
     set cookie/www.somehost.com "param=value"
Packit 8f70b4
.TP
Packit 8f70b4
.BR http:decode \ (boolean)
Packit 8f70b4
when true, lftp automatically decodes the entity when Content-Encoding
Packit 8f70b4
header value matches deflate, gzip, compress, x-gzip or x-compress.
Packit 8f70b4
.TP
Packit 8f70b4
.BR http:post-content-type " (string)"
Packit 8f70b4
specifies value of Content-Type HTTP request header for POST method.
Packit 8f70b4
Default is ``application/x-www-form-urlencoded''.
Packit 8f70b4
.TP
Packit 8f70b4
.BR http:proxy \ (URL)
Packit 8f70b4
specifies HTTP proxy. It is used when lftp works over HTTP protocol.
Packit 8f70b4
Default value is taken from environment variable \fBhttp_proxy\fP.
Packit 8f70b4
If your proxy requires authentication, specify user name and password
Packit 8f70b4
in the URL.
Packit 8f70b4
.TP
Packit 8f70b4
.BR http:put-method " (PUT or POST)"
Packit 8f70b4
specifies which HTTP method to use on put.
Packit 8f70b4
.TP
Packit 8f70b4
.BR http:put-content-type " (string)"
Packit 8f70b4
specifies value of Content-Type HTTP request header for PUT method.
Packit 8f70b4
.TP
Packit 8f70b4
.BR http:referer " (string)"
Packit 8f70b4
specifies value for Referer HTTP request header. Single dot `.' expands
Packit 8f70b4
to current directory URL. Default is `.'. Set to empty string to disable
Packit 8f70b4
Referer header.
Packit 8f70b4
.TP
Packit 8f70b4
.BR http:set-cookies " (boolean)"
Packit 8f70b4
if true, lftp modifies http:cookie variables when Set-Cookie header is received.
Packit 8f70b4
.TP
Packit 8f70b4
.BR http:use-allprop \ (boolean)
Packit 8f70b4
if true, lftp will send `<allprop/>' request body in `PROPFIND' requests,
Packit 8f70b4
otherwise it will send an empty request body.
Packit 8f70b4
.TP
Packit 8f70b4
.BR http:use-mkcol \ (boolean)
Packit 8f70b4
if set to off, lftp will try to use `PUT' instead of `MKCOL' to create
Packit 8f70b4
directories with HTTP protocol. Default is on.
Packit 8f70b4
.TP
Packit 8f70b4
.BR http:use-propfind \ (boolean)
Packit 8f70b4
if set to off, lftp will not try to use `PROPFIND' to get directory contents
Packit 8f70b4
with HTTP protocol and use `GET' instead. Default is off. When enabled, lftp
Packit 8f70b4
will also use PROPPATCH to set `Last-Modified' property after a file upload.
Packit 8f70b4
.TP
Packit 8f70b4
.BR http:use-range \ (boolean)
Packit 8f70b4
when true, lftp will use Range header for transfer restart.
Packit 8f70b4
.TP
Packit 8f70b4
.BR http:user-agent " (string)"
Packit 8f70b4
the string lftp sends in User-Agent header of HTTP request.
Packit 8f70b4
.TP
Packit 8f70b4
.BR https:proxy " (string)"
Packit 8f70b4
specifies https proxy. Default value is taken from environment variable \fBhttps_proxy\fP.
Packit 8f70b4
.TP
Packit 8f70b4
.BR log:enabled \ (boolean)
Packit 8f70b4
when true, the log messages are output. The closure for this and other `log:'
Packit 8f70b4
variables is either `debug' for debug messages or `xfer' for transfer logging.
Packit 8f70b4
.TP
Packit 8f70b4
.BR log:file " (string)"
Packit 8f70b4
the target output file for logging. When empty, \fBstderr\fP is used.
Packit 8f70b4
.TP
Packit 8f70b4
.BR log:level " (number)"
Packit 8f70b4
the log verbosity level. Currently it's only defined for `debug' closure.
Packit 8f70b4
.TP
Packit 8f70b4
.BR log:max-size " (number)"
Packit 8f70b4
maximum size of the log file. When the size is reached, the file is renamed and started anew.
Packit 8f70b4
.TP
Packit 8f70b4
.BR log:prefix-error " (string)"
Packit 8f70b4
.TP
Packit 8f70b4
.BR log:prefix-note " (string)"
Packit 8f70b4
.TP
Packit 8f70b4
.BR log:prefix-recv " (string)"
Packit 8f70b4
.TP
Packit 8f70b4
.BR log:prefix-send " (string)"
Packit 8f70b4
the prefixes for corresponding types of debug messages.
Packit 8f70b4
.TP
Packit 8f70b4
.BR log:show-ctx \ (boolean)
Packit 8f70b4
.TP
Packit 8f70b4
.BR log:show-pid \ (boolean)
Packit 8f70b4
.TP
Packit 8f70b4
.BR log:show-time \ (boolean)
Packit 8f70b4
select additional information in the log messages.
Packit 8f70b4
.TP
Packit 8f70b4
.BR mirror:dereference " (boolean)"
Packit 8f70b4
when true, mirror will dereference symbolic links by default.
Packit 8f70b4
You can override it by \-\-no\-dereference option. Default if false.
Packit 8f70b4
.TP
Packit 8f70b4
.BR mirror:exclude-regex " (regex)"
Packit 8f70b4
specifies default exclusion pattern. You can override it by \-\-include option.
Packit 8f70b4
.TP
Packit 8f70b4
.BR mirror:include-regex " (regex)"
Packit 8f70b4
specifies default inclusion pattern. It is used just after mirror:exclude-regex
Packit 8f70b4
is applied. It is never used if mirror:exclude-regex is empty.
Packit 8f70b4
.TP
Packit 8f70b4
.BR mirror:no-empty-dirs " (boolean)"
Packit 8f70b4
when true, mirror doesn't create empty directories (like \-\-no\-empty\-dirs option).
Packit 8f70b4
.TP
Packit 8f70b4
.BR mirror:sort-by " (string)"
Packit 8f70b4
specifies order of file transfers. Valid values are: name, name-desc, size, size-desc,
Packit 8f70b4
date, date-desc. When the value is name or name-desc, then mirror:order setting also
Packit 8f70b4
affects the order or transfers.
Packit 8f70b4
.TP
Packit 8f70b4
.BR mirror:order " (list of patterns)"
Packit 8f70b4
specifies order of file transfers when sorting by name. E.g. setting this to "*.sfv *.sum" makes mirror to
Packit 8f70b4
transfer files matching *.sfv first, then ones matching *.sum and then all other
Packit 8f70b4
files. To process directories after other files, add "*/" to the end of pattern list.
Packit 8f70b4
.TP
Packit 8f70b4
.BR mirror:overwrite " (boolean)"
Packit 8f70b4
when true, mirror will overwrite plain files instead of removing and re-creating them.
Packit 8f70b4
.TP
Packit 8f70b4
.BR mirror:parallel-directories " (boolean)"
Packit 8f70b4
if true, mirror will start processing of several directories in parallel
Packit 8f70b4
when it is in parallel mode. Otherwise, it will transfer files from a single
Packit 8f70b4
directory before moving to other directories.
Packit 8f70b4
.TP
Packit 8f70b4
.BR mirror:parallel-transfer-count " (number)"
Packit 8f70b4
specifies number of parallel transfers mirror is allowed to start.
Packit 8f70b4
You can override it with \-\-parallel option.
Packit 8f70b4
A closure can be matched against source or target host names, the minimum
Packit 8f70b4
number greater than 0 is used.
Packit 8f70b4
.TP
Packit 8f70b4
.BR mirror:require-source \ (boolean)
Packit 8f70b4
When true, mirror requires a source directory to be specified explicitly,
Packit 8f70b4
otherwise it is supposed to be the current directory.
Packit 8f70b4
.TP
Packit 8f70b4
.BR mirror:set-permissions \ (boolean)
Packit 8f70b4
When set to off, mirror won't try to copy file and directory permissions.
Packit 8f70b4
You can override it by \-\-perms option. Default is on.
Packit 8f70b4
.TP
Packit 8f70b4
.BR mirror:skip-noaccess \ (boolean)
Packit 8f70b4
when true, mirror does not try to download files which are obviously
Packit 8f70b4
inaccessible by the permission mask. Default is false.
Packit 8f70b4
.TP
Packit 8f70b4
.BR mirror:use-pget-n " (number)"
Packit 8f70b4
specifies \-n option for pget command used to transfer every single file under
Packit 8f70b4
mirror.
Packit 8f70b4
A closure can be matched against source or target host names, the minimum
Packit 8f70b4
number greater than 0 is used.
Packit 8f70b4
When the value is less than 2, pget is not used.
Packit 8f70b4
.TP
Packit 8f70b4
.BR module:path \ (string)
Packit 8f70b4
colon separated list of directories to look for modules. Can be initialized by
Packit 8f70b4
environment variable LFTP_MODULE_PATH. Default is `PKGLIBDIR/VERSION:PKGLIBDIR'.
Packit 8f70b4
.TP
Packit 8f70b4
.BR net:connection-limit \ (number)
Packit 8f70b4
maximum number of concurrent connections to the same site. 0 means unlimited.
Packit 8f70b4
.TP
Packit 8f70b4
.BR net:connection-limit-timer " (time interval)"
Packit 8f70b4
increase the dynamic connection limit after this time interval.
Packit 8f70b4
.TP
Packit 8f70b4
.BR net:connection-takeover \ (boolean)
Packit 8f70b4
if true, foreground connections have priority over background ones and can
Packit 8f70b4
interrupt background transfers to complete a foreground operation.
Packit 8f70b4
.TP
Packit 8f70b4
.BR net:idle " (time interval)"
Packit 8f70b4
disconnect from server after this idle time. Default is 3 minutes.
Packit 8f70b4
.TP
Packit 8f70b4
.BR net:limit-rate " (bytes per second)"
Packit 8f70b4
limit transfer rate on data connection. 0 means unlimited. You can specify
Packit 8f70b4
two numbers separated by colon to limit download and upload rate separately.
Packit 8f70b4
Suffixes are supported, e.g. 100K means 102400.
Packit 8f70b4
.TP
Packit 8f70b4
.BR net:limit-max \ (bytes)
Packit 8f70b4
limit accumulating of unused limit-rate. 0 means twice of limit-rate.
Packit 8f70b4
.TP
Packit 8f70b4
.BR net:limit-total-rate " (bytes per second)"
Packit 8f70b4
limit transfer rate of all connections in sum. 0 means unlimited. You can specify
Packit 8f70b4
two numbers separated by colon to limit download and upload rate separately.
Packit 8f70b4
Note that sockets have receive buffers on them, this can lead to network
Packit 8f70b4
link load higher than this rate limit just after transfer beginning. You
Packit 8f70b4
can try to set net:socket-buffer to relatively small value to avoid this.
Packit 8f70b4
.PP
Packit 8f70b4
If you specify a closure, then rate limitation will be applied to sum of
Packit 8f70b4
connections to a single matching host.
Packit 8f70b4
.TP
Packit 8f70b4
.BR net:limit-total-max \ (bytes)
Packit 8f70b4
limit accumulating of unused limit-total-rate. 0 means twice of limit-total-rate.
Packit 8f70b4
.TP
Packit 8f70b4
.BR net:max-retries \ (number)
Packit 8f70b4
the maximum number of sequential tries of an operation without success.
Packit 8f70b4
0 means unlimited. 1 means no retries.
Packit 8f70b4
.TP
Packit 8f70b4
.BR net:no-proxy \ (string)
Packit 8f70b4
contains comma separated list of domains for which proxy should not be used.
Packit 8f70b4
Default is taken from environment variable \fBno_proxy\fP.
Packit 8f70b4
.TP
Packit 8f70b4
.BR net:persist-retries " (number)"
Packit 8f70b4
ignore this number of hard errors. Useful to login to buggy FTP servers which
Packit 8f70b4
reply 5xx when there is too many users.
Packit 8f70b4
.TP
Packit 8f70b4
.BR net:reconnect-interval-base \ (seconds)
Packit 8f70b4
sets the base minimal time between reconnects. Actual interval depends on
Packit 8f70b4
net:reconnect-interval-multiplier and number of attempts to perform an
Packit 8f70b4
operation.
Packit 8f70b4
.TP
Packit 8f70b4
.BR net:reconnect-interval-max \ (seconds)
Packit 8f70b4
sets maximum reconnect interval. When current interval after multiplication
Packit 8f70b4
by net:reconnect-interval-multiplier reaches this value (or exceeds it), it
Packit 8f70b4
is reset back to net:reconnect-interval-base.
Packit 8f70b4
.TP
Packit 8f70b4
.BR net:reconnect-interval-multiplier \ (real\ number)
Packit 8f70b4
sets multiplier by which base interval is multiplied each time new attempt
Packit 8f70b4
to perform an operation fails. When the interval reaches maximum, it is reset
Packit 8f70b4
to base value. See net:reconnect-interval-base and net:reconnect-interval-max.
Packit 8f70b4
.TP
Packit 8f70b4
.BR net:socket-bind-ipv4 " (ipv4 address)"
Packit 8f70b4
bind all IPv4 sockets to specified address. This can be useful to select a
Packit 8f70b4
specific network interface to use. Default is empty which means not to bind
Packit 8f70b4
IPv4 sockets, operating system will choose an address automatically using
Packit 8f70b4
routing table.
Packit 8f70b4
.TP
Packit 8f70b4
.BR net:socket-bind-ipv6 " (ipv6 address)"
Packit 8f70b4
the same for IPv6 sockets.
Packit 8f70b4
.TP
Packit 8f70b4
.BR net:socket-buffer \ (bytes)
Packit 8f70b4
use given size for SO_SNDBUF and SO_RCVBUF socket options. 0 means system
Packit 8f70b4
default.
Packit 8f70b4
.TP
Packit 8f70b4
.BR net:socket-maxseg \ (bytes)
Packit 8f70b4
use given size for TCP_MAXSEG socket option. Not all operating systems support
Packit 8f70b4
this option, but Linux does.
Packit 8f70b4
.TP
Packit 8f70b4
.BR net:timeout " (time interval)"
Packit 8f70b4
sets the network protocol timeout.
Packit 8f70b4
.TP
Packit 8f70b4
.BR pget:default-n \ (number)
Packit 8f70b4
default number of chunks to split the file to in pget.
Packit 8f70b4
.TP
Packit 8f70b4
.BR pget:min-chunk-size \ (number)
Packit 8f70b4
minimal chunk size to split the file to.
Packit 8f70b4
.TP
Packit 8f70b4
.BR pget:save-status " (time interval)"
Packit 8f70b4
save pget transfer status this often. Set to `never' to disable saving of the status file.
Packit 8f70b4
The status is saved to a file with suffix \fI.lftp-pget-status\fP.
Packit 8f70b4
.TP
Packit 8f70b4
.BR sftp:auto-confirm \ (boolean)
Packit 8f70b4
when true, lftp answers ``yes'' to all ssh questions, in particular to the
Packit 8f70b4
question about a new host key. Otherwise it answers ``no''.
Packit 8f70b4
.TP
Packit 8f70b4
.BR sftp:charset \ (string)
Packit 8f70b4
the character set used by SFTP server in file names and file listings.
Packit 8f70b4
Default is empty which means the same as local. This setting is only used
Packit 8f70b4
for SFTP protocol version prior to 4. Version 4 and later always use UTF-8.
Packit 8f70b4
.TP
Packit 8f70b4
.BR sftp:connect-program \ (string)
Packit 8f70b4
the program to use for connecting to remote server. It should support `\-l' option
Packit 8f70b4
for user name, `\-p' for port number. Default is `ssh \-a \-x'.
Packit 8f70b4
For private key authentication add `\-i' option with the key file.
Packit 8f70b4
.TP
Packit 8f70b4
.BR sftp:max-packets-in-flight \ (number)
Packit 8f70b4
The maximum number of unreplied packets in flight. If round trip time is
Packit 8f70b4
significant, you should increase this and size-read/size-write. Default is 16.
Packit 8f70b4
.TP
Packit 8f70b4
.BR sftp:protocol-version \ (number)
Packit 8f70b4
The protocol number to negotiate. Default is 6. The actual protocol version
Packit 8f70b4
used depends on the server.
Packit 8f70b4
.TP
Packit 8f70b4
.BR sftp:server-program \ (string)
Packit 8f70b4
The server program implementing SFTP protocol. If it does not contain a slash `/',
Packit 8f70b4
it is considered a ssh2 subsystem and \-s option is used when starting connect-program.
Packit 8f70b4
Default is `sftp'. You can use rsh as transport level protocol like this:
Packit 8f70b4
.Ds
Packit 8f70b4
set sftp:connect-program rsh
Packit 8f70b4
set sftp:server-program /usr/libexec/openssh/sftp-server
Packit 8f70b4
.De
Packit 8f70b4
Similarly you can run SFTP over SSH1.
Packit 8f70b4
.TP
Packit 8f70b4
.BR sftp:size-read \ (number)
Packit 8f70b4
Block size for reading. Default is 0x8000.
Packit 8f70b4
.TP
Packit 8f70b4
.BR sftp:size-write \ (number)
Packit 8f70b4
Block size for writing. Default is 0x8000.
Packit 8f70b4
.TP
Packit 8f70b4
.BR ssl:ca-file " (path to file)"
Packit 8f70b4
use specified file as Certificate Authority certificate.
Packit 8f70b4
.TP
Packit 8f70b4
.BR ssl:ca-path " (path to directory)"
Packit 8f70b4
use specified directory as Certificate Authority certificate repository (OpenSSL only).
Packit 8f70b4
.TP
Packit 8f70b4
.BR ssl:check-hostname " (boolean)"
Packit 8f70b4
when true, lftp checks if the host name used to connect to the server
Packit 8f70b4
corresponds to the host name in its certificate.
Packit 8f70b4
.TP
Packit 8f70b4
.BR ssl:crl-file " (path to file)"
Packit 8f70b4
use specified file as Certificate Revocation List certificate.
Packit 8f70b4
.TP
Packit 8f70b4
.BR ssl:crl-path " (path to directory)"
Packit 8f70b4
use specified directory as Certificate Revocation List certificate repository (OpenSSL only).
Packit 8f70b4
.TP
Packit 8f70b4
.BR ssl:key-file " (path to file)"
Packit 8f70b4
use specified file as your private key. This setting is only used for ftps
Packit 8f70b4
and https protocols. For sftp and fish protocols use sftp:connect-program
Packit 8f70b4
and fish:connect-program respectively (add `\-i' option to ssh).
Packit 8f70b4
.TP
Packit 8f70b4
.BR ssl:cert-file " (path to file)"
Packit 8f70b4
use specified file as your certificate.
Packit 8f70b4
.TP
Packit 8f70b4
.BR ssl:use-sni \ (boolean)
Packit 8f70b4
when true, use Server Name Indication (SNI) TLS extension.
Packit 8f70b4
.TP
Packit 8f70b4
.BR ssl:verify-certificate \ (boolean)
Packit 8f70b4
if set to yes, then verify server's certificate to be signed by a known
Packit 8f70b4
Certificate Authority and not be on Certificate Revocation List. You can
Packit 8f70b4
specify either host name or certificate fingerprint in the closure.
Packit 8f70b4
.TP
Packit 8f70b4
.BR ssl:priority " (string)"
Packit 8f70b4
free form priority string for GnuTLS. If built with OpenSSL the understood
Packit 8f70b4
values are \fI+\fP or \fI\-\fP followed by SSL3.0, TLS1.0, TLS1.1 or TLS1.2,
Packit 8f70b4
separated by \fI:\fP. Example:
Packit 8f70b4
.Ds
Packit 8f70b4
set ssl:priority "NORMAL:\-SSL3.0:\-TLS1.0:\-TLS1.1:+TLS1.2"
Packit 8f70b4
.De
Packit 8f70b4
.TP
Packit 8f70b4
.BR torrent:ip " (ipv4 address)"
Packit 8f70b4
IP address to send to the tracker. Specify it if you are using an HTTP proxy.
Packit 8f70b4
.TP
Packit 8f70b4
.BR torrent:ipv6 " (ipv6 address)"
Packit 8f70b4
IPv6 address to send to the tracker. By default, first found global unicast address is used.
Packit 8f70b4
.TP
Packit 8f70b4
.BR torrent:max-peers \ (number)
Packit 8f70b4
maximum number of peers for a torrent. Least used peers are removed to
Packit 8f70b4
maintain this limit.
Packit 8f70b4
.TP
Packit 8f70b4
.BR torrent:port-range \ (from-to)
Packit 8f70b4
port range to accept connections on. A single port is selected when a torrent
Packit 8f70b4
starts.
Packit 8f70b4
.TP
Packit 8f70b4
.BR torrent:retracker \ (URL)
Packit 8f70b4
explicit retracker URL, e.g. `http://retracker.local/announce'.
Packit 8f70b4
.TP
Packit 8f70b4
.BR torrent:save-metadata \ (boolean)
Packit 8f70b4
when true, lftp saves metadata of each torrent it works with to
Packit 8f70b4
\fI~/.local/share/lftp/torrent/md\fP or \fI~/.lftp/torrent/md\fP directory
Packit 8f70b4
and loads it from there if necessary.
Packit 8f70b4
.TP
Packit 8f70b4
.BR torrent:seed-max-time " (time interval)"
Packit 8f70b4
maximum seed time. After this period of time a complete torrent shuts down
Packit 8f70b4
independently of ratio. It can be set to infinity if needed.
Packit 8f70b4
.TP
Packit 8f70b4
.BR torrent:seed-min-peers \ (number)
Packit 8f70b4
minimum number of peers when the torrent is complete. If there are less,
Packit 8f70b4
new peers are actively searched for.
Packit 8f70b4
.TP
Packit 8f70b4
.BR torrent:stop-min-ppr " (real number)"
Packit 8f70b4
minimum per-piece-ratio to stop seeding. Use it to avoid a situation when
Packit 8f70b4
a popular piece causes quick raise of the total ratio.
Packit 8f70b4
.TP
Packit 8f70b4
.BR torrent:stop-on-ratio " (real number)"
Packit 8f70b4
torrent stops when it's complete and ratio reached this number.
Packit 8f70b4
.TP
Packit 8f70b4
.BR torrent:timeout " (time interval)"
Packit 8f70b4
maximum time without any progress. When it's reached, the torrent shuts down.
Packit 8f70b4
.TP
Packit 8f70b4
.BR torrent:use-dht \ (boolean)
Packit 8f70b4
when true, DHT is used.
Packit 8f70b4
.TP
Packit 8f70b4
.BR xfer:auto-rename (boolean)
Packit 8f70b4
suggested filenames provided by the server are used if user explicitly sets
Packit 8f70b4
this option to `on'. As this could be security risk, default is off.
Packit 8f70b4
.TP
Packit 8f70b4
.BR xfer:backup-suffix \ (string)
Packit 8f70b4
a time format string (see strftime(3)) for backup file name when replacing
Packit 8f70b4
an existing file.
Packit 8f70b4
.TP
Packit 8f70b4
.BR xfer:clobber \ (boolean)
Packit 8f70b4
if this setting is off, get commands will not overwrite existing
Packit 8f70b4
files and generate an error instead.
Packit 8f70b4
.TP
Packit 8f70b4
.BR xfer:destination-directory " (path or URL to directory)"
Packit 8f70b4
This setting is used as default \-O option for get and mget commands.
Packit 8f70b4
Default is empty, which means current directory (no \-O option).
Packit 8f70b4
.TP
Packit 8f70b4
.BR xfer:disk-full-fatal \ (boolean)
Packit 8f70b4
when true, lftp aborts a transfer if it cannot write target file because
Packit 8f70b4
of full disk or quota; when false, lftp waits for disk space to be freed.
Packit 8f70b4
.TP
Packit 8f70b4
.BR xfer:eta-period \ (seconds)
Packit 8f70b4
the period over which weighted average rate is calculated to produce ETA.
Packit 8f70b4
.TP
Packit 8f70b4
.BR xfer:eta-terse \ (boolean)
Packit 8f70b4
show terse ETA (only high order parts). Default is true.
Packit 8f70b4
.TP
Packit 8f70b4
.BR xfer:keep-backup \ (boolean)
Packit 8f70b4
when true, the backup file created before replacing an existing file is not removed after successful transfer.
Packit 8f70b4
.TP
Packit 8f70b4
.BR xfer:make-backup \ (boolean)
Packit 8f70b4
when true, lftp renames pre-existing file adding xfer:backup-suffix instead of overwriting it.
Packit 8f70b4
.TP
Packit 8f70b4
.BR xfer:max-redirections " (number)"
Packit 8f70b4
maximum number of redirections. This can be useful for downloading over HTTP.
Packit 8f70b4
0 prohibits redirections.
Packit 8f70b4
.TP
Packit 8f70b4
.BR xfer:parallel \ (number)
Packit 8f70b4
the default number of parallel transfers in a single get/put/mget/mput command.
Packit 8f70b4
.TP
Packit 8f70b4
.BR xfer:rate-period \ (seconds)
Packit 8f70b4
the period over which weighted average rate is calculated to be shown.
Packit 8f70b4
.TP
Packit 8f70b4
.BR xfer:temp-file-name \ (string)
Packit 8f70b4
temporary file name pattern, first asterisk is replaced by the original file name.
Packit 8f70b4
.TP
Packit 8f70b4
.BR xfer:timeout " (time interval)"
Packit 8f70b4
maximum time without any transfer progress. It can be used to limit maximum
Packit 8f70b4
time to retry a transfer from a server not supporting transfer restart.
Packit 8f70b4
.TP
Packit 8f70b4
.BR xfer:use-temp-file \ (boolean)
Packit 8f70b4
when true, a file will be transferred to a temporary file in the same directory and then renamed.
Packit 8f70b4
.TP
Packit 8f70b4
.BR xfer:verify \ (boolean)
Packit 8f70b4
when true, verify-command is launched after successful transfer to validate
Packit 8f70b4
file integrity. Zero exit code of that command should indicate correctness
Packit 8f70b4
of the file.
Packit 8f70b4
.TP
Packit 8f70b4
.BR xfer:verify-command \ (string)
Packit 8f70b4
the command to validate file integrity. The only argument is the path to
Packit 8f70b4
the file.
Packit 8f70b4
Packit 8f70b4
.PP
Packit 8f70b4
The name of a variable can be abbreviated unless it becomes
Packit 8f70b4
ambiguous. The prefix before `:' can be omitted too. You can
Packit 8f70b4
set one variable several times for different closures, and thus
Packit 8f70b4
you can get a particular settings for particular state. The closure
Packit 8f70b4
is to be specified after variable name separated with slash `/'.
Packit 8f70b4
.PP
Packit 8f70b4
The closure for `dns:', `net:', `ftp:', `http:', `hftp:' domain variables
Packit 8f70b4
is currently just the host name as you specify it in the `open' command
Packit 8f70b4
(with some exceptions where closure is meaningless, e.g. dns:cache-size).
Packit 8f70b4
For some `cmd:' domain variables the closure is current URL without path.
Packit 8f70b4
For `log:' domain variables the closure is either `debug' or `xfer'.
Packit 8f70b4
For other variables it is not currently used. See examples in the sample
Packit 8f70b4
\fIlftp.conf\fR.
Packit 8f70b4
.PP
Packit 8f70b4
Certain commands and settings take a time interval parameter. It has
Packit 8f70b4
the format Nx[Nx...], where N is time amount (floating point) and x is time unit: d - days,
Packit 8f70b4
h - hours, m - minutes, s - seconds. Default unit is second. E.g. 5h30m or 5.5h.
Packit 8f70b4
Also the interval can be `infinity', `inf', `never', `forever' - it means
Packit 8f70b4
infinite interval. E.g. `sleep forever' or `set dns:cache-expire never'.
Packit 8f70b4
.PP
Packit 8f70b4
Boolean settings can be one of (true, on, yes, 1, +) for a True value
Packit 8f70b4
or one of (false, off, no, 0, -) for a False value.
Packit 8f70b4
.PP
Packit 8f70b4
Tri-boolean settings have either a boolean value or `auto'.
Packit 8f70b4
.PP
Packit 8f70b4
Integer settings can have a suffix: k - kibi, m - mebi, g - gigi, etc.
Packit 8f70b4
They can also have a prefix: 0 - octal, 0x - hexadecimal.
Packit 8f70b4
Packit 8f70b4
.SS FTP asynchronous mode (pipelining)
Packit 8f70b4
.PP
Packit 8f70b4
.B Lftp
Packit 8f70b4
can speed up FTP operations by sending several commands at once and
Packit 8f70b4
then checking all the responses. See ftp:sync-mode variable. Sometimes
Packit 8f70b4
this does not work, thus synchronous mode is the default. You can try
Packit 8f70b4
to turn synchronous mode off and see if it works for you. It is known
Packit 8f70b4
that some network software dealing with address translation works
Packit 8f70b4
incorrectly in the case of several FTP commands in one network packet.
Packit 8f70b4
.PP
Packit 8f70b4
RFC959 says: ``The user-process sending another command before the
Packit 8f70b4
completion reply would be in violation of protocol; but server-FTP
Packit 8f70b4
processes should queue any commands that arrive while a preceding
Packit 8f70b4
command is in progress''. Also, RFC1123 says: ``Implementors MUST
Packit 8f70b4
NOT assume any correspondence between READ boundaries on the control
Packit 8f70b4
connection and the Telnet EOL sequences (CR LF).'' and ``a single READ
Packit 8f70b4
from the control connection may include more than one FTP command''.
Packit 8f70b4
Packit 8f70b4
So it must be safe to send several commands at once, which speeds up
Packit 8f70b4
operation a lot and seems to work with all Unix and VMS based ftp
Packit 8f70b4
servers. Unfortunately, windows based servers often cannot handle
Packit 8f70b4
several commands in one packet, and so cannot some broken routers.
Packit 8f70b4
Packit 8f70b4
.SH OPTIONS
Packit 8f70b4
.TP
Packit 8f70b4
.B \-d
Packit 8f70b4
Switch on debugging mode.
Packit 8f70b4
.TP
Packit 8f70b4
.BI \-e " commands"
Packit 8f70b4
Execute given commands and don't exit.
Packit 8f70b4
.TP
Packit 8f70b4
.BI \-p " port"
Packit 8f70b4
Use the given port to connect.
Packit 8f70b4
.TP
Packit 8f70b4
.BI \-u " user\fR[\fP\fB,\fPpass\fR]\fP"
Packit 8f70b4
Use the given username and password to connect. Remember to quote the
Packit 8f70b4
password properly in the shell. Also note that it is not secure to specify
Packit 8f70b4
the password on command line, use \fI~/.netrc\fP file or
Packit 8f70b4
\fBLFTP_PASSWORD\fP environment variable together with \-\-env\-password
Packit 8f70b4
option. Alternatively you can use ssh-based protocols with authorized keys,
Packit 8f70b4
so you don't have to enter a password.
Packit 8f70b4
.PP
Packit 8f70b4
.TP
Packit 8f70b4
.B \-\-norc
Packit 8f70b4
Don't execute rc files from the home directory.
Packit 8f70b4
.TP
Packit 8f70b4
.BI \-\-rcfile " file"
Packit 8f70b4
Execute commands from the file. May be specified multiple times.
Packit 8f70b4
.TP
Packit 8f70b4
.BI \-f " script_file"
Packit 8f70b4
Execute commands in the file and exit.
Packit 8f70b4
This option must be used alone without other arguments (except \fB\-\-norc\fP).
Packit 8f70b4
.TP
Packit 8f70b4
.BI \-c " commands"
Packit 8f70b4
Execute the given commands and exit. Commands can be separated with
Packit 8f70b4
a semicolon, `&&' or `||'. Remember to quote the commands argument properly in the shell.
Packit 8f70b4
This option must be used alone without other arguments (except \fB\-\-norc\fP).
Packit 8f70b4
.TP
Packit 8f70b4
Other \fBopen\fP options may also be given on the \fBlftp\fP command line.
Packit 8f70b4
Packit 8f70b4
.SH ENVIRONMENT VARIABLES
Packit 8f70b4
The following environment variables are processed by \fBlftp\fR:
Packit 8f70b4
.IP "\fBEDITOR\fP"
Packit 8f70b4
Used as local editor for the \fBedit\fR command.
Packit 8f70b4
.IP "\fBHOME\fP"
Packit 8f70b4
Used for (local) tilde (`~') expansion.
Packit 8f70b4
.IP "\fBSHELL\fP"
Packit 8f70b4
Used by the \fB!\fR command to determine the shell to run.
Packit 8f70b4
.IP "\fBPAGER\fP"
Packit 8f70b4
This should be the name of the pager to use.  It's used by the
Packit 8f70b4
\fBmore\fR and \fBzmore\fR commands.
Packit 8f70b4
.IP "\fBhttp_proxy\fP, \fBhttps_proxy\fP"
Packit 8f70b4
Used to set initial http:proxy, hftp:proxy and https:proxy variables.
Packit 8f70b4
.IP "\fBftp_proxy\fP"
Packit 8f70b4
Used to set initial ftp:proxy or hftp:proxy variables, depending
Packit 8f70b4
on URL protocol used in this environment variable.
Packit 8f70b4
.IP "\fBno_proxy\fP"
Packit 8f70b4
Used to set initial net:no-proxy variable.
Packit 8f70b4
.IP "\fBLFTP_MODULE_PATH\fP"
Packit 8f70b4
Used to set initial module:path variable.
Packit 8f70b4
.IP "\fBLFTP_HOME\fP"
Packit 8f70b4
Used to locate the directory that stores user-specific configuration files. If
Packit 8f70b4
unset, \fI~/.lftp\fR will be used. Please note that if this directory does not
Packit 8f70b4
exist, then XDG directories will be used.
Packit 8f70b4
.IP "\fBLFTP_PASSWORD\fP"
Packit 8f70b4
Used for \-\-env\-password \fBopen\fP option.
Packit 8f70b4
.IP "\fBLS_COLORS\fP"
Packit 8f70b4
used to set initial color:dir-colors variable.
Packit 8f70b4
.IP "\fBXDG_CONFIG_HOME\fP, \fBXDG_DATA_HOME\fP, \fBXDG_CACHE_HOME\fP"
Packit 8f70b4
Used to locate the directories for user-specific files when \fI~/.lftp\fR
Packit 8f70b4
(or \fB$LFTP_HOME\fP directory) does not exist. Defaults are
Packit 8f70b4
\fI~/.config\fR, \fI~/.local/share\fR and \fI~/.cache\fR respectively. The
Packit 8f70b4
suffix \fI/lftp\fR is appended to make the full path to the directories.
Packit 8f70b4
Packit 8f70b4
.SH FILES
Packit 8f70b4
.TP
Packit 8f70b4
.I "/etc/lftp.conf"
Packit 8f70b4
system-wide startup file. Actual location depends on \-\-sysconfdir
Packit 8f70b4
configure option. It is \fI/etc\fR when prefix is \fI/usr\fR,
Packit 8f70b4
\fI/usr/local/etc\fR by default.
Packit 8f70b4
Packit 8f70b4
.TP
Packit 8f70b4
.I "~/.config/lftp/rc \fPor\fI ~/.lftp/rc, ~/.lftprc"
Packit 8f70b4
These files are executed on lftp startup after \fI/etc/lftp.conf\fR.
Packit 8f70b4
.TP
Packit 8f70b4
.I "~/.local/share/lftp/log \fPor\fI ~/.lftp/log"
Packit 8f70b4
The file things are logged to when lftp moves into the background in
Packit 8f70b4
nohup mode.
Packit 8f70b4
.TP
Packit 8f70b4
.I "~/.local/share/lftp/transfer_log \fPor\fI ~/.lftp/transfer_log"
Packit 8f70b4
The file transfers are logged to when log:enabled/xfer setting is set to `yes'.
Packit 8f70b4
The location can be changed by log:file/xfer setting.
Packit 8f70b4
.TP
Packit 8f70b4
.I "~/.local/share/lftp/bookmarks \fPor\fI ~/.lftp/bookmarks"
Packit 8f70b4
The file is used to store lftp's bookmarks.  See the \fBbookmark\fR
Packit 8f70b4
command.
Packit 8f70b4
.TP
Packit 8f70b4
.I "~/.local/share/lftp/cwd_history \fPor\fI ~/.lftp/cwd_history"
Packit 8f70b4
The file is used to store last working directories for each site visited.
Packit 8f70b4
.TP
Packit 8f70b4
.I "~/.local/share/lftp/bg/ \fPor\fI ~/.lftp/bg/"
Packit 8f70b4
The directory is used to store named sockets for backgrounded lftp processes.
Packit 8f70b4
.TP
Packit 8f70b4
.I "~/.cache/lftp/DHT/ \fPor\fI ~/.lftp/DHT/""
Packit 8f70b4
The directory is used to store DHT id and nodes cache for IPv4 and IPv6.
Packit 8f70b4
File name suffix is the host name.
Packit 8f70b4
.TP
Packit 8f70b4
.I "~/.cache/lftp/edit/ \fPor\fI ~/.lftp/edit/""
Packit 8f70b4
The directory is used to store temporary files for \fBedit\fR command.
Packit 8f70b4
.TP
Packit 8f70b4
.I "~/.local/share/lftp/torrent/md/ \fPor\fI ~/.lftp/torrent/md/""
Packit 8f70b4
The directory is used to store torrent metadata. It is especially useful
Packit 8f70b4
for magnet links, cached metadata can be loaded from the directory.
Packit 8f70b4
It can also serve as torrent history, file names are the info_hash of torrents.
Packit 8f70b4
.TP
Packit 8f70b4
.I "~/.netrc"
Packit 8f70b4
The file is consulted to get default login and password to a server
Packit 8f70b4
when it is specified without a protocol to the `open' command.
Packit 8f70b4
Passwords are also searched here if an URL with user name but with no
Packit 8f70b4
password is used.
Packit 8f70b4
Packit 8f70b4
.SH SEE ALSO
Packit 8f70b4
.BR ftpd (8),\  ftp (1)
Packit 8f70b4
.br
Packit 8f70b4
RFC854 (telnet),
Packit 8f70b4
RFC959 (ftp),
Packit 8f70b4
RFC1123,
Packit 8f70b4
RFC1945 (http/1.0),
Packit 8f70b4
RFC2052 (SRV RR),
Packit 8f70b4
RFC2228 (ftp security extensions),
Packit 8f70b4
RFC2389 (ftp FEAT),
Packit 8f70b4
RFC2428 (ftp/ipv6),
Packit 8f70b4
RFC2518 (WebDAV),
Packit 8f70b4
RFC2616 (http/1.1),
Packit 8f70b4
RFC2617 (http/1.1 authentication),
Packit 8f70b4
RFC2640 (ftp i18n),
Packit 8f70b4
RFC3659 (ftp extensions),
Packit 8f70b4
RFC4217 (ftp over ssl),
Packit 8f70b4
BEP0003 (BitTorrent Protocol),
Packit 8f70b4
BEP0005 (DHT Protocol),
Packit 8f70b4
BEP0006 (Fast Extension),
Packit 8f70b4
BEP0007 (IPv6 Tracker Extension),
Packit 8f70b4
BEP0009 (Extension for Peers to Send Metadata Files),
Packit 8f70b4
BEP0010 (Extension Protocol),
Packit 8f70b4
BEP0012 (Multitracker Metadata Extension),
Packit 8f70b4
BEP0023 (Tracker Returns Compact Peer Lists),
Packit 8f70b4
BEP0032 (DHT Extensions for IPv6).
Packit 8f70b4
.br
Packit 8f70b4
.na
Packit 8f70b4
https://tools.ietf.org/html/draft-preston-ftpext-deflate-04
Packit 8f70b4
(ftp deflate transmission mode),
Packit 8f70b4
.br
Packit 8f70b4
https://tools.ietf.org/html/draft-ietf-secsh-filexfer-13
Packit 8f70b4
(sftp).
Packit 8f70b4
.br
Packit 8f70b4
http://wiki.theory.org/BitTorrentSpecification
Packit 8f70b4
.br
Packit 8f70b4
http://www.bittornado.com/docs/multitracker-spec.txt
Packit 8f70b4
.br
Packit 8f70b4
http://www.rasterbar.com/products/libtorrent/dht_sec.html (DHT security extension)
Packit 8f70b4
.br
Packit 8f70b4
http://xbtt.sourceforge.net/udp_tracker_protocol.html (UDP tracker)
Packit 8f70b4
.ad
Packit 8f70b4
Packit 8f70b4
.SH AUTHOR
Packit 8f70b4
.nf
Packit 8f70b4
Alexander V. Lukyanov
Packit 8f70b4
lav@yars.free.net
Packit 8f70b4
.fi
Packit 8f70b4
Packit 8f70b4
.SH ACKNOWLEDGMENTS
Packit 8f70b4
This manual page was originally written by Christoph Lameter
Packit 8f70b4
<clameter@debian.org>, for the Debian GNU/Linux system. The page was
Packit 8f70b4
improved and updated later by Nicolas Lichtmaier <nick@Feedback.com.ar>,
Packit 8f70b4
James Troup <J.J.Troup@comp.brad.ac.uk> and Alexander V. Lukyanov
Packit 8f70b4
<lav@yars.free.net>.