Blame doc/lftp.1

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