127 lines
4.9 KiB
HTML
127 lines
4.9 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of IPPUSBXD</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>IPPUSBXD</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"> </A>
|
|
<H2>NAME</H2>
|
|
|
|
ippusbxd - Communication driver for IPP-over-USB class printers
|
|
<A NAME="lbAC"> </A>
|
|
<H2>SYNOPSIS</H2>
|
|
|
|
<B>ippusbxd</B>
|
|
|
|
[<B>-v</B>|<B>--vid </B> <I>VENDOR_ID</I>]
|
|
[<B>-m</B>|<B>--pid </B> <I>PRODUCT_ID</I>]
|
|
[<B>-s</B>|<B>--serial </B> <I>SERIAL_NUMBER</I>]
|
|
[<B>--bus </B> <I>BUS</I>]
|
|
[<B>--device </B> <I>DEVICE</I>]
|
|
[<B>--bus-device </B> <I>BUS</I><B>:</B><I>DEVICE</I>]
|
|
[<B>-p</B>|<B>--only-port </B> <I>PORT_NUMBER</I>]
|
|
[<B>-P</B>|<B>--from-port </B> <I>PORT_NUMBER</I>]
|
|
[<B>-i</B>|<B>--interface </B> <I>INTERFACE</I>]
|
|
[<B>-l</B>|<B>--logging</B>]
|
|
[<B>-q</B>|<B>--verbose</B>]
|
|
[<B>-d</B>|<B>--debug</B>]
|
|
[<B>-n</B>|<B>--no-fork</B>]
|
|
[<B>-B</B>|<B>--no-broadcast</B>]
|
|
[<B>-N</B>|<B>--no-printer</B>]
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
<B>ippusbxd</B>
|
|
|
|
connects to a IPP-over-USB printer and exposes it to a network interface (like localhost or dummy0) on a given port, so that the printer can be accessed like an IPP network printer. The printer is also registered at Avahi to be advertised via DNS-SD on the interface, so <B>CUPS</B> and <B><A HREF="/cgi-bin/man/man2html?8+cups-browsed">cups-browsed</A>(8)</B> will auto-discover the printer for easy setup of a print queue. This requires avahi-daemon to be running and the network interface to be supported by the Avahi version in use.
|
|
<P>
|
|
Upon successful startup the TCP port it is listening on and the process ID of the daemon are printed to stdout. <B>ippusbxd</B> will shut itself down when the connected printer disconnects. When not specifying information about the desired printer, <B>ippusbxd</B> scans the USB and connects to the first available IPP-over-USB printer.
|
|
<A NAME="lbAE"> </A>
|
|
<H2>OPTIONS</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="1"><B>-h</B>, <B>--help</B>
|
|
|
|
<DD>
|
|
Show help message.
|
|
<DT id="2"><B>-v</B> <I>VENDOR_ID</I>, <B>--vid</B> <I>VENDOR_ID</I>
|
|
|
|
<DD>
|
|
USB vendor ID of desired printer.
|
|
<DT id="3"><B>-m</B> <I>PRODUCT_ID</I>, <B>--pid</B> <I>PRODUCT_ID</I>
|
|
|
|
<DD>
|
|
USB product ID of desired printer.
|
|
<DT id="4"><B>-s</B> <I>SERIAL_NUMBER</I>, <B>--serial</B> <I>SERIAL_NUMBER</I>
|
|
|
|
<DD>
|
|
Serial number of desired printer.
|
|
<DT id="5"><B>--bus</B> <I>BUS</I> <B>--device</B> <I>DEVICE</I>, <B>--bus-device</B> <I>BUS</I><B>:</B><I>DEVICE</I>
|
|
|
|
<DD>
|
|
USB bus and device numbers where the device is currently connected (see output of <B><A HREF="/cgi-bin/man/man2html?8+lsusb">lsusb</A>(8)</B>). Note that these numbers change when the device is disconnected and reconnected. This method of calling <B>ippusbxd</B> is only for calling via UDEV. <I>BUS</I> and <I>DEVICE</I> have to be given in decimal numbers.
|
|
<DT id="6"><B>-p</B> <I>PORT_NUMBER</I>, <B>--only-port</B> <I>PORT_NUMBER</I>
|
|
|
|
<DD>
|
|
Port number <B>ippusbxd</B> will expose the printer over. If this port is already taken, <B>ippusbxd</B> will error out.
|
|
<DT id="7"><B>-P</B> <I>PORT_NUMBER</I>, <B>--from-port</B> <I>PORT_NUMBER</I>
|
|
|
|
<DD>
|
|
Port number <B>ippusbxd</B> will expose the printer over. If this port is already taken, <B>ippusbxd</B> will increase the port number by 1 and try again until it finds a free port.
|
|
<DT id="8"><B>-i</B> <I>INTERFACE</I>, <B>--interface</B> <I>INTERFACE</I>
|
|
|
|
<DD>
|
|
Network interface to use. Default is the loopback interface (lo, localhost).
|
|
<DT id="9"><B>-l</B>, <B>--logging</B>
|
|
|
|
<DD>
|
|
Send all logging to syslog.
|
|
<DT id="10"><B>-q</B>, <B>--verbose</B>
|
|
|
|
<DD>
|
|
Enable verbose logging.
|
|
<DT id="11"><B>-d</B>, <B>--debug</B>
|
|
|
|
<DD>
|
|
Enables debug mode.
|
|
Implies -q and -n.
|
|
Verbose logging will be sent to stdout
|
|
<DT id="12"><B>-n</B>, <B>--no-fork</B>
|
|
|
|
<DD>
|
|
Enables no fork mode.
|
|
Disables deamonization.
|
|
<DT id="13"><B>-B</B>, <B>--no-broadcast</B>
|
|
|
|
<DD>
|
|
No-broadcast mode, do not DNS-SD-broadcast
|
|
<DT id="14"><B>-N</B>, <B>--no-printer</B>
|
|
|
|
<DD>
|
|
No-printer mode, debug/developer mode which makes <B>ippusbxd</B> run without IPP-over-USB printer
|
|
</DL>
|
|
<A NAME="lbAF"> </A>
|
|
<H2>BUGS</H2>
|
|
|
|
<B>ippusbxd</B> does not detect whether a USB printer is already connected by another instance of <B>ippusbxd</B>, so the system/the user has to take care to not start <B>ippusbxd</B> more than once for one and the same printer. Especially one should never start <B>ippusbxd</B> repeatedly without specifying a printer to assure that all connected IPP-over-USB printers get their <B>ippusbxd</B> instance.
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="15"><A HREF="#lbAB">NAME</A><DD>
|
|
<DT id="16"><A HREF="#lbAC">SYNOPSIS</A><DD>
|
|
<DT id="17"><A HREF="#lbAD">DESCRIPTION</A><DD>
|
|
<DT id="18"><A HREF="#lbAE">OPTIONS</A><DD>
|
|
<DT id="19"><A HREF="#lbAF">BUGS</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:13 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|