added --noacls options and checking for same mismatch in backtracking
[gd/samba/.git] / NEWS
1 This file aims to document the major changes since the latest released version 
2 of Samba, 3.0. Samba 4.0 contains rewrites of several subsystems 
3 and uses a different internal format for most data. Since this 
4 file is an initial draft, please update missing items.
5
6 One of the main goals of Samba 4 was Active Directory Domain Controller 
7 support. This means Samba now implements several protocols that are required 
8 by AD such as Kerberos and DNS.
9
10 An (experimental) upgrade script that performs a one-way upgrade 
11 from Samba 3 is available in source/setup/upgrade.
12
13 Removal of nmbd and introduction of process models
14 ==================================================
15 smbd now implements several network protocols other than just CIFS and 
16 DCE/RPC. nmbd's functionality has been merged into smbd. smbd supports 
17 various 'process models' that specify how concurrent connections are 
18 handled (when to fork, use threads, etc). 
19
20 Introduction of LDB
21 ===================
22 Samba now stores most of its persistent data in a LDAP-like database 
23 called LDB (see ldb(7) for more info). 
24
25 Removed SWAT
26 ==================
27 Unlike previous versions, Samba4 does not provide a web interface at this time.
28
29 Built-in KDC
30 ============
31 Samba4 ships with an integrated KDC (Kerberos Key Distribution
32 Center).  Backed directly onto our main internal database, and
33 integrated with custom code to handle the PAC, Samba4's KDC is an
34 integral part of our support for AD logon protocols.
35
36 Built-in LDAP Server
37 ====================
38 Like the situation with the KDC, Samba4 ships with it's own LDAP
39 server, included to provide simple, built-in LDAP services in an AD
40 (rather than distinctly standards) matching manner.  The database is
41 LDB, and it shares that in common with the rest of Samba.
42
43 Changed configuration options
44 =============================
45 Several configuration options have been removed in Samba4 while others have 
46 been introduced. This section contains a summary of changes to smb.conf and 
47 where these settings moved. Configuration options that have disappeared may be 
48 re-added later when the functionality that uses them gets reimplemented in 
49 Samba 4.
50
51 The 'security' parameter has been split up. It is now only used to choose 
52 between the 'user' and 'share' security levels (the latter is not supported 
53 in Samba 4 yet). The other values of this option and the 'domain master' and 
54 'domain logons' parameters have been merged into a 'server role' parameter 
55 that can be either 'domain controller', 'member server' or 'standalone'. Note that 
56 member server support does not work yet.
57
58 The following parameters have been removed:
59 - passdb backend: accounts are now stored in a LDB-based SAM database, 
60         see 'sam database' below.
61 - update encrypted
62 - public
63 - guest ok
64 - client schannel
65 - server schannel
66 - allow trusted domains
67 - hosts equiv
68 - map to guest
69 - smb passwd file
70 - algorithmic rid base
71 - root directory
72 - root dir
73 - root
74 - guest account
75 - enable privileges
76 - pam password change
77 - passwd program
78 - passwd chat debug
79 - passwd chat timeout
80 - check password script
81 - username map
82 - username level
83 - unix password sync
84 - restrict anonymous
85 - username
86 - user
87 - users
88 - invalid users
89 - valid users
90 - admin users
91 - read list
92 - write list
93 - printer admin
94 - force user
95 - force group
96 - group
97 - write ok
98 - writeable
99 - writable
100 - acl check permissions
101 - acl group control
102 - acl map full control
103 - create mask
104 - create mode
105 - force create mode
106 - security mask
107 - force security mode
108 - directory mask
109 - directory mode
110 - force directory mode
111 - directory security mask
112 - force directory security mode
113 - force unknown acl user
114 - inherit permissions
115 - inherit acls
116 - inherit owner
117 - guest only
118 - only guest
119 - only user
120 - allow hosts
121 - deny hosts
122 - preload modules
123 - use kerberos keytab
124 - syslog
125 - syslog only
126 - max log size
127 - debug timestamp
128 - timestamp logs
129 - debug hires timestamp
130 - debug pid
131 - debug uid
132 - allocation roundup size
133 - aio read size
134 - aio write size
135 - aio write behind
136 - large readwrite
137 - protocol
138 - read bmpx
139 - reset on zero vc
140 - acl compatibility
141 - defer sharing violations
142 - ea support
143 - nt acl support
144 - nt pipe support
145 - profile acls
146 - map acl inherit
147 - afs share
148 - max ttl
149 - client use spnego
150 - enable asu support
151 - svcctl list
152 - block size
153 - change notify timeout
154 - deadtime
155 - getwd cache
156 - keepalive
157 - kernel change notify
158 - lpq cache time
159 - max smbd processes
160 - max disk size
161 - max open files
162 - min print space
163 - strict allocate
164 - sync always
165 - use mmap
166 - use sendfile
167 - hostname lookups
168 - write cache size
169 - name cache timeout
170 - max reported print jobs
171 - load printers
172 - printcap cache time
173 - printcap name
174 - printcap
175 - printing
176 - cups options
177 - cups server
178 - iprint server
179 - print command
180 - disable spoolss
181 - enable spoolss
182 - lpq command
183 - lprm command
184 - lppause command
185 - lpresume command
186 - queuepause command
187 - queueresume command
188 - enumports command
189 - addprinter command
190 - deleteprinter command
191 - show add printer wizard
192 - os2 driver map
193 - use client driver
194 - default devmode
195 - force printername
196 - mangling method
197 - mangle prefix
198 - default case
199 - case sensitive
200 - casesignames
201 - preserve case
202 - short preserve case
203 - mangling char
204 - hide dot files
205 - hide special files
206 - hide unreadable
207 - hide unwriteable files
208 - delete veto files
209 - veto files
210 - hide files
211 - veto oplock files
212 - map readonly
213 - mangled names
214 - mangled map
215 - max stat cache size
216 - stat cache
217 - store dos attributes
218 - machine password timeout
219 - add user script
220 - rename user script
221 - delete user script
222 - add group script
223 - delete group script
224 - add user to group script
225 - delete user from group script
226 - set primary group script
227 - add machine script
228 - shutdown script
229 - abort shutdown script
230 - username map script
231 - logon script
232 - logon path
233 - logon drive
234 - logon home
235 - domain logons
236 - os level
237 - lm announce
238 - lm interval
239 - domain master
240 - browse list
241 - enhanced browsing
242 - wins proxy
243 - wins hook
244 - wins partners
245 - blocking locks
246 - fake oplocks
247 - kernel oplocks
248 - locking
249 - lock spin count
250 - lock spin time
251 - level2 oplocks
252 - oplock break wait time
253 - oplock contention limit
254 - posix locking
255 - share modes
256 - ldap server
257 - ldap port
258 - ldap admin dn
259 - ldap delete dn
260 - ldap group suffix
261 - ldap idmap suffix
262 - ldap machine suffix
263 - ldap passwd sync
264 - ldap password sync
265 - ldap replication sleep
266 - ldap suffix
267 - ldap ssl
268 - ldap timeout
269 - ldap page size
270 - ldap user suffix
271 - add share command
272 - change share command
273 - delete share command
274 - eventlog list
275 - utmp directory
276 - wtmp directory
277 - utmp
278 - default service
279 - default
280 - message command
281 - dfree cache time
282 - dfree command
283 - get quota command
284 - set quota command
285 - remote announce
286 - remote browse sync
287 - homedir map
288 - afs username map
289 - afs token lifetime
290 - log nt token command
291 - time offset
292 - NIS homedir
293 - preexec
294 - exec
295 - preexec close
296 - postexec
297 - root preexec
298 - root preexec close
299 - root postexec
300 - set directory
301 - wide links
302 - follow symlinks
303 - dont descend
304 - magic script
305 - magic output
306 - delete readonly
307 - dos filemode
308 - dos filetimes
309 - dos filetime resolution
310 - fake directory create times
311 - panic action
312 - vfs objects
313 - vfs object
314 - msdfs root
315 - msdfs proxy
316 - host msdfs
317 - enable rid algorithm
318 - passdb expand explicit
319 - idmap backend
320 - idmap uid
321 - winbind uid
322 - idmap gid
323 - winbind gid
324 - template homedir
325 - template shell
326 - winbind separator
327 - winbind cache time
328 - winbind enum users
329 - winbind enum groups
330 - winbind use default domain
331 - winbind trusted domains only
332 - winbind nested groups
333 - winbind max idle children
334 - winbind nss info
335  
336 The following parameters have been added:
337 + rpc big endian (G)
338         Make Samba fake it is running on a bigendian machine when using DCE/RPC. 
339         Useful for debugging.
340
341         Default: no
342
343 + case insensitive filesystem (S)
344         Set to true if this share is located on a case-insensitive filesystem.
345         This disables looking for a filename by trying all possible combinations of 
346         uppercase/lowercase characters and thus speeds up operations when a 
347         file cannot be found. 
348
349         Default: no
350         
351 + js include (G)
352         Path to JavaScript library. 
353
354         Default: Set at compile-time
355         
356 + setup directory
357         Path to data used by provisioning script.
358
359         Default: Set at compile-time
360         
361 + ncalrpc dir
362         Directory to use for UNIX sockets used by the 'ncalrpc' DCE/RPC transport.
363
364         Default: Set at compile-time
365         
366 + ntvfs handler
367         Backend to the NT VFS to use (more than one can be specified). Available
368         backends include: 
369         
370         - posix:
371                 Maps POSIX FS semantics to NT semantics
372
373         - simple:
374                 Very simple backend (original testing backend).
375
376         - unixuid:
377                 Sets up user credentials based on POSIX gid/uid.
378
379         - cifs:
380                 Proxies a remote CIFS FS. Mainly useful for testing.
381
382         - nbench:
383                 Filter module that saves data useful to the nbench benchmark suite.
384
385         - ipc:
386                 Allows using SMB for inter process communication. Only used for 
387                 the IPC$ share.
388
389         - print:
390                 Allows printing over SMB. This is LANMAN-style printing (?), not 
391                 the be confused with the spoolss DCE/RPC interface used by later 
392                 versions of Windows.
393         
394         Default: unixuid default
395
396 + ntptr providor
397         FIXME
398
399 + dcerpc endpoint servers
400         What DCE/RPC servers to start.
401
402         Default: epmapper srvsvc wkssvc rpcecho samr netlogon lsarpc spoolss drsuapi winreg dssetup
403
404 + server services
405         Services Samba should provide.
406
407         Default: smb rpc nbt wrepl ldap cldap web kdc
408
409 + sam database
410         Location of the SAM (account database) database. This should be a 
411         LDB URL.
412
413         Default: set at compile-time
414
415 + spoolss database
416         Spoolss (printer) DCE/RPC server database. This should be a LDB URL.
417
418         Default: set at compile-time
419
420 + wins config database
421         WINS configuration database location. This should be a LDB URL.
422
423         Default: set at compile-time
424         
425 + wins database
426         WINS database location. This should be a LDB URL.
427
428         Default: set at compile-time
429         
430 + client use spnego principal
431         Tells the client to use the Kerberos service principal specified by the 
432         server during the security protocol negotation rather than 
433         looking up the principal itself (cifs/hostname).
434
435         Default: false
436
437 + nbt port
438         TCP/IP Port used by the NetBIOS over TCP/IP (NBT) implementation.
439  
440         Default: 137
441
442 + dgram port
443         UDP/IP port used by the NetBIOS over TCP/IP (NBT) implementation.
444         
445         Default: 138
446
447 + cldap port
448         UDP/IP port used by the CLDAP protocol.
449
450         Default: 389
451
452 + krb5 port
453         IP port used by the kerberos KDC.       
454         
455         Default: 88
456         
457 + kpasswd port
458         IP port used by the kerberos password change protocol.
459
460         Default: 464
461         
462 + web port
463         TCP/IP port SWAT should listen on.
464
465         Default: 901
466
467 + tls enabled
468         Enable TLS support for SWAT
469         
470         Default: true
471         
472 + tls keyfile
473         Path to TLS key file (PEM format) to be used by SWAT. If no 
474         path is specified, Samba will create a key.
475
476         Default: none
477
478 + tls certfile
479         Path to TLS certificate file (PEM format) to be used by SWAT. If no 
480         path is specified, Samba will create a certificate.
481
482         Default: none
483         
484 + tls cafile
485         Path to CA authority file Samba will use to sign TLS keys it generates. If 
486         no path is specified, Samba will create a self-signed CA certificate.
487
488         Default: none
489
490 + tls crlfile
491         Path to TLS certificate revocation lists file.
492
493         Default: none
494
495 + swat directory
496         SWAT data directory.
497
498         Default: set at compile-time
499
500 + large readwrite
501         Indicate the CIFS server is able to do large reads/writes.
502
503         Default: true
504         
505 + unicode
506         Enable/disable unicode support in the protocol.
507
508         Default: true