EnglishFrenchSpanish

OnWorks favicon

tthsum - Online in the Cloud

Run tthsum in OnWorks free hosting provider over Ubuntu Online, Fedora Online, Windows online emulator or MAC OS online emulator

This is the command tthsum that can be run in the OnWorks free hosting provider using one of our multiple free online workstations such as Ubuntu Online, Fedora Online, Windows online emulator or MAC OS online emulator

PROGRAM:

NAME


tthsum ‐ generates or checks TTH message digests

SYNOPSIS


tthsum [-bhmpvVw] [-c [file]] | [file...]

DESCRIPTION


tthsum generates or checks TTH checksums (roots of the Tiger/THEX hash tree). The Merkle
Hash Tree, invented by Ralph Merkle, is a hash construct that exhibits desirable
properties for verifying the integrity of files and file subranges in an incremental or
out‐of‐order fashion. tthsum uses the Tiger hash algorithm, by Ross Anderson and Eli
Biham, for both the internal and the leaf nodes.

The specification of the THEX algorithm is at:
. http://tthsum.devs.nu/draft-jchapweske-thex-02.html

The specification of the Tiger hash algorithm is at:
. http://www.cs.technion.ac.il/~biham/Reports/Tiger/

Normally tthsum generates checksums of all files given to it as parameters and prints the
checksums followed by the filenames. If, however, -c is specified, only one filename
parameter is allowed. This file should contain checksums and filenames to which these
checksums refer, and the files listed in that file are checked against the checksums
listed there. See option -c for more information.

If no file is specified data will be read from standard input.

OPTIONS
-b An md5sum compatibility option. It does absolutely nothing. (md5sum uses -b to
treat binary files differently from texts files.)

-c Check tthsum of all files listed in file against the checksum listed in the same
file. The actual format of that file is the same as output of tthsum. That is,
each line in the file describes a file. A line looks like:

<TTH CHECKSUM> <FILENAME>

So, for example, if a file were created and its message digest calculated like so:

echo foo > tth-test-file; tthsum tth-test-file

tthsum would report:

A2MPPCGS5CPJV6AOAP37ICDCFV3WYU7PBREC6FY tth-test-file

See NOTES for more information on the digest file format.

-m Use mmap(2) instead of read(2) to read the contents of the files to hash. Normally,
using read is cheaper. This all depends on system load, I/O speed, CPU speed, L1
and/or L2 cache size and whatnot.

-p Show the progress. Print the percentage of completeness while hashing on standard
error. Prints file position instead of percentage when the file size is unknown.

-v Be verbose. Print filenames when checking (with -c).

-w Warn on improperly formatted lines when checking (with -c).

-h, -V Print a small help text or the version, respectively, on standard out. If an
unknown combination of options is encountered, the small help is printed on
standard error and tthsum will return non‐zero.

RETURN VALUE


tthsum returns 0 if no error occurred or, when checking a digest, if at least one line is
formatted properly and the TTHs of all properly formatted lines match. tthsum returns 2
if an unknown combination of options is encountered. In all other cases will tthsum
return 1.

NOTES


tthsum intentionally uses an interface identical to md5sum.

tthsum uses BASE32 encoding consisting of the following characters:
ABCDEFGHIJKLMNOPQRSTUVWXYZ234567. It will accept lower case letters in the digest input
as well.

tthsum does not accept long options such as --help.

A digest file format line looks like: <BASE32><SPACES><FILENAME><EOL>. BASE32 is a 39
character long BASE32 encoded string. SPACES is a set of two spaces (0x20). FILENAME is
the name of the file, encoded in UTF8 and with all control characters (those below 0x20)
encoded as \xNN or \C C‐style escapes. (The backslash is escaped as \\ as well. On
Windows, backslashes in paths will be translated to slashes for compatibility with real
operating systems.) EOL may be CRLF (\r\n), just plain LF (\n) or even nothing at end‐of‐
file.

If you see warnings about an improper locale setup, check your LANG and/or LC_CTYPE
environment variables. If these are not set properly, tthsum cannot represent non‐ASCII
characters (those above 0x7F) in UTF8. See locale(1) for more information or try to set
LC_CTYPE to e.g. "en_US".

REPORTING BUGS


Report bugs to <walter+[email protected]>.

COPYRIGHT


Copyright © 2009 Walter Doekes. License GPLv3+: GNU GPL version 3 or later
<http://gnu.org/licenses/gpl.html>
This is free software: you are free to change and redistribute it. There is NO WARRANTY,
to the extent permitted by law.

Use tthsum online using onworks.net services


Free Servers & Workstations

Download Windows & Linux apps

  • 1
    Image Downloader
    Image Downloader
    Crawl and download images using
    Selenium Using python3 and PyQt5.
    Supported Search Engine: Google, Bing,
    Baidu. Keywords input from the keyboard
    or input from ...
    Download Image Downloader
  • 2
    Eclipse Tomcat Plugin
    Eclipse Tomcat Plugin
    The Eclipse Tomcat Plugin provides
    simple integration of a tomcat servlet
    container for the development of java
    web applications. You can join us for
    discussio...
    Download Eclipse Tomcat Plugin
  • 3
    WebTorrent Desktop
    WebTorrent Desktop
    WebTorrent Desktop is for streaming
    torrents on Mac, Windows or Linux. It
    connects to both BitTorrent and
    WebTorrent peers. Now there's no
    need to wait for...
    Download WebTorrent Desktop
  • 4
    GenX
    GenX
    GenX is a scientific program to refine
    x-ray refelcetivity, neutron
    reflectivity and surface x-ray
    diffraction data using the differential
    evolution algorithm....
    Download GenX
  • 5
    pspp4windows
    pspp4windows
    PSPP is a program for statistical
    analysis of sampled data. It is a free
    replacement for the proprietary program
    SPSS. PSPP has both text-based and
    graphical us...
    Download pspp4windows
  • 6
    Git Extensions
    Git Extensions
    Git Extensions is a standalone UI tool
    for managing Git repositories. It also
    integrates with Windows Explorer and
    Microsoft Visual Studio
    (2015/2017/2019). Th...
    Download Git Extensions
  • More »

Linux commands

Ad