1 d188f690 2022-02-04 op .\" Copyright (c) 2022 Omar Polo <op@omarpolo.com>
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.
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.
15 86e6f0c9 2022-02-09 op .Dd February 9, 2022
16 d188f690 2022-02-04 op .Dt KAMIPROXY 1
20 d188f690 2022-02-04 op .Nd 9p over tls proxy
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
27 d188f690 2022-02-04 op .Op Fl K Ar key
28 d188f690 2022-02-04 op .Sh DESCRIPTION
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
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
42 d188f690 2022-02-04 op name on the specified
44 d188f690 2022-02-04 op .Pq 1337 by default.
46 d188f690 2022-02-04 op Do not daemonize.
47 d188f690 2022-02-04 op If this option is specified,
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
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.
60 d188f690 2022-02-04 op .Dq localhost .
62 d188f690 2022-02-04 op Produce more verbose output.
71 d188f690 2022-02-04 op program was written by
72 d188f690 2022-02-04 op .An Omar Polo Aq Mt op@omarpolo.com .
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.