Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

**4.12.0** #144

Merged
merged 1 commit into from
Sep 18, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions CMakeLists.txt
Original file line number Diff line number Diff line change
Expand Up @@ -56,8 +56,8 @@ cmake_minimum_required(VERSION 2.6)
project(TLSH)

set(VERSION_MAJOR 4)
set(VERSION_MINOR 11)
set(VERSION_PATCH 2)
set(VERSION_MINOR 12)
set(VERSION_PATCH 0)

# TLSH uses only half the counting buckets.
# It can use all the buckets now.
Expand Down
8 changes: 8 additions & 0 deletions Change_History.md
Original file line number Diff line number Diff line change
Expand Up @@ -731,3 +731,11 @@ TIME ms= 21.00 per million iterations
resolve issue #116
Library will not compile on CENTOS 7 (use of threads)
</PRE>

**4.12.0**
<PRE>
16/09/2024
document what has changed since **4.11.2** on 23/10/2021
Merge pull request #137 - this fixed a memory leak in py-tlsh
Merge pull request #134 - this improved the ifdef WINDOWS to be more portable
</PRE>
35 changes: 14 additions & 21 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,31 +10,23 @@ the detection of similar objects by comparing their hash values. Note that
the byte stream should have a sufficient amount of complexity. For example,
a byte stream of identical bytes will not generate a hash value.

## What's New in TLSH 4.10.x
22/09/2021

Release version 4.8.x - merged in pull requests for more stable installation.

Release version 4.9.x - added -thread and -private options.
- Both versions are faster than previous versions, but they set the checksum to 00.
- This loses a very small part of the functionality.
- See 4.9.3 in the Change_History to see timing comparisons.
## What's (relatively) New in TLSH 4.12.0
16/09/2024

Release version 4.10.x - a Python clustering tool.
- See the directory tlshCluster.

I am going to try to make 4.12.0 a release version and build a py-tlsh Python library from 4.12.0
4.12.0 includes:
Merge pull request #137 - this fixed a memory leak in py-tlsh
Merge pull request #134 - this improved the ifdef WINDOWS to be more portable

2020
- adopted by [Virus Total](https://developers.virustotal.com/v3.0/reference#files-tlsh)
- adopted by [Malware Bazaar](https://bazaar.abuse.ch/api/#tlsh)

TLSH has gained some traction. It has been included in STIX 2.1 and been ported to a number of langauges.

We have added a version identifier ("T1") to the start of the digest so that we can
cleary distinguish between different variants of the digest (such as non-standard choices of 3 byte checksum).
This means that we do not rely on the length of the hex string to determine if a hex string is a TLSH digest
(this is a brittle method for identifying TLSH digests).
We are doing this to enable compatibility, especially backwards compatibility of the TLSH approach.

We have added a version identifier ("T1") to the start of the digest.
Please use versions of TLSH that have the T1 header
The code is backwards compatible, it can still read and interpret 70 hex character strings as TLSH digests.
And data sets can include mixes of the old and new digests.
If you need old style TLSH digests to be outputted, then use the command line option '-old'
Expand Down Expand Up @@ -299,11 +291,12 @@ TLSH similarity is expressed as a difference score:

# Current Version

**4.11.2**
**4.12.0**
<PRE>
23/10/2021
resolve issue #116
Library will not compile on CENTOS 7 (use of threads)
16/09/2024
document what has changed since **4.11.2** on 23/10/2021
Merge pull request #137 - this fixed a memory leak in py-tlsh
Merge pull request #134 - this improved the ifdef WINDOWS to be more portable
</PRE>

# Change History
Expand Down
4 changes: 2 additions & 2 deletions include/tlsh_win_version.h
Original file line number Diff line number Diff line change
Expand Up @@ -6,8 +6,8 @@
****************************************************/

#define VERSION_MAJOR 4
#define VERSION_MINOR 11
#define VERSION_PATCH 2
#define VERSION_MINOR 12
#define VERSION_PATCH 0
#define TLSH_HASH "compact hash"
#define TLSH_CHECKSUM "1 byte checksum"

Expand Down