summaryrefslogtreecommitdiff
path: root/docs/htmldocs/testprns.1.html
diff options
context:
space:
mode:
Diffstat (limited to 'docs/htmldocs/testprns.1.html')
-rw-r--r--docs/htmldocs/testprns.1.html96
1 files changed, 96 insertions, 0 deletions
diff --git a/docs/htmldocs/testprns.1.html b/docs/htmldocs/testprns.1.html
new file mode 100644
index 0000000000..a457aa55f5
--- /dev/null
+++ b/docs/htmldocs/testprns.1.html
@@ -0,0 +1,96 @@
+
+
+
+
+
+<html><head><title>testparm</title>
+
+<link rev="made" href="mailto:samba-bugs@samba.anu.edu.au">
+</head>
+<body>
+
+<hr>
+
+<h1>testparm</h1>
+<h2>Samba</h2>
+<h2>23 Oct 1998</h2>
+
+
+
+
+<p><br><a name="NAME"></a>
+<h2>NAME</h2>
+ testparm - check printer name for validity with smbd
+<p><br><a name="SYNOPSIS"></a>
+<h2>SYNOPSIS</h2>
+
+<p><br><strong>testprns</strong> <a href="testprns.1.html#printername">printername</a> [<a href="testprns.1.html#printcapname">printcapname</a>]
+<p><br><a name="DESCRIPTION"></a>
+<h2>DESCRIPTION</h2>
+
+<p><br>This program is part of the <strong>Samba</strong> suite.
+<p><br><strong>testprns</strong> is a very simple test program to determine whether a
+given printer name is valid for use in a service to be provided by
+<a href="smbd.8.html"><strong>smbd</strong></a>.
+<p><br>"Valid" in this context means "can be found in the printcap
+specified". This program is very stupid - so stupid in fact that it
+would be wisest to always specify the printcap file to use.
+<p><br><a name="OPTIONS"></a>
+<h2>OPTIONS</h2>
+
+<p><br><ul>
+<p><br><a name="printername"></a>
+<li><strong><strong>printername</strong></strong> The printer name to validate.
+<p><br>Printer names are taken from the first field in each record in the
+printcap file, single printer names and sets of aliases separated by
+vertical bars ("|") are recognised. Note that no validation or
+checking of the printcap syntax is done beyond that required to
+extract the printer name. It may be that the print spooling system is
+more forgiving or less forgiving than <strong>testprns</strong>. However, if
+<strong>testprns</strong> finds the printer then <a href="smbd.8.html"><strong>smbd</strong></a> should
+do so as well.
+<p><br><a name="printcapname"></a>
+<li><strong><strong>printcapname</strong></strong> This is the name of the printcap file within
+which to search for the given printer name.
+<p><br>If no printcap name is specified <strong>testprns</strong> will attempt to scan the
+printcap file name specified at compile time.
+<p><br></ul>
+<p><br><a name="FILES"></a>
+<h2>FILES</h2>
+
+<p><br><strong>/etc/printcap</strong> This is usually the default printcap file to
+scan. See <strong>printcap (5)</strong>.
+<p><br><a name="DIAGNOSTICS"></a>
+<h2>DIAGNOSTICS</h2>
+
+<p><br>If a printer is found to be valid, the message "Printer name
+&lt;printername&gt; is valid" will be displayed.
+<p><br>If a printer is found to be invalid, the message "Printer name
+&lt;printername&gt; is not valid" will be displayed.
+<p><br>All messages that would normally be logged during operation of the
+<a href="samba.7.html"><strong>Samba</strong></a> daemons are logged by this program to the
+file <code>test.log</code> in the current directory. The program runs at
+debuglevel 3, so quite extensive logging information is written. The
+log should be checked carefully for errors and warnings.
+<p><br>Other messages are self-explanatory.
+<p><br><a name="SEEALSO"></a>
+<h2>SEE ALSO</h2>
+
+<p><br><strong>printcap (5)</strong>, <a href="smbd.8.html"><strong>smbd (8)</strong></a>, <a href="smbclient.1.html"><strong>smbclient
+(1)</strong></a>
+<p><br><a name="AUTHOR"></a>
+<h2>AUTHOR</h2>
+
+<p><br>The original Samba software and related utilities were created by
+Andrew Tridgell <a href="mailto:samba-bugs@samba.anu.edu.au"><em>samba-bugs@samba.anu.edu.au</em></a>. Samba is now developed
+by the Samba Team as an Open Source project similar to the way the
+Linux kernel is developed.
+<p><br>The original Samba man pages were written by Karl Auer. The man page
+sources were converted to YODL format (another excellent piece of Open
+Source software) and updated for the Samba2.0 release by Jeremy
+Allison, <a href="mailto:samba-bugs@samba.anu.edu.au"><em>samba-bugs@samba.anu.edu.au</em></a>.
+<p><br>See <a href="samba.7.html"><strong>samba (7)</strong></a> to find out how to get a full
+list of contributors and details on how to submit bug reports,
+comments etc.
+</body>
+</html>