LSFTP(1)							    Lsh Manuals 							  LSFTP(1)

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 a 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,  recur-
       sive  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 Moller <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)