Skip to content

Commit

Permalink
Forget this every time smh
Browse files Browse the repository at this point in the history
  • Loading branch information
PsychedelicShayna committed Sep 19, 2024
1 parent 5e6a153 commit 1e0d945
Showing 1 changed file with 16 additions and 9 deletions.
25 changes: 16 additions & 9 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -69,16 +69,15 @@ Options:
This will result in a significant drop in performance due to the constant terminal output.
-c, --checksum
Output an index containing the hash of every file using the specified algorithm.
Uses the default algorithm. To specify one use --calgo.
Note: specifying --calgo makes this redundant.
Generate an index of file hashes and their associated file names, and print it.
The algorithm used by default is Xxh3, which is the recommended choice. Though
if you want to use a different algorithm, use --checksum-with (-C) instead.
-C, --checksum-with <algorithm>
Performs --checksum but with the specified hashing algorithm.
Using xxh3 is the recommended choice. Unless you have a reason to use something else,
stick with the default. SHA2 and MD5 are provided for compatibility with other tools
and existing data. If you're only using jw, you stand to gain a large increase in
performance by using xxh3.
If another argument changes the operating mode of the program, e.g. --diff, then
the algorithm specified will only be stored, and no checksum will be performed.
Stick to Xxh3 and just use -c unless you have a reason to use a different one.
[default: xxh3]
[possible values: xxh3, sha224, sha256, sha384, sha512, md5]
Expand All @@ -90,6 +89,13 @@ Options:
missing in the subsequent files, or if the subsequent files have entries not
present in the first file, that will be reported as well.
The hash length must be known for -D to parse the input files and separate
hashes from file paths. A length of 16 is assumed by default as that's how
long Xxh3 hashes are. If you used a different algorithm however, then you
must specify the algorithm before -D, e.g. `jw -C sha256 -D file1 file2`
If you stuck with defaults: `jw -c`, then you can just `jw -D file1 file2`
-d, --depth <limit>
The recursion depth limit. Setting this to 1 effectively disables recursion.
Expand All @@ -105,8 +111,9 @@ Options:
-s, --stats
Count the number of files, dirs, and other entries, and print at the end.
This will decrease performance. Unnoticeable in most cases, but the more
files you're traversing, the more it begins to add up.
This will decrease performance. This will cause a significant slowdown
and is primarily here for debugging or benchmarking. A more efficient
method to do this will be implemented in the future.
-h, --help
Print help (see a summary with '-h')
Expand Down

0 comments on commit 1e0d945

Please sign in to comment.