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