afpfs-ng-mac/INSTALL

94 lines
2.3 KiB
Plaintext

This is a quick guide on how to install afpfs-ng.
To get running:
1. Requirements
a) Linux
- libgcrypt, libgmp for the encrypted login methods
- readline for the command line client
- libfuse (2.7.0 or later) for the FUSE client
b) FreeBSD
- libgcrypt (1.4.0 or later), libgmp for the encrypted login methods
- libfuse (2.7.0 or later) for the untested FUSE client
- iconv
You'll want to configure with:
CFLAGS="-I/usr/local/include -L/usr/local/lib" ./configure
Testing is currently very weak.
c) Mac OS X
You'll need the developer kit and need to manually compile and install libgcrypt.
Only the command line client works.
Testing is currently very weak.
2. Compile afpfs-ng
tar -xzf afpfs-ng-0.8.tar.bz2
cd afpfs-ng-0.8.
./configure
make install
3. Running the FUSE client
This will let you mount remote filesystems.
As the user who will be needing to access, the file, run the management daemon
by running:
afpfsd
This should fork off. You should see messages in /var/log/messages. For more
details, run it with the '-d' option to see detailed debug info.
To mount a filesystem:
mount_afp2 "afp://username:password@servername/volumename" <mountpoint>
After this, you should be able to access files on <mountpoint>.
You can see status by running 'afp_client status'. See afp_client(1) for more info.
4. Running the command line client
There are two modes:
a) interactive mode
afpcmd is a command line tool like an FTP client.
Just run:
afpcmd "afp://username:password@servername/volumename"
(if you enter no volumename, it shows which ones are available. If you
provide no URL, you can use 'connect'. If you provide a '-' as the
password, you will be prompted for one interactively)
Available commands are:
get <filename>: retrieves the filename
get -r <dirname>: recursively retrieves the directory and its contents
put <filename>: send the file
dir: show directory listings
Others are available too; touch, chmod, chown, del, rename, etc. See
afpcmd(1) for more.
b) batch transfer
This will let you quickly transfer one file or recursively a directory,
and then return you to the command prompt.
Eg.
> afpcmd afp://user:pass@server/alexdevries/linux-2.6.14.tar.bz2
Connected to server Cubalibre using UAM "DHX2"
Connected to volume alexdevries
Getting file /linux-2.6.14.tar.bz2
Transferred 39172170 bytes in 2.862 seconds. (13687 kB/s)