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.

LSFTP                                             NOVEMBER 2004                                         LSFTP(1)