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


SYNOPSIS

       testparm [ -s ]  [ -h ]  [ -L <servername> ]  config file­
       name [ hostname hostIP ]


DESCRIPTION

       This tool is part of the  Sambasuite.

       testparm  is  a  very simple test program to check an smbd
       configuration file for internal correctness. If this  pro­
       gram  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 speci­
       fied in the configuration file will be available  or  will
       operate as expected.

       If  the  optional host name and host IP address are speci­
       fied on the command  line,  this  test  program  will  run
       through  the  service entries reporting whether the speci­
       fied 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

              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  con­
       figuration file loaded OK or not. This message may be pre­
       ceded 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,  avail­
       able           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


Man(1) output converted with man2html