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 fb1a36c0 2022-01-09 op .Dd $Mdocdate: December 16 2021 $
 16 fb1a36c0 2022-01-09 op .Dt KAMIREPL 1
 17 fb1a36c0 2022-01-09 op .Os
 18 fb1a36c0 2022-01-09 op .Sh NAME
 19 fb1a36c0 2022-01-09 op .Nm kamirepl
 20 fb1a36c0 2022-01-09 op .Nd 9p repl client
 21 fb1a36c0 2022-01-09 op .Sh SYNOPSIS
 22 fb1a36c0 2022-01-09 op .Nm
 23 fb1a36c0 2022-01-09 op .Op Fl chv
 24 fb1a36c0 2022-01-09 op .Op Fl C Ar cert
 25 fb1a36c0 2022-01-09 op .Op Fl H Ar host
 26 fb1a36c0 2022-01-09 op .Op Fl K Ar key
 27 fb1a36c0 2022-01-09 op .Op Fl P Ar port
 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 repl client.
 33 fb1a36c0 2022-01-09 op .Pp
 34 fb1a36c0 2022-01-09 op The optinos are as follows:
 35 fb1a36c0 2022-01-09 op .Bl -tag -width tenletters
 36 fb1a36c0 2022-01-09 op .It Fl C Ar cert
 37 fb1a36c0 2022-01-09 op Path to the TLS client certificate to use.
 38 fb1a36c0 2022-01-09 op .It Fl c
 39 fb1a36c0 2022-01-09 op Use TLS for the connection.
 40 fb1a36c0 2022-01-09 op .Fl C
 41 fb1a36c0 2022-01-09 op and
 42 fb1a36c0 2022-01-09 op .Fl K
 43 fb1a36c0 2022-01-09 op are mandatory if used.
 44 fb1a36c0 2022-01-09 op .It Fl H Ar host
 45 fb1a36c0 2022-01-09 op Hostname of the file server.
 46 fb1a36c0 2022-01-09 op .It Fl h
 47 fb1a36c0 2022-01-09 op Display usage and exit.
 48 fb1a36c0 2022-01-09 op .It Fl K Ar key
 49 fb1a36c0 2022-01-09 op Path to the TLS client certificate private key.
 50 fb1a36c0 2022-01-09 op .It Fl P Ar port
 51 fb1a36c0 2022-01-09 op Port number to connect to.
 52 fb1a36c0 2022-01-09 op .It Fl v
 53 fb1a36c0 2022-01-09 op Verbose logging.
 54 fb1a36c0 2022-01-09 op .El
 55 fb1a36c0 2022-01-09 op .Pp
 56 fb1a36c0 2022-01-09 op The interactive commands are
 57 fb1a36c0 2022-01-09 op .Bl -tag -width Ds
 58 fb1a36c0 2022-01-09 op .It Ic version Op Ar version-string
 59 fb1a36c0 2022-01-09 op .Ar version-string
 60 fb1a36c0 2022-01-09 op is
 61 fb1a36c0 2022-01-09 op .Dq 9P2000
 62 fb1a36c0 2022-01-09 op by default.
 63 fb1a36c0 2022-01-09 op .It Ic attach Ar fid Ar uname Ar aname
 64 fb1a36c0 2022-01-09 op Request the file server to attach the file tree identified by
 65 fb1a36c0 2022-01-09 op .Ar aname
 66 fb1a36c0 2022-01-09 op to the specified
 67 fb1a36c0 2022-01-09 op .Ar fid
 68 fb1a36c0 2022-01-09 op number.
 69 fb1a36c0 2022-01-09 op .Ar aname
 70 fb1a36c0 2022-01-09 op is the identifier for the user.
 71 fb1a36c0 2022-01-09 op The afid used is implicitly NOFID.
 72 fb1a36c0 2022-01-09 op .It Ic clunk Ar fid
 73 fb1a36c0 2022-01-09 op Closes
 74 fb1a36c0 2022-01-09 op .Ar fid.
 75 fb1a36c0 2022-01-09 op .It Ic flush Ar oldtag
 76 fb1a36c0 2022-01-09 op Require the server to flush
 77 fb1a36c0 2022-01-09 op .Ar oldtag .
 78 fb1a36c0 2022-01-09 op .It Ic walk Ar fid Ar newfid Ar wnames...
 79 fb1a36c0 2022-01-09 op Do a walk from
 80 fb1a36c0 2022-01-09 op .Ar fid
 81 fb1a36c0 2022-01-09 op following
 82 fb1a36c0 2022-01-09 op .Ar wnames
 83 fb1a36c0 2022-01-09 op component and associating the reached file to
 84 fb1a36c0 2022-01-09 op .Ar newfid .
 85 fb1a36c0 2022-01-09 op .It Ic open Ar fid Ar mode Op Ar flag
 86 fb1a36c0 2022-01-09 op Prepare
 87 fb1a36c0 2022-01-09 op .Ar fid
 88 fb1a36c0 2022-01-09 op for I/O.
 89 fb1a36c0 2022-01-09 op .Ar mode
 90 fb1a36c0 2022-01-09 op can be one of
 91 fb1a36c0 2022-01-09 op .Sq read
 92 fb1a36c0 2022-01-09 op or
 93 fb1a36c0 2022-01-09 op .Sq r ,
 94 fb1a36c0 2022-01-09 op .Sq write
 95 fb1a36c0 2022-01-09 op or
 96 fb1a36c0 2022-01-09 op .Sq w ,
 97 fb1a36c0 2022-01-09 op .Sq readwrite
 98 fb1a36c0 2022-01-09 op or
 99 fb1a36c0 2022-01-09 op .Sq rdwr .
100 fb1a36c0 2022-01-09 op Optionally,
101 fb1a36c0 2022-01-09 op .Ar flag
102 fb1a36c0 2022-01-09 op can be on of
103 fb1a36c0 2022-01-09 op .Sq trunc
104 fb1a36c0 2022-01-09 op to truncate the file or
105 fb1a36c0 2022-01-09 op .Sq rclose
106 fb1a36c0 2022-01-09 op to remove the file upon
107 fb1a36c0 2022-01-09 op .Ic clunk .
108 fb1a36c0 2022-01-09 op .It Ic create Ar fid Ar name Ar perm Ar mode
109 fb1a36c0 2022-01-09 op Create the file
110 fb1a36c0 2022-01-09 op .Ar name
111 fb1a36c0 2022-01-09 op and open it with
112 fb1a36c0 2022-01-09 op .Ar mode
113 fb1a36c0 2022-01-09 op as the given
114 fb1a36c0 2022-01-09 op .Ar fid.
115 fb1a36c0 2022-01-09 op .Ar perm
116 fb1a36c0 2022-01-09 op should be used to select the permissions of the file, but is currently
117 fb1a36c0 2022-01-09 op unused.
118 fb1a36c0 2022-01-09 op .It Ic read Ar fid Ar offset Ar count
119 fb1a36c0 2022-01-09 op Issue a read request for the given
120 fb1a36c0 2022-01-09 op .Ar fid ,
121 fb1a36c0 2022-01-09 op which must have been prepared for I/O with
122 fb1a36c0 2022-01-09 op .Ic open ,
123 fb1a36c0 2022-01-09 op at
124 fb1a36c0 2022-01-09 op .Ar offset
125 fb1a36c0 2022-01-09 op and for
126 fb1a36c0 2022-01-09 op .Ar count
127 fb1a36c0 2022-01-09 op bytes.
128 fb1a36c0 2022-01-09 op .It Ic write Ar fid Ar offset Ar content
129 fb1a36c0 2022-01-09 op Writes
130 fb1a36c0 2022-01-09 op .Ar content
131 fb1a36c0 2022-01-09 op to
132 fb1a36c0 2022-01-09 op .Ar fid
133 fb1a36c0 2022-01-09 op starting at
134 fb1a36c0 2022-01-09 op .Ar offset .
135 fb1a36c0 2022-01-09 op .It Ic remove Ar fid
136 fb1a36c0 2022-01-09 op Delete the file identified by
137 fb1a36c0 2022-01-09 op .Ar fid
138 fb1a36c0 2022-01-09 op and close it.
139 fb1a36c0 2022-01-09 op Even in case of error,
140 fb1a36c0 2022-01-09 op .Ar fid
141 fb1a36c0 2022-01-09 op is clunked.
142 fb1a36c0 2022-01-09 op .El
143 fb1a36c0 2022-01-09 op .Sh SEE ALSO
144 fb1a36c0 2022-01-09 op .Xr kamiftp 1
145 fb1a36c0 2022-01-09 op .Xr 9p 7
146 fb1a36c0 2022-01-09 op .Xr kamid 8
147 fb1a36c0 2022-01-09 op .Sh AUTHORS
148 fb1a36c0 2022-01-09 op .An -nosplit
149 fb1a36c0 2022-01-09 op The
150 fb1a36c0 2022-01-09 op .Nm
151 fb1a36c0 2022-01-09 op utility was written by
152 fb1a36c0 2022-01-09 op .An Omar Polo Aq Mt op@omarpolo.com .