rdmark / afpfs-ng

afpfs-ng/libafpclient is an open source client for the Apple Filing Protocol

Apple Filing Protocol Client Library - afpfs-ng - libafpclient

Description

AFPFS is a client implementation of the Apple Filing Protocol written in C which can be used to access AFP shares exposed by multiple devices, notably Mac OS X computers, linux devices exporting shares with netatalk, Apple Airport and Time Capsule products as well as other NAS devices from various vendors.

Installation

Pretty standard unix stuff:

If you are using a bootstrapped tarball, you can skip this step. You may need to install autoconf / automake / libtool / aclocal first.

./bootstrap

Configure, build and install the software.

./configure && make && sudo make install && echo 'done!'

Use --disable-fuse and/or --disable-gcrypt if your system cannot meet those dependancies. (note that disabling gcrypt will prevent you from using encrypted login/password auth.)

The command line tool needs ncurses-dev and libreadline-dev to compile. Install them with sudo apt-get install ncurses-dev libreadline-dev on ubuntu/debian.

Usage

You can either use afpfs to mount an AFP share with fuse or with the command-line client.

fuse

Mount the time_travel volume from delorean.local (in this example, my time capsule's hostname) on /mnt/timetravel without authentication:

$ mount_afp afp://delorean.local/time_travel /mnt/timetravel

Same, with authentication:

$ mount_afp afp://simon:[email protected]/time_travel /mnt/timetravel

Same, with authentication, forcing the UAM of your choice (usually not needed):

$ mount_afp afp://simon;AUTH=DHX2:[email protected]/time_travel /mnt/timetravel

Unmount the volume:

$ fusermount -u /mnt/timetravel

command line client

Open volume time_travel on delorean.local:

$ afpcmd afp://simon:[email protected]/time_travel

Connect anonymously to delorean.local, list all available volumes:

$ afpcmd afp://simon:[email protected]/

cd to change directories, ls to list, get file to retrieve file, put file to put file... and help for a list of supported commands.

Credits and license

This is a fork of the original afpfs-ng project that has gone unmaintained for quite some time. It is so far the only available open source AFP client.

This repository includes many patches collected by the XBMC project (www.xbmc.org) as well as mine, in a bid to improve stability, performance and to implement new features.

Check AUTHORS for a somewhat complete list of contributors.

The original afpfs-ng webiste can be found on the Wayback Machine.

This project retains the original author's license and is distributed under the GPL.

afpfs-ng's Issues

afpcmd: can't do mv commands on files with spaces

A file with a space cannot be moved with "mv". Support for some kind of space escaping mechanism is needed, such as quotation marks.

afpcmd: can't parse AUTH arguments

the internal URL parsing test fails:

afpcmd: test
Testing URL parsing
url doesn't parse
* Could not parse afp://user::name;AUTH=authtype:pa@@sword@server/volume/path
url doesn't parse
* Could not parse afp://username;AUTH=authtype:password@server/volume/path
url doesn't parse
* Could not parse afp://username;AUTH=authtype:password@server:548/volume/path
* Parsed afp://username:password@server/volume/path correctly
* Parsed afp://username@server/volume/path correctly
* Parsed afp://server/volume/path correctly
* Parsed afp://server/ correctly
* Parsed afp://server:22/ correctly
* Parsed afp://server:22 correctly
* Parsed afp://server:22/volume/ correctly

also, actually using the AUTH argument does not work

afpcmd: chmod does not have an effect

Try to change mode for a file with the "chmod" command, e.g. "chmod 700 file". No effect.

afpcmd: view leads to segfault

Connect to any server, create a new text file, use the "view" command on that text file. Segfault (Linux, macOS, FreeBSD)

afpcmd: passwd command does not take effect

The passwd command silently fails. The user password is unchanged.

afpcmd: testafp has no visible effect

The "testafp" command may be doing something silently, but there is no visual output.

Port RJVB's patches to 0.8.2

A patchset for stability and fuse functionality was contributed for the baseline 0.8.1 codebase:

https://sourceforge.net/p/afpfs-ng/patches/4/

These patches no longer apply cleanly on 0.8.2 code, so this ticket is for tracking the porting effort.

afpcmd: mv to nested subdir is buggy

If you have a dir structure like: /1/2/ with dir "2" empty

And do mv file 1/2, then the file gets renamed to "2" and the dir "2" is removed

Note that this doesn't happen when doing mv file 1/2/ with a trailing slash

afpcmd: the mv commands prepend space to filename

When moving a file with "mv" a space gets inexplicably added to the beginning of the file name. E.g. "mv 123 234" leads to the "123" file renamed to " 234"