man-pages/man8/usbmuxd.8.html
2021-03-31 01:06:50 +01:00

133 lines
4.0 KiB
HTML
Raw Permalink Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML><HEAD><TITLE>Man page of usbmuxd</TITLE>
</HEAD><BODY>
<H1>usbmuxd</H1>
Section: Maintenance Commands (8)<BR><A HREF="#index">Index</A>
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
<A NAME="lbAB">&nbsp;</A>
<H2>NAME</H2>
usbmuxd - Expose a socket to multiplex connections from and to iOS devices.
<A NAME="lbAC">&nbsp;</A>
<H2>SYNOPSIS</H2>
<B>usbmuxd</B>
[OPTIONS]
<P>
<A NAME="lbAD">&nbsp;</A>
<H2>DESCRIPTION</H2>
<P>
usbmuxd stands for &quot;USB multiplexing daemon&quot;. 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.
<P>
When usbmuxd is running (normally started, or stopped as a result of &quot;udev&quot;
auto-insertion messages or by systemd) it provides a socket interface in
&quot;/var/run/usbmuxd&quot; that is designed to be compatible with the socket interface
that is provided on Mac OS X.
<P>
You should also create a &quot;usbmux&quot; user that has access to USB devices on your
system. Alternatively, you can pass a different username using the -U argument.
<P>
Due to iOS 7 the daemon now also manages pairing records with iOS devices and
the host in &quot;/var/lib/lockdown&quot; (Linux) or &quot;/var/db/lockdown&quot; (Mac OS X).
Ensure proper permissions are setup for the daemon to access the directory.
<P>
<A NAME="lbAE">&nbsp;</A>
<H2>OPTIONS</H2>
<DL COMPACT>
<DT id="1"><B>-U, --user USER</B>
<DD>
Change to this user after startup (needs USB privileges).
<DT id="2"><B>-f, --foreground</B>
<DD>
Do not daemonize (implies one -v).
<DT id="3"><B>-n, --disable-hotplug</B>
<DD>
Disables automatic discovery of devices on hotplug. Starting another instance
will trigger discovery instead.
<DT id="4"><B>-z, --enable-exit</B>
<DD>
Enable &quot;--exit&quot; request from other instances and exit automatically if no
device is attached.
<DT id="5"><B>-u, --udev</B>
<DD>
Run in udev operation mode (implies -n and -z).
<DT id="6"><B>-s, --systemd</B>
<DD>
Run in systemd operation mode (implies -z and -f).
<DT id="7"><B>-x, --exit</B>
<DD>
Notify a running instance to exit if there are no devices connected (sends
SIGUSR1 to running instance) and exit.
<DT id="8"><B>-X, --force-exit</B>
<DD>
Notify a running instance to exit even if there are still devices connected
(always works) and exit.
<DT id="9"><B>-v, --verbose</B>
<DD>
be verbose (use twice or more to increase verbose level).
<DT id="10"><B>-V, --version</B>
<DD>
print version information and exit.
<DT id="11"><B>-h, --help</B>
<DD>
prints usage information.
<P>
</DL>
<A NAME="lbAF">&nbsp;</A>
<H2>AUTHOR</H2>
The first usbmuxd daemon implementation was authored by Hector Martin.
<P>
Now mainly developed by Nikias Bassen, Martin Szulecki and contributors (see AUTHORS file).
<P>
<A NAME="lbAG">&nbsp;</A>
<H2>SEE ALSO</H2>
<P>
<A HREF="http://www.libimobiledevice.org">http://www.libimobiledevice.org</A>
<P>
<A HREF="http://github.com/libimobiledevice/usbmuxd/">http://github.com/libimobiledevice/usbmuxd/</A>
<P>
<A HREF="/cgi-bin/man/man2html?1+idevice_id">idevice_id</A>(1), <A HREF="/cgi-bin/man/man2html?1+iproxy">iproxy</A>(1).
<P>
<HR>
<A NAME="index">&nbsp;</A><H2>Index</H2>
<DL>
<DT id="12"><A HREF="#lbAB">NAME</A><DD>
<DT id="13"><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT id="14"><A HREF="#lbAD">DESCRIPTION</A><DD>
<DT id="15"><A HREF="#lbAE">OPTIONS</A><DD>
<DT id="16"><A HREF="#lbAF">AUTHOR</A><DD>
<DT id="17"><A HREF="#lbAG">SEE ALSO</A><DD>
</DL>
<HR>
This document was created by
<A HREF="/cgi-bin/man/man2html">man2html</A>,
using the manual pages.<BR>
Time: 00:06:18 GMT, March 31, 2021
</BODY>
</HTML>