Debian Codegraph @

docs/iproxy.1

raw
1 .TH "iproxy" 1
2 .SH NAME
3 iproxy \- A proxy that binds local TCP ports to be forwarded to the specified ports on a usbmux device
4 .SH SYNOPSIS
5 .B iproxy
6 [OPTIONS]
7 LOCAL_PORT:DEVICE_PORT [LOCAL_PORT2:DEVICE_PORT2 ...]
8 .SH DESCRIPTION
9 iproxy allows binding local TCP ports so that a connection to one (or more) of
10 the local ports will be forwarded to the specified port (or ports) on a usbmux
11 device.
12 .SH OPTIONS
13 .TP
14 .B \-u, \-\-udid UDID
15 Target specific device by UDID. Note that if this option is \f[I]not\f[] specified,
16 iproxy will make connection attempts to the first device found.
17 .TP
18 .B \-n, \-\-network
19 Connect to network device. The device needs to have WiFi sync enabled and
20 needs to be paired with this computer for this to work. Please note that
21 a device might close connections at any time to save power.
22 This option will make iproxy try to connect to network attched devices only,
23 unless \f[B]-l\f[] is passed too (see below).
24 .TP
25 .B \-l, \-\-local
26 Connect to USB device. This is the default if no option is passed. If used
27 together with \f[B]-n\f[], iproxy will first attempt a connection to a device
28 attached via USB, and if not available attempt to reach a device via network.
29 .TP
30 .B \-s, \-\-source ADDR
31 Allows setting a source address for the listening socket. The default is
32 127.0.0.1 (local connections only). While not needed in normal setups,
33 this option allows other than local connections, for example 0.0.0.0 would
34 make the TCP proxy port(s) accessible from other computers in the network.
35
36 \f[B]WARNING:\f[] Use with caution since this could expose a device over
37 the network!
38 .TP
39 .B \-h, \-\-help
40 Prints usage information.
41 .TP
42 .B \-d, \-\-debug
43 Increase debug level.
44 .SH EXAMPLES
45 .TP
46 .B iproxy 2222:44
47 Bind local TCP port 2222 and forward to port 44 of the first device connected via USB.
48 .TP
49 .B iproxy -u 3fac232fbdd684bdb1e3b65973922ae8b7db174a 2222:44
50 Bind local TCP port 2222 and forward to port 44 of the device with UDID
51 3fac232fbdd684bdb1e3b65973922ae8b7db174a connected via USB.
52 .TP
53 .B iproxy -n -u 3fac232fbdd684bdb1e3b65973922ae8b7db174a 2222:44 8080:8080
54 Bind local TCP ports 2222 and 8080 and forward to ports 44 and 8080 respectively
55 of the device with UDID 3fac232fbdd684bdb1e3b65973922ae8b7db174a connected via network.
56 .SH AUTHOR
57 Nikias Bassen
58 .SH SEE ALSO
59 inetcat(1)
60 .SH ON THE WEB
61 https://libimobiledevice.org
62
63 https://github.com/libimobiledevice/libusbmuxd