AUFS-CLASHES(1)

NAME
aufs-clashes - Find all file path clashes between aufs branches

SYNOPSIS
aufs-clashes -h
aufs-clashes [-b branch_list] [-c branch_count[+|-]] [-a] [-d] [-s|-l] [-q] reference_branch_number [comparison_branch_number]

DESCRIPTION
The aufs-clashes script uses the find command to find file paths that exist in both of the specified numbered branches. The branch numbers can be found by running aufs-list /. If a comparison branch is not given, then the reference branch is compared to each branch below it (i.e. all numerically greater branches), or to all other branches if the -a option is given.

Here "file" can includes folders and file-like objects: symlinks, named pipes and sockets.

OUTPUT
By default, the output of aufs-clashes is in two columns, separated by tabs. You might like to expand and align the output by piping to column -t.

From left to right, the columns are: • the branch number of the comparison branch;
• the file path of the clash (in the aufs file system). If the -l (long output) option is given, the output is in three columns: • the branch number of the comparison branch;
• the file path of the clash (in the reference branch's source folder);
• the file path of the clash (in the comparison branch's source folder). In addition to the columnar output printed to standard output, some extra messages are printed to the standard error stream before each branch comparison begins. These messages can be suppressed with the -q option.

OPTIONS

-a  If no comparison branch is given, then compare files in the reference branch to all other branches, both above and below the reference branch.

-d  Consider clashes between a directory in the reference branch and a directory in the comparison branch. The default behaviour is to exclude these clashes, to avoid overly verbose output; however, if a file in the reference branch clashes with a directory in the comparison branch, this is included.

-s  Short two-column output (this is the default).

-l  Long three-column output.

-q  Quiet mode. Do not print the Checking branch N... messages to standard error.

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

NOTES

It is recommended to run aufs-clashes as root, because it looks at the entire directory tree of each branch, and it is likely that your current user will not have read access to some files.

EXAMPLES

aufs-clashes -q 3

    Find file path clashes between branch 3 and all branches below it (branch 4, 5 and so on). Give short (two-column) output, and do not print the standard error messages before each branch comparison.

aufs-clashes -q -a -d 3

    As above, but find file path clashes between branch 3 and the branches below it (branches 0, 1 and 2), and include directory-directory clashes. The usual rules apply when combining options; -qad is equivalent to -q -a -d.

aufs-clashes -l 3 4

    Find file path clashes between branches 3 and 4 only. Give long (three-column) output.

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-revert(1), aufs-unwh(1)