From cdc9f26f0375d54143a7aa6a4df56a04db105132 Mon Sep 17 00:00:00 2001 From: Nikias Bassen Date: Sun, 31 May 2020 15:41:51 +0200 Subject: Add man pages for iproxy and inetcat --- Makefile.am | 2 +- configure.ac | 1 + docs/Makefile.am | 3 +++ docs/inetcat.1 | 54 ++++++++++++++++++++++++++++++++++++++++++++++++ docs/iproxy.1 | 63 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 5 files changed, 122 insertions(+), 1 deletion(-) create mode 100644 docs/Makefile.am create mode 100644 docs/inetcat.1 create mode 100644 docs/iproxy.1 diff --git a/Makefile.am b/Makefile.am index 26188a5..ac45873 100644 --- a/Makefile.am +++ b/Makefile.am @@ -1,6 +1,6 @@ AUTOMAKE_OPTIONS = foreign ACLOCAL_AMFLAGS = -I m4 -SUBDIRS = common src include tools +SUBDIRS = common src include tools docs pkgconfigdir = $(libdir)/pkgconfig pkgconfig_DATA = libusbmuxd.pc diff --git a/configure.ac b/configure.ac index ce80929..acd6cba 100644 --- a/configure.ac +++ b/configure.ac @@ -126,6 +126,7 @@ common/Makefile src/Makefile include/Makefile tools/Makefile +docs/Makefile libusbmuxd.pc ]) diff --git a/docs/Makefile.am b/docs/Makefile.am new file mode 100644 index 0000000..3e8ba03 --- /dev/null +++ b/docs/Makefile.am @@ -0,0 +1,3 @@ +man_MANS = iproxy.1 inetcat.1 + +EXTRA_DIST = $(man_MANS) diff --git a/docs/inetcat.1 b/docs/inetcat.1 new file mode 100644 index 0000000..f9bb2c0 --- /dev/null +++ b/docs/inetcat.1 @@ -0,0 +1,54 @@ +.TH "inetcat" 1 +.SH NAME +inetcat \- Opens a read/write interface via STDIN/STDOUT to a TCP port on a usbmux device +.SH SYNOPSIS +.B inetcat +[OPTIONS] + +.SH DESCRIPTION +inetcat is a simple netcat-like tool that allows opening a read/write +interface to a TCP port on a usbmux device and exposing it via STDIN/STDOUT. +.SH OPTIONS +.TP +.B \-u, \-\-udid UDID +Target specific device by UDID. Note that if this option is \f[I]not\f[] specified, +inetcat will connect to the first device found. +.TP +.B \-n, \-\-network +Connect to network device. The device needs to have WiFi sync enabled and +needs to be paired with this computer for this to work. Please note that +a device might close connections at any time to save power. +This option will make inetcat connect to network attched devices only, +unless \f[B]-l\f[] is passed too (see below). +.TP +.B \-l, \-\-local +Connect to USB device. This is the default if no option is passed. If used +together with \f[B]-n\f[], inetcat will first attempt a connection to a device +attached via USB, and if not available attempt to reach a device via network. +.TP +.B \-h, \-\-help +Prints usage information. +.TP +.B \-d, \-\-debug +Increase debug level. +.SH EXAMPLE +Use ssh ProxyCommand to connect to a jailbroken iOS device via SSH: + +$ ssh -oProxyCommand="inetcat 22" root@localhost + +Used in SSH config file to connect to iOS Device: + +$ cat ~/.ssh/config +Host myiphone + User root + ProxyCommand "icat 22 UDID_of_my_iphone" +$ ssh myiphone + +.SH AUTHOR +Adrien Guinet +.SH SEE ALSO +iproxy(1) +.SH ON THE WEB +https://github.com/libimobiledevice/libusbmuxd + +https://libimobiledevice.org diff --git a/docs/iproxy.1 b/docs/iproxy.1 new file mode 100644 index 0000000..f7810b0 --- /dev/null +++ b/docs/iproxy.1 @@ -0,0 +1,63 @@ +.TH "iproxy" 1 +.SH NAME +iproxy \- A proxy that binds local TCP ports to be forwarded to the specified ports on a usbmux device +.SH SYNOPSIS +.B iproxy +[OPTIONS] +LOCAL_PORT:DEVICE_PORT [LOCAL_PORT2:DEVICE_PORT2 ...] +.SH DESCRIPTION +iproxy allows binding local TCP ports so that a connection to one (or more) of +the local ports will be forwarded to the specified port (or ports) on a usbmux +device. +.SH OPTIONS +.TP +.B \-u, \-\-udid UDID +Target specific device by UDID. Note that if this option is \f[I]not\f[] specified, +iproxy will make connection attempts to the first device found. +.TP +.B \-n, \-\-network +Connect to network device. The device needs to have WiFi sync enabled and +needs to be paired with this computer for this to work. Please note that +a device might close connections at any time to save power. +This option will make iproxy try to connect to network attched devices only, +unless \f[B]-l\f[] is passed too (see below). +.TP +.B \-l, \-\-local +Connect to USB device. This is the default if no option is passed. If used +together with \f[B]-n\f[], iproxy will first attempt a connection to a device +attached via USB, and if not available attempt to reach a device via network. +.TP +.B \-s, \-\-source ADDR +Allows setting a source address for the listening socket. The default is +127.0.0.1 (local connections only). While not needed in normal setups, +this option allows other than local connections, for example 0.0.0.0 would +make the TCP proxy port(s) accessible from other computers in the network. + +\f[B]WARNING:\f[] Use with caution since this could expose a device over +the network! +.TP +.B \-h, \-\-help +Prints usage information. +.TP +.B \-d, \-\-debug +Increase debug level. +.SH EXAMPLES +.TP +.B iproxy 2222:44 +Bind local TCP port 2222 and forward to port 44 of the first device connected via USB. +.TP +.B iproxy -u 3fac232fbdd684bdb1e3b65973922ae8b7db174a 2222:44 +Bind local TCP port 2222 and forward to port 44 of the device with UDID +3fac232fbdd684bdb1e3b65973922ae8b7db174a connected via USB. +.TP +.B iproxy -n -u 3fac232fbdd684bdb1e3b65973922ae8b7db174a 2222:44 8080:8080 +Bind local TCP ports 2222 and 8080 and forward to ports 44 and 8080 respectively +of the device with UDID 3fac232fbdd684bdb1e3b65973922ae8b7db174a connected via network. +.SH AUTHOR +Nikias Bassen +.SH SEE ALSO +inetcat(1) +.SH ON THE WEB +https://github.com/libimobiledevice/libusbmuxd + +https://libimobiledevice.org -- cgit v1.1-32-gdbae