From f961e3589910a8c3d90752edeee1604fe1a1fb02 Mon Sep 17 00:00:00 2001 From: Martin Szulecki Date: Fri, 21 Nov 2014 15:15:17 +0100 Subject: docs: Use correct manual section (8) for manpage --- docs/Makefile.am | 2 +- docs/usbmuxd.1 | 80 -------------------------------------------------------- docs/usbmuxd.8 | 80 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 3 files changed, 81 insertions(+), 81 deletions(-) delete mode 100644 docs/usbmuxd.1 create mode 100644 docs/usbmuxd.8 diff --git a/docs/Makefile.am b/docs/Makefile.am index 12e0e57..70a61ca 100644 --- a/docs/Makefile.am +++ b/docs/Makefile.am @@ -1,3 +1,3 @@ -man_MANS = usbmuxd.1 +man_MANS = usbmuxd.8 EXTRA_DIST = $(man_MANS) diff --git a/docs/usbmuxd.1 b/docs/usbmuxd.1 deleted file mode 100644 index 00f0a5c..0000000 --- a/docs/usbmuxd.1 +++ /dev/null @@ -1,80 +0,0 @@ -.TH "usbmuxd" 1 -.SH NAME -usbmuxd \- Expose a socket to multiplex connections from and to iOS devices. -.SH SYNOPSIS -.B usbmuxd -[OPTIONS] - -.SH DESCRIPTION - -usbmuxd stands for "USB multiplexing daemon". This daemon is in charge of -multiplexing connections over USB to an iOS device. To users, it means -you can sync your music, contacts, photos, etc. over USB. To developers, it -means you can connect to any listening localhost socket on the device. usbmuxd -is not used for tethering data transfer which uses a dedicated USB interface as -a virtual network device. Multiple connections to different TCP ports can happen -in parallel. The higher-level layers are handled by libimobiledevice. - -When usbmuxd is running (normally started, or stopped as a result of "udev" -auto-insertion messages or by systemd) it provides a socket interface in -"/var/run/usbmuxd" that is designed to be compatible with the socket interface -that is provided on Mac OS X. - -You should also create a "usbmux" user that has access to USB devices on your -system. Alternatively, you can pass a different username using the -U argument. - -Due to iOS 7 the daemon now also manages pairing records with iOS devices and -the host in "/var/lib/lockdown" (Linux) or "/var/db/lockdown" (Mac OS X). -Ensure proper permissions are setup for the daemon to access the directory. - -.SH OPTIONS -.TP -.B \-U, \-\-user USER -Change to this user after startup (needs USB privileges). -.TP -.B \-f, \-\-foreground -Do not daemonize (implies one -v). -.TP -.B \-n, \-\-disable-hotplug -Disables automatic discovery of devices on hotplug. Starting another instance -will trigger discovery instead. -.TP -.B \-z, \-\-enable-exit -Enable "--exit" request from other instances and exit automatically if no -device is attached. -.TP -.B \-u, \-\-udev -Run in udev operation mode (implies -n and -z). -.TP -.B \-s, \-\-systemd -Run in systemd operation mode (implies -z and -f). -.TP -.B \-x, \-\-exit -Notify a running instance to exit if there are no devices connected (sends -SIGUSR1 to running instance) and exit. -.TP -.B \-X, \-\-force-exit -Notify a running instance to exit even if there are still devices connected -(always works) and exit. -.TP -.B \-v, \-\-verbose -be verbose (use twice or more to increase verbose level). -.TP -.B \-V, \-\-version -print version information and exit. -.TP -.B \-h, \-\-help -prints usage information. - -.SH AUTHOR -The first usbmuxd daemon implementation was authored by Hector Martin. - -Now mainly developed by Nikias Bassen, Martin Szulecki and contributors (see AUTHORS file). - -.SH SEE ALSO - -http://www.libimobiledevice.org - -http://github.com/libimobiledevice/usbmuxd/ - -idevice_id(1), iproxy(1). diff --git a/docs/usbmuxd.8 b/docs/usbmuxd.8 new file mode 100644 index 0000000..0a05f12 --- /dev/null +++ b/docs/usbmuxd.8 @@ -0,0 +1,80 @@ +.TH "usbmuxd" 8 +.SH NAME +usbmuxd \- Expose a socket to multiplex connections from and to iOS devices. +.SH SYNOPSIS +.B usbmuxd +[OPTIONS] + +.SH DESCRIPTION + +usbmuxd stands for "USB multiplexing daemon". This daemon is in charge of +multiplexing connections over USB to an iOS device. To users, it means +you can sync your music, contacts, photos, etc. over USB. To developers, it +means you can connect to any listening localhost socket on the device. usbmuxd +is not used for tethering data transfer which uses a dedicated USB interface as +a virtual network device. Multiple connections to different TCP ports can happen +in parallel. The higher-level layers are handled by libimobiledevice. + +When usbmuxd is running (normally started, or stopped as a result of "udev" +auto-insertion messages or by systemd) it provides a socket interface in +"/var/run/usbmuxd" that is designed to be compatible with the socket interface +that is provided on Mac OS X. + +You should also create a "usbmux" user that has access to USB devices on your +system. Alternatively, you can pass a different username using the -U argument. + +Due to iOS 7 the daemon now also manages pairing records with iOS devices and +the host in "/var/lib/lockdown" (Linux) or "/var/db/lockdown" (Mac OS X). +Ensure proper permissions are setup for the daemon to access the directory. + +.SH OPTIONS +.TP +.B \-U, \-\-user USER +Change to this user after startup (needs USB privileges). +.TP +.B \-f, \-\-foreground +Do not daemonize (implies one -v). +.TP +.B \-n, \-\-disable-hotplug +Disables automatic discovery of devices on hotplug. Starting another instance +will trigger discovery instead. +.TP +.B \-z, \-\-enable-exit +Enable "--exit" request from other instances and exit automatically if no +device is attached. +.TP +.B \-u, \-\-udev +Run in udev operation mode (implies -n and -z). +.TP +.B \-s, \-\-systemd +Run in systemd operation mode (implies -z and -f). +.TP +.B \-x, \-\-exit +Notify a running instance to exit if there are no devices connected (sends +SIGUSR1 to running instance) and exit. +.TP +.B \-X, \-\-force-exit +Notify a running instance to exit even if there are still devices connected +(always works) and exit. +.TP +.B \-v, \-\-verbose +be verbose (use twice or more to increase verbose level). +.TP +.B \-V, \-\-version +print version information and exit. +.TP +.B \-h, \-\-help +prints usage information. + +.SH AUTHOR +The first usbmuxd daemon implementation was authored by Hector Martin. + +Now mainly developed by Nikias Bassen, Martin Szulecki and contributors (see AUTHORS file). + +.SH SEE ALSO + +http://www.libimobiledevice.org + +http://github.com/libimobiledevice/usbmuxd/ + +idevice_id(1), iproxy(1). -- cgit v1.1-32-gdbae