docs/htmldocs/testprns.1.html

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