summaryrefslogtreecommitdiff
path: root/docs/manpages/testprns.1
diff options
context:
space:
mode:
Diffstat (limited to 'docs/manpages/testprns.1')
-rw-r--r--docs/manpages/testprns.1175
1 files changed, 89 insertions, 86 deletions
diff --git a/docs/manpages/testprns.1 b/docs/manpages/testprns.1
index a9753d7637..91738ebcfe 100644
--- a/docs/manpages/testprns.1
+++ b/docs/manpages/testprns.1
@@ -1,87 +1,90 @@
-.TH "testprns " "1" "23 Oct 1998" "Samba" "SAMBA"
-.PP
-.SH "NAME"
-testprns \- check printer name for validity with smbd
-.PP
-.SH "SYNOPSIS"
-.PP
-\fBtestprns\fP printername [printcapname]
-.PP
-.SH "DESCRIPTION"
-.PP
-This program is part of the \fBSamba\fP suite\&.
-.PP
-\fBtestprns\fP 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\fP\&.
-.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\&.
-.PP
-.SH "OPTIONS"
-.PP
-.IP
-.IP "\fBprintername\fP"
-The printer name to validate\&.
-.IP
-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\fP\&. However, if
-\fBtestprns\fP finds the printer then \fBsmbd\fP should
-do so as well\&.
-.IP
-.IP "\fBprintcapname\fP"
+.\" This manpage has been automatically generated by docbook2man-spec
+.\" from a DocBook document. docbook2man-spec can be found at:
+.\" <http://shell.ipoline.com/~elmert/hacks/docbook2X/>
+.\" Please send any bug reports, improvements, comments, patches,
+.\" etc. to Steve Cheng <steve@ggi-project.org>.
+.TH "TESTPRNS" "1" "22 February 2001" "" ""
+.SH NAME
+testprns \- check printer name for validity with smbd
+.SH SYNOPSIS
+.sp
+\fBtestprns\fR \fBprintername\fR [ \fBprintcapname\fR ]
+.SH "DESCRIPTION"
+.PP
+This tool is part of the Samba <URL:samba.7.html> 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 \fB smbd(8)\fR <URL:smbd.8.html>.
+.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.
+.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 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\&.
-.IP
-If no printcap name is specified \fBtestprns\fP will attempt to scan the
-printcap file name specified at compile time\&.
-.IP
-.PP
-.SH "FILES"
-.PP
-\fB/etc/printcap\fP This is usually the default printcap file to
-scan\&. See \fBprintcap (5)\fP\&.
-.PP
-.SH "DIAGNOSTICS"
-.PP
-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\&.
-.PP
-All messages that would normally be logged during operation of the
-\fBSamba\fP daemons are logged by this program to the
-file \f(CWtest\&.log\fP 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\&.
-.PP
-.SH "SEE ALSO"
-.PP
-\fBprintcap (5)\fP, \fBsmbd (8)\fP, \fBsmbclient
-(1)\fP
-.PP
-.SH "AUTHOR"
-.PP
-The original Samba software and related utilities were created by
-Andrew Tridgell samba@samba\&.org\&. 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
-\fBftp://ftp\&.icce\&.rug\&.nl/pub/unix/\fP)
-and updated for the Samba2\&.0 release by Jeremy Allison\&.
-samba@samba\&.org\&.
-.PP
-See \fBsamba (7)\fP to find out how to get a full
-list of contributors and details on how to submit bug reports,
-comments etc\&.
+which to search for the given printer name.
+
+If no printcap name is specified \fBtestprns
+\fRwill 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.
+.SH "DIAGNOSTICS"
+.PP
+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.
+.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.
+.PP
+Other messages are self-explanatory.
+.SH "VERSION"
+.PP
+This man page is correct for version 2.2 of
+the Samba suite.
+.SH "SEE ALSO"
+.PP
+\fIprintcap(5)\fR,
+\fBsmbd(8)\fR <URL:smbd.8.html>,
+\fBsmbclient(1)\fR <URL:smbclient.1.html>
+.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.
+.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