smb.conf (5)

Samba

23 Oct 1998


NAME

smb.conf - The configuration file for the Samba suite


SYNOPSIS


smb.conf The smb.conf file is a configuration file for the Samba suite. smb.conf contains runtime configuration information for the Samba programs. The smb.conf file is designed to be configured and administered by the swat (8) program. The complete description of the file format and possible parameters held within are here for reference purposes.


FILE FORMAT


The file consists of sections and parameters. A section begins with the name of the section in square brackets and continues until the next section begins. Sections contain parameters of the form


'name = value'


The file is line-based - that is, each newline-terminated line represents either a comment, a section name or a parameter.


Section and parameter names are not case sensitive.


Only the first equals sign in a parameter is significant. Whitespace before or after the first equals sign is discarded. Leading, trailing and internal whitespace in section and parameter names is irrelevant. Leading and trailing whitespace in a parameter value is discarded. Internal whitespace within a parameter value is retained verbatim.


Any line beginning with a semicolon (';') or a hash ('#') character is ignored, as are lines containing only whitespace.


Any line ending in a '\' is "continued" on the next line in the customary UNIX fashion.


The values following the equals sign in parameters are all either a string (no quotes needed) or a boolean, which may be given as yes/no, 0/1 or true/false. Case is not significant in boolean values, but is preserved in string values. Some items such as create modes are numeric.


SECTION DESCRIPTIONS


Each section in the configuration file (except for the [global] section) describes a shared resource (known as a "share"). The section name is the name of the shared resource and the parameters within the section define the shares attributes.


There are three special sections, [global], [homes] and [printers], which are described under 'special sections'. The is preserup is to send the query to the broadcast address of the primary network interface as either auto-detected or defined in the interfaces parameter of the smb.conf (5) file.


  • -U unicast address Do a unicast query to the specified address or host "unicast address". This option (along with the -R option) is needed to query a WINS server.


  • -d debuglevel debuglevel is an integer from 0 to 10.


    The default value if this parameter is not specified is zero.


    The higher this value, the more detail will be logged about the activities of nmblookup. At level 0, only critical errors and serious warnings will be logged.


    Levels above 1 will generate considerable amounts of log data, and should only be used when investigating a problem. Levels above 3 are designed for use only by developers and generate HUGE amounts of data, most of which is extremely cryptic.


    Note that specifying this parameter here will override the log level parameter in the smb.conf (5) file.


  • -s smb.conf This parameter specifies the pathname to the Samba configuration file, smb.conf. This file controls all aspects of the Samba setup on the machine.


  • -i scope This specifies a NetBIOS scope that nmblookup will use to communicate with when generating NetBIOS names. For details on the use of NetBIOS scopes, see rfc1001.txt and rfc1002.txt. NetBIOS scopes are very rarely used, only set this parameter if you are the system administrator in charge of all the NetBIOS systems you communicate with.


  • -T This causes any IP addresses found in the lookup to be looked up via a reverse DNS lookup into a DNS name, and printed out before each "IP address NetBIOS name" pair that is the normal output.


  • name This is the NetBIOS name being queried. Depending upon the previous options this may be a NetBIOS name or IP address. If a NetBIOS name then the different name types may be specified by appending #<type> to the name. This name may also be "*", which will return all registered names within a broadcast area.



    EXAMPLES


    nmblookup can be used to query a WINS server (in the same way nslookup is used to query DNS servers). To query a WINS server, nmblookup must be called like this:


    nmblookup -U server -R 'name'


    For example, running :


    nmblookup -U samba.org -R IRIX#1B'


    would query the WINS server samba.org for the domain master browser (1B name type) for the IRIX workgroup.


    VERSION


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


    SEE ALSO


    samba (7), nmbd (8), smb.conf (5)


    AUTHOR


    The original Samba software and related utilities were created by Andrew Tridgell samba-bugs@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-bugs@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.


    usr/lib/samba/swat/help/samba.7.html100644 0 0 16100 6750314400 15640 0ustar rootroot Samba (7)


    Samba (7)

    Samba

    23 Oct 1998


    NAME

    Samba - A Windows SMB/CIFS fileserver for UNIX


    SYNOPSIS

    Samba


    DESCRIPTION


    The Samba software suite is a collection of programs that implements the Server Message Block(commonly abbreviated as SMB) protocol for UNIX systems. This protocol is sometimes also referred to as the Common Internet File System (CIFS), LanManager or NetBIOS protocol.


    COMPONENTS


    The Samba suite is made up of several components. Each component is described in a separate manual page. It is strongly recommended that you read the documentation that comes with Samba and the manual pages of those components that you use. If the manual pages aren't clear enough then please send a patch or bug report to samba-bugs@samba.org.



    AVAILABILITY


    The Samba software suite is licensed under the GNU Public License (GPL). A copy of that license should have come with the package in the file COPYING. You are encouraged to distribute copies of the Samba suite, but please obey the terms of this license.


    The latest version of the Samba suite can be obtained via anonymous ftp from samba.org in the directory pub/samba/. It is also available on several mirror sites worldwide.


    You may also find useful information about Samba on the newsgroup comp.protocols.smb and the Samba mailing list. Details on how to join the mailing list are given in the README file that comes with Samba.


    If you have access to a WWW viewer (such as Netscape or Mosaic) then you will also find lots of useful information, including back issues of the Samba mailing list, at http://samba.org/samba/.


    VERSION


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


    CONTRIBUTIONS


    If you wish to contribute to the Samba project, then I suggest you join the Samba mailing list at samba@samba.org. See the Web page at http://samba.org/listproc for details on how to do this.


    If you have patches to submit or bugs to report then you may mail them directly to samba-bugs@samba.org. Note, however, that due to the enormous popularity of this package the Samba Team may take some time to respond to mail. We prefer patches in diff -u format.


    CREDITS


    Contributors to the project are now too numerous to mention here but all deserve the thanks of all Samba users. To see a full list, look at ftp://samba.org/pub/samba/alpha/change-log for the pre-CVS changes and at ftp://samba.org/pub/samba/alpha/cvs.log for the contributors to Samba post-CVS. CVS is the Open Source source code control system used by the Samba Team to develop Samba. The project would have been unmanageable without it.


    In addition, several commercial organizations now help fund the Samba Team with money and equipment. For details see the Samba Web pages at http://samba.org/samba/samba-thanks.html.


    AUTHOR


    The original Samba software and related utilities were created by Andrew Tridgell samba-bugs@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-bugs@samba.org. usr/lib/samba/swat/help/smb.conf.5.html100644 0 0 1060307 6750314401 16332 0ustar rootroot smb.conf (5)


    smb.conf (5)

    Samba

    23 Oct 1998


    NAME

    smb.conf - The configuration file for the Samba suite


    SYNOPSIS


    smb.conf The smb.conf file is a configuration file for the Samba suite. smb.conf contains runtime configuration information for the Samba programs. The smb.conf file is designed to be configured and administered by the swat (8) program. The complete description of the file format and possible parameters held within are here for reference purposes.


    FILE FORMAT


    The file consists of sections and parameters. A section begins with the name of the section in square brackets and continues until the next section begins. Sections contain parameters of the form


    'name = value'


    The file is line-based - that is, each newline-terminated line represents either a comment, a section name or a parameter.


    Section and parameter names are not case sensitive.


    Only the first equals sign in a parameter is significant. Whitespace before or after the first equals sign is discarded. Leading, trailing and internal whitespace in section and parameter names is irrelevant. Leading and trailing whitespace in a parameter value is discarded. Internal whitespace within a parameter value is retained verbatim.


    Any line beginning with a semicolon (';') or a hash ('#') character is ignored, as are lines containing only whitespace.


    Any line ending in a '\' is "continued" on the next line in the customary UNIX fashion.


    The values following the equals sign in parameters are all either a string (no quotes needed) or a boolean, which may be given as yes/no, 0/1 or true/false. Case is not significant in boolean values, but is preserved in string values. Some items such as create modes are numeric.


    SECTION DESCRIPTIONS


    Each section in the configuration file (except for the [global] section) describes a shared resource (known as a "share"). The section name is the name of the shared resource and the parameters within the section define the shares attributes.


    There are three special sections, [global], [homes] and [printers], which are described under 'special sections'. The is preserup is to send the query to the broadcast address of the primary network interface as either auto-detected or defined in the interfaces parameter of the smb.conf (5) file.


  • -U unicast address Do a unicast query to the specified address or host "unicast address". This option (along with the -R option) is needed to query a WINS server.


  • -d debuglevel debuglevel is an integer from 0 to 10.


    The default value if this parameter is not specified is zero.


    The higher this value, the more detail will be logged about the activities of nmblookup. At level 0, only critical errors and serious warnings will be logged.


    Levels above 1 will generate considerable amounts of log data, and should only be used when investigating a problem. Levels above 3 are designed for use only by developers and generate HUGE amounts of data, most of which is extremely cryptic.


    Note that specifying this parameter here will override the log level parameter in the smb.conf (5) file.


  • -s smb.conf This parameter specifies the pathname to the Samba configuration file, smb.conf. This file controls all aspects of the Samba setup on the machine.


  • -i scope This specifies a NetBIOS scope that nmblookup will use to communicate with when generating NetBIOS names. For details on the use of NetBIOS scopes, see rfc1001.txt and rfc1002.txt. NetBIOS scopes are very rarely used, only set this parameter if you are the system administrator in charge of all the NetBIOS systems you communicate with.


  • -T This causes any IP addresses found in the lookup to be looked up via a reverse DNS lookup into a DNS name, and printed out before each "IP address NetBIOS name" pair that is the normal output.


  • name This is the NetBIOS name being queried. Depending upon the previous options this may be a NetBIOS name or IP address. If a NetBIOS name then the different name types may be specified by appending #<type> to the name. This name may also be "*", which will return all registered names within a broadcast area.



    EXAMPLES


    nmblookup can be used to query a WINS server (in the same way nslookup is used to query DNS servers). To query a WINS server, nmblookup must be called like this:


    nmblookup -U server -R 'name'


    For example, running :


    nmblookup -U samba.org -R IRIX#1B'


    would query the WINS server samba.org for the domain master browser (1B name type) for the IRIX workgroup.


    VERSION


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


    SEE ALSO


    samba (7), nmbd (8), smb.conf (5)


    AUTHOR


    The original Samba software and related utilities were created by Andrew Tridgell samba-bugs@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-bugs@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.


    usr/lib/samba/swat/help/samba.7.html100644 0 0 16100 6750314400 15640 0ustar rootroot Samba (7)


    Samba (7)

    Samba

    23 Oct 1998


    NAME

    Samba - A Windows SMB/CIFS fileserver for UNIX


    SYNOPSIS

    Samba


    DESCRIPTION


    The Samba software suite is a collection of programs that implements the Server Message Block(commonly abbreviated as SMB) protocol for UNIX systems. This protocol is sometimes also referred to as the Common Internet File System (CIFS), LanManager or NetBIOS protocol.


    COMPONENTS


    The Samba suite is made up of several components. Each component is described in a separate manual page. It is strongly recommended that you read the documentation that comes with Samba and the manual pages of those components that you use. If the manual pages aren't clear enough then please send a patch or bug report to samba-bugs@samba.org.



    AVAILABILITY


    The Samba software suite is licensed under the GNU Public License (GPL). A copy of that license should have come with the package in the file COPYING. You are encouraged to distribute copies of the Samba suite, but please obey the terms of this license.


    The latest version of the Samba suite can be obtained via anonymous ftp from samba.org in the directory pub/samba/. It is also available on several mirror sites worldwide.


    You may also find useful information about Samba on the newsgroup comp.protocols.smb and the Samba mailing list. Details on how to join the mailing list are given in the README file that comes with Samba.


    If you have access to a WWW viewer (such as Netscape or Mosaic) then you will also find lots of useful information, including back issues of the Samba mailing list, at http://samba.org/samba/.


    VERSION


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


    CONTRIBUTIONS


    If you wish to contribute to the Samba project, then I suggest you join the Samba mailing list at samba@samba.org. See the Web page at http://samba.org/listproc for details on how to do this.


    If you have patches to submit or bugs to report then you may mail them directly to samba-bugs@samba.org. Note, however, that due to the enormous popularity of this package the Samba Team may take some time to respond to mail. We prefer patches in diff -u format.


    CREDITS


    Contributors to the project are now too numerous to mention here but all deserve the thanks of all Samba users. To see a full list, look at ftp://samba.org/pub/samba/alpha/change-log for the pre-CVS changes and at ftp://samba.org/pub/samba/alpha/cvs.log for the contributors to Samba post-CVS. CVS is the Open Source source code control system used by the Samba Team to develop Samba. The project would have been unmanageable without it.


    In addition, several commercial organizations now help fund the Samba Team with money and equipment. For details see the Samba Web pages at http://samba.org/samba/samba-thanks.html.


    AUTHOR


    The original Samba software and related utilities were created by Andrew Tridgell samba-bugs@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-bugs@samba.org. usr/lib/samba/swat/help/smb.conf.5.html100644 0 0 1060307 6750314401 16332 0ustar rootroot smb.conf (5)


    smb.conf (5)

    Samba

    23 Oct 1998


    NAME

    smb.conf - The configuration file for the Samba suite


    SYNOPSIS


    smb.conf The smb.conf file is a configuration file for the Samba suite. smb.conf contains runtime configuration information for the Samba programs. The smb.conf file is designed to be configured and administered by the swat (8) program. The complete description of the file format and possible parameters held within are here for reference purposes.


    FILE FORMAT


    The file consists of sections and parameters. A section begins with the name of the section in square brackets and continues until the next section begins. Sections contain parameters of the form


    'name = value'


    The file is line-based - that is, each newline-terminated line represents either a comment, a section name or a parameter.


    Section and parameter names are not case sensitive.


    Only the first equals sign in a parameter is significant. Whitespace before or after the first equals sign is discarded. Leading, trailing and internal whitespace in section and parameter names is irrelevant. Leading and trailing whitespace in a parameter value is discarded. Internal whitespace within a parameter value is retained verbatim.


    Any line beginning with a semicolon (';') or a hash ('#') character is ignored, as are lines containing only whitespace.


    Any line ending in a '\' is "continued" on the next line in the customary UNIX fashion.


    The values following the equals sign in parameters are all either a string (no quotes needed) or a boolean, which may be given as yes/no, 0/1 or true/false. Case is not significant in boolean values, but is preserved in string values. Some items such as create modes are numeric.


    SECTION DESCRIPTIONS


    Each section in the configuration file (except for the [global] section) describes a shared resource (known as a "share"). The section name is the name of the shared resource and the parameters within the section define the shares attributes.


    There are three special sections, [global], [homes] and [printers], which are described under 'special sections'. The is preserup is to send the query to the broadcast address of the primary network interface as either auto-detected or defined in the interfaces parameter of the smb.conf (5) file.


  • -U unicast address Do a unicast query to the specified address or host "unicast address". This option (along with the -R option) is needed to query a WINS server.


  • -d debuglevel debuglevel is an integer from 0 to 10.


    The default value if this parameter is not specified is zero.


    The higher this value, the more detail will be logged about the activities of nmblookup. At level 0, only critical errors and serious warnings will be logged.


    Levels above 1 will generate considerable amounts of log data, and should only be used when investigating a problem. Levels above 3 are designed for use only by developers and generate HUGE amounts of data, most of which is extremely cryptic.


    Note that specifying this parameter here will override the log level parameter in the smb.conf (5) file.


  • -s smb.conf This parameter specifies the pathname to the Samba configuration file, smb.conf. This file controls all aspects of the Samba setup on the machine.


  • -i scope This specifies a NetBIOS scope that nmblookup will use to communicate with when generating NetBIOS names. For details on the use of NetBIOS scopes, see rfc1001.txt and rfc1002.txt. NetBIOS scopes are very rarely used, only set this parameter if you are the system administrator in charge of all the NetBIOS systems you communicate with.


  • -T This causes any IP addresses found in the lookup to be looked up via a reverse DNS lookup into a DNS name, and printed out before each "IP address NetBIOS name" pair that is the normal output.


  • name This is the NetBIOS name being queried. Depending upon the previous options this may be a NetBIOS name or IP address. If a NetBIOS name then the different name types may be specified by appending #<type> to the name. This name may also be "*", which will return all registered names within a broadcast area.



    EXAMPLES


    nmblookup can be used to query a WINS server (in the same way nslookup is used to query DNS servers). To query a WINS server, nmblookup must be called like this:


    nmblookup -U server -R 'name'


    For example, running :


    nmblookup -U samba.org -R IRIX#1B'


    would query the WINS server samba.org for the domain master browser (1B name type) for the IRIX workgroup.


    VERSION


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


    SEE ALSO


    samba (7), nmbd (8), smb.conf (5)


    AUTHOR


    The original Samba software and related utilities were created by Andrew Tridgell samba-bugs@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-bugs@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.


    usr/lib/samba/swat/help/samba.7.html100644 0 0 16100 6750314400 15640 0ustar rootroot Samba (7)


    Samba (7)

    Samba

    23 Oct 1998


    NAME

    Samba - A Windows SMB/CIFS fileserver for UNIX


    SYNOPSIS

    Samba


    DESCRIPTION


    The Samba software suite is a collection of programs that implements the Server Message Block(commonly abbreviated as SMB) protocol for UNIX systems. This protocol is sometimes also referred to as the Common Internet File System (CIFS), LanManager or NetBIOS protocol.


    COMPONENTS


    The Samba suite is made up of several components. Each component is described in a separate manual page. It is strongly recommended that you read the documentation that comes with Samba and the manual pages of those components that you use. If the manual pages aren't clear enough then please send a patch or bug report to samba-bugs@samba.org.



    AVAILABILITY


    The Samba software suite is licensed under the GNU Public License (GPL). A copy of that license should have come with the package in the file COPYING. You are encouraged to distribute copies of the Samba suite, but please obey the terms of this license.


    The latest version of the Samba suite can be obtained via anonymous ftp from samba.org in the directory pub/samba/. It is also available on several mirror sites worldwide.


    You may also find useful information about Samba on the newsgroup comp.protocols.smb and the Samba mailing list. Details on how to join the mailing list are given in the README file that comes with Samba.


    If you have access to a WWW viewer (such as Netscape or Mosaic) then you will also find lots of useful information, including back issues of the Samba mailing list, at http://samba.org/samba/.


    VERSION


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


    CONTRIBUTIONS


    If you wish to contribute to the Samba project, then I suggest you join the Samba mailing list at samba@samba.org. See the Web page at http://samba.org/listproc for details on how to do this.


    If you have patches to submit or bugs to report then you may mail them directly to samba-bugs@samba.org. Note, however, that due to the enormous popularity of this package the Samba Team may take some time to respond to mail. We prefer patches in diff -u format.


    CREDITS


    Contributors to the project are now too numerous to mention here but all deserve the thanks of all Samba users. To see a full list, look at ftp://samba.org/pub/samba/alpha/change-log for the pre-CVS changes and at ftp://samba.org/pub/samba/alpha/cvs.log for the contributors to Samba post-CVS. CVS is the Open Source source code control system used by the Samba Team to develop Samba. The project would have been unmanageable without it.


    In addition, several commercial organizations now help fund the Samba Team with money and equipment. For details see the Samba Web pages at http://samba.org/samba/samba-thanks.html.


    AUTHOR


    The original Samba software and related utilities were created by Andrew Tridgell samba-bugs@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-bugs@samba.org. usr/lib/samba/swat/help/smb.conf.5.html100644 0 0 1060307 6750314401 16332 0ustar rootroot smb.conf (5)


    smb.conf (5)

    Samba

    23 Oct 1998


    NAME

    smb.conf - The configuration file for the Samba suite


    SYNOPSIS


    smb.conf The smb.conf file is a configuration file for the Samba suite. smb.conf contains runtime configuration information for the Samba programs. The smb.conf file is designed to be configured and administered by the swat (8) program. The complete description of the file format and possible parameters held within are here for reference purposes.


    FILE FORMAT


    The file consists of sections and parameters. A section begins with the name of the section in square brackets and continues until the next section begins. Sections contain parameters of the form


    'name = value'


    The file is line-based - that is, each newline-terminated line represents either a comment, a section name or a parameter.


    Section and parameter names are not case sensitive.


    Only the first equals sign in a parameter is significant. Whitespace before or after the first equals sign is discarded. Leading, trailing and internal whitespace in section and parameter names is irrelevant. Leading and trailing whitespace in a parameter value is discarded. Internal whitespace within a parameter value is retained verbatim.


    Any line beginning with a semicolon (';') or a hash ('#') character is ignored, as are lines containing only whitespace.


    Any line ending in a '\' is "continued" on the next line in the customary UNIX fashion.


    The values following the equals sign in parameters are all either a string (no quotes needed) or a boolean, which may be given as yes/no, 0/1 or true/false. Case is not significant in boolean values, but is preserved in string values. Some items such as create modes are numeric.


    SECTION DESCRIPTIONS


    Each section in the configuration file (except for the [global] section) describes a shared resource (known as a "share"). The section name is the name of the shared resource and the parameters within the section define the shares attributes.


    There are three special sections, [global], [homes] and [printers], which are described under 'special sections'. The is preserup is to send the query to the broadcast address of the primary network interface as either auto-detected or defined in the interfaces parameter of the smb.conf (5) file.


  • -U unicast address Do a unicast query to the specified address or host "unicast address". This option (along with the -R option) is needed to query a WINS server.


  • -d debuglevel debuglevel is an integer from 0 to 10.


    The default value if this parameter is not specified is zero.


    The higher this value, the more detail will be logged about the activities of nmblookup. At level 0, only critical errors and serious warnings will be logged.


    Levels above 1 will generate considerable amounts of log data, and should only be used when investigating a problem. Levels above 3 are designed for use only by developers and generate HUGE amounts of data, most of which is extremely cryptic.


    Note that specifying this parameter here will override the log level parameter in the smb.conf (5) file.


  • -s smb.conf This parameter specifies the pathname to the Samba configuration file, smb.conf. This file controls all aspects of the Samba setup on the machine.


  • -i scope This specifies a NetBIOS scope that nmblookup will use to communicate with when generating NetBIOS names. For details on the use of NetBIOS scopes, see rfc1001.txt and rfc1002.txt. NetBIOS scopes are very rarely used, only set this parameter if you are the system administrator in charge of all the NetBIOS systems you communicate with.


  • -T This causes any IP addresses found in the lookup to be looked up via a reverse DNS lookup into a DNS name, and printed out before each "IP address NetBIOS name" pair that is the normal output.


  • name This is the NetBIOS name being queried. Depending upon the previous options this may be a NetBIOS name or IP address. If a NetBIOS name then the different name types may be specified by appending #<type> to the name. This name may also be "*", which will return all registered names within a broadcast area.



    EXAMPLES


    nmblookup can be used to query a WINS server (in the same way nslookup is used to query DNS servers). To query a WINS server, nmblookup must be called like this:


    nmblookup -U server -R 'name'


    For example, running :


    nmblookup -U samba.org -R IRIX#1B'


    would query the WINS server samba.org for the domain master browser (1B name type) for the IRIX workgroup.


    VERSION


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


    SEE ALSO


    samba (7), nmbd (8), smb.conf (5)


    AUTHOR


    The original Samba software and related utilities were created by Andrew Tridgell samba-bugs@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-bugs@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.


    usr/lib/samba/swat/help/samba.7.html100644 0 0 16100 6750314400 15640 0ustar rootroot Samba (7)


    Samba (7)

    Samba

    23 Oct 1998


    NAME

    Samba - A Windows SMB/CIFS fileserver for UNIX


    SYNOPSIS

    Samba


    DESCRIPTION


    The Samba software suite is a collection of programs that implements the Server Message Block(commonly abbreviated as SMB) protocol for UNIX systems. This protocol is sometimes also referred to as the Common Internet File System (CIFS), LanManager or NetBIOS protocol.


    COMPONENTS


    The Samba suite is made up of several components. Each component is described in a separate manual page. It is strongly recommended that you read the documentation that comes with Samba and the manual pages of those components that you use. If the manual pages aren't clear enough then please send a patch or bug report to samba-bugs@samba.org.



    AVAILABILITY


    The Samba software suite is licensed under the GNU Public License (GPL). A copy of that license should have come with the package in the file COPYING. You are encouraged to distribute copies of the Samba suite, but please obey the terms of this license.


    The latest version of the Samba suite can be obtained via anonymous ftp from samba.org in the directory pub/samba/. It is also available on several mirror sites worldwide.


    You may also find useful information about Samba on the newsgroup comp.protocols.smb and the Samba mailing list. Details on how to join the mailing list are given in the README file that comes with Samba.


    If you have access to a WWW viewer (such as Netscape or Mosaic) then you will also find lots of useful information, including back issues of the Samba mailing list, at http://samba.org/samba/.


    VERSION


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


    CONTRIBUTIONS


    If you wish to contribute to the Samba project, then I suggest you join the Samba mailing list at samba@samba.org. See the Web page at http://samba.org/listproc for details on how to do this.


    If you have patches to submit or bugs to report then you may mail them directly to samba-bugs@samba.org. Note, however, that due to the enormous popularity of this package the Samba Team may take some time to respond to mail. We prefer patches in diff -u format.


    CREDITS


    Contributors to the project are now too numerous to mention here but all deserve the thanks of all Samba users. To see a full list, look at ftp://samba.org/pub/samba/alpha/change-log for the pre-CVS changes and at ftp://samba.org/pub/samba/alpha/cvs.log for the contributors to Samba post-CVS. CVS is the Open Source source code control system used by the Samba Team to develop Samba. The project would have been unmanageable without it.


    In addition, several commercial organizations now help fund the Samba Team with money and equipment. For details see the Samba Web pages at http://samba.org/samba/samba-thanks.html.


    AUTHOR


    The original Samba software and related utilities were created by Andrew Tridgell samba-bugs@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-bugs@samba.org. usr/lib/samba/swat/help/smb.conf.5.html100644 0 0 1060307 6750314401 16332 0ustar rootroot smb.conf (5)


    smb.conf (5)

    Samba

    23 Oct 1998


    NAME

    smb.conf - The configuration file for the Samba suite


    SYNOPSIS


    smb.conf The smb.conf file is a configuration file for the Samba suite. smb.conf contains runtime configuration information for the Samba programs. The smb.conf file is designed to be configured and administered by the swat (8) program. The complete description of the file format and possible parameters held within are here for reference purposes.


    FILE FORMAT


    The file consists of sections and parameters. A section begins with the name of the section in square brackets and continues until the next section begins. Sections contain parameters of the form


    'name = value'


    The file is line-based - that is, each newline-terminated line represents either a comment, a section name or a parameter.


    Section and parameter names are not case sensitive.


    Only the first equals sign in a parameter is significant. Whitespace before or after the first equals sign is discarded. Leading, trailing and internal whitespace in section and parameter names is irrelevant. Leading and trailing whitespace in a parameter value is discarded. Internal whitespace within a parameter value is retained verbatim.


    Any line beginning with a semicolon (';') or a hash ('#') character is ignored, as are lines containing only whitespace.


    Any line ending in a '\' is "continued" on the next line in the customary UNIX fashion.


    The values following the equals sign in parameters are all either a string (no quotes needed) or a boolean, which may be given as yes/no, 0/1 or true/false. Case is not significant in boolean values, but is preserved in string values. Some items such as create modes are numeric.


    SECTION DESCRIPTIONS


    Each section in the configuration file (except for the [global] section) describes a shared resource (known as a "share"). The section name is the name of the shared resource and the parameters within the section define the shares attributes.


    There are three special sections, [global], [homes] and [printers], which are described under 'special sections'. The is preserup is to send the query to the broadcast address of the primary network interface as either auto-detected or defined in the interfaces parameter of the smb.conf (5) file.


  • -U unicast address Do a unicast query to the specified address or host "unicast address". This option (along with the -R option) is needed to query a WINS server.


  • -d debuglevel debuglevel is an integer from 0 to 10.


    The default value if this parameter is not specified is zero.


    The higher this value, the more detail will be logged about the activities of nmblookup. At level 0, only critical errors and serious warnings will be logged.


    Levels above 1 will generate considerable amounts of log data, and should only be used when investigating a problem. Levels above 3 are designed for use only by developers and generate HUGE amounts of data, most of which is extremely cryptic.


    Note that specifying this parameter here will override the log level parameter in the smb.conf (5) file.


  • -s smb.conf This parameter specifies the pathname to the Samba configuration file, smb.conf. This file controls all aspects of the Samba setup on the machine.


  • -i scope This specifies a NetBIOS scope that nmblookup will use to communicate with when generating NetBIOS names. For details on the use of NetBIOS scopes, see rfc1001.txt and rfc1002.txt. NetBIOS scopes are very rarely used, only set this parameter if you are the system administrator in charge of all the NetBIOS systems you communicate with.


  • -T This causes any IP addresses found in the lookup to be looked up via a reverse DNS lookup into a DNS name, and printed out before each "IP address NetBIOS name" pair that is the normal output.


  • name This is the NetBIOS name being queried. Depending upon the previous options this may be a NetBIOS name or IP address. If a NetBIOS name then the different name types may be specified by appending #<type> to the name. This name may also be "*", which will return all registered names within a broadcast area.



    EXAMPLES


    nmblookup can be used to query a WINS server (in the same way nslookup is used to query DNS servers). To query a WINS server, nmblookup must be called like this:


    nmblookup -U server -R 'name'


    For example, running :


    nmblookup -U samba.org -R IRIX#1B'


    would query the WINS server samba.org for the domain master browser (1B name type) for the IRIX workgroup.


    VERSION


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


    SEE ALSO


    samba (7), nmbd (8), smb.conf (5)


    AUTHOR


    The original Samba software and related utilities were created by Andrew Tridgell samba-bugs@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-bugs@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.


    usr/lib/samba/swat/help/samba.7.html100644 0 0 16100 6750314400 15640 0ustar rootroot Samba (7)


    Samba (7)

    Samba

    23 Oct 1998


    NAME

    Samba - A Windows SMB/CIFS fileserver for UNIX


    SYNOPSIS

    Samba


    DESCRIPTION


    The Samba software suite is a collection of programs that implements the Server Message Block(commonly abbreviated as SMB) protocol for UNIX systems. This protocol is sometimes also referred to as the Common Internet File System (CIFS), LanManager or NetBIOS protocol.


    COMPONENTS


    The Samba suite is made up of several components. Each component is described in a separate manual page. It is strongly recommended that you read the documentation that comes with Samba and the manual pages of those components that you use. If the manual pages aren't clear enough then please send a patch or bug report to samba-bugs@samba.org.



    AVAILABILITY


    The Samba software suite is licensed under the GNU Public License (GPL). A copy of that license should have come with the package in the file COPYING. You are encouraged to distribute copies of the Samba suite, but please obey the terms of this license.


    The latest version of the Samba suite can be obtained via anonymous ftp from samba.org in the directory pub/samba/. It is also available on several mirror sites worldwide.


    You may also find useful information about Samba on the newsgroup comp.protocols.smb and the Samba mailing list. Details on how to join the mailing list are given in the README file that comes with Samba.


    If you have access to a WWW viewer (such as Netscape or Mosaic) then you will also find lots of useful information, including back issues of the Samba mailing list, at http://samba.org/samba/.


    VERSION


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


    CONTRIBUTIONS


    If you wish to contribute to the Samba project, then I suggest you join the Samba mailing list at samba@samba.org. See the Web page at http://samba.org/listproc for details on how to do this.


    If you have patches to submit or bugs to report then you may mail them directly to samba-bugs@samba.org. Note, however, that due to the enormous popularity of this package the Samba Team may take some time to respond to mail. We prefer patches in diff -u format.


    CREDITS


    Contributors to the project are now too numerous to mention here but all deserve the thanks of all Samba users. To see a full list, look at ftp://samba.org/pub/samba/alpha/change-log for the pre-CVS changes and at ftp://samba.org/pub/samba/alpha/cvs.log for the contributors to Samba post-CVS. CVS is the Open Source source code control system used by the Samba Team to develop Samba. The project would have been unmanageable without it.


    In addition, several commercial organizations now help fund the Samba Team with money and equipment. For details see the Samba Web pages at http://samba.org/samba/samba-thanks.html.


    AUTHOR


    The original Samba software and related utilities were created by Andrew Tridgell samba-bugs@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-bugs@samba.org. usr/lib/samba/swat/help/smb.conf.5.html100644 0 0 1060307 6750314401 16332 0ustar rootroot smb.conf (5)


    smb.conf (5)

    Samba

    23 Oct 1998


    NAME

    smb.conf - The configuration file for the Samba suite


    SYNOPSIS


    smb.conf The smb.conf file is a configuration file for the Samba suite. smb.conf contains runtime configuration information for the Samba programs. The smb.conf file is designed to be configured and administered by the swat (8) program. The complete description of the file format and possible parameters held within are here for reference purposes.


    FILE FORMAT


    The file consists of sections and parameters. A section begins with the name of the section in square brackets and continues until the next section begins. Sections contain parameters of the form


    'name = value'


    The file is line-based - that is, each newline-terminated line represents either a comment, a section name or a parameter.


    Section and parameter names are not case sensitive.


    Only the first equals sign in a parameter is significant. Whitespace before or after the first equals sign is discarded. Leading, trailing and internal whitespace in section and parameter names is irrelevant. Leading and trailing whitespace in a parameter value is discarded. Internal whitespace within a parameter value is retained verbatim.


    Any line beginning with a semicolon (';') or a hash ('#') character is ignored, as are lines containing only whitespace.


    Any line ending in a '\' is "continued" on the next line in the customary UNIX fashion.


    The values following the equals sign in parameters are all either a string (no quotes needed) or a boolean, which may be given as yes/no, 0/1 or true/false. Case is not significant in boolean values, but is preserved in string values. Some items such as create modes are numeric.


    SECTION DESCRIPTIONS


    Each section in the configuration file (except for the [global] section) describes a shared resource (known as a "share"). The section name is the name of the shared resource and the parameters within the section define the shares attributes.


    There are three special sections, [global], [homes] and [printers], which are described under 'special sections'. The is preserup is to send the query to the broadcast address of the primary network interface as either auto-detected or defined in the interfaces parameter of the smb.conf (5) file.


  • -U unicast address Do a unicast query to the specified address or host "unicast address". This option (along with the -R option) is needed to query a WINS server.


  • -d debuglevel debuglevel is an integer from 0 to 10.


    The default value if this parameter is not specified is zero.


    The higher this value, the more detail will be logged about the activities of nmblookup. At level 0, only critical errors and serious warnings will be logged.


    Levels above 1 will generate considerable amounts of log data, and should only be used when investigating a problem. Levels above 3 are designed for use only by developers and generate HUGE amounts of data, most of which is extremely cryptic.


    Note that specifying this parameter here will override the log level parameter in the smb.conf (5) file.


  • -s smb.conf This parameter specifies the pathname to the Samba configuration file, smb.conf. This file controls all aspects of the Samba setup on the machine.


  • -i scope This specifies a NetBIOS scope that nmblookup will use to communicate with when generating NetBIOS names. For details on the use of NetBIOS scopes, see rfc1001.txt and rfc1002.txt. NetBIOS scopes are very rarely used, only set this parameter if you are the system administrator in charge of all the NetBIOS systems you communicate with.


  • -T This causes any IP addresses found in the lookup to be looked up via a reverse DNS lookup into a DNS name, and printed out before each "IP address NetBIOS name" pair that is the normal output.


  • name This is the NetBIOS name being queried. Depending upon the previous options this may be a NetBIOS name or IP address. If a NetBIOS name then the different name types may be specified by appending #<type> to the name. This name may also be "*", which will return all registered names within a broadcast area.



    EXAMPLES


    nmblookup can be used to query a WINS server (in the same way nslookup is used to query DNS servers). To query a WINS server, nmblookup must be called like this:


    nmblookup -U server -R 'name'


    For example, running :


    nmblookup -U samba.org -R IRIX#1B'


    would query the WINS server samba.org for the domain master browser (1B name type) for the IRIX workgroup.


    VERSION


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


    SEE ALSO


    samba (7), nmbd (8), smb.conf (5)


    AUTHOR


    The original Samba software and related utilities were created by Andrew Tridgell samba-bugs@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-bugs@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.


    usr/lib/samba/swat/help/samba.7.html100644 0 0 16100 6750314400 15640 0ustar rootroot Samba (7)


    Samba (7)

    Samba

    23 Oct 1998


    NAME

    Samba - A Windows SMB/CIFS fileserver for UNIX


    SYNOPSIS

    Samba


    DESCRIPTION


    The Samba software suite is a collection of programs that implements the Server Message Block(commonly abbreviated as SMB) protocol for UNIX systems. This protocol is sometimes also referred to as the Common Internet File System (CIFS), LanManager or NetBIOS protocol.


    COMPONENTS


    The Samba suite is made up of several components. Each component is described in a separate manual page. It is strongly recommended that you read the documentation that comes with Samba and the manual pages of those components that you use. If the manual pages aren't clear enough then please send a patch or bug report to samba-bugs@samba.org.



    AVAILABILITY


    The Samba software suite is licensed under the GNU Public License (GPL). A copy of that license should have come with the package in the file COPYING. You are encouraged to distribute copies of the Samba suite, but please obey the terms of this license.


    The latest version of the Samba suite can be obtained via anonymous ftp from samba.org in the directory pub/samba/. It is also available on several mirror sites worldwide.


    You may also find useful information about Samba on the newsgroup comp.protocols.smb and the Samba mailing list. Details on how to join the mailing list are given in the README file that comes with Samba.


    If you have access to a WWW viewer (such as Netscape or Mosaic) then you will also find lots of useful information, including back issues of the Samba mailing list, at http://samba.org/samba/.


    VERSION


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


    CONTRIBUTIONS


    If you wish to contribute to the Samba project, then I suggest you join the Samba mailing list at samba@samba.org. See the Web page at http://samba.org/listproc for details on how to do this.


    If you have patches to submit or bugs to report then you may mail them directly to samba-bugs@samba.org. Note, however, that due to the enormous popularity of this package the Samba Team may take some time to respond to mail. We prefer patches in diff -u format.


    CREDITS


    Contributors to the project are now too numerous to mention here but all deserve the thanks of all Samba users. To see a full list, look at ftp://samba.org/pub/samba/alpha/change-log for the pre-CVS changes and at ftp://samba.org/pub/samba/alpha/cvs.log for the contributors to Samba post-CVS. CVS is the Open Source source code control system used by the Samba Team to develop Samba. The project would have been unmanageable without it.


    In addition, several commercial organizations now help fund the Samba Team with money and equipment. For details see the Samba Web pages at http://samba.org/samba/samba-thanks.html.


    AUTHOR


    The original Samba software and related utilities were created by Andrew Tridgell samba-bugs@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-bugs@samba.org. usr/lib/samba/swat/help/smb.conf.5.html100644 0 0 1060307 6750314401 16332 0ustar rootroot smb.conf (5)


    smb.conf (5)

    Samba

    23 Oct 1998


    NAME

    smb.conf - The configuration file for the Samba suite


    SYNOPSIS


    smb.conf The smb.conf file is a configuration file for the Samba suite. smb.conf contains runtime configuration information for the Samba programs. The smb.conf file is designed to be configured and administered by the swat (8) program. The complete description of the file format and possible parameters held within are here for reference purposes.


    FILE FORMAT


    The file consists of sections and parameters. A section begins with the name of the section in square brackets and continues until the next section begins. Sections contain parameters of the form


    'name = value'


    The file is line-based - that is, each newline-terminated line represents either a comment, a section name or a parameter.


    Section and parameter names are not case sensitive.


    Only the first equals sign in a parameter is significant. Whitespace before or after the first equals sign is discarded. Leading, trailing and internal whitespace in section and parameter names is irrelevant. Leading and trailing whitespace in a parameter value is discarded. Internal whitespace within a parameter value is retained verbatim.


    Any line beginning with a semicolon (';') or a hash ('#') character is ignored, as are lines containing only whitespace.


    Any line ending in a '\' is "continued" on the next line in the customary UNIX fashion.


    The values following the equals sign in parameters are all either a string (no quotes needed) or a boolean, which may be given as yes/no, 0/1 or true/false. Case is not significant in boolean values, but is preserved in string values. Some items such as create modes are numeric.


    SECTION DESCRIPTIONS


    Each section in the configuration file (except for the [global] section) describes a shared resource (known as a "share"). The section name is the name of the shared resource and the parameters within the section define the shares attributes.


    There are three special sections, [global], [homes] and [printers], which are described under 'special sections'. The is preserup is to send the query to the broadcast address of the primary network interface as either auto-detected or defined in the interfaces parameter of the smb.conf (5) file.


  • -U unicast address Do a unicast query to the specified address or host "unicast address". This option (along with the -R option) is needed to query a WINS server.


  • -d debuglevel debuglevel is an integer from 0 to 10.


    The default value if this parameter is not specified is zero.


    The higher this value, the more detail will be logged about the activities of nmblookup. At level 0, only critical errors and serious warnings will be logged.


    Levels above 1 will generate considerable amounts of log data, and should only be used when investigating a problem. Levels above 3 are designed for use only by developers and generate HUGE amounts of data, most of which is extremely cryptic.


    Note that specifying this parameter here will override the log level parameter in the smb.conf (5) file.


  • -s smb.conf This parameter specifies the pathname to the Samba configuration file, smb.conf. This file controls all aspects of the Samba setup on the machine.


  • -i scope This specifies a NetBIOS scope that nmblookup will use to communicate with when generating NetBIOS names. For details on the use of NetBIOS scopes, see rfc1001.txt and rfc1002.txt. NetBIOS scopes are very rarely used, only set this parameter if you are the system administrator in charge of all the NetBIOS systems you communicate with.


  • -T This causes any IP addresses found in the lookup to be looked up via a reverse DNS lookup into a DNS name, and printed out before each "IP address NetBIOS name" pair that is the normal output.


  • name This is the NetBIOS name being queried. Depending upon the previous options this may be a NetBIOS name or IP address. If a NetBIOS name then the different name types may be specified by appending #<type> to the name. This name may also be "*", which will return all registered names within a broadcast area.



    EXAMPLES


    nmblookup can be used to query a WINS server (in the same way nslookup is used to query DNS servers). To query a WINS server, nmblookup must be called like this:


    nmblookup -U server -R 'name'


    For example, running :


    nmblookup -U samba.org -R IRIX#1B'


    would query the WINS server samba.org for the domain master browser (1B name type) for the IRIX workgroup.


    VERSION


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


    SEE ALSO


    samba (7), nmbd (8), smb.conf (5)


    AUTHOR


    The original Samba software and related utilities were created by Andrew Tridgell samba-bugs@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-bugs@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.


    usr/lib/samba/swat/help/samba.7.html100644 0 0 16100 6750314400 15640 0ustar rootroot Samba (7)


    Samba (7)

    Samba

    23 Oct 1998


    NAME

    Samba - A Windows SMB/CIFS fileserver for UNIX


    SYNOPSIS

    Samba


    DESCRIPTION


    The Samba software suite is a collection of programs that implements the Server Message Block(commonly abbreviated as SMB) protocol for UNIX systems. This protocol is sometimes also referred to as the Common Internet File System (CIFS), LanManager or NetBIOS protocol.


    COMPONENTS


    The Samba suite is made up of several components. Each component is described in a separate manual page. It is strongly recommended that you read the documentation that comes with Samba and the manual pages of those components that you use. If the manual pages aren't clear enough then please send a patch or bug report to samba-bugs@samba.org.



    AVAILABILITY


    The Samba software suite is licensed under the GNU Public License (GPL). A copy of that license should have come with the package in the file COPYING. You are encouraged to distribute copies of the Samba suite, but please obey the terms of this license.


    The latest version of the Samba suite can be obtained via anonymous ftp from samba.org in the directory pub/samba/. It is also available on several mirror sites worldwide.


    You may also find useful information about Samba on the newsgroup comp.protocols.smb and the Samba mailing list. Details on how to join the mailing list are given in the README file that comes with Samba.


    If you have access to a WWW viewer (such as Netscape or Mosaic) then you will also find lots of useful information, including back issues of the Samba mailing list, at http://samba.org/samba/.


    VERSION


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


    CONTRIBUTIONS


    If you wish to contribute to the Samba project, then I suggest you join the Samba mailing list at samba@samba.org. See the Web page at http://samba.org/listproc for details on how to do this.


    If you have patches to submit or bugs to report then you may mail them directly to samba-bugs@samba.org. Note, however, that due to the enormous popularity of this package the Samba Team may take some time to respond to mail. We prefer patches in diff -u format.


    CREDITS


    Contributors to the project are now too numerous to mention here but all deserve the thanks of all Samba users. To see a full list, look at ftp://samba.org/pub/samba/alpha/change-log for the pre-CVS changes and at ftp://samba.org/pub/samba/alpha/cvs.log for the contributors to Samba post-CVS. CVS is the Open Source source code control system used by the Samba Team to develop Samba. The project would have been unmanageable without it.


    In addition, several commercial organizations now help fund the Samba Team with money and equipment. For details see the Samba Web pages at http://samba.org/samba/samba-thanks.html.


    AUTHOR


    The original Samba software and related utilities were created by Andrew Tridgell samba-bugs@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-bugs@samba.org. usr/lib/samba/swat/help/smb.conf.5.html100644 0 0 1060307 6750314401 16332 0ustar rootroot smb.conf (5)


    smb.conf (5)

    Samba

    23 Oct 1998


    NAME

    smb.conf - The configuration file for the Samba suite


    SYNOPSIS


    smb.conf The smb.conf file is a configuration file for the Samba suite. smb.conf contains runtime configuration information for the Samba programs. The smb.conf file is designed to be configured and administered by the swat (8) program. The complete description of the file format and possible parameters held within are here for reference purposes.


    FILE FORMAT


    The file consists of sections and parameters. A section begins with the name of the section in square brackets and continues until the next section begins. Sections contain parameters of the form


    'name = value'


    The file is line-based - that is, each newline-terminated line represents either a comment, a section name or a parameter.


    Section and parameter names are not case sensitive.


    Only the first equals sign in a parameter is significant. Whitespace before or after the first equals sign is discarded. Leading, trailing and internal whitespace in section and parameter names is irrelevant. Leading and trailing whitespace in a parameter value is discarded. Internal whitespace within a parameter value is retained verbatim.


    Any line beginning with a semicolon (';') or a hash ('#') character is ignored, as are lines containing only whitespace.


    Any line ending in a '\' is "continued" on the next line in the customary UNIX fashion.


    The values following the equals sign in parameters are all either a string (no quotes needed) or a boolean, which may be given as yes/no, 0/1 or true/false. Case is not significant in boolean values, but is preserved in string values. Some items such as create modes are numeric.


    SECTION DESCRIPTIONS


    Each section in the configuration file (except for the [global] section) describes a shared resource (known as a "share"). The section name is the name of the shared resource and the parameters within the section define the shares attributes.


    There are three special sections, [global], [homes] and [printers], which are described under 'special sections'. The is preserup is to send the query to the broadcast address of the primary network interface as either auto-detected or defined in the interfaces parameter of the smb.conf (5) file.


  • -U unicast address Do a unicast query to the specified address or host "unicast address". This option (along with the -R option) is needed to query a WINS server.


  • -d debuglevel debuglevel is an integer from 0 to 10.


    The default value if this parameter is not specified is zero.


    The higher this value, the more detail will be logged about the activities of nmblookup. At level 0, only critical errors and serious warnings will be logged.


    Levels above 1 will generate considerable amounts of log data, and should only be used when investigating a problem. Levels above 3 are designed for use only by developers and generate HUGE amounts of data, most of which is extremely cryptic.


    Note that specifying this parameter here will override the log level parameter in the smb.conf (5) file.


  • -s smb.conf This parameter specifies the pathname to the Samba configuration file, smb.conf. This file controls all aspects of the Samba setup on the machine.


  • -i scope This specifies a NetBIOS scope that nmblookup will use to communicate with when generating NetBIOS names. For details on the use of NetBIOS scopes, see rfc1001.txt and rfc1002.txt. NetBIOS scopes are very rarely used, only set this parameter if you are the system administrator in charge of all the NetBIOS systems you communicate with.


  • -T This causes any IP addresses found in the lookup to be looked up via a reverse DNS lookup into a DNS name, and printed out before each "IP address NetBIOS name" pair that is the normal output.


  • name This is the NetBIOS name being queried. Depending upon the previous options this may be a NetBIOS name or IP address. If a NetBIOS name then the different name types may be specified by appending #<type> to the name. This name may also be "*", which will return all registered names within a broadcast area.



    EXAMPLES


    nmblookup can be used to query a WINS server (in the same way nslookup is used to query DNS servers). To query a WINS server, nmblookup must be called like this:


    nmblookup -U server -R 'name'


    For example, running :


    nmblookup -U samba.org -R IRIX#1B'


    would query the WINS server samba.org for the domain master browser (1B name type) for the IRIX workgroup.


    VERSION


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


    SEE ALSO


    samba (7), nmbd (8), smb.conf (5)


    AUTHOR


    The original Samba software and related utilities were created by Andrew Tridgell samba-bugs@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-bugs@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.


    usr/lib/samba/swat/help/samba.7.html100644 0 0 16100 6750314400 15640 0ustar rootroot Samba (7)


    Samba (7)

    Samba

    23 Oct 1998


    NAME

    Samba - A Windows SMB/CIFS fileserver for UNIX


    SYNOPSIS

    Samba


    DESCRIPTION


    The Samba software suite is a collection of programs that implements the Server Message Block(commonly abbreviated as SMB) protocol for UNIX systems. This protocol is sometimes also referred to as the Common Internet File System (CIFS), LanManager or NetBIOS protocol.


    COMPONENTS


    The Samba suite is made up of several components. Each component is described in a separate manual page. It is strongly recommended that you read the documentation that comes with Samba and the manual pages of those components that you use. If the manual pages aren't clear enough then please send a patch or bug report to samba-bugs@samba.org.



    AVAILABILITY


    The Samba software suite is licensed under the GNU Public License (GPL). A copy of that license should have come with the package in the file COPYING. You are encouraged to distribute copies of the Samba suite, but please obey the terms of this license.


    The latest version of the Samba suite can be obtained via anonymous ftp from samba.org in the directory pub/samba/. It is also available on several mirror sites worldwide.


    You may also find useful information about Samba on the newsgroup comp.protocols.smb and the Samba mailing list. Details on how to join the mailing list are given in the README file that comes with Samba.


    If you have access to a WWW viewer (such as Netscape or Mosaic) then you will also find lots of useful information, including back issues of the Samba mailing list, at http://samba.org/samba/.


    VERSION


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


    CONTRIBUTIONS


    If you wish to contribute to the Samba project, then I suggest you join the Samba mailing list at samba@samba.org. See the Web page at http://samba.org/listproc for details on how to do this.


    If you have patches to submit or bugs to report then you may mail them directly to samba-bugs@samba.org. Note, however, that due to the enormous popularity of this package the Samba Team may take some time to respond to mail. We prefer patches in diff -u format.


    CREDITS


    Contributors to the project are now too numerous to mention here but all deserve the thanks of all Samba users. To see a full list, look at ftp://samba.org/pub/samba/alpha/change-log for the pre-CVS changes and at ftp://samba.org/pub/samba/alpha/cvs.log for the contributors to Samba post-CVS. CVS is the Open Source source code control system used by the Samba Team to develop Samba. The project would have been unmanageable without it.


    In addition, several commercial organizations now help fund the Samba Team with money and equipment. For details see the Samba Web pages at http://samba.org/samba/samba-thanks.html.


    AUTHOR


    The original Samba software and related utilities were created by Andrew Tridgell samba-bugs@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-bugs@samba.org. usr/lib/samba/swat/help/smb.conf.5.html100644 0 0 1060307 6750314401 16332 0ustar rootroot smb.conf (5)


    smb.conf (5)

    Samba

    23 Oct 1998


    NAME

    smb.conf - The configuration file for the Samba suite


    SYNOPSIS


    smb.conf The smb.conf file is a configuration file for the Samba suite. smb.conf contains runtime configuration information for the Samba programs. The smb.conf file is designed to be configured and administered by the swat (8) program. The complete description of the file format and possible parameters held within are here for reference purposes.


    FILE FORMAT


    The file consists of sections and parameters. A section begins with the name of the section in square brackets and continues until the next section begins. Sections contain parameters of the form


    'name = value'


    The file is line-based - that is, each newline-terminated line represents either a comment, a section name or a parameter.


    Section and parameter names are not case sensitive.


    Only the first equals sign in a parameter is significant. Whitespace before or after the first equals sign is discarded. Leading, trailing and internal whitespace in section and parameter names is irrelevant. Leading and trailing whitespace in a parameter value is discarded. Internal whitespace within a parameter value is retained verbatim.


    Any line beginning with a semicolon (';') or a hash ('#') character is ignored, as are lines containing only whitespace.


    Any line ending in a '\' is "continued" on the next line in the customary UNIX fashion.


    The values following the equals sign in parameters are all either a string (no quotes needed) or a boolean, which may be given as yes/no, 0/1 or true/false. Case is not significant in boolean values, but is preserved in string values. Some items such as create modes are numeric.


    SECTION DESCRIPTIONS


    Each section in the configuration file (except for the [global] section) describes a shared resource (known as a "share"). The section name is the name of the shared resource and the parameters within the section define the shares attributes.


    There are three special sections, [global], [homes] and [printers], which are described under 'special sections'. The is preserup is to send the query to the broadcast address of the primary network interface as either auto-detected or defined in the interfaces parameter of the smb.conf (5) file.


  • -U unicast address Do a unicast query to the specified address or host "unicast address". This option (along with the -R option) is needed to query a WINS server.


  • -d debuglevel debuglevel is an integer from 0 to 10.


    The default value if this parameter is not specified is zero.


    The higher this value, the more detail will be logged about the activities of nmblookup. At level 0, only critical errors and serious warnings will be logged.


    Levels above 1 will generate considerable amounts of log data, and should only be used when investigating a problem. Levels above 3 are designed for use only by developers and generate HUGE amounts of data, most of which is extremely cryptic.


    Note that specifying this parameter here will override the log level parameter in the smb.conf (5) file.


  • -s smb.conf This parameter specifies the pathname to the Samba configuration file, smb.conf. This file controls all aspects of the Samba setup on the machine.


  • -i scope This specifies a NetBIOS scope that nmblookup will use to communicate with when generating NetBIOS names. For details on the use of NetBIOS scopes, see rfc1001.txt and rfc1002.txt. NetBIOS scopes are very rarely used, only set this parameter if you are the system administrator in charge of all the NetBIOS systems you communicate with.


  • -T This causes any IP addresses found in the lookup to be looked up via a reverse DNS lookup into a DNS name, and printed out before each "IP address NetBIOS name" pair that is the normal output.


  • name This is the NetBIOS name being queried. Depending upon the previous options this may be a NetBIOS name or IP address. If a NetBIOS name then the different name types may be specified by appending #<type> to the name. This name may also be "*", which will return all registered names within a broadcast area.



    EXAMPLES


    nmblookup can be used to query a WINS server (in the same way nslookup is used to query DNS servers). To query a WINS server, nmblookup must be called like this:


    nmblookup -U server -R 'name'


    For example, running :


    nmblookup -U samba.org -R IRIX#1B'


    would query the WINS server samba.org for the domain master browser (1B name type) for the IRIX workgroup.


    VERSION


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


    SEE ALSO


    samba (7), nmbd (8), smb.conf (5)


    AUTHOR


    The original Samba software and related utilities were created by Andrew Tridgell samba-bugs@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-bugs@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.


    usr/lib/samba/swat/help/samba.7.html100644 0 0 16100 6750314400 15640 0ustar rootroot Samba (7)


    Samba (7)

    Samba

    23 Oct 1998


    NAME

    Samba - A Windows SMB/CIFS fileserver for UNIX


    SYNOPSIS

    Samba


    DESCRIPTION


    The Samba software suite is a collection of programs that implements the Server Message Block(commonly abbreviated as SMB) protocol for UNIX systems. This protocol is sometimes also referred to as the Common Internet File System (CIFS), LanManager or NetBIOS protocol.


    COMPONENTS


    The Samba suite is made up of several components. Each component is described in a separate manual page. It is strongly recommended that you read the documentation that comes with Samba and the manual pages of those components that you use. If the manual pages aren't clear enough then please send a patch or bug report to samba-bugs@samba.org.



    AVAILABILITY


    The Samba software suite is licensed under the GNU Public License (GPL). A copy of that license should have come with the package in the file COPYING. You are encouraged to distribute copies of the Samba suite, but please obey the terms of this license.


    The latest version of the Samba suite can be obtained via anonymous ftp from samba.org in the directory pub/samba/. It is also available on several mirror sites worldwide.


    You may also find useful information about Samba on the newsgroup comp.protocols.smb and the Samba mailing list. Details on how to join the mailing list are given in the README file that comes with Samba.


    If you have access to a WWW viewer (such as Netscape or Mosaic) then you will also find lots of useful information, including back issues of the Samba mailing list, at http://samba.org/samba/.


    VERSION


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


    CONTRIBUTIONS


    If you wish to contribute to the Samba project, then I suggest you join the Samba mailing list at samba@samba.org. See the Web page at http://samba.org/listproc for details on how to do this.


    If you have patches to submit or bugs to report then you may mail them directly to samba-bugs@samba.org. Note, however, that due to the enormous popularity of this package the Samba Team may take some time to respond to mail. We prefer patches in diff -u format.


    CREDITS


    Contributors to the project are now too numerous to mention here but all deserve the thanks of all Samba users. To see a full list, look at ftp://samba.org/pub/samba/alpha/change-log for the pre-CVS changes and at ftp://samba.org/pub/samba/alpha/cvs.log for the contributors to Samba post-CVS. CVS is the Open Source source code control system used by the Samba Team to develop Samba. The project would have been unmanageable without it.


    In addition, several commercial organizations now help fund the Samba Team with money and equipment. For details see the Samba Web pages at http://samba.org/samba/samba-thanks.html.


    AUTHOR


    The original Samba software and related utilities were created by Andrew Tridgell samba-bugs@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-bugs@samba.org. usr/lib/samba/swat/help/smb.conf.5.html100644 0 0 1060307 6750314401 16332 0ustar rootroot smb.conf (5)


    smb.conf (5)

    Samba

    23 Oct 1998


    NAME

    smb.conf - The configuration file for the Samba suite


    SYNOPSIS


    smb.conf The smb.conf file is a configuration file for the Samba suite. smb.conf contains runtime configuration information for the Samba programs. The smb.conf file is designed to be configured and administered by the swat (8) program. The complete description of the file format and possible parameters held within are here for reference purposes.


    FILE FORMAT


    The file consists of sections and parameters. A section begins with the name of the section in square brackets and continues until the next section begins. Sections contain parameters of the form


    'name = value'


    The file is line-based - that is, each newline-terminated line represents either a comment, a section name or a parameter.


    Section and parameter names are not case sensitive.


    Only the first equals sign in a parameter is significant. Whitespace before or after the first equals sign is discarded. Leading, trailing and internal whitespace in section and parameter names is irrelevant. Leading and trailing whitespace in a parameter value is discarded. Internal whitespace within a parameter value is retained verbatim.


    Any line beginning with a semicolon (';') or a hash ('#') character is ignored, as are lines containing only whitespace.


    Any line ending in a '\' is "continued" on the next line in the customary UNIX fashion.


    The values following the equals sign in parameters are all either a string (no quotes needed) or a boolean, which may be given as yes/no, 0/1 or true/false. Case is not significant in boolean values, but is preserved in string values. Some items such as create modes are numeric.


    SECTION DESCRIPTIONS


    Each section in the configuration file (except for the [global] section) describes a shared resource (known as a "share"). The section name is the name of the shared resource and the parameters within the section define the shares attributes.


    There are three special sections, [global], [homes] and [printers], which are described under 'special sections'. The is preserup is to send the query to the broadcast address of the primary network interface as either auto-detected or defined in the interfaces parameter of the smb.conf (5) file.


  • -U unicast address Do a unicast query to the specified address or host "unicast address". This option (along with the -R option) is needed to query a WINS server.


  • -d debuglevel debuglevel is an integer from 0 to 10.


    The default value if this parameter is not specified is zero.


    The higher this value, the more detail will be logged about the activities of nmblookup. At level 0, only critical errors and serious warnings will be logged.


    Levels above 1 will generate considerable amounts of log data, and should only be used when investigating a problem. Levels above 3 are designed for use only by developers and generate HUGE amounts of data, most of which is extremely cryptic.


    Note that specifying this parameter here will override the log level parameter in the smb.conf (5) file.


  • -s smb.conf This parameter specifies the pathname to the Samba configuration file, smb.conf. This file controls all aspects of the Samba setup on the machine.


  • -i scope This specifies a NetBIOS scope that nmblookup will use to communicate with when generating NetBIOS names. For details on the use of NetBIOS scopes, see rfc1001.txt and rfc1002.txt. NetBIOS scopes are very rarely used, only set this parameter if you are the system administrator in charge of all the NetBIOS systems you communicate with.


  • -T This causes any IP addresses found in the lookup to be looked up via a reverse DNS lookup into a DNS name, and printed out before each "IP address NetBIOS name" pair that is the normal output.


  • name This is the NetBIOS name being queried. Depending upon the previous options this may be a NetBIOS name or IP address. If a NetBIOS name then the different name types may be specified by appending #<type> to the name. This name may also be "*", which will return all registered names within a broadcast area.



    EXAMPLES


    nmblookup can be used to query a WINS server (in the same way nslookup is used to query DNS servers). To query a WINS server, nmblookup must be called like this:


    nmblookup -U server -R 'name'


    For example, running :


    nmblookup -U samba.org -R IRIX#1B'


    would query the WINS server samba.org for the domain master browser (1B name type) for the IRIX workgroup.


    VERSION


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


    SEE ALSO


    samba (7), nmbd (8), smb.conf (5)


    AUTHOR


    The original Samba software and related utilities were created by Andrew Tridgell samba-bugs@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-bugs@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.


    usr/lib/samba/swat/help/samba.7.html100644 0 0 16100 6750314400 15640 0ustar rootroot Samba (7)


    Samba (7)

    Samba

    23 Oct 1998


    NAME

    Samba - A Windows SMB/CIFS fileserver for UNIX


    SYNOPSIS

    Samba


    DESCRIPTION


    The Samba software suite is a collection of programs that implements the Server Message Block(commonly abbreviated as SMB) protocol for UNIX systems. This protocol is sometimes also referred to as the Common Internet File System (CIFS), LanManager or NetBIOS protocol.


    COMPONENTS


    The Samba suite is made up of several components. Each component is described in a separate manual page. It is strongly recommended that you read the documentation that comes with Samba and the manual pages of those components that you use. If the manual pages aren't clear enough then please send a patch or bug report to samba-bugs@samba.org.



    AVAILABILITY


    The Samba software suite is licensed under the GNU Public License (GPL). A copy of that license should have come with the package in the file COPYING. You are encouraged to distribute copies of the Samba suite, but please obey the terms of this license.


    The latest version of the Samba suite can be obtained via anonymous ftp from samba.org in the directory pub/samba/. It is also available on several mirror sites worldwide.


    You may also find useful information about Samba on the newsgroup comp.protocols.smb and the Samba mailing list. Details on how to join the mailing list are given in the README file that comes with Samba.


    If you have access to a WWW viewer (such as Netscape or Mosaic) then you will also find lots of useful information, including back issues of the Samba mailing list, at http://samba.org/samba/.


    VERSION


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


    CONTRIBUTIONS


    If you wish to contribute to the Samba project, then I suggest you join the Samba mailing list at samba@samba.org. See the Web page at http://samba.org/listproc for details on how to do this.


    If you have patches to submit or bugs to report then you may mail them directly to samba-bugs@samba.org. Note, however, that due to the enormous popularity of this package the Samba Team may take some time to respond to mail. We prefer patches in diff -u format.


    CREDITS


    Contributors to the project are now too numerous to mention here but all deserve the thanks of all Samba users. To see a full list, look at ftp://samba.org/pub/samba/alpha/change-log for the pre-CVS changes and at ftp://samba.org/pub/samba/alpha/cvs.log for the contributors to Samba post-CVS. CVS is the Open Source source code control system used by the Samba Team to develop Samba. The project would have been unmanageable without it.


    In addition, several commercial organizations now help fund the Samba Team with money and equipment. For details see the Samba Web pages at http://samba.org/samba/samba-thanks.html.


    AUTHOR


    The original Samba software and related utilities were created by Andrew Tridgell samba-bugs@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-bugs@samba.org. usr/lib/samba/swat/help/smb.conf.5.html100644 0 0 1060307 6750314401 16332 0ustar rootroot smb.conf (5)


    smb.conf (5)

    Samba

    23 Oct 1998


    NAME

    smb.conf - The configuration file for the Samba suite


    SYNOPSIS


    smb.conf The smb.conf file is a configuration file for the Samba suite. smb.conf contains runtime configuration information for the Samba programs. The smb.conf file is designed to be configured and administered by the swat (8) program. The complete description of the file format and possible parameters held within are here for reference purposes.


    FILE FORMAT


    The file consists of sections and parameters. A section begins with the name of the section in square brackets and continues until the next section begins. Sections contain parameters of the form


    'name = value'


    The file is line-based - that is, each newline-terminated line represents either a comment, a section name or a parameter.


    Section and parameter names are not case sensitive.


    Only the first equals sign in a parameter is significant. Whitespace before or after the first equals sign is discarded. Leading, trailing and internal whitespace in section and parameter names is irrelevant. Leading and trailing whitespace in a parameter value is discarded. Internal whitespace within a parameter value is retained verbatim.


    Any line beginning with a semicolon (';') or a hash ('#') character is ignored, as are lines containing only whitespace.


    Any line ending in a '\' is "continued" on the next line in the customary UNIX fashion.


    The values following the equals sign in parameters are all either a string (no quotes needed) or a boolean, which may be given as yes/no, 0/1 or true/false. Case is not significant in boolean values, but is preserved in string values. Some items such as create modes are numeric.


    SECTION DESCRIPTIONS


    Each section in the configuration file (except for the [global] section) describes a shared resource (known as a "share"). The section name is the name of the shared resource and the parameters within the section define the shares attributes.


    There are three special sections, [global], [homes] and [printers], which are described under 'special sections'. The is preserup is to send the query to the broadcast address of the primary network interface as either auto-detected or defined in the interfaces parameter of the smb.conf (5) file.


  • -U unicast address Do a unicast query to the specified address or host "unicast address". This option (along with the -R option) is needed to query a WINS server.


  • -d debuglevel debuglevel is an integer from 0 to 10.


    The default value if this parameter is not specified is zero.


    The higher this value, the more detail will be logged about the activities of nmblookup. At level 0, only critical errors and serious warnings will be logged.


    Levels above 1 will generate considerable amounts of log data, and should only be used when investigating a problem. Levels above 3 are designed for use only by developers and generate HUGE amounts of data, most of which is extremely cryptic.


    Note that specifying this parameter here will override the log level parameter in the smb.conf (5) file.


  • -s smb.conf This parameter specifies the pathname to the Samba configuration file, smb.conf. This file controls all aspects of the Samba setup on the machine.


  • -i scope This specifies a NetBIOS scope that nmblookup will use to communicate with when generating NetBIOS names. For details on the use of NetBIOS scopes, see rfc1001.txt and rfc1002.txt. NetBIOS scopes are very rarely used, only set this parameter if you are the system administrator in charge of all the NetBIOS systems you communicate with.


  • -T This causes any IP addresses found in the lookup to be looked up via a reverse DNS lookup into a DNS name, and printed out before each "IP address NetBIOS name" pair that is the normal output.


  • name This is the NetBIOS name being queried. Depending upon the previous options this may be a NetBIOS name or IP address. If a NetBIOS name then the different name types may be specified by appending #<type> to the name. This name may also be "*", which will return all registered names within a broadcast area.



    EXAMPLES


    nmblookup can be used to query a WINS server (in the same way nslookup is used to query DNS servers). To query a WINS server, nmblookup must be called like this:


    nmblookup -U server -R 'name'


    For example, running :


    nmblookup -U samba.org -R IRIX#1B'


    would query the WINS server samba.org for the domain master browser (1B name type) for the IRIX workgroup.


    VERSION


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


    SEE ALSO


    samba (7), nmbd (8), smb.conf (5)


    AUTHOR


    The original Samba software and related utilities were created by Andrew Tridgell samba-bugs@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-bugs@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.


    usr/lib/samba/swat/help/samba.7.html100644 0 0 16100 6750314400 15640 0ustar rootroot Samba (7)


    Samba (7)

    Samba

    23 Oct 1998


    NAME

    Samba - A Windows SMB/CIFS fileserver for UNIX


    SYNOPSIS

    Samba


    DESCRIPTION


    The Samba software suite is a collection of programs that implements the Server Message Block(commonly abbreviated as SMB) protocol for UNIX systems. This protocol is sometimes also referred to as the Common Internet File System (CIFS), LanManager or NetBIOS protocol.


    COMPONENTS


    The Samba suite is made up of several components. Each component is described in a separate manual page. It is strongly recommended that you read the documentation that comes with Samba and the manual pages of those components that you use. If the manual pages aren't clear enough then please send a patch or bug report to samba-bugs@samba.org.



    AVAILABILITY


    The Samba software suite is licensed under the GNU Public License (GPL). A copy of that license should have come with the package in the file COPYING. You are encouraged to distribute copies of the Samba suite, but please obey the terms of this license.


    The latest version of the Samba suite can be obtained via anonymous ftp from samba.org in the directory pub/samba/. It is also available on several mirror sites worldwide.


    You may also find useful information about Samba on the newsgroup comp.protocols.smb and the Samba mailing list. Details on how to join the mailing list are given in the README file that comes with Samba.


    If you have access to a WWW viewer (such as Netscape or Mosaic) then you will also find lots of useful information, including back issues of the Samba mailing list, at http://samba.org/samba/.


    VERSION


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


    CONTRIBUTIONS


    If you wish to contribute to the Samba project, then I suggest you join the Samba mailing list at samba@samba.org. See the Web page at http://samba.org/listproc for details on how to do this.


    If you have patches to submit or bugs to report then you may mail them directly to samba-bugs@samba.org. Note, however, that due to the enormous popularity of this package the Samba Team may take some time to respond to mail. We prefer patches in diff -u format.


    CREDITS


    Contributors to the project are now too numerous to mention here but all deserve the thanks of all Samba users. To see a full list, look at ftp://samba.org/pub/samba/alpha/change-log for the pre-CVS changes and at ftp://samba.org/pub/samba/alpha/cvs.log for the contributors to Samba post-CVS. CVS is the Open Source source code control system used by the Samba Team to develop Samba. The project would have been unmanageable without it.


    In addition, several commercial organizations now help fund the Samba Team with money and equipment. For details see the Samba Web pages at http://samba.org/samba/samba-thanks.html.


    AUTHOR


    The original Samba software and related utilities were created by Andrew Tridgell samba-bugs@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-bugs@samba.org. usr/lib/samba/swat/help/smb.conf.5.html100644 0 0 1060307 6750314401 16332 0ustar rootroot smb.conf (5)


    smb.conf (5)

    Samba

    23 Oct 1998


    NAME

    smb.conf - The configuration file for the Samba suite


    SYNOPSIS


    smb.conf The smb.conf file is a configuration file for the Samba suite. smb.conf contains runtime configuration information for the Samba programs. The smb.conf file is designed to be configured and administered by the swat (8) program. The complete description of the file format and possible parameters held within are here for reference purposes.


    FILE FORMAT


    The file consists of sections and parameters. A section begins with the name of the section in square brackets and continues until the next section begins. Sections contain parameters of the form


    'name = value'


    The file is line-based - that is, each newline-terminated line represents either a comment, a section name or a parameter.


    Section and parameter names are not case sensitive.


    Only the first equals sign in a parameter is significant. Whitespace before or after the first equals sign is discarded. Leading, trailing and internal whitespace in section and parameter names is irrelevant. Leading and trailing whitespace in a parameter value is discarded. Internal whitespace within a parameter value is retained verbatim.


    Any line beginning with a semicolon (';') or a hash ('#') character is ignored, as are lines containing only whitespace.


    Any line ending in a '\' is "continued" on the next line in the customary UNIX fashion.


    The values following the equals sign in parameters are all either a string (no quotes needed) or a boolean, which may be given as yes/no, 0/1 or true/false. Case is not significant in boolean values, but is preserved in string values. Some items such as create modes are numeric.


    SECTION DESCRIPTIONS


    Each section in the configuration file (except for the [global] section) describes a shared resource (known as a "share"). The section name is the name of the shared resource and the parameters within the section define the shares attributes.


    There are three special sections, [global], [homes] and [printers], which are described under 'special sections'. The is preserup is to send the query to the broadcast address of the primary network interface as either auto-detected or defined in the interfaces parameter of the smb.conf (5) file.


  • -U unicast address Do a unicast query to the specified address or host "unicast address". This option (along with the -R option) is needed to query a WINS server.


  • -d debuglevel debuglevel is an integer from 0 to 10.


    The default value if this parameter is not specified is zero.


    The higher this value, the more detail will be logged about the activities of nmblookup. At level 0, only critical errors and serious warnings will be logged.


    Levels above 1 will generate considerable amounts of log data, and should only be used when investigating a problem. Levels above 3 are designed for use only by developers and generate HUGE amounts of data, most of which is extremely cryptic.


    Note that specifying this parameter here will override the log level parameter in the smb.conf (5) file.


  • -s smb.conf This parameter specifies the pathname to the Samba configuration file, smb.conf. This file controls all aspects of the Samba setup on the machine.


  • -i scope This specifies a NetBIOS scope that nmblookup will use to communicate with when generating NetBIOS names. For details on the use of NetBIOS scopes, see rfc1001.txt and rfc1002.txt. NetBIOS scopes are very rarely used, only set this parameter if you are the system administrator in charge of all the NetBIOS systems you communicate with.


  • -T This causes any IP addresses found in the lookup to be looked up via a reverse DNS lookup into a DNS name, and printed out before each "IP address NetBIOS name" pair that is the normal output.


  • name This is the NetBIOS name being queried. Depending upon the previous options this may be a NetBIOS name or IP address. If a NetBIOS name then the different name types may be specified by appending #<type> to the name. This name may also be "*", which will return all registered names within a broadcast area.



    EXAMPLES


    nmblookup can be used to query a WINS server (in the same way nslookup is used to query DNS servers). To query a WINS server, nmblookup must be called like this:


    nmblookup -U server -R 'name'


    For example, running :


    nmblookup -U samba.org -R IRIX#1B'


    would query the WINS server samba.org for the domain master browser (1B name type) for the IRIX workgroup.


    VERSION


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


    SEE ALSO


    samba (7), nmbd (8), smb.conf (5)


    AUTHOR


    The original Samba software and related utilities were created by Andrew Tridgell samba-bugs@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-bugs@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.


    usr/lib/samba/swat/help/samba.7.html100644 0 0 16100 6750314400 15640 0ustar rootroot Samba (7)


    Samba (7)

    Samba

    23 Oct 1998


    NAME

    Samba - A Windows SMB/CIFS fileserver for UNIX


    SYNOPSIS

    Samba


    DESCRIPTION


    The Samba software suite is a collection of programs that implements the Server Message Block(commonly abbreviated as SMB) protocol for UNIX systems. This protocol is sometimes also referred to as the Common Internet File System (CIFS), LanManager or NetBIOS protocol.


    COMPONENTS


    The Samba suite is made up of several components. Each component is described in a separate manual page. It is strongly recommended that you read the documentation that comes with Samba and the manual pages of those components that you use. If the manual pages aren't clear enough then please send a patch or bug report to samba-bugs@samba.org.



    AVAILABILITY


    The Samba software suite is licensed under the GNU Public License (GPL). A copy of that license should have come with the package in the file COPYING. You are encouraged to distribute copies of the Samba suite, but please obey the terms of this license.


    The latest version of the Samba suite can be obtained via anonymous ftp from samba.org in the directory pub/samba/. It is also available on several mirror sites worldwide.


    You may also find useful information about Samba on the newsgroup comp.protocols.smb and the Samba mailing list. Details on how to join the mailing list are given in the README file that comes with Samba.


    If you have access to a WWW viewer (such as Netscape or Mosaic) then you will also find lots of useful information, including back issues of the Samba mailing list, at http://samba.org/samba/.


    VERSION


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


    CONTRIBUTIONS


    If you wish to contribute to the Samba project, then I suggest you join the Samba mailing list at samba@samba.org. See the Web page at http://samba.org/listproc for details on how to do this.


    If you have patches to submit or bugs to report then you may mail them directly to samba-bugs@samba.org. Note, however, that due to the enormous popularity of this package the Samba Team may take some time to respond to mail. We prefer patches in diff -u format.


    CREDITS


    Contributors to the project are now too numerous to mention here but all deserve the thanks of all Samba users. To see a full list, look at ftp://samba.org/pub/samba/alpha/change-log for the pre-CVS changes and at ftp://samba.org/pub/samba/alpha/cvs.log for the contributors to Samba post-CVS. CVS is the Open Source source code control system used by the Samba Team to develop Samba. The project would have been unmanageable without it.


    In addition, several commercial organizations now help fund the Samba Team with money and equipment. For details see the Samba Web pages at http://samba.org/samba/samba-thanks.html.


    AUTHOR


    The original Samba software and related utilities were created by Andrew Tridgell samba-bugs@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-bugs@samba.org. usr/lib/samba/swat/help/smb.conf.5.html100644 0 0 1060307 6750314401 16332 0ustar rootroot smb.conf (5)


    smb.conf (5)

    Samba

    23 Oct 1998


    NAME

    smb.conf - The configuration file for the Samba suite


    SYNOPSIS


    smb.conf The smb.conf file is a configuration file for the Samba suite. smb.conf contains runtime configuration information for the Samba programs. The smb.conf file is designed to be configured and administered by the swat (8) program. The complete description of the file format and possible parameters held within are here for reference purposes.


    FILE FORMAT


    The file consists of sections and parameters. A section begins with the name of the section in square brackets and continues until the next section begins. Sections contain parameters of the form


    'name = value'


    The file is line-based - that is, each newline-terminated line represents either a comment, a section name or a parameter.


    Section and parameter names are not case sensitive.


    Only the first equals sign in a parameter is significant. Whitespace before or after the first equals sign is discarded. Leading, trailing and internal whitespace in section and parameter names is irrelevant. Leading and trailing whitespace in a parameter value is discarded. Internal whitespace within a parameter value is retained verbatim.


    Any line beginning with a semicolon (';') or a hash ('#') character is ignored, as are lines containing only whitespace.


    Any line ending in a '\' is "continued" on the next line in the customary UNIX fashion.


    The values following the equals sign in parameters are all either a string (no quotes needed) or a boolean, which may be given as yes/no, 0/1 or true/false. Case is not significant in boolean values, but is preserved in string values. Some items such as create modes are numeric.


    SECTION DESCRIPTIONS


    Each section in the configuration file (except for the [global] section) describes a shared resource (known as a "share"). The section name is the name of the shared resource and the parameters within the section define the shares attributes.


    There are three special sections, [global], [homes] and [printers], which are described under 'special sections'. The is preserup is to send the query to the broadcast address of the primary network interface as either auto-detected or defined in the interfaces parameter of the smb.conf (5) file.


  • -U unicast address Do a unicast query to the specified address or host "unicast address". This option (along with the -R option) is needed to query a WINS server.


  • -d debuglevel debuglevel is an integer from 0 to 10.


    The default value if this parameter is not specified is zero.


    The higher this value, the more detail will be logged about the activities of nmblookup. At level 0, only critical errors and serious warnings will be logged.


    Levels above 1 will generate considerable amounts of log data, and should only be used when investigating a problem. Levels above 3 are designed for use only by developers and generate HUGE amounts of data, most of which is extremely cryptic.


    Note that specifying this parameter here will override the log level parameter in the smb.conf (5) file.


  • -s smb.conf This parameter specifies the pathname to the Samba configuration file, smb.conf. This file controls all aspects of the Samba setup on the machine.


  • -i scope This specifies a NetBIOS scope that nmblookup will use to communicate with when generating NetBIOS names. For details on the use of NetBIOS scopes, see rfc1001.txt and rfc1002.txt. NetBIOS scopes are very rarely used, only set this parameter if you are the system administrator in charge of all the NetBIOS systems you communicate with.


  • -T This causes any IP addresses found in the lookup to be looked up via a reverse DNS lookup into a DNS name, and printed out before each "IP address NetBIOS name" pair that is the normal output.


  • name This is the NetBIOS name being queried. Depending upon the previous options this may be a NetBIOS name or IP address. If a NetBIOS name then the different name types may be specified by appending #<type> to the name. This name may also be "*", which will return all registered names within a broadcast area.



    EXAMPLES


    nmblookup can be used to query a WINS server (in the same way nslookup is used to query DNS servers). To query a WINS server, nmblookup must be called like this:


    nmblookup -U server -R 'name'


    For example, running :


    nmblookup -U samba.org -R IRIX#1B'


    would query the WINS server samba.org for the domain master browser (1B name type) for the IRIX workgroup.


    VERSION


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


    SEE ALSO


    samba (7), nmbd (8), smb.conf (5)


    AUTHOR


    The original Samba software and related utilities were created by Andrew Tridgell samba-bugs@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-bugs@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.


    usr/lib/samba/swat/help/samba.7.html100644 0 0 16100 6750314400 15640 0ustar rootroot Samba (7)


    Samba (7)

    Samba

    23 Oct 1998


    NAME

    Samba - A Windows SMB/CIFS fileserver for UNIX


    SYNOPSIS

    Samba


    DESCRIPTION


    The Samba software suite is a collection of programs that implements the Server Message Block(commonly abbreviated as SMB) protocol for UNIX systems. This protocol is sometimes also referred to as the Common Internet File System (CIFS), LanManager or NetBIOS protocol.


    COMPONENTS


    The Samba suite is made up of several components. Each component is described in a separate manual page. It is strongly recommended that you read the documentation that comes with Samba and the manual pages of those components that you use. If the manual pages aren't clear enough then please send a patch or bug report to samba-bugs@samba.org.



    AVAILABILITY


    The Samba software suite is licensed under the GNU Public License (GPL). A copy of that license should have come with the package in