auth/gensec: make sure gensec_start_mech_by_authtype() resets SIGN/SEAL before starting
[Samba.git] / WHATSNEW.txt
blobf7b50ab5e2bc8b29c0e7f9530d1f50aae49e6808
1                    ==============================
2                    Release Notes for Samba 4.1.19
3                             June 23, 2015
4                    ==============================
7 This is the latest stable release of Samba 4.1.
10 Changes since 4.1.18:
11 ---------------------
13 o   Jeremy Allison <jra@samba.org>
14     * BUG 11068: s3: smbcacls: Ensure we read a hex number as %x, not %u.
15     * BUG 11249: Make mangled names work with acl_xattr.
16     * BUG 11295: Excessive cli_resolve_path() usage can slow down transmission.
19 o   Ralph Boehme <slow@samba.org>
20     * BUG 11244: Error code path doesn't call END_PROFILE.
21     * BUG 11277: s3:smb2: Add padding to last command in compound requests.
24 o   Alexander Bokovoy <ab@samba.org>
25     * BUG 11284: s4: libcli/finddcs_cldap: Continue processing CLDAP until all
26       addresses are used.
29 o   Evangelos Foutras <evangelos@foutrelis.com>
30     * BUG 8780: s4:lib/tls: Fix build with gnutls 3.4.
33 o   David Holder <david.holder@erion.co.uk>
34     * BUG 11283: s3: IPv6 enabled DNS connections for ADS client.
37 o   Steve Howells <steve.howells@moscowfirst.com>
38     * BUG 10924: s4.2/fsmo.py: Fix fsmo transfer exception.
41 o   Stefan Metzmacher <metze@samba.org>
42     * BUG 11141: s3:winbindd: Make sure we remove pending io requests before
43       closing client sockets.
44     * BUG 11182: Fix panic triggered by smbd_smb2_request_notify_done() ->
45       smbXsrv_session_find_channel() in smbd.
48 o   Christof Schmitt <cs@samba.org>
49     * BUG 11313: idmap_rfc2307: Fix 'wbinfo --gid-to-sid' query.
52 o   Uri Simchoni <urisimchoni@gmail.com>
53     * BUG 11267: libads: Record service ticket endtime for sealed ldap
54       connections.
57 #######################################
58 Reporting bugs & Development Discussion
59 #######################################
61 Please discuss this release on the samba-technical mailing list or by
62 joining the #samba-technical IRC channel on irc.freenode.net.
64 If you do report problems then please try to send high quality
65 feedback. If you don't provide vital information to help us track down
66 the problem then you will probably be ignored.  All bug reports should
67 be filed under the Samba 4.1 product in the project's Bugzilla
68 database (https://bugzilla.samba.org/).
71 ======================================================================
72 == Our Code, Our Bugs, Our Responsibility.
73 == The Samba Team
74 ======================================================================
77 Release notes for older releases follow:
78 ----------------------------------------
80 ======================================================================
82                    ==============================
83                    Release Notes for Samba 4.1.18
84                             May 12, 2015
85                    ==============================
88 This is the latest stable release of Samba 4.1.
91 Changes since 4.1.17:
92 ---------------------
94 o   Michael Adam <obnox@samba.org>
95     * BUG 8905: s3:winbind:grent: Don't stop group enumeration when a group has
96       no gid.
97     * BUG 11058: cli_connect_nb_send: don't segfault on host == NULL.
98     * BUG 11117: vfs_glusterfs manpage corrections.
99     * BUG 11143: s3-winbind: Fix chached user group lookup of trusted domains.
102 o   Jeremy Allison <jra@samba.org>
103     * BUG 10016: Fix NTLM authentication.
104     * BUG 10888: s3: client - "client use spnego principal = yes" code checks
105       wrong name.
106     * BUG 11079: s3: lib: libsmbclient: If reusing a server struct, check every
107       cli->timout miliseconds if it's still valid before use.
108     * BUG 11094: s3: smbclient: Allinfo leaves the file handle open.
109     * BUG 11144: Fix memory leak in SMB2 notify handling.
110     * BUG 11173: s3: libcli: smb1: Ensure we correctly finish a tevent req if
111       the writev fails in the SMB1 case.
112     * BUG 11177: s3: libsmbclient: Add missing talloc stackframe.
113     * BUG 11186: s3: libsmbclient: After getting attribute server, ensure main
114       srv pointer is still valid.
115     * BUG 11187: s3: Mac OS X 10.10.x fails validate negotiate request to 4.1.x.
116     * BUG 11236: s4: rpc: Refactor dcesrv_alter() function into setup and send
117       steps.
118     * BUG 11240: s3: smbd: Incorrect file size returned in the response of
119       "FILE_SUPERSEDE Create".
120     * BUG 11254: s3: nmbd: Don't set work_changed = True inside
121       update_server_ttl().
124 o   Andrew Bartlett <abartlet@samba.org>
125     * BUG 11100: debug: Set close-on-exec for the main log file FD.
128 o   Ralph Boehme <slow@samba.org>
129     * BUG 11224: s3:smbd: Missing tevent_req_nterror.
130     * BUG 11243: vfs: kernel_flock and named streams.
133 o   Ira Cooper <ira@samba.org>
134     * BUG 11069: vfs_glusterfs: Add comments to the pipe(2) code.
135     * BUG 11115: smbd: Stop using vfs_Chdir after SMB_VFS_DISCONNECT.
138 o   Günther Deschner <gd@samba.org>
139     * BUG 10240: vfs: Add glusterfs manpage.
142 o   David Disseldorp <ddiss@samba.org>
143     * BUG 10808: printing/cups: Pack requested-attributes with IPP_TAG_KEYWORD.
144     * BUG 11018: smbd can't find the GUID for a printer in the registry and
145       fails to publish printers.
146     * BUG 11059: libsmb: Provide authinfo domain for encrypted session
147       referrals.
148     * BUG 11169: docs/idmap_rid: Remove deprecated base_rid from example.
149     * BUG 11210: spoolss: Purge the printer name cache on name change.
152 o   Julien Kerihuel <j.kerihuel@openchange.org>
153     * BUG 11225: s4:rpc_server: Add multiplex state to dcerpc flags and control
154       over multiplex PFC flag in bind_ack and and dcesrv_alter replies.
155     * BUG 11226: Fix terminate connection behavior for asynchronous endpoint
156       with PUSH notification flavors.
159 o   Volker Lendecke <vl@samba.org>
160     * BUG 11041: smbd: Fix CID 1063259 Uninitialized scalar variable.
161     * BUG 11051: net: Fix 'net sam addgroupmem'.
164 o   Stefan Metzmacher <metze@samba.org>
165     * BUG 9702: s3:smb2_server: protect against integer wrap with "smb2 max
166       credits = 65535".
167     * BUG 11144: Fix memory leak in SMB2 notify handling.
168     * BUG 11164: s4:auth/gensec_gssapi: let gensec_gssapi_update() return
169       NT_STATUS_LOGON_FAILURE for unknown errors.
172 o   Andreas Schneider <asn@samba.org>
173     * BUG 10984: spoolss: Clear PrinterInfo on GetPrinter error.
174     * BUG 11008: s3-util: Fix authentication with long hostnames.
175     * BUG 11037: s3-libads: Fix a possible segfault in kerberos_fetch_pac().
176     * BUG 11058: utils: Fix 'net time' segfault.
177     * BUG 11066: s3-pam_smbpass: Fix memory leak in pam_sm_authenticate().
178     * BUG 11127: doc-xml: Add 'sharesec' reference to 'access based share enum'.
179     * BUG 11180: s4-process_model: Do not close random fds while forking.
180     * BUG 11185: s3-passdb: Fix 'force user' with winbind default domain.
183 o   Richard Sharpe <rsharpe@nutanix.com>
184     * BUG 11234: Fix crash in 'net ads dns gethostbyname' with an error in TALLOC_FREE
185       if you enter invalid values.
188 #######################################
189 Reporting bugs & Development Discussion
190 #######################################
192 Please discuss this release on the samba-technical mailing list or by
193 joining the #samba-technical IRC channel on irc.freenode.net.
195 If you do report problems then please try to send high quality
196 feedback. If you don't provide vital information to help us track down
197 the problem then you will probably be ignored.  All bug reports should
198 be filed under the Samba 4.1 product in the project's Bugzilla
199 database (https://bugzilla.samba.org/).
202 ======================================================================
203 == Our Code, Our Bugs, Our Responsibility.
204 == The Samba Team
205 ======================================================================
208 ----------------------------------------------------------------------
211                    ==============================
212                    Release Notes for Samba 4.1.17
213                           February 23, 2015
214                    ==============================
217 This is a security release in order to address CVE-2015-0240 (Unexpected
218 code execution in smbd).
220 o  CVE-2015-0240:
221    All versions of Samba from 3.5.0 to 4.2.0rc4 are vulnerable to an
222    unexpected code execution vulnerability in the smbd file server
223    daemon.
225    A malicious client could send packets that may set up the stack in
226    such a way that the freeing of memory in a subsequent anonymous
227    netlogon packet could allow execution of arbitrary code. This code
228    would execute with root privileges.
231 Changes since 4.1.16:
232 ---------------------
234 o   Jeremy Allison <jra@samba.org>
235     * BUG 11077: CVE-2015-0240: talloc free on uninitialized stack pointer
236       in netlogon server could lead to security vulnerability.
239 o   Andreas Schneider <asn@samba.org>
240     * BUG 11077: CVE-2015-0240: s3-netlogon: Make sure we do not deference
241       a NULL pointer.
244 #######################################
245 Reporting bugs & Development Discussion
246 #######################################
248 Please discuss this release on the samba-technical mailing list or by
249 joining the #samba-technical IRC channel on irc.freenode.net.
251 If you do report problems then please try to send high quality
252 feedback. If you don't provide vital information to help us track down
253 the problem then you will probably be ignored.  All bug reports should
254 be filed under the Samba 4.1 product in the project's Bugzilla
255 database (https://bugzilla.samba.org/).
258 ======================================================================
259 == Our Code, Our Bugs, Our Responsibility.
260 == The Samba Team
261 ======================================================================
264 ----------------------------------------------------------------------
267                    ==============================
268                    Release Notes for Samba 4.1.16
269                           January 15, 2015
270                    ==============================
273 This is a security release in order to address CVE-2014-8143 (Elevation
274 of privilege to Active Directory Domain Controller).
276 o  CVE-2014-8143:
277    Samba's AD DC allows the administrator to delegate
278    creation of user or computer accounts to specific users or groups.
280    However, all released versions of Samba's AD DC did not implement the
281    additional required check on the UF_SERVER_TRUST_ACCOUNT bit in the
282    userAccountControl attributes.
285 Changes since 4.1.15:
286 ---------------------
288 o   Andrew Bartlett <abartlet@samba.org>
289     * BUG 10993: CVE-2014-8143: dsdb-samldb: Check for extended access
290       rights before we allow changes to userAccountControl.
293 #######################################
294 Reporting bugs & Development Discussion
295 #######################################
297 Please discuss this release on the samba-technical mailing list or by
298 joining the #samba-technical IRC channel on irc.freenode.net.
300 If you do report problems then please try to send high quality
301 feedback. If you don't provide vital information to help us track down
302 the problem then you will probably be ignored.  All bug reports should
303 be filed under the Samba 4.1 product in the project's Bugzilla
304 database (https://bugzilla.samba.org/).
307 ======================================================================
308 == Our Code, Our Bugs, Our Responsibility.
309 == The Samba Team
310 ======================================================================
313 -----------------------------------------------------------------------
316                    ==============================
317                    Release Notes for Samba 4.1.15
318                           January 12, 2015
319                    ==============================
322 This is the latest stable release of Samba 4.1.
325 Changes since 4.1.14:
326 ---------------------
328 o   Jeremy Allison <jra@samba.org>
329     * BUG 10966: libcli: SMB2: Pure SMB2-only negprot fix to make us behave as a
330       Windows client does.
331     * BUG 10982 s3: smbd/modules: Fix *allocate* calls to follow POSIX error
332       return convention.
335 o   Christian Ambach <ambi@samba.org>
336     * BUG 9629: Fix profiles tool.
339 o   Samuel Cabrero <scabrero@zentyal.com>
340     * BUG 11006: idl:drsuapi: Manage all possible lengths of drsuapi_DsBindInfo.
343 o   Günther Deschner <gd@samba.org>
344     * BUG 9056: pam_winbind: Fix warn_pwd_expire implementation.
347 o   Guenter Kukkukk <linux@kukkukk.com>
348     * BUG 10952: s4-rpc: dnsserver: Fix enumeration of IPv4 and IPv6 addresses.
351 o   Stefan Metzmacher <metze@samba.org>
352     * BUG 9299: nsswitch: Fix soname of linux nss_*.so.2 modules.
353     * BUG 10949: s4:dsdb/rootdse: Expand extended dn values with the AS_SYSTEM
354       control.
355     * BUG 10958: s3:smb2_server: Allow reauthentication without signing.
356     * BUG 11006: Fix 'domain join' by adding 'drsuapi.DsBindInfoFallBack'
357       attribute 'supported_extensions'.
360 o   Matthieu Patou <mat@matws.net>
361     * BUG 11006: Fix 'domain join' by adding 'drsuapi.DsBindInfoFallBack'
362       attribute 'supported_extensions'.
365 o   Christof Schmitt <cs@samba.org>
366     * BUG 11034: winbind: Retry LogonControl RPC in ping-dc after session
367       expiration.
370 o   Andreas Schneider <asn@samba.org>
371     * BUG 10279: s3-lib: Do not require a password with --use-ccache.
372     * BUG 10960: s3-smbclient: Return success if we listed the shares.
373     * BUG 10961: s3-smbstatus: Fix exit code of profile output.
376 #######################################
377 Reporting bugs & Development Discussion
378 #######################################
380 Please discuss this release on the samba-technical mailing list or by
381 joining the #samba-technical IRC channel on irc.freenode.net.
383 If you do report problems then please try to send high quality
384 feedback. If you don't provide vital information to help us track down
385 the problem then you will probably be ignored.  All bug reports should
386 be filed under the Samba 4.1 product in the project's Bugzilla
387 database (https://bugzilla.samba.org/).
390 ======================================================================
391 == Our Code, Our Bugs, Our Responsibility.
392 == The Samba Team
393 ======================================================================
396 ----------------------------------------------------------------------
399                    ==============================
400                    Release Notes for Samba 4.1.14
401                           December 1, 2014
402                    ==============================
405 This is the latest stable release of Samba 4.1.
408 Changes since 4.1.13:
409 ---------------------
411 o   Michael Adam <obnox@samba.org>
412     * BUG 10472: Revert buildtools/wafadmin/Tools/perl.py back to upstream
413       state.
416 o   Jeremy Allison <jra@samba.org>
417     * BUG 10711: nmbd fails to accept "--piddir" option.
418     * BUG 10896: s3-nmbd: Fix netbios name truncation.
419     * BUG 10904: s3: libsmbclient-smb2. MacOSX 10 SMB2 server doesn't set
420       STATUS_NO_MORE_FILES when handed a non-wildcard path.
421     * BUG 10920: s3: nmbd: Ensure NetBIOS names are only 15 characters stored.
424 o   Günther Deschner <gd@samba.org>
425     * BUG 10942: Cleanup add_string_to_array and usage.
428 o   David Disseldorp <ddiss@samba.org>
429     * BUG 10898: spoolss: Fix handling of bad EnumJobs levels.
430     * BUG 10905: spoolss: Fix jobid in level 3 EnumJobs response.
433 o   Amitay Isaacs <amitay@gmail.com>
434     * BUG 10620: s4-dns: Add support for BIND 9.10.
437 o   Björn Jacke <bj@sernet.de>
438     * BUG 10835: nss_winbind: Add getgroupmembership for FreeBSD.
441 o   Volker Lendecke <vl@samba.org>
442     * BUG 10932: pdb_tdb: Fix a TALLOC/SAFE_FREE mixup.
445 o   Stefan Metzmacher <metze@samba.org>
446     * BUG 10472: pidl/wscript: Remove --with-perl-* options.
447     * BUG 10921: s3:smbd: Fix file corruption using "write cache size != 0".
450 o   Jose A. Rivera <jarrpa@redhat.com>
451     * BUG 10889: vfs_glusterfs: Remove "integer fd" code and store the glfs
452       pointers.
455 o   Matt Rogers <mrogers@redhat.com>
456     * BUG 10933: s3-keytab: Fix keytab array NULL termination.
459 o   Richard Sharpe <realrichardsharpe@gmail.com>
460     * BUG 10880: S3: source3/smbd/process.c::srv_send_smb() returns true on the
461       error path.
464 #######################################
465 Reporting bugs & Development Discussion
466 #######################################
468 Please discuss this release on the samba-technical mailing list or by
469 joining the #samba-technical IRC channel on irc.freenode.net.
471 If you do report problems then please try to send high quality
472 feedback. If you don't provide vital information to help us track down
473 the problem then you will probably be ignored.  All bug reports should
474 be filed under the Samba 4.1 product in the project's Bugzilla
475 database (https://bugzilla.samba.org/).
478 ======================================================================
479 == Our Code, Our Bugs, Our Responsibility.
480 == The Samba Team
481 ======================================================================
484 ----------------------------------------------------------------------
487                    ==============================
488                    Release Notes for Samba 4.1.13
489                          October 20, 2014
490                    ==============================
493 This is the latest stable release of Samba 4.1.
496 Changes since 4.1.12:
497 ---------------------
499 o    Michael Adam <obnox@samba.org>
500      * BUG 10809: s3:smbd:open_file: Use a more natural check.
503 o   Jeremy Allison <jra@samba.org>
504     * BUG 10717: s3: winbindd: Old NT Domain code sets struct
505       winbind_domain->alt_name to be NULL. Ensure this is safe with modern
506       AD-DCs.
507     * BUG 10779: pthreadpool: Slightly serialize jobs.
508     * BUG 10809: s3: smbd: Open logic fix.
509     * BUG 10830: s3: nmbd: Ensure the main nmbd process doesn't create zombies.
510     * BUG 10831: s3: lib: Signal handling - ensure smbrun and change password
511       code save and restore existing SIGCHLD handlers.
512     * BUG 10848: s3: smb2cli: Query info return length check was reversed.
515 o   Günther Deschner <gd@samba.org>
516     * BUG 9984: s3-libnet: Make sure we do not overwrite precreated SPNs.
519 o   Björn Jacke <bj@sernet.de
520     * BUG 10814: docs: Mention incompatibility between kernel oplocks and
521       streams_xattr.
524 o   Volker Lendecke <vl@samba.org>
525     * BUG 10735: Fix unstrcpy.
526     * BUG 10797: s3: smbd: streams - Ensure share mode validation ignores
527       internal opens (op_mid == 0).
528     * BUG 10813: vfs_media_harmony: Fix a crash bug.
529     * BUG 10860: registry: Don't leave dangling transactions.
532 o   Christof Schmitt <cs@samba.org>
533     * BUG 10826: s3-winbindd: Use correct realm for trusted domains in idmap
534       child.
535     * BUG 10837: idmap_rfc2307: Fix a crash after connection problem to DC.
536     * BUG 10838: s3-winbindd: Do not use domain SID from LookupSids for
537       Sids2UnixIDs call.
540 o   Andreas Schneider <asn@samba.org>
541     * BUG 9984: s3-libnet: Add libnet_join_get_machine_spns().
542     * BUG 9985: s3-libads: Add all machine account principals to the keytab.
543     * BUG 10816: nmbd: Send waiting status to systemd.
544     * BUG 10817: libcli: Fix a segfault calling smbXcli_req_set_pending() on
545       NULL.
546     * BUG 10824: nsswitch: Skip groups we were not able to map.
549 #######################################
550 Reporting bugs & Development Discussion
551 #######################################
553 Please discuss this release on the samba-technical mailing list or by
554 joining the #samba-technical IRC channel on irc.freenode.net.
556 If you do report problems then please try to send high quality
557 feedback. If you don't provide vital information to help us track down
558 the problem then you will probably be ignored.  All bug reports should
559 be filed under the Samba 4.1 product in the project's Bugzilla
560 database (https://bugzilla.samba.org/).
563 ======================================================================
564 == Our Code, Our Bugs, Our Responsibility.
565 == The Samba Team
566 ======================================================================
569 ----------------------------------------------------------------------
572                    ==============================
573                    Release Notes for Samba 4.1.12
574                          September 8, 2014
575                    ==============================
578 This is the latest stable release of Samba 4.1.
580 Major enhancements in Samba 4.1.12 include:
582 o  New parameter "winbind request timeout" has been added (bug #3204). Please
583    see smb.conf man page for details.
584 o  Fix smbd crashes when filename contains non-ascii character (bug #10716).
585 o  dnsserver: Handle updates of tombstoned dnsNode objects (bug #10749).
588 Changes since 4.1.11:
589 ---------------------
591 o   Michael Adam <obnox@samba.org>
592     * BUG 10369: build: Fix configure to honour '--without-dmapi'.
593     * BUG 10737: s3:idmap: Don't log missing range config if range checking not
594       requested.
595     * BUG 10741: Fix flapping VFS gpfs offline bit.
598 o   Jeremy Allison <jra@samba.org>
599     * BUG 3204: s3: winbindd: On new client connect, prune idle or hung
600       connections older than "winbind request timeout". Add new parameter
601       "winbind request timeout".
602     * BUG 10640: lib: tevent: make TEVENT_SIG_INCREMENT atomic.
603     * BUG 10650: Make "case sensitive = True" option working with
604       "max protocol = SMB2" or higher in large directories.
605     * BUG 10716: Fix smbd crashes when filename contains non-ascii
606       character.
607     * BUG 10728: 'net time': Fix usage and core dump.
608     * BUG 10773: s3: smbd: POSIX ACLs. Remove incorrect check for
609       SECINFO_PROTECTED_DACL in incoming security_information flags in
610       posix_get_nt_acl_common().
611     * BUG 10794: vfs_dirsort: Fix an off-by-one error that can cause
612       uninitialized memory read.
615 o   Björn Baumbach <bb@sernet.de>
616     * BUG 10543: s3: Enforce a positive allocation_file_size for non-empty
617       files.
620 o   Kai Blin <kai@samba.org>
621     * BUG 10466: provision: Correctly provision the SOA record minimum TTL.
624 o   David Disseldorp <ddiss@samba.org>
625     * BUG 10652: Samba 4 consuming a lot of CPU when re-reading printcap info.
626     * BUG 10787: dosmode: Fix FSCTL_SET_SPARSE request validation.
629 o   Amitay Isaacs <amitay@gmail.com>
630     * BUG 10742: s4-rpc: dnsserver: Allow . to be specified for @ record.
633 o   Daniel Kobras <d.kobras@science-computing.de>
634     * BUG 10731: sys_poll_intr: Fix timeout arithmetic.
637 o   Ross Lagerwall <rosslagerwall@gmail.com>
638     * BUG 10778: s3:libsmb: Set a max charge for SMB2 connections.
641 o   Volker Lendecke <vl@samba.org>
642     * BUG 10716: lib: strings: Simplify strcasecmp.
643     * BUG 10758: lib: Remove unused nstrcpy.
644     * BUG 10782: smbd: Properly initialize mangle_hash.
647 o   Stefan Metzmacher <metze@samba.org>
648     * BUG 9831: s4:setup/dns_update_list: make use of the new substitution
649       variables.
650     * BUG 10723: Allow netr_ServerReqChallenge() and netr_ServerAuthenticate3()
651       on different connections.
652     * BUG 10749: s4-rpc: dnsserver: Handle updates of tombstoned dnsNode
653       objects.
654     * BUG 10751: s4-rpc: dnsserver: return DNS_RANK_NS_GLUE recors when
655       explicitly asked for.
656     * BUG 10773: libcli/security: Add better detection of
657       SECINFO_[UN]PROTECTED_[D|S]ACL in get_sec_info().
660 o   Marc Muehlfeld <mmuehlfeld@samba.org>
661     * BUG 10761: docs: Fix typos in smb.conf (inherit acls).
664 o   Shirish Pargaonkar <spargaonkar@suse.com>
665     * BUG 10755: samba: Retain case sensitivity of cifs client.
668 o   Arvid Requate <requate@univention.de>
669     * BUG 9570: passdb: Fix NT_STATUS_NO_SUCH_GROUP.
672 o   Har Gagan Sahai <SHarGagan@novell.com>
673     * BUG 10759: Fix a memory leak in cli_set_mntpoint().
676 o   Roel van Meer <roel@1afa.com>
677     * BUG 10777: Don't discard result of checking grouptype.
680 #######################################
681 Reporting bugs & Development Discussion
682 #######################################
684 Please discuss this release on the samba-technical mailing list or by
685 joining the #samba-technical IRC channel on irc.freenode.net.
687 If you do report problems then please try to send high quality
688 feedback. If you don't provide vital information to help us track down
689 the problem then you will probably be ignored.  All bug reports should
690 be filed under the Samba 4.1 product in the project's Bugzilla
691 database (https://bugzilla.samba.org/).
694 ======================================================================
695 == Our Code, Our Bugs, Our Responsibility.
696 == The Samba Team
697 ======================================================================
700 ----------------------------------------------------------------------
703                    ==============================
704                    Release Notes for Samba 4.1.11
705                            August 1, 2014
706                    ==============================
709 This is a security release in order to address
710 CVE-2014-3560 (Remote code execution in nmbd).
712 o  CVE-2014-3560:
713    Samba 4.0.0 to 4.1.10 are affected by a remote code execution attack on
714    unauthenticated nmbd NetBIOS name services.
716    A malicious browser can send packets that may overwrite the heap of
717    the target nmbd NetBIOS name services daemon. It may be possible to
718    use this to generate a remote code execution vulnerability as the
719    superuser (root).
722 Changes since 4.1.10:
723 ---------------------
725 o   Volker Lendecke <vl@samba.org>
726     * BUG 10735: CVE-2014-3560: Fix unstrcpy macro length.
729 #######################################
730 Reporting bugs & Development Discussion
731 #######################################
733 Please discuss this release on the samba-technical mailing list or by
734 joining the #samba-technical IRC channel on irc.freenode.net.
736 If you do report problems then please try to send high quality
737 feedback. If you don't provide vital information to help us track down
738 the problem then you will probably be ignored.  All bug reports should
739 be filed under the Samba 4.1 product in the project's Bugzilla
740 database (https://bugzilla.samba.org/).
743 ======================================================================
744 == Our Code, Our Bugs, Our Responsibility.
745 == The Samba Team
746 ======================================================================
749 ----------------------------------------------------------------------
752                    ==============================
753                    Release Notes for Samba 4.1.10
754                            July 28, 2014
755                    ==============================
758 This is the latest stable release of Samba 4.1.
761 Changes since 4.1.9:
762 --------------------
764 o   Michael Adam <obnox@samba.org>
765     * BUG 10693: Backport ldb-1.1.17 + changes from master.
768 o   Jeremy Allison <jra@samba.org>
769     * BUG 10587: s3: libsmbclient: Work around bugs in SLES cifsd and Apple smbx
770       SMB1 servers.
771     * BUG 10653: Samba won't start on a machine configured with only IPv4.
772     * BUG 10671: s3: smbd: Prevent file truncation on an open that fails with
773       share mode violation.
774     * BUG 10673: s3: SMB2: Fix leak of blocking lock records in the database.
775     * BUG 10684: SMB1 blocking locks can fail notification on unlock, causing
776       client timeout.
777     * BUG 10685: s3: smbd: Locking, fix off-by one calculation in
778       brl_pending_overlap().
779     * BUG 10692: wbcCredentialCache fails if challenge_blob is not first.
782 o   Christian Ambach <ambi@samba.org>
783     * BUG 10693: lib/ldb: Fix compiler warnings.
786 o   Andrew Bartlett <abartlet@samba.org>
787     * BUG 8077: dbcheck: Add check and test for various invalid userParameters
788       values.
789     * BUG 8449: Simple use case results in "no talloc stackframe around, leaking
790       memory" error.)
791     * BUG 10130: dsdb: Always store and return the userParameters as a array of
792       LE 16-bit values.
793     * BUG 10582: dsdb: Rename private_data to rootdse_private_data in rootdse.
794     * BUG 10627: rid_array used before status checked - segmentation fault due
795       to null pointer dereference.
796     * BUG 10693: ldb: make the successful ldb_transaction_start() message
797       clearer.
798     * BUG 10694: dsdb: Return NO_SUCH_OBJECT if a basedn is a deleted object.
799     * BUG 10700: Backport access check related fixes from master.
802 o   Björn Baumbach <bb@sernet.de>
803     * BUG 10674: samba-tool: Add --site parameter to provision command.
806 o   Howard Chu <hyc@symas.com>
807     * BUG 10693: Fix SEGV from improperly formed SUBSTRING/PRESENCE filter.
810 o   Jeroen Dekkers <jeroen@dekkers.ch>
811     * BUG 10693: ldb: Do not build libldb-cmdline when using system ldb.
814 o   Nadezhda Ivanova <nivanova@symas.com>
815     * BUG 10693: s4-openldap: Remove use of talloc_reference in
816       ldb_map_outbound.c
819 o   Björn Jacke <bj@sernet.de>
820     * BUG 3263: net/doc: Make clear that net vampire is for NT4 domains only.
823 o   Abhidnya Joshi <achirmul@in.ibm.com>
824     * BUG s3: Fix missing braces in nfs4_acls.c.
827 o   Volker Lendecke <vl@samba.org>
828     * BUG 10593: Fix "PANIC: assert failed at ../source3/smbd/open.c(1582): ret".
829     * BUG 10663: msg_channel: Fix a 100% CPU loop.
830     * BUG 10671: s3: smbd: Prevent file truncation on an open that fails with
831       share mode violation.
832     * BUG 10680: smbstatus: Fix an uninitialized variable.
833     * BUG 10687: 'RW2' smbtorture test fails when -N <numprocs> is set to 2 due
834       to the invalid status check in the second client.
835     * BUG 10693: ldb: Fix 1138330 Dereference null return value, fix CIDs
836       241329, 240798, 1034791, 1034792 1034910, 1034910).
837     * BUG 10699: smbd: Avoid double-free in get_print_db_byname.
840 o   Stefan Metzmacher <metze@samba.org>
841     * BUG 8077: s4:dsdb/samldb: Don't allow 'userParameters' to be modified over
842       LDAP for now.
843     * BUG 9763: s4:dsdb/repl_meta_data: Make sure objectGUID can't be deleted.
844     * BUG 10469: ldb-samba: fix a memory leak in
845       ldif_canonicalise_objectCategory().
846     * BUG 10294: s4:repl_meta_data: fix array assignment in
847       replmd_process_linked_attribute().
848     * BUG 10536: dbchecker: Verify and fix broken dn values.
849     * BUG 10692: wbcCredentialCache fails if challenge_blob is not first.
850     * BUG 10693: ldb:pyldb: Add some more helper functions for LdbDn.
851     * BUG 10694: s4:dsdb/extended_dn_in: Don't force DSDB_SEARCH_SHOW_RECYCLED.
852     * BUG 10696: Backport autobuild/selftest fixes from master.
853     * BUG 10706: s3:smb2_read: let smb2_sendfile_send_data() behave like
854       send_file_readX().
857 o   Matthieu Patou <mat@matws.net>
858     * BUG 10693: pyldb: Decrement ref counters on py_results and quiet warnings.
859     * BUG 10698: Backport drs-crackname fixes from master.
862 o   Pavel Reichl <pavel.reichl@redhat.com>
863     * BUG 10693: ldb: Use of NULL pointer bugfix.
866 o   Garming Sam <garming@catalyst.net.nz>
867     * BUG 10703: Backport provision fixes from master.
870 o   Andreas Schneider <asn@samba.org>
871     * BUG 10693: ldb: Add a env variable to disable RTLD_DEEPBIND.
874 #######################################
875 Reporting bugs & Development Discussion
876 #######################################
878 Please discuss this release on the samba-technical mailing list or by
879 joining the #samba-technical IRC channel on irc.freenode.net.
881 If you do report problems then please try to send high quality
882 feedback. If you don't provide vital information to help us track down
883 the problem then you will probably be ignored.  All bug reports should
884 be filed under the Samba 4.1 product in the project's Bugzilla
885 database (https://bugzilla.samba.org/).
888 ======================================================================
889 == Our Code, Our Bugs, Our Responsibility.
890 == The Samba Team
891 ======================================================================
894 ----------------------------------------------------------------------
897                    =============================
898                    Release Notes for Samba 4.1.9
899                            June 23, 2014
900                    =============================
903 This is a security release in order to address
904 CVE-2014-0244 (Denial of service - CPU loop) and
905 CVE-2014-3493 (Denial of service - Server crash/memory corruption).
907 o  CVE-2014-0244:
908    All current released versions of Samba are vulnerable to a denial of
909    service on the nmbd NetBIOS name services daemon. A malformed packet
910    can cause the nmbd server to loop the CPU and prevent any further
911    NetBIOS name service.
913    This flaw is not exploitable beyond causing the code to loop expending
914    CPU resources.
916 o  CVE-2014-3493:
917    All current released versions of Samba are affected by a denial of service
918    crash involving overwriting memory on an authenticated connection to the
919    smbd file server.
922 Changes since 4.1.8:
923 --------------------
925 o   Jeremy Allison <jra@samba.org>
926     * BUG 10633: CVE-2014-0244: Fix nmbd denial of service.
927     * BUG 10654: CVE-2014-3493: Fix segmentation fault in
928       smbd_marshall_dir_entry()'s SMB_FIND_FILE_UNIX handler.
931 #######################################
932 Reporting bugs & Development Discussion
933 #######################################
935 Please discuss this release on the samba-technical mailing list or by
936 joining the #samba-technical IRC channel on irc.freenode.net.
938 If you do report problems then please try to send high quality
939 feedback. If you don't provide vital information to help us track down
940 the problem then you will probably be ignored.  All bug reports should
941 be filed under the Samba 4.1 product in the project's Bugzilla
942 database (https://bugzilla.samba.org/).
945 ======================================================================
946 == Our Code, Our Bugs, Our Responsibility.
947 == The Samba Team
948 ======================================================================
951 ----------------------------------------------------------------------
954                    =============================
955                    Release Notes for Samba 4.1.8
956                            June 3, 2014
957                    =============================
960 This is the latest stable release of Samba 4.1.
962 Please note that this bug fix release also addresses two minor security issues
963 without being a dedicated security release:
965   o CVE-2014-0239: dns: Don't reply to replies (bug #10609).
966   o CVE-2014-0178: Malformed FSCTL_SRV_ENUMERATE_SNAPSHOTS response
967     (bug #10549).
969 For more details including security advisories and patches, please see
971   http://www.samba.org/samba/history/security.html
974 Changes since 4.1.7:
975 --------------------
977 o   Michael Adam <obnox@samba.org>
978     * BUG 10548: build: Fix ordering problems with lib-provided and internal
979       RPATHs.
982 o   Jeremy Allison <jra@samba.org>
983     * BUG 3124: s3: smb2: Fix 'xcopy /d' with samba shares.
984     * BUG 10544: s3: lib/util: Fix logic inside set_namearray loops.
985     * BUG 10564: Fix lock order violation and file lost.
986     * BUG 10577: Fix wildcard unlink to fail if we get an error rather than
987       trying to continue.
990 o   Andrew Bartlett <abartlet@samba.org>
991     * BUG 10569: dsdb: Do checks for invalid renames in samldb, before
992       repl_meta_data.
995 o   Björn Baumbach <bb@sernet.de>
996     * BUG 10239: s3: nmbd: Reset debug settings after reading config file.
997     * BUG 10544: s3: lib/util: set_namearray reads across end of namelist
998     * BUG 10556: lib-util: Rename memdup to smb_memdup and fix all callers.
1001 o   Kai Blin <kai@samba.org>
1002     * BUG 10609: CVE-2014-0239: dns: Don't reply to replies.
1005 o   Alexander Bokovoy <ab@samba.org>
1006     * BUG 10517: Use exit_daemon() to communicate status of startup to
1007       systemd.
1010 o   David Disseldorp <ddiss@samba.org>
1011     * BUG 10590: byteorder: Do not assume PowerPC is big-endian.
1012     * BUG 10612: printing: Fix purge of all print jobs.
1015 o   Benjamin Franzke <benjaminfranzke@googlemail.com>
1016     * BUG 10524: Fix adding NetApps.
1019 o   Abhidnya Joshi <achirmul@in.ibm.com>
1020     * BUG 10547: idmap_autorid: Fix failure in reverse lookup if ID is from
1021       domain range index #0.
1024 o   Stefan Metzmacher <metze@samba.org>
1025     * BUG 10472: script/autobuild: Make use of
1026       '--with-perl-{arch,lib}-install-dir'.
1029 o   Noel Power <nopower@suse.com>
1030     * BUG 10554: Fix read of deleted memory in reply_writeclose()'.
1033 o   Jose A. Rivera <jarrpa@redhat.com>
1034     * BUG 10151: Extra ':' in msg for Waf Cross Compile Build System with
1035       Cross-answers command.
1036     * BUG 10348: Fix empty body in if-statement in continue_domain_open_lookup.
1039 o   Christof Schmitt <christof.schmitt@us.ibm.com>
1040     * BUG 10549: CVE-2014-0178: Malformed FSCTL_SRV_ENUMERATE_SNAPSHOTS
1041       response.
1044 o   Andreas Schneider <asn@samba.org>
1045     * BUG 10472: wafsamba: Fix the installation on FreeBSD.
1048 #######################################
1049 Reporting bugs & Development Discussion
1050 #######################################
1052 Please discuss this release on the samba-technical mailing list or by
1053 joining the #samba-technical IRC channel on irc.freenode.net.
1055 If you do report problems then please try to send high quality
1056 feedback. If you don't provide vital information to help us track down
1057 the problem then you will probably be ignored.  All bug reports should
1058 be filed under the Samba 4.1 product in the project's Bugzilla
1059 database (https://bugzilla.samba.org/).
1062 ======================================================================
1063 == Our Code, Our Bugs, Our Responsibility.
1064 == The Samba Team
1065 ======================================================================
1068 ----------------------------------------------------------------------
1071                    =============================
1072                    Release Notes for Samba 4.1.7
1073                            April 17, 2014
1074                    =============================
1077 This is the latest stable release of Samba 4.1.
1080 Changes since 4.1.6:
1081 --------------------
1083 o   Jeremy Allison <jra@samba.org>
1084     * BUG 9878: Make "force user" work as expected.
1085     * BUG 9942: Fix problem with server taking too long to respond to a
1086       MSG_PRINTER_DRVUPGRADE message.
1087     * BUG 9993: s3-printing: Fix obvious memory leak in
1088       printer_list_get_printer().
1089     * BUG 10344: SessionLogoff on a signed connection with an outstanding notify
1090       request crashes smbd.
1091     * BUG 10431: Fix STATUS_NO_MEMORY response from Query File Posix Lock request.
1092     * BUG 10508: smbd: Correctly add remote users into local groups.
1093     * BUG 10534: Cleanup messages.tdb record after unclean smbd shutdown.
1096 o   Christian Ambach <ambi@samba.org>
1097     * BUG 9911: Fix build on AIX with IBM XL C/C++ (gettext detection issues).
1098     * BUG 10308: Fix String Conversion Errors with Samba 4.1.0 Build on AIX 7.1.
1101 o   Gregor Beck <gbeck@sernet.de>
1102     * BUG 10230: Make (lib)smbclient work with NetApp.
1103     * BUG 10458: Fix 'wbinfo -i' with one-way trust.
1104     * s3:rpc_server: Minor refactoring of process_request_pdu().
1107 o   Kai Blin <kai@samba.org>
1108     * BUG 10471: Don't respond with NXDOMAIN to records that exist with another
1109       type.
1112 o   Alexander Bokovoy <ab@samba.org>
1113     * BUG 10504: lsa.idl: Define lsa.ForestTrustCollisionInfo and
1114       ForestTrustCollisionRecord as public structs.
1117 o   Günther Deschner <gd@samba.org>
1118     * BUG 10439: Increase max netbios name components.
1121 o   David Disseldorp <ddiss@samba.org>
1122     * BUG 10188: doc: Add "spoolss: architecture" parameter usage.
1123     * BUG 10484: Initial FSRVP rpcclient requests fail with
1124       NT_STATUS_PIPE_NOT_AVAILABLE.
1125     * BUG 10521: rpcclient FSRVP request UNCs should include a trailing
1126       backslash.
1129 o   Daniel Liberman <danielvl@gmail.com>
1130     * BUG 10387: 'net ads search' on high latency networks can return a partial
1131       list with no error indication.
1134 o   Stefan Metzmacher <metze@samba.org>
1135     * BUG 10200: Make 'smbclient' support DFS shares with SMB2/3.
1136     * BUG 10344: SessionLogoff on a signed connection with an outstanding notify
1137       request crashes smbd.
1138     * BUG 10422: max xmit > 64kb leads to segmentation fault.
1139     * BUG 10444: smbd_server_connection_terminate("CTDB_SRVID_RELEASE_IP")
1140       panics from within ctdbd_migrate() with invalid lock_order.
1141     * BUG 10464: samba4 services not binding on IPv6 addresses causing
1142       connection delays.
1145 o   Garming Sam <garming@catalyst.net.nz>
1146     * BUG 10378: dfs: Always call create_conn_struct with root privileges.
1149 o   Andreas Schneider <asn@cryptomilk.org>
1150     * BUG 10467: s3-vfs: Fix stream_depot vfs module on btrfs.
1151     * BUG 10472: pidl: waf should have an option for the dir to install perl
1152       files and do not glob.
1153     * BUG 10474: s3-spoolssd: Don't register spoolssd if epmd is not running.
1154     * BUG 10481: s3-rpc_server: Fix handling of fragmented rpc requests.
1157 o   Gustavo Zacarias <gustavo@zacarias.com.ar>
1158     * BUG 10506: Make 'smbreadline' build with readline 6.3.
1161 #######################################
1162 Reporting bugs & Development Discussion
1163 #######################################
1165 Please discuss this release on the samba-technical mailing list or by
1166 joining the #samba-technical IRC channel on irc.freenode.net.
1168 If you do report problems then please try to send high quality
1169 feedback. If you don't provide vital information to help us track down
1170 the problem then you will probably be ignored.  All bug reports should
1171 be filed under the Samba 4.1 product in the project's Bugzilla
1172 database (https://bugzilla.samba.org/).
1175 ======================================================================
1176 == Our Code, Our Bugs, Our Responsibility.
1177 == The Samba Team
1178 ======================================================================
1181 ----------------------------------------------------------------------
1184                    =============================
1185                    Release Notes for Samba 4.1.6
1186                            March 11, 2014
1187                    =============================
1190 This is a security release in order to address
1191 CVE-2013-4496 (Password lockout not enforced for SAMR password changes) and
1192 CVE-2013-6442 (smbcacls can remove a file or directory ACL by mistake).
1194 o  CVE-2013-4496:
1195    Samba versions 3.4.0 and above allow the administrator to implement
1196    locking out Samba accounts after a number of bad password attempts.
1198    However, all released versions of Samba did not implement this check for
1199    password changes, such as are available over multiple SAMR and RAP
1200    interfaces, allowing password guessing attacks.
1202 o  CVE-2013-6442:
1203    Samba versions 4.0.0 and above have a flaw in the smbcacls command. If
1204    smbcacls is used with the "-C|--chown name" or "-G|--chgrp name"
1205    command options it will remove the existing ACL on the object being
1206    modified, leaving the file or directory unprotected.
1209 Changes since 4.1.5:
1210 --------------------
1212 o   Jeremy Allison <jra@samba.org>
1213     * BUG 10327: CVE-2013-6442: ensure we don't lose an existing ACL when
1214       setting owner or group owner.
1217 o   Andrew Bartlett <abartlet@samba.org>
1218     * BUG 10245: CVE-2013-4496: Enforce password lockout for SAMR password
1219       changes.
1222 o   Stefan Metzmacher <metze@samba.org>
1223     * BUG 10245: CVE-2013-4496: Enforce password lockout for SAMR password
1224       changes.
1227 #######################################
1228 Reporting bugs & Development Discussion
1229 #######################################
1231 Please discuss this release on the samba-technical mailing list or by
1232 joining the #samba-technical IRC channel on irc.freenode.net.
1234 If you do report problems then please try to send high quality
1235 feedback. If you don't provide vital information to help us track down
1236 the problem then you will probably be ignored.  All bug reports should
1237 be filed under the Samba 4.1 product in the project's Bugzilla
1238 database (https://bugzilla.samba.org/).
1241 ======================================================================
1242 == Our Code, Our Bugs, Our Responsibility.
1243 == The Samba Team
1244 ======================================================================
1247 ----------------------------------------------------------------------
1250                    =============================
1251                    Release Notes for Samba 4.1.5
1252                          February 21, 2014
1253                    =============================
1256 This is the latest stable release of Samba 4.1.
1258 Major enhancements in Samba 4.1.5 include:
1260 o  Fix 100% CPU utilization in winbindd when trying to free memory in
1261    winbindd_reinit_after_fork (bug #10358).
1262 o  smbd: Fix memory overwrites (bug #10415).
1265 Changes since 4.1.4:
1266 --------------------
1268 o   Michael Adam <obnox@samba.org>
1269     * BUG 10259: Make shadow_copy2 module working with Windows 7.
1272 o   Jeremy Allison <jra@samba.org>
1273     * BUG 2662: Make revamped directory handling code 64bit clean.
1274     * BUG 10320: s3: smbpasswd: Fix crashes on invalid input.
1275     * BUG 10358: Fix 100% CPU utilization in winbindd when trying to free
1276       memory in winbindd_reinit_after_fork.
1277     * BUG 10406: s3: vfs_dirsort module: Allow dirsort to work when multiple
1278       simultaneous directories are open.
1279     * BUG 10429: s3: modules: streaminfo: As we have no VFS function
1280       SMB_VFS_LLISTXATTR we can't cope with a symlink when lp_posix_pathnames()
1281       is true.
1284 o   Alistair Leslie-Hughes <leslie_alistair@hotmail.com>
1285     * BUG 10087: ntlm_auth sometimes returns the wrong username to
1286       mod_ntlm_auth_winbind.
1289 o   Andrew Bartlett <abartlet@samba.org>
1290     * BUG 10418: Fix INTERNAL ERROR: Signal 11 in the kdc pid.
1293 o   Jeffrey Clark <dude@zaplabs.com>
1294     * BUG 10418: Add support for Heimdal's unified krb5 and hdb plugin system.
1297 o   Niels de Vos <ndevos@redhat.com>
1298     * BUG 10384: vfs/glusterfs: In case atime is not passed, set it to the
1299       current atime.
1302 o   David Disseldorp <ddiss@samba.org>
1303     * BUG 10424: vfs_btrfs: Fix incorrect zero length server-side copy request
1304       handling.
1307 o   Volker Lendecke <vl@samba.org>
1308     * BUG 2191: s3-winbind: Improve performance of wb_fill_pwent_sid2uid_done().
1309     * BUG 10415: smbd: Fix memory overwrites.
1310     * BUG 10436: smbd: Fix an ancient oplock bug.
1313 o   Stefan Metzmacher <metze@samba.org>
1314     * BUG 10442: Fix crash bug in smb2_notify code.
1317 o   Andreas Schneider <asn@samba.org>
1318     * BUG 10367: Fix several memory leaks.
1321 o   Jelmer Vernooij <jelmer@samba.org>
1322     * BUG 10418: Cope with first element in hdb_method having a different name
1323       in different heimdal versions.
1326 #######################################
1327 Reporting bugs & Development Discussion
1328 #######################################
1330 Please discuss this release on the samba-technical mailing list or by
1331 joining the #samba-technical IRC channel on irc.freenode.net.
1333 If you do report problems then please try to send high quality
1334 feedback. If you don't provide vital information to help us track down
1335 the problem then you will probably be ignored.  All bug reports should
1336 be filed under the Samba 4.1 product in the project's Bugzilla
1337 database (https://bugzilla.samba.org/).
1340 ======================================================================
1341 == Our Code, Our Bugs, Our Responsibility.
1342 == The Samba Team
1343 ======================================================================
1346 ----------------------------------------------------------------------
1349                    =============================
1350                    Release Notes for Samba 4.1.4
1351                          January 10, 2014
1352                    =============================
1355 This is the latest stable release of Samba 4.1.
1357 Major enhancements in Samba 4.1.4 include:
1359 o  Fix segfault in smbd (bug #10284).
1360 o  Fix SMB2 server panic when a smb2 brlock times out (bug #10311).
1363 Changes since 4.1.3:
1364 --------------------
1366 o   Jeremy Allison <jra@samba.org>
1367     * BUG 9870: smbd: Allow updates on directory write times on open handles.
1368     * BUG 10260: smbclient shows no error if deleting a directory with del
1369       failed.
1370     * BUG 10297: smbd: Fix writing to a directory with -wx permissions
1371       on a share.
1372     * BUG 10305: ldb: bad if test in ldb_comparison_fold().
1375 o   Christian Ambach <ambi@samba.org>
1376     * BUG 10276: Fix waf build error on AIX with IBM XL C/C++.
1377     * BUG 10280: s3:winbindd fix use of uninitialized variables.
1380 o   Michele Baldessari <michele@acksyn.org>
1381     * BUG 10281: Fix typos in man pages.
1384 o   Jan Brummer <jan.brummer@tabos.org>
1385     * BUG 10285: s3-winbindd: Fix DEBUG statement in winbind_msg_offline().
1388 o   Günther Deschner <gd@samba.org>
1389     * BUG 10262: s3-libnetjoin: Use upper-case realm when composing default
1390       upn.
1391     * BUG 10281: Fix numerous typos in man pages.
1394 o   David Disseldorp <ddiss@samba.org>
1395     * BUG 10271: Send correct job-ID in print job notifications.
1398 o   Poornima Gurusiddaiah <pgurusid@redhat.com>
1399     * BUG 10337: vfs_glusterfs: Enable per client log file.
1402 o   Volker Lendecke <vl@samba.org>
1403     * BUG 10250: smbd: Fix a talloc hierarchy problem in msg_channel.
1404     * BUG 10284: smbd: Fix segfaults.
1405     * BUG 10297: smbd: Fix writing to a directory with -wx permissions
1406       on a share.
1407     * BUG 10311: Fix SMB2 server panic when a smb2 brlock times out.
1410 o   Stefan Metzmacher <metze@samba.org>
1411     * BUG 10298: Reduce smb2_server processing overhead.
1414 o   Arvid Requate <requate@univention.de>
1415     * BUG 10267: Fix printing via local printer drivers with Windows 8.
1418 o   Christof Schmitt <cs@samba.org>
1419     * BUG 10310: Fix AIO with SMB2 and locks.
1422 o   Andreas Schneider <asn@samba.org>
1423     * BUG 2191: Fix %G/%g substitution in 'template homedir'.
1424     * BUG 10274: Fix several issues and warnings from analyzer tools.
1425     * BUG 10286: s3-lib: Fix %G substitution for domain users in smbd.
1428 #######################################
1429 Reporting bugs & Development Discussion
1430 #######################################
1432 Please discuss this release on the samba-technical mailing list or by
1433 joining the #samba-technical IRC channel on irc.freenode.net.
1435 If you do report problems then please try to send high quality
1436 feedback. If you don't provide vital information to help us track down
1437 the problem then you will probably be ignored.  All bug reports should
1438 be filed under the Samba 4.1 product in the project's Bugzilla
1439 database (https://bugzilla.samba.org/).
1442 ======================================================================
1443 == Our Code, Our Bugs, Our Responsibility.
1444 == The Samba Team
1445 ======================================================================
1448 ----------------------------------------------------------------------
1451                    =============================
1452                    Release Notes for Samba 4.1.3
1453                          December 9, 2013
1454                    =============================
1457 This is a security release in order to address
1458 CVE-2013-4408 (DCE-RPC fragment length field is incorrectly checked) and
1459 CVE-2012-6150 (pam_winbind login without require_membership_of restrictions).
1461 o  CVE-2013-4408:
1462    Samba versions 3.4.0 and above (versions 3.4.0 - 3.4.17, 3.5.0 -
1463    3.5.22, 3.6.0 - 3.6.21, 4.0.0 - 4.0.12 and including 4.1.2) are
1464    vulnerable to buffer overrun exploits in the client processing of
1465    DCE-RPC packets. This is due to incorrect checking of the DCE-RPC
1466    fragment length in the client code.
1468    This is a critical vulnerability as the DCE-RPC client code is part of
1469    the winbindd authentication and identity mapping daemon, which is
1470    commonly configured as part of many server installations (when joined
1471    to an Active Directory Domain). A malicious Active Directory Domain
1472    Controller or man-in-the-middle attacker impersonating an Active
1473    Directory Domain Controller could achieve root-level access by
1474    compromising the winbindd process.
1476    Samba server versions 3.4.0 - 3.4.17 and versions 3.5.0 - 3.5.22 are
1477    also vulnerable to a denial of service attack (server crash) due to a
1478    similar error in the server code of those versions.
1480    Samba server versions 3.6.0 and above (including all 3.6.x versions,
1481    all 4.0.x versions and 4.1.x) are not vulnerable to this problem.
1483    In addition range checks were missing on arguments returned from calls
1484    to the DCE-RPC functions LookupSids (lsa and samr), LookupNames (lsa and samr)
1485    and LookupRids (samr) which could also cause similar problems.
1487    As this was found during an internal audit of the Samba code there are
1488    no currently known exploits for this problem (as of December 9th 2013).
1490 o  CVE-2012-6150:
1491    Winbind allows for the further restriction of authenticated PAM logins using
1492    the require_membership_of parameter. System administrators may specify a list
1493    of SIDs or groups for which an authenticated user must be a member of. If an
1494    authenticated user does not belong to any of the entries, then login should
1495    fail. Invalid group name entries are ignored.
1497    Samba versions 3.3.10, 3.4.3, 3.5.0 and later incorrectly allow login from
1498    authenticated users if the require_membership_of parameter specifies only
1499    invalid group names.
1501    This is a vulnerability with low impact. All require_membership_of group
1502    names must be invalid for this bug to be encountered.
1505 Changes since 4.1.2:
1506 --------------------
1508 o   Jeremy Allison <jra@samba.org>
1509     * BUG 10185: CVE-2013-4408: Correctly check DCE-RPC fragment length field.
1512 o   Stefan Metzmacher <metze@samba.org>
1513     * BUG 10185: CVE-2013-4408: Correctly check DCE-RPC fragment length field.
1516 o   Noel Power <noel.power@suse.com>
1517     * BUGs 10300, 10306: CVE-2012-6150: Fail authentication if user isn't
1518       member of *any* require_membership_of specified groups.
1521 #######################################
1522 Reporting bugs & Development Discussion
1523 #######################################
1525 Please discuss this release on the samba-technical mailing list or by
1526 joining the #samba-technical IRC channel on irc.freenode.net.
1528 If you do report problems then please try to send high quality
1529 feedback. If you don't provide vital information to help us track down
1530 the problem then you will probably be ignored.  All bug reports should
1531 be filed under the Samba 4.1 product in the project's Bugzilla
1532 database (https://bugzilla.samba.org/).
1535 ======================================================================
1536 == Our Code, Our Bugs, Our Responsibility.
1537 == The Samba Team
1538 ======================================================================
1541 ----------------------------------------------------------------------
1544                    =============================
1545                    Release Notes for Samba 4.1.2
1546                          November 22, 2013
1547                    =============================
1550 This is is the latest stable release of Samba 4.1.
1553 Changes since 4.1.1:
1554 --------------------
1556 o   Jeremy Allison <jra@samba.org>
1557     * BUG 10187: Missing talloc_free can leak stackframe in error path.
1558     * BUG 10196: RW Deny for a specific user is not overriding RW Allow for a
1559       group.
1562 o   Anand Avati <avati@redhat.com>
1563     * BUG 10224: vfs_glusterfs: Implement proper mashalling/unmarshalling of
1564       ACLs.
1567 o   Andrew Bartlett <abartlet@samba.org>
1568     * BUG 10052: dfs_server: Use dsdb_search_one to catch 0 results as well as
1569       NO_SUCH_OBJECT errors.
1572 o   Samuel Cabrero <scabrero@zentyal.com>
1573     * BUG 9091: s4-dns: dlz_bind9: Create dns-HOSTNAME account disabled.
1576 o   Günther Deschner <gd@samba.org>
1577     * BUG 10264: s3-winbindd: Fix cache_traverse_validate_fn failure for
1578       NDR cache entries.
1581 o   Christopher R. Hertel <crh@redhat.com>
1582     * BUG 10224: vfs_glusterfs: Fix excessive debug output from
1583       vfs_gluster_open().
1586 o   Björn Jacke <bj@sernet.de>
1587     * BUG 10247: xattr: Fix listing EAs on *BSD for non-root users.
1590 o   Volker Lendecke <vl@samba.org>
1591     * BUG 10190: Fix memset used with constant zero length parameter.
1592     * BUG 10195: nsswitch: Fix short writes in winbind_write_sock.
1595 o   Stefan Metzmacher <metze@samba.org>
1596     * BUG 10193: s4:dsdb/rootdse: report 'dnsHostName' instead of 'dNSHostName'.
1597     * BUG 10232: libcli/smb: Fix smb2cli_ioctl*() against Windows 2008.
1600 o   Susant Kumar Palai <spalai@redhat.com>
1601     * BUG 10224: VFS plugin was sending the actual size of the volume instead of
1602       the total number of block units because of which windows was getting the
1603       wrong volume capacity.
1606 o   Andreas Schneider <asn@samba.org>
1607     * BUG 10194: Make offline logon cache updating for cross child domain group
1608       membership.
1609     * BUG 10269: util: Remove 32bit macros breaking strict aliasing.
1610     * BUG 10253: Fix the build of vfs_glusterfs.
1613 #######################################
1614 Reporting bugs & Development Discussion
1615 #######################################
1617 Please discuss this release on the samba-technical mailing list or by
1618 joining the #samba-technical IRC channel on irc.freenode.net.
1620 If you do report problems then please try to send high quality
1621 feedback. If you don't provide vital information to help us track down
1622 the problem then you will probably be ignored.  All bug reports should
1623 be filed under the Samba 4.1 product in the project's Bugzilla
1624 database (https://bugzilla.samba.org/).
1627 ======================================================================
1628 == Our Code, Our Bugs, Our Responsibility.
1629 == The Samba Team
1630 ======================================================================
1633 ----------------------------------------------------------------------
1636                    =============================
1637                    Release Notes for Samba 4.1.1
1638                          November 11, 2013
1639                    =============================
1642 This is a security release in order to address
1643 CVE-2013-4475 (ACLs are not checked on opening an alternate
1644 data stream on a file or directory) and
1645 CVE-2013-4476 (Private key in key.pem world readable).
1647 o  CVE-2013-4475:
1648    Samba versions 3.2.0 and above (all versions of 3.2.x, 3.3.x,
1649    3.4.x, 3.5.x, 3.6.x, 4.0.x and 4.1.x) do not check the underlying
1650    file or directory ACL when opening an alternate data stream.
1652    According to the SMB1 and SMB2+ protocols the ACL on an underlying
1653    file or directory should control what access is allowed to alternate
1654    data streams that are associated with the file or directory.
1656    By default no version of Samba supports alternate data streams
1657    on files or directories.
1659    Samba can be configured to support alternate data streams by loading
1660    either one of two virtual file system modues (VFS) vfs_streams_depot or
1661    vfs_streams_xattr supplied with Samba, so this bug only affects Samba
1662    servers configured this way.
1664    To determine if your server is vulnerable, check for the strings
1665    "streams_depot" or "streams_xattr" inside your smb.conf configuration
1666    file.
1668 o  CVE-2013-4476:
1669    In setups which provide ldap(s) and/or https services, the private
1670    key for SSL/TLS encryption might be world readable. This typically
1671    happens in active directory domain controller setups.
1674 Changes since 4.1.0:
1675 --------------------
1677 o   Jeremy Allison <jra@samba.org>
1678     * BUGs 10234 + 10229: CVE-2013-4475: Fix access check verification on stream
1679       files.
1682 o   Björn Baumbach <bb@sernet.de>
1683     * BUG 10234: CVE-2013-4476: Private key in key.pem world readable.
1686 #######################################
1687 Reporting bugs & Development Discussion
1688 #######################################
1690 Please discuss this release on the samba-technical mailing list or by
1691 joining the #samba-technical IRC channel on irc.freenode.net.
1693 If you do report problems then please try to send high quality
1694 feedback. If you don't provide vital information to help us track down
1695 the problem then you will probably be ignored.  All bug reports should
1696 be filed under the Samba 4.1 product in the project's Bugzilla
1697 database (https://bugzilla.samba.org/).
1700 ======================================================================
1701 == Our Code, Our Bugs, Our Responsibility.
1702 == The Samba Team
1703 ======================================================================
1706 ----------------------------------------------------------------------
1709                    =============================
1710                    Release Notes for Samba 4.1.0
1711                          October 11, 2013
1712                    =============================
1715 This is is the first stable release of Samba 4.1.
1717 Samba 4.1 will be the next version of the Samba suite and includes
1718 all the technology found in both the Samba4 series and the stable 3.x
1719 series. The primary additional features over Samba 3.6 are
1720 support for the Active Directory logon protocols used by Windows 2000
1721 and above.
1723 Major enhancements in Samba 4.1.0 include:
1725 Client tools support SMB2/3
1726 ===========================
1728 Samba 4.1.0 contains the first release of our client tools
1729 and client library that work over the new protocols SMB2 or SMB3.
1730 Note that SMB3 only works either to a Samba server version 4.0.0
1731 or above, or to a Windows Server running Windows 2012 or Windows 8.
1733 The default protocol for smbclient and smbcacls is still
1734 SMB1 (the NT1 protocol dialect). An SMB2 or SMB3 connection
1735 can be selected in one of two ways. The easiest way to test
1736 the new protocol connection is to add the -mMAX_PROTOCOL
1737 command line switch to either smbclient or smbcacls.
1739 For example, to connect using SMB3 with smbclient a user
1740 would type:
1742 smbclient //server/share -Uuser%password -mSMB3
1744 Another example of connecting using SMB2 using smbcacls
1745 would be:
1747 smbcacls //server/share -Uuser%password -mSMB2 filename
1749 Note that when connecting using SMB2 or SMB3 protocols
1750 the UNIX extensions are no longer available inside the
1751 smbclient command set. This is due to UNIX extensions
1752 not yet being defined for the SMB2 or SMB3 protocols.
1754 The second way to select SMB2 or SMB3 connections is to
1755 set the "client max protocol" parameter in the [global]
1756 section of your smb.conf.
1758 Setting this parameter will cause all client connections
1759 from Samba and its client tools to offer the requested
1760 max protocol to a server on every connection request.
1762 For example, to cause all client tools (including winbindd,
1763 rpcclient, and the libsmbclient library) to attempt use SMB3
1764 by default add the line:
1766 client max protocol = SMB3
1768 to the [global] section of your smb.conf. This has not
1769 been as widely tested as the -mPROTOCOL options, but
1770 is intended to work correctly in the final release of
1771 4.1.0.
1773 Encrypted transport
1774 ===================
1776 Although Samba servers have supported encrypted transport
1777 connections using the UNIX extensions for many years,
1778 selecting SMB3 transport allows encrypted transport
1779 connections to Windows servers that support SMB3, as
1780 well as Samba servers.
1782 In order to enable this, add the "-e" option to the
1783 smbclient command line.
1785 For example, to connect to a Windows 2012 server over
1786 SMB3 and select an encrypted transport you would use
1787 the following command line:
1789 smbclient //Win2012Server/share -Uuser%password -mSMB3 -e
1792 Directory database replication (AD DC mode)
1793 ===========================================
1795 Directory replication has been reworked in order to improve the
1796 correctness and efficiency.
1797 As a net effect of it, replication with other domain controllers with
1798 a heavily modified schema is now possible (ie. Windows 2012 DCs or
1799 other Windows DC with exchange installed) and replication didn't fail
1800 anymore in such environments.
1803 Server-Side Copy Support
1804 ========================
1806 Samba 4.1.0 adds support for server-side copy operations via the SMB2
1807 FSCTL_SRV_COPYCHUNK request. Clients making use of server-side copy
1808 support, such as Windows Server 2012, should experience considerable
1809 performance improvements for file copy operations, as file data need not
1810 traverse the network.
1811 This feature is enabled by default on the smbd file server.
1814 Btrfs Filesystem Integration
1815 ============================
1817 The Btrfs VFS module provided with Samba 4.1.0 further improves the
1818 performance of server-side copy operations on shares backed by a Btrfs
1819 filesystem. It does so by allowing multiple files to share the same
1820 on-disk extents, avoiding the unnecessary duplication of source and
1821 destination file data during a server-side copy operation.
1823 This feature can be explicitly enabled on smbd shares backed by a Btrfs
1824 filesystem with the smb.conf parameter:
1825 vfs objects = btrfs
1828 REMOVED COMPONENTS
1829 ==================
1831 The Samba Web Administration Tool (SWAT) has been removed.
1832 Details why SWAT has been removed can be found on the samba-technical mailing
1833 list:
1835 https://lists.samba.org/archive/samba-technical/2013-February/090572.html
1838 ######################################################################
1839 Changes
1840 #######
1842 smb.conf changes
1843 ----------------
1845    Parameter Name                       Description     Default
1846    --------------                       -----------     -------
1848    acl allow execute always             New             False
1849    password level                       Removed
1850    set directory                        Removed
1851    use ntdb                             New             No
1854 RUNNING Samba 4.1 as an AD DC
1855 =============================
1857 A short guide to setting up Samba as an AD DC can be found on the wiki:
1859   https://wiki.samba.org/index.php/Samba_AD_DC_HOWTO
1862 COMMIT HIGHLIGHTS
1863 =================
1865 o   Jeremy Allison <jra@samba.org>
1866     * Add SMB2 and SMB3 support for client tools and client library.
1867     * Add support for SMB3 Encrypted transport.
1870 o   David Disseldorp <ddiss@samba.org>
1871     * Add vfs_btrfs module.
1872     * Add support for server-side copy operations via the
1873       SMB2 FSCTL_SRV_COPYCHUNK request.
1876 CHANGES SINCE 4.1.0rc4
1877 ======================
1879 o   Stefan Metzmacher <metze@samba.org>
1880     * BUG 10178: Fix PAC parsing failure.
1883 o   Andreas Schneider <asn@samba.org>
1884     * BUG 10132: pam_winbindd: Support the KEYRING ccache type.
1887 CHANGES SINCE 4.1.0rc3
1888 ======================
1890 o   Michael Adam <obnox@samba.org>
1891     * BUG 10134: Add "acl allow execute always" parameter.
1894 o   Jeremy Allison <jra@samba.org>
1895     * BUG 10139: Valid utf8 filenames cause "invalid conversion error"
1896       messages.
1897     * BUG 10145: Samba SMB2 client code reads the wrong short name length in a
1898       directory listing reply.
1899     * BUG 10149: cli_smb2_get_ea_list_path() failed to close file on exit.
1900     * BUG 10150: Not all OEM servers support the ALTNAME info level.
1903 o   Andrew Bartlett <abartlet@samba.org>
1904     * BUG 8077: dsdb: Convert the full string from UTF16 to UTF8, including
1905       embedded NULLs.
1906     * BUG 9461: python-samba-tool fsmo: Do not give an error on a successful
1907       role transfer.
1908     * BUG 10157: Regression causes replication failure with Windows 2008R2 and
1909       deletes Deleted Objects.
1912 o   Günther Deschner <gd@samba.org>
1913     * BUG 10147: Better document potential implications of a globally used
1914       "valid users".
1917 o   Korobkin <korobkin+samba@gmail.com>
1918     * BUG 10118: Raise the level of a debug when unable to open a printer.
1921 o   Volker Lendecke <vl@samba.org>
1922     * BUG 10008: dbwrap_ctdb: Treat empty records as non-existing.
1923     * BUG 10138: smbd: Always clean up share modes after hard crash.
1926 o   Daniel Liberman <danielvl@gmail.com>
1927     * BUG 10162: Fix POSIX ACL mapping when setting DENY ACE's from Windows.
1930 o   Stefan Metzmacher <metze@samba.org>
1931     * BUG 10144: libcli/smb: Use SMB1 MID=0 for the initial Negprot.
1932     * BUG 10146: libcli/smb: Only check the SMB2 session setup signature if
1933       required and valid.
1936 o   Matthieu Patou <mat@matws.net>
1937     * BUG 10158: Netbios related samba process consumes 100% CPU.
1940 o   Christof Schmitt <christof.schmitt@us.ibm.com>
1941     * BUG 10137: vfs_shadow_copy2: Display previous versions correctly over
1942       SMB2.
1945 CHANGES SINCE 4.1.0rc2
1946 ======================
1948 o   Michael Adam <obnox@samba.org>
1949     * BUG 10107: Fix Winbind crashes on DC with trusted AD domains.
1952 o   Jeremy Allison <jra@samba.org>
1953     * BUG 5917: Fix working on site with Read Only Domain Controller.
1954     * BUG 9974: Add SMB2 and SMB3 support for smbclient.
1955     * BUG 10063: Fix memory leak in source3/lib/util.c:1493.
1956     * BUG 10121: Masks incorrectly applied to UNIX extension permission
1957       changes.
1960 o   Christian Ambach <ambi@samba.org>
1961     * BUG 9911: Build Samba 4.0.x on AIX with IBM XL C/C++.
1964 o   Andrew Bartlett <abartlet@samba.org>
1965     * BUG 9091: When replicating DNS for bind9_dlz we need to create the
1966       server-DNS account remotely.
1969 o   Günther Deschner <gd@samba.org>
1970     * BUG 9615: Winbind unable to retrieve user information from AD.
1971     * BUG 9899: winbind_lookup_names() fails because of
1972       NT_STATUS_CANT_ACCESS_DOMAIN_INFO.
1973     * BUG 10107: Fix Winbind crashes on DC with trusted AD domains.
1976 o   Volker Lendecke <vl@samba.org>
1977     * BUG 10086: smbd: Fix async echo handler forking.
1978     * BUG 10106: Honour output buffer length set by the client for SMB2 GetInfo
1979       requests.
1980     * BUG 10114: Handle Dropbox (write-only-directory) case correctly
1981       in pathname lookup.
1984 o   Stefan Metzmacher <metze@samba.org>
1985     * BUG 10030: ::1 added to nameserver on join.
1988 o   Rusty Russell <rusty@rustcorp.com.au>
1989     * BUG 10000: Add man pages for ntdb tools.
1992 o   Karolin Seeger <kseeger@samba.org>
1993     * BUG 7364: Add man page for vfs_syncops.
1994     * BUG 7490: Add man page for vfs_linux_xfs_sgid.
1995     * BUG 10001: Add man page for samba-regedit tool.
1996     * BUG 10076: Fix variable list in vfs_crossrename man page.
1999 o   Andreas Schneider <asn@samba.org>
2000     * BUG 10073: Fix segmentation fault in 'net ads join'.
2001     * BUG 10082: s3-winbind: Fix a segfault passing NULL to a fstring argument.
2004 o   Richard Sharpe <realrichardsharpe@gmail.com>
2005     * BUG 10097: MacOSX 10.9 will not follow path-based DFS referrals handed
2006       out by Samba.
2009 o   Ralph Wuerthner <ralph.wuerthner@de.ibm.com>
2010     * BUG 10106: Honour output buffer length set by the client for SMB2 GetInfo
2011       requests.
2014 CHANGES SINCE 4.1.0rc1
2015 ======================
2017 o   Jeremy Allison <jra@samba.org>
2018     * BUG 9992: Windows error 0x800700FE when copying files with xattr names
2019       containing ":".
2020     * BUG 10010: Missing integer wrap protection in EA list reading can cause
2021       server to loop with DOS (CVE-2013-4124).
2022     * BUG 10064: Linux kernel oplock breaks can miss signals.
2025 o   Andrew Bartlett <abartlet@samba.org>
2026     * BUG 9029: Fix replication with --domain-crictical-only to fill in
2027       backlinks.
2028     * BUG 9820: Fix crash of winbind after "ls -l
2029       /usr/local/samba/var/locks/sysvol".
2030     * BUG 10056: dsdb improvements.
2033 o   Björn Baumbach <bb@sernet.de>
2034     * BUG 10003: Fix segfault while reading incomplete session info.
2037 o   Gregor Beck <gbeck@sernet.de>
2038     * BUG 9678: Windows 8 Roaming profiles fail.
2041 o   Günther Deschner <gd@samba.org>
2042     * BUG 10043: Allow to change the default location for Kerberos credential
2043       caches.
2046 o   Volker Lendecke <vl@samba.org>
2047     * BUG 10013: Fix a 100% loop at shutdown time (smbd).
2050 o   Stefan Metzmacher <metze@samba.org>
2051     * BUG 9820: Fix crash of winbind after "ls -l
2052       /usr/local/samba/var/locks/sysvol".
2053     * BUG 10015: Fix/improve debug options.
2054     * BUG 10042: Fix crashes in socket_get_local_addr().
2055     * BUG 10056: dsdb improvements.
2058 o   Andreas Schneider <asn@samba.org>
2059     * BUG 9994: Do not delete an existing valid credential cache (s3-winbind).
2060     * BUG 10040: Rename regedit to samba-regedit.
2061     * BUG 10041: Remove obsolete swat manpage and references.
2062     * BUG 10048: nsswitch: Add OPT_KRB5CCNAME to avoid an error message.
2065 o   Alexander Werth <alexander.werth@de.ibm.com>
2066     * BUG 10045: Remove a redundant inlined substitution of ACLs.
2069 o   Ralph Wuerthner <ralphw@de.ibm.com>
2070     * BUG 10064: Linux kernel oplock breaks can miss signals.
2073 #######################################
2074 Reporting bugs & Development Discussion
2075 #######################################
2077 Please discuss this release on the samba-technical mailing list or by
2078 joining the #samba-technical IRC channel on irc.freenode.net.
2080 If you do report problems then please try to send high quality
2081 feedback. If you don't provide vital information to help us track down
2082 the problem then you will probably be ignored.  All bug reports should
2083 be filed under the Samba 4.1 product in the project's Bugzilla
2084 database (https://bugzilla.samba.org/).
2087 ======================================================================
2088 == Our Code, Our Bugs, Our Responsibility.
2089 == The Samba Team
2090 ======================================================================