summaryrefslogtreecommitdiffstats
path: root/docs/idevicepair.1
diff options
context:
space:
mode:
Diffstat (limited to 'docs/idevicepair.1')
-rw-r--r--docs/idevicepair.135
1 files changed, 32 insertions, 3 deletions
diff --git a/docs/idevicepair.1 b/docs/idevicepair.1
index 5c567ee..eb6e7d4 100644
--- a/docs/idevicepair.1
+++ b/docs/idevicepair.1
@@ -13,12 +13,21 @@ Manage host pairings with devices and usbmuxd.
.TP
.B \-u, \-\-udid UDID
target specific device by UDID.
-.TP
+.TP
+.B \-w, \-\-wireless
+perform wireless pairing (\f[B]see NOTE\f[]).
+.TP
+.B \-n, \-\-network
+connect to network device (\f[B]see NOTE\f[]).
+.TP
.B \-d, \-\-debug
enable communication debugging.
-.TP
+.TP
.B \-h, \-\-help
prints usage information.
+.TP
+.B \-v, \-\-version
+prints version information.
.SH COMMANDS
.TP
@@ -40,6 +49,24 @@ unpair device with this host.
.B list
list devices paired with this host.
+.SH NOTE
+Pairing over network (wireless pairing) is only supported by Apple TV
+devices. To perform a wireless pairing, you need to use the \f[B]\-w\f[]
+command line switch.
+
+Make sure to put the device into pairing mode first by opening
+Settings > Remotes and Devices > Remote App and Devices.
+
+The pairable device will become visible with a special UDID, and then you
+can run idevicepair like this:
+
+.B idevicepair -u fffc8:ab:cd:12:34:56fff -w pair
+
+idevicepair will then ask for the PIN that the device is displaying and
+continues with the pairing once entered.
+
+Please note that wireless pairing is currently not supported on Linux.
+
.SH AUTHORS
Nikias Bassen
@@ -48,4 +75,6 @@ Martin Szulecki
Julien Lavergne
.SH ON THE WEB
-http://libimobiledevice.org
+https://libimobiledevice.org
+
+https://github.com/libimobiledevice/libimobiledevice