1 fb1a36c0 2022-01-09 op .\" Copyright (c) 2021 Omar Polo <op@omarpolo.com>
3 fb1a36c0 2022-01-09 op .\" Permission to use, copy, modify, and distribute this software for any
4 fb1a36c0 2022-01-09 op .\" purpose with or without fee is hereby granted, provided that the above
5 fb1a36c0 2022-01-09 op .\" copyright notice and this permission notice appear in all copies.
7 fb1a36c0 2022-01-09 op .\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
8 fb1a36c0 2022-01-09 op .\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
9 fb1a36c0 2022-01-09 op .\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
10 fb1a36c0 2022-01-09 op .\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
11 fb1a36c0 2022-01-09 op .\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
12 fb1a36c0 2022-01-09 op .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
13 fb1a36c0 2022-01-09 op .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
15 fb1a36c0 2022-01-09 op .Dd $Mdocdate: December 14 2021 $
24 fb1a36c0 2022-01-09 op .Op Fl C Ar cert
25 fb1a36c0 2022-01-09 op .Op Fl K Ar key
26 fb1a36c0 2022-01-09 op .Ar host Op Ar path
27 fb1a36c0 2022-01-09 op .Sh DESCRIPTION
33 fb1a36c0 2022-01-09 op The options are as follows:
34 fb1a36c0 2022-01-09 op .Bl -tag -width Ds
36 fb1a36c0 2022-01-09 op Use TLS for the connection.
40 fb1a36c0 2022-01-09 op .It Fl C Ar certificate
41 fb1a36c0 2022-01-09 op Specify the path to the client
42 fb1a36c0 2022-01-09 op .Ar certificate
43 fb1a36c0 2022-01-09 op to be use during the TLS handsahke.
46 fb1a36c0 2022-01-09 op .It Fl K Ar key
47 fb1a36c0 2022-01-09 op Specify the path to the client certificate
49 fb1a36c0 2022-01-09 op to be used during the TLS handshake.
50 3b95ae81 2022-01-30 op If not given, the file passed to
57 fb1a36c0 2022-01-09 op The following commands are recognized by
59 fb1a36c0 2022-01-09 op .Bl -tag -width Ds
60 fb1a36c0 2022-01-09 op .It Ic bell Oo Cm on | off Oc
61 fb1a36c0 2022-01-09 op Request terminal to sound a bell after each command.
62 fb1a36c0 2022-01-09 op Without arguments toggle the current state.
64 fb1a36c0 2022-01-09 op Terminate the session.
67 11cd7416 2022-01-16 op .It Ic cd Ar remote-path
68 11cd7416 2022-01-16 op Change the working directory on the remote machine to
69 11cd7416 2022-01-16 op .Ar remote-path .
70 11cd7416 2022-01-16 op .It Ic edit Ar remote-path
72 11cd7416 2022-01-16 op .Ar remote-path
73 11cd7416 2022-01-16 op and open it with the preferred editor
82 11cd7416 2022-01-16 op then attempt to re-upload it.
83 11cd7416 2022-01-16 op .It Ic get Ar remote-file Op Ar local-file
85 11cd7416 2022-01-16 op .Ar remote-file
86 11cd7416 2022-01-16 op and save it locally as
87 11cd7416 2022-01-16 op .Ar local-file .
89 11cd7416 2022-01-16 op .Ar local-file
90 11cd7416 2022-01-16 op is not given, use the file name from
91 11cd7416 2022-01-16 op .Ar remote-file .
92 5565d021 2022-01-16 op .It Ic hexdump Oo Cm on | off Oc
93 5565d021 2022-01-16 op Print the packets sent from/to the server.
94 5565d021 2022-01-16 op Without arguments, toggle the current state.
95 11cd7416 2022-01-16 op .It Ic lcd Op Ar local-directory
96 11cd7416 2022-01-16 op Change the local current working directory to
97 11cd7416 2022-01-16 op .Ar local-directory
100 11cd7416 2022-01-16 op if not given.
102 11cd7416 2022-01-16 op Print the local working directory.
104 11cd7416 2022-01-16 op List the file in the remote current working directory.
105 11cd7416 2022-01-16 op .It Ic page Ar remote-file
107 11cd7416 2022-01-16 op .Ar remote-file
108 11cd7416 2022-01-16 op and open it with the
110 11cd7416 2022-01-16 op .Pq Xr less 1 by default .
111 1c9ab7cf 2022-01-29 op .It Ic pipe Ar remote-file Ar cmd Op Ar args...
113 1c9ab7cf 2022-01-29 op .Ar remote-file
114 1c9ab7cf 2022-01-29 op and pass it as standard input for
116 1c9ab7cf 2022-01-29 op (with optional
117 1c9ab7cf 2022-01-29 op .Ar args Ns ).
118 11cd7416 2022-01-16 op .It Ic put Ar local-file Op Ar remote-file
120 11cd7416 2022-01-16 op .Ar local-file
122 11cd7416 2022-01-16 op .Ar remote-file .
124 11cd7416 2022-01-16 op .Ar remote-file
125 11cd7416 2022-01-16 op is not given,
126 11cd7416 2022-01-16 op use the file name from
127 11cd7416 2022-01-16 op .Ar local-file .
129 fb1a36c0 2022-01-09 op Terminate the session.
132 424338c2 2022-01-29 op .It Ic rename Ar remote-file Ar new-remote-name
134 13b8bb0a 2022-01-17 op .Ar remote-file
136 13b8bb0a 2022-01-17 op .Ar new-remote-name
137 13b8bb0a 2022-01-17 op on the remote server.
138 fb1a36c0 2022-01-09 op .It Ic verbose Oo Cm on | off Oc
139 fb1a36c0 2022-01-09 op Print verbose information.
140 fb1a36c0 2022-01-09 op Without arguments toggle the current state.
142 11cd7416 2022-01-16 op .Sh ENVIRONMENT
143 11cd7416 2022-01-16 op The following environment variables are inspected:
144 11cd7416 2022-01-16 op .Bl -tag -width Ds
146 11cd7416 2022-01-16 op The user login directory.
148 7d4a725d 2022-01-17 op The pager to use,
151 11cd7416 2022-01-16 op .It Ev VISUAL, Ev EDITOR
152 11cd7416 2022-01-16 op The program used to edit files.
154 11cd7416 2022-01-16 op is inspected first,
156 11cd7416 2022-01-16 op as a fallback.
157 11cd7416 2022-01-16 op If both are undefined,
159 11cd7416 2022-01-16 op is given some love.
167 fb1a36c0 2022-01-09 op utility was written by
168 fb1a36c0 2022-01-09 op .An Omar Polo Aq Mt op@omarpolo.com .