Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
lpoptions(1)			  OpenPrinting			    lpoptions(1)

NAME
     lpoptions - display or set printer options and defaults

SYNOPSIS
     lpoptions [ -h server[:port] ] [ -E ] -d destination[/instance] [ -l ]
     lpoptions	[ -h server[:port] ] [ -E ] [ -p destination[/instance] ] -o op-
     tion[=value] ...
     lpoptions [ -h server[:port] ] [ -E ] [ -p destination[/instance] ] -r  op-
     tion
     lpoptions [ -h server[:port] ] [ -E ] -x destination[/instance]

DESCRIPTION
     lpoptions	displays or sets printer options and defaults.	If no printer is
     specified using the -p option, the default printer is used as described  in
     lp(1).

     If no -l, -o, or -r options are specified, the current options 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.

     When run by the root user, lpoptions gets and sets default options and  in-
     stances  for  all	users in the /usr/local/etc/cups/lpoptions file.  Other-
     wise, the per-user defaults are managed in the ~/.cups/lpoptions file.

OPTIONS
     lpoptions supports the following options:

     -E   Enables encryption when communicating with the CUPS server.

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

     -h server[:port]
	  Uses an alternate server.  Note: This option	must  occur  before  all
	  others.

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

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

     -p destination[/instance]
	  Sets	the destination and instance, if specified, for any options that
	  follow.  If the named instance does not  exist  then	it  is	created.
	  Destinations can only be created using the lpadmin(8) program.

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

     -x destination[/instance]
	  Removes  the options for the named destination and instance, if speci-
	  fied.  If the named instance does not exist then  this  does	nothing.
	  Destinations can only be removed using the lpadmin(8) command.

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

CONFORMING TO
     The lpoptions command is unique to CUPS.

SEE ALSO
     cancel(1), lp(1), lpadmin(8), lpr(1), lprm(1), CUPS Online Help (http://lo-
     calhost:631/help)

COPYRIGHT
     Copyright (C) 2020-2024 by OpenPrinting.

2022-05-02			      CUPS			    lpoptions(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=lpoptions&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help