JHT ==> Just tidying up for Release.
[sfrench/samba-autobuild/.git] / examples / smb.conf.default
1 ; The global setting for a default install
2 ; Copyright(C) John H Terpstra - 1997
3 ;======================= Global Settings =====================================
4 [global]
5
6 ; workgroup = NT-Domain-Name or Workgroup-Name, eg: REDHAT4
7    workgroup = WORKGROUP
8
9 ; comment is the equivalent of the NT Description field
10    comment = Samba Server
11
12 ; printing = BSD or SYSV or AIX, etc.
13    printing = bsd
14    printcap name = /etc/printcap
15    load printers = yes
16
17 ; Uncomment this if you want a guest account, you must add this to /etc/passwd
18 ;  guest account = pcguest
19    log file = /usr/local/samba/var/log.%m
20
21 ; Put a capping on the size of the log files (in Kb)
22    max log size = 50
23
24 ; Options for handling file name case sensitivity and / or preservation
25 ; Case Sensitivity breaks many WfW and Win95 apps
26 ;   case sensitive = yes
27     short preserve case = yes
28     preserve case = yes
29
30 ; Security and file integrity related options
31    lock directory = /usr/local/samba/var/locks
32    locking = yes
33 ; Strict locking is available for paranoid locking situations only
34 ;        enabling this severely degrades read / write performance.
35 ;   strict locking = yes
36 ;   fake oplocks = yes
37    share modes = yes
38
39 ; Security modes: USER uses Unix username/passwd, SHARE uses WfW type passwords
40 ;        SERVER uses an other SMB server (eg: Windows NT Server or Samba)
41 ;        to provide authentication services
42    security = user
43 ; Use password server option only with security = server
44 ;   password server = <NT-Server-Name>
45
46 ; Configuration Options ***** The location of this entry in your smb.conf
47 ; heirachy determines  which parameters are overwritten - please watch out!
48 ; Where %m is any SMBName (machine name, or computer name) for which a custom
49 ; configuration is desired
50 ;   include = /usr/local/samba/lib/smb.conf.%m
51
52 ; Performance Related Options
53 ; Before setting socket options read the smb.conf man page!!
54    socket options = TCP_NODELAY 
55 ; Socket Address is used to specify which socket Samba
56 ; will listen on (good for aliased systems)
57 ;   socket address = aaa.bbb.ccc.ddd
58 ; Use keep alive only if really needed!!!!
59 ;   keep alive = 60
60 ; Configure Samba to use multiple interfaces
61 ;        Samba will auto-detect network interfaces - only use this if
62 ;        the auto-detection does not deliver the needed results
63 ;   interfaces = 192.168.12.2/24 176.16.111.22/19 10.11.13.14/255.255.252.0
64
65 ; Browser Control Options:
66 ; Local Master set to True causes Samba to participate in browser elections
67 ;       the default setting is true, this causes Samba to behave like a
68 ;       Windows NT server. Setting this to false turns off all browser
69 ;       election participation.
70 ;   local master = yes
71
72 ; OS Level gives Samba the power to win browser elections. Windows NT = 32
73 ;       Any value < 32 means NT wins as Master Browser, > 32 Samba gets it
74 ;       default = 0, this ensures that Samba will NOT win the browser election.
75 ;   os level = 33
76
77 ; Domain Master specifies Samba to be the Domain Master Browser
78 ;       Only ever set this if there is NO Windows NT Domain Controller on the
79 ;       network
80 ;   domain master = yes 
81
82 ; Preferred Master causes Samba to force a local browser election on startup
83 ;   preferred master = yes
84
85 ; Use with care only if you have an NT server on your network that has been
86 ; configured at install time to be a primary domain controller.
87 ;   domain controller = <NT-Domain-Controller-SMBName>
88
89 ; Domain Logon Service Options:
90 ; Domain logon control can be a good thing! See [netlogon] share section below!
91 ;       Do NOT set this to yes if there is an Windows NT domain controller
92 ;       on the network
93 ;   domain logons = yes
94
95 ; run a specific logon batch file per workstation (machine)
96 ;   logon script = %m.bat
97 ; run a specific logon batch file per username
98 ;   logon script = %u.bat
99
100 ; Where to store roving profiles (only for Win95 and WinNT)
101 ;        %L substitutes for the SMB name we are called, %U is username
102 ;        You must uncomment the [Profiles] share below
103 ;   logon path = \\%L\Profiles\%U
104
105 ; Windows Internet Name Serving Support Section:
106 ; WINS Support - Tells the NMBD component of Samba to enable it's WINS Server
107 ;       the default is NO. If you have an Windows NT Server WINS use it!
108 ;       Samba defaults to wins support = no
109 ;   wins support = yes
110
111 ; WINS Server - Tells the NMBD components of Samba to be a WINS Client
112 ;       Note: Samba can be either a WINS Server, or a WINS Client, but NOT both
113 ;   wins server = w.x.y.z
114
115 ; WINS Proxy - Tells Samba to answer name resolution queries on behalf of a non
116 ;       WINS Client capable client, for this to work there must be at least one
117 ;       WINS Server on the network. The default is NO.
118 ;   wins proxy = yes
119
120 ;============================ Share Definitions ==============================
121 [homes]
122    comment = Home Directories
123    browseable = no
124    writable = yes
125
126 ; Un-comment the following and create the netlogon directory for Domain Logons
127 ; [netlogon]
128 ;   comment = Samba Network Logon Service
129 ;   path = /usr/local/samba/lib/netlogon
130 ; Case sensitivity breaks logon script processing!!!
131 ;   case sensitive = no
132 ;   guest ok = yes
133 ;   locking = no
134 ;   writable = no
135 ;   For browseable say NO if you want to hide the NETLOGON share
136 ;   browseable = yes
137
138 ; Un-comment the following to provide a specific roving profile share
139 ; the default is to use the user's home directory
140 ;[Profiles]
141 ;    path = /usr/local/samba/profiles
142 ;    browseable = no
143 ;    printable = no
144 ;    guest ok = yes
145
146 ; NOTE: There is NO need to specifically define each individual printer
147 [printers]
148    comment = All Printers
149    path = /usr/spool/samba
150    browseable = no
151    printable = yes
152 ; Set public = yes to allow user 'guest account' to print
153    guest ok = no
154    writable = no
155    create mask = 0700
156
157 ;[tmp]
158 ;   comment = Temporary file space
159 ;   path = /tmp
160 ;   read only = no
161 ;   public = yes
162
163 ; A publicly accessible directory, but read only, except for people in
164 ; the staff group
165 [public]
166    comment = Public Stuff
167    path = /home/samba
168    public = yes
169    writable = yes
170    printable = no
171    write list = @users
172
173 ; Other examples. 
174 ;
175 ; A private printer, usable only by fred. Spool data will be placed in fred's
176 ; home directory. Note that fred must have write access to the spool directory,
177 ; wherever it is.
178 ;[fredsprn]
179 ;   comment = Fred's Printer
180 ;   valid users = fred
181 ;   path = /homes/fred
182 ;   printer = freds_printer
183 ;   public = no
184 ;   writable = no
185 ;   printable = yes
186 ;
187 ; A private directory, usable only by fred. Note that fred requires write
188 ; access to the directory.
189 ;[fredsdir]
190 ;   comment = Fred's Service
191 ;   path = /usr/somewhere/private
192 ;   valid users = fred
193 ;   public = no
194 ;   writable = yes
195 ;   printable = no
196 ;
197 ; a service which has a different directory for each machine that connects
198 ; this allows you to tailor configurations to incoming machines. You could
199 ; also use the %u option to tailor it by user name.
200 ; The %m gets replaced with the machine name that is connecting.
201 ;[pchome]
202 ;  comment = PC Directories
203 ;  path = /usr/pc/%m
204 ;  public = no
205 ;  writable = yes
206 ;
207 ;
208 ; A publicly accessible directory, read/write to all users. Note that all files
209 ; created in the directory by users will be owned by the default user, so
210 ; any user with access can delete any other user's files. Obviously this
211 ; directory must be writable by the default user. Another user could of course
212 ; be specified, in which case all files would be owned by that user instead.
213 ;[public]
214 ;   path = /usr/somewhere/else/public
215 ;   public = yes
216 ;   only guest = yes
217 ;   writable = yes
218 ;   printable = no
219 ;
220 ;
221 ; The following two entries demonstrate how to share a directory so that two
222 ; users can place files there that will be owned by the specific users. In this
223 ; setup, the directory should be writable by both users and should have the
224 ; sticky bit set on it to prevent abuse. Obviously this could be extended to
225 ; as many users as required.
226 ;[myshare]
227 ;   comment = Mary's and Fred's stuff
228 ;   path = /usr/somewhere/shared
229 ;   valid users = mary fred
230 ;   public = no
231 ;   writable = yes
232 ;   printable = no
233 ;   create mask = 0765
234