doc/www/ReleaseNotes

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