1usbmuxd(8)                  System Manager's Manual                 usbmuxd(8)
2
3
4

NAME

6       usbmuxd  -  Expose  a  socket  to multiplex connections from and to iOS
7       devices.
8

SYNOPSIS

10       usbmuxd [OPTIONS]
11
12

DESCRIPTION

14       usbmuxd stands for "USB multiplexing daemon". This daemon is in  charge
15       of  multiplexing  connections  over  USB to an iOS device. To users, it
16       means you can sync your music, contacts,  photos,  etc.  over  USB.  To
17       developers,  it means you can connect to any listening localhost socket
18       on the device. usbmuxd is not used for tethering  data  transfer  which
19       uses  a  dedicated  USB interface as a virtual network device. Multiple
20       connections to different TCP ports can happen in parallel. The  higher-
21       level layers are handled by libimobiledevice.
22
23       When  usbmuxd  is  running (normally started, or stopped as a result of
24       "udev" auto-insertion messages or by  systemd)  it  provides  a  socket
25       interface  in "/var/run/usbmuxd" that is designed to be compatible with
26       the socket interface that is provided on Mac OS X.
27
28       You should also create a "usbmux" user that has access to  USB  devices
29       on  your system. Alternatively, you can pass a different username using
30       the -U argument.
31
32       Due to iOS 7 the daemon now  also  manages  pairing  records  with  iOS
33       devices  and  the host in "/var/lib/lockdown" (Linux) or "/var/db/lock‐
34       down" (Mac OS X).  Ensure proper permissions are setup for  the  daemon
35       to access the directory.
36
37

OPTIONS

39       -U, --user USER
40              Change to this user after startup (needs USB privileges).
41
42       -f, --foreground
43              Do not daemonize (implies one -v).
44
45       -n, --disable-hotplug
46              Disables  automatic  discovery  of  devices on hotplug. Starting
47              another instance will trigger discovery instead.
48
49       -z, --enable-exit
50              Enable "--exit" request from other instances and exit  automati‐
51              cally if no device is attached.
52
53       -u, --udev
54              Run in udev operation mode (implies -n and -z).
55
56       -s, --systemd
57              Run in systemd operation mode (implies -z and -f).
58
59       -x, --exit
60              Notify  a  running instance to exit if there are no devices con‐
61              nected (sends SIGUSR1 to running instance) and exit.
62
63       -X, --force-exit
64              Notify a running instance  to  exit  even  if  there  are  still
65              devices connected (always works) and exit.
66
67       -v, --verbose
68              be verbose (use twice or more to increase verbose level).
69
70       -V, --version
71              print version information and exit.
72
73       -h, --help
74              prints usage information.
75
76

AUTHOR

78       The first usbmuxd daemon implementation was authored by Hector Martin.
79
80       Now mainly developed by Nikias Bassen, Martin Szulecki and contributors
81       (see AUTHORS file).
82
83

SEE ALSO

85       idevice_id(1), iproxy(1).
86
87

ON THE WEB

89       https://libimobiledevice.org
90
91       https://github.com/libimobiledevice/usbmuxd
92
93
94
95                                                                    usbmuxd(8)