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
       option[=value] ...
       lpoptions [ -h server[:port] ] [	-E ] [ -p destination[/instance] ]  -r
       option
       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 de-
       scribed in lp(1).

       If no -l, -o, or	-r options are specified, the current options are  re-
       ported 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
       instances for all  users	 in  the  /usr/local/etc/cups/lpoptions	 file.
       Otherwise,  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 sup-
	    plied then that particular instance	is used.   This	 option	 over-
	    rides the system 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 cre-
	    ated.  Destinations	can only be created using the lpadmin(8)  pro-
	    gram.

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

       -x destination[/instance]
	    Removes  the  options  for	the named destination and instance, if
	    specified.	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 cre-
       ated 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://localhost: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+14.3.quarterly>

home | help