IPB
>  Man Pages > Unix > Solaris 10 11/06 > Section 1M > lpset man page

lpset man page

Section 1M - Solaris 10 11/06 Man Pages

Other operating system man pages available here


Advanced Search

Hopefully, this page is exactly what you are looking for, but if not, you can always find further assistance on Unix/Linux Forum!





System Administration Commands                          lpset(1M)



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

SYNOPSIS
     lpset [-n  system | nisplus | fnsldap]  [-x] [ [-D   binddn]
     [-w   passwd] [-h  ldaphost]] [-a key=value] [-d key] desti-
     nation

DESCRIPTION
     The lpset utility sets printing configuration information in
     the  system configuration databases. Use lpset to create and
     update  printing  configuration  in  /etc/printers.conf,  or
     printers.org_dir    (NIS+).    See    nsswitch.conf(4)   and
     printers.conf(4).

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

OPTIONS
     The following options are supported:

     -n system|nisplus|ldap

         Create or update the configuration information  for  the
         destination       entry      in      /etc/printers.conf,
         printers.org_dir (NIS+), or LDAP printer contexts.  sys-
         tem specifies that the information is created or updated
         in /etc/printers.conf. nisplus specifies that the infor-
         mation  is  created  or  updated in the printers.org_dir
         NIS+ table. ldap specifies that the information is writ-
         ten to an LDAP server. See NOTES.

         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  destina-
         tion.   See  printers.conf(4)  for information regarding
         the specification of key=value pairs.







SunOS 5.10          Last change: 23 May 2003                    1






System Administration Commands                          lpset(1M)



     -d key

         Delete the configuration option specified by key for the
         destination  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 directory server.



     -w passwd

         Use passwd as the password  for  authentication  to  the
         LDAP directory 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 current host system.



OPERANDS
     The following operand is supported:

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



EXAMPLES
     Example 1:  Removing  All  Existing  Printing  Configuration
     Information



SunOS 5.10          Last change: 23 May 2003                    2






System Administration Commands                          lpset(1M)



     The following example removes all existing  printing  confi-
     guration    information    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 the NIS+ context:

     example% lpset -n nisplus -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.



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

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWpcu                     |
    |_____________________________|_____________________________|
    | Stability Level             | Stable                      |
    |_____________________________|_____________________________|




SunOS 5.10          Last change: 23 May 2003                    3






System Administration Commands                          lpset(1M)



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), printers.conf(4), attributes(5), standards(5)

     System Administration Guide: Naming and  Directory  Services
     (DNS, NIS, and LDAP)

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 extracted from the ldapclient(1M) configura-
         tion, the LDAP server being updated must host  the  same
         domain  that  is  used  by  the  current  ldapclient(1M)
         server.


     2.  If the LDAP server  being  updated  is  a  replica  LDAP
         server,  the updates 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  replica-
         tion.


     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.10          Last change: 23 May 2003                    4





Man(1) output converted with man2html and wrapped by fishsponge

This page was generated on Wed Sep 12 11:26:10 GMT 2007

Your favourite pages:

No pages logged yet.
Trying to save cookie...

Top 10 most popular pages:

sqlite3 man page (5334 hits)
(openSUSE 10.2)

svn man page (5209 hits)
(FreeBSD 6.2)

adv_cap_autoneg man page (4870 hits)
(Solaris 10 11_06)

CPAN man page (4607 hits)
(Suse Linux 10.1)

ssh man page (4342 hits)
(Suse Linux 10.1)

ssh-socks5-proxy-connect man page (2884 hits)
(Solaris 10 11_06)

netcat man page (2717 hits)
(Suse Linux 10.1)

pprosetup man page (2492 hits)
(Solaris 10 11_06)

startproc man page (2471 hits)
(Suse Linux 10.1)

signal man page (2408 hits)
(Suse Linux 10.1)

Useful Links

Go Back

Visitor Statistics


Valid XHTML 1.0 Transitional     Valid CSS!

Partners: Cambridge Plus :: Pyrenees Food :: PIC Micro Development :: <Link Available>
Unix Man Pages / Linux Man Pages :: HiFi Forum :: SIP VoIP Phone & Provider Reviews :: UNIX/Linux Forum Archives

More info on advertising on Unix/Linux Forum