| 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 |