added auto.home parameters - contributed by simeon@bangor.ac.uk.

lkcl

1 files changed, 62 insertions, 0 deletions

diff --git a/docs/manpages/smb.conf.5 b/docs/manpages/smb.conf.5
index 753edca79fc..897ae2aeb37 100644
--- a/docs/manpages/smb.conf.5
+++ b/docs/manpages/smb.conf.5
@@ -341,6 +341,8 @@ encrypt passwords
 
 getwd cache
 
+homedir map
+
 hosts equiv
 
 include
@@ -373,6 +375,8 @@ max xmit
 
 message command
 
+nis homedir
+
 null passwords
 
 os level
@@ -429,6 +433,8 @@ strip dot
 
 time offset
 
+unix realname
+
 username map
 
 use rhosts
@@ -719,6 +725,8 @@ shares in a net view and in the browse list.
 
 .B Example: 
 	browseable = No
+.SS case sensitive (G)
+See the discussion on NAME MANGLING.
 
 .SS case sig names (G)
 See "case sensitive"
@@ -1068,6 +1076,29 @@ a dot appear as hidden files.
 
 .B Example:
 	hide dot files = no
+.SS homedir map (G)
+If "nis homedir" is true, this parameter specifies the NIS (or YP) map
+from which the server for the user's home directory should be extracted.
+At present, only the Sun auto.home map format is understood. The form of
+the map is:
+
+username	server:/some/file/system
+
+and the program will extract the servername from before the first ':'.
+There should probably be a better parsing system that copes with different
+map formats and also Amd (another automounter) maps.
+
+NB: The -DNETGROUP option is required in the Makefile for option to work
+and on some architectures the line -lrpcsvc needs to be added to the
+LIBSM variable. This is required for Solaris 2, FreeBSD and HPUX.
+
+See also "nis homedir"
+
+.B Default:
+	homedir map = auto.home
+
+.B Example:
+	homedir map = amd.homedir
 .SS hosts allow (S)
 See
 .B allow hosts.
@@ -1768,6 +1799,26 @@ kilobytes. The default is 0, which means no limit.
 .B Example:
 	min print space = 2000
 
+.SS nis homedir (G)
+Get the home share server from a NIS (or YP) map. For unix systems that
+use an automounter, the user's home directory will often be mounted on
+a workstation on demand from a remote server. When the Samba logon server
+is not the actual home directory server, two network hops are required
+to access the home directory and this can be very slow especially with 
+writing via Samba to an NFS mounted directory. This option allows samba
+to return the home share as being on a different server to the logon
+server and as long as a samba daemon is running on the home directory 
+server, it will be mounted on the Samba client directly from the directory
+server. When Samba is returning the home share to the client, it will
+consult the NIS (or YP) map specified in "homedir map" and return the
+server listed there.
+
+.B Default:
+	nis homedir = false
+
+.B Example:
+	nis homedir = true
+
 .SS null passwords (G)
 Allow or disallow access to accounts that have null passwords. 
 
@@ -2629,6 +2680,17 @@ that have incorrect daylight saving time handling.
 .B Example:
 	time offset = 60
 
+.SS unix realname (G)
+This boolean parameter when set causes samba to supply the real name field
+from the unix password file to the client. This is useful for setting up
+mail clients and WWW browsers on systems used by more than one person.
+
+.B Default:
+	unix realname = no
+
+.B Example:
+	unix realname = yes
+
 .SS user (S)
 See
 .B username.