mirrors/go-mtree
1
0
Fork 0
mirror of https://github.com/vbatts/go-mtree.git synced 2025-04-04 05:28:44 +00:00
Code Releases Activity

README: markdown lint

Browse source 
Signed-off-by: Vincent Batts <vbatts@hashbangbash.com>
This commit is contained in:
Vincent Batts 2022-04-03 22:24:36 -04:00
parent 01744958cd
commit e1f0f056c7
Signed by: vbatts
GPG key ID: 10937E57733F1362
1 changed files with 7 additions and 12 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

19
README.md
View file

@ -12,7 +12,6 @@ provided with libarchive ([libarchive-formats(5)][libarchive-formats(5)]).
There is also an [mtree port for Linux][archiecobbs/mtree-port] though it is There is also an [mtree port for Linux][archiecobbs/mtree-port] though it is
not widely packaged for Linux distributions. not widely packaged for Linux distributions.
## Format ## Format
The format of hierarchy specification is consistent with the `# mtree v2.0` The format of hierarchy specification is consistent with the `# mtree v2.0`
@ -26,12 +25,11 @@ This implementation of mtree supports a few non-upstream "keyword"s, such as:
`xattr` and `tar_time`. If you include these keywords, the FreeBSD `mtree` `xattr` and `tar_time`. If you include these keywords, the FreeBSD `mtree`
will fail, as they are unknown keywords to that implementation. will fail, as they are unknown keywords to that implementation.
To have `go-mtree` produce specifications that will be To have `go-mtree` produce specifications that will be
strictly compatible with the BSD `mtree`, use the `-bsd-keywords` flag when strictly compatible with the BSD `mtree`, use the `-bsd-keywords` flag when
creating a manifest. This will make sure that only the keywords supported by creating a manifest. This will make sure that only the keywords supported by
BSD `mtree` are used in the program. BSD `mtree` are used in the program.
### Typical form ### Typical form
With the standard keywords, plus say `sha256digest`, the hierarchy With the standard keywords, plus say `sha256digest`, the hierarchy
@ -51,7 +49,6 @@ See the directory presently in, and the files present. Along with each
path, is provided the keywords and the unique values for each path. Any common path, is provided the keywords and the unique values for each path. Any common
keyword and values are established in the `/set` command. keyword and values are established in the `/set` command.
### Extended attributes form ### Extended attributes form
```mtree ```mtree
@ -97,23 +94,21 @@ More interestingly, this also means that we can create a manifest from an archiv
validate this manifest against a filesystem hierarchy that's on disk, and vice versa. validate this manifest against a filesystem hierarchy that's on disk, and vice versa.
Notice that for the output of creating a validation manifest from a tar file, the default behavior Notice that for the output of creating a validation manifest from a tar file, the default behavior
for evaluating a notion of time is to use the `tar_time` keyword. In the for evaluating a notion of time is to use the `tar_time` keyword. In the
"filesystem hierarchy" format of mtree, `time` is being evaluated with "filesystem hierarchy" format of mtree, `time` is being evaluated with
nanosecond precision. However, GNU tar truncates a file's modification time nanosecond precision. However, GNU tar truncates a file's modification time
to 1-second precision. That is, if a file's full modification time is to 1-second precision. That is, if a file's full modification time is
123456789.123456789, the "tar time" equivalent would be 123456789.000000000. 123456789.123456789, the "tar time" equivalent would be 123456789.000000000.
This way, if you validate a manifest created using a tar file against an This way, if you validate a manifest created using a tar file against an
actual root directory, there will be no complaints from `go-mtree` so long as the actual root directory, there will be no complaints from `go-mtree` so long as the
1-second precision time of a file in the root directory is the same. 1-second precision time of a file in the root directory is the same.
## Usage ## Usage
To use the Go programming language library, see [the docs][godoc]. To use the Go programming language library, see [the docs][godoc].
To use the command line tool, first [build it](#Building), then the following. To use the command line tool, first [build it](#Building), then the following.
### Create a manifest ### Create a manifest
This will also include the sha512 digest of the files. This will also include the sha512 digest of the files.
@ -122,7 +117,7 @@ This will also include the sha512 digest of the files.
gomtree -c -K sha512digest -p . > /tmp/root.mtree gomtree -c -K sha512digest -p . > /tmp/root.mtree
``` ```
With a tar file: With a tar file:
```bash ```bash
gomtree -c -K sha512digest -T sometarfile.tar > /tmp/tar.mtree gomtree -c -K sha512digest -T sometarfile.tar > /tmp/tar.mtree
@ -173,7 +168,6 @@ Available keywords:
sha512digest sha512digest
``` ```
## Building ## Building
Either: Either:
@ -193,18 +187,19 @@ go build ./cmd/gomtree
## Testing ## Testing
On Linux: On Linux:
```bash ```bash
cd $GOPATH/src/github.com/vbatts/go-mtree cd $GOPATH/src/github.com/vbatts/go-mtree
make make
``` ```
On FreeBSD: On FreeBSD:
```bash ```bash
cd $GOPATH/src/github.com/vbatts/go-mtree cd $GOPATH/src/github.com/vbatts/go-mtree
gmake gmake
``` ```
[mtree(8)]: https://www.freebsd.org/cgi/man.cgi?mtree(8) [mtree(8)]: https://www.freebsd.org/cgi/man.cgi?mtree(8)
[libarchive-formats(5)]: https://www.freebsd.org/cgi/man.cgi?query=libarchive-formats&sektion=5&n=1 [libarchive-formats(5)]: https://www.freebsd.org/cgi/man.cgi?query=libarchive-formats&sektion=5&n=1
[archiecobbs/mtree-port]: https://github.com/archiecobbs/mtree-port [archiecobbs/mtree-port]: https://github.com/archiecobbs/mtree-port