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

FreeBSD Manual Pages

  
 
  

home | help
lpset(1M)		System Administration Commands		     lpset(1M)

NAME
       lpset  -	set printing configuration in /etc/printers.conf or other sup-
       ported databases

SYNOPSIS
       lpset [-n  system | nisplus | fns | ldap]   [-x]	 [  [-D	  binddn]  [-w
       passwd] [-h  ldaphost]] [-a key=value] [-d key] destination

DESCRIPTION
       The  lpset utility sets printing	configuration information in  the sys-
       tem configuration databases. Use	lpset to create	 and  update  printing
       configuration in	/etc/printers.conf, printers.org_dir (NIS+), or	Feder-
       ated Naming System (FNS). See nsswitch.conf(4),	printers.conf(4),  and
       fns(5).

       Only a superuser	or a member of Group 14	may execute lpset.

OPTIONS
       The following options are supported:

       -n system|nisplus|fns|ldap
	     Create  or	update the configuration information  for the destina-
	     tion entry	in /etc/printers.conf, printers.org_dir	 (NIS+),  LDAP
	     or	FNS printer contexts. system specifies that the	information is
	     created or	updated	in /etc/printers.conf. nisplus specifies  that
	     the  information  is  created  or updated in the printers.org_dir
	     NIS+ table. ldap specifies	that the information is	written	to  an
	     LDAP  server.  See	 NOTES.	 fns specifies that the	information is
	     written using federated naming context.

	     If	 -n is not specified, system is	the default.

       -x    Remove all	configuration for   the	 destination  entry  from  the
	     database specified	by the -n option.

       -a key=value
	     Configure	the specified key=value	pair for the destination.  See
	     printers.conf(4) for information regarding	the  specification  of
	     key=value pairs.

       -d key
	     Delete  the configuration option specified	by key for the	desti-
	     nation entry. See printers.conf(4)	for information	regarding  the
	     specification of key and  key=value pairs.

       -D binddn
	     Use the distinguished name	(DN) binddn to bind to the LDAP	direc-
	     tory server.

       -w passwd
	     Use passwd	as the password	for authentication to the LDAP	direc-
	     tory server.

       -h ldaphost
	     Specify  an  alternate  host on which the LDAP server is running.
	     This option is only used when ldap	is  specified  as  the	naming
	     service. If this option is	not specified, the default is the cur-
	     rent host system.

OPERANDS
       The following operand is	supported:

       destination
	     Specifies the  entry  in	/etc/printers.conf,  printers.org_dir,
	     LDAP,  or FNS, in which to	create or modify information. destina-
	     tion names	a printer of class of printers.	See  lpadmin(1M). Each
	     entry in  printers.conf describes one destination.	Specify	desti-
	     nation using atomic or Federated Naming Service  (FNS)  (.../ser-
	     vice/printer/...)	names.	POSIX-style  destination names are not
	     acceptable. See printers.conf(4) for  information	regarding  the
	     naming  conventions for atomic and	FNS names and standards(5) for
	     information regarding POSIX.

EXAMPLES
       Example 1: Removing All Existing	Printing Configuration Information

       The following example removes all existing printing  configuration  in-
       formation for destination dogs from /etc/printers.conf:

       example%	lpset -x dogs

       Example 2: Setting a key=value Pair

       The  following  example	sets the user-equivalence =true	key=value pair
       for destination	tabloid	in FNS context:

       example%	lpset -n fns -a	user-equivalence=true tabloid

       Example 3: Setting a key=value Pair in LDAP

       example%	lpset -n ldap -h ldapl.xyz.com -D "cn=Directory	Manager" \
	  -w passwd -a key1=value1 printer1

EXIT STATUS
       The following exit values are returned:

       0     Successful	completion.

       non-zero
	     An	error occurred.

FILES
       /etc/printers.conf
	     System configuration database.

       printer.org_dir (NIS+)
	     NIS+ version of /etc/printers.conf.

       fns.ctx_dir.domain
	     FNS version of /etc/printers.conf.

ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE	TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWpcu			   |
       +-----------------------------+-----------------------------+
       |Stability Level		     |Stable			   |
       +-----------------------------+-----------------------------+

SEE ALSO
       ldap(1),	lp(1), lpc(1B),	lpq(1B), lpr(1B),  lpstat(1),  ldapclient(1M),
       lpadmin(1M),    lpget(1M),    nsswitch.conf(4),	 printers(4),	print-
       ers.conf(4), attributes(5), fns(5), standards(5)

       System Administration Guide: Naming and Directory Services

NOTES
	If the ldap database is	used,  the  printer  administrator  should  be
       mindful of the following	when updating printer information.

       1. Because  the domain information for the printer being	updated	is ex-
	  tracted from the ldapclient(1M) configuration, the LDAP server being
	  updated  must	host the same domain that is used by the current ldap-
	  client(1M) server.

       2. If the LDAP server being updated is a	replica	LDAP server,  the  up-
	  dates	 will  be  referred  to	 the  master LDAP server and completed
	  there. The updates might be out of sync and not appear immediatedly,
	  as  the  replica  server  may	 not  have  been updated by the	master
	  server.  For example,	a printer that you deleted by using lpset  may
	  still	 appear	 in  the printer list you display with lpget until the
	  replica is updated from the master. Replica servers vary as  to  how
	  often	 they  are updated from	the master.  See System	Administration
	  Guide: Advanced Administration for information on LDAP server	repli-
	  cation.

       3. Although  users  can	use the	LDAP command line utilities ldapadd(1)
	  and ldapmodify(1) to update printer entries in  the  directory,  the
	  preferred  method  is	 to  use  lpset. Otherwise, if the ldapadd and
	  ldapmodify utilities are used, the administrator  must  ensure  that
	  the  printer-name  attribute	value is unique	within the ou=printers
	  container on the LDAP	server.	If the value is	not unique, the	result
	  of  modifications  done  using  lpset	 or the	Solaris	Print Manager,
	  printmgr(1M) may be unpredictable.

SunOS 5.9			  6 Aug	2001			     lpset(1M)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | OPERANDS | EXAMPLES | EXIT STATUS | FILES | ATTRIBUTES | SEE ALSO | NOTES

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=lpset&sektion=1m&manpath=SunOS+5.9>

home | help