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 ++++++++++++++++++++++++++++++------------ 1 file changed, 291 insertions(+), 114 deletions(-) (limited to 'docs/htmldocs/testparm.1.html') 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 -- cgit