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: August 28 2022 $
26 .Oo Ar user Ns @ Oc Ns Ar host Ns Op : Ns Ar port
34 The options are as follows:
37 Use TLS for the connection.
41 .It Fl C Ar certificate
42 Specify the path to the client
44 to be use during the TLS handsahke.
48 Specify the path to the client certificate
50 to be used during the TLS handshake.
51 If not given, the file passed to
58 The following commands are recognized by
61 .It Ic bell Oo Cm on | off Oc
62 Request terminal to sound a bell after each command.
63 Without arguments toggle the current state.
65 Terminate the session.
68 .It Ic cd Ar remote-path
69 Change the working directory on the remote machine to
71 .It Ic edit Ar remote-path
74 and open it with the preferred editor
83 then attempt to re-upload it.
84 .It Ic get Ar remote-file Op Ar local-file
87 and save it locally as
91 is not given, use the file name from
93 .It Ic hexdump Oo Cm on | off Oc
94 Print the packets sent from/to the server.
95 Without arguments, toggle the current state.
96 .It Ic lcd Op Ar local-directory
97 Change the local current working directory to
103 Print the local working directory.
105 List the file in the remote current working directory.
106 .It Ic page Ar remote-file
111 .Pq Xr less 1 by default .
112 .It Ic pipe Ar remote-file Ar cmd Op Ar args...
115 and pass it as standard input for
119 .It Ic put Ar local-file Op Ar remote-file
127 use the file name from
130 Terminate the session.
133 .It Ic rename Ar remote-file Ar new-remote-name
138 on the remote server.
139 .It Ic verbose Oo Cm on | off Oc
140 Print verbose information.
141 Without arguments toggle the current state.
144 The following environment variables are inspected:
147 The user login directory.
152 .It Ev VISUAL, Ev EDITOR
153 The program used to edit files.
158 If both are undefined,
168 utility was written by
169 .An Omar Polo Aq Mt op@omarpolo.com .