IPB
>  Man Pages > Unix > Solaris 10 11/06 > Section 4 > printers man page

printers man page

Section 4 - 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!





File Formats                                          printers(4)



NAME
     printers - user-configurable printer alias database

SYNOPSIS
     $HOME/.printers

DESCRIPTION
     The  $HOME/.printers file is a  simplified  version  of  the
     system  /etc/printers.conf file. See printers.conf(4). Users
     create the $HOME/.printers file  in  their  home  directory.
     This optional file is customizable by the user.

     The $HOME/.printers file performs the following functions:

     1.  Sets personal aliases for all print commands.


     2.  Sets the interest list for  the lpget, lpstat, and  can-
         cel commands. See lpget(1M), lpstat(1) and  cancel(1).


     3.  Sets the default printer for the lp, lpr, lpq, and  lprm
         commands. See lp(1), lpr(1B), lpq(1B), and lprm(1B).


  Entries
     Use a line or full screen editor to  create  or  modify  the
     $HOME/.printers file.

     Each entry in  $HOME/.printers  describes  one  destination.
     Entries  are  one line consisting of two fields separated by
     either BLANKs or TABs and terminated by  a  NEWLINE.  Format
     for an entry in $HOME/.printers varies according to the pur-
     pose of the entry.

     Empty lines can be included  for  readability.  Entries  may
     continue on to multiple lines by adding a backslash (`\') as
     the last character in the line. The $HOME/.printers file can
     include  comments.  Comments  have a pound sign (`#') as the
     first character in the line, and are terminated  by  a  NEW-
     LINE.

  Setting Personal Aliases
     Specify the alias or aliases in the  first  field.  Separate
     multiple  aliases by a pipe sign (`|'). Specify the destina-
     tion in the second field. A destination names a  printer  or
     class of printers, See  lpadmin(1M). Specify the destination
     using atomic or POSIX-style (server:destination) names.  See
     printers.conf(4)  for  information regarding the naming con-
     ventions for atomic names, and standards(5) for  information
     regarding POSIX.




SunOS 5.10          Last change: 23 May 2003                    1






File Formats                                          printers(4)



  Setting the Interest List for lpget, lpstat and cancel
     Specify _all in the first field. Specify the  list of desti-
     nations  for the interest list in the second field. Separate
     each destinations by a  comma  (`,').  Specify  destinations
     using  atomic or POSIX-style (server:destination) names. See
     printers.conf(4) for information regarding the  naming  con-
     ventions for atomic and names. This list of destinations can
     refer to an alias defined in $HOME/.printers.

  Setting the Default Destination
     Specify _default in the first  field.  Specify  the  default
     destination  in the second field. Specify the default desti-
     nation  using  atomic  or  POSIX-style  (server:destination)
     names.  See  printers.conf(4)  for information regarding the
     naming conventions for atomic names. The default destination
     may refer to an alias defined in $HOME/.printers.

  Locating Destination Information
     The print client  commands  locate  destination  information
     based    on   the   "printers"   database   entry   in   the
     /etc/nsswitch.conf file. See nsswitch.conf(4).

  Locating the Personal Default Destination
     The default destination is located differently depending  on
     the command.

     The lp command locates the default destination in  the  fol-
     lowing order:

     1.  lp command's -d destination option.


     2.  LPDEST environment variable.


     3.  PRINTER environment variable.


     4.  _default destination in  $HOME/.printers.


     5.  _default destination in  /etc/printers.conf.


     The  lpr, lpq, and  lprm commands locate the default  desti-
     nation in the following order:

     1.  lpr command's -P destination option.


     2.  PRINTER environment variable.




SunOS 5.10          Last change: 23 May 2003                    2






File Formats                                          printers(4)



     3.  LPDEST environment variable.


     4.  _default destination in  $HOME/.printers.


     5.  _default destination in  /etc/printers.conf.


  Locating the Interest List for lpget, lpstat, and cancel
     The lpget, lpstat, and cancel commands locate  the  interest
     list in the following order:

     1.  _all list in $HOME/.printers.


     2.  _all list in /etc/printers.conf.


EXAMPLES
     Example 1: Setting the interest list

     The following entry sets the interest list  to  destinations
     ps, secure, and dog at server west and  finance_ps:

     _all      ps,secure,west:dog/finance_ps

     Example 2: Setting aliases to a printer

     The following entry sets the  aliases ps,  lp,  and   lw  to
     sparc_printer:

     ps|lp|lw  sparc_printer

     Example 3: Setting an alias as a default destination

     The following entry sets the alias pcl to  hplj and sets  it
     as the default destination:

     pcl|_default   hplj

     Example 4: Setting an alias to a server destination

     The following entry sets the  alias  secure  to  destination
     catalpa at server tabloid:

     secure    tabloid:catalpa

     Example 5: Setting an alias to a site destination

     The following entry sets the alias insecure  to  destination
     legal_ps:



SunOS 5.10          Last change: 23 May 2003                    3






File Formats                                          printers(4)



     insecure  legal_ps

FILES
     $HOME/.printers                 User-configurable    printer
                                     database.



     /etc/printers.conf              System printer configuration
                                     database.



     printers.conf.byname            NIS        version        of
                                     /etc/printers.conf.



     printers.org_dir                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                      |
    |_____________________________|_____________________________|


SEE ALSO
     cancel(1), lp(1),  lpq(1B),  lpr(1B),  lprm(1B),  lpstat(1),
     lpadmin(1M),  lpget(1M), nsswitch.conf(4), printers.conf(4),
     attributes(5), standards(5)

     System Administration Guide: Basic Administration

NOTES
     $HOME/.printers  is  referenced  by  the  printing  commands
     before     further    name    resolution    is    made    in
     /etc/printers.conf or the name service. If  the alias refer-
     ences  a  destination  defined  in /etc/printers.conf, it is
     possible that the destination is defined differently on dif-
     ferent  systems.   This  could cause output to be sent to an
     unintended destination if the user is logged in  to  a  dif-
     ferent system.



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:27:29 GMT 2007

Your favourite pages:

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

Top 10 most popular pages:

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

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

svn man page (2354 hits)
(FreeBSD 6.2)

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

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

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

sqlite3 man page (1329 hits)
(openSUSE 10.2)

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

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

lwptut man page (1105 hits)
(Suse Linux 10.1)

Useful Links

Go Back

Visitor Statistics


Valid XHTML 1.0 Transitional     Valid CSS!

Partners: Cambridge Plus :: Pyrenees Ski Resorts :: Server Room Temperature Monitor :: <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