Subversion Repositories

.\"                                      Hey, EMACS: -*- nroff -*-

.\"                                      Hey, EMACS: -*- nroff -*-

.\" First parameter, NAME, should be all caps

.\" First parameter, NAME, should be all caps

.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection

.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection

.\" other parameters are allowed: see man(7), man(1)

.\" other parameters are allowed: see man(7), man(1)

.TH LSFTP 1 "Aug 21 2002" lsftp "lsh manuals"

.TH LSFTP 1 "Aug 21 2002" lsftp "lsh manuals"

.\" Please adjust this date whenever revising the manpage.

.\" Please adjust this date whenever revising the manpage.

.\"

.\"

.\" Some roff macros, for reference:

.\" Some roff macros, for reference:

.\" .nh        disable hyphenation

.\" .nh        disable hyphenation

.\" .hy        enable hyphenation

.\" .hy        enable hyphenation

.\" .ad l      left justify

.\" .ad l      left justify

.\" .ad b      justify to both left and right margins

.\" .ad b      justify to both left and right margins

.\" .nf        disable filling

.\" .nf        disable filling

.\" .fi        enable filling

.\" .fi        enable filling

.\" .br        insert line break

.\" .br        insert line break

.\" .sp <n>    insert n+1 empty lines

.\" .sp <n>    insert n+1 empty lines

.\" for manpage-specific macros, see man(7)

.\" for manpage-specific macros, see man(7)

.SH NAME

.SH NAME

lsftp \- lsh's sftp client

lsftp \- lsh's sftp client

.SH SYNOPSIS

.SH SYNOPSIS

.B lsftp

.B lsftp

.RI [ transport-options ] [-- " command" ...]

.RI [ transport-options ] [-- " command" ...]

.SH DESCRIPTION

.SH DESCRIPTION

This manual page documents briefly the

This manual page documents briefly the

.B lsftp

.B lsftp

command.

command.

This manual page was written for the Debian distribution

This manual page was written for the Debian distribution

because the original program does not have a manual page.

because the original program does not have a manual page.

Instead, it has documentation in the GNU Info format; see below.

Instead, it has documentation in the GNU Info format; see below.

.PP

.PP

.\" TeX users may be more comfortable with the \fB<whatever>\fP and

.\" TeX users may be more comfortable with the \fB<whatever>\fP and

.\" \fI<whatever>\fP escape sequences to invode bold face and italics,

.\" \fI<whatever>\fP escape sequences to invode bold face and italics,

.\" respectively.

.\" respectively.

\fBlsftp\fP is a program that connects to a remote sftp server, and can be

\fBlsftp\fP is a program that connects to a remote sftp server, and can be

used to upload download files \['a] la FTP. When invoked with no command arguments,

used to upload download files \['a] la FTP. When invoked with no command arguments,

lsftp enters interactive mode, much like \fBftp (1)\fP. However, when the

lsftp enters interactive mode, much like \fBftp (1)\fP. However, when the

\fI--\fP argument and subsequent commands are passed to lsftp, lsftp simply

\fI--\fP argument and subsequent commands are passed to lsftp, lsftp simply

executes those commands and exits.

executes those commands and exits.

.SH OPTIONS

.SH OPTIONS

This program follows the usual GNU command line syntax, with long

This program follows the usual GNU command line syntax, with long

options starting with two dashes (`-').

options starting with two dashes (`-').

A summary of options is included below.

A summary of options is included below.

For a complete description, see the Info files.

For a complete description, see the Info files.

.TP

.TP

.B \-\-help

.B \-\-help

Show summary of options.

Show summary of options.

.TP

.TP

.B \-\-version

.B \-\-version

Show version of program.

Show version of program.

.SH COMMANDS

.SH COMMANDS

.TP

.TP

.B cd \fIdirectory\fP

.B cd \fIdirectory\fP

Change the current directory on the remote server to \fIdirectory\fP.

Change the current directory on the remote server to \fIdirectory\fP.

.TP

.TP

.B rm \fIfilespec\fP

.B rm \fIfilespec\fP

Removes files or directories. To delete directories, the \-r option needs to be

Removes files or directories. To delete directories, the \-r option needs to be

specified. The rm command doesn't accept wildcards by default, to enable these

specified. The rm command doesn't accept wildcards by default, to enable these

you must specify the \-g option.

you must specify the \-g option.

.TP

.TP

.B delete

.B delete

Alias for \fBrm\fP.

Alias for \fBrm\fP.

.TP

.TP

.B mkdir \fIdir\fP

.B mkdir \fIdir\fP

Make directory \fIdir\fP.

Make directory \fIdir\fP.

.TP

.TP

.B about

.B about

Display information about lsftp.

Display information about lsftp.

.TP

.TP

.B help

.B help

Displays a list of commands.

Displays a list of commands.

.TP

.TP

.B ?

.B ?

Alias for \fBhelp\fP.

Alias for \fBhelp\fP.

.TP

.TP

.B longhelp

.B longhelp

Displays the list of commands with detailed information about each command.

Displays the list of commands with detailed information about each command.

.TP

.TP

.B ls \fIfilespec\fP

.B ls \fIfilespec\fP

List remote files and folders.

List remote files and folders.

.TP

.TP

.B list

.B list

Alias for \fBls\fP.

Alias for \fBls\fP.

.TP

.TP

.B dir

.B dir

(Another) Alias for \fBls\fP.

(Another) Alias for \fBls\fP.

.TP

.TP

.B pwd

.B pwd

Print the current working directory.

Print the current working directory.

.TP

.TP

.B quit

.B quit

Quit lsftp.

Quit lsftp.

.TP

.TP

.B exit

.B exit

Quit lsftp.

Quit lsftp.

.TP

.TP

.B set [\fIvar=value\fP]

.B set [\fIvar=value\fP]

Sets or shows variables. Without an argument, \fIset\fP displays the current variable state. With

Sets or shows variables. Without an argument, \fIset\fP displays the current variable state. With

a \fIvar=value\fP argument, \fBset\fP sets the appropriate variable in the environment.

a \fIvar=value\fP argument, \fBset\fP sets the appropriate variable in the environment.

.TP

.TP

.B mail

.B mail

Runs the \fBmail (1)\fP command.

Runs the \fBmail (1)\fP command.

.TP

.TP

.B umask [\fIvalue\fP]

.B umask [\fIvalue\fP]

Sets or displays the remote umask.

Sets or displays the remote umask.

.TP

.TP

.B jobs

.B jobs

Prints information about currently running jobs.

Prints information about currently running jobs.

.TP

.TP

.B open \fIsite\fP

.B open \fIsite\fP

Open a sftp connection to \fIsite\fP.

Open a sftp connection to \fIsite\fP.

.TP

.TP

.B close

.B close

Close the current connection.

Close the current connection.

.TP

.TP

.B mv \fIold\-filename\fP \fInew\-filename\fP

.B mv \fIold\-filename\fP \fInew\-filename\fP

Rename file \fIold\-filename\fP to \fInew\-filename\fP.

Rename file \fIold\-filename\fP to \fInew\-filename\fP.

.TP

.TP

.B rename

.B rename

Alias for \fBmv\fP.

Alias for \fBmv\fP.

.TP

.TP

.B ln \fIfile\fP \fIlink\fP

.B ln \fIfile\fP \fIlink\fP

Make \fIlink\fP a symlink to \fIfile\fP.

Make \fIlink\fP a symlink to \fIfile\fP.

.TP

.TP

.B get \fIremote\-file\fP

.B get \fIremote\-file\fP

Retrieve \fIremote\-file\fP on the remote system to the local system.

Retrieve \fIremote\-file\fP on the remote system to the local system.

.TP

.TP

.B put \fIlocal\-file\fP

.B put \fIlocal\-file\fP

Send \fIlocal\-file\fP on the local system to the remote system.

Send \fIlocal\-file\fP on the local system to the remote system.

.TP

.TP

.B chown \fIuid\fP \fIfile\fP

.B chown \fIuid\fP \fIfile\fP

Change the ownership of \fIfile\fP to be owned by the user represented by

Change the ownership of \fIfile\fP to be owned by the user represented by

\fIuid\fP.

\fIuid\fP.

.TP

.TP

.B chgrp \fIgid\fP \fIfile\fP

.B chgrp \fIgid\fP \fIfile\fP

Change the group ownership of \fIfile\fP to be owned by the group represented by

Change the group ownership of \fIfile\fP to be owned by the group represented by

\fIgid\fP.

\fIgid\fP.

.TP

.TP

.B lcd \fIdir\fP

.B lcd \fIdir\fP

Change the current local directory to \fIdir\fP.

Change the current local directory to \fIdir\fP.

.TP

.TP

.B lrm \fIfile\fP

.B lrm \fIfile\fP

Remove \fIfile\fP from the \fBlocal\fP system.

Remove \fIfile\fP from the \fBlocal\fP system.

.TP

.TP

.B ldelete

.B ldelete

Alias for \fBlrm\fP.

Alias for \fBlrm\fP.

.TP

.TP

.B lls

.B lls

List files on the local system.

List files on the local system.

.TP

.TP

.B llist

.B llist

Alias for \fBlls\fP.

Alias for \fBlls\fP.

.TP

.TP

.B lpwd

.B lpwd

Print the current local working directory.

Print the current local working directory.

.TP

.TP

.B ! \fIcommand\fP

.B ! \fIcommand\fP

Executes \fIcommand\fP in a shell on the local system.

Executes \fIcommand\fP in a shell on the local system.

.SH ENVIRONMENT

.SH ENVIRONMENT

.TP

.TP

.B LSFTP_RSH

.B LSFTP_RSH

The program to use for the SSH tunnel. If the variable is not set, lsftp

The program to use for the SSH tunnel. If the variable is not set, lsftp

defaults to using lshg.

defaults to using lshg.

.TP

.TP

.B LSFTP_BEFORE_ARGS

.B LSFTP_BEFORE_ARGS

.TP

.TP

.B LSFTP_AFTER_ARGS

.B LSFTP_AFTER_ARGS

.SH SEE ALSO

.SH SEE ALSO

.BR mail (1),

.BR mail (1),

.BR lshd (8),

.BR lshd (8),

.BR lshg (8).

.BR lshg (8).

.BR

.BR

The programs are documented fully by

The programs are documented fully by

.IR "Lsh" ,

.IR "Lsh" ,

available via the Info system.

available via the Info system.

.SH AUTHOR

.SH AUTHOR

This manual page was written by Timshel Knoll <timshel@debian.org>,

This manual page was written by Timshel Knoll <timshel@debian.org>,

for the Debian GNU/Linux system (but may be used by others).

for the Debian GNU/Linux system (but may be used by others).