Blame


1 d8355ed6 2021-12-16 op .\" Copyright (c) 2021 Omar Polo <op@omarpolo.com>
2 d8355ed6 2021-12-16 op .\"
3 d8355ed6 2021-12-16 op .\" Permission to use, copy, modify, and distribute this software for any
4 d8355ed6 2021-12-16 op .\" purpose with or without fee is hereby granted, provided that the above
5 d8355ed6 2021-12-16 op .\" copyright notice and this permission notice appear in all copies.
6 d8355ed6 2021-12-16 op .\"
7 d8355ed6 2021-12-16 op .\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
8 d8355ed6 2021-12-16 op .\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
9 d8355ed6 2021-12-16 op .\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
10 d8355ed6 2021-12-16 op .\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
11 d8355ed6 2021-12-16 op .\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
12 d8355ed6 2021-12-16 op .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
13 d8355ed6 2021-12-16 op .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
14 d8355ed6 2021-12-16 op .\"
15 d8355ed6 2021-12-16 op .Dd $Mdocdate: December 16 2021 $
16 d8355ed6 2021-12-16 op .Dt KAMIREPL 1
17 d8355ed6 2021-12-16 op .Os
18 d8355ed6 2021-12-16 op .Sh NAME
19 d8355ed6 2021-12-16 op .Nm kamirepl
20 d8355ed6 2021-12-16 op .Nd 9p repl client
21 d8355ed6 2021-12-16 op .Sh SYNOPSIS
22 d8355ed6 2021-12-16 op .Nm
23 d8355ed6 2021-12-16 op .Op Fl chv
24 d8355ed6 2021-12-16 op .Op Fl C Ar cert
25 d8355ed6 2021-12-16 op .Op Fl H Ar host
26 d8355ed6 2021-12-16 op .Op Fl K Ar key
27 d8355ed6 2021-12-16 op .Op Fl P Ar port
28 d8355ed6 2021-12-16 op .Sh DESCRIPTION
29 d8355ed6 2021-12-16 op .Nm
30 d8355ed6 2021-12-16 op is a
31 d8355ed6 2021-12-16 op .Xr 9p 7
32 d8355ed6 2021-12-16 op repl client.
33 d8355ed6 2021-12-16 op .Pp
34 d8355ed6 2021-12-16 op The optinos are as follows:
35 d8355ed6 2021-12-16 op .Bl -tag -width tenletters
36 d8355ed6 2021-12-16 op .It Fl C Ar cert
37 d8355ed6 2021-12-16 op Path to the TLS client certificate to use.
38 d8355ed6 2021-12-16 op .It Fl c
39 d8355ed6 2021-12-16 op Use TLS for the connection.
40 d8355ed6 2021-12-16 op .Fl C
41 d8355ed6 2021-12-16 op and
42 d8355ed6 2021-12-16 op .Fl K
43 d8355ed6 2021-12-16 op are mandatory if used.
44 d8355ed6 2021-12-16 op .It Fl H Ar host
45 d8355ed6 2021-12-16 op Hostname of the file server.
46 d8355ed6 2021-12-16 op .It Fl h
47 d8355ed6 2021-12-16 op Display usage and exit.
48 d8355ed6 2021-12-16 op .It Fl K Ar key
49 d8355ed6 2021-12-16 op Path to the TLS client certificate private key.
50 d8355ed6 2021-12-16 op .It Fl P Ar port
51 d8355ed6 2021-12-16 op Port number to connect to.
52 d8355ed6 2021-12-16 op .It Fl v
53 d8355ed6 2021-12-16 op Verbose logging.
54 d8355ed6 2021-12-16 op .El
55 d8355ed6 2021-12-16 op .Pp
56 d8355ed6 2021-12-16 op The interactive commands are
57 d8355ed6 2021-12-16 op .Bl -tag -width Ds
58 d8355ed6 2021-12-16 op .It Ic version Op Ar version-string
59 d8355ed6 2021-12-16 op .Ar version-string
60 d8355ed6 2021-12-16 op is
61 d8355ed6 2021-12-16 op .Dq 9P2000
62 d8355ed6 2021-12-16 op by default.
63 d8355ed6 2021-12-16 op .It Ic attach Ar fid Ar uname Ar aname
64 d8355ed6 2021-12-16 op Request the file server to attach the file tree identified by
65 d8355ed6 2021-12-16 op .Ar aname
66 d8355ed6 2021-12-16 op to the specified
67 d8355ed6 2021-12-16 op .Ar fid
68 d8355ed6 2021-12-16 op number.
69 d8355ed6 2021-12-16 op .Ar aname
70 d8355ed6 2021-12-16 op is the identifier for the user.
71 d8355ed6 2021-12-16 op The afid used is implicitly NOFID.
72 d8355ed6 2021-12-16 op .It Ic clunk Ar fid
73 d8355ed6 2021-12-16 op Closes
74 d8355ed6 2021-12-16 op .Ar fid.
75 d8355ed6 2021-12-16 op .It Ic flush Ar oldtag
76 d8355ed6 2021-12-16 op Require the server to flush
77 d8355ed6 2021-12-16 op .Ar oldtag .
78 d8355ed6 2021-12-16 op .It Ic walk Ar fid Ar newfid Ar wnames...
79 d8355ed6 2021-12-16 op Do a walk from
80 d8355ed6 2021-12-16 op .Ar fid
81 d8355ed6 2021-12-16 op following
82 d8355ed6 2021-12-16 op .Ar wnames
83 d8355ed6 2021-12-16 op component and associating the reached file to
84 d8355ed6 2021-12-16 op .Ar newfid .
85 d8355ed6 2021-12-16 op .It Ic open Ar fid Ar mode Op Ar flag
86 d8355ed6 2021-12-16 op Prepare
87 d8355ed6 2021-12-16 op .Ar fid
88 d8355ed6 2021-12-16 op for I/O.
89 d8355ed6 2021-12-16 op .Ar mode
90 d8355ed6 2021-12-16 op can be one of
91 d8355ed6 2021-12-16 op .Sq read
92 d8355ed6 2021-12-16 op or
93 d8355ed6 2021-12-16 op .Sq r ,
94 d8355ed6 2021-12-16 op .Sq write
95 d8355ed6 2021-12-16 op or
96 d8355ed6 2021-12-16 op .Sq w ,
97 d8355ed6 2021-12-16 op .Sq readwrite
98 d8355ed6 2021-12-16 op or
99 d8355ed6 2021-12-16 op .Sq rdwr .
100 d8355ed6 2021-12-16 op Optionally,
101 d8355ed6 2021-12-16 op .Ar flag
102 d8355ed6 2021-12-16 op can be on of
103 d8355ed6 2021-12-16 op .Sq trunc
104 d8355ed6 2021-12-16 op to truncate the file or
105 d8355ed6 2021-12-16 op .Sq rclose
106 d8355ed6 2021-12-16 op to remove the file upon
107 d8355ed6 2021-12-16 op .Ic clunk .
108 c7f145d4 2021-12-20 op .It Ic create Ar fid Ar name Ar perm Ar mode
109 c7f145d4 2021-12-20 op Create the file
110 c7f145d4 2021-12-20 op .Ar name
111 c7f145d4 2021-12-20 op and open it with
112 c7f145d4 2021-12-20 op .Ar mode
113 c7f145d4 2021-12-20 op as the given
114 c7f145d4 2021-12-20 op .Ar fid.
115 c7f145d4 2021-12-20 op .Ar perm
116 c7f145d4 2021-12-20 op should be used to select the permissions of the file, but is currently
117 c7f145d4 2021-12-20 op unused.
118 d8355ed6 2021-12-16 op .It Ic read Ar fid Ar offset Ar count
119 d8355ed6 2021-12-16 op Issue a read request for the given
120 d8355ed6 2021-12-16 op .Ar fid ,
121 d8355ed6 2021-12-16 op which must have been prepared for I/O with
122 d8355ed6 2021-12-16 op .Ic open ,
123 d8355ed6 2021-12-16 op at
124 d8355ed6 2021-12-16 op .Ar offset
125 d8355ed6 2021-12-16 op and for
126 d8355ed6 2021-12-16 op .Ar count
127 d8355ed6 2021-12-16 op bytes.
128 c7f145d4 2021-12-20 op .It Ic write Ar fid Ar offset Ar content
129 c7f145d4 2021-12-20 op Writes
130 c7f145d4 2021-12-20 op .Ar content
131 c7f145d4 2021-12-20 op to
132 c7f145d4 2021-12-20 op .Ar fid
133 c7f145d4 2021-12-20 op starting at
134 c7f145d4 2021-12-20 op .Ar offset .
135 c7f145d4 2021-12-20 op .It Ic remove Ar fid
136 c7f145d4 2021-12-20 op Delete the file identified by
137 c7f145d4 2021-12-20 op .Ar fid
138 c7f145d4 2021-12-20 op and close it.
139 c7f145d4 2021-12-20 op Even in case of error,
140 c7f145d4 2021-12-20 op .Ar fid
141 c7f145d4 2021-12-20 op is clunked.
142 d8355ed6 2021-12-16 op .El
143 d8355ed6 2021-12-16 op .Sh SEE ALSO
144 d8355ed6 2021-12-16 op .Xr kamiftp 1
145 d8355ed6 2021-12-16 op .Xr 9p 7
146 d8355ed6 2021-12-16 op .Xr kamid 8
147 d8355ed6 2021-12-16 op .Sh AUTHORS
148 d8355ed6 2021-12-16 op .An -nosplit
149 d8355ed6 2021-12-16 op The
150 d8355ed6 2021-12-16 op .Nm
151 d8355ed6 2021-12-16 op utility was written by
152 d8355ed6 2021-12-16 op .An Omar Polo Aq Mt op@omarpolo.com .