AUFS-REVERT(1)

NAME
aufs-revert - Remove a file from a writeable aufs branch, reverting it to an underlying version from a lower branch

SYNOPSIS
aufs-revert -h
aufs-revert file_to_revert

DESCRIPTION
The aufs-revert script checks that the uppermost version of the file at file_to_revert is in a writeable branch of the aufs file system, and that another version of it also exists in a lower branch. If both these conditions are met, the uppermost version is deleted. The effect is to revert the file seen in the aufs file system to the version present in the lower branch. file_to_revert must be the path to a regular file (not a directory, symlink, pipe or socket).

OUTPUT
If the file is successfully reverted, aufs-revert produces no output.

OPTIONS

-h, --help
    Display a short help message and exit. (The help message is also displayed when aufs-revert is called with no arguments.)

NOTES

It is recommended to run aufs-revert as root, to ensure it has permission to find and remove the file from the writeable branch.

The file_to_revert must be in the aufs file system. Symlinks are not resolved.

EXAMPLES

aufs-revert /usr/bin/cowsay

    Removes any changes made to the file /usr/bin/cowsay in the writeable branch (if present), reverting it to the lower branch version.

REPORTING BUGS

Please report any bugs or other issues on the Codeberg repository: https://codeberg.org/lcpterid/aufs-dir-tools/

AUTHORS
lcpterid

SEE ALSO
aufs-find(1), aufs-list(1), aufs-diff(1), aufs-clashes(1), aufs-unwh(1)