STANNIX Solutions for the Real World


Manual: usbmuxd

usbmuxd(8)				   System Manager's Manual				  usbmuxd(8)

NAME
       usbmuxd - Expose a socket to multiplex connections from and to iOS devices.

SYNOPSIS
       usbmuxd [OPTIONS]

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 de‐
       vice. 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.

OPTIONS
       -U, --user USER
	      Change to this user after startup (needs USB privileges).

       -f, --foreground
	      Do not daemonize (implies one -v).

       -n, --disable-hotplug
	      Disables	automatic  discovery  of  devices on hotplug. Starting another instance will trigger
	      discovery instead.

       -z, --enable-exit
	      Enable "--exit" request from other instances and exit automatically if no device is attached.

       -u, --udev
	      Run in udev operation mode (implies -n and -z).

       -s, --systemd
	      Run in systemd operation mode (implies -z and -f).

       -x, --exit
	      Notify a running instance to exit if there are no devices connected (sends SIGUSR1 to  running
	      instance) and exit.

       -X, --force-exit
	      Notify a running instance to exit even if there are still devices connected (always works) and
	      exit.

       -v, --verbose
	      be verbose (use twice or more to increase verbose level).

       -V, --version
	      print version information and exit.

       -h, --help
	      prints usage information.

AUTHOR
       The first usbmuxd daemon implementation was authored by Hector Martin.

       Now mainly developed by Nikias Bassen, Martin Szulecki and contributors (see AUTHORS file).

SEE ALSO
       idevice_id(1), iproxy(1).

ON THE WEB
       https://libimobiledevice.org

       https://github.com/libimobiledevice/usbmuxd

												  usbmuxd(8)