afpfs-ng-mac/README.md

2.9 KiB
Raw Permalink Blame History

afpfs-ng for macOS / OS X

-                                 A N N O U N C E M E N T                                

- dgsga ported netatalk to compile and run on macOS!

- While afpfs-ng is in fact immature and incomplete, netatalk has been developed and
- refined over many years making it a solid software.

- So everyone who came here looking for a solution to network his Classic Mac or emulator
- (running up to Mac OS 9.2) with modern macOS, Id like to encourage using his solution.

- Find his repository and the related discussion at the following links, respectively:

https://github.com/dgsga/netatalk

https://www.emaculation.com/forum/viewtopic.php?f=34&t=11123

Description

macOS / OS X ships with the ability to mount volumes via AFP. However, OS X 10.6 and newer are not capable of AFP version 2.x or older which is needed to network with Classic MacOS (7.6 to 9.2 via IP).

This version of afpfs-ng is based on Simon Vetters version. It has fixes hacked in to make it work with macFUSE on macOS / OS X. As a consequence, it does not work with Fuse for Linux.

It is of use for you if you emulate Classic Mac OS, e. g. using SheepShaver or QEMU. And of course if you own an old Macintosh you want to exchange files with.

macOS / OS X already makes use of the mount_afp command. Thus in this version of afpfs-ng that command has been changed to mount_afp2 (to indicate it is for use with AFP v. 2.x).

Prerequesites

Download and install macFUSE from https://osxfuse.github.io/ (v. 4.0.5 as of writing this).

Installation

Either use the .pkg installer at https://github.com/mabam/afpfs-ng-mac/releases or compile yourself as follows:

Im not sure whether AFP up to v. 2.x offers password encryption. But I didnt succeed in compiling it in anyway, which is why I simply disabled it:

./configure --disable-gcrypt --enable-fuse
make
sudo make install

Also, I couldnt figure how to make the Fuse components compile automatically on macOS / OS X. This is how to do that manually:

cd fuse
make
sudo make install

Usage, credits and license

See https://github.com/mabam/afpfs-ng-mac/releases for a version with GUI. See https://emaculation.com/forum/viewtopic.php?f=34&p=58790#p58790 for some main issues.

If you prefer using the shell, dont forget to load macFUSE first:

/Library/Filesystems/osxfuse.fs/Contents/Resources/load_osxfuse

See README_old.md for examples on commands. But mind the change to mount_afp2.

There you can also find information on the license and credits.

Credits for this macOS / OS X version goes to adespoton for his guidance.

Information on the background and process of porting afpfs-ng to macOS / OS X can be found at http://emaculation.com/forum/viewtopic.php?f=34&p=57993#p57806 . Feel free to join the forum!