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.7"></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.1"
  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 <SPAN
  51 CLASS="CITEREFENTRY"
  52 ><SPAN
  53 CLASS="REFENTRYTITLE"
  54 >Samba</SPAN
  55 >(7)</SPAN
  56 > suite.</P
  57 ><P
  58 ><B
  59 CLASS="COMMAND"
  60 >testprns</B
  61 > is a very simple test program
  62         to determine whether a given printer name is valid for use in
  63         a service to be provided by <SPAN
  64 CLASS="CITEREFENTRY"
  65 ><SPAN
  66 CLASS="REFENTRYTITLE"
  67 >smbd</SPAN
  68 >(8)</SPAN
  69 >.</P
  70 ><P
  71 >"Valid" in this context means "can be found in the
  72         printcap specified". This program is very stupid - so stupid in
  73         fact that it would be wisest to always specify the printcap file
  74         to use. </P
  75 ></DIV
  76 ><DIV
  77 CLASS="REFSECT1"
  78 ><A
  79 NAME="AEN25"
  80 ></A
  81 ><H2
  82 >OPTIONS</H2
  83 ><P
  84 ></P
  85 ><DIV
  86 CLASS="VARIABLELIST"
  87 ><DL
  88 ><DT
  89 >printername</DT
  90 ><DD
  91 ><P
  92 >The printer name to validate.</P
  93 ><P
  94 >Printer names are taken from the first field in each
  95                 record in the printcap file, single printer names and sets
  96                 of aliases separated by vertical bars ("|") are recognized.
  97                 Note that no validation or checking of the printcap syntax is
  98                 done beyond that required to extract the printer name. It may
  99                 be that the print spooling system is more forgiving or less
 100                 forgiving than <B
 101 CLASS="COMMAND"
 102 >testprns</B
 103 >. However, if
 104                 <B
 105 CLASS="COMMAND"
 106 >testprns</B
 107 > finds the printer then <SPAN
 108 CLASS="CITEREFENTRY"
 109 ><SPAN
 110 CLASS="REFENTRYTITLE"
 111 >smbd</SPAN
 112 >(8)</SPAN
 113 > should do so as well. </P
 114 ></DD
 115 ><DT
 116 >printcapname</DT
 117 ><DD
 118 ><P
 119 >This is the name of the printcap file within
 120                 which to search for the given printer name. </P
 121 ><P
 122 >If no printcap name is specified <B
 123 CLASS="COMMAND"
 124 >testprns
 125                 </B
 126 > will attempt to scan the printcap file name
 127                 specified at compile time. </P
 128 ></DD
 129 ></DL
 130 ></DIV
 131 ></DIV
 132 ><DIV
 133 CLASS="REFSECT1"
 134 ><A
 135 NAME="AEN44"
 136 ></A
 137 ><H2
 138 >FILES</H2
 139 ><P
 140 ></P
 141 ><DIV
 142 CLASS="VARIABLELIST"
 143 ><DL
 144 ><DT
 145 ><TT
 146 CLASS="FILENAME"
 147 >/etc/printcap</TT
 148 ></DT
 149 ><DD
 150 ><P
 151 >This is usually the default printcap
 152                 file to scan. See <TT
 153 CLASS="FILENAME"
 154 >printcap (5)</TT
 155 >.
 156                 </P
 157 ></DD
 158 ></DL
 159 ></DIV
 160 ></DIV
 161 ><DIV
 162 CLASS="REFSECT1"
 163 ><A
 164 NAME="AEN53"
 165 ></A
 166 ><H2
 167 >DIAGNOSTICS</H2
 168 ><P
 169 >If a printer is found to be valid, the message
 170         "Printer name &#60;printername&#62; is valid" will be
 171         displayed. </P
 172 ><P
 173 >If a printer is found to be invalid, the message
 174         "Printer name &#60;printername&#62; is not valid" will be
 175         displayed. </P
 176 ><P
 177 >All messages that would normally be logged during
 178         operation of the Samba daemons are logged by this program to the
 179         file <TT
 180 CLASS="FILENAME"
 181 >test.log</TT
 182 > in the current directory. The
 183         program runs at debuglevel 3, so quite extensive logging
 184         information is written. The log should be checked carefully
 185         for errors and warnings. </P
 186 ><P
 187 >Other messages are self-explanatory. </P
 188 ></DIV
 189 ><DIV
 190 CLASS="REFSECT1"
 191 ><A
 192 NAME="AEN60"
 193 ></A
 194 ><H2
 195 >VERSION</H2
 196 ><P
 197 >This man page is correct for version 2.2 of
 198         the Samba suite.</P
 199 ></DIV
 200 ><DIV
 201 CLASS="REFSECT1"
 202 ><A
 203 NAME="AEN63"
 204 ></A
 205 ><H2
 206 >SEE ALSO</H2
 207 ><P
 208 ><TT
 209 CLASS="FILENAME"
 210 >printcap(5)</TT
 211 >,
 212         <SPAN
 213 CLASS="CITEREFENTRY"
 214 ><SPAN
 215 CLASS="REFENTRYTITLE"
 216 >smbd</SPAN
 217 >(8)</SPAN
 218 >, <SPAN
 219 CLASS="CITEREFENTRY"
 220 ><SPAN
 221 CLASS="REFENTRYTITLE"
 222 >smbclient</SPAN
 223 >(1)</SPAN
 224 ></P
 225 ></DIV
 226 ><DIV
 227 CLASS="REFSECT1"
 228 ><A
 229 NAME="AEN73"
 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 <A
 242 HREF="ftp://ftp.icce.rug.nl/pub/unix/"
 243 TARGET="_top"
 244 >       ftp://ftp.icce.rug.nl/pub/unix/</A
 245 >) and updated for the Samba 2.0
 246         release by Jeremy Allison.  The conversion to DocBook for
 247         Samba 2.2 was done by Gerald Carter. The conversion to DocBook XML 4.2
 248         for Samba 3.0 was done by Alexander Bokovoy.</P
 249 ></DIV
 250 ></BODY
 251 ></HTML
 252 >