commit: 002a266ff42eafcadf86185a2d6852a2484c362e
parent: a9610d600e971a51416a1c13feffd7e2972785ca
author: Chris Noxz <chris@noxz.tech>
date: Tue, 12 Jul 2022 17:57:42 +0200
update version of acst to 0.1.3
1 file changed, 31 insertions(+), 4 deletions(-)
diff --git a/noxz.tech/software/acst/index.www b/noxz.tech/software/acst/index.www
@@ -10,8 +10,8 @@ mtime and checksum.
Download
.HnE
-.URL //noxz.tech/git/acst.git/archive/acst-0.1.2.tar.gz "acst 0.1.2"
-(27kb) (2022-07-02)
+.URL //noxz.tech/git/acst.git/archive/acst-0.1.3.tar.gz "acst 0.1.3"
+(31kb) (2022-07-12)
.HnS 1
Manual
@@ -25,7 +25,7 @@ NAME
acst - Actual C-implementation of a Simple shaTag
SYNOPSIS
- acst [-hmnqrvx] <FILE...>
+ acst [-dhmnqrvx] <FILE...>
DESCRIPTION
acst is a minimal and simplified implementation in C of, or rather,
@@ -49,11 +49,23 @@ DESCRIPTION
example, if you specify two different partitions mounted on two
different directories, they would both be traversed.
+ acst reads names of files to open from standard input if the only FILE
+ argument is '-'. To open files starting with '-', use '--' to cancel
+ parsing of arguments.
+
acst does not aim to be format-compatible with shatag and uses
different names for the extended attributes but similar formats for the
extended attributes (see the COMPATIBILITY section).
OPTIONS
+ -d Check for duplicates among files based on stored checksums from
+ acst's extended attributes. Return values when checking for
+ duplicates are normally 0 for success or 1 for fatal errors (in
+ other words, the RETURN VALUES section does not apply).
+ Certainty of the result is, of course, dependent on checksums
+ being created or corrected fairly recently as no checksums are
+ being computed during the duplicate check.
+
-h Print brief usage information to standard output and exit.
-m Summarize information at end of execution.
@@ -123,7 +135,17 @@ FILE STATUSES
xattr removed
Extended attributes were removed.
+ dup Duplicate of checksum among files checked.
+
EXAMPLES
+ find /strg/shr/media -xdev -type f | acst - > /root/acst.log
+ will use find to recursively traverse through files in
+ /mnt/memorystick within the same file system and log the result
+ to /root/acst.log. Using acst this way is many times faster than
+ using the recursive argument and can also replace all examples
+ below using the recursive argument. It should be treated as the
+ preferred method of using acst.
+
acst -r /home/user01 /mnt/memorystick > /root/acst.log
will recursively process files in both /home/user01 and
/mnt/memorystick even if they belong to different file systems,
@@ -138,6 +160,11 @@ EXAMPLES
will recursively process and remove extended attributes from
files in /mnt/memorystick and log the result to /root/acst.log.
+ acst -rd /mnt/memorystick
+ will recursively check for duplicates among files in
+ /mnt/memorystick based on checksums stored as extended
+ attributes.
+
COMPATIBILITY
acst writes to user.acst.cs and user.acst.ts instead of the
user.shatag.sha256 and user.shatag.ts specified by shatag.
@@ -171,7 +198,7 @@ AVAILABILITY
https://noxz.tech/git/acst
https://noxz.tech/software/acst
- acst-0.1.2 ACST(1)
+ acst-0.1.3 ACST(1)
.COE
.CDE
