|
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>.
|