afpcmd(1)

📦 version 0.8.2, in alpine 3.24, arch rolling, epel 9, fedora 43, fedora 44

okay bestie, welcome to the afpcmd(1) manual page 💖 it's the file-transfer tool from afpfs-ng, and we're about to get into all of it ✨

✨ NAME ✨

afpcmd - transfer files over the networking using the Apple Filing Protocol (AFP) 🦋

🎀 SYNOPSIS 🎀

afpcmd [-r [afp url]

💅 DESCRIPTION 💅

okay so afpcmd is a command-line tool that helps you move files to and from a server using AFP 📂 the server is usually Netatalk or Mac OS or Mac OS X, so you know it's giving legit Apple energy 🍎

you can do all of this as a non-root user, which is lowkey the best part 🫶 you get either an interactive command line (basically a traditional FTP client vibe 💻) or batch retrievals.

bestie, don't mix this up with the FUSE mounting tools (mount_afp, afpfsd, afp_client) 🙈 those ones mount an entire filesystem, and afpcmd does NOT do that.

🌸 OPTIONS 🌸

  • -r — turns on the recursive flag 🔁
  • afp url — uses the standard AFP URL format 🔗

🦋 AFP version support 🦋

for the deets on which AFP versions are supported, go check the afpfs-ng documentation 📖 it has all the compatibility info you need, no cap.

🚀 Batch mode 🚀

batch file transfers can go one of two ways, and both are giving efficiency 💖

afpcmd -r [afp url to directory]

this one does a recursive transfer of all subdirectories and files locally 📁✨

afpcmd [afp url to file]

this one just transfers the one file locally 📄

after either of these finishes, the command exits. bye bye 👋

🌈 Interactive mode 🌈

if you pass a URL on the command line, afpcmd connects and drops you right into the volume and directory you specified 🧚

standard readline keystrokes are enabled 💅 you get command line completion (hit tab 🎀) and history (up and down arrows 🍓). local filename completion is enabled too, so you're literally set.

Most common commands

  • connect <afp URL> — connect to the server, then change to the volume and directory 🔌
  • cd — change directories on the server 📂
  • get <filename> — retrieve a file 📥
  • get -r <directory> — recursively retrieve the directory 🌳
  • put <filename> — upload a file 📤
  • quit — quit 👋

Conect/disconnect commands

  • disconnect — disconnect from the current server 🔌
  • passwd — prompts for a new password without showing it on screen 🙈
  • user <user> — set the user 👤
  • passwd — change the password on the server. It does not work. 💀

Remote directory commands

  • pwd — show the current directory on the server 📍
  • mkdir <directory> — create a new directory 🌷
  • rmdir <directory — remove a directory 🗑️
  • ls or dir — show the files in the current directory 👀

Remote file commands

  • mv or rename old_file new_file — rename <old file> to <new file> ✏️
  • touch <filename> — create a blank file 🫧
  • view <filename> — show the file 👁️
  • chmod: <file> <mode> — change the mode of a file on the server 🔐
  • delete of rm: <file> — remove the file from the server 💅

Status commands

  • status — show the status of the connection and details. For debugging 🛠️
  • df — show the disk size and available blocks 💾

Local commands

  • lpwd — show current local 🙈
  • lcd — change the local directory 🏡

Other commands

  • help or ? — show help 🆘
  • testafp — various tests for developers 🧪

🔗 AFP URLs 🔗

a typical usage of afpcmd looks like this, and it's so simple 🥰

afpcmd afp://username:password@servername/volume

the complete syntax of a URL is a little more extra 💜

afp://username;AUTH=authtype:password@server:port/volume/path

pro tip from the manual: if you put a password of "-", afpcmd will prompt you for the password instead 🔐✨

📬 REPORTING BUGS 📬

found a bug? slide into the afpfs-ng-devel@sf.net mailing list 💌 that's where bug reports go.

👑 SEE ALSO 👑

That's the whole page, bestie 🫶 this is afpcmd(1) from afpfs-ng, version 0.5, dated 13 Nov 2007 🌈 stay iconic, and go transfer some files 💖✨

📦 where this page comes from