LSFTP(1)

✨ LSFTP(1) ✨

okay bestie, sit down, hydrate, and let me tell you about lsftp — she's the client for the sftp subsystem, she ships with the Lsh Manuals, and she is, genuinely, that girl. 💅

---

🎀 NAME 🎀

lsftp — Client for the sftp subsystem. short, sweet, no notes. 🦋

---

🌸 SYNOPSIS 🌸

lsftp [OPTION]... [-- [COMMAND]...]

---

💖 DESCRIPTION 💖

so lsftp is a program that connects to a remote sftp server, and you can use it to upload and download files á la FTP. very nostalgic, very slay. 🌈

when you invoke her with no command arguments, lsftp drops into interactive mode, much like ftp (1) — except the interface is more feature rich, okay? she's giving tab completion, recursive up and downloads and more. main character energy fr fr. 👑

but when you pass the -- argument and subsequent commands to lsftp, she simply executes those commands and exits. no small talk, no lingering, just business. periodt. 💅

---

✨ OPTIONS ✨

okay so the rules here are a little spicy, stay with me. 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. we love a quick recap. 💖
• --version — Show version of program. know your era. ⭐
• -- — End of options (if the last occurence). that's the last one that counts, iykyk. 🫶

---

🦋 COMMANDS 🦋

here's the whole menu, bestie, nothing skipped, nothing gatekept:

• 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. ⚠️ careful with that one, she bites.
• 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. the deluxe edition. ✨
• 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

these two 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. so much freedom, obsessed. 🎀

---

🙈 REPORTING BUGS 🙈

Report bugs to <bug-lsh@gnu.org>. be nice, they're doing their best. 💜

---

👑 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. read the receipts, bestie. 📜

---

💜 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>. legends only. 🫶

---

⭐ 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. go read it, it's giving encyclopedia but make it cute. 📚✨

---

and that's the whole page, bestie — this one's LSFTP, dated NOVEMBER 2004, and yeah, she's still LSFTP(1) at heart. no cap, she ate. 💅💖