*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->IRIX man pages -> testparm.1 (1)              
Title
Content
Arch
Section
 

Contents


     TESTPARM(1)     UNIX System V (19 November	2002)	   TESTPARM(1)



     NAME    [Toc]    [Back]
	  testparm - check an smb.conf configuration file for
	  internal correctness

     SYNOPSIS    [Toc]    [Back]
	  testparm [ -s	]  [ -h	]  [ -x	]  [ -L	<servername> ]	config
	  filename [ hostname hostIP ]

     DESCRIPTION    [Toc]    [Back]
	  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    [Toc]    [Back]
	  -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

	  -x   Print only parameters that have non-default values

	  -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



     Page 1					     (printed 2/13/04)






     TESTPARM(1)     UNIX System V (19 November	2002)	   TESTPARM(1)



	       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    [Toc]    [Back]
	  smb.conf
	       This is usually the name	of the configuration file used
	       by smbd.

     DIAGNOSTICS    [Toc]    [Back]
	  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    [Toc]    [Back]
	  This man page	is correct for version 2.2 of the Samba	suite.

     SEE ALSO    [Toc]    [Back]
	  smb.conf(5) smbd(8)

     AUTHOR    [Toc]    [Back]
	  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/
	  <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













     Page 2					     (printed 2/13/04)



[ Back ]
      
      
 Similar pages
Name OS Title
pw.conf FreeBSD format of the pw.conf configuration file
config Tru64 OpenSSL CONF library configuration files
authck HP-UX check internal consistency of Authentication database
checkdba Tru64 Check the JOIN IP address lease database for internal consistency
update-modules Linux (re)generate /etc/modules.conf and /etc/chandev.conf
tcpdchk HP-UX check tcp wrapper configuration
svcsetup Tru64 set up the svc.conf file
amconfig IRIX check or modify availmon configuration values
nss2svc Tru64 keep /etc/svc.conf in sync with /etc/nsswitch.conf
sshd-check-conf Tru64 Check what the configuration allows or denies based on incoming user and/or host name
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service