usbmuxd(8)                                             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, con-
          tacts, 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 hap-
          pen 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 privi-
               leges).

          -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

     Page 1                       Plan 9             (printed 5/24/22)

     usbmuxd(8)                                             usbmuxd(8)

               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 Hec-
          tor 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

     Page 2                       Plan 9             (printed 5/24/22)