From 8c098397f1946f1572dba30bd7f019d8b04bb9e5 Mon Sep 17 00:00:00 2001 From: Gerald Carter Date: Thu, 22 Feb 2001 22:49:43 +0000 Subject: make it stop...please, make it stop.... (This used to be commit 3d8f4113ebb178e2f8281edfce968d7035f443af) --- docs/docbook/manpages/testparm.1.sgml | 168 ++++++++++++++ docs/docbook/manpages/testprns.1.sgml | 143 ++++++++++++ docs/htmldocs/testparm.1.html | 405 ++++++++++++++++++++++++---------- docs/htmldocs/testprns.1.html | 350 +++++++++++++++++++++-------- docs/manpages/testparm.1 | 204 +++++++++-------- docs/manpages/testprns.1 | 175 +++++++-------- 6 files changed, 1043 insertions(+), 402 deletions(-) create mode 100644 docs/docbook/manpages/testparm.1.sgml create mode 100644 docs/docbook/manpages/testprns.1.sgml (limited to 'docs') diff --git a/docs/docbook/manpages/testparm.1.sgml b/docs/docbook/manpages/testparm.1.sgml new file mode 100644 index 0000000000..da90dc6e6c --- /dev/null +++ b/docs/docbook/manpages/testparm.1.sgml @@ -0,0 +1,168 @@ + + + + + testparm + 1 + + + + + testparm + check an smb.conf configuration file for + internal correctness + + + + + testparm + -s + -h + -L <servername> + config filename + hostname hostIP + + + + + DESCRIPTION + + This tool is part of the + Samba suite. + + testparm is a very simple test program + to check an smbd configuration file for + internal correctness. If this program reports no problems, you + can use the configuration file with confidence that smbd + will successfully load the configuration file. + + + Note that this is NOT a guarantee that + the services specified in the configuration file will be + available or will operate as expected. + + If the optional host name and host IP address are + specified on the command line, this test program will run through + the service entries reporting whether the specified host + has access to each service. + + If testparm finds an error in the + smb.conf file it returns an exit code of 1 to the calling + program, else it returns an exit code of 0. This allows shell scripts + to test the output from testparm. + + + + OPTIONS + + + + -s + Without this option, testparm + will prompt for a carriage return after printing the service + names and before dumping the service definitions. + + + + + -h + Print usage message + + + + + -L servername + Sets the value of the %L macro to servername. + This is useful for testing include files specified with the + %L macro. + + + + + configfilename + This is the name of the configuration file + to check. If this parameter is not present then the + default smb.conf file will be checked. + + + + + + hostname + If this parameter and the following are + specified, then testparm will examine the hosts + allow and hosts deny + parameters in the smb.conf file to + determine if the hostname with this IP address would be + allowed access to the smbd server. If + this parameter is supplied, the hostIP parameter must also + be supplied. + + + + + hostIP + This is the IP address of the host specified + in the previous parameter. This address must be supplied + if the hostname parameter is supplied. + + + + + + FILES + + + + smb.conf + This is usually the name of the configuration + file used by smbd. + + + + + + + DIAGNOSTICS + + The program will issue a message saying whether the + configuration file loaded OK or not. This message may be preceeded by + errors and warnings if the file did not load. If the file was + loaded OK, the program then dumps all known service details + to stdout. + + + + + VERSION + + This man page is correct for version 2.2 of + the Samba suite. + + + + SEE ALSO + smb.conf(5), + smbd(8) + + + + + AUTHOR + + 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 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 + + + + diff --git a/docs/docbook/manpages/testprns.1.sgml b/docs/docbook/manpages/testprns.1.sgml new file mode 100644 index 0000000000..cd99494a9a --- /dev/null +++ b/docs/docbook/manpages/testprns.1.sgml @@ -0,0 +1,143 @@ + + + + + testprns + 1 + + + + + testprns + check printer name for validity with smbd + + + + + testprns + printername + printcapname + + + + + DESCRIPTION + + This tool is part of the + Samba suite. + + testprns is a very simple test program + to determine whether a given printer name is valid for use in + a service to be provided by + smbd(8). + + "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. + + + + + + OPTIONS + + + + 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 testprns. However, if + testprns finds the printer then + smbd should do so as well. + + + + printcapname + This is the name of the printcap file within + which to search for the given printer name. + + If no printcap name is specified testprns + will attempt to scan the printcap file name + specified at compile time. + + + + + + + FILES + + + + /etc/printcap + This is usually the default printcap + file to scan. See printcap (5). + + + + + + + + DIAGNOSTICS + + 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 invalid, the message + "Printer name <printername> is not valid" will be + displayed. + + All messages that would normally be logged during + operation of the Samba daemons are logged by this program to the + file test.log 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. + + Other messages are self-explanatory. + + + + + VERSION + + This man page is correct for version 2.2 of + the Samba suite. + + + + SEE ALSO + printcap(5), + smbd(8), + smbclient(1) + + + + + AUTHOR + + 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 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 + + + + diff --git a/docs/htmldocs/testparm.1.html b/docs/htmldocs/testparm.1.html index 8babecbcfa..d1a1e4333a 100644 --- a/docs/htmldocs/testparm.1.html +++ b/docs/htmldocs/testparm.1.html @@ -1,114 +1,291 @@ - - - - - - -testparm (1) - - - - - -

- -

testparm (1)

Samba

23 Oct 1998

- - - -

NAME

- testparm - check an smb.conf configuration file for internal correctness -

SYNOPSIS

- -

testparm [-s] [-h] [-L servername] [configfilename] [hostname hostIP] -

DESCRIPTION

- -

This program is part of the Samba suite. -

testparm is a very simple test program to check an -smbd configuration file for internal -correctness. If this program reports no problems, you can use the -configuration file with confidence that smbd -will successfully load the configuration file. -

Note that this is NOT a guarantee that the services specified in the -configuration file will be available or will operate as expected. -

If the optional host name and host IP address are specified on the -command line, this test program will run through the service entries -reporting whether the specified host has access to each service. -

If testparm finds an error in the smb.conf -file it returns an exit code of 1 to the calling program, else it returns -an exit code of 0. This allows shell scripts to test the output from -testparm. -

OPTIONS

- -

-s

Without this option, testparm will prompt for a -carriage return after printing the service names and before dumping -the service definitions. -

-h

Print usage message -

-L servername

Sets the value of the %L macro to servername. This -is useful for testing include files specified with the %L macro. -

configfilename

This is the name of the configuration file to -check. If this parameter is not present then the default -smb.conf file will be checked. -

hostname

If this parameter and the following are specified, -then testparm will examine the "hosts -allow" and "hosts -deny" parameters in the -smb.conf file to determine if the hostname -with this IP address would be allowed access to the -smbd server. If this parameter is supplied, the -hostIP parameter must also be supplied. -

hostIP

This is the IP address of the host specified in the -previous parameter. This address must be supplied if the hostname -parameter is supplied. -

FILES

- -

smb.conf. This is usually the name of the -configuration file used by smbd. -

DIAGNOSTICS

- -

The program will issue a message saying whether the configuration file -loaded OK or not. This message may be preceded by errors and warnings -if the file did not load. If the file was loaded OK, the program then -dumps all known service details to stdout. -

VERSION

- -

This man page is correct for version 2.0 of the Samba suite. -

AUTHOR

- -

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. -

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 Samba2.0 release by Jeremy Allison. -samba@samba.org. -

See samba (7) to find out how to get a full -list of contributors and details on how to submit bug reports, -comments etc. - - +testparm

testparm

Name

testparm -- check an smb.conf configuration file for + internal correctness

Synopsis

testparm [-s] [-h] [-L <servername>] {config filename} [hostname hostIP]

DESCRIPTION

This tool is part of the Samba suite.

testparm is a very simple test program + to check an smbd configuration file for + internal correctness. If this program reports no problems, you + can use the configuration file with confidence that smbd + will successfully load the configuration file.

Note that this is NOT a guarantee that + the services specified in the configuration file will be + available or will operate as expected.

If the optional host name and host IP address are + specified on the command line, this test program will run through + the service entries reporting whether the specified host + has access to each service.

If testparm finds an error in the smb.conf file it returns an exit code of 1 to the calling + program, else it returns an exit code of 0. This allows shell scripts + to test the output from testparm.

OPTIONS

-s: Without this option, testparm + will prompt for a carriage return after printing the service + names and before dumping the service definitions.
-h: Print usage message
-L servername: Sets the value of the %L macro to servername. + This is useful for testing include files specified with the + %L macro.
configfilename: This is the name of the configuration file + to check. If this parameter is not present then the + default smb.conf file will be checked. +
hostname: If this parameter and the following are + specified, then testparm will examine the hosts + allow and hosts deny + parameters in the smb.conf file to + determine if the hostname with this IP address would be + allowed access to the smbd server. If + this parameter is supplied, the hostIP parameter must also + be supplied.
hostIP: This is the IP address of the host specified + in the previous parameter. This address must be supplied + if the hostname parameter is supplied.

FILES

smb.conf: This is usually the name of the configuration + file used by smbd. +

DIAGNOSTICS

The program will issue a message saying whether the + configuration file loaded OK or not. This message may be preceeded by + errors and warnings if the file did not load. If the file was + loaded OK, the program then dumps all known service details + to stdout.

VERSION

This man page is correct for version 2.2 of + the Samba suite.

AUTHOR

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 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

\ No newline at end of file diff --git a/docs/htmldocs/testprns.1.html b/docs/htmldocs/testprns.1.html index 42f5aebe74..94ab41c98d 100644 --- a/docs/htmldocs/testprns.1.html +++ b/docs/htmldocs/testprns.1.html @@ -1,98 +1,252 @@ - - - - - - -testprns (1) - - - - - -

- -

testprns (1)

Samba

23 Oct 1998

- - - -

NAME

- testprns - check printer name for validity with smbd -

SYNOPSIS

- -

testprns printername [printcapname] -

DESCRIPTION

- -

This program is part of the Samba suite. -

testprns is a very simple test program to determine whether a -given printer name is valid for use in a service to be provided by -smbd. -

"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. -

OPTIONS

- -

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 testprns. However, if -testprns finds the printer then smbd should -do so as well. -

printcapname

This is the name of the printcap file within -which to search for the given printer name. -

If no printcap name is specified testprns will attempt to scan the -printcap file name specified at compile time. -

FILES

- -

/etc/printcap This is usually the default printcap file to -scan. See printcap (5). -

DIAGNOSTICS

- -

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 invalid, the message "Printer name -<printername> is not valid" will be displayed. -

All messages that would normally be logged during operation of the -Samba daemons are logged by this program to the -file test.log 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. -

Other messages are self-explanatory. -

AUTHOR

- -

See samba (7) to find out how to get a full -list of contributors and details on how to submit bug reports, -comments etc. - - +testprns

testprns

Name

testprns -- check printer name for validity with smbd

Synopsis

testprns {printername} [printcapname]

DESCRIPTION

This tool is part of the Samba suite.

testprns is a very simple test program + to determine whether a given printer name is valid for use in + a service to be provided by smbd(8).

"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.

OPTIONS

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 testprns. However, if + testprns finds the printer then + smbd should do so as well.

printcapname

This is the name of the printcap file within + which to search for the given printer name.

If no printcap name is specified testprns + will attempt to scan the printcap file name + specified at compile time.

FILES

/etc/printcap: This is usually the default printcap + file to scan. See printcap (5). +

DIAGNOSTICS

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 invalid, the message + "Printer name <printername> is not valid" will be + displayed.

All messages that would normally be logged during + operation of the Samba daemons are logged by this program to the + file test.log 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.

Other messages are self-explanatory.

VERSION

This man page is correct for version 2.2 of + the Samba suite.

AUTHOR

\ No newline at end of file diff --git a/docs/manpages/testparm.1 b/docs/manpages/testparm.1 index e02b887394..a5aa932aa1 100644 --- a/docs/manpages/testparm.1 +++ b/docs/manpages/testparm.1 @@ -1,104 +1,100 @@ -.TH "testparm " "1" "23 Oct 1998" "Samba" "SAMBA" -.PP -.SH "NAME" -testparm \- check an smb\&.conf configuration file for internal correctness -.PP -.SH "SYNOPSIS" -.PP -\fBtestparm\fP [-s] [-h] [-L servername] [configfilename] [hostname hostIP] -.PP -.SH "DESCRIPTION" -.PP -This program is part of the \fBSamba\fP suite\&. -.PP -\fBtestparm\fP is a very simple test program to check an -\fBsmbd\fP configuration file for internal -correctness\&. If this program reports no problems, you can use the -configuration file with confidence that \fBsmbd\fP -will successfully load the configuration file\&. -.PP -Note that this is \fINOT\fP a guarantee that the services specified in the -configuration file will be available or will operate as expected\&. -.PP -If the optional host name and host IP address are specified on the -command line, this test program will run through the service entries -reporting whether the specified host has access to each service\&. -.PP -If \fBtestparm\fP finds an error in the \fBsmb\&.conf\fP -file it returns an exit code of 1 to the calling program, else it returns -an exit code of 0\&. This allows shell scripts to test the output from -\fBtestparm\fP\&. -.PP -.SH "OPTIONS" -.PP -.IP -.IP "\fB-s\fP" -Without this option, \fBtestparm\fP will prompt for a -carriage return after printing the service names and before dumping -the service definitions\&. -.IP -.IP "\fB-h\fP" -Print usage message -.IP -.IP "\fB-L servername\fP" -Sets the value of the %L macro to servername\&. This -is useful for testing include files specified with the %L macro\&. -.IP -.IP "\fBconfigfilename\fP" -This is the name of the configuration file to -check\&. If this parameter is not present then the default -\fBsmb\&.conf\fP file will be checked\&. -.IP -.IP "\fBhostname\fP" -If this parameter and the following are specified, -then testparm will examine the \fB"hosts -allow"\fP and \fB"hosts -deny"\fP parameters in the -\fBsmb\&.conf\fP file to determine if the hostname -with this IP address would be allowed access to the -\fBsmbd\fP server\&. If this parameter is supplied, the -hostIP parameter must also be supplied\&. -.IP -.IP "\fBhostIP\fP" -This is the IP address of the host specified in the -previous parameter\&. This address must be supplied if the hostname -parameter is supplied\&. -.IP -.PP -.SH "FILES" -.PP -\fBsmb\&.conf\fP\&. This is usually the name of the -configuration file used by \fBsmbd\fP\&. -.PP -.SH "DIAGNOSTICS" -.PP -The program will issue a message saying whether the configuration file -loaded OK or not\&. This message may be preceded by errors and warnings -if the file did not load\&. If the file was loaded OK, the program then -dumps all known service details to stdout\&. -.PP -.SH "VERSION" -.PP -This man page is correct for version 2\&.0 of the Samba suite\&. -.PP -.SH "SEE ALSO" -.PP -\fBsmb\&.conf (5)\fP, \fBsmbd (8)\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\&. +.\" This manpage has been automatically generated by docbook2man-spec +.\" from a DocBook document. docbook2man-spec can be found at: +.\" +.\" Please send any bug reports, improvements, comments, patches, +.\" etc. to Steve Cheng . +.TH "TESTPARM" "1" "22 February 2001" "" "" +.SH NAME +testparm \- check an smb.conf configuration file for internal correctness +.SH SYNOPSIS +.sp +\fBtestparm\fR [ \fB-s\fR ] [ \fB-h\fR ] [ \fB-L \fR ] \fBconfig filename\fR [ \fBhostname hostIP\fR ] +.SH "DESCRIPTION" +.PP +This tool is part of the Samba suite. +.PP +\fBtestparm\fR is a very simple test program +to check an \fBsmbd\fR configuration file for +internal correctness. If this program reports no problems, you +can use the configuration file with confidence that \fBsmbd +\fRwill successfully load the configuration file. +.PP +Note that this is \fBNOT\fR a guarantee that +the services specified in the configuration file will be +available or will operate as expected. +.PP +If the optional host name and host IP address are +specified on the command line, this test program will run through +the service entries reporting whether the specified host +has access to each service. +.PP +If \fBtestparm\fR finds an error in the \fI smb.conf\fR file it returns an exit code of 1 to the calling +program, else it returns an exit code of 0. This allows shell scripts +to test the output from \fBtestparm\fR. +.SH "OPTIONS" +.TP +\fB-s\fR +Without this option, \fBtestparm\fR +will prompt for a carriage return after printing the service +names and before dumping the service definitions. +.TP +\fB-h\fR +Print usage message +.TP +\fB-L servername\fR +Sets the value of the %L macro to servername. +This is useful for testing include files specified with the +%L macro. +.TP +\fBconfigfilename\fR +This is the name of the configuration file +to check. If this parameter is not present then the +default \fIsmb.conf\fR file will be checked. +.TP +\fBhostname\fR +If this parameter and the following are +specified, then testparm will examine the \fIhosts +allow\fR and \fIhosts deny\fR +parameters in the \fIsmb.conf\fR file to +determine if the hostname with this IP address would be +allowed access to the \fBsmbd\fR server. If +this parameter is supplied, the hostIP parameter must also +be supplied. +.TP +\fBhostIP\fR +This is the IP address of the host specified +in the previous parameter. This address must be supplied +if the hostname parameter is supplied. +.SH "FILES" +.TP +\fB\fIsmb.conf\fB\fR +This is usually the name of the configuration +file used by \fBsmbd\fR. +.SH "DIAGNOSTICS" +.PP +The program will issue a message saying whether the +configuration file loaded OK or not. This message may be preceeded by +errors and warnings if the file did not load. If the file was +loaded OK, the program then dumps all known service details +to stdout. +.SH "VERSION" +.PP +This man page is correct for version 2.2 of +the Samba suite. +.SH "SEE ALSO" +.PP +\fIsmb.conf(5)\fR , +\fBsmbd(8)\fR +.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/ ) and updated for the Samba 2.0 +release by Jeremy Allison. The conversion to DocBook for +Samba 2.2 was done by Gerald Carter 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: +.\" +.\" Please send any bug reports, improvements, comments, patches, +.\" etc. to Steve Cheng . +.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 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 . +.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 - is valid" will be displayed\&. -.PP -If a printer is found to be invalid, the message "Printer name - 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 is valid" will be +displayed. +.PP +If a printer is found to be invalid, the message +"Printer name 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 , +\fBsmbclient(1)\fR +.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/ ) and updated for the Samba 2.0 +release by Jeremy Allison. The conversion to DocBook for +Samba 2.2 was done by Gerald Carter -- cgit