1 .\" Copyright (c) 2021 Omar Polo <op@omarpolo.com>
3 .\" Permission to use, copy, modify, and distribute this software for any
4 .\" purpose with or without fee is hereby granted, provided that the above
5 .\" copyright notice and this permission notice appear in all copies.
7 .\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
8 .\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
9 .\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
10 .\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
11 .\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
12 .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
13 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
15 .Dd $Mdocdate: November 23 2022 $
26 .Oo 9p:// Oc Ns Oo Ar user Ns @ Oc Ns Ar host Ns Oo : Ns Ar port Oc Ns Op / Ns Ar path
36 downloads it in the current directory and exit, otherwise changes the
37 remote working directory and starts accepting commands.
39 The options are as follows:
44 .It Fl C Ar certificate
45 Connect with TLS to the remote server and use the given
47 during the TLS handsahke.
49 Specify the path to the client certificate
51 to be used during the TLS handshake.
52 If not given, the file passed to
59 When fetching the file specified to the command line,
62 To write the content to standard output, use
64 It's an error to specify
74 parses the input similarly to
76 Words are splitted on spaces, multiple spaces are collapsed into one.
81 can be used to preserve spaces and other quotes.
83 can be used to quote the following character.
84 No special meaning is given to
93 The following commands are recognized by
96 .It Ic bell Oo Cm on | off Oc
97 Request terminal to sound a bell after each command.
98 Without arguments toggle the current state.
100 Terminate the session.
103 .It Ic cd Ar remote-path
104 Change the working directory on the remote machine to
106 .It Ic edit Ar remote-path
109 and open it with the preferred editor
118 then attempt to re-upload it.
119 .It Ic get Ar remote-file Op Ar local-file
122 and save it locally as
126 is not given, use the file name from
128 .It Ic hexdump Oo Cm on | off Oc
129 Print the packets sent from/to the server.
130 Without arguments, toggle the current state.
131 .It Ic lcd Op Ar local-directory
132 Change the local current working directory to
138 Print the local working directory.
140 List the file in the remote current working directory or
143 .It Ic page Ar remote-file
148 .Pq Xr less 1 by default .
149 .It Ic pipe Ar remote-file Ar cmd Op Ar args...
152 and pass it as standard input for
156 .It Ic put Ar local-file Op Ar remote-file
164 use the file name from
167 Terminate the session.
170 .It Ic rename Ar remote-file Ar new-remote-name
175 on the remote server.
177 Remove the remote files.
178 .It Ic verbose Oo Cm on | off Oc
179 Print verbose information.
180 Without arguments toggle the current state.
183 The following environment variables are inspected:
186 The user login directory.
191 .It Ev VISUAL , Ev EDITOR
192 The program used to edit files.
197 If both are undefined,
201 Default login, used if no
203 is given on the command line.
211 utility was written by
212 .An Omar Polo Aq Mt op@omarpolo.com .