README 2.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596
  1. About
  2. =====
  3. A socket daemon to multiplex connections from and to iOS devices.
  4. Background
  5. ==========
  6. usbmuxd stands for "USB multiplexing daemon". This daemon is in charge of
  7. multiplexing connections over USB to an iOS device. To users, it means
  8. you can sync your music, contacts, photos, etc. over USB. To developers, it
  9. means you can connect to any listening localhost socket on the device. usbmuxd
  10. is not used for tethering data transfer which uses a dedicated USB interface as
  11. a virtual network device. Multiple connections to different TCP ports can happen
  12. in parallel. The higher-level layers are handled by libimobiledevice.
  13. When usbmuxd is running (normally started, or stopped as a result of "udev"
  14. auto-insertion messages or by systemd) it provides a socket interface in
  15. "/var/run/usbmuxd" that is designed to be compatible with the socket interface
  16. that is provided on Mac OS X.
  17. You should also create a "usbmux" user that has access to USB devices on your
  18. system. Alternatively, you can pass a different username using the -U argument.
  19. Due to iOS 7 the daemon now also manages pairing records with iOS devices and
  20. the host in "/var/lib/lockdown" (Linux) or "/var/db/lockdown" (Mac OS X).
  21. Ensure proper permissions are setup for the daemon to access the directory.
  22. Requirements
  23. ============
  24. Development Packages of:
  25. libimobiledevice
  26. libplist
  27. libusb
  28. Software:
  29. make
  30. autoheader
  31. automake
  32. autoconf
  33. libtool
  34. pkg-config
  35. gcc
  36. udev (Linux only)
  37. Optional:
  38. systemd (Linux only)
  39. Installation
  40. ============
  41. To compile run:
  42. ./autogen.sh
  43. make
  44. sudo make install
  45. The daemon is automatically started by udev or systemd depending on what you
  46. have configured it on hotplug of an iOS device and exits if the last device
  47. was unplugged.
  48. For debugging purposes it is helpful to start usbmuxd using the foreground '-f'
  49. argument and enable verbose mode '-v' to get suitable logs.
  50. Who/What/Where?
  51. ===============
  52. Home:
  53. http://www.libimobiledevice.org/
  54. Code:
  55. git clone http://git.sukimashita.com/usbmuxd.git
  56. Code (Mirror):
  57. git clone https://github.com/libimobiledevice/usbmuxd.git
  58. Tickets:
  59. http://github.com/libimobiledevice/usbmuxd/issues
  60. Mailing List:
  61. http://lists.libimobiledevice.org/mailman/listinfo/libimobiledevice-devel
  62. IRC:
  63. irc://irc.freenode.net#libimobiledevice
  64. Credits
  65. =======
  66. The first usbmuxd daemon implementation was authored by Hector Martin.
  67. Apple, iPhone, iPod, and iPod Touch are trademarks of Apple Inc.
  68. libimobiledevice is an independent software library and has not been
  69. authorized, sponsored, or otherwise approved by Apple Inc.
  70. README Updated on:
  71. 2014-10-02