1 fb1a36c0 2022-01-09 op .\" Copyright (c) 2021 Omar Polo <op@omarpolo.com>
  2 fb1a36c0 2022-01-09 op .\"
  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.
  6 fb1a36c0 2022-01-09 op .\"
  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.
 14 fb1a36c0 2022-01-09 op .\"
 15 6cd1a16b 2022-10-07 op .Dd $Mdocdate: October 7 2022 $
 16 fb1a36c0 2022-01-09 op .Dt KAMIFTP 1
 17 fb1a36c0 2022-01-09 op .Os
 18 fb1a36c0 2022-01-09 op .Sh NAME
 19 fb1a36c0 2022-01-09 op .Nm kamiftp
 20 fb1a36c0 2022-01-09 op .Nd 9p client
 21 fb1a36c0 2022-01-09 op .Sh SYNOPSIS
 22 fb1a36c0 2022-01-09 op .Nm
 23 fb1a36c0 2022-01-09 op .Op Fl c
 24 fb1a36c0 2022-01-09 op .Op Fl C Ar cert
 25 fb1a36c0 2022-01-09 op .Op Fl K Ar key
 26 e22049cc 2022-08-28 op .Oo Ar user Ns @ Oc Ns Ar host Ns Op : Ns Ar port
 27 9e0cb828 2022-08-28 op .Op Ar path
 28 fb1a36c0 2022-01-09 op .Sh DESCRIPTION
 29 fb1a36c0 2022-01-09 op .Nm
 30 fb1a36c0 2022-01-09 op is a
 31 fb1a36c0 2022-01-09 op .Xr 9p 7
 32 fb1a36c0 2022-01-09 op client.
 33 fb1a36c0 2022-01-09 op .Pp
 34 fb1a36c0 2022-01-09 op The options are as follows:
 35 fb1a36c0 2022-01-09 op .Bl -tag -width Ds
 36 fb1a36c0 2022-01-09 op .It Fl c
 37 fb1a36c0 2022-01-09 op Use TLS for the connection.
 38 3c615b61 2022-01-30 op If used,
 39 fb1a36c0 2022-01-09 op .Fl C
 40 3c615b61 2022-01-30 op is mandatory.
 41 fb1a36c0 2022-01-09 op .It Fl C Ar certificate
 42 fb1a36c0 2022-01-09 op Specify the path to the client
 43 fb1a36c0 2022-01-09 op .Ar certificate
 44 fb1a36c0 2022-01-09 op to be use during the TLS handsahke.
 45 ce28299c 2022-01-30 op Implies
 46 ce28299c 2022-01-30 op .Fl c .
 47 fb1a36c0 2022-01-09 op .It Fl K Ar key
 48 fb1a36c0 2022-01-09 op Specify the path to the client certificate
 49 fb1a36c0 2022-01-09 op .Ar key
 50 fb1a36c0 2022-01-09 op to be used during the TLS handshake.
 51 3b95ae81 2022-01-30 op If not given, the file passed to
 52 3b95ae81 2022-01-30 op .Fl C
 53 3b95ae81 2022-01-30 op will be used.
 54 ce28299c 2022-01-30 op Implies
 55 ce28299c 2022-01-30 op .Fl c .
 56 fb1a36c0 2022-01-09 op .El
 57 fb1a36c0 2022-01-09 op .Pp
 58 fb1a36c0 2022-01-09 op The following commands are recognized by
 59 fb1a36c0 2022-01-09 op .Nm :
 60 fb1a36c0 2022-01-09 op .Bl -tag -width Ds
 61 fb1a36c0 2022-01-09 op .It Ic bell Oo Cm on | off Oc
 62 fb1a36c0 2022-01-09 op Request terminal to sound a bell after each command.
 63 fb1a36c0 2022-01-09 op Without arguments toggle the current state.
 64 fb1a36c0 2022-01-09 op .It Ic bye
 65 fb1a36c0 2022-01-09 op Terminate the session.
 66 fb1a36c0 2022-01-09 op Synomym of
 67 fb1a36c0 2022-01-09 op .Ic quit .
 68 11cd7416 2022-01-16 op .It Ic cd Ar remote-path
 69 11cd7416 2022-01-16 op Change the working directory on the remote machine to
 70 11cd7416 2022-01-16 op .Ar remote-path .
 71 11cd7416 2022-01-16 op .It Ic edit Ar remote-path
 72 11cd7416 2022-01-16 op Download
 73 11cd7416 2022-01-16 op .Ar remote-path
 74 11cd7416 2022-01-16 op and open it with the preferred editor
 75 11cd7416 2022-01-16 op .Po
 76 11cd7416 2022-01-16 op .Ev VISUAL
 77 11cd7416 2022-01-16 op or
 78 11cd7416 2022-01-16 op .Ev EDITOR
 79 11cd7416 2022-01-16 op with
 80 11cd7416 2022-01-16 op .Xr ed 1
 81 11cd7416 2022-01-16 op as fallback
 82 11cd7416 2022-01-16 op .Pc
 83 11cd7416 2022-01-16 op then attempt to re-upload it.
 84 11cd7416 2022-01-16 op .It Ic get Ar remote-file Op Ar local-file
 85 11cd7416 2022-01-16 op Fetch
 86 11cd7416 2022-01-16 op .Ar remote-file
 87 11cd7416 2022-01-16 op and save it locally as
 88 11cd7416 2022-01-16 op .Ar local-file .
 89 11cd7416 2022-01-16 op If
 90 11cd7416 2022-01-16 op .Ar local-file
 91 11cd7416 2022-01-16 op is not given, use the file name from
 92 11cd7416 2022-01-16 op .Ar remote-file .
 93 5565d021 2022-01-16 op .It Ic hexdump Oo Cm on | off Oc
 94 5565d021 2022-01-16 op Print the packets sent from/to the server.
 95 5565d021 2022-01-16 op Without arguments, toggle the current state.
 96 11cd7416 2022-01-16 op .It Ic lcd Op Ar local-directory
 97 11cd7416 2022-01-16 op Change the local current working directory to
 98 11cd7416 2022-01-16 op .Ar local-directory
 99 11cd7416 2022-01-16 op or the
100 11cd7416 2022-01-16 op .Ev HOME
101 11cd7416 2022-01-16 op if not given.
102 11cd7416 2022-01-16 op .It Ic lpwd
103 11cd7416 2022-01-16 op Print the local working directory.
104 fb1a36c0 2022-01-09 op .It Ic ls
105 11cd7416 2022-01-16 op List the file in the remote current working directory.
106 11cd7416 2022-01-16 op .It Ic page Ar remote-file
107 11cd7416 2022-01-16 op Download
108 11cd7416 2022-01-16 op .Ar remote-file
109 11cd7416 2022-01-16 op and open it with the
110 11cd7416 2022-01-16 op .Ev PAGER
111 11cd7416 2022-01-16 op .Pq Xr less 1 by default .
112 1c9ab7cf 2022-01-29 op .It Ic pipe Ar remote-file Ar cmd Op Ar args...
113 1c9ab7cf 2022-01-29 op Fetch
114 1c9ab7cf 2022-01-29 op .Ar remote-file
115 1c9ab7cf 2022-01-29 op and pass it as standard input for
116 1c9ab7cf 2022-01-29 op .Ar cmd
117 1c9ab7cf 2022-01-29 op (with optional
118 1c9ab7cf 2022-01-29 op .Ar args Ns ).
119 11cd7416 2022-01-16 op .It Ic put Ar local-file Op Ar remote-file
120 11cd7416 2022-01-16 op Upload
121 11cd7416 2022-01-16 op .Ar local-file
122 11cd7416 2022-01-16 op to
123 11cd7416 2022-01-16 op .Ar remote-file .
124 11cd7416 2022-01-16 op If
125 11cd7416 2022-01-16 op .Ar remote-file
126 11cd7416 2022-01-16 op is not given,
127 11cd7416 2022-01-16 op use the file name from
128 11cd7416 2022-01-16 op .Ar local-file .
129 fb1a36c0 2022-01-09 op .It Ic quit
130 fb1a36c0 2022-01-09 op Terminate the session.
131 fb1a36c0 2022-01-09 op Synomym of
132 fb1a36c0 2022-01-09 op .Ic bye .
133 424338c2 2022-01-29 op .It Ic rename Ar remote-file Ar new-remote-name
134 13b8bb0a 2022-01-17 op Renames
135 13b8bb0a 2022-01-17 op .Ar remote-file
136 13b8bb0a 2022-01-17 op to
137 13b8bb0a 2022-01-17 op .Ar new-remote-name
138 13b8bb0a 2022-01-17 op on the remote server.
139 fb1a36c0 2022-01-09 op .It Ic verbose Oo Cm on | off Oc
140 fb1a36c0 2022-01-09 op Print verbose information.
141 fb1a36c0 2022-01-09 op Without arguments toggle the current state.
142 fb1a36c0 2022-01-09 op .El
143 11cd7416 2022-01-16 op .Sh ENVIRONMENT
144 11cd7416 2022-01-16 op The following environment variables are inspected:
145 11cd7416 2022-01-16 op .Bl -tag -width Ds
146 11cd7416 2022-01-16 op .It Ev HOME
147 11cd7416 2022-01-16 op The user login directory.
148 11cd7416 2022-01-16 op .It Ev PAGER
149 7d4a725d 2022-01-17 op The pager to use,
150 11cd7416 2022-01-16 op .Xr less 1
151 11cd7416 2022-01-16 op by default.
152 16012c8f 2022-10-07 op .It Ev VISUAL , Ev EDITOR
153 11cd7416 2022-01-16 op The program used to edit files.
154 11cd7416 2022-01-16 op .Ev VISUAL
155 11cd7416 2022-01-16 op is inspected first,
156 11cd7416 2022-01-16 op .Ev EDITOR
157 11cd7416 2022-01-16 op as a fallback.
158 11cd7416 2022-01-16 op If both are undefined,
159 11cd7416 2022-01-16 op .Xr ed 1
160 11cd7416 2022-01-16 op is given some love.
161 6cd1a16b 2022-10-07 op .It Ev USER
162 6cd1a16b 2022-10-07 op Default login, used if no
163 6cd1a16b 2022-10-07 op .Ar user
164 6cd1a16b 2022-10-07 op is given on the command line.
165 11cd7416 2022-01-16 op .El
166 fb1a36c0 2022-01-09 op .Sh SEE ALSO
167 fb1a36c0 2022-01-09 op .Xr 9p 7 ,
168 fb1a36c0 2022-01-09 op .Xr kamid 8
169 fb1a36c0 2022-01-09 op .Sh AUTHORS
170 fb1a36c0 2022-01-09 op The
171 fb1a36c0 2022-01-09 op .Nm
172 fb1a36c0 2022-01-09 op utility was written by
173 fb1a36c0 2022-01-09 op .An Omar Polo Aq Mt op@omarpolo.com .