4 The Netatalk development team is proud to announce version 3.0.3 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.3.
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).
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
20 Summary of major new features and enhancements in 3.0
21 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
23 * New ini style configuration file afp.conf which replaces all previous
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
32 Please make sure to read the upgrading section in the Netatalk online
33 manual before trying to upgrade your system to 3.0!
35 http://netatalk.sourceforge.net/3.0/htmldocs/upgrade.html
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
44 http://www.gnu.org/licenses/old-licenses/gpl-2.0.txt
48 * UPD: afpd: Increase default DSI server quantum to 1 MB
49 * UPD: bundled libevent2 is now static
50 * NEW: --with-lockfile=PATH configure option for specifying an
51 alternative path for the netatalk lockfile.
52 * UPD: systemd service file use PIDFile and ExecReload.
54 * UPD: RedHat sysvinit: rm graceful, reimplement reload, add condrestart
55 * FIX: Couldn't create folders on FreeBSD 9.1 ZFS fileystems.
57 * FIX: Fix an issue with user homes when user home directory has not the
58 same name as the username.
60 * UPD: Fix PAM config install, new default installation dir is
61 $sysconfdir/pam.d/. Add configure option --with-pam-confdir
62 to specify alternative path.
63 * NEW: AFP stats about active session via dbus IPC. Client side python
64 program `afpstats`. Requires dbus, dbus-glib any python-dbus.
65 configure option --dbus-sysconf-dir for specifying dbus
66 system security configuration files.
67 New option 'afpstats' (default: no) which determines whether
68 to enable the feature or not.
69 * NEW: configure option --with-init-dir
70 * NEW: dtrace probes, cf include/atalk/afp_dtrace.d for available
72 * UPD: Reload groups when reloading volumes. FR #71.
73 * FIX: Attempt to read read-only ._ rfork results in disconnect.
75 * FIX: File's ressource fork can't be read if metadata EA is missing.
77 * FIX: Conversion from adouble v2 to ea for directories.
79 * FIX: Error messages when mounting read-only filesystems.
81 * FIX: Permissions of ._ AppleDouble ressource fork after conversion
84 * UPD: Use FreeBSD sendfile() capability to send protocol header.
86 * UPD: Increase IO size when sendfile() is not used.
88 * FIX: Can't set Finder label on symlinked folder with "follow symlinks = yes".
90 * FIX: Setting POSIX ACLs on Linux
92 * FIX: "ad ls" segfault if requested object is not in an AFP volume.
97 * NEW: afpd: Put file extension type/creator mapping back in which had
99 * NEW: afpd: new option 'ad domain'. From FR #66.
100 * FIX: volumes and home share with symlinks in the path
101 * FIX: Copying packages to a Netatalk share could fail, bug #469
102 * FIX: Reloading volumes from config file was broken. Fixes bug #474.
103 * FIX: Fix _device-info service type registered with dns-sd API
104 * FIX: Fix pathname bug for FCE modified event.
105 * FIX: Remove length limitation of options like "valid users".
107 * FIX: Dont copy our metadata EA in copyfile(). Fixes bug #452.
108 * FIX: Fix an error where catalog search gave incomplete results.
110 * REM: Remove TimeMachine volume used size FCE event.
111 * UPD: Add quoting support to '[in]valid users' option. Fixes bug #472.
112 * FIX: Install working PAM config on Solaris 11. Fixes bug #481.
113 * FIX: Fix a race condition between dbd and the cnid_dbd daemon
114 which could result in users being disconnected from volumes
115 when dbd was scanning their volumes. Fixes bug #477.
116 * FIX: Netatalk didn't start when the last line of the config file
117 afp.conf wasn't terminated by a newline. Fixes bug #476.
118 * NEW: Add a new volumes option 'follow symlinks'. The default setting is
119 false, symlinks are not followed on the server. This is the same
120 behaviour as OS X's AFP server.
121 Setting the option to true causes afpd to follow symlinks on the
122 server. symlinks may point outside of the AFP volume, currently
123 afpd doesn't do any checks for "wide symlinks".
124 * FIX: Automatic AppleDouble conversion to EAs failing for directories.
126 * FIX: dbd failed to convert appledouble files of symlinks.
131 * NEW: afpd: Optional "ldap uuid encoding = string | ms-guid" parameter to
132 afp.conf, allowing for usage of the binary objectGUID fields from
134 * FIX: afpd: Fix a Solaris 10 SPARC sendfilev bug
135 * FIX: afpd: Fix a crash on FreeBSD
136 * FIX: afpd: Fixes open file handle refcounting bug which was reported as
137 being unable to play movies off a Netatalk AFP share.
139 * FIX: afpd: Fix a possible data corruption when reading from and writing
140 to the server simultaniously under load
141 * FIX: Fix possible alignment violations due to bad casts
142 * FIX: dbd: Fix logging
143 * FIX: apple_dump: Extended Attributes AppleDouble support for *BSD
144 * FIX: handling of '/' and ':' in volume name
145 * UPD: Install relevant includes necessary for building programs with
146 installed headers and shared lib libatalk
147 * UPD: libevent configure args to pick up installed version. Removed
148 configure arg --disable-libevent, added configure args
149 --with-libevent-header|lib.
150 * UPD: gentoo initscript: merge from portage netatalk.init,v 1.1
151 * REM: Remove --with-smbsharemodes configure option, it was an
152 empty stub not yet implemented
157 * UPD: afpd: force read only mode if cnid scheme is last
158 * REM: afpd: removed global option "icon"
159 * FIX: CNID path for user homes
164 * UPD: Solaris and friends: Replace initscript with SMF manifest
165 * FIX: Solaris and friends: resource fork handling
170 * UPD: afpd: Performance tuning of read/write AFP operations. New option
171 "afp read locks" (default: no) which disables that the server
172 applies UNIX byte range locks to regions of files in AFP read and
174 * UPD: apple_dump: Extended Attributes AppleDouble support.
175 (*BSD is not supported yet)
177 Changes in 3.0 alpha3
178 ~~~~~~~~~~~~~~~~~~~~~
180 * NEW: afpd: Per volume "login message", NetAFP bug ID #18
181 * NEW: afpd: Cross-platform locking (share modes) on Solaris and derivates
182 with Solaris CIFS/SMB server. Uses new Solaris fcntl F_SHARE share
183 reservation locking primitives. Enabled by default, set global
184 "solaris share reservations" option to false to disable it.
185 * NEW: ad: ad set subcommand for changing Mac metadata on the server
186 * UPD: unix charset is UTF8 by default
187 vol charset is same value as unix charset by default
188 * UPD: .AppleDesktop/ are stored in $localstatedir/netatalk/CNID
189 (default: /var/netatalk/CNID), databases found in AFP volumes are
191 * FIX: afpd: Server info packet was malformed resulting in broken
192 server names being displayed on clients
193 * FIX: afpd: Byte order detection. Fixes an error where Netatalk on
194 OpenIndiana returned wrong volume size information.
196 Changes in 3.0 alpha2
197 ~~~~~~~~~~~~~~~~~~~~~
199 * UPD: afpd: Store '.' as is and '/' as ':' on the server, don't
200 CAP hexencode as "2e" and "2f" respectively
201 * UPD: afdp: Automatic name conversion, renaming files and directories
202 containing CAP sequences to their not enscaped forms
203 * UPD: afpd: Correct handling of user homes and users without homes
204 * UPD: afpd: Perform complete automatic adouble:v2 to adouble:ea conversion
205 as root. Previously only unlinking the adouble:v2 file was done as root
206 * UPD: dbd: -C option removes CAP encoding
207 * UPD: Add graceful option to RedHat init script
208 * UPD: Add --disable-bundled-libevent configure options When set to yes,
209 we rely on a properly installed version on libevent CPPFLAGS and LDFLAGS
210 should be set properly to pick that up
211 * UPD: Run ldconfig on Linux at the end of make install
212 * FIX: afpd: ad cp on appledouble = ea volumes
213 * FIX: dbd: ignore ._ appledouble files
214 * REM: Volumes options "use dots" and "hex encoding"
216 Changes in 3.0 alpha1
217 ~~~~~~~~~~~~~~~~~~~~~
219 * NEW: Central configuration file afp.conf which replaces all previous files
220 * NEW: netatalk: service controller starting and restarting afpd and cnid_metad
222 * NEW: afpd: Extended Attributes AppleDouble backend (default)
223 * UPD: CNID databases are stored in $localstatedir/netatalk/CNID
224 (default: /var/netatalk/CNID), databases found in AFP volumes are
226 * UPD: Start scripts and service manifests have been changed to only start
227 the new netatalk service controller process
228 * UPD: afpd: UNIX privileges and use dots enabled by default
229 * UPD: afpd: Support for arbitrary AFP volumes using variable expansion has been
231 * UPD: afpd: afp_voluuid.conf and afp_signature.conf location has been
232 changed to $localstatedir/netatalk/ (default: /var/netatalk/)
233 * UPD: afpd: default server messages dir changed to $localstatedir/netatalk/msg/
234 * UPD: dbd: new option -C for conversion from AppleDouble v2 to ea
235 * REM: AppleTalk support has been removed
236 * REM: afpd: SLP and AFP proxy support have been removed
237 * REM: afpd: legacy file extension to type/creator mapping has been removed
238 * REM: afpd: AppleDouble backends v1, osx and sfm have been removed
244 As of Netatalk 3.0 the following operating systems are supported:
250 * Solaris and derivates
252 Netatalk may compile and run on other operating systems as well, but
253 it is not well-tested on those. We welcome patches and suggestions
254 for enhancing the portability of Netatalk as well as success and failure
255 stories. Please write to netatalk-devel@lists.sourceforge.net.
260 Netatalk tar-balls can be found at:
262 http://sourceforge.net/project/showfiles.php?group_id=8642
264 Netatalk is also available via anonymous git. See the SourceForge project
265 site for anonymous git instructions.
270 For more information about Netatalk, see its web page at:
272 http://netatalk.sourceforge.net/
274 The project is hosted at SourceForge. The SourceForge project page is
277 http://sourceforge.net/projects/netatalk/
279 The Netatalk development team can be reached via the mailing list
280 netatalk-devel@lists.sourceforge.net. For subscription information and
281 archives see Netatalk's SourceForge project page.
283 netatalk-admins@lists.sourceforge.net is a mailing list for Netatalk
284 system administrators. For subscription information and archives see
285 the Netatalk web page.
290 We would like to thank all contributors to the Netatalk project for
291 their commitment. Without the many suggestions, bug and problem reports,
292 patches, and reviews this project wouldn't be where it is.
294 - The Netatalk Development Team, January 2013