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) 2021-2022 by OpenPrinting.

2022-05-02			     CUPS			  lpoptions(1)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | FILES | CONFORMING TO | SEE ALSO | COPYRIGHT

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

home | help