OS Manuals

/usr/bin/lpadmin

CUPS command-line client programs

From cups-client 2.4.20-r0 (os), captured 2026-11-05 by running lpadmin --help (exit 1). permalink

Usage: lpadmin [options] -d destination
       lpadmin [options] -p destination
       lpadmin [options] -p destination -c class
       lpadmin [options] -p destination -r class
       lpadmin [options] -x destination
Options:
-c class                Add the named destination to a class
-d destination          Set the named destination as the server default
-D description          Specify the textual description of the printer
-E                      Encrypt the connection to the server
-E                      Enable and accept jobs on the printer (after -p)
-h server[:port]        Connect to the named server and port
-i ppd-file             Specify a PPD file for the printer
-L location             Specify the textual location of the printer
-m model                Specify a standard model/PPD file for the printer
-m everywhere           Specify the printer is compatible with IPP Everywhere
-o name-default=value   Specify the default value for the named option
-o Name=Value           Specify the default value for the named PPD option
-o cupsIPPSupplies=false
                        Disable supply level reporting via IPP
-o cupsSNMPSupplies=false
                        Disable supply level reporting via SNMP
-o job-k-limit=N        Specify the kilobyte limit for per-user quotas
-o job-page-limit=N     Specify the page limit for per-user quotas
-o job-quota-period=N   Specify the per-user quota period in seconds
-o printer-error-policy=name
                        Specify the printer error policy
-o printer-is-shared=true
                        Share the printer
-o printer-op-policy=name
                        Specify the printer operation policy
-p destination          Specify/add the named destination
-r class                Remove the named destination from a class
-R name-default         Remove the default value for the named option
-u allow:all            Allow all users to print
-u allow:list           Allow the list of users or groups (@name) to print
-u deny:list            Prevent the list of users or groups (@name) to print
-U username             Specify the username to use for authentication
-v device-uri           Specify the device URI for the printer
-x destination          Remove the named destination
Options (17)
OptionDescriptionSource
-c classAdd the named destination to a classhelp + man
-d destinationSet the named destination as the server defaulthelp
-D descriptionProvides a textual description of the destination.help + man
-EWhen specified before the -d, -p, or -x options, forces the use of TLS encryption on the connection to the scheduler.help + man
-h server[:portConnect to the named server and porthelp
-i ppd-fileThis option historically has been used to provide either a System V interface script or (as an implementation side-effect) a PPD file.help + man
-L locationProvides a textual location of the destination.help + man
-m modelSets a standard PPD file for the printer from the model directory or using one of the driver interfaces.help + man
-o name-default=valueSpecify the default value for the named optionhelp + man
-p destinationSpecify/add the named destinationhelp
-r classRemove the named destination from a classhelp + man
-R name-defaultRemove the default value for the named optionhelp + man
-u allow:allAllow all users to printhelp + man
-U usernameSpecify the username to use for authenticationhelp
-v device-uriSets the device-uri attribute of the printer queue.help + man
-x destinationRemove the named destinationhelp
-P ppd-fileSpecifies a PostScript Printer Description (PPD) file to use with the printer. (in the manual page but not in --help)man
Examples (1) from the manual page, untested

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.