JHT ==> Still getting ready for 1.9.17 release.
[samba.git] / docs / INSTALL.txt
index 6f752b63971c657abf33e7a35fe54f1ee7e47177..a97d5f26790c49f8eb54ed60b175334dc29330c5 100644 (file)
@@ -1,5 +1,9 @@
-HOW TO INSTALL AND TEST SAMBA
-=============================
+Contributor:   Andrew Tridgell <samba-bugs@samba.anu.edu.au>
+Date:          Unknown
+Status:                Current
+
+Subject:       HOW TO INSTALL AND TEST SAMBA
+===============================================================================
 
 
 STEP 0. Read the man pages. They contain lots of useful info that will
@@ -8,6 +12,10 @@ try something like:
 
        nroff -man smbd.8 | more
 
+Unfortunately, having said this, the man pages are sadly out of date and
+really need more effort to maintain them. Other sources of information 
+are pointed to by the Samba web site, http://samba.canberra.edu.au/pub/samba.
+
 STEP 1. Building the binaries
 
 To do this, first edit the file source/Makefile. You will find that
@@ -49,10 +57,11 @@ options.
 
 The simplest useful configuration file would be something like this:
 
-[homes]
-       workgroup = MYGROUP
-       guest ok = no
-       read only = no
+   workgroup = MYGROUP
+
+   [homes]
+      guest ok = no
+      read only = no
 
 which would allow connections by anyone with an account on the server,
 using either their login name or "homes" as the service name. (Note
@@ -230,8 +239,9 @@ CHOOSING THE PROTOCOL LEVEL
 The SMB protocol has many dialects. Currently Samba supports 5, called
 CORE, COREPLUS, LANMAN1, LANMAN2 and NT1.
 
-You can choose what protocols to support in the smb.conf file. The
-default is NT1 and that is the best for the vast majority of sites.
+You can choose what maximum protocol to support in the smb.conf
+file. The default is NT1 and that is the best for the vast majority of
+sites.
 
 In older versions of Samba you may have found it necessary to use
 COREPLUS. The limitations that led to this have mostly been fixed. It
@@ -310,7 +320,9 @@ compatability modes called DENY_FCB and DENY_DOS.
 
 You can disable share modes using "share modes = no". This may be
 useful on a heavily loaded server as the share modes code is very
-slow. 
+slow. See also the FAST_SHARE_MODES option in the Makefile for a way
+to do full share modes very fast using shared memory (if your OS
+supports it).
 
 
 MAPPING USERNAMES