From bc9abb07b1a2a731b4b6ca89ef99ad86e2442e93 Mon Sep 17 00:00:00 2001 From: Ian Macalinao Date: Sun, 13 Dec 2015 09:43:45 -0600 Subject: Convert README to Markdown --- README | 99 ------------------------------------------------------------------ 1 file changed, 99 deletions(-) delete mode 100644 README (limited to 'README') diff --git a/README b/README deleted file mode 100644 index 7d96013..0000000 --- a/README +++ /dev/null @@ -1,99 +0,0 @@ -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.libimobiledevice.org/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 - -Twitter: - https://twitter.com/libimobiledev - -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: - 2015-01-28 -- cgit v1.1-32-gdbae