summaryrefslogtreecommitdiff
path: root/docs/manpages/testprns.1
diff options
context:
space:
mode:
authorAlexander Bokovoy <ab@samba.org>2003-04-30 22:52:23 +0000
committerAlexander Bokovoy <ab@samba.org>2003-04-30 22:52:23 +0000
commit94f33628d8251b614d47b75fd4fd19d1a9965ffa (patch)
tree227349f40958db9cd63c92fd247edef6da2e5434 /docs/manpages/testprns.1
parent721195f77b49e7c341970ad78834a71641ae9577 (diff)
downloadsamba-94f33628d8251b614d47b75fd4fd19d1a9965ffa.tar.gz
samba-94f33628d8251b614d47b75fd4fd19d1a9965ffa.tar.bz2
samba-94f33628d8251b614d47b75fd4fd19d1a9965ffa.zip
Rebuild docs
(This used to be commit 7cafdf9e9576f7988d72fccbc2fad3fbcd3c67df)
Diffstat (limited to 'docs/manpages/testprns.1')
-rw-r--r--docs/manpages/testprns.1134
1 files changed, 70 insertions, 64 deletions
diff --git a/docs/manpages/testprns.1 b/docs/manpages/testprns.1
index cb231510f5..9f98ea1d59 100644
--- a/docs/manpages/testprns.1
+++ b/docs/manpages/testprns.1
@@ -1,90 +1,96 @@
-.\" This manpage has been automatically generated by docbook2man
-.\" from a DocBook document. This tool can be found at:
-.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/>
-.\" Please send any bug reports, improvements, comments, patches,
-.\" etc. to Steve Cheng <steve@ggi-project.org>.
-.TH "TESTPRNS" "1" "19 april 2003" "" ""
-
+.\"Generated by db2man.xsl. Don't modify this, modify the source.
+.de Sh \" Subsection
+.br
+.if t .Sp
+.ne 5
+.PP
+\fB\\$1\fR
+.PP
+..
+.de Sp \" Vertical space (when we can't use .PP)
+.if t .sp .5v
+.if n .sp
+..
+.de Ip \" List item
+.br
+.ie \\n(.$>=3 .ne \\$3
+.el .ne 3
+.IP "\\$1" \\$2
+..
+.TH "TESTPRNS" 1 "" "" ""
.SH NAME
testprns \- check printer name for validity with smbd
-.SH SYNOPSIS
+.SH "SYNOPSIS"
-\fBtestprns\fR \fBprintername\fR [ \fBprintcapname\fR ]
+.nf
+\fBtestprns\fR {printername} [printcapname]
+.fi
.SH "DESCRIPTION"
+
.PP
-This tool is part of the \fBSamba\fR(7) suite.
+This tool is part of the \fBSamba\fR(7) suite\&.
+
.PP
-\fBtestprns\fR is a very simple test program
-to determine whether a given printer name is valid for use in
-a service to be provided by \fBsmbd\fR(8).
+\fBtestprns\fR is a very simple test program to determine whether a given printer name is valid for use in a service to be provided by \fBsmbd\fR(8)\&.
+
.PP
-"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.
+"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\&.
+
.SH "OPTIONS"
+
.TP
-\fBprintername\fR
-The printer name to validate.
-
-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 recognized.
-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 \fBtestprns\fR. However, if
-\fBtestprns\fR finds the printer then \fBsmbd\fR(8) should do so as well.
+printername
+The printer name to validate\&.
+
+
+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 recognized\&. 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 \fBtestprns\fR\&. However, if \fBtestprns\fR finds the printer then \fBsmbd\fR(8) should do so as well\&.
+
+
.TP
-\fBprintcapname\fR
-This is the name of the printcap file within
-which to search for the given printer name.
+printcapname
+This is the name of the printcap file within which to search for the given printer name\&.
+
+
+If no printcap name is specified \fBtestprns \fR will attempt to scan the printcap file name specified at compile time\&.
+
-If no printcap name is specified \fBtestprns
-\fR will attempt to scan the printcap file name
-specified at compile time.
.SH "FILES"
+
.TP
-\fB\fI/etc/printcap\fB\fR
-This is usually the default printcap
-file to scan. See \fIprintcap (5)\fR.
+\fI/etc/printcap\fR
+This is usually the default printcap file to scan\&. See \fIprintcap (5)\fR\&.
+
+
.SH "DIAGNOSTICS"
+
.PP
-If a printer is found to be valid, the message
-"Printer name <printername> is valid" will be
-displayed.
+If a printer is found to be valid, the message "Printer name <printername> is valid" will be displayed\&.
+
.PP
-If a printer is found to be invalid, the message
-"Printer name <printername> is not valid" will be
-displayed.
+If a printer is found to be invalid, the message "Printer name <printername> is not valid" will be displayed\&.
+
.PP
-All messages that would normally be logged during
-operation of the Samba daemons are logged by this program to the
-file \fItest.log\fR 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.
+All messages that would normally be logged during operation of the Samba daemons are logged by this program to the file \fItest\&.log\fR 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\&.
+
.PP
-Other messages are self-explanatory.
+Other messages are self-explanatory\&.
+
.SH "VERSION"
+
.PP
-This man page is correct for version 3.0 of
-the Samba suite.
+This man page is correct for version 3\&.0 of the Samba suite\&.
+
.SH "SEE ALSO"
+
.PP
-\fIprintcap(5)\fR,
-\fBsmbd\fR(8), \fBsmbclient\fR(1)
+\fIprintcap(5)\fR,\fBsmbd\fR(8), \fBsmbclient\fR(1)
+
.SH "AUTHOR"
+
.PP
-The original Samba software and related utilities
-were created by Andrew Tridgell. Samba is now developed
-by the Samba Team as an Open Source project similar
-to the way the Linux kernel is developed.
+The original Samba software and related utilities were created by Andrew Tridgell\&. Samba is now developed by the Samba Team as an Open Source project similar to the way the Linux kernel is developed\&.
+
.PP
-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, available at ftp://ftp.icce.rug.nl/pub/unix/ <URL:ftp://ftp.icce.rug.nl/pub/unix/>) and updated for the Samba 2.0
-release by Jeremy Allison. The conversion to DocBook for
-Samba 2.2 was done by Gerald Carter. The conversion to DocBook XML 4.2
-for Samba 3.0 was done by Alexander Bokovoy.
+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, available at ftp://ftp\&.icce\&.rug\&.nl/pub/unix/) and updated for the Samba 2\&.0 release by Jeremy Allison\&. The conversion to DocBook for Samba 2\&.2 was done by Gerald Carter\&. The conversion to DocBook XML 4\&.2 for Samba 3\&.0 was done by Alexander Bokovoy\&.
+