doc/www/ReleaseNotes

   1 Netatalk 3.0.4
   2 ==============
   3
   4 The Netatalk development team is proud to announce version 3.0.4 of
   5 the Netatalk File Sharing suite. This is the latest update to the 3.0
   6 release series. All users are encouraged to upgrade their systems to 3.0.4.
   7
   8 Netatalk is a freely-available Open Source AFP fileserver.
   9 A *NIX/*BSD system running Netatalk is capable of serving many Macintosh
  10 clients simultaneously as an AppleShare file server (AFP).
  11
  12 The suite contains:
  13
  14 * netatalk   - the main server service controller
  15 * afpd       - the AFP file server daemin
  16 * cnid_metad - the CNID database multiplexing daemon
  17 * cnid_dbd   - the CNID database daemon serving CNIDs for AFP volumes
  18 * various supporting programs and utilities
  19
  20 Summary of major new features and enhancements in 3.0
  21 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  22
  23 * New ini style configuration file afp.conf which replaces all previous
  24   configuration files
  25 * New default AppleDouble backend using filesystem Extended Attributes,
  26   conversion from AppleDouble v2 is done automatically on access
  27 * New service controller process "netatalk" responsible for starting and
  28   restarting afpd and cnid_metad as necessary
  29 * AppleTalk support has been removed
  30 * Coherent cross-platform locking with Solaris CIFS server
  31
  32 Please make sure to read the upgrading section in the Netatalk online
  33 manual before trying to upgrade your system to 3.0!
  34
  35   http://netatalk.sourceforge.net/3.0/htmldocs/upgrade.html
  36
  37 License
  38 ~~~~~~~
  39
  40 Netatalk is a Free/Open Source Software project and is released under
  41 the GNU General Public License (GPLv2).  The full license text is available
  42 at:
  43
  44   http://www.gnu.org/licenses/old-licenses/gpl-2.0.txt
  45
  46 Changes in 3.0.4
  47 ~~~~~~~~~~~~~~~~
  48 * FIX: Opening files without metadata EA may result in an invalid
  49        metadata EA. Check for malformed metadata EAs and delete them.
  50        Fixes bug #510.
  51 * FIX: Fix an issue with filenames containing non-ASCII characters that
  52        lead to a failure setting the size of a files ressource fork.
  53        This affected application like Adobe Photoshop where saving
  54        files may fail. Fixes bug #511.
  55 * UPD: Enhance ACL mapping, change global ACL option 'map acl' to take
  56        the following options: "none", "rights" (default), "mode".
  57        none   = no mapping, this resembles the previous false/no setting
  58        rights = map ACLs to Finder UARights, this resembles the previous
  59                 true/yes setting. This is the default.
  60        mode   = map ACLs to Finder UARights and UNIX mode
  61        From FR #73.
  62 * FIX: Fix a possible crash in cname() where cname_mtouname calls
  63        dirlookup() where the curdir is freed because the dircache
  64        detected a dev/inode cache difference and evicted the object
  65        from the cache. Fixes bug #498.
  66 * FIX: Add missing include, fixes bug #512.
  67 * FIX: Change default FinderInfo for directories to be all 0, fixes
  68        bug 514.
  69 * NEW: New option "afp interfaces" which allows specifying where
  70        Netatalk listens for AFP connections by interface names.
  71        From FR #79.
  72
  73 Changes in 3.0.3
  74 ~~~~~~~~~~~~~~~~
  75 * UPD: afpd: Increase default DSI server quantum to 1 MB
  76 * UPD: bundled libevent2 is now static
  77 * NEW: --with-lockfile=PATH configure option for specifying an
  78        alternative path for the netatalk lockfile.
  79 * UPD: systemd service file use PIDFile and ExecReload.
  80        From FR #70.
  81 * UPD: RedHat sysvinit: rm graceful, reimplement reload, add condrestart
  82 * FIX: Couldn't create folders on FreeBSD 9.1 ZFS fileystems.
  83        Fixed bug #491.
  84 * FIX: Fix an issue with user homes when user home directory has not the
  85        same name as the username.
  86        Fixes bug #497.
  87 * UPD: Fix PAM config install, new default installation dir is
  88        $sysconfdir/pam.d/. Add configure option --with-pam-confdir
  89        to specify alternative path.
  90 * NEW: AFP stats about active session via dbus IPC. Client side python
  91        program `afpstats`. Requires dbus, dbus-glib any python-dbus.
  92        configure option --dbus-sysconf-dir for specifying dbus
  93        system security configuration files.
  94        New option 'afpstats' (default: no) which determines whether
  95        to enable the feature or not.
  96 * NEW: configure option --with-init-dir
  97 * NEW: dtrace probes, cf include/atalk/afp_dtrace.d for available
  98        probes.
  99 * UPD: Reload groups when reloading volumes. FR #71.
 100 * FIX: Attempt to read read-only ._ rfork results in disconnect.
 101        Fixes bug #502.
 102 * FIX: File's ressource fork can't be read if metadata EA is missing.
 103        Fixes bug #501.
 104 * FIX: Conversion from adouble v2 to ea for directories.
 105        Fixes bug #500.
 106 * FIX: Error messages when mounting read-only filesystems.
 107        Fixes bug #504.
 108 * FIX: Permissions of ._ AppleDouble ressource fork after conversion
 109        from v2 to ea.
 110        Fixes bug #505.
 111 * UPD: Use FreeBSD sendfile() capability to send protocol header.
 112        From FR #75.
 113 * UPD: Increase IO size when sendfile() is not used.
 114        From FR #76.
 115 * FIX: Can't set Finder label on symlinked folder with "follow symlinks = yes".
 116        Fixes bug #508.
 117 * FIX: Setting POSIX ACLs on Linux
 118        Fixes bug #506.
 119 * FIX: "ad ls" segfault if requested object is not in an AFP volume.
 120        Fixes bug #496.
 121
 122 Changes in 3.0.2
 123 ~~~~~~~~~~~~~~~~
 124 * NEW: afpd: Put file extension type/creator mapping back in which had
 125        been removed in 3.0.
 126 * NEW: afpd: new option 'ad domain'. From FR #66.
 127 * FIX: volumes and home share with symlinks in the path
 128 * FIX: Copying packages to a Netatalk share could fail, bug #469
 129 * FIX: Reloading volumes from config file was broken.  Fixes bug #474.
 130 * FIX: Fix _device-info service type registered with dns-sd API
 131 * FIX: Fix pathname bug for FCE modified event.
 132 * FIX: Remove length limitation of options like "valid users".
 133        Fixes bug #473.
 134 * FIX: Dont copy our metadata EA in copyfile(). Fixes bug #452.
 135 * FIX: Fix an error where catalog search gave incomplete results.
 136        Fixes bug #479.
 137 * REM: Remove TimeMachine volume used size FCE event.
 138 * UPD: Add quoting support to '[in]valid users' option. Fixes bug #472.
 139 * FIX: Install working PAM config on Solaris 11. Fixes bug #481.
 140 * FIX: Fix a race condition between dbd and the cnid_dbd daemon
 141        which could result in users being disconnected from volumes
 142        when dbd was scanning their volumes. Fixes bug #477.
 143 * FIX: Netatalk didn't start when the last line of the config file
 144        afp.conf wasn't terminated by a newline. Fixes bug #476.
 145 * NEW: Add a new volumes option 'follow symlinks'. The default setting is
 146        false, symlinks are not followed on the server. This is the same
 147        behaviour as OS X's AFP server.
 148        Setting the option to true causes afpd to follow symlinks on the
 149        server. symlinks may point outside of the AFP volume, currently
 150        afpd doesn't do any checks for "wide symlinks".
 151 * FIX: Automatic AppleDouble conversion to EAs failing for directories.
 152        Fixes bug #486.
 153 * FIX: dbd failed to convert appledouble files of symlinks.
 154        Fixes bug #490.
 155
 156 Changes in 3.0.1
 157 ~~~~~~~~~~~~~~~~
 158 * NEW: afpd: Optional "ldap uuid encoding = string | ms-guid" parameter to
 159        afp.conf, allowing for usage of the binary objectGUID fields from
 160        Active Directory.
 161 * FIX: afpd: Fix a Solaris 10 SPARC sendfilev bug
 162 * FIX: afpd: Fix a crash on FreeBSD
 163 * FIX: afpd: Fixes open file handle refcounting bug which was reported as
 164        being unable to play movies off a Netatalk AFP share.
 165        Bug ID 3559783.
 166 * FIX: afpd: Fix a possible data corruption when reading from and writing
 167        to the server simultaniously under load
 168 * FIX: Fix possible alignment violations due to bad casts
 169 * FIX: dbd: Fix logging
 170 * FIX: apple_dump: Extended Attributes AppleDouble support for *BSD
 171 * FIX: handling of '/' and ':' in volume name
 172 * UPD: Install relevant includes necessary for building programs with
 173        installed headers and shared lib libatalk
 174 * UPD: libevent configure args to pick up installed version. Removed
 175        configure arg --disable-libevent, added configure args
 176        --with-libevent-header|lib.
 177 * UPD: gentoo initscript: merge from portage netatalk.init,v 1.1
 178 * REM: Remove --with-smbsharemodes configure option, it was an
 179        empty stub not yet implemented
 180
 181 Changes in 3.0
 182 ~~~~~~~~~~~~~~
 183
 184 * UPD: afpd: force read only mode if cnid scheme is last
 185 * REM: afpd: removed global option "icon"
 186 * FIX: CNID path for user homes
 187
 188 Changes in 3.0 beta2
 189 ~~~~~~~~~~~~~~~~~~~~
 190
 191 * UPD: Solaris and friends: Replace initscript with SMF manifest
 192 * FIX: Solaris and friends: resource fork handling
 193
 194 Changes in 3.0 beta1
 195 ~~~~~~~~~~~~~~~~~~~~
 196
 197 * UPD: afpd: Performance tuning of read/write AFP operations. New option
 198        "afp read locks" (default: no) which disables that the server
 199        applies UNIX byte range locks to regions of files in AFP read and
 200        write calls.
 201 * UPD: apple_dump: Extended Attributes AppleDouble support.
 202        (*BSD is not supported yet)
 203
 204 Changes in 3.0 alpha3
 205 ~~~~~~~~~~~~~~~~~~~~~
 206
 207 * NEW: afpd: Per volume "login message", NetAFP bug ID #18
 208 * NEW: afpd: Cross-platform locking (share modes) on Solaris and derivates
 209        with Solaris CIFS/SMB server. Uses new Solaris fcntl F_SHARE share
 210        reservation locking primitives. Enabled by default, set global
 211        "solaris share reservations" option to false to disable it.
 212 * NEW: ad: ad set subcommand for changing Mac metadata on the server
 213 * UPD: unix charset is UTF8 by default
 214        vol charset is same value as unix charset by default
 215 * UPD: .AppleDesktop/ are stored in $localstatedir/netatalk/CNID
 216        (default: /var/netatalk/CNID), databases found in AFP volumes are
 217        automatically moved
 218 * FIX: afpd: Server info packet was malformed resulting in broken
 219        server names being displayed on clients
 220 * FIX: afpd: Byte order detection. Fixes an error where Netatalk on
 221        OpenIndiana returned wrong volume size information.
 222
 223 Changes in 3.0 alpha2
 224 ~~~~~~~~~~~~~~~~~~~~~
 225
 226 * UPD: afpd: Store '.' as is and '/' as ':' on the server, don't
 227        CAP hexencode as "2e" and "2f" respectively
 228 * UPD: afdp: Automatic name conversion, renaming files and directories
 229        containing CAP sequences to their not enscaped forms
 230 * UPD: afpd: Correct handling of user homes and users without homes
 231 * UPD: afpd: Perform complete automatic adouble:v2 to adouble:ea conversion
 232        as root. Previously only unlinking the adouble:v2 file was done as root
 233 * UPD: dbd: -C option removes CAP encoding
 234 * UPD: Add graceful option to RedHat init script
 235 * UPD: Add --disable-bundled-libevent configure options When set to yes,
 236        we rely on a properly installed version on libevent CPPFLAGS and LDFLAGS
 237        should be set properly to pick that up
 238 * UPD: Run ldconfig on Linux at the end of make install
 239 * FIX: afpd: ad cp on appledouble = ea volumes
 240 * FIX: dbd: ignore ._ appledouble files
 241 * REM: Volumes options "use dots" and "hex encoding"
 242
 243 Changes in 3.0 alpha1
 244 ~~~~~~~~~~~~~~~~~~~~~
 245
 246 * NEW: Central configuration file afp.conf which replaces all previous files
 247 * NEW: netatalk: service controller starting and restarting afpd and cnid_metad
 248        as necessary
 249 * NEW: afpd: Extended Attributes AppleDouble backend (default)
 250 * UPD: CNID databases are stored in $localstatedir/netatalk/CNID
 251        (default: /var/netatalk/CNID), databases found in AFP volumes are
 252        automatically moved
 253 * UPD: Start scripts and service manifests have been changed to only start
 254        the new netatalk service controller process
 255 * UPD: afpd: UNIX privileges and use dots enabled by default
 256 * UPD: afpd: Support for arbitrary AFP volumes using variable expansion has been
 257        removed
 258 * UPD: afpd: afp_voluuid.conf and afp_signature.conf location has been
 259        changed to $localstatedir/netatalk/ (default: /var/netatalk/)
 260 * UPD: afpd: default server messages dir changed to $localstatedir/netatalk/msg/
 261 * UPD: dbd: new option -C for conversion from AppleDouble v2 to ea
 262 * REM: AppleTalk support has been removed
 263 * REM: afpd: SLP and AFP proxy support have been removed
 264 * REM: afpd: legacy file extension to type/creator mapping has been removed
 265 * REM: afpd: AppleDouble backends v1, osx and sfm have been removed
 266
 267
 268 Supported Platforms
 269 ~~~~~~~~~~~~~~~~~~~
 270
 271 As of Netatalk 3.0 the following operating systems are supported:
 272
 273  * FreeBSD
 274  * Linux
 275  * OpenBSD
 276  * NetBSD
 277  * Solaris and derivates
 278
 279 Netatalk may compile and run on other operating systems as well, but
 280 it is not well-tested on those.  We welcome patches and suggestions
 281 for enhancing the portability of Netatalk as well as success and failure
 282 stories.  Please write to netatalk-devel@lists.sourceforge.net.
 283
 284 Availability
 285 ~~~~~~~~~~~~
 286
 287 Netatalk tar-balls can be found at:
 288
 289 http://sourceforge.net/project/showfiles.php?group_id=8642
 290
 291 Netatalk is also available via anonymous git.  See the SourceForge project
 292 site for anonymous git instructions.
 293
 294 Contact
 295 ~~~~~~~
 296
 297 For more information about Netatalk, see its web page at:
 298
 299 http://netatalk.sourceforge.net/
 300
 301 The project is hosted at SourceForge.  The SourceForge project page is
 302 located at:
 303
 304 http://sourceforge.net/projects/netatalk/
 305
 306 The Netatalk development team can be reached via the mailing list
 307 netatalk-devel@lists.sourceforge.net.  For subscription information and
 308 archives see Netatalk's SourceForge project page.
 309
 310 netatalk-admins@lists.sourceforge.net is a mailing list for Netatalk
 311 system administrators.  For subscription information and archives see
 312 the Netatalk web page.
 313
 314 Acknowledgements
 315 ~~~~~~~~~~~~~~~~
 316
 317 We would like to thank all contributors to the Netatalk project for
 318 their commitment.  Without the many suggestions, bug and problem reports,
 319 patches, and reviews this project wouldn't be where it is.
 320
 321  - The Netatalk Development Team, May 2013