docs: Documents length limitations for NetBIOS name
[Samba.git] / docs-xml / smbdotconf / base / netbiosname.xml
blobed7dd5ec57d3bfdab9f43a1d8cd2d09f01883df0
1 <samba:parameter name="netbios name"
2                  context="G"
3                  type="string"
4                  constant="1"
5                  xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
6 <description>
7         <para>
8                 This sets the NetBIOS name by which a Samba server is known. By default it is the same as the first component
9                 of the host's DNS name. If a machine is a browse server or logon server this name (or the first component of
10                 the hosts DNS name) will be the name that these services are advertised under.
11                 </para>
13                 <para>Note that the maximum length for a NetBIOS name is 15 charactars.</para>
15                 <para>
16                 There is a bug in Samba that breaks operation of browsing and access to shares if the netbios name
17                 is set to the literal name <literal>PIPE</literal>. To avoid this problem, do not name your Samba
18                 server <literal>PIPE</literal>.
19                 </para>
20 </description>
22 <related>netbios aliases</related>
23 <value type="default"><comment>machine DNS name</comment></value>
24 <value type="example">MYNAME</value>
25 </samba:parameter>