AFPSTATS(1)

✨ AFPSTATS(1) ✨ — Netatalk AFP Fileserver Manual 💖

Okay so this is the manual page for afpstats, the tool that spills the tea on List Netatalk AFP server statistics 💅 Think of it as your nosy bestie who knows exactly who's connected to your Netatalk AFP server right now 👀🫶

🎀 NAME 🎀

afpstats — List Netatalk AFP server statistics 🌸

🦋 SYNOPSIS 🦋

afpstats [-h client-address] [-s socket]

afpstats [-v | --version]

Two ways to call it, babe 🧚 Either ask for the list, or ask what version it is ✨

💜 DESCRIPTION 💜

Okay so afpstats lists info about users connected to a Netatalk AFP server running on the local machine 🍓 You get their mounted volumes, their time of login, and other deets 😭 Sessions connected over both TCP/IP (DSI) and AppleTalk (ASP) show up, so nobody's getting left out 🫶

Lowkey important: to turn on AFP statistics in Netatalk at runtime, you need afpstats = yes set in afp.conf 🔥 By default, only root and users permitted by the socket's group ownership can query the session list 🙈 If you want other users to get in on the gossip, set "afpstats group = group" and add those users to the configured group 💅

🌈 OPTIONS 🌈

• -h, --hostname client-address — Filter the output by the client hostname or address you give it 💖 TCP/IP sessions use the resolved client hostname, and if that's not available, they fall back to the IP address 🧚 AppleTalk sessions use the client DDP address in net.node form 🦋
• -s, --socket path — Connect to the afpstats Unix socket at path ✨ It defaults to /var/lib/netatalk/afpstats.sock (the path changes depending on the configured localstatedir) 🌸
• -v, --version — Show the version and exit 👑

🙈 NOTE 🙈

The socket is created by afpd on startup with mode 0660 🚨 By default, only root and users permitted by the socket's group ownership can query the session list 💀

Want to set the group owner explicitly? Use the afpstats group option in afp.conf, for example to a dedicated netatalk group 🫶 The socket path also depends on search permissions for the parent directory, so check those too 🔥

🍓 EXAMPLES 🍓

List connected users:

$ afpstats
Connected user  PID     Login time       State     Protocol   Client address     Mounted volumes
alice           452547  Apr 28 21:58:50  sleeping  TCP/IP     workstation.local  Data Vault, alice's Home
bob             451969  Apr 28 21:21:32  active    AppleTalk  65280.12           My AFP Volume

🧚 SEE ALSO 🧚

afpd(8), afp.conf(5) 💜

👑 AUTHOR 👑

Contributors to the Netatalk Project 🌈

---

Bestie, that's the whole tea ☕💖 This page is from Netatalk 4.5.1, and it was last updated on 2026-10-13 🦋 Stay iconic, stay connected 💅✨