# Name

afpstats — List Netatalk AFP server statistics

# Synopsis

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

**afpstats** [-v | \-\-version]

# Description

**afpstats** lists information about users connected to a Netatalk AFP server running on the local machine,
their mounted volumes, time of login, and other details.
Sessions connected over both TCP/IP (DSI) and AppleTalk (ASP) are reported.

To enable AFP statistics in Netatalk at runtime, **afpstats = yes** must be set in *afp.conf*.
By default, only root and users permitted by the socket's group ownership can query the session list.
To allow other users to query the socket, set "**afpstats group = *group***" and add those users
to the configured group.

# Options

**-h**, **\-\-hostname** *client-address*

> Filter the output by the given client hostname or address.
> TCP/IP sessions use the resolved client hostname, falling 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*.
> Defaults to */var/lib/netatalk/afpstats.sock* (path varies with the configured *localstatedir*).

**-v**, **\-\-version**

> Show 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. Use the **afpstats group** option in *afp.conf* to set the
group owner explicitly, for example to a dedicated *netatalk* group.
The socket path also depends on search permissions for the parent directory.

# 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](https://netatalk.io/contributors)
