A **rolling hash** (also known as recursive hashing or rolling checksum) is a hash function where the input is hashed in a window that moves through the input.

A few hash functions allow a rolling hash to be computed very quickly—the new hash value is rapidly calculated given only the old hash value, the old value removed from the window, and the new value added to the window—similar to the way a moving average function can be computed much more quickly than other low-pass filters.

One of the main applications is the Rabin-Karp string search algorithm, which uses the rolling hash described below.

Another popular application is rsync program which uses a checksum based on Mark Adler's adler-32 as its rolling hash.

Another application is the Low Bandwidth Network Filesystem (LBFS), which uses a Rabin fingerprint as its rolling hash.

At best, rolling hash values are pairwise independent or strongly universal. They cannot be 3-wise independent, for example.

The Rabin-Karp string search algorithm is normally used with a very simple rolling hash function that only uses multiplications and additions:

H
=
c
1
a
k
−
1
+
c
2
a
k
−
2
+
c
3
a
k
−
3
+
.
.
.
+
c
k
a
0
where
a
is a constant and
c
1
,
.
.
.
,
c
k
are the input characters.

In order to avoid manipulating huge
H
values, all math is done modulo
n
. The choice of
a
and
n
is critical to get good hashing; see linear congruential generator for more discussion.

Removing and adding characters simply involves adding or subtracting the first or last term. Shifting all characters by one position to the left requires multiplying the entire sum
H
by
a
. Shifting all characters by one position to the right requires dividing the entire sum
H
by
a
. Note that in modulo arithmetic,
a
can be chosen to have a multiplicative inverse
a
−
1
by which
H
can be multiplied to get the result of the division without actually performing a division.

One of the interesting use cases of the rolling hash function is that it can create dynamic, content-based chunks of a stream or file. This is especially useful when it is required to send only the changed chunks of a large file over a network and a simple byte addition at the front of the file would cause all the fixed size windows to become updated, while in reality, only the first ‘chunk’ has been modified.

The simplest approach to calculate the dynamic chunks is to calculate the rolling hash and if it matches a pattern (like the lower N bits are all zeroes) then it’s a chunk boundary. This approach will ensure that any change in the file will only affect its current and possibly the next chunk, but nothing else.

When the boundaries are known, the chunks need to be compared by their hash values to detect which one was modified and needs transfer across the network.

Hashing by cyclic polynomial—sometimes called Buzhash—is also simple, but it has the benefit of avoiding multiplications, using barrel shifts instead. It is a form of tabulation hashing: it presumes that there is some hash function
h
from characters to integers in the interval
[
0
,
2
L
)
. This hash function might be simply an array or a hash table mapping characters to random integers. Let the function
s
be a cyclic binary rotation (or barrel shift): it rotates the bits by 1 to the left, pushing the latest bit in the first position. E.g.,
s
(
10011
)
=
00111
. Let
⊕
be the bit-wise exclusive or. The hash values are defined as

H
=
s
k
−
1
(
h
(
c
1
)
)
⊕
s
k
−
2
(
h
(
c
2
)
)
⊕
…
⊕
s
(
h
(
c
k
−
1
)
)
⊕
h
(
c
k
)

where the multiplications by powers of two can be implemented by binary shifts. The result is a number in
[
0
,
2
L
)
.

Computing the hash values in a rolling fashion is done as follows. Let
H
be the previous hash value. Rotate
H
once:
H
←
s
(
H
)
. If
c
1
is the character to be removed, rotate it
k
times:
s
k
(
h
(
c
1
)
)
. Then simply set

H
←
s
(
H
)
⊕
s
k
(
h
(
c
1
)
)
⊕
h
(
c
k
+
1
)

where
c
k
+
1
is the new character.

Hashing by cyclic polynomials is strongly universal or pairwise independent: simply keep the first
L
−
k
+
1
bits. That is, take the result
H
and dismiss any
k
−
1
consecutive bits. In practice, this can be achieved by an integer division
H
→
H
÷
2
k
−
1
.

Several programs including gzip (with the `--rsyncable`

option) and rsyncrypto do content-based slicing based on an this specific (unweighted) moving sum:

S
(
n
)
=
∑
i
=
n
−
8195
n
c
i

H
(
n
)
=
S
(
n
)
mod
4096

where

S
(
n
)
is the sum of 8196 consecutive bytes ending with byte
n
(requires 21 bits of storage)
c
i
is byte
i
of the file
H
(
n
)
is a "hash value" consisting of the bottom 12 bits of
S
(
n
)
Shifting the window by one byte simply involves adding the new character to the sum and subtracting the oldest character (no longer in the window) from the sum.

For every
n
where
H
(
n
)
==
0
, these programs cut the file between
n
and
n
+
1
. This approach will ensure that any change in the file will only affect its current and possibly the next chunk, but no other chunk.

All rolling hash functions are linear in the number of characters, but their complexity with respect to the length of the window (
k
) varies. Rabin-Karp rolling hash requires the multiplications of two
k
-bit numbers, integer multiplication is in
O
(
k
log
k
2
O
(
log
∗
k
)
)
. Hashing ngrams by cyclic polynomials can be done in linear time.

rollinghashcpp is a Free software C++ implementation of several rolling hash functions
rollinghashjava is an Apache licensed Java implementation of rolling hash functions