testparm

 

---

 TESTPARM(1)                                           TESTPARM(1)
 
 
 
NAME
        testparm - check an smb.conf configuration file for inter­
        nal correctness
 
 
SYNOPSIS
        testparm [-s] [-h] [-L servername] [configfilename] [host­
        name 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  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
               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  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.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 sim­
        ilar 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/) 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 con­
        tributors and details on how to submit bug  reports,  com­
        ments etc.
 
 
 
 testparm 2.0.10            23 Jun 2001                TESTPARM(1)

---