1 d188f690 2022-02-04 op .\" Copyright (c) 2022 Omar Polo <op@omarpolo.com>
 2 d188f690 2022-02-04 op .\"
 3 d188f690 2022-02-04 op .\" Permission to use, copy, modify, and distribute this software for any
 4 d188f690 2022-02-04 op .\" purpose with or without fee is hereby granted, provided that the above
 5 d188f690 2022-02-04 op .\" copyright notice and this permission notice appear in all copies.
 6 d188f690 2022-02-04 op .\"
 7 d188f690 2022-02-04 op .\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
 8 d188f690 2022-02-04 op .\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
 9 d188f690 2022-02-04 op .\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
10 d188f690 2022-02-04 op .\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
11 d188f690 2022-02-04 op .\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
12 d188f690 2022-02-04 op .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
13 d188f690 2022-02-04 op .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
14 d188f690 2022-02-04 op .\"
15 86e6f0c9 2022-02-09 op .Dd February 9, 2022
16 d188f690 2022-02-04 op .Dt KAMIPROXY 1
17 d188f690 2022-02-04 op .Os
18 d188f690 2022-02-04 op .Sh NAME
19 d188f690 2022-02-04 op .Nm kamiproxy
20 d188f690 2022-02-04 op .Nd 9p over tls proxy
21 d188f690 2022-02-04 op .Sh SYNOPSIS
22 d188f690 2022-02-04 op .Nm
23 d188f690 2022-02-04 op .Op Fl dv
24 d188f690 2022-02-04 op .Fl c Ar host Ns Oo : Ns Ar port Oc
25 d188f690 2022-02-04 op .Fl l Oo Ar host : Oc Ns port
26 d188f690 2022-02-04 op .Fl C Ar cert
27 d188f690 2022-02-04 op .Op Fl K Ar key
28 d188f690 2022-02-04 op .Sh DESCRIPTION
29 d188f690 2022-02-04 op .Nm
30 d188f690 2022-02-04 op is a proxy for 9p over tls.
31 d188f690 2022-02-04 op It listen on a local port for plaintext 9p connections and forwards
32 d188f690 2022-02-04 op them to a real server using a TLS-encrypted tunnel and a client
33 d188f690 2022-02-04 op certificate.
34 d188f690 2022-02-04 op .Pp
35 d188f690 2022-02-04 op The options are as follows:
36 d188f690 2022-02-04 op .Bl -tag -width Ds
37 d188f690 2022-02-04 op .It Fl C Ar cert
38 d188f690 2022-02-04 op Path to the client certificate to use.
39 d188f690 2022-02-04 op .It Fl c Ar host Ns Oo : Ns Ar port Oc
40 d188f690 2022-02-04 op Connect to the remote server identified by the given
41 d188f690 2022-02-04 op .Ar host
42 d188f690 2022-02-04 op name on the specified
43 d188f690 2022-02-04 op .Ar port
44 d188f690 2022-02-04 op .Pq 1337 by default.
45 d188f690 2022-02-04 op .It Fl d
46 d188f690 2022-02-04 op Do not daemonize.
47 d188f690 2022-02-04 op If this option is specified,
48 d188f690 2022-02-04 op .Nm
49 d188f690 2022-02-04 op will run in the foreground and log to standard error.
50 d188f690 2022-02-04 op .It Fl K Ar key
51 d188f690 2022-02-04 op Path to the key of the client certificate.
52 d188f690 2022-02-04 op If not provided, it's assumed to be the same as the
53 d188f690 2022-02-04 op .Fl C
54 d188f690 2022-02-04 op flag.
55 d188f690 2022-02-04 op .It Fl l Oo Ar host : Oc Ns port
56 d188f690 2022-02-04 op Listen on the specified address.
57 d188f690 2022-02-04 op The
58 d188f690 2022-02-04 op .Ar host
59 d188f690 2022-02-04 op by default is
60 d188f690 2022-02-04 op .Dq localhost .
61 d188f690 2022-02-04 op .It Fl v
62 d188f690 2022-02-04 op Produce more verbose output.
63 d188f690 2022-02-04 op .El
64 d188f690 2022-02-04 op .Sh SEE ALSO
65 d188f690 2022-02-04 op .Xr 9p 7 ,
66 d188f690 2022-02-04 op .Xr kamid 8
67 d188f690 2022-02-04 op .Sh AUTHORS
68 d188f690 2022-02-04 op .An -nosplit
69 d188f690 2022-02-04 op The
70 d188f690 2022-02-04 op .Nm
71 d188f690 2022-02-04 op program was written by
72 d188f690 2022-02-04 op .An Omar Polo Aq Mt op@omarpolo.com .
73 86e6f0c9 2022-02-09 op .Sh CAVEATS
74 d188f690 2022-02-04 op .Nm
75 d188f690 2022-02-04 op opens one TLS-encrypted connection for each incoming connection.
76 d188f690 2022-02-04 op A better approach would be to multiplex the traffic to the remote
77 d188f690 2022-02-04 op server, akin to what the plan9 kernel does by default.