r590: updating release notes for 2.2.9
[Samba.git] / WHATSNEW.txt
blob39b8f2e7b80dba0b9e7fa7998a29a1f2b879fdce
1                  =============================
2                  Release Notes for Samba 2.2.9
3                           May 8, 2004
4                  =============================
6 This is the latest stable release of the Samba 2.2 code base.
7 This is a maintainence release of Samba 2.2.8a to address the 
8 problem with user password changes after applying the Microsoft 
9 hotfix described in KB282741 to Windows NT 4.0/200x/XP clients.  
10 No other changes have been applied since Samba 2.2.8a.
12 There are no further Samba 2.2.x releases planned at this time.
14 Older releases notes for 2.2.x distributions follow
16        ------------------------------------------------------
18             ===========================================
19             What's new in Samba 2.2.8a - 7th April 2003
20             ===========================================
22              ****************************************
23              * IMPORTANT: Security bugfix for Samba *
24              ****************************************
26 Summary
27 -------
29 Digital Defense, Inc. has alerted the Samba Team to a serious 
30 vulnerability in all stable versions of Samba currently shipping. 
31 The Common Vulnerabilities and Exposures (CVE) project has assigned 
32 the ID CAN-2003-0201 to this defect.
34 This vulnerability, if exploited correctly, leads to an anonymous 
35 user gaining root access on a Samba serving system. All versions 
36 of Samba up to and including Samba 2.2.8 are vulnerable. An active 
37 exploit of the bug has been reported in the wild. Alpha versions of 
38 Samba 3.0 and above are *NOT* vulnerable.
41 Credit
42 ------
44 The Samba Team would like to thank Erik Parker and the team at
45 Digital Defense, Inc. for their efforts spent in the responsible 
46 and timely reporting of this bug.
49 Patch Availability
50 ------------------
52 The Samba 2.2.8a release contains only updates to address this 
53 security issue. A roll-up patch for release 2.2.7a and 2.0.10 
54 addressing both CAN-2003-0201 and CAN-2003-0085 can be obtained 
55 from http://www.samba.org/samba/ftp/patches/security/.
58             ========================================
61 Older releases notes for 2.2.x distributions follow
63 -----------------------------------------------------------------
64 The release notes for 2.2.8 follow:
66             ****************************************
67             * IMPORTANT: Security bugfix for Samba *
68             ****************************************
70 Summary
71 -------
73 The SuSE security audit team, in particular Sebastian Krahmer
74 <krahmer@suse.de>, has found an flaw in the Samba main smbd code which
75 could allow an external attacker to remotely and anonymously gain
76 Super User (root) privileges on a server running a Samba server.
78 This flaw exists in previous versions of Samba from 2.0.x to 2.2.7a
79 inclusive.  This is serious problem and all sites should either
80 upgrade to Samba 2.2.8 immediately or prohibit access to TCP ports 139
81 and 445. Advice on how to protect an unpatched Samba server created by
82 Andrew Tridgell, the leader of the Samba Team, is given at the end of
83 this section.
85 The SMB/CIFS protocol implemented by Samba is vulnerable to many
86 attacks, even without specific security holes.  The TCP ports 139 and
87 the new port 445 (used by Win2k and the Samba 3.0 alpha code in
88 particular) should never be exposed to untrusted networks.
90 Description
91 -----------
93 A buffer overrun condition exists in the SMB/CIFS packet fragment
94 re-assembly code in smbd which would allow an attacker to cause smbd
95 to overwrite arbitrary areas of memory in its own process address
96 space. This could allow a skilled attacker to inject binary specific
97 exploit code into smbd.
99 This version of Samba adds explicit overrun and overflow checks on
100 fragment re-assembly of SMB/CIFS packets to ensure that only valid
101 re-assembly is performed by smbd.
103 In addition, the same checks have been added to the re-assembly
104 functions in the client code, making it safe for use in other
105 services.
107 Credit
108 ------
110 This security flaw was discovered and reported to the Samba Team by
111 Sebastian Krahmer <krahmer@suse.de> of the SuSE Security Audit Team.  
112 The fix was prepared by Jeremy Allison and reviewed by engineers from
113 the Samba Team, SuSE, HP, SGI, Apple, and the Linux vendor engineers
114 on the Linux Vendor security mailing list.
116 The Samba Team would like to thank SuSE and Sebastian Krahmer for
117 their excellent auditing work and for drawing attention to this flaw.
119 Patch Availability
120 -----------------
122 As this is a security issue, patches for this flaw specific to earlier
123 versions of Samba will be and posted on the samba-technical@samba.org
124 mailing list as requested.
127 ************************************
128 Protecting an unpatched Samba server
129 ************************************
131   Samba Team, March 2003
133   This is a note on how to provide your Samba server some
134   protection against the recently discovered remote security
135   hole if you are unable to upgrade to the fixed version
136   immediately. Even if you do upgrade you might like to think
137   about the suggestions in this note to provide you with
138   additional levels of protection.
141   Using host based protection
142   ---------------------------
144   In many installations of Samba the greatest threat comes for
145   outside your immediate network. By default Samba will accept
146   connections from any host, which means that if you run an
147   insecure version of Samba on a host that is directly
148   connected to the Internet you can be especially vulnerable.
150   One of the simplest fixes in this case is to use the 'hosts
151   allow' and 'hosts deny' options in the Samba smb.conf
152   configuration file to only allow access to your server from a
153   specific range of hosts. An example might be:
155     hosts allow = 127.0.0.1 192.168.2.0/24 192.168.3.0/24
156     hosts deny = 0.0.0.0/0
158   The above will only allow SMB connections from 'localhost'
159   (your own computer) and from the two private networks
160   192.168.2 and 192.168.3. All other connections will be
161   refused connections as soon as the client sends its first
162   packet. The refusal will be marked as a 'not listening on
163   called name' error.
166   Using interface protection
167   --------------------------
169   By default Samba will accept connections on any network
170   interface that it finds on your system. That means if you
171   have a ISDN line or a PPP connection to the Internet then
172   Samba will accept connections on those links. This may not be
173   what you want.
175   You can change this behavior using options like the
176   following:
178     interfaces = eth* lo
179     bind interfaces only = yes
181   that tells Samba to only listen for connections on interfaces
182   with a name starting with 'eth' such as eth0, eth1, plus on
183   the loopback interface called 'lo'. The name you will need to
184   use depends on what OS you are using, in the above I used the
185   common name for ethernet adapters on Linux.
187   If you use the above and someone tries to make a SMB
188   connection to your host over a PPP interface called 'ppp0'
189   then they will get a TCP connection refused reply. In that
190   case no Samba code is run at all as the operating system has
191   been told not to pass connections from that interface to any
192   process.
195   Using a firewall
196   ----------------
198   Many people use a firewall to deny access to services that
199   they don't want exposed outside their network. This can be a
200   very good idea, although I would recommend using it in
201   conjunction with the above methods so that you are protected
202   even if your firewall is not active for some reason.
204   If you are setting up a firewall then you need to know what
205   TCP and UDP ports to allow and block. Samba uses the
206   following:
208     UDP/137    - used by nmbd
209     UDP/138    - used by nmbd
210     TCP/139    - used by smbd
211     TCP/445    - used by smbd
213   The last one is important as many older firewall setups may
214   not be aware of it, given that this port was only added to
215   the protocol in recent years.
218   Using a IPC$ share deny
219   -----------------------
221   If the above methods are not suitable, then you could also
222   place a more specific deny on the IPC$ share that is used in
223   the recently discovered security hole. This allows you to
224   offer access to other shares while denying access to IPC$
225   from potentially untrustworthy hosts.
227   To do that you could use:
229     [ipc$]
230         hosts allow = 192.168.115.0/24 127.0.0.1
231         hosts deny = 0.0.0.0/0
233   this would tell Samba that IPC$ connections are not allowed
234   from anywhere but the two listed places (localhost and a
235   local subnet). Connections to other shares would still be
236   allowed. As the IPC$ share is the only share that is always
237   accessible anonymously this provides some level of protection
238   against attackers that do not know a username/password for
239   your host.
241   If you use this method then clients will be given a 'access
242   denied' reply when they try to access the IPC$ share. That
243   means that those clients will not be able to browse shares,
244   and may also be unable to access some other resources.
246   I don't recommend this method unless you cannot use one of
247   the other methods listed above for some reason.
250   Upgrading Samba
251   ---------------
253   Of course the best solution is to upgrade Samba to a version
254   where the bug has been fixed. If you wish to also use one of
255   the additional measures above then that would certainly be a
256   good idea.
258   Please check regularly on http://www.samba.org/ for updates
259   and important announcements.
262             ****************************************
263             ****************************************
266 Changes since 2.2.7a
267 ---------------------
269 New Parameters
271     * acl compatibility
273 Additional Changes:
274     See the cvs log for SAMBA_2_2 for more details
276 1)  smbumount lazy patch from Mandrake
277 2)  Check for too many processes *before* the fork.
278 3)  make sure we don't run over the end of 'name' in unix_convert()
279 4)  set umask to 0 before creating socket directory.
280 5)  Fix the LARGE_SMB_OFF_T problems and allow smbd to do the right 
281     thing in interactive mode when a log file dir is also specified.
282 6)  Fix delete on close semantics to match W2K.
283 7)  Correctly return access denied on share mode deny when we can't 
284     open the file.
285 8)  Always use safe_strcpy not pstrcpy for malloc()'d strings
286 9)  Fixes for HP-UX only having limited POSIX lock range
287 10) Added uid/gid caching code. Reduces load on winbindd.
288 11) Removed extra copy of server name in the printername field (it was
289     mangling the the name to be \\server\\\server\printer
290 12) Fix dumb perror used without errno being set.
291 13) Do retries correctly if the connection to the DC has failed.
292 14) Correctly check for inet_addr fail.
293 15) Ensure we use getgrnam() unless BROKEN_GETGRNAM is defined.
294 16) Fix for missing if (setting_acls) on default perms.
295 17) Fix to cache the sidtype
296 18) fix printer settings on Solaris (big-endian) print servers.
297     ASCII -> UNICODE conversion bug.
298 19) Small fix check correct error return.
299 20) Ensure space_avail is unsigned.
300 21) patch to check for a valid [f]chmod_acl function pointer
301     before calling it.  Fixes seg fault in audit VFS module
302 22) When checking is_locked() new WRITE locks conflict with existing
303     READ locks even if the context is the same.
304 23) Merge off-by-one crash fixes from HEAD
305 24) Move off-by-one buggy malloc()/safe_strcpy() combination to 
306     strdup() instead.
307 25) Merge from HEAD. Use pstrcpy not safe_strcpy.
308 26) Fix to allow blocking lock notification to be done rapidly (no wait
309     for smb -> smb lock release). Adds new PENDING_LOCK type to lockdb
310     (does not interfere with existing locks).
311 27) Doxygen cleanups for code documentation
312 28) limit the unix domain sockets used by winbindd  by adding a
313     "last_access" field to winbindd connections, and will close
314     the oldest idle connection once the number of open connections goes
315     over WINBINDD_MAX_SIMULTANEOUS_CLIENTS (defined in local.h as 200
316     currently)
317 29) Fix a couple of string handling errors in smbd/dir.c that would
318     cause smbd to crash
319 30) Fix seg fault in smbpasswd when specifying the new password
320     as a command line argument
321 31) Correct 64-but file sizes issues with smbtar and smbclient
322 32) Add batch mode option to pdbedit
323 33) Add protection in nmbd against malformed reply packets
324 34) Fix bug with sendfile profiling support in smbstatus output
325 35) Correct bug in "hide unreadable" smb.conf parameter that
326     resulted in incorrect directory listings
327 36) Fix bug in group enumeration in winbindd
328 37) Correct build issues with libsmbclient on Solaris
329 38) Fix memory leak and bad pointer dereference in password
330     changing code in smbd
331 39) Fix for changing attributes on a file truncate
332 40) Ensure smbd process count never gets to -1 if limiting number
333     of processes
334 41) Ensure we return disk full by default on short writes
335 42) Don't delete jobs submitted after the lpq time
336 43) Fix reference count bug where smbds would not terminate
337     with no open resources
338 44) Performance fix when using quota support on HP-UX
339 45) Fixes for --with-ldapsam
340     * Default to port 389 when "ldap ssl != on"
341     * add support for rebinding to the master directory server
342       for password changes when "ldap server" points to a read-only
343       slave
344 46) Add -W and -X command line flags to smbpasswd for extracting and
345     setting the machine/domain SID in secrets.tdb.  See the
346     smbpasswd(8) man page for details.
347 47) Added (c) Luke Howard to winbind_nss_solaris.c for coded
348     obtained from PADL's nss_ldap library.
349 48) Fix bug in samr_dispinfo query in winbindd
350 49) Fix segfault in NTLMSSP password changing code for
351     guest connections
352 50) Correct pstring/fstring mismatches
353 51) Send level II oplock break requests synchronously to prevent
354     condition where one smbd would continually lock a share entry
355     in locking.tdb
356 52) Miscellaneous cleanups for tdb error conditions and appending
357     data in a record
358 53) Implement correct open file truncate semantics with DOS
359     attributes
360 54) Enforce wide links = no on files as well as directories
361 55) Include shared library checks for Stratus VOS
362 56) Include support for CUPS printer classes and logging the remote
363     client name
364 57) Include  "WinXP" (Windows XP) and "Win2K3" (Windows .NET) values
365     for %a
366 58) Increase the max PDU size to deal with some troublesome printer 
367     drivers and Windows NT 4.0 clients
368 59) increment the process counter immediately after the fork   
369     (not just when we receive the first smb packet)
370 60) Ensure rename sets errno correctly
371 61) Unify ACL code (back-port from 3.0)
372 62) Fix some further issues around off_t and large offsets
375 Changes since 2.2.7
376 --------------------
378 See the cvs log for SAMBA_2_2 for more details
380 1)  Fix for smbclient reporting negative file sizes on dir command
381     and negative statistics being reported when using put or get
382     on large files.
383 2)  Fix bug in determination of allocation size
384 3)  Fix 64bit size problems which prevented copying of files larger
385     than 2 GBytes.
386 4)  Fix for xcopy /s problem with old DOS clients not sending correct
387     attributes on subsequent SMBsearch calls.
388 5)  Fix bug in call to standard_sub_advanced giving a 0 length. This
389     fixes the string overflow in string_sub errors.
390 6)  Correctly handle querygroup rpcclient command
391 7)  fix broken incremental tar in smbtar command
394 The release notes for 2.2.7 follow :
396 IMPORTANT: Security bugfix for Samba
397 ------------------------------------
399 Summary
400 -------
402 A security hole has been discovered in versions 2.2.2 through 2.2.6 
403 of Samba that could potentially allow an attacker to gain root access
404 on the target machine.  The word "potentially" is used because there 
405 is no known exploit of this bug, and the Samba Team has not been able to
406 craft one ourselves. However, the seriousness of the problem warrants
407 this immediate 2.2.7 release.
409 In addition to addressing this security issue, Samba 2.2.7 also includes
410 thirteen unrelated improvements. These improvements result from our
411 process of continuous quality assurance and code review, and are part of
412 the Samba team's commitment to excellence.
414 Details
415 -------
417 There was a bug in the length checking for encrypted password change
418 requests from clients. A client could potentially send an encrypted
419 password, which, when decrypted with the old hashed password could be
420 used as a buffer overrun attack on the stack of smbd. The attach would
421 have to be crafted such that converting a DOS codepage string to little
422 endian UCS2 unicode would translate into an executable block of code.
424 All versions of Samba between 2.2.2 to 2.2.6 inclusive are vulnerable
425 to this problem. This version of Samba 2.2.7 contains a fix for this
426 problem.
428 Earlier versions of Samba are not vulnerable.
430 There is no known exploit or exploit code for this vulnerability,
431 it was discovered by a code audit by Debian Samba maintainers.
433 Credit
434 ------
436 Thanks to Steve Langasek <vorlon@debian.org> and Eloy Paris
437 <peloy@debian.org> for bringing this vulnerability to our notice.
439 Patch for Samba versions 2.2.2 to 2.2.6
440 ---------------------------------------
442 The following patch applies cleanly to the above Samba versions
443 and will fix the vulnerability for sites that do not wish to upgrade
444 to 2.2.7 at this time.
447 -------------------------------cut here---------------------------------
448 --- libsmb/smbencrypt.c.orig    Tue Nov 19 17:21:57 2002
449 +++ libsmb/smbencrypt.c Tue Nov 19 17:22:12 2002
450 @@ -63,7 +63,7 @@
451         if(len > 128)
452                 len = 128;
453         /* Password must be converted to NT unicode - null terminated. */
454 -       dos_struni2((char *)wpwd, (const char *)passwd, 256);
455 +       dos_struni2((char *)wpwd, (const char *)passwd, len);
456         /* Calculate length in bytes */
457         len = strlen_w((const smb_ucs2_t *)wpwd) * sizeof(int16);
458 -------------------------------cut here---------------------------------
462 Changes since 2.2.6
463 --------------------
465 See the cvs log for SAMBA_2_2 for more details
467 1)  ensure we send the notify message in the same way it is expected
468     to be received by srv_spoolss_receive_message().
469 2)  attribute matching on truncate only matters when opening truncate
470     with current SYSTEM|HIDDEN -> NONE. It's fine to truncate on open
471     with current NONE -> SYSTEM | HIDDEN.
472 3)  Fix bug in rpcclient's deldriver command
473 4)  Don't set global_machine_password_needs_changing if
474     lp_machine_password_timeout() is set to zero
475 5)  don't parse the BUFFER5 if the buffer length is zero
476 6)  fix core dump if pdbedit is run as non-root or smbpasswd file does
477     not exist
478 7)  Ensure can_delete() returns correct error code
479 8)  correctly return NT_STATUS_DELETE_PENDING from open code
480 9)  fix bug that assumed dos_unistr2 length was in ucs2 units, not 
481     bytes
482 10) check the long_archi name is not null when deleting a printer 
483     driver.  fixes core dump in smbd when using rpcclient's deldriver
484 11) fix fd leak with kernel change notify on Linux 2.4 kernels
485 12) must add one to the extra_data size to transfer the 0 string
486     terminator.  This was causing "wbinfo --sequence" to access past 
487     the end of malloced memory
488 13) fix for large systems allowing more than 65536 files open in
489     NTcreate&X
490 14) Fix bug in %U expansion
494 ----------------------------------------------------------------------
495 The release notes for 2.2.6 follow :
497 There have been several fixes and internal enhancements which include:
499  * Fixes for MS-RPC printing issues affecting Windows 2000 clients
500  * New support for smb.conf generation in SWAT
501  * Inclusion of several performance enhancements (See --with-sendfile
502    & and the modified smb.conf(5) parameters in these Release Notes)
503  * Fixes for several file locking bugs and returned status codes
506 New Parameters
507 --------------
509 Refer to the smb.conf(5) man page for complete descriptions of new 
510 parameters.
512   * profile acls (S)            workaround for issue with WinXP SP1
513                                 and roaming user profiles
515 Removed Parameters
516 ------------------
518   * max packet (G)
519   * packet size (G)
521 Modified Parameters
522 -------------------
524   * max xmit (G)                new default value
525   * large readwrite (G)         new default value
527 New ./configure Options
528 -----------------------
530   --with-sendfile               Enable experimental sendfile support
531   --with-winbind-ldap-hack      Enable winbindd_ldap_hack() functionality
532                                 for Windows 2000 native mode domains
535 Changes since 2.2.5
536 --------------------
538 See the cvs log for SAMBA_2_2 for more details
540 1)  Fixed several compiler warnings caused by the use of const parameters
541 2)  Fixed a hang in the main smbd process caused by an EINTR in the
542     wrong place
543 3)  Fixed string substitutions to accept a length for sanity checks
544 4)  Fixed 17-bit length field in nmb header
545 5)  Removed non-portable inline declaration for functions
546 6)  Performance fix for including files with an smb.conf variable in the
547     path name
548 7)  Fix for parsing LPRng lpq output
549 8)  Parsing fix for PRINTER_INFO_2 structure which was causing viewing
550     printer properties to fail
551 9)  Fix for printer change notification and Windows NT clients which caused
552     the client to go into an infinite loop of refreshing the local printers
553     folder
554 10) Allow trans2 and nttrans messages to be processed in oplock break state
555     which fixes a problem with oplock break requests and Win2k clients
556 11) Don't crash on setfileinfo on printer fsp
557 12) Memory fixes caught by Valgrind
558 13) Updates to stop spurious error message in tdb
559 14) Fix silly logic bug in 'make smbd processes' and 'status = no' check
560 15) Fix compilation of pam_smbpass and --with-ldap
561 16) Fix compilation of smbwrapper on Solaris hosts
562 17) fix logic error in a check for enabling the winbind_pam_auth_crap() code
563     & fix formatting typo in --with-winbind-auth-challenge
564 18) Correcting check for ldap_start_tls()
565 19) Fixed a problem with getgroups() where it could include our current
566     effective gid
567 20) fix incorrect semantics in the DeletePrinterDriver() spoolss rpc
568     to only attempt to delete the architecture specified by the client
569 21) Don't allow TEMP attribute on directory open
570 22) Restore VxFS quotas to the 2.2 branch
571 23) Added basic "Wizard" functionality to SWAT
572 24) Fix initial "allocation size" in NTcreate&X call
573 25) Fix for open fid, "nametoolong"
574 26) Exit server on receipt of a non-SMB packet.  Ensure we have
575     at least smb_size bytes before processing a packet
576 27) Replace inet_aton with inet_addr() to correct compile problems on Solaris
577 28) Include the "account" objectclass when adding a new account to --with-ldapsam
578     in order to comply with the data model implemented by OpenLDAP 2.1.x
579 29) Various fixes for POSIX compliance
580 30) Correct alignment & offset bug in EnumPrinterDataEx()
581 31) Fix access checks when modifying forms using a print server handle
582     (not just a printer handle)
583 32) Account for case data_len == 0 in EnumPrinterDataEx()
584 33) Fix logic error in blocking lock code
585 34) Fixed various incorrect return codes to clients
586 35) Add RESOLVE_DFSPATH to mkdir operations
587 36) Fix longstanding bug in Win2k clients by clearing the shortname
588     buffer before returning ASCII short name
589 37) added -t option to smbpasswd for explicitly changing a trust
590     account password when operating in security = domain
591 38) installed -x option to testparm to eXclude printing all parameter
592     values that are at default settings.
593 39) Fix shares/printers view in SWAT so that only Basic options are exposed
594     upon initial entry.
595 40) Added 1125 & KOI8-U to codepage list in Makefile.in
596 41) Include separate configure checks for *openbsd* & *freebsd* when
597     determining flags used to compile shared libraries.
598 42) Merge in free list unlock on error fix
599 43) Correctly fail opens with mismatching SYSTEM or HIDDEN attributes
600     if we are mapping system or hidden
601 44) Fix bug with stat mode open being done on read-only open with truncate
602 45) Fix crash bug discovered where cli struct was being deallocated in a
603     called function
604 46) Ensure we open UNIX fifo's non-blocking
605 47) Fix DeletePrinterDriver() (hopefully for the last time...yeah right....)
606 48) only lowercase global_myname in the %L substitution, not the whole string
607 49) Merged Steve French's fix for OS/2 EA return error being removed
608 50) Patch from Steve French to fix difference in responses to smbclient
609     //server/share ls / on Samba and Windows 2000
610 51) Print error and exit if smb.conf doesn't have security=domain and
611     encrypt passwords=yes when joining domain
612 52) Added final Steve French patch for "required" attributes with old dir
613     listings
614 53) Initialize user_rid value in WINBIND_USERINFO structure returned by
615     the rpc version of query_user()
616 54) Ensure we've failed a lock with a lock denied message before automatically
617     pushing it onto the blocking queue
618 55) Add experimental --with-sendfile code
619 56) alignment fix in printing code merged from HEAD
620 57) Merge fix for other sids in token from HEAD
621 58) Merge winbindd with current (more advanced) state of play in APPLIANCE_HEAD
622 59) fix smbclient / Win98 off by one bug
623 60) Never, *ever* hold a mutex lock in the message database where there may be
624     traversals being attempted
625 61) Add LDAP hack for retrieving the SAM sequence number when a member of a
626     Windows 2000 native mode domain
627 62) Fix race condition when changing a machine account password as we were
628     no longer locking the secrets entry
629 63) Allow '@' as a valid character in domain names
630 64) remove jobs from the spool directory when using cups
631 65) removed -lresolv for --enable-ldapsam
632 66) Memory leak fix and correct use of negative caching in winbindd
633 67) Updated spoolss parsing code with known good state of APPLIANCE_HEAD
634 68) Delete printer security check was reversed
635 69) Windows allows delete printer on a handle opened by an admin user, then
636     used on a pipe handle created by an anonymous user...We do to now...
637 70) Make explicit the difference between a tdb key with no data attached, and
638     a non existent entry
639 71) Ensure we register the 1c name on the unicast subnet.
640 72) Fix inheritance problem when recursively setting ACLs on directories
641 73) prevent ACL set on read-only share
642 74) Ensure we never have more than MAX_PRINT_JOBS in a queue
643 75) Added timeout to tdb_lock_bystring()
644 76) Ensure we set FIRST+LAST flags on a bind request
645 77) Add version strings to the usage message for smbcacls and smbpasswd
646 78) Fix bug in the write cache code
647 79) make the default printed values for boolean the same for all parameters
648 80) Default all LDAP connections to v3 with compiling with --with-ldapsam
649 81) Fix memory leak in smbspool
650 82) Fix bug in mangling code that resulted in Win9x clients not being
651     able to execute batch files in deep, non 8.3  directory paths
652 83) Fix infinite looping bug in winbindd_getgrent()
653 84) Fix crash bug on 64-bit systems (merge from HEAD)
654 85) Fix extended character bug when setting LanMan/NT password
655 86) Negotiate same SMB read size as a Windows 2000 file server
656     to fix performance bug with NT4 clients
660 -----------------------------------------------------------------------------
661 The release notes for 2.2.5 follow :
663 There have been several fixes and internal enhancements which include:
665 * Several compile fixes for Solaris and HP-UX
666 * More printing fixes for Windows NT/2k/XP clients
667 * New options for the VFS recycle bin library
668 * New internal signal handling semantics relating to directory change
669   notification and oplocks
671 New/Changed parameters in 2.2.5
672 --------------------------------
674 For more information on these parameters, see the man pages for
675 smb.conf(5).
677 Added/changed parameters
678 ------------------------
680 * block size = <INTEGER>
681 * force unknown acl user = <boolean>
682 * mangling method = [hash|hash2]
685 Deprecated Parameters
686 ---------------------
688 The following parameters have been marked as deprecated and will be removed
689 in Samba 3.0
691 * strip dot
692 * status
695 Removed Parameters
696 ------------------
698   none
701 Changes in 2.2.5
702 ----------------
704 See the cvs log for SAMBA_2_2 for more details
706 1)  Removal of several compiler warnings, incorrect Makefile dependencies,
707     and wrong autoconf tests on various platforms--Solaris & HP-UX 10.20
708     being the predominantly reported platforms
709 2)  Fixed winbindd crash bug on the IBM s390 running Linux
710 3)  Inclusion of enhanced Linux quota support
711 4)  Correctly link against Sun LDAP libraries on Solaris 8 (even through
712     there is no apparent SSL support there)
713 5)  POSIX conformance patches
714 6)  Include new configure --enable-cups option (can also be disabled even
715     if CUPS libraries are installed on the system)
716 7)  Set reasonable default for the "passwd program" parameter using an
717     autoconf test
718 8)  Added --with-winbind-auth for enabling winbindd_pam_auth_crap() code
719 9)  fixed bug to prevent root account from being deleted by the
720     "delete user script"
721 10) Inclusion of autoconf script for building VFS modules
722 11) Add new run time options to the VFS recycle bin library (see
723     examples/VFS/recycle/README for details)
724 12) Include findsmb perl script as part of the "make install" process
725 13) Return correct error code for EnumPrinters(PRINTER_ENUM_REMOTE, InfoLevel1)
726     to fix a bug where printers appear at the workgroup level in the Windows
727     NT/2k APW browse list
728 14) Added support to nmblookup to return NMB flags (See nmblookup(8) for
729     details)
730 15) Fix length bug that caused password changes from Windows NT/2k clients to
731     occasionally fail
732 16) Correct false password expiration when using --with-ldapsam caused by
733     missing attributes in the directory
734 17) added -S option to smbpasswd for storing the SID of a domain controller
735     as the local machine SID in secrets.tdb.  See the smbpasswd(8) man page
736     for details.
737 18) Various fixes for UNIX CIFS extensions commands
738 19) Fixed CIDR notation in "hosts allow/deny"
739 20) Change semantics of an idle connection to mean "no open files and no
740     open handles".  We cannot idle a connection if there are open named
741     pipe handles.  This fixes scalability problem on Samba print servers
742     and NT/2k clients introduced in 2.2.4
743 21) Fix germam umlaut problem when returning ACL entries
744 22) Return NT_STATUS_OBJECT_NAME_NOT_FOUND for ENOENT.  This fixes the bug
745     of running the Microsoft Access executable (msaccess.exe) and database
746     files from a Samba share documented in the 2.2.4 release
747 23) Corrected signal handling relating to directory change notification and
748     kernel oplocks
749 24) Fix bug in unix_to_nt_time() that appeared on files dated close to Daylight
750     Savings Time
751 25) Corrected alignment bug in spoolss parsing code which caused Win2k/XP
752     clients not to be able to view printer properties from a Samba host
753 26) Fixed spoolss parsing bug causing printing from ACT! 2000 running on
754     Windows 2k/XP clients to fail
755 27) Fixed incorrect error check in mod_share_entry()
756 28) Allow %S variable in MS-DFS root paths
757 29) Correct a bug regarding the use of 'wbinfo -A'
758 30) Fixed libnss_wins.so to correctly work on RedHat 7.3 systems
759 31) Store the key for a name-to-sid cache entry in upper case rather than
760     whatever case the request was made in.  This gets rid of duplicate
761     cache entries.
762 32) Fix bug causing the pid stored in winbindd's pid file to be the wrong id
763 33) Enhanced error reporting messages of wbinfo
764 34) Parameterize block size on disk size return
765 35) Added new parameter to allow incoming ACLs to have owner and group forced
766     to the currently logged in user. This fixes the XCOPY /O problem
767 36) Fixed bug in local_change_password() caused by reusing a struct
768     passwd* pointer
769 37) Change default value for "ldap port" to 389 if "ldap ssl = no"
770 38) Updated HOWTO's, manpages, and general documentation....
771 39) Allow root as well as domain admins to open an LDAP connection
772 40) Fixed veto files bug with ".*"
773 41) Fixed uninitialized variable bug in smbpasswd that was causing a random
774     IP address to be used in the connection when joining a domain
775 42) Fix for joining a domain with a netbios name of 15 characters and
776     pre-creating the account on the DC
777 43) Added links to new documentation on SWAT welcome page
781 -----------------------------------------------------------------------------
782 The release notes for 2.2.4 follow :
784 There have been several fixes and internal enhancements which include:
786  * More/better SPOOLSS printing functionality for Windows
787    NT/2k/XP clients.
788  * Several fixes relating to serving PC database files such
789    as (Access and FoxPro) from a Samba file share.
790  * Several improves in Samba's VFS layer which can be seen
791    in the inclusion of a "Recycle Bin" vfs module.  See
792    examples/VFS/README for more details on this.
793  * Addition of a tool (tdbbackup) for backup/restore of Samba's
794    tdb's
795  * Continued improvements to winbind for greater scalability
796    and stability
797  * Several fixes related to Samba's MS-DFS support
798  * Rpcclient's various printer commands now work (again)
801 New/Changed parameters in 2.2.4
802 --------------------------------
804 For more information on these parameters, see the man pages for
805 smb.conf(5).
807 Added/changed parameters
808 ------------------------
810 * csc policy
811 * inherit acls
812 * nt status support
813 * lock spin count
814 * lock spin time
815 * pid directory
816 * winbind use default domain
819 Deprecated parameters
820 ---------------------
822 The following parameters have been marked as deprecated
823 and will be removed in Samba 3.0
825 * postscript
826 * printer driver
827 * printer driver file
828 * printer driver location
831 Removed Parameters
832 ------------------
834   none
837 Changes in 2.2.4
838 ----------------
840 See the cvs log for SAMBA_2_2 for more details
842 1)  added -c option to smbpasswd
843 2)  reworked smbpasswd internal command line option parsing
844 3)  small various bug fixes to experimental pdb_tdb.c
845 4)  Enforce spoolss RPCs based on the access granted at PrinterOpen()
846 5)  Added missing access checks to [add/delete/set]form
847 6)  Compile fixes for pam_smbpass
848 7)  fix smbd crash when netbios session request fails from
849     spoolss_connect_to_client().
850 8)  fixed logic bug that prevent SetPrinter() from storing devmode
851 9)  Removed extra get_printer_snum() calls from set_printer_hnd_name()
852 10) fix joining domain on big endian machine when using -U to smbpasswd
853 11) allow command line arg to override smb.conf log level
854 12) continue to retry to register 1b name with wins server if there is an old IP there
855 13) fix smbclient print crash bug
856 14) 9x pnp fix when the config file and driver file are different
857 15) force testparm to print the correct value for log level
858 16) fix swat to show full log level info
859 17) fix server GetPrinterData() fields to be more sensible
860 18) fix logic error in SetPrinterDataEx()
861 19) Only set smb_read_error if not already set
862 20) Fix string returns that require unicode
863 21) Merge of printing performance fixes from appliance
864 22) lpq parsing fixes
865 23) Back port tridge's xcopy /o fix from HEAD
866 24) Fix the printer change notify code (unfinished)
867 25) Patch for Domain users not showing up
868 26) Fixed SetPrinterData(magic key) to support zero length DEVMODE
869 27) Ensure that all methods of looking up and connecting to DC's work
870     using identical logic.
871 28) Merge in the mutex code to stop multiple domain logon failure
872 29) Ignore 0/0 lock
873 30) Fix winbindd to respect command line debuglevel as nmbd/smbd
874 31) Update with tdbbackup from HEAD
875 32) Fix for typo on solaris nss
876 33) Merge in the locking changes from HEAD
877 34) Added POSIX ACL layer into the vfs
878 35) Fix the returning of domain enum
879 36) Fix the generation of the MACHINE.SID file into the secrets.tdb.
880 37) Enable test for -rdynamic when building binaries
881 38) Remove the "stat open" code - make it inline
882 39) Fix the mp3 rename bug
883 40) Fix for Explorer DFS problems on older Windows 9X machines
884 41) implement OpenPrinter() opnum == 0x01
885 42) Matched W2K *insane* open semantics....
886 43) small fix that will prevent the "failed to marshall
887     R_NET_SAMLOGON" message in the logs
888 42) don't do checking of local passdb in smbpasswd if using -r option
889 43) fix "smbpasswd -j DOMAIN -r * -U Admin%XXXX" so that it doesn't
890     try to connect to a server named '*'
891 44) merge rpcclient code from HEAD
892 45) Ensure MACHINE.SID update done before child spawns
893 46) Fix the bad path errors for mkdir so mkdir \a\b\c\d works
894 47) Removed --with-vfs - always built if available
895 48) Fixed psec for 2.2
896 49) Fixed the handle leak in the connection management code
897 50) fix disable spoolss after the switch to nt status codes
898 51) Added Shirish's client side caching policy change
899 52) Honor the specversion when parsing the the DEVICEMODE
900 53) fix parsing bug when DEVICEMODE's private data does not end
901     on a 4 byte boundary
902 54) do not idle an smbd when there is an open pipe
903 55) when a new driver is added to a Samba server, cycle through
904     all printers and bump the change_id for each one bound to the driver
905 56) allow smbclient to work with a FIFO as well (needed for KDE
906     ioslave)
907 57) various updates to pdb_nisplus.c
908 58) many small documentation updates
909 59) removed many compiler warnings
912 -----------------------------------------------------------------------------
913 The release notes for 2.2.3a follow :
915 This is a minor bugfix release for the 2.2.3 release. The 2.2.3
916 release had a problem that was visible to Windows 2000 Explorer
917 users in that copying files into a share that already existed
918 failed with "Access Denied" rather than asking the user if an
919 overwrite was required. This was due to an incorrect error mapping
920 between the UNIX EXIST error code and the NT status error.
922 As Windows Explorer is a highly visible end user application a quick
923 bugfix release was required, hence 2.2.3a.
925 Compilation on HP-UX versions earlier than HP-UX 11 has also been
926 corrected.
928 The cvs.log file is no longer included with this release, as it adds
929 13Mb to the size of the release, and is easily available on the Web.
931 -----------------------------------------------------------------------------
932 The release notes for 2.2.3 follow :
934 There are several important scaling bugs that have been fixed in this release
935 for large server systems so an upgrade is recommended.
937 LDAP update
938 -----------
940 Much work has been done on the LDAP backend code. The configure
941 option --with-ldapsam is now considered to be stable. The schema
942 used has changed, see the file examples/LDAP/samba.schema for the
943 new schema.
945 New documentation explaining how to set up a Samba only PDC/BDC
946 setup has been added in the files Samba-LDAP-HOWTO and Samba-BDC-HOWTO
947 in the documentation tree.
949 winbindd daemon extended
950 ------------------------
952 Samba 2.2.2 was the first release to include the winbind daemon.
953 This code allows UNIX systems that implement the name service
954 switch (nss) to be entered into a Windows NT/2000 domain and
955 use the Domain controller for all user and group enumeration.
957 Samba 2.2.3 fixes the known memory leaks in winbindd and has
958 been extended to work with SGI IRIX and HP-UX (11.x) in addition
959 to the earlier targets of Linux and Solaris.
961 For more information on using winbind, see the man pages for
962 winbindd and wbinfo.
964 Note that winbindd is not installed by default.
966 New/Changed parameters in 2.2.3
967 --------------------------------
969 For more information on these parameters, see the man pages for
970 smb.conf.
972 Added/changed parameters.
973 -------------------------
975 unix extensions
977 Enables the experimental UNIX CIFS extensions in smbd. See the manpage
978 for more details.
980 default devmode
982 Some printer drivers will crash the Windows NT/2000 spooler service
983 if they are given a default devmode, some require it. This parameter
984 allows the administrator a choice of whether smbd returns such a
985 default devmode for a driver.
987 share modes
989 This parameter has been restored to allow people who wish smbd to ignore
990 client share modes. This is *very dangerous* and should not be set without
991 full knowledge of what this is designed for.
993 Changes in 2.2.3
994 -----------------
996 1). Fixed shared library compile for Solaris with native compiler.
997 2). UNIX CIFS extensions code added (donated by HP).
998 3). Changed to using NT status codes on the wire if the client can support
999 this.
1000 4). altname command to show 8.3 name added to smbclient.
1001 5). const-safe endian macros now used.
1002 6). client code now uses UNICODE on the wire.
1003 7). Correctly return fault PDU's on bad handle.
1004 8). Improved NT error code mapping table.
1005 9). Many new point and print RPC calls added.
1006 10). Win9x clients can now see full user list.
1007 11). field added to identify simultaneous open files (no longer
1008 use dev/inode/time as unique value).
1009 12). HP-UX ACL code added (donated by HP).
1010 13). vfs interfaces updated (again !).
1011 14). MSDOS Code Page 866 -> 1251 mapping added.
1012 15). winbindd now processes quit/hup signals correctly.
1013 16). No tdb traversal done on startup/shutdown - ensures scalability.
1014 17). Fix bug with paths for homes share.
1015 18). Fixed copyfile for OS/2.
1016 19). Fix group membership when groups are on more than one line.
1017 20). Fixed core dumps in posix ACL mapping code.
1018 21). Tidyup of UNICODE functions (put/get).
1019 22). Move rpcclient to the new libsmb code.
1020 23). Add missing Windows 2000 passthough trans2 calls.
1021 24). Return check all tdb calls.
1022 25). Make local name lookup work even if wins server is down.
1023 26). pam session code added to winbind.
1024 27). Added winbindd cache to all lookups.
1025 28). Fix allocate bugs that caused file sizes to be incorrect.
1026 29). Fixed write cache code - now safe to use.
1027 30). Fixed winbindd memory leaks.
1028 31). winbindd will now do name lookups (to allow non Open Source
1029 systems to do the nsswitch WINS lookup). Fixed by SGI.
1030 32). passdb memory leaks fixed.
1031 33). LDAP code updates and now properly maintained.
1032 34). Finally figured out how changeid is meant to work.
1033 35). Downlevel printing now looks as NT does in print monitor window.
1034 36). Many fixups in spoolss printing RPC parsing.
1035 37). Speed up password enumeration as a PDC.
1036 38). Fix printer changed notify messages (work from HP).
1037 39). Fix modify timestamp on close code.
1038 40). Fix long standing mangled names bug.
1039 41). Fix delete on close semantics.
1040 42). Stop opening all files with O_NONBLOCK !
1041 43). Use O_NOFOLLOW for systems that have it and don't want symlinks.
1042 44). Ensure NT supplementary groups get added to user token.
1043 45). Try and mitigate effects of DNS timeout (do less lookups).
1044 46). Added current user connection context stack.
1045 47). Fixes to utmp code.
1046 48). smbw code tidyups.
1047 49). Added tdb open log code. Several tdb fixes.
1049 -----------------------------------------------------------------------------
1050 The release notes for 2.2.2 follow :
1052 New daemon included - winbindd
1053 ------------------------------
1055 Samba 2.2.2 is the first release to include the winbind daemon.
1056 This code allows UNIX systems that implement the name service
1057 switch (nss) to be entered into a Windows NT/2000 domain and
1058 use the Domain controller for all user and group enumeration.
1060 This allows a Samba server added to a Windows domain to serve
1061 file and print services with *NO* local users needed in /etc/passwd
1062 and /etc/group - all users and groups are read directly from the
1063 Windows domain controller. In addition with pam_winbind which allows
1064 a PAM enabled UNIX system to use a Windows domain for authentication
1065 service this allows single sign on and account control across
1066 UNIX and Windows systems.
1068 The current version of winbindd shipped in 2.2.2 does have some
1069 memory leaks, which will be addressed for the next Samba release,
1070 so it is advisable to monitor the winbind process. This code is
1071 being used in production by several vendors, so the leaks are
1072 manageable. In addition, this version of winbind does not work
1073 correctly against a Samba PDC, due to some missing calls on the
1074 PDC side. These problems are being addressed for the next Samba
1075 release, but it was thought better to release the code now rather
1076 than delay the main Samba code to match the winbind release schedule.
1078 For more information on using winbind, see the man pages for
1079 winbindd and wbinfo.
1081 Note that winbindd is not installed by default.
1083 New/Changed parameters in 2.2.2
1084 -------------------------------
1086 For more information on these parameters, see the man pages for
1087 smb.conf.
1089 Added/changed parameters.
1090 -------------------------
1092 strict allocate
1094 Causes Samba not to create UNIX 'sparse' files, but to follow the
1095 Windows behavior of always allocating on-disk space.
1097 use mmap
1099 Set to 'on' by default, only set to 'off' on HP-UX 11.x or below or other
1100 UNIX systems that don't have coherent mmap/read-write internal caches.
1101 You should not need to set this parameter.
1103 nt acl support
1105 This parameter has been changed to a per-share option, and is very
1106 useful in enabling Windows 2000 SP2 to load/save profiles from a 
1107 Samba share.
1109 New printing parameters.
1110 ------------------------
1112 disable spoolss
1114 Setting this parameter causes Samba to go back to the old 2.0.x
1115 LANMAN printing behavior, for people who wish to disable the
1116 new SPOOLSS pipe.
1118 use client driver
1120 Causes Windows NT/2000 clients to need have a local printer driver
1121 installed and to treat the printer as local.
1123 New LDAP parameters.
1124 --------------------
1126 Samba 2.2.2 contains new code to maintain a Samba SAM database
1127 on a remote LDAP server. These parameters have been added as
1128 part of this code. These parameters are only available when Samba
1129 has been compiled with the --with-ldapsam option.
1131 ldap admin dn
1132 ldap ssl
1134 New SSL parameters.
1135 -------------------
1137 The SSL support in Samba has been fixed. These new parameters
1138 are part of the changes added. These parameters are only available
1139 when Samba has been compiled with the --with-ssl option. 
1140 Please see the smb.conf man page for details.
1142 ssl egd socket
1143 ssl entropy file
1144 ssl entropy bytes
1146 New winbindd parameters.
1147 ------------------------
1149 These parameters are used by winbindd. See the man page for
1150 winbindd for details.
1152 winbind separator
1153 winbind uid
1154 winbind gid
1155 winbind cache time
1156 winbind enum users
1157 winbind enum groups
1158 template homedir
1159 template shell
1161 Removed parameters.
1162 -------------------
1164 share modes
1165 ldap root
1166 ldap root passwd
1168 New Documentation.
1169 ------------------
1171 Some new README's have been added in the docs/ directory. These cover
1172 using roving profiles with Windows 2000 SP2 (docs/README.Win2kSP2),
1173 and how to use Samba to help prevent Windows virus spread
1174 (docs/README.Win32-Viruses).
1176 Quota problems on a Linux 2.4 kernel.
1177 -------------------------------------
1179 Currently the quota interfaces have diverged between the Linus
1180 2.4.x kernels and the Alan Cox 2.4.x kernels (the Alan Cox variants
1181 are shipped with RedHat). Running quota-enabled Samba compiled on
1182 an Alan Cox kernel works correctly on an Alan Cox kernel (the one
1183 shipped by default with RedHat 7.x) but fails on a Linus kernel.
1185 This is a mess, and hopefully Alan and Linus will sort it out soon.
1186 In the meantime we need to ship.....
1188 Changes in 2.2.2
1189 -----------------
1191 1). mmap tdb code disabled on HP-UX. This should prevent the reports of
1192 tdb corruption on HUPX.
1193 2). Large file support set to off in Solaris 5.5 and below.
1194 3). Better CUPS detection.
1195 4). New SAM (password database) backends - smbpasswd (traditional),
1196 LDAP, NIS+ and Samba TDB.
1197 5). Quota fixups on Linux.
1198 6). libsmbclient stand-alone code added. Can be built as a shared library
1199 under Linux.
1200 7). Tru64 ACL support added.
1201 8). winbindd option added.
1202 9). Realloc fail tidyup fixes all over the code.
1203 10). Large improvement in hash table code efficiency - would be found with
1204 large stat caches.
1205 11). Error code consistency improved (still needs more work).
1206 12). Profile shared memory support added to nmbd.
1207 13). New Windows 2000/NT passthrough info levels added.
1208 14). readraw/writeraw code rewritten - many bugs fixed.
1209 15). UNIX password sync (non pam) code fixed, use correct wildcard matcher.
1210 16). Reverse DNS lookup avoided on socket open.
1211 17). Bug preventing nmbd re-registering names on WINS server timeout fixed.
1212 18). Zero length byte range lock code added. Much closer to Windows semantics.
1213 19). Alignment fault fixes for Linux/Alpha.
1214 20). Error checking on tdb returns vastly improved.
1215 21). Handling of delete on close fixed. No longer possible to leave 'dead'
1216 file entries.
1217 22). Handling of oplock break failure cleanups improved. Should not be
1218 able to leave 'dead' entries.
1219 23). Fix handling of errors trying to set 64 bit locks on 32 bit NFS mounts.
1220 24). Misc. MS-DFS code fixes.
1221 25). Ignore logon packets if not a PDC (needed for PDC/BDC failover).
1222 26). winbind pam module added.
1223 27). Order N^^2 enumeration of printers problem fixed.
1224 28). Password backend database code re-ordered to allow different password
1225 backends (at compile time currently).
1226 29). Improved print driver version detection for Windows 2000.
1227 30). Driver DEVMODE initialization fixes.
1228 31). Improved SYSV print parse code.
1229 32). Fixed enumeration of large numbers of users/groups from Windows clients.
1230 Code still too slow.
1231 33). Fix for buggy NetApp RPC pipe clients.
1232 34). Fix for NT sending multiple SetPrinterDataEx calls.
1233 35). Fix for logic bug where smbd could delay oplock break request messages
1234 from other smbd daemons whilst client kept us busy.
1235 36). Fix deadlock problem with connections tdb on enumeration.
1236 37). Fixes for setting/getting NT ACLs - improved POSIX mapping both ways.
1237 38). Removed unused readbmpx/writebmpx code.
1238 39). Attempt to fix Linux 2.4.x quota mess.
1239 40). Improved ctemp code for Windows 2000 compatibility.
1240 41). Finally understood difference between set EOF and set allocation requests.
1241 Added strict allocate parameter to help.
1242 42). Correctly return name types on name to SID lookups.
1243 43). tdb spinlock code update.
1244 44). Use pread/pwrite on systems that have it to fix race condition in tdb code.
1246 -----------------------------------------------------------------------------
1247 The release notes for 2.2.1a follow :
1249 This is a minor bugfix release for 2.2.1, *NOT* security related.
1251 1). 2.2.1 had a bug where using smbpasswd -m to add a Windows NT or
1252 Windows2000 machine into a Samba hosted PDC would fail due to our
1253 stricter user name checking. We were disallowing user names
1254 containing '$', which is needed when using smbpasswd to add a
1255 machine into a domain. Automatically adding machines (using the
1256 native Windows tools) into a Samba domain worked correctly.
1258 2.2.1a fixes this single problem.
1260 -----------------------------------------------------------------------------
1261 The release notes for 2.2.1 follow :
1263 New/Changed parameters in 2.2.1
1264 -------------------------------
1266 Added parameters.
1267 -----------------
1269 obey pam restrictions
1271 When Samba is configured to use PAM, turns on or off Samba checking
1272 the PAM account restrictions. Defaults to off.
1274 pam password change
1276 When Samba is configured to use PAM, turns on or off Samba passing
1277 the password changes to PAM. Defaults to off.
1279 large readwrite
1281 New option to allow new Windows 2000 large file (64k) streaming
1282 read/write options. Needs a 64 bit underlying operating system
1283 (for Linux use kernel 2.4 with glibc 2.2 or above). Can improve performance
1284 by 10% with Windows 2000 clients. Defaults to off. Not as tested
1285 as some other Samba code paths.
1287 hide unreadable
1289 Prevents clients from seeing the existence of files that cannot
1290 be read. Off by default.
1292 enhanced browsing
1294 Turn on/off the enhanced Samba browsing functionality (*1B names).
1295 Default is "on". Can prevent eternal machines in workgroups when
1296 WINS servers are not synchronized.
1298 Removed parameters.
1299 -------------------
1301 domain groups
1302 domain admin users
1303 domain guest users
1305 Changes in 2.2.1
1306 -----------------
1308 1). "find" command removed for smbclient. Internal code now used.
1309 2). smbspool updates to retry connections from Michael Sweet.
1310 3). Fix for mapping 8859-15 characters to UNICODE.
1311 4). Changed "security=server" to try with invalid username to prevent
1312     account lockouts.
1313 5). Fixes to allow Windows 2000 SP2 clients to join a Samba PDC.
1314 6). Support for Windows 9x Nexus tools to allow security changes from Win9x.
1315 7). Two locking fixes added. Samba 2.2.1 now passes the Clarion network
1316     lock tester tool for distributed databases.
1317 8). Preliminary support added for Windows 2000 large file read/write SMBs.
1318 9). Changed random number generator in Samba to prevent guess attacks.
1319 10). Fixes for tdb corruption in connections.tdb and file locking brlock.tdb.
1320      smbd's clean the tdb files on startup and shutdown.
1321 11). Fixes for default ACLs on Solaris.
1322 12). Tidyup of password entry caching code.
1323 13). Correct shutdowns added for send fails. Helps tdb cleanup code.
1324 14). Prevent invalid '/' characters in workgroup names.
1325 15). Removed more static arrays in SAMR code.
1326 16). Client code is now UNICODE on the wire.
1327 17). Fix 2 second timestamp resolution everywhere if dos timestamp set to yes.
1328 18). All tdb opens now going through logging function.
1329 19). Add pam password changing and pam restrictions code.
1330 20). Printer driver management improvements (delete driver).
1331 21). Fix difference between NULL security descriptors and empty
1332      security descriptors.
1333 22). Fix SID returns for server roles.
1334 23). Allow Windows 2000 mmc to view and set Samba share security descriptors.
1335 24). Allow smbcontrol to forcibly disconnect a share.
1336 25). tdb fixes for HP-UX, OpenBSD and other OS's that don't have a coherent
1337      mmap/file read/write cache.
1338 26). Fix race condition in returning create disposition for file create/open.
1339 27). Fix NT rewriting of security descriptors to their canonical form for
1340      ACLs.
1341 28). Fix for Samba running on top of Linux VFAT ftruncate bug.
1342 29). Swat fixes for being run with xinetd that doesn't set the umask.
1343 30). Fix for slow writes with Win9x Explorer clients. Emulates Microsoft
1344      TCP stack early ack specification error.
1345 31). Changed lock & persistent tdb directory to /var/cache/samba by default on
1346      RedHat and Mandrake as they clear the /var/lock/samba directory on reboot.
1348 -----------------------------------------------------------------------------
1349 The release notes for 2.2.0a follow :
1351 SECURITY FIX
1352 ============
1354 This is a security bugfix release for Samba 2.2.0. This release provides the
1355 following two changes *ONLY* from the 2.2.0 release.
1357 1). Fix for the security hole discovered by Michal Zalewski (lcamtuf@bos.bindview.com)
1358     and described in the security advisory below.
1359 2). Fix for the hosts allow/hosts deny parameters not being honoured.
1361 No other changes are being made for this release to ensure a security fix only.
1362 For new functionality (including these security fixes) download Samba 2.2.1
1363 when it is available.
1365 The security advisory follows :
1368                 IMPORTANT: Security bugfix for Samba
1369                 ------------------------------------
1371 June 23rd 2001
1374 Summary
1375 -------
1377 A serious security hole has been discovered in all versions of Samba
1378 that allows an attacker to gain root access on the target machine for
1379 certain types of common Samba configuration.
1381 The immediate fix is to edit your smb.conf configuration file and
1382 remove all occurances of the macro "%m". Replacing occurances of %m
1383 with %I is probably the best solution for most sites.
1385 Details
1386 -------
1388 A remote attacker can use a netbios name containing unix path
1389 characters which will then be substituted into the %m macro wherever
1390 it occurs in smb.conf. This can be used to cause Samba to create a log
1391 file on top of an important system file, which in turn can be used to
1392 compromise security on the server.
1394 The most commonly used configuration option that can be vulnerable to
1395 this attack is the "log file" option. The default value for this
1396 option is VARDIR/log.smbd. If the default is used then Samba is not
1397 vulnerable to this attack.
1399 The security hole occurs when a log file option like the following is
1400 used:
1402   log file = /var/log/samba/%m.log
1404 In that case the attacker can use a locally created symbolic link to
1405 overwrite any file on the system. This requires local access to the
1406 server.
1408 If your Samba configuration has something like the following:
1410   log file = /var/log/samba/%m
1412 Then the attacker could successfully compromise your server remotely
1413 as no symbolic link is required. This type of configuration is very
1414 rare.
1416 The most commonly used log file configuration containing %m is the
1417 distributed in the sample configuration file that comes with Samba:
1419   log file = /var/log/samba/log.%m
1421 in that case your machine is not vulnerable to this attack unless you
1422 happen to have a subdirectory in /var/log/samba/ which starts with the
1423 prefix "log."
1425 Credit
1426 ------
1428 Thanks to Michal Zalewski (lcamtuf@bos.bindview.com) for finding this
1429 vulnerability.
1432 New Release
1433 -----------
1435 While we recommend that vulnerable sites immediately change their
1436 smb.conf configuration file to prevent the attack we will also be
1437 making new releases of Samba within the next 24 hours to properly fix
1438 the problem. Please see http://www.samba.org/ for the new releases.
1440 Please report any attacks to the appropriate authority.
1442         The Samba Team
1443         security@samba.org
1445 ---------------------------------------------------------------------------
1447 The release notes for 2.2.0 follow :
1449 This is the official Samba 2.2.0 release. This version of Samba provides
1450 the following new features and enhancements.
1452 Integration between Windows oplocks and NFS file opens (IRIX and Linux
1453 2.4 kernel only). This gives complete data and locking integrity between
1454 Windows and UNIX file access to the same data files.
1456 Ability to act as an authentication source for Windows 2000 clients as
1457 well as for NT4.x clients.
1459 Integration with the winbind daemon that provides a single
1460 sign on facility for UNIX servers in Windows 2000/NT4 networks
1461 driven by a Windows 2000/NT4 PDC. winbind is not included in
1462 this release, it currently must be obtained separately. We are
1463 committed to including winbind in a future Samba 2.2.x release.
1465 Support for native Windows 2000/NT4 printing RPCs. This includes
1466 support for automatic printer driver download.
1468 Support for server supported Access Control Lists (ACLs).
1469 This release contains support for the following filesystems: 
1471     Solaris 2.6+ 
1472     SGI Irix 
1473     Linux Kernel with ACL patch from http://acl.bestbits.at
1474         Linux Kernel with XFS ACL support.
1475         Caldera/SCO UnixWare
1476         IBM AIX
1477         FreeBSD (with external patch)
1479 Other platforms will be supported as resources are
1480 available to test and implement the necessary modules. If
1481 you are interested in writing the support for a particular
1482 ACL filesystem, please join the samba-technical mailing
1483 list and coordinate your efforts. 
1485 On PAM (Pluggable Authentication Module) based systems - better debugging
1486 messages and encrypted password users now have access control verified via
1487 PAM - Note: Authentication still uses the encrypted password database.
1489 Rewritten internal locking semantics for more robustness.
1490 This release supports full 64 bit locking semantics on all
1491 (even 32 bit) platforms. SMB locks are mapped onto POSIX
1492 locks (32 bit or 64 bit) as the underlying system allows.
1494 Conversion of various internal flat data structures to use
1495 database records for increased performance and
1496 flexibility.
1498 Support for acting as a MS-DFS (Distributed File System) server.
1500 Support for manipulating Samba shares using Windows client tools
1501 (server manager). Per share security can be set using these tools
1502 and Samba will obey the access restrictions applied.
1504 Samba profiling support (see below).
1506 Compile time option for enabling a (Virtual file system) VFS layer 
1507 to allow non-disk resources to be exported as Windows filesystems
1508 (such as databases etc.).
1510 The documentation in this release has been updated and converted
1511 from Yodl to DocBook 4.1. There are many new parameters since 2.0.7
1512 and some defaults have changed.
1514 Profiling support.
1515 ------------------
1516 Support for collection of profile information. A shared 
1517 memory area has been created which contains counters for
1518 the number of calls to and the amount of time spent in
1519 various system calls, smb transactions and nmbd activity. See 
1520 the file profile.h for a complete listing of the information 
1521 collected. Sample code for a samba pmda (collection agent
1522 for Performance Co-Pilot) has been included in the pcp
1523 directory. 
1525 To enable the profile data collection code in samba, you must 
1526 compile samba with profile data support (run configure with 
1527 the --with-profiling-data option). On startup, collection of 
1528 data is disabled. To begin collecting data use the smbcontrol
1529 program to turn on profiling (see the smbcontrol man page).
1530 Profile information collection can be enabled for nmbd, all smbd
1531 processes or one or more selected processes. The profiling
1532 data collected is the aggregate for all processes that have
1533 profiling enabled.
1535 With samba compiled for profile data collection, you may see
1536 a very slight degradation in performance even with profiling
1537 collection turned off. On initial tests with NetBench on an
1538 SGI Origin 200 server, this degradation was not measurable 
1539 with profile collection off compared to no profile collection
1540 compiled into samba.
1542 With count profile collection enabled on all clients, the 
1543 degradation was less than 2%. With full profile collection 
1544 enabled on all clients, the degradation was about 8.5%. 
1546 =====================================================================
1548 If you think you have found a bug please email a report to :
1550         samba@samba.org
1552 As always, all bugs are our responsibility.
1554 Regards,
1556         The Samba Team.