fix documentation of --compare
[metastore.git] / metastore.1
blobfc72b1efd9aa63ba7147914a17ca97681255b6d7
1 .TH metastore "1" "May 2007"
2 .\"
3 .SH NAME
4 metastore \- stores and restores filesystem metadata
5 .\"
6 .SH SYNOPSIS
7 \fBmetastore\fR \fIACTION\fR [\fIOPTION...\fR] [\fIPATH...\fR]
8 .\"
9 .SH DESCRIPTION
10 Stores or restores metadata (owner, group, permissions, xattrs and optionally
11 mtime) for a filesystem tree. This can be used to preserve the metadata in
12 situations where it is usually not stored (git and tar for example) or as
13 a tripwire like mechanism to detect any changes to metadata. Note that e.g.
14 SELinux stores its labels in xattrs so care should be taken when applying
15 stored metadata to make sure that system security is not compromised.
16 .\"
17 .SH ACTIONS
18 .TP
19 .B -c, --compare
20 Shows the difference between the stored and real metadata.
21 .TP
22 .B -s, --save
23 Saves the current metadata to ./.metadata.
24 .TP
25 .B -a, --apply
26 Attempts to apply the stored metadata to the file system.
27 .TP
28 .B -h, --help
29 Prints a help message and exits.
30 .\"
31 .SH OPTIONS
32 .TP
33 .B -v, --verbose
34 Causes metastore to print more verbose messages. Can be repeated more than
35 once for even more verbosity.
36 .TP
37 .B -q, --quiet
38 Causes metastore to print less verbose messages. Can be repeated more than
39 once for even less verbosity.
40 .TP
41 .B -m, --mtime
42 Causes metastore to also take mtime into account for the compare or apply actions.
43 .\"
44 .SH PATHS
45 If no path is specified, metastore will use the current directory as the basis
46 for the actions. This is the recommended way of executing metastore.
47 Alternatively, one or more paths can be specified and they will each be
48 examined. Later invocations should be made using the exact same paths to
49 ensure that the stored metadata is interpreted correctly.
50 .\"
51 .SH AUTHOR
52 Written by David Härdeman <david@hardeman.nu>