docs/htmldocs/testprns.1.html

   1 <HTML
   2 ><HEAD
   3 ><TITLE
   4 >testprns</TITLE
   5 ><META
   6 NAME="GENERATOR"
   7 CONTENT="Modular DocBook HTML Stylesheet Version 1.57"></HEAD
   8 ><BODY
   9 CLASS="REFENTRY"
  10 BGCOLOR="#FFFFFF"
  11 TEXT="#000000"
  12 LINK="#0000FF"
  13 VLINK="#840084"
  14 ALINK="#0000FF"
  15 ><H1
  16 ><A
  17 NAME="TESTPRNS"
  18 >testprns</A
  19 ></H1
  20 ><DIV
  21 CLASS="REFNAMEDIV"
  22 ><A
  23 NAME="AEN5"
  24 ></A
  25 ><H2
  26 >Name</H2
  27 >testprns&nbsp;--&nbsp;check printer name for validity with smbd</DIV
  28 ><DIV
  29 CLASS="REFSYNOPSISDIV"
  30 ><A
  31 NAME="AEN8"
  32 ></A
  33 ><H2
  34 >Synopsis</H2
  35 ><P
  36 ><B
  37 CLASS="COMMAND"
  38 >testprns</B
  39 >  {printername} [printcapname]</P
  40 ></DIV
  41 ><DIV
  42 CLASS="REFSECT1"
  43 ><A
  44 NAME="AEN13"
  45 ></A
  46 ><H2
  47 >DESCRIPTION</H2
  48 ><P
  49 >This tool is part of the <A
  50 HREF="samba.7.html"
  51 TARGET="_top"
  52 >       Samba</A
  53 > suite.</P
  54 ><P
  55 ><B
  56 CLASS="COMMAND"
  57 >testprns</B
  58 > is a very simple test program
  59         to determine whether a given printer name is valid for use in
  60         a service to be provided by <A
  61 HREF="smbd.8.html"
  62 TARGET="_top"
  63 ><B
  64 CLASS="COMMAND"
  65 >       smbd(8)</B
  66 ></A
  67 >. </P
  68 ><P
  69 >"Valid" in this context means "can be found in the
  70         printcap specified". This program is very stupid - so stupid in
  71         fact that it would be wisest to always specify the printcap file
  72         to use. </P
  73 ></DIV
  74 ><DIV
  75 CLASS="REFSECT1"
  76 ><A
  77 NAME="AEN22"
  78 ></A
  79 ><H2
  80 >OPTIONS</H2
  81 ><P
  82 ></P
  83 ><DIV
  84 CLASS="VARIABLELIST"
  85 ><DL
  86 ><DT
  87 >printername</DT
  88 ><DD
  89 ><P
  90 >The printer name to validate.</P
  91 ><P
  92 >Printer names are taken from the first field in each
  93                 record in the printcap file, single printer names and sets
  94                 of aliases separated by vertical bars ("|") are recognized.
  95                 Note that no validation or checking of the printcap syntax is
  96                 done beyond that required to extract the printer name. It may
  97                 be that the print spooling system is more forgiving or less
  98                 forgiving than <B
  99 CLASS="COMMAND"
 100 >testprns</B
 101 >. However, if
 102                 <B
 103 CLASS="COMMAND"
 104 >testprns</B
 105 > finds the printer then
 106                 <B
 107 CLASS="COMMAND"
 108 >smbd</B
 109 > should do so as well. </P
 110 ></DD
 111 ><DT
 112 >printcapname</DT
 113 ><DD
 114 ><P
 115 >This is the name of the printcap file within
 116                 which to search for the given printer name. </P
 117 ><P
 118 >If no printcap name is specified <B
 119 CLASS="COMMAND"
 120 >testprns
 121                 </B
 122 > will attempt to scan the printcap file name
 123                 specified at compile time. </P
 124 ></DD
 125 ></DL
 126 ></DIV
 127 ></DIV
 128 ><DIV
 129 CLASS="REFSECT1"
 130 ><A
 131 NAME="AEN39"
 132 ></A
 133 ><H2
 134 >FILES</H2
 135 ><P
 136 ></P
 137 ><DIV
 138 CLASS="VARIABLELIST"
 139 ><DL
 140 ><DT
 141 ><TT
 142 CLASS="FILENAME"
 143 >/etc/printcap</TT
 144 ></DT
 145 ><DD
 146 ><P
 147 >This is usually the default printcap
 148                 file to scan. See <TT
 149 CLASS="FILENAME"
 150 >printcap (5)</TT
 151 >.
 152                 </P
 153 ></DD
 154 ></DL
 155 ></DIV
 156 ></DIV
 157 ><DIV
 158 CLASS="REFSECT1"
 159 ><A
 160 NAME="AEN48"
 161 ></A
 162 ><H2
 163 >DIAGNOSTICS</H2
 164 ><P
 165 >If a printer is found to be valid, the message
 166         "Printer name &#60;printername&#62; is valid" will be
 167         displayed. </P
 168 ><P
 169 >If a printer is found to be invalid, the message
 170         "Printer name &#60;printername&#62; is not valid" will be
 171         displayed. </P
 172 ><P
 173 >All messages that would normally be logged during
 174         operation of the Samba daemons are logged by this program to the
 175         file <TT
 176 CLASS="FILENAME"
 177 >test.log</TT
 178 > in the current directory. The
 179         program runs at debuglevel 3, so quite extensive logging
 180         information is written. The log should be checked carefully
 181         for errors and warnings. </P
 182 ><P
 183 >Other messages are self-explanatory. </P
 184 ></DIV
 185 ><DIV
 186 CLASS="REFSECT1"
 187 ><A
 188 NAME="AEN55"
 189 ></A
 190 ><H2
 191 >VERSION</H2
 192 ><P
 193 >This man page is correct for version 2.2 of
 194         the Samba suite.</P
 195 ></DIV
 196 ><DIV
 197 CLASS="REFSECT1"
 198 ><A
 199 NAME="AEN58"
 200 ></A
 201 ><H2
 202 >SEE ALSO</H2
 203 ><P
 204 ><TT
 205 CLASS="FILENAME"
 206 >printcap(5)</TT
 207 >,
 208         <A
 209 HREF="smbd.8.html"
 210 TARGET="_top"
 211 ><B
 212 CLASS="COMMAND"
 213 >smbd(8)</B
 214 ></A
 215 >,
 216         <A
 217 HREF="smbclient.1.html"
 218 TARGET="_top"
 219 ><B
 220 CLASS="COMMAND"
 221 >smbclient(1)</B
 222 ></A
 223 >
 224         </P
 225 ></DIV
 226 ><DIV
 227 CLASS="REFSECT1"
 228 ><A
 229 NAME="AEN66"
 230 ></A
 231 ><H2
 232 >AUTHOR</H2
 233 ><P
 234 >The original Samba software and related utilities
 235         were created by Andrew Tridgell. Samba is now developed
 236         by the Samba Team as an Open Source project similar
 237         to the way the Linux kernel is developed.</P
 238 ><P
 239 >The original Samba man pages were written by Karl Auer.
 240         The man page sources were converted to YODL format (another
 241         excellent piece of Open Source software, available at
 242         <A
 243 HREF="ftp://ftp.icce.rug.nl/pub/unix/"
 244 TARGET="_top"
 245 >       ftp://ftp.icce.rug.nl/pub/unix/</A
 246 >) and updated for the Samba 2.0
 247         release by Jeremy Allison.  The conversion to DocBook for
 248         Samba 2.2 was done by Gerald Carter</P
 249 ></DIV
 250 ></BODY
 251 ></HTML
 252 >