                   User-Visible afs-admin-tools Changes

afs-admin-tools 3.1 (2026-07-09)

    volcreate: Fix a bug where vos create was invoked with positional
    arguments, causing the final argument (max quota) to be interpreted
    as the volume name.  All vos and fs sub-commands are now invoked
    using named options (-server, -partition, -id, -name, -maxquota,
    etc.).

    volcreate: When an external command (vos, fs, loadmtpt) fails, the
    error message now includes the captured stderr from that command.

    volcreate: -h/--help now prints a short usage summary.  The full
    manual is now printed by a new -m/--manual option (this is what
    -h used to do).

    volcreate: Add a new -s/--servers option to override the $SERVERS
    configuration variable from the command line, useful when operating
    on a non-default cell whose servers file lives at a different path.

    volcreate: When --cell is given, $VOLCREATE_MOUNT_PREFIX is now
    derived automatically as "/afs/.<cell>/", replacing any value set
    by the configuration file.

    volnuke: Add a new -V/--verbose option that emits progress messages
    as the tool examines the volume, queries each replica, removes each
    site, and cleans up.

    volnuke: Fix a bug where per-site information for replicated
    volumes was silently collapsed to only the last site's values.
    Per-site access warnings and the unreleased flag now correctly
    reflect all replica sites.

    volnuke: If Ctrl-C is pressed between "vos remove" calls during the
    destructive phase, a warning is now printed naming the volume that
    may be partially removed, along with a suggested state-check
    command, instead of exiting silently.

    volcreate and volnuke: Add a new -C/--cell option, threaded through
    every "vos" command via -cell.  Overrides both the built-in default
    and any $CELL set in the configuration file.

    volcreate and volnuke: Add a new --config option to load an
    alternate configuration file, overriding the default
    /etc/afs-admin-tools/config path.

    volcreate and volnuke: Fix a bug where $FS and $VOS assignments in
    /etc/afs-admin-tools/config were silently ignored due to lexical
    scoping.

    volcreate and volnuke: Add a new $CELL configuration variable,
    defaulting to ir.stanford.edu.

afs-admin-tools 3.0 (2026-03-02)

    volcreate-logs: Large refactoring.  The mail option has been
    removed.  The configuration file format has changed from Perl to
    YAML.

afs-admin-tools 2.1 (unreleased)

    Add a new -A option to mvto, which uses -localauth for all vos
    commands so that there's no risk of tokens expiring.  This requires
    running mvto as root on a system with access to the AFS KeyFile.
    Based on work by Niklas Edmundsson.

    The Debian package now depends on either openafs-client or
    auristorfs-client, adding support for AuriStor filesystem clients.

afs-admin-tools 2.0 (2013-01-15)

    Initial tarball release, based on frak 1.34, fsr 1.14, lsmounts 1.8,
    mvto 1.17, partinfo 1.3, volcreate 1.26, volcreate-logs 1.22, and
    volnuke 1.15.

    All utilities now load /etc/afs-admin-tools/config if it exists and
    honor configuration variables set there.  All utilities now document
    their supported configuration variables.

    Look for AFS utilities on the user's PATH by default, except for vos
    where /usr/local/sbin and /usr/sbin are checked first (since those
    directories may not be on the PATH).

    volcreate no longer requires mount points begin with the
    Stanford-specific path prefix.  Instead, a new configuration variable,
    $VOLCREATE_MOUNT_PREFIX, can be set in the configuration file to
    require mount point paths begin with that prefix.  If the prefix
    requires read/write paths and the read-only path is given, it will be
    converted automatically rather than failing.

    volcreate no longer runs loadmtpt by default.  To enable loadmtpt
    support, set $LOADMTPT in the configuration file to the path to the
    loadmtpt utility.  Checking of the mount point prefix is only done if
    loadmtpt support is enabled, since otherwise it doesn't matter how the
    mount point path is designated.

    Remove support for Kerberos v4 authentication in volcreate-logs.  This
    only applies to the -k option, not to use of pre-existing credentials.
