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

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)