testparm man page on JazzOS

Man page or keyword search:  
man Server   2339 pages
apropos Keyword Search (all sections)
Output format
JazzOS logo
[printable version]

TESTPARM(1)							   TESTPARM(1)

       testparm	 -  check an smb.conf configuration file for internal correct‐

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

       This tool is part of the samba(7) suite.

       testparm	 is  a very simple test program to check an smbd(8) configura‐
       tion file for internal correctness. If this program  reports  no	 prob‐
       lems,  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 com‐
       mand line, this test program will run through the service  entries  re‐
       porting 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.

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

	      Print a summary of command line options.

       -V     Prints the program version number.

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

       -v     If this option is specified, testparm will also output  all  op‐
	      tions  that  were	 not  used  in smb.conf(5) and are thus set to
	      their defaults.

       -t encoding
	      Output data in specified encoding.

	      This is the name of the configuration file to check. If this pa‐
	      rameter is not present then the default smb.conf(5) file will be

	      If this parameter and the following are specified, then testparm
	      will  examine  the  hosts allow and hosts deny parameters in the
	      smb.conf(5) file to determine if the hostname with this  IP  ad‐
	      dress would be allowed access to the smbd server. If this param‐
	      eter is supplied, the hostIP parameter must also be supplied.

       hostIP This is the IP address of the host specified in the previous pa‐
	      rameter. This address must be supplied if the hostname parameter
	      is supplied.

	      This is usually the name	of  the	 configuration	file  used  by

       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.

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

       smb.conf(5), smbd(8)

       The original Samba software and related utilities were created  by  An‐
       drew  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  up‐
       dated  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 Doc‐
       Book XML 4.2 for Samba 3.0 was done by Alexander Bokovoy.


List of man pages available for JazzOS

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
Vote for polarhome
Free Shell Accounts :: the biggest list on the net