update whatsnew and increment version
[Samba.git] / WHATSNEW.txt
blobe277d32705e36706daf18fbdefb9ac45af25e7ed
1             WHAT'S NEW IN Samba 2.2.6rc1  - 9th October 2002
2             ================================================
4 This is a prelease snapshot of SAMBA_2_2 cvs branch.  This is a non-production
5 release provided for testing purposes only.
7 The following new new smb.conf(5) options have been added in this preview
8 release:
10         * profiles acls (S)
12 The following options have been added to Samba's configure script
14         --with-sendfile (enable experiemental sendfile support)
17 Changes since 2.2.6pre2
18 -----------------------
19 1)  Merge in freelist unlock on error fix
20 2)  Correctly fail opens with mismatching SYSTEM or HIDDEN attributes
21     if we are mapping system or hidden
22 3)  Fix bug with stat mode open being done on read-only open with truncate
23 4)  Fix crashbug discovered where cli struct was being deallocated in a
24     called function
25 5)  Ensure we open UNIX fifo's non-blocking
26 6)  Fix DeletePrinterDriver() (hopefully for the last time...yeah right....)
27 7)  only lowercase global_myname in the %L substitution, not the whole string
28 8)  Merged Steve French's fix for OS/2 EA return error being removed
29 9)  Patch from Steve French to fix difference in responses to smbclient
30     //server/share ls / on Samba and Windows 2000
31 10) Print error and exit if smb.conf doesn't have security=domain and 
32     encrypt passwords=yes when joining domain
33 11) Added final Steve French patch for "required" attributes with old dir 
34     listings
35 12) Initialise user_rid value in WINBIND_USERINFO structure returned by 
36     the rpc version of query_user()
37 13) Ensure we've failed a lock with a lock denied message before automatically 
38     pushing it onto the blocking queue
39 14) Add experiemental --with-sendfile code
40 15) alignment fix in printing code merged from HEAD
41 16) Merge fix for other sids in token from HEAD
42 17) Merge winbindd with current (more advanced) state of play in APPLIANCE_HEAD
43 18) fix smbclient / Win98 off by one bug
44 19) Never, *ever* hold a mutex lock in the message database where there may be
45     traversals being attempted
46 20) Add LDAP hack for retrieving the SAM sequence number whe a member of a 
47     Windows 2000 native mode domain
48 21) Fix race condition when changing a machine acount password as we were 
49     no longer locking the secrets entry
50 22) Allow '@' as a valid character in domain names
51 23) remove jobs from the spool directory when using cups
52 24) removed -lresolv for --enable-ldapsam
53 25) Memory leak fix and correct use of negative caching in winbindd
54 26) Updated spoolss parsing code with known good state of APPLIANCE_HEAD
55 27) Delete printer security check was reversed
56 28) Windows allows delete printer on a handle opened by an admin user, then
57     used on a pipe handle created by an anonymous user...We do to now...
58 29) Make explicit the difference between a tdb key with no data attached, and 
59     a non existent entry
60 30) Ensure we register the 1c name on the unicast subnet.
61 31) Fix inheritance problem when recusively setting ACLs on directories
62 32) prevent ACL set on read-only share
63 33) Ensure we never have more than MAX_PRINT_JOBS in a queue
64 34) Added timeout to tdb_lock_bystring()
65 35) Ensure we set FIRST+LAST flags on a bind request
66 36) Add version strings to the usage message for smbcacls and smbpasswd
67 37) Fix bug in the write cache code
68 38) make the default printed values for boolean the same for all parameters
71 Changes since 2.2.6pre1
72 -----------------------
73 1)  fix incorrect semantics in the DeletePrinterDriver() spoolss rpc
74     to only attempt to delete the architecture specified by the client
75 2)  Don't allow TEMP attribute on directory open
76 3)  Restore VxFS quotas to the 2.2 branch
77 4)  Added basic "Wizard" functionality to SWAT
78 5)  Fix initial "allocation size" in NTcreate&X call
79 6)  Fix for open fid, "nametoolong"
80 7)  Exit server on receipt of a non-SMB packet.  Ensure we have 
81     at least smb_size bytes before processing a packet
82 8)  Replace inet_aton with inet_addr() to correct compile problems on Solaris
83 9)  Include the "account" objectclass when adding a new account to --with-ldapsam
84     in order to comply with the data model implemented by OpenLDAP 2.1.x
85 10) Various fixes for POSIX compliance
86 11) Correct alignment & offset bug in EnumPrinterDataEx()
87 12) Fix access checks when modifying forms using a print server handle
88     (not just a printer handle)
89 13) Account for case data_len == 0 in EnumPrinterDataEx()
90 14) Fix logic error in blocking lock code
91 15) Fixed various incorrect return codes to clients
92 16) Add RESOLVE_DFSPATH to mkdir operations
93 17) Fix longstanding bug in Win2k clients by clearing the shortname
94     buffer before returning ASCII short name
95 18) added -t option to smbpasswd for explicitly changing a trust 
96     account password when operating in security = domain
97 19) installed -x option to testparm to eXclude printing all parameter
98     values that are at default settings.
99 20) Fix shares/printers view in SWAT so that only Basic options are exposed
100     upon initial entry.
101 21) Added 1125 & KOI8-U to codepage list in Makefile.in
102 22) Include separate configure checks for *openbsd* & *freebsd* when
103     determining flags used to compile shared libraries.
108 Changes since 2.2.5
109 --------------------
111 1)  Fixed several compiler warnings caused by the use of const parameters
112 2)  Fixed a hang in the main smbd process caused by an EINTR in the
113     wrong place
114 3)  Fixed string substitutions to accept a length for sanity checks
115 4)  Fixed 17-bit length field in nmb header
116 5)  Removed non-portable inline declaration for functions
117 6)  Performance fix for including files with an smb.conf variable in the
118     path name
119 7)  Fix for parsing LPRng lpq output
120 8)  Parsing fix for PRINTER_INFO_2 structure which was causing viewing
121     printer properties to fail
122 9)  Fix for printer change notification and Windows NT clients which caused
123     the client to go into an infinite loop of refeshing the local printers
124     folder
125 10) Allow trans2 and nttrans messages to be processed in oplock break state
126     which fixes a problem with oplock break requests and Win2k clients
127 11) Don't crash on setfileinfo on printer fsp
128 12) Memory fixes caught by Valgrind
129 13) Updates to stop spurious error message in tdb
130 14) Fix silly logic bug in 'make smbd processes' and 'status = no' check
131 15) Fix compilation of pam_smbpass and --with-ldap
132 16) Fix compilation of samwrapper on Solaris hosts
133 17) fix logic error in a check for enableing the winbind_pam_auth_crap() code
134     & fix formatting typo in --with-winbind-auth-challenge
135 18) Correcting check for ldap_start_tls()
136 19) Fixed a problem with getgroups() where it could include our current
137     effective gid
140               =========================================
142 Older releases notes for 2.2.x distributions follow
144 -----------------------------------------------------------------------------
145 The release notes for 2.2.5 follow :
147 There have been several fixes and internal enhancements which include:
149 * Several compile fixes for Solaris and HP-UX
150 * More printing fixes for Windows NT/2k/XP clients
151 * New options for the VFS recycle bin library
152 * New internal signal handling semantics relating to directory change
153   notification and oplocks
155 New/Changed parameters in 2.2.5
156 --------------------------------
158 For more information on these parameters, see the man pages for
159 smb.conf(5).
161 Added/changed parameters
162 ------------------------
164 * block size = <INTEGER>
165 * force unknown acl user = <boolean>
166 * mangling method = [hash|hash2]
169 Deprecated Parameters
170 ---------------------
172 The following parameters have been marked as deprecated and will be removed
173 in Samba 3.0
175 * strip dot
176 * status
179 Removed Parameters
180 ------------------
182   none
185 Changes in 2.2.5
186 ----------------
188 See the cvs log for SAMBA_2_2 for more details
190 1)  Removal of several compiler warnings, incorrect Makefile dependencies,
191     and wrong autoconf tests on various platforms--Solaris & HP-UX 10.20
192     being the predominantly reported platforms
193 2)  Fixed winbindd crash bug on the IBM s390 running Linux
194 3)  Inclusion of enhanced Linux quota support
195 4)  Correctly link against Sun LDAP libraries on Solaris 8 (even through
196     there is no apparent SSL support there)
197 5)  POSIX conformance patches
198 6)  Include new configure --enable-cups option (can also be disabled even
199     if CUPS libraries are installed on the system)
200 7)  Set reasonable default for the "passwd program" parameter using an
201     autoconf test
202 8)  Added --with-winbind-auth for enabling winbindd_pam_auth_crap() code
203 9)  fixed bug to prevent root account from being deleted by the
204     "delete user script"
205 10) Inclusion of autoconf script for building VFS modules
206 11) Add new run time options to the VFS recycle bin library (see
207     examples/VFS/recycle/README for details)
208 12) Include findsmb perl script as part of the "make install" process
209 13) Return correct error code for EnumPrinters(PRINTER_ENUM_REMOTE, InfoLevel1)
210     to fix a bug where printers appear at the workgroup level in the Windows
211     NT/2k APW browse list
212 14) Added support to nmblookup to return NMB flags (See nmblookup(8) for
213     details)
214 15) Fix length bug that caused password changes from Windows NT/2k clients to
215     occasionally fail
216 16) Correct false password expiration when using --with-ldapsam caused by
217     missing attributes in the directory
218 17) added -S option to smbpasswd for storing the SID of a domain controller
219     as the local machine SID in secrets.tdb.  See the smbpasswd(8) man page
220     for details.
221 18) Various fixes for UNIX CIFS extensions commands
222 19) Fixed CIDR notation in "hosts allow/deny"
223 20) Change semantics of an idle connection to mean "no open files and no
224     open handles".  We cannot idle a connection if there are open named
225     pipe handles.  This fixes scalability problem on Samba print servers
226     and NT/2k clients introduced in 2.2.4
227 21) Fix germam umlaut problem when returning ACL entries
228 22) Return NT_STATUS_OBJECT_NAME_NOT_FOUND for ENOENT.  This fixes the bug
229     of running the Microsoft Access executable (msaccess.exe) and database
230     files from a Samba share documented in the 2.2.4 release
231 23) Corrected signal handling relating to directory change notification and
232     kernel oplocks
233 24) Fix bug in unix_to_nt_time() that appeared on files dated close to Daylight
234     Savings Time
235 25) Corrected alignment bug in spoolss parsing code which caused Win2k/XP
236     clients not to be able to view printer properties from a Samba host
237 26) Fixed spoolss parsing bug causing printing from ACT! 2000 running on
238     Windows 2k/XP clients to fail
239 27) Fixed incorrect error check in mod_share_entry()
240 28) Allow %S variable in MS-DFS root paths
241 29) Correct a bug regarding the use of 'wbinfo -A'
242 30) Fixed libnss_wins.so to correctly work on RedHat 7.3 systems
243 31) Store the key for a name-to-sid cache entry in upper case rather than
244     whatever case the request was made in.  This gets rid of duplicate
245     cache entries.
246 32) Fix bug causing the pid stored in winbindd's pid file to be the wrong id
247 33) Enhanced error reporting messages of wbinfo
248 34) Parameterize block size on disk size return
249 35) Added new parameter to allow incoming ACLs to have owner and group forced
250     to the currently logged in user. This fixes the XCOPY /O problem
251 36) Fixed bug in local_change_password() caused by reusing a struct
252     passwd* pointer
253 37) Change default value for "ldap port" to 389 if "ldap ssl = no"
254 38) Updated HOWTO's, manpages, and general documentation....
255 39) Allow root as well as domain admins to open an LDAP connection
256 40) Fixed veto files bug with ".*"
257 41) Fixed uninitialized variable bug in smbpasswd that was causing a random
258     IP address to be used in the connection when joining a domain
259 42) Fix for joining a domain with a netbios name of 15 characters and
260     pre-creating the account on the DC
261 43) Added links to new documentation on SWAT welcome page
265 -----------------------------------------------------------------------------
266 The release notes for 2.2.4 follow :
268 There have been several fixes and internal enhancements which include:
270  * More/better SPOOLSS printing functionality for Windows
271    NT/2k/XP clients.
272  * Several fixes relating to serving PC database files such
273    as (Access and FoxPro) from a Samba file share.
274  * Several improves in Samba's VFS layer which can be seen
275    in the inclusion of a "Recycle Bin" vfs module.  See
276    examples/VFS/README for more details on this.
277  * Addition of a tool (tdbbackup) for backup/restore of Samba's
278    tdb's
279  * Continued improvements to winbind for greater scalability
280    and stability
281  * Several fixes related to Samba's MS-DFS support
282  * Rpcclient's various printer commands now work (again)
285 New/Changed parameters in 2.2.4
286 --------------------------------
288 For more information on these parameters, see the man pages for
289 smb.conf(5).
291 Added/changed parameters
292 ------------------------
294 * csc policy
295 * inherit acls
296 * nt status support
297 * lock spin count
298 * lock spin time
299 * pid directory
300 * winbind use default domain
303 Deprecated parameters
304 ---------------------
306 The following parameters have been marked as deprecated
307 and will be removed in Samba 3.0
309 * postscript
310 * printer driver
311 * printer driver file
312 * printer driver location
315 Removed Parameters
316 ------------------
318   none
321 Changes in 2.2.4
322 ----------------
324 See the cvs log for SAMBA_2_2 for more details
326 1)  added -c option to smbpasswd
327 2)  reworked smbpasswd internal command line option parsing
328 3)  small various bug fixes to experimental pdb_tdb.c
329 4)  Enforce spoolss RPCs based on the access granted at PrinterOpen()
330 5)  Added missing access checks to [add/delete/set]form
331 6)  Compile fixes for pam_smbpass
332 7)  fix smbd crash when netbios session request fails from
333     spoolss_connect_to_client().
334 8)  fixed logic bug that prevent SetPrinter() from storing devmode
335 9)  Removed extra get_printer_snum() calls from set_printer_hnd_name()
336 10) fix joining domain on big endian machine when using -U to smbpasswd
337 11) allow command line arg to override smb.conf log level
338 12) continue to retry to register 1b name with wins server if there is an old IP there
339 13) fix smbclient print crash bug
340 14) 9x pnp fix when the config file and driver file are different
341 15) force testparm to print the correct value for log level
342 16) fix swat to show full log level info
343 17) fix server GetPrinterData() fields to be more sensible
344 18) fix logic error in SetPrinterDataEx()
345 19) Only set smb_read_error if not already set
346 20) Fix string returns that require unicode
347 21) Merge of printing performance fixes from appliance
348 22) lpq parsing fixes
349 23) Back port tridge's xcopy /o fix from HEAD
350 24) Fix the printer change notify code (unfinished)
351 25) Patch for Domain users not showing up
352 26) Fixed SetPrinterData(magic key) to support zero length DEVMODE
353 27) Ensure that all methods of looking up and connecting to DC's work
354     using identical logic.
355 28) Merge in the mutex code to stop multiple domain logon failure
356 29) Ignore 0/0 lock
357 30) Fix winbindd to respect command line debuglevel as nmbd/smbd
358 31) Update with tdbbackup from HEAD
359 32) Fix for typo on solaris nss
360 33) Merge in the locking changes from HEAD
361 34) Added POSIX ACL layer into the vfs
362 35) Fix the returning of domain enum
363 36) Fix the generation of the MACHINE.SID file into the secrets.tdb.
364 37) Enable test for -rdynamic when building binaries
365 38) Remove the "stat open" code - make it inline
366 39) Fix the mp3 rename bug
367 40) Fix for Explorer DFS problems on older Windows 9X machines
368 41) implement OpenPrinter() opnum == 0x01
369 42) Matched W2K *insane* open semantics....
370 43) small fix that will prevent the "failed to marshall
371     R_NET_SAMLOGON" message in the logs
372 42) don't do checking of local passdb in smbpasswd if using -r option
373 43) fix "smbpasswd -j DOMAIN -r * -U Admin%XXXX" so that it doesn't
374     try to connect to a server named '*'
375 44) merge rpcclient code from HEAD
376 45) Ensure MACHINE.SID update done before child spawns
377 46) Fix the bad path errors for mkdir so mkdir \a\b\c\d works
378 47) Removed --with-vfs - always built if available
379 48) Fixed psec for 2.2
380 49) Fixed the handle leak in the connection management code
381 50) fix disable spoolss after the switch to nt status codes
382 51) Added Shirish's client side caching policy change
383 52) Honor the specversion when parsing the the DEVICEMODE
384 53) fix parsing bug when DEVICEMODE's private data does not end
385     on a 4 byte boundary
386 54) do not idle an smbd when there is an open pipe
387 55) when a new driver is added to a Samba server, cycle through
388     all printers and bump the change_id for each one bound to the driver
389 56) allow smbclient to work with a FIFO as well (needed for KDE
390     ioslave)
391 57) various updates to pdb_nisplus.c
392 58) many small documentation updates
393 59) removed many compiler warnings
396 -----------------------------------------------------------------------------
397 The release notes for 2.2.3a follow :
399 This is a minor bugfix release for the 2.2.3 release. The 2.2.3
400 release had a problem that was visible to Windows 2000 Explorer
401 users in that copying files into a share that already existed
402 failed with "Access Denied" rather than asking the user if an
403 overwrite was required. This was due to an incorrect error mapping
404 between the UNIX EXIST error code and the NT status error.
406 As Windows Explorer is a highly visible end user application a quick
407 bugfix release was required, hence 2.2.3a.
409 Compilation on HPUX versions earlier than HPUX 11 has also been
410 corrected.
412 The cvs.log file is no longer included with this release, as it adds
413 13Mb to the size of the release, and is easily available on the Web.
415 -----------------------------------------------------------------------------
416 The release notes for 2.2.3 follow :
418 There are several important scaling bugs that have been fixed in this release
419 for large server systems so an upgrade is recommended.
421 LDAP update
422 -----------
424 Much work has been done on the LDAP backend code. The configure
425 option --with-ldapsam is now considered to be stable. The schema
426 used has changed, see the file examples/LDAP/samba.schema for the
427 new schema.
429 New documentation explaining how to set up a Samba only PDC/BDC
430 setup has been added in the files Samba-LDAP-HOWTO and Samba-BDC-HOWTO
431 in the documentation tree.
433 winbindd daemon extended
434 ------------------------
436 Samba 2.2.2 was the first release to include the winbind daemon.
437 This code allows UNIX systems that implement the name service
438 switch (nss) to be entered into a Windows NT/2000 domain and
439 use the Domain controller for all user and group enumeration.
441 Samba 2.2.3 fixes the known memory leaks in winbindd and has
442 been extended to work with SGI IRIX and HPUX (11.x) in addition
443 to the earlier targets of Linux and Solaris.
445 For more information on using winbind, see the man pages for
446 winbindd and wbinfo.
448 Note that winbindd is not installed by default.
450 New/Changed parameters in 2.2.3
451 --------------------------------
453 For more information on these parameters, see the man pages for
454 smb.conf.
456 Added/changed parameters.
457 -------------------------
459 unix extensions
461 Enables the experimental UNIX CIFS extensions in smbd. See the manpage
462 for more details.
464 default devmode
466 Some printer drivers will crash the Windows NT/2000 spooler service
467 if they are given a default devmode, some require it. This parameter
468 allows the administrator a choice of whether smbd returns such a
469 default devmode for a driver.
471 share modes
473 This parameter has been restored to allow people who wish smbd to ignore
474 client share modes. This is *very dangerous* and should not be set without
475 full knowledge of what this is designed for.
477 Changes in 2.2.3
478 -----------------
480 1). Fixed shared library compile for Solaris with native compiler.
481 2). UNIX CIFS extensions code added (donated by HP).
482 3). Changed to using NT status codes on the wire if the client can support
483 this.
484 4). altname command to show 8.3 name added to smbclient.
485 5). const-safe endian macros now used.
486 6). client code now uses UNICODE on the wire.
487 7). Correctly return fault PDU's on bad handle.
488 8). Improved NT error code mapping table.
489 9). Many new point and print RPC calls added.
490 10). Win9x clients can now see full user list.
491 11). field added to identify simultaneous open files (no longer
492 use dev/inode/time as unique value).
493 12). HPUX ACL code added (donated by HP).
494 13). vfs interfaces updated (again !).
495 14). MSDOS Code Page 866 -> 1251 mapping added.
496 15). winbindd now processes quit/hup signals correctly.
497 16). No tdb traversal done on startup/shutdown - ensures scalability.
498 17). Fix bug with paths for homes share.
499 18). Fixed copyfile for OS/2.
500 19). Fix group membership when groups are on more than one line.
501 20). Fixed core dumps in posix ACL mapping code.
502 21). Tidyup of UNICODE functions (put/get).
503 22). Move rpcclient to the new libsmb code.
504 23). Add missing Windows 2000 passthough trans2 calls.
505 24). Return check all tdb calls.
506 25). Make local name lookup work even if wins server is down.
507 26). pam session code added to winbind.
508 27). Added winbindd cache to all lookups.
509 28). Fix allocate bugs that caused file sizes to be incorrect.
510 29). Fixed write cache code - now safe to use.
511 30). Fixed winbindd memory leaks.
512 31). winbindd will now do name lookups (to allow non Open Source
513 systems to do the nsswitch WINS lookup). Fixed by SGI.
514 32). passdb memory leaks fixed.
515 33). LDAP code updates and now properly maintained.
516 34). Finally figured out how changeid is meant to work.
517 35). Downlevel printing now looks as NT does in print monitor window.
518 36). Many fixups in spoolss printing RPC parsing.
519 37). Speed up password enumeration as a PDC.
520 38). Fix printer changed notify messages (work from HP).
521 39). Fix modify timestamp on close code.
522 40). Fix long standing mangled names bug.
523 41). Fix delete on close semantics.
524 42). Stop opening all files with O_NONBLOCK !
525 43). Use O_NOFOLLOW for systems that have it and don't want symlinks.
526 44). Ensure NT supplementary groups get added to user token.
527 45). Try and mitigate effects of DNS timeout (do less lookups).
528 46). Added current user connection context stack.
529 47). Fixes to utmp code.
530 48). smbw code tidyups.
531 49). Added tdb open log code. Several tdb fixes.
533 -----------------------------------------------------------------------------
534 The release notes for 2.2.2 follow :
536 New daemon included - winbindd
537 ------------------------------
539 Samba 2.2.2 is the first release to include the winbind daemon.
540 This code allows UNIX systems that implement the name service
541 switch (nss) to be entered into a Windows NT/2000 domain and
542 use the Domain controller for all user and group enumeration.
544 This allows a Samba server added to a Windows domain to serve
545 file and print services with *NO* local users needed in /etc/passwd
546 and /etc/group - all users and groups are read directly from the
547 Windows domain controller. In addition with pam_winbind which allows
548 a PAM enabled UNIX system to use a Windows domain for authentication
549 service this allows single sign on and account control across
550 UNIX and Windows systems.
552 The current version of winbindd shipped in 2.2.2 does have some
553 memory leaks, which will be addressed for the next Samba release,
554 so it is advisable to monitor the winbind process. This code is
555 being used in production by several vendors, so the leaks are
556 manageable. In addition, this version of winbind does not work
557 correctly against a Samba PDC, due to some missing calls on the
558 PDC side. These problems are being addressed for the next Samba
559 release, but it was thought better to release the code now rather
560 than delay the main Samba code to match the winbind release schedule.
562 For more information on using winbind, see the man pages for
563 winbindd and wbinfo.
565 Note that winbindd is not installed by default.
567 New/Changed parameters in 2.2.2
568 -------------------------------
570 For more information on these parameters, see the man pages for
571 smb.conf.
573 Added/changed parameters.
574 -------------------------
576 strict allocate
578 Causes Samba not to create UNIX 'sparse' files, but to follow the
579 Windows behavior of always allocating on-disk space.
581 use mmap
583 Set to 'on' by default, only set to 'off' on HPUX 11.x or below or other
584 UNIX systems that don't have coherent mmap/read-write internal caches.
585 You should not need to set this parameter.
587 nt acl support
589 This parameter has been changed to a per-share option, and is very
590 useful in enabling Windows 2000 SP2 to load/save profiles from a 
591 Samba share.
593 New printing parameters.
594 ------------------------
596 disable spoolss
598 Setting this parameter causes Samba to go back to the old 2.0.x
599 LANMAN printing behavior, for people who wish to disable the
600 new SPOOLSS pipe.
602 use client driver
604 Causes Windows NT/2000 clients to need have a local printer driver
605 installed and to treat the printer as local.
607 New LDAP parameters.
608 --------------------
610 Samba 2.2.2 contains new code to maintain a Samba SAM database
611 on a remote LDAP server. These parameters have been added as
612 part of this code. These parameters are only available when Samba
613 has been compiled with the --with-ldapsam option.
615 ldap admin dn
616 ldap ssl
618 New SSL parameters.
619 -------------------
621 The SSL support in Samba has been fixed. These new parameters
622 are part of the changes added. These parameters are only available
623 when Samba has been compiled with the --with-ssl option. 
624 Please see the smb.conf man page for details.
626 ssl egd socket
627 ssl entropy file
628 ssl entropy bytes
630 New winbindd parameters.
631 ------------------------
633 These parameters are used by winbindd. See the man page for
634 winbindd for details.
636 winbind separator
637 winbind uid
638 winbind gid
639 winbind cache time
640 winbind enum users
641 winbind enum groups
642 template homedir
643 template shell
645 Removed parameters.
646 -------------------
648 share modes
649 ldap root
650 ldap root passwd
652 New Documentation.
653 ------------------
655 Some new README's have been added in the docs/ directory. These cover
656 using roving profiles with Windows 2000 SP2 (docs/README.Win2kSP2),
657 and how to use Samba to help prevent Windows virus spread
658 (docs/README.Win32-Viruses).
660 Quota problems on a Linux 2.4 kernel.
661 -------------------------------------
663 Currently the quota interfaces have diverged between the Linus
664 2.4.x kernels and the Alan Cox 2.4.x kernels (the Alan Cox variants
665 are shipped with RedHat). Running quota-enabled Samba compiled on
666 an Alan Cox kernel works correctly on an Alan Cox kernel (the one
667 shipped by default with RedHat 7.x) but fails on a Linus kernel.
669 This is a mess, and hopefully Alan and Linus will sort it out soon.
670 In the meantime we need to ship.....
672 Changes in 2.2.2
673 -----------------
675 1). mmap tdb code disabled on HPUX. This should prevent the reports of
676 tdb corruption on HUPX.
677 2). Large file support set to off in Solaris 5.5 and below.
678 3). Better CUPS detection.
679 4). New SAM (password database) backends - smbpasswd (traditional),
680 LDAP, NIS+ and Samba TDB.
681 5). Quota fixups on Linux.
682 6). libsmbclient stand-alone code added. Can be built as a shared library
683 under Linux.
684 7). Tru64 ACL support added.
685 8). winbindd option added.
686 9). Realloc fail tidyup fixes all over the code.
687 10). Large improvement in hash table code efficiency - would be found with
688 large stat caches.
689 11). Error code consistency improved (still needs more work).
690 12). Profile shared memory support added to nmbd.
691 13). New Windows 2000/NT passthrough info levels added.
692 14). readraw/writeraw code rewritten - many bugs fixed.
693 15). UNIX password sync (non pam) code fixed, use correct wildcard matcher.
694 16). Reverse DNS lookup avoided on socket open.
695 17). Bug preventing nmbd re-registering names on WINS server timeout fixed.
696 18). Zero length byte range lock code added. Much closer to Windows semantics.
697 19). Alignment fault fixes for Linux/Alpha.
698 20). Error checking on tdb returns vastly improved.
699 21). Handling of delete on close fixed. No longer possible to leave 'dead'
700 file entries.
701 22). Handling of oplock break failure cleanups improved. Should not be
702 able to leave 'dead' entries.
703 23). Fix handling of errors trying to set 64 bit locks on 32 bit NFS mounts.
704 24). Misc. MS-DFS code fixes.
705 25). Ignore logon packets if not a PDC (needed for PDC/BDC failover).
706 26). winbind pam module added.
707 27). Order N^^2 enumeration of printers problem fixed.
708 28). Password backend database code re-ordered to allow different password
709 backends (at compile time currently).
710 29). Improved print driver version detection for Windows 2000.
711 30). Driver DEVMODE initialization fixes.
712 31). Improved SYSV print parse code.
713 32). Fixed enumeration of large numbers of users/groups from Windows clients.
714 Code still too slow.
715 33). Fix for buggy NetApp RPC pipe clients.
716 34). Fix for NT sending multiple SetPrinterDataEx calls.
717 35). Fix for logic bug where smbd could delay oplock break request messages
718 from other smbd daemons whilst client kept us busy.
719 36). Fix deadlock problem with connections tdb on enumeration.
720 37). Fixes for setting/getting NT ACLs - improved POSIX mapping both ways.
721 38). Removed unused readbmpx/writebmpx code.
722 39). Attempt to fix Linux 2.4.x quota mess.
723 40). Improved ctemp code for Windows 2000 compatibility.
724 41). Finally understood difference between set EOF and set allocation requests.
725 Added strict allocate parameter to help.
726 42). Correctly return name types on name to SID lookups.
727 43). tdb spinlock code update.
728 44). Use pread/pwrite on systems that have it to fix race condition in tdb code.
730 -----------------------------------------------------------------------------
731 The release notes for 2.2.1a follow :
733 This is a minor bugfix release for 2.2.1, *NOT* security related.
735 1). 2.2.1 had a bug where using smbpasswd -m to add a Windows NT or
736 Windows2000 machine into a Samba hosted PDC would fail due to our
737 stricter user name checking. We were disallowing user names
738 containing '$', which is needed when using smbpasswd to add a
739 machine into a domain. Automatically adding machines (using the
740 native Windows tools) into a Samba domain worked correctly.
742 2.2.1a fixes this single problem.
744 -----------------------------------------------------------------------------
745 The release notes for 2.2.1 follow :
747 New/Changed parameters in 2.2.1
748 -------------------------------
750 Added parameters.
751 -----------------
753 obey pam restrictions
755 When Samba is configured to use PAM, turns on or off Samba checking
756 the PAM account restrictions. Defaults to off.
758 pam password change
760 When Samba is configured to use PAM, turns on or off Samba passing
761 the password changes to PAM. Defaults to off.
763 large readwrite
765 New option to allow new Windows 2000 large file (64k) streaming
766 read/write options. Needs a 64 bit underlying operating system
767 (for Linux use kernel 2.4 with glibc 2.2 or above). Can improve performance
768 by 10% with Windows 2000 clients. Defaults to off. Not as tested
769 as some other Samba code paths.
771 hide unreadable
773 Prevents clients from seeing the existence of files that cannot
774 be read. Off by default.
776 enhanced browsing
778 Turn on/off the enhanced Samba browsing functionality (*1B names).
779 Default is "on". Can prevent eternal machines in workgroups when
780 WINS servers are not synchronized.
782 Removed parameters.
783 -------------------
785 domain groups
786 domain admin users
787 domain guest users
789 Changes in 2.2.1
790 -----------------
792 1). "find" command removed for smbclient. Internal code now used.
793 2). smbspool updates to retry connections from Michael Sweet.
794 3). Fix for mapping 8859-15 characters to UNICODE.
795 4). Changed "security=server" to try with invalid username to prevent
796     account lockouts.
797 5). Fixes to allow Windows 2000 SP2 clients to join a Samba PDC.
798 6). Support for Windows 9x Nexus tools to allow security changes from Win9x.
799 7). Two locking fixes added. Samba 2.2.1 now passes the Clarion network
800     lock tester tool for distributed databases.
801 8). Preliminary support added for Windows 2000 large file read/write SMBs.
802 9). Changed random number generator in Samba to prevent guess attacks.
803 10). Fixes for tdb corruption in connections.tdb and file locking brlock.tdb.
804      smbd's clean the tdb files on startup and shutdown.
805 11). Fixes for default ACLs on Solaris.
806 12). Tidyup of password entry caching code.
807 13). Correct shutdowns added for send fails. Helps tdb cleanup code.
808 14). Prevent invalid '/' characters in workgroup names.
809 15). Removed more static arrays in SAMR code.
810 16). Client code is now UNICODE on the wire.
811 17). Fix 2 second timestamp resolution everywhere if dos timestamp set to yes.
812 18). All tdb opens now going through logging function.
813 19). Add pam password changing and pam restrictions code.
814 20). Printer driver management improvements (delete driver).
815 21). Fix difference between NULL security descriptors and empty
816      security descriptors.
817 22). Fix SID returns for server roles.
818 23). Allow Windows 2000 mmc to view and set Samba share security descriptors.
819 24). Allow smbcontrol to forcibly disconnect a share.
820 25). tdb fixes for HPUX, OpenBSD and other OS's that don't have a coherent
821      mmap/file read/write cache.
822 26). Fix race condition in returning create disposition for file create/open.
823 27). Fix NT rewriting of security descriptors to their canonical form for
824      ACLs.
825 28). Fix for Samba running on top of Linux VFAT ftruncate bug.
826 29). Swat fixes for being run with xinetd that doesn't set the umask.
827 30). Fix for slow writes with Win9x Explorer clients. Emulates Microsoft
828      TCP stack early ack specification error.
829 31). Changed lock & persistent tdb directory to /var/cache/samba by default on
830      RedHat and Mandrake as they clear the /var/lock/samba directory on reboot.
832 -----------------------------------------------------------------------------
833 The release notes for 2.2.0a follow :
835 SECURITY FIX
836 ============
838 This is a security bugfix release for Samba 2.2.0. This release provides the
839 following two changes *ONLY* from the 2.2.0 release.
841 1). Fix for the security hole discovered by Michal Zalewski (lcamtuf@bos.bindview.com)
842     and described in the security advisory below.
843 2). Fix for the hosts allow/hosts deny parameters not being honoured.
845 No other changes are being made for this release to ensure a security fix only.
846 For new functionality (including these security fixes) download Samba 2.2.1
847 when it is available.
849 The security advisory follows :
852                 IMPORTANT: Security bugfix for Samba
853                 ------------------------------------
855 June 23rd 2001
858 Summary
859 -------
861 A serious security hole has been discovered in all versions of Samba
862 that allows an attacker to gain root access on the target machine for
863 certain types of common Samba configuration.
865 The immediate fix is to edit your smb.conf configuration file and
866 remove all occurances of the macro "%m". Replacing occurances of %m
867 with %I is probably the best solution for most sites.
869 Details
870 -------
872 A remote attacker can use a netbios name containing unix path
873 characters which will then be substituted into the %m macro wherever
874 it occurs in smb.conf. This can be used to cause Samba to create a log
875 file on top of an important system file, which in turn can be used to
876 compromise security on the server.
878 The most commonly used configuration option that can be vulnerable to
879 this attack is the "log file" option. The default value for this
880 option is VARDIR/log.smbd. If the default is used then Samba is not
881 vulnerable to this attack.
883 The security hole occurs when a log file option like the following is
884 used:
886   log file = /var/log/samba/%m.log
888 In that case the attacker can use a locally created symbolic link to
889 overwrite any file on the system. This requires local access to the
890 server.
892 If your Samba configuration has something like the following:
894   log file = /var/log/samba/%m
896 Then the attacker could successfully compromise your server remotely
897 as no symbolic link is required. This type of configuration is very
898 rare.
900 The most commonly used log file configuration containing %m is the
901 distributed in the sample configuration file that comes with Samba:
903   log file = /var/log/samba/log.%m
905 in that case your machine is not vulnerable to this attack unless you
906 happen to have a subdirectory in /var/log/samba/ which starts with the
907 prefix "log."
909 Credit
910 ------
912 Thanks to Michal Zalewski (lcamtuf@bos.bindview.com) for finding this
913 vulnerability.
916 New Release
917 -----------
919 While we recommend that vulnerable sites immediately change their
920 smb.conf configuration file to prevent the attack we will also be
921 making new releases of Samba within the next 24 hours to properly fix
922 the problem. Please see http://www.samba.org/ for the new releases.
924 Please report any attacks to the appropriate authority.
926         The Samba Team
927         security@samba.org
929 ---------------------------------------------------------------------------
931 The release notes for 2.2.0 follow :
933 This is the official Samba 2.2.0 release. This version of Samba provides
934 the following new features and enhancements.
936 Integration between Windows oplocks and NFS file opens (IRIX and Linux
937 2.4 kernel only). This gives complete data and locking integrity between
938 Windows and UNIX file access to the same data files.
940 Ability to act as an authentication source for Windows 2000 clients as
941 well as for NT4.x clients.
943 Integration with the winbind daemon that provides a single
944 sign on facility for UNIX servers in Windows 2000/NT4 networks
945 driven by a Windows 2000/NT4 PDC. winbind is not included in
946 this release, it currently must be obtained separately. We are
947 committed to including winbind in a future Samba 2.2.x release.
949 Support for native Windows 2000/NT4 printing RPCs. This includes
950 support for automatic printer driver download.
952 Support for server supported Access Control Lists (ACLs).
953 This release contains support for the following filesystems: 
955     Solaris 2.6+ 
956     SGI Irix 
957     Linux Kernel with ACL patch from http://acl.bestbits.at
958         Linux Kernel with XFS ACL support.
959         Caldera/SCO UnixWare
960         IBM AIX
961         FreeBSD (with external patch)
963 Other platforms will be supported as resources are
964 available to test and implement the necessary modules. If
965 you are interested in writing the support for a particular
966 ACL filesystem, please join the samba-technical mailing
967 list and coordinate your efforts. 
969 On PAM (Pluggable Authentication Module) based systems - better debugging
970 messages and encrypted password users now have access control verified via
971 PAM - Note: Authentication still uses the encrypted password database.
973 Rewritten internal locking semantics for more robustness.
974 This release supports full 64 bit locking semantics on all
975 (even 32 bit) platforms. SMB locks are mapped onto POSIX
976 locks (32 bit or 64 bit) as the underlying system allows.
978 Conversion of various internal flat data structures to use
979 database records for increased performance and
980 flexibility.
982 Support for acting as a MS-DFS (Distributed File System) server.
984 Support for manipulating Samba shares using Windows client tools
985 (server manager). Per share security can be set using these tools
986 and Samba will obey the access restrictions applied.
988 Samba profiling support (see below).
990 Compile time option for enabling a (Virtual file system) VFS layer 
991 to allow non-disk resources to be exported as Windows filesystems
992 (such as databases etc.).
994 The documentation in this release has been updated and converted
995 from Yodl to DocBook 4.1. There are many new parameters since 2.0.7
996 and some defaults have changed.
998 Profiling support.
999 ------------------
1000 Support for collection of profile information. A shared 
1001 memory area has been created which contains counters for
1002 the number of calls to and the amount of time spent in
1003 various system calls, smb transactions and nmbd activity. See 
1004 the file profile.h for a complete listing of the information 
1005 collected. Sample code for a samba pmda (collection agent
1006 for Performance Co-Pilot) has been included in the pcp
1007 directory. 
1009 To enable the profile data collection code in samba, you must 
1010 compile samba with profile data support (run configure with 
1011 the --with-profiling-data option). On startup, collection of 
1012 data is disabled. To begin collecting data use the smbcontrol
1013 program to turn on profiling (see the smbcontrol man page).
1014 Profile information collection can be enabled for nmbd, all smbd
1015 processes or one or more selected processes. The profiling
1016 data collected is the aggregate for all processes that have
1017 profiling enabled.
1019 With samba compiled for profile data collection, you may see
1020 a very slight degradation in performance even with profiling
1021 collection turned off. On initial tests with NetBench on an
1022 SGI Origin 200 server, this degradation was not measurable 
1023 with profile collection off compared to no profile collection
1024 compiled into samba.
1026 With count profile collection enabled on all clients, the 
1027 degradation was less than 2%. With full profile collection 
1028 enabled on all clients, the degradation was about 8.5%. 
1030 =====================================================================
1032 If you think you have found a bug please email a report to :
1034         samba@samba.org
1036 As always, all bugs are our responsibility.
1038 Regards,
1040         The Samba Team.