home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 20 NDrivers / 20-NDrivers.zip / samba193.zip / testprns.txt < prev   
Text File  |  1996-01-06  |  4KB  |  133 lines
  1.  
  2.  
  3.  
  4. TESTPRNS(1)                  testprns                 TESTPRNS(1)
  5.  
  6.  
  7. NAME
  8.        testprns - check printer name for validity with smbd
  9.  
  10. SYNOPSIS
  11.        testprns printername [ printcapname ]
  12.  
  13. DESCRIPTION
  14.        This program is part of the Samba suite.
  15.  
  16.        testprns  is  a  very  simple  test  program  to determine
  17.        whether a given printer name is valid for use in a service
  18.        to be provided by smbd.
  19.  
  20.        "Valid"  in this context means "can be found in the print-
  21.        cap specified". This program is very stupid - so stupid in
  22.        fact  that it would be wisest to always specify the print-
  23.        cap file to use.
  24.  
  25. OPTIONS
  26.        printername
  27.  
  28.           The printer name to validate.
  29.  
  30.           Printer names are taken from the first  field  in  each
  31.           record  in  the printcap file, single printer names and
  32.           sets of aliases separated by vertical  bars  ("|")  are
  33.           recognised.  Note that no validation or checking of the
  34.           printcap syntax is done beyond that required to extract
  35.           the  printer  name.  It  may be that the print spooling
  36.           system is more forgiving or less forgiving  than  test-
  37.           prns  however  if  testprns finds the printer then smbd
  38.           should do as well.
  39.  
  40.  
  41.        printcapname
  42.  
  43.           This is the name of the printcap file to search for the
  44.           given printer name in.
  45.  
  46.           If no printcap name is specified, testprns will attempt
  47.           to scan the printcap file  specified  at  compile  time
  48.           (PRINTCAP_NAME).
  49.  
  50. FILES
  51.        /etc/printcap
  52.           This  is usually the default printcap file to scan. See
  53.           printcap(5)).
  54.  
  55. ENVIRONMENT VARIABLES
  56.        Not applicable.
  57.  
  58.  
  59. INSTALLATION
  60.        The location of the server and  its  support  files  is  a
  61.  
  62.  
  63.  
  64. testprns                    17/1/1995                           1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. TESTPRNS(1)                  testprns                 TESTPRNS(1)
  71.  
  72.  
  73.        matter for individual system administrators. The following
  74.        are thus suggestions only.
  75.  
  76.        It is recommended that the testprns program  be  installed
  77.        under the /usr/local hierarchy, in a directory readable by
  78.        all, writeable only by root. The program  should  be  exe-
  79.        cutable  by all.  The program should NOT be setuid or set-
  80.        gid!
  81.  
  82. VERSION
  83.        This man page is (mostly) correct for  version  1.9.00  of
  84.        the  Samba  suite,  plus some of the recent patches to it.
  85.        These notes will necessarily lag behind development of the
  86.        software,  so it is possible that your version of the pro-
  87.        gram has extensions or  parameter  semantics  that  differ
  88.        from  or  are  not covered by this man page. Please notify
  89.        these to the address below for rectification.
  90.  
  91. SEE ALSO
  92.        printcap(5), smbd(8), smbclient(1)
  93.  
  94. DIAGNOSTICS
  95.        If a printer is found to be valid,  the  message  "Printer
  96.        name <printername> is valid" will be displayed.
  97.  
  98.        If  a printer is found to be invalid, the message "Printer
  99.        name <printername> is not valid" will be displayed.
  100.  
  101.        All messages that would normally be logged  during  opera-
  102.        tion  of  smbd  are  logged  by  this  program to the file
  103.        test.log in the current directory.  The  program  runs  at
  104.        debuglevel  3,  so  quite extensive logging information is
  105.        written. The log should be checked  carefully  for  errors
  106.        and warnings.
  107.  
  108.        Other messages are self-explanatory.
  109.  
  110. BUGS
  111.        None known.
  112.  
  113. CREDITS
  114.        The  original  Samba  software  and related utilities were
  115.        created by Andrew Tridgell (samba-bugs@anu.edu.au). Andrew
  116.        is also the Keeper of the Source for this project.
  117.  
  118.        The  testprns  program  and  this man page were written by
  119.        Karl Auer (Karl.Auer@anu.edu.au)
  120.  
  121.        See samba(7) for a full list of contributors  and  details
  122.        of how to submit bug reports, comments etc.
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130. testprns                    17/1/1995                           2
  131.  
  132.  
  133.