iprntcmd (1)

Name

iprntcmd - iprint administrative utility.

SYNTAX

iprntcmd <options> <parameter>

DESCRIPTION

iprntcmd provides command-line functionality for iPrint administrative tasks on a workstation.

OPTION SUMMARY

You must use quotes around parameters that contain spaces.

OPTIONS

Option type <parameter>

-T | --tray-icon: Displays an iPrint icon to the notification area and launches the iprint-listener-gui process, if it is not running.
-r | --run-listener: Launches the iprint-listener process if it is not already running.
-a | --addprinter <printer-uri>: Installs the specified printer.
-d | --delprinter <printer-uri>: Removes the specified printer.
-d | --delprinter all: Remove all the printers. This option requires your confirmation before removing all the printers.
-d | --delprinter all --force: Remove all the printers. This option removes all the printers forcibly without any user intervention.
-g | --getdefault: Displays the default printer installed on the workstation.
-h | --help: Displays help for the command.
-j | --listjobs <printer-uri>: Lists the print jobs for the specified printer that are on the server in a pending or printing state.
-l | --listprinters: Lists printers installed on the workstation.
-L | -listprintersonserver <psm-hostname or psm-address>: Lists iPrint printers on the specified Print Manager where psm-hostname or psm-address can be a DNS name or IP address.
-p | --printfile <printer-uri> <file path>: Sends a printer-ready file to the specified iPrint printer.
-P | --ppdlist: Lists the PPDs installed on this workstation.
-s | --setdefault <printer-uri>: Sets the specified printer as the default.
-t | --testpage <printer-uri>: Prints a test page to the specified printer.
-u | --uploadids <ids-uri> <ppd path with/without wildcards>: Uploads the specified PPD files to the indicated driver store where ids_uri is the IP address or DNS name for the driver store, and ppd is the directory path and filename to the PPD files. You can use a wildcard in the PPD filename.
-U | --uploadbroker <rms-uri> <rms-name> <ppd path with/without wildcards>: Uploads the specified PPD files to the indicated Broker where rms_uri is the IP address or DNS name for the Broker’s associated print manager, rms_name is the username with rights to add drivers to the broker, and ppd is the directory path and filename to the PPD files. You can use a wildcard in the PPD filename.
-v | --version <psm-hostname or psm-address>: Displays the server platform and version information where server_uri is the URI for the server.
-i | --info <printer-uri>: Displays the printer information.
-S | --setprimarypsm <IP/DNS>: Sets the PSM address for iCM configuration.
-c | --clearallpasswords: Clears all saved passwords.
-f | --fetchdriverlocal <printer-uri>: Fetches the printer driver on local machine.

EXAMPLES

Syntax

iprntcmd --<option> ipp://<host_address>/ipp/<printer_name>

Example to add a printer

iprntcmd --addprinter ipp://printing.MyCompany.com/ipp/Printer1

Example to delete a printer

iprntcmd --delprinter ipp://printing.MyCompany.com/ipp/Printer1

Example to get a default printer

iprntcmd --getdefault

Example to list the print jobs

iprntcmd --listjobs ipp://printing.MyCompany.com/ipp/Printer1

Example to get the list of installed printers

iprntcmd --listprinters

Example to get the list of printers on a server

iprntcmd --listprintersonserver printing.MyCompany.com

Example to print a file

iprntcmd --printfile ipp://printing.MyCompany.com/ipp/Printer1 /home/user1/temp.txt

Example to get a list of local ppd files

iprntcmd --ppdlist

Example to set a default printer

iprntcmd --setdefault ipp://printing.MyCompany.com/ipp/Printer1

Example to test a print page

iprntcmd --testpage ipp://printing.MyCompany.com/ipp/Printer1

Example to upload driver <without using a wildcard> to ids

iprntcmd --uploadids printing.MyCompany.com /usr/share/cups/model/HP/LaserJet_4V_4LJ_Pro-lj4dithp.ppd.gz

or

iprntcmd --uploadids 192.168.3.4 /usr/share/cups/model/HP/LaserJet_4V_4LJ_Pro-lj4dithp.ppd.gz

Example to upload driver <using a wildcard> to ids

iprntcmd --uploadids printing.MyCompany.com /usr/share/cups/model/HP/LaserJet_4*

or

iprntcmd --uploadids 192.168.3.4 /usr/share/cups/model/HP/LaserJet_4*

Example to upload drivers (without using a wildcard) to rms

iprntcmd --uploadbroker printing.MyCompany.com rms_name /usr/share/cups/model/HP/LaserJet_4V_4LJ_Pro-lj4dithp.ppd.gz

or

iprntcmd --uploadbroker 192.168.3.4 rms_name /usr/share/cups/model/HP/LaserJet_4V_4LJ_Pro-lj4dithp.ppd.gz

Example to upload drivers (using a wildcard) to rms

iprntcmd --uploadbroker printing.MyCompany.com rms_name /usr/share/cups/model/HP/LaserJet_4*

or

iprntcmd --uploadbroker 1.2.3.4 rms_name /usr/share/cups/model/HP/LaserJet_4*

Example to get iprint server version

iprntcmd --version printing.MyCompany.com

or

iprntcmd --version 192.168.3.4

Example to get information of a printer

iprntcmd --info ipp://printing.MyCompany.com/ipp/Printer1