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/htmldocs/testparm.1.html | 405 ++++++++++++++++++++++++++++++------------ docs/htmldocs/testprns.1.html | 350 ++++++++++++++++++++++++++---------- 2 files changed, 543 insertions(+), 212 deletions(-) (limited to 'docs/htmldocs') 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. -

-

SEE ALSO

- -

smb.conf (5), smbd (8) -

-

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.

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

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

-

SEE ALSO

- -

printcap (5), smbd (8), smbclient -(1) -

-

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

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

\ No newline at end of file -- cgit