4.6 Using iprntcmd on Linux and Macintosh

The Linux and Macintosh iPrint Clients include the iprntcmd utility that performs the same functions as iprntcmd in the Windows iPrint Client. In addition, you can use iprntcmd to upload PPD drivers to a Driver Store from the Linux iPrint Client. iprntcmd is located in /opt/novell/iprint/bin/iprntcmd on Linux and in /usr/bin on Macintosh.

Use the following parameters when executing the iprntcmd command:

Table 4-9 Parameters Used with iprntcmd

Parameters

Description

-T | --tray-icon

Displays an iPrint icon to the notification area and starts 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 or --addprinter printer_uri

Installs the specified printer.

-d or --delprinter printer_uri

Removes the specified printer.

-d or --delprinter all

Removes all printers. This option requires your confirmation before removing all the printers.

-d or --delprinter all --force

Remove all the printers. This option removes all the printers forcibly without any user intervention.

-g or --getdefault

Displays the default printer installed on the workstation.

-h or --help

Displays help for the command.

-j or --listjobs printer_uri

Lists the print jobs for the specified printer that are on the server in a pending or printing state.

-l or --listprinters

Lists printers installed on the workstation.

-L or --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 or --printfile printer-uri filepath

Sends a printer-ready file to the specified iPrint printer.

-P or --ppdlist

Lists the PPDs installed on this workstation.

-s or --setdefault printer_uri

Sets the specified printer as the default.

-t or --testpage printer_uri

Prints a test page to the specified printer.

-u or --uploadids ids_uri ppd with/without a wildcard

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 or --uploadbroker rms_uri rms_name ppd with/without a wildcard

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 or --version psm-hostname or psm-address

Displays the server platform and version information where server_uri is the URI for the server.

-i or --info printer-uri

Displays the printer information.

Syntax

iprntcmd options parameters

You must use quotes around parameter information that contains a space, such as printer names and printer drivers.

Example

To install a printer named Color Printer 1 and set it as the default printer, enter the following

iprntcmd -a "ipp://printing.my_company.com/ipp/Color Printer 1"

iprntcmd --setdefault "ipp://printing.my_Company.com/ipp/Color Printer 1"

For uploading PPD files from Mac and Linux clients, enter the following:

iprntcmd -u <ids-hostname or ids-address> <ppd path with/without wild cards>

When prompted for a username, examples of two acceptable formats are:

admin or cn=admin,o=OrgName

For more examples, use the man iprntcmd command on your server console.