# HP Linux Imaging and Printing (HPLIP)

About
- Features
- Screenshots
- FAQs
Setup and Installation
- System Requirements
- Supported Devices
- Downloads
- Installation Instructions
Usage and Support
- Mailing Lists
- How-Tos
- Troubleshooting
- Release Notes
Resources
- Technical Documentation
- Sourceforge Project Page
- Software License
- Other Support Information
- About HPLIP
- Contacts

Home > Technical Documentation > Man Pages > hp-setup

Installs HPLIP printers and faxes in the CUPS spooler. Tries to automatically determine the correct PPD file to use. Allows the printing of a testpage. Performs basic fax parameter setup.

Usage: hp-setup [OPTIONS] [SERIAL NO.|USB ID|IP|DEVNODE]

[SERIAL NO.|USB ID|IP|DEVNODE]

USB IDs (usb only): | "xxx:yyy" where 'xxx' is the USB bus ID and 'yyy' is the USB device ID. (Note: The ':' and all leading zeros must be present.)
| Use the 'lsusb' command to obtain this information.
IPs (network only): | IPv4 address "a.b.c.d" or "hostname"
DEVNODE (parallel only): | "/dev/parportX", X=0,1,2,...
SERIAL NO. (usb and parallel only): | "serial no."

[OPTIONS]

Automatic mode: | -a or --auto
To specify the port on a multi-port JetDirect: | -p<port> or --port=<port> (Valid values are 1*, 2, and 3. *default)
No testpage in automatic mode: | -x
To specify a CUPS printer queue name: | -n<printer> or --printer=<printer>
To specify a CUPS fax queue name: | -f<fax> or --fax=<fax>
Type of queue(s) to install: | -t<typelist> or --type=<typelist>. <typelist>: print*, fax* (*default)
Bus to probe (if device not specified): | -b<bus> or --bus=<bus>
| <bus>: cups*, usb*, net, bt, fw, par* (*defaults) (Note: bt and fw not supported in this release.)
Set the logging level: | -l<level> or --logging=<level>
| <level>: none, info*, error, warn, debug (*default)
Run in debug mode: | -g (same as option: -ldebug)
This help information: | -h or --help

Examples:

One USB printer attached, automatic: | $ hp-setup -a
USB, IDs specified: | $ hp-setup 001:002
Network: | $ hp-setup 66.35.250.209
Network, Jetdirect port 2: | $ hp-setup --port=2 66.35.250.209
Parallel: | $ hp-setup /dev/parport0
USB or parallel, using serial number: | $ hp-setup US12345678A
USB, automatic: | $ hp-setup --auto 001:002
Parallel, automatic, no testpage: | $ hp-setup -a -x /dev/parport0
Parallel, choose device: | $ hp-setup -b par

Notes:

1. If no serial number, USB ID, IP, or device node is specified, the USB and parallel busses will be probed for devices.

2. Using 'lsusb' to obtain USB IDs: (example)

$ lsusb
Bus 003 Device 011: ID 03f0:c202 Hewlett-Packard
$ hp-setup --auto 003:011
(Note: You may have to run 'lsusb' from /sbin or another location. Use '$ locate lsusb' to determine this.)

See Also:

hp-makeuri |

Last update: Tue Aug 1 13:42:01 2006