cintch

a command tool to tag, check and retag files and folders for integrity checking
by Howard Oakley of https://electiclight.co

Installation:
————

All users are recommend to use the Installer package provided. This is now notarized for Mojave and later, and may be required.

cintch uses the Swift standard frameworks. These are installed at a system level in later versions of Mojave (10.14.4 and later) and in Catalina (10.15) and later. Those using earlier versions of Mojave (10.14.3 and before), Sierra or High Sierra may need to download and install Swift Runtime Support for Command Tools from https://support.apple.com/kb/DL1998

Use:
————

cintch -t|r|c path|file [buffersize]

where
	t adds hash tags to all files.
	r checks whether a valid tag is present; if not, it adds one. If the current tag doesn't match the hash of the file, it replaces that tag with a valid one.
	c checks hash tags on all files

path is the path to an accessible directory; when supplied, cintch will try to apply the action to all files within that directory.

file is the path to an accessible file; when supplied, cintch will try to apply the action to that file only.

buffersize is an optional positive integer in the range 1 - 1048576 which specifies the size of the buffer to be used when computing hashes. This is given in KB, with a default of 512 KB.

Full details of the hashing and tagging are given in the Help book provided with Dintch and Fintch, which perform the same operations with a GUI.

cintch -h to show usage information.

On error, stdout should return an error message prefaced with the word Error, and stderr should return -1.

This should work under macOS El Capitan, Sierra, High Sierra, Mojave and Catalina, on both HFS+ and APFS.

Howard Oakley

Version History:
———————————

Version 2, 31 August 2020
- Universal binary

Version 1.0, 25 May 2020
- initial release

https://electiclight.co
