smbclient.1: Added documentation of the username%password environment code.
[kai/samba.git] / docs / manpages / smb.conf.5
index 475eae8c7e0bd0b43c713b5ac05c40a6e9ad773f..869dbf9ffd8503f6ce72897256ef8d8af80d83ec 100644 (file)
@@ -477,6 +477,8 @@ time server
 
 unix realname
 
+username level
+
 username map
 
 use rhosts
@@ -3199,6 +3201,26 @@ on how this parameter determines access to the services.
        username = fred
        username = fred, mary, jack, jane, @users, @pcgroup
 
+.SS username level (G)
+
+This option helps Samba to try and 'guess' at the real UNIX username,
+as many DOS clients send an all-uppercase username. By default Samba
+tries all lowercase, followed by the username with the first letter
+capitalized, and fails if the username is not found on the UNIX machine.
+
+If this parameter is set to non-zero the behaviour changes. This 
+parameter is a number that specifies the number of uppercase combinations 
+to try whilst trying to determine the UNIX user name. The higher the number
+the more combinations will be tried, but the slower the discovery
+of usernames will be. Use this parameter when you have strange
+usernames on your UNIX machine, such as 'AstrangeUser'.
+
+.B Default:
+    username level = 0
+
+.B Example:
+    username level = 5
+
 .SS username map (G)
 
 This option allows you to to specify a file containing a mapping of