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