1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
|
About
=====
A socket daemon to multiplex connections from and to iOS devices.
Background
==========
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.
Requirements
============
Development Packages of:
libimobiledevice
libplist
libusb
Software:
make
autoheader
automake
autoconf
libtool
pkg-config
gcc
udev (Linux only)
Optional:
systemd (Linux only)
Installation
============
To compile run:
./autogen.sh
make
sudo make install
The daemon is automatically started by udev or systemd depending on what you
have configured it on hotplug of an iOS device and exits if the last device
was unplugged.
For debugging purposes it is helpful to start usbmuxd using the foreground '-f'
argument and enable verbose mode '-v' to get suitable logs.
Who/What/Where?
===============
Home:
http://www.libimobiledevice.org/
Code:
git clone http://git.sukimashita.com/usbmuxd.git
Code (Mirror):
git clone https://github.com/libimobiledevice/usbmuxd.git
Tickets:
http://github.com/libimobiledevice/usbmuxd/issues
Mailing List:
http://lists.libimobiledevice.org/mailman/listinfo/libimobiledevice-devel
IRC:
irc://irc.freenode.net#libimobiledevice
Credits
=======
The first usbmuxd daemon implementation was authored by Hector Martin.
Apple, iPhone, iPod, and iPod Touch are trademarks of Apple Inc.
libimobiledevice is an independent software library and has not been
authorized, sponsored, or otherwise approved by Apple Inc.
README Updated on:
2014-10-02
|