Apple Filing Protocol: Difference between revisions

From Wikipedia, the free encyclopedia
Jump to navigation Jump to search
VisualWikitext
imported>Manmatteo
Marked for deprecation
 
imported>VulcanSphere
Rescuing 7 sources and tagging 0 as dead.) #IABot (v2.0.9.5
 
Line 2: Line 2:
{{distinguish|text=[[Apple File System]] (APFS), a file system for macOS, iOS, tvOS and watchOS, currently being developed and deployed by Apple Inc}}
{{distinguish|text=[[Apple File System]] (APFS), a file system for macOS, iOS, tvOS and watchOS, currently being developed and deployed by Apple Inc}}
{{Infobox networking protocol|title=Apple Filing Protocol|developer=Apple, Inc.|purpose=File services|is stack=no|ports=548}}
{{Infobox networking protocol|title=Apple Filing Protocol|developer=Apple, Inc.|purpose=File services|is stack=no|ports=548}}
The '''Apple Filing Protocol''' ('''AFP'''), formerly '''AppleTalk Filing Protocol''', is a [[proprietary protocol|proprietary]] [[Communications protocol|network protocol]], and part of the '''Apple File Service''' ('''AFS'''), that offers file services for [[macOS]], [[classic Mac OS]], and [[Apple II]] computers.  In [[OS X Mountain Lion|OS X 10.8 Mountain Lion]] and earlier, AFP was the primary protocol for file services. Starting with [[OS X Mavericks|OS X 10.9 Mavericks]], [[Server Message Block]] (SMB) was made the primary file sharing protocol, with the ability to run an AFP server removed later in [[macOS Big Sur|macOS 11 Big Sur]]<ref>{{Cite web|last=Fleishman|first=Glenn|date=2020-12-18|title=AFP is no longer supported in macOS Big Sur. Here's the fix|url=https://www.macworld.com/article/3600899/using-afp-to-share-a-mac-drive-its-time-to-change.html|access-date=2021-01-09|website=Macworld|language=en}}</ref> and the client being marked for deprecation in the 15.5 update of [[macOS Sequoia|MacOS Sequoia]].<ref>{{Cite web |title=What's new for enterprise in macOS Sequoia |url=https://support.apple.com/en-us/121011 |access-date=2025-05-16 |website=Apple Support |language=en}}</ref> AFP supports [[Unicode]] file names, [[POSIX]] and [[access-control list]] permissions, [[resource fork]]s, named extended attributes, and advanced [[file locking]].
The '''Apple Filing Protocol''' ('''AFP'''), formerly '''AppleTalk Filing Protocol''', is a [[proprietary protocol|proprietary]] [[Communications protocol|network protocol]], and part of the '''Apple File Service''' ('''AFS'''), that offers file services for [[macOS]], [[classic Mac OS]], and [[Apple II]] computers.  In [[OS X Mountain Lion|OS X 10.8 Mountain Lion]] and earlier, AFP was the primary protocol for file services. Starting with [[OS X Mavericks|OS X 10.9 Mavericks]], [[Server Message Block]] (SMB) was made the primary file sharing protocol, with the ability to run an AFP server removed later in [[macOS Big Sur|macOS 11 Big Sur]]<ref>{{Cite web|last=Fleishman|first=Glenn|date=2020-12-18|title=AFP is no longer supported in macOS Big Sur. Here's the fix|url=https://www.macworld.com/article/3600899/using-afp-to-share-a-mac-drive-its-time-to-change.html|access-date=2021-01-09|website=Macworld|language=en}}</ref> and the client being marked for deprecation in the 15.5 update of [[macOS Sequoia]].<ref>{{Cite web |title=What's new for enterprise in macOS Sequoia |url=https://support.apple.com/en-us/121011 |access-date=2025-05-16 |website=Apple Support |language=en}}</ref> AFP supports [[Unicode]] file names, [[POSIX]] and [[access-control list]] permissions, [[resource fork]]s, named extended attributes, and advanced [[file locking]]. [[macOS Tahoe]] will be the last version of macOS to support AFP, with support being dropped in macOS 27.


==Compatibility==
==Compatibility==
Line 14: Line 14:


==History==
==History==
Early implementations of AFP server software were available in Mac OS starting with System 6, in AppleShare and AppleShare IP, and in early "1.x" releases of Mac OS X Server. In client operating systems, AFP was called "Personal File Sharing", and supported up to ten simultaneous connections.<ref name="classiclimits">{{cite web|url=http://support.apple.com/kb/TA21611|title=AppleShare & AppleShare IP File Sharing: Chart of All Limitations|access-date=2012-06-10}}</ref> These AFP implementations relied on version 1.x or 2.x of the protocol. AppleShare IP 5.x, 6.x, and the "1.x" releases of Mac OS X Server introduced AFP version 2.2. This was the first version to offer transport connections using TCP/IP as well as AppleTalk. It also increased the maximum share point size from four [[gigabyte]]s to two [[terabyte]]s,<ref name="classiclimits"/> although the maximum file size that could be stored remained at two gigabytes due to limitations in the original Mac OS.<ref>{{cite web|url=http://support.apple.com/kb/TA21924|title=Mac OS 8, 9: Mac OS Extended Format - Volume and File Limits|access-date=2012-06-10}}</ref>
Early implementations of AFP server software were available in Mac OS starting with System 6, in AppleShare and AppleShare IP, and in early "1.x" releases of Mac OS X Server. In client operating systems, AFP was called "Personal File Sharing", and supported up to ten simultaneous connections.<ref name="classiclimits">{{cite web|url=http://support.apple.com/kb/TA21611|title=AppleShare & AppleShare IP File Sharing: Chart of All Limitations|access-date=2012-06-10|archive-date=2014-02-27|archive-url=https://web.archive.org/web/20140227004457/http://support.apple.com/kb/TA21611|url-status=live}}</ref> These AFP implementations relied on version 1.x or 2.x of the protocol. AppleShare IP 5.x, 6.x, and the "1.x" releases of Mac OS X Server introduced AFP version 2.2. This was the first version to offer transport connections using TCP/IP as well as AppleTalk. It also increased the maximum share point size from four [[gigabyte]]s to two [[terabyte]]s,<ref name="classiclimits"/> although the maximum file size that could be stored remained at two gigabytes due to limitations in the original Mac OS.<ref>{{cite web|url=http://support.apple.com/kb/TA21924|title=Mac OS 8, 9: Mac OS Extended Format - Volume and File Limits|access-date=2012-06-10|archive-date=2014-10-31|archive-url=https://web.archive.org/web/20141031231256/http://support.apple.com/kb/TA21924|url-status=live}}</ref>


Changes made in AFP since version 3.0 represent major advances in the protocol, introducing features designed specifically for Mac OS X clients.  
Changes made in AFP since version 3.0 represent major advances in the protocol, introducing features designed specifically for Mac OS X clients.  
Line 20: Line 20:
However, like the AppleShare client in original Mac OS, the AFP client in Mac OS X continues to support [[type code|type]] and [[creator code]]s, along with [[filename extension]]s.
However, like the AppleShare client in original Mac OS, the AFP client in Mac OS X continues to support [[type code|type]] and [[creator code]]s, along with [[filename extension]]s.


AFP 3.0 was introduced in [[Mac OS X Server]] 10.0.3, and was used through Mac OS X Server 10.1.5. It was the first version to use the UNIX-style POSIX permissions model and Unicode [[UTF-8]] file name encodings. Version 3.0 supported a maximum share point and file size of two terabytes, the maximum file size and volume size for Mac OS X until version 10.2.<ref name="hfspluslimits">{{cite web|url=http://support.apple.com/kb/HT2422|title=Mac OS X: Mac OS Extended Format - Volume and File Limits|access-date=2012-06-10}}</ref> (Note that the maximum file size changed from version 2.2, described above.) Before AFP 3.0, 31 bytes was the maximum length of a filename sent over AFP.
AFP 3.0 was introduced in [[Mac OS X Server]] 10.0.3, and was used through Mac OS X Server 10.1.5. It was the first version to use the UNIX-style POSIX permissions model and Unicode [[UTF-8]] file name encodings. Version 3.0 supported a maximum share point and file size of two terabytes, the maximum file size and volume size for Mac OS X until version 10.2.<ref name="hfspluslimits">{{cite web|url=http://support.apple.com/kb/HT2422|title=Mac OS X: Mac OS Extended Format - Volume and File Limits|access-date=2012-06-10|archive-date=2010-07-30|archive-url=https://web.archive.org/web/20100730000158/http://support.apple.com/kb/ht2422|url-status=live}}</ref> (Note that the maximum file size changed from version 2.2, described above.) Before AFP 3.0, 31 bytes was the maximum length of a filename sent over AFP.


AFP 3.1 was introduced in Mac OS X Server version 10.2. Notable changes included support for Kerberos authentication, automatic client reconnect, NFS resharing, and secure AFP connections via [[Secure Shell]] (SSH). The maximum share point and file size increased to 8 [[terabytes]] with Mac OS X Server 10.2,<ref name="hfspluslimits"/><ref>{{cite web|url=http://support.apple.com/kb/TA21110|title=Mac OS X Server 10.2: Tested and theoretical maximums (limits)|access-date=2012-06-10}}</ref> and then to 16 terabytes with Mac OS X Server 10.3.<ref name="hfspluslimits"/><ref>{{cite web|url=http://support.apple.com/kb/TA21342|title=Mac OS X Server 10.3: Tested and theoretical maximums (limits)|access-date=2012-06-10}}</ref>
AFP 3.1 was introduced in Mac OS X Server version 10.2. Notable changes included support for Kerberos authentication, automatic client reconnect, NFS resharing, and secure AFP connections via [[Secure Shell]] (SSH). The maximum share point and file size increased to 8 [[terabytes]] with Mac OS X Server 10.2,<ref name="hfspluslimits"/><ref>{{cite web|url=http://support.apple.com/kb/TA21110|title=Mac OS X Server 10.2: Tested and theoretical maximums (limits)|access-date=2012-06-10|archive-date=2010-08-26|archive-url=https://web.archive.org/web/20100826065631/http://support.apple.com/kb/TA21110|url-status=live}}</ref> and then to 16 terabytes with Mac OS X Server 10.3.<ref name="hfspluslimits"/><ref>{{cite web|url=http://support.apple.com/kb/TA21342|title=Mac OS X Server 10.3: Tested and theoretical maximums (limits)|access-date=2012-06-10|archive-date=2009-06-15|archive-url=https://web.archive.org/web/20090615090831/http://support.apple.com/kb/TA21342|url-status=live}}</ref>


AFP 3.2 adds support for Access Control Lists and [[extended attributes]] in Mac OS X Server 10.4. Maximum share point size is at least 16 terabytes, although Apple has not published a limits document for Mac OS X Server 10.4. Apple implemented AFP 3.2 support in their [[AirPort Time Capsule]] wireless router device.
AFP 3.2 adds support for Access Control Lists and [[extended attributes]] in Mac OS X Server 10.4. Maximum share point size is at least 16 terabytes, although Apple has not published a limits document for Mac OS X Server 10.4. Apple implemented AFP 3.2 support in their [[AirPort Time Capsule]] wireless router device.
Line 32: Line 32:
AFP 3.4, introduced in [[OS X Mountain Lion]], includes a minor change in the mapping of POSIX errors to AFP errors.
AFP 3.4, introduced in [[OS X Mountain Lion]], includes a minor change in the mapping of POSIX errors to AFP errors.


See Apple's Developer documentation on AFP Version Differences.<ref>{{cite web|url=https://developer.apple.com/library/mac/#documentation/Networking/Conceptual/AFP/AFPVersionDifferences/AFPVersionDifferences.html|title=Apple's Developer documentation on AFP Version Differences|access-date=2011-09-15}}</ref>
See Apple's Developer documentation on AFP Version Differences.<ref>{{cite web|url=https://developer.apple.com/library/mac/#documentation/Networking/Conceptual/AFP/AFPVersionDifferences/AFPVersionDifferences.html|title=Apple's Developer documentation on AFP Version Differences|access-date=2011-09-15|archive-date=2012-06-09|archive-url=https://web.archive.org/web/20120609170929/http://developer.apple.com/library/mac/#documentation/Networking/Conceptual/AFP/AFPVersionDifferences/AFPVersionDifferences.html|url-status=live}}</ref>
 
[[macOS Tahoe]] will be the last version of macOS to support AFP, with support being dropped in macOS 27. Time Machine backups using [[AirPort Time Capsule]] routers will no longer function.<ref>{{Cite web |date=2025-06-10 |title=Warning: Apple Says macOS 27 Won't Support AirPort Time Capsule Backups |url=https://www.macrumors.com/2025/06/10/macos-27-wont-support-airport-time-capsule/ |access-date=2025-06-22 |website=MacRumors |language=en}}</ref>


==The macOS client==
==The macOS client==
Line 54: Line 56:
*[http://www.xinet.com/ Xinet] from North Plains Systems offers an AFP platform that can run on most Unix based platforms.  One of their products, ka-share, has been a main stay on [[Solaris (operating system)|Solaris]] [[SPARC]] and [[Silicon Graphics]] [[IRIX]] platforms.
*[http://www.xinet.com/ Xinet] from North Plains Systems offers an AFP platform that can run on most Unix based platforms.  One of their products, ka-share, has been a main stay on [[Solaris (operating system)|Solaris]] [[SPARC]] and [[Silicon Graphics]] [[IRIX]] platforms.
*Columbia AppleTalk Package (CAP) is a historical open source implementation of AFP and AppleTalk from [[Columbia University]] that was last updated in 1996.<ref>{{cite web | url=https://github.com/mabam/CAP/blob/master/README | title=Mabam/CAP | website=[[GitHub]] }}</ref>
*Columbia AppleTalk Package (CAP) is a historical open source implementation of AFP and AppleTalk from [[Columbia University]] that was last updated in 1996.<ref>{{cite web | url=https://github.com/mabam/CAP/blob/master/README | title=Mabam/CAP | website=[[GitHub]] }}</ref>
*supported by [[GVfs]] through gfvs-afp-volume-monitor<ref>{{cite web |url=https://wiki.gnome.org/Projects/gvfs/backends |title=Back-ends for GVfs}}</ref>
*supported by [[GVfs]] through gfvs-afp-volume-monitor<ref>{{cite web |url=https://wiki.gnome.org/Projects/gvfs/backends |title=Back-ends for GVfs |access-date=2016-03-04 |archive-date=2020-11-11 |archive-url=https://web.archive.org/web/20201111164107/https://wiki.gnome.org/Projects/gvfs/backends |url-status=live }}</ref>


==See also==
==See also==

Latest revision as of 09:08, 25 June 2025

Template:Short description Script error: No such module "Distinguish". Template:Infobox networking protocol The Apple Filing Protocol (AFP), formerly AppleTalk Filing Protocol, is a proprietary network protocol, and part of the Apple File Service (AFS), that offers file services for macOS, classic Mac OS, and Apple II computers. In OS X 10.8 Mountain Lion and earlier, AFP was the primary protocol for file services. Starting with OS X 10.9 Mavericks, Server Message Block (SMB) was made the primary file sharing protocol, with the ability to run an AFP server removed later in macOS 11 Big Sur[1] and the client being marked for deprecation in the 15.5 update of macOS Sequoia.[2] AFP supports Unicode file names, POSIX and access-control list permissions, resource forks, named extended attributes, and advanced file locking. macOS Tahoe will be the last version of macOS to support AFP, with support being dropped in macOS 27.

Compatibility

AFP versions 3.0 and greater rely exclusively on TCP/IP (port 548) for establishing communication, supporting AppleTalk only as a service discovery protocol. The AFP 2.x family supports both TCP/IP (using Data Stream Interface) and AppleTalk for communication and service discovery. Many third-party AFP implementations use AFP 2.x, thereby supporting AppleTalk as a connection method. Still earlier versions rely exclusively on AppleTalk. For this reason, some older literature refers to AFP as "AppleTalk Filing Protocol". Other literature may refer to AFP as "AppleShare", the name of the Mac OS 9 (and earlier) AFP client.

Notable current compatibility topics are:

  1. Mac OS X v10.4 and later eliminates support for AFP servers that rely solely on AppleTalk for communication.
  2. Computers using classic Mac OS can connect to AFP 3.x servers, with some limitations. For example, the maximum file size in Mac OS 8 is 2 gigabytes. Typically, Mac OS 9.1 or later is recommended for connecting to AFP 3.x servers; for versions of original Mac OS prior to 9.1, installation of the AppleShare client 3.8.8 is required.
  3. AFP 3.0 and later is required for network home directories, since Mac OS X requires POSIX permissions on user home directories. Single sign-on using Kerberos requires AFP 3.1.
  4. APFS: AFP is incompatible with sharing of APFS volumes but is still usable as a Time Machine destination in High Sierra.

History

Early implementations of AFP server software were available in Mac OS starting with System 6, in AppleShare and AppleShare IP, and in early "1.x" releases of Mac OS X Server. In client operating systems, AFP was called "Personal File Sharing", and supported up to ten simultaneous connections.[3] These AFP implementations relied on version 1.x or 2.x of the protocol. AppleShare IP 5.x, 6.x, and the "1.x" releases of Mac OS X Server introduced AFP version 2.2. This was the first version to offer transport connections using TCP/IP as well as AppleTalk. It also increased the maximum share point size from four gigabytes to two terabytes,[3] although the maximum file size that could be stored remained at two gigabytes due to limitations in the original Mac OS.[4]

Changes made in AFP since version 3.0 represent major advances in the protocol, introducing features designed specifically for Mac OS X clients.

However, like the AppleShare client in original Mac OS, the AFP client in Mac OS X continues to support type and creator codes, along with filename extensions.

AFP 3.0 was introduced in Mac OS X Server 10.0.3, and was used through Mac OS X Server 10.1.5. It was the first version to use the UNIX-style POSIX permissions model and Unicode UTF-8 file name encodings. Version 3.0 supported a maximum share point and file size of two terabytes, the maximum file size and volume size for Mac OS X until version 10.2.[5] (Note that the maximum file size changed from version 2.2, described above.) Before AFP 3.0, 31 bytes was the maximum length of a filename sent over AFP.

AFP 3.1 was introduced in Mac OS X Server version 10.2. Notable changes included support for Kerberos authentication, automatic client reconnect, NFS resharing, and secure AFP connections via Secure Shell (SSH). The maximum share point and file size increased to 8 terabytes with Mac OS X Server 10.2,[5][6] and then to 16 terabytes with Mac OS X Server 10.3.[5][7]

AFP 3.2 adds support for Access Control Lists and extended attributes in Mac OS X Server 10.4. Maximum share point size is at least 16 terabytes, although Apple has not published a limits document for Mac OS X Server 10.4. Apple implemented AFP 3.2 support in their AirPort Time Capsule wireless router device.

AFP 3.2+ was introduced in Mac OS X Leopard and adds case sensitivity support and improves support for Time Machine (synchronization, lock stealing, and sleep notifications).

AFP 3.3 mandates support for Replay Cache functionality (required for Time Machine).

AFP 3.4, introduced in OS X Mountain Lion, includes a minor change in the mapping of POSIX errors to AFP errors.

See Apple's Developer documentation on AFP Version Differences.[8]

macOS Tahoe will be the last version of macOS to support AFP, with support being dropped in macOS 27. Time Machine backups using AirPort Time Capsule routers will no longer function.[9]

The macOS client

In Mac OS X Tiger, users can connect to AFP servers by browsing for them in the Network globe or entering an AFP Uniform Resource Locator (URL) into the Connect to Server dialog. In Mac OS X Leopard and later releases, AFP shares are displayed in the Finder sidebar. AFP URLs take the form: afp://Template:Angbr/Template:Angbr, where Template:Angbr is the server's IP address, Domain Name System (DNS) name, or Bonjour name, and Template:Angbr is the name of the share point. In Snow Leopard and later, a URL of the form afp://Template:Angbr/Template:Angbr/Template:Angbr can be used to mount a subdirectory underneath a share point.

macOS also offers Personal File Sharing, a "light" implementation of the current version of AFP. In Mac OS X 10.4, users can share the contents of their Public folders by checking Personal File Sharing in the Sharing section of System Preferences.

AFP URLs for AppleTalk servers took the form: afp://at/Template:Angbr:Template:Angbr. For networks without AppleTalk zones, an asterisk (*) would be substituted for the zone name.

Third-party implementations

Third party server implementations of AFP are available from a number of companies.

See also

References

Template:Reflist

External links

Template:File systems

  1. ↑ Script error: No such module "citation/CS1".
  2. ↑ Script error: No such module "citation/CS1".
  3. ↑ a b Script error: No such module "citation/CS1".
  4. ↑ Script error: No such module "citation/CS1".
  5. ↑ a b c Script error: No such module "citation/CS1".
  6. ↑ Script error: No such module "citation/CS1".
  7. ↑ Script error: No such module "citation/CS1".
  8. ↑ Script error: No such module "citation/CS1".
  9. ↑ Script error: No such module "citation/CS1".
  10. ↑ Script error: No such module "citation/CS1".
  11. ↑ Script error: No such module "citation/CS1".
Retrieved from "http://debianws.lexgopc.com/wiki143/index.php?title=Apple_Filing_Protocol&oldid=1707812"