NAME¶
lsftp - Client for the sftp subsystem
SYNOPSIS¶
lsftp [OPTION]... [-- [COMMAND]...]
DESCRIPTION¶
lsftp is a program that connects to a remote sftp server, and can be used
to upload download files á la FTP. When invoked with no command
arguments, lsftp enters interactive mode, much like
ftp (1)
(although with a more feature rich interface, providing tab completion,
recursive up and downloads and more). However, when the
-- argument and
subsequent commands are passed to lsftp, lsftp simply executes those commands
and exits.
OPTIONS¶
Anything (except the special options --,
--help and
--version )
before the last (if any) -- is handled as options, meaning lsftp passes them
directly to the transport program. If you want to pass -- to the transport
program, you must give an extra -- to make sure it's not handled as end of
options, e.g.
lsftp OPTIONS -- MORE OPTIONS --
to enter interactive mode or
lsftp -l OTPIONS -- MORE OPTIONS -- ls
to perform the
ls command.
- Available options:
-
- --help
- Show summary of options.
- --version
- Show version of program.
- --
- End of options (if the last occurence).
COMMANDS¶
- cd directory
- Change the current directory on the remote server to
directory.
- rm filespec
- 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 you must specify the -g option.
- delete
- Alias for rm.
- mkdir dir
- Make directory dir.
- about
- Display information about lsftp.
- help
- Displays a list of commands.
- ?
- Alias for help.
- longhelp
- Displays the list of commands with detailed information
about each command.
- ls filespec
- List remote files and folders.
- list
- Alias for ls.
- dir
- (Another) Alias for ls.
- pwd
- Print the current working directory.
- quit
- Quit lsftp.
- exit
- Quit lsftp.
- set [var=value]
- Sets or shows variables. Without an argument, set
displays the current variable state. With a var=value argument,
set sets the appropriate variable in the environment.
- mail
- Runs the mail (1) command.
- umask [value]
- Sets or displays the remote umask.
- jobs
- Prints information about currently running jobs.
- open site
- Open a sftp connection to site.
- close
- Close the current connection.
- mv old-filename new-filename
- Rename file old-filename to
new-filename.
- rename
- Alias for mv.
- ln file link
- Make link a symlink to file.
- get remote-file
- Retrieve remote-file on the remote system to the
local system.
- put local-file
- Send local-file on the local system to the remote
system.
- chown uid file
- Change the ownership of file to be owned by the user
represented by uid.
- chgrp gid file
- Change the group ownership of file to be owned by
the group represented by gid.
- lcd dir
- Change the current local directory to dir.
- lrm file
- Remove file from the local system.
- ldelete
- Alias for lrm.
- lls
- List files on the local system.
- llist
- Alias for lls.
- lpwd
- Print the current local working directory.
- ! command
- Executes command in a shell on the local system.
ENVIRONMENT¶
- LSFTP_RSH
- The program to use for the SSH tunnel. If the variable is
not set, lsftp defaults to using lshg.
- LSFTP_BEFORE_ARGS
- LSFTP_AFTER_ARGS
-
may be used to specify default options to be parsed before and after the
command line options, making it possible to provide default transport
options as well as commands if desired.
REPORTING BUGS¶
Report bugs to <bug-lsh@gnu.org>.
COPYING¶
The lsh suite of programs is distributed under the GNU General Public License;
see the COPYING and AUTHORS files in the source distribution for details.
AUTHOR¶
The lsh program suite is written mainly by Niels Möller
<nisse@lysator.liu.se>. The lsftp client was written mainly by Pontus
Freyhult.
This man-page was written for lsh 2.0 by Pontus Freyhult
<pont_lsh@soua.net>, it is based on a template written by J.H.M. Dassen
(Ray) <jdassen@wi.LeidenUniv.nl>. Most of the text was taken from the
man page provided for the Debian GNU/Linux system by Timshel Knoll
<timshel@debian.org>.
SEE ALSO¶
lsftp(1),
lshd(8),
sftp(1),
sftp-server(8)
The full documentation for
lsh is maintained as a Texinfo manual. If the
info and
lsh programs are properly installed at your site, the
command
- info lsh
should give you access to the complete manual.