bionic (8) ippusbxd.8.gz

Provided by: ippusbxd_1.32-2_amd64 bug

NAME

       ippusbxd - Communication driver for IPP-over-USB class printers

SYNOPSIS

       ippusbxd [-v|--vid  VENDOR_ID] [-m|--pid  PRODUCT_ID] [-s|--serial  SERIAL_NUMBER] [--bus  BUS] [--device
       DEVICE]  [--bus-device    BUS:DEVICE]   [-p|--only-port    PORT_NUMBER]   [-P|--from-port    PORT_NUMBER]
       [-i|--interface  INTERFACE] [-l|--logging] [-q|--verbose] [-d|--debug] [-n|--no-fork] [-B|--no-broadcast]
       [-N|--no-printer]

DESCRIPTION

       ippusbxd 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 CUPS and  cups-browsed(8)  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.

       Upon successful startup the TCP port it is listening on and the process ID of the daemon are  printed  to
       stdout.  ippusbxd  will  shut  itself  down  when  the connected printer disconnects. When not specifying
       information about the desired printer, ippusbxd scans the USB and connects to the  first  available  IPP-
       over-USB printer.

OPTIONS

       -h, --help
              Show help message.

       -v VENDOR_ID, --vid VENDOR_ID
              USB vendor ID of desired printer.

       -m PRODUCT_ID, --pid PRODUCT_ID
              USB product ID of desired printer.

       -s SERIAL_NUMBER, --serial SERIAL_NUMBER
              Serial number of desired printer.

       --bus BUS --device DEVICE, --bus-device BUS:DEVICE
              USB  bus and device numbers where the device is currently connected (see output of lsusb(8)). Note
              that these numbers change when the device is disconnected and reconnected. This method of  calling
              ippusbxd is only for calling via UDEV. BUS and DEVICE have to be given in decimal numbers.

       -p PORT_NUMBER, --only-port PORT_NUMBER
              Port  number  ippusbxd  will expose the printer over. If this port is already taken, ippusbxd will
              error out.

       -P PORT_NUMBER, --from-port PORT_NUMBER
              Port number ippusbxd will expose the printer over. If this port is already  taken,  ippusbxd  will
              increase the port number by 1 and try again until it finds a free port.

       -i INTERFACE, --interface INTERFACE
              Network interface to use. Default is the loopback interface (lo, localhost).

       -l, --logging
              Send all logging to syslog.

       -q, --verbose
              Enable verbose logging.

       -d, --debug
              Enables debug mode.  Implies -q and -n.  Verbose logging will be sent to stdout

       -n, --no-fork
              Enables no fork mode.  Disables deamonization.

       -B, --no-broadcast
              No-broadcast mode, do not DNS-SD-broadcast

       -N, --no-printer
              No-printer mode, debug/developer mode which makes ippusbxd run without IPP-over-USB printer

BUGS

       ippusbxd  does  not detect whether a USB printer is already connected by another instance of ippusbxd, so
       the system/the user has to take care to not start ippusbxd more than once for one and the  same  printer.
       Especially  one  should  never  start ippusbxd repeatedly without specifying a printer to assure that all
       connected IPP-over-USB printers get their ippusbxd instance.

                                                                                                     IPPUSBXD(8)