DBD(1)

Name
dbd — CNID database maintenance utility

Synopsis
dbd [-cfFistuv] [volumepath]

dbd [-V]

Description
dbd scans all file and directories of an AFP volume and updates the CNID database when discrepancies are found between the database and the filesystem. It must be run with appropriate permissions, i.e. as root.

When run with the -f parameter, it will completely wipe the existing volume table in the database and create a new one from scratch. This can be used for example to convert a volume from one CNID scheme to another.

Despite sharing a name with the dbd (Database Daemon) CNID backend module, this tool can be used with any CNID backend.

Options
-c

    convert from AppleDouble v2 to Extended Attributes filesystem metadata

-f

    delete and recreate CNID database

-F

    location of the afp.conf config file

-i

    invalidate CNID hints stored in AppleDouble files, so existing database entries are used instead of stale AD hints; combine with -f to assign fresh CNIDs to all files and directories

-s

    scan volume: treat the volume as read only and don't perform any filesystem modifications

-t

    show statistics while running

-u

    username for use with AFP volumes using user variable $u

-v

    verbose

-V

    display version info

CNID usage
The CNID backends maintains filename to ID mappings. If you change a filename outside afpd(8) (shell, samba), the CNID database will not reflect that change. Netatalk tries to recover from such inconsistencies as gracefully as possible.

For when you want to operate on a Netatalk volume outside of an AFP client without sacrificing the integrity of the CNID database, you can use the nad(1) tool which updates the CNID records while modifying files.

See also
nad(1), afpd(8), cnid_dbd(8)

Author
Contributors to the Netatalk Project (https://netatalk.io/contributors)