lpoptions(1)

NAME

       lpoptions - display or set printer options and defaults

SYNOPSIS

       lpoptions [ -h server ] -d dest[/instance] [ -o option=value ] ... [ -o
       option=value ]
       lpoptions [ -h server ] [ -E ] [ -p dest[/instance] ] -l
       lpoptions [ -h  server  ]  [  -E  ]  [  -o  option=value  ]  ...  [  -o
       option=value ] [ -p dest[/instance] ] -r option
       lpoptions [ -h server ] [ -E ] -x dest[/instance]

DESCRIPTION

       lpoptions  displays  or  sets  printer options and defaults.  lpoptions
       shows the default printer options when run  with  no  arguments.  Other
       options include:

       -E
            Enables encryption when communicating with the CUPS server.

       -d dest[/instance]
            Sets  the  default  printer  to dest. If instance is supplied then
            that particular instance is used. This option overrides the system
            default printer for the current user.

       -h server
            Specifies the CUPS server to communicate with.

       -l
            Lists the printer specific options and their current settings.

       -o option=value
            Specifies a new option for the named destination.

       -p dest[/instance]
            Sets  the  destination and instance, if specified, for any options
            that follow.  If the named instance does not exist then it is cre-
            ated.

       -r option
            Removes the specified option for the named destination.

       -x dest[/instance]
            Removes  the  options  for  the named destination and instance, if
            specified.  If the named instance does not exist  then  this  does
            nothing.

       If  no  options  are  specified  using  the  -o option then the current
       options for the named printer are reported on the standard output.

       Options set with the lpoptions command are used by the lp(1) and lpr(1)
       commands when submitting jobs.

ROOT ACCOUNT OPTIONS

       When  run by the root user, lpoptions gets and sets default options and
       instances for all users in the /etc/cups/lpoptions file.

COMPATIBILITY

       The lpoptions command is unique to CUPS.

FILES

       ~/.lpoptions - user defaults and instances created by non-root users.
       /etc/cups/lpoptions - system-wide defaults and instances created by the
       root user.

SEE ALSO

       cancel(1), lp(1), CUPS Software Users Manual, http://localhost:631/doc-
       umentation.html

COPYRIGHT

       Copyright 1993-2005 by Easy Software Products, All Rights Reserved.

21 October 2002           Common UNIX Printing System             lpoptions(1)