fuzzer.c: enabled ring buffer tests for decompress_fast

Ring buffer tests were performed only with LZ4_decompress_safe_continue,
leaving my buggy changes to LZ4_decompress_safe_continue undetected.
The tests are now replicated and performed in a similar manner for both
LZ4_decompress_safe_continue and LZ4_decompress_safe_continue (except
for the small buffer case where only one function can be tested,
because part of the dictionary is overwritten with the output).

I also updated function names in the messages (changed them to the
actual ones).  The error was reported for LZ4_decompress_safe(),
which I found misleading.

lz4.c: fixed the LZ4_decompress_safe_continue case

The previous change broke decoding with a ring buffer.  That's because
I didn't realize that the "double dictionary mode" was possible, i.e.
that the decoding routine can look both at the first part of the
dictionary passed as prefix and the second part passed via dictStart+dictSize.

So this change introduces the LZ4_decompress_safe_doubleDict helper,
which handles this "double dictionary" situation.  (This is a bit of
a misnomer, there is only one dictionary, but I can't think of a better
name, and perhaps the designation is not all too bad.)  The helper is
used only once, in LZ4_decompress_safe_continue, it should be inlined
with LZ4_FORCE_O2_GCC_PPC64LE attached to LZ4_decompress_safe_continue.

(Also, in the helper functions, I change the dictStart parameter type
to "const void*", to avoid a cast when calling helpers.  In the helpers,
the upcast to "BYTE*" is still required, for compatibility with C++.)

So this fixes the case of LZ4_decompress_safe_continue, and I'm
surprised by the fact that the fuzzer is now happy and does not detect
a similar problem with LZ4_decompress_fast_continue.  So before fixing
LZ4_decompress_fast_continue, the next logical step is to enhance
the fuzzer.

lz4.c: refactor the decoding routines

I noticed that LZ4_decompress_generic is sometimes instantiated with
identical set of parameters, or (what's worse) with a subtly different
sets of parameters.  For example, LZ4_decompress_fast_withPrefix64k is
instantiated as follows:

    return LZ4_decompress_generic(source, dest, 0, originalSize, endOnOutputSize,
full, 0, withPrefix64k, (BYTE*)dest - 64 KB, NULL, 64 KB);

while the equivalent withPrefix64k call in LZ4_decompress_usingDict_generic
passes 0 for the last argument instead of 64 KB.  It turns out that there
is no difference in this case: if you change 64 KB to 0 KB in
LZ4_decompress_fast_withPrefix64k, you get the same binary code.

Moreover, because it's been clarified that LZ4_decompress_fast doesn't
check match offsets, it is now obvious that both of these fast/withPrefix64k
instantiations are simply redundant.  Exactly because LZ4_decompress_fast
doesn't check offsets, it serves well with any prefixed dictionary.

There's a difference, though, with LZ4_decompress_safe_withPrefix64k.
It also passes 64 KB as the last argument, and if you change that to 0,
as in LZ4_decompress_usingDict_generic, you get a completely different
binary code.  It seems that passing 0 enables offset checking:

    const int checkOffset = ((safeDecode) && (dictSize < (int)(64 KB)));

However, the resulting code seems to run a bit faster.  How come
enabling extra checks can make the code run faster?  Curiouser and
curiouser!  This needs extra study.  Currently I take the view that
the dictSize should be set to non-zero when nothing else will do,
i.e. when passing the external dictionary via dictStart.  Otherwise,
lowPrefix betrays just enough information about the dictionary.

    * * *

Anyway, with this change, I instantiate all the necessary cases as
functions with distinctive names, which also take fewer arguments and
are therefore less error-prone.  I also make the functions non-inline.
(The compiler won't inline the functions because they are used more than
once.  Hence I attach LZ4_FORCE_O2_GCC_PPC64LE to the instances while
removing from the callers.)  The number of instances is now is reduced
from 18 (safe+fast+partial+4*continue+4*prefix+4*dict+2*prefix64+forceExtDict)
down to 7 (safe+fast+partial+2*prefix+2*dict).  The size of the code is
not the only issue here.  Separate helper function are much more
amenable to profile-guided optimization: it is enough to profile only
a few basic functions, while the other less-often used functions, such
as LZ4_decompress_*_continue, will benefit automatically.

This is the list of LZ4_decompress* functions in liblz4.so, sorted by size.
Exported functions are marked with a capital T.

$ nm -S lib/liblz4.so |grep -wi T |grep LZ4_decompress |sort -k2
0000000000016260 0000000000000005 T LZ4_decompress_fast_withPrefix64k
0000000000016dc0 0000000000000025 T LZ4_decompress_fast_usingDict
0000000000016d80 0000000000000040 T LZ4_decompress_safe_usingDict
0000000000016d10 000000000000006b T LZ4_decompress_fast_continue
0000000000016c70 000000000000009f T LZ4_decompress_safe_continue
00000000000156c0 000000000000059c T LZ4_decompress_fast
0000000000014a90 00000000000005fa T LZ4_decompress_safe
0000000000015c60 00000000000005fa T LZ4_decompress_safe_withPrefix64k
0000000000002280 00000000000005fa t LZ4_decompress_safe_withSmallPrefix
0000000000015090 000000000000062f T LZ4_decompress_safe_partial
0000000000002880 00000000000008ea t LZ4_decompress_fast_extDict
0000000000016270 0000000000000993 t LZ4_decompress_safe_forceExtDict

Merge pull request #503 from lz4/l120

minor length reduction of several large lines

Merge pull request #502 from lhacc1/dev

Wrap likely/unlikely macroses with #ifndef

modified indentation for consistency

minor length reduction of several large lines

Merge pull request #497 from lz4/lowAddr

Compatibility with low memory addresses

Wrap likely/unlikely macroses with #ifndef

It prevent redefine error when project using lz4 has its own likely/unlikely
macroses.

fixed LZ4_compress_fast_extState_fastReset() in 32-bit mode

fix dictDelta setting error

wrong test

fix matchIndex overflow

can happen with dictCtx

Merge branch 'dev' into lowAddr

Merge pull request #501 from felixhandte/fix-dict-load-offset

Always Bump Offset by 64 KB in LZ4_loadDict()

Always Bump Offset by 64 KB in LZ4_loadDict()

This actually ensures the guarantee referred to in the comment in
LZ4_compress_fast_continue().

fixed dictCtx compression

edited a few traces for debugging

fixed minor format warnings

fixed fuzzer tests

which were modified in parallel within branc `dev`

Merge branch 'dev' into lowAddr

fixed gcc performance regression

Merge pull request #499 from felixhandte/lz4-attach-dict-tests

Test LZ4_attach_dictionary() and Friends

Further Test that ExtDictCtx Mode Produces the Exact Same Output

Add Tests for LZ4_attach_dictionary and Friends

fixed minor unused variable warning

added comment on variables required after _next_match

fixed potential ptrdiff_t overflow (32-bits mode)

Also removed pointer comparison, which should solve #485

compatibility with gcc-4.4 string.h version

Someone found it would be a great idea to define there a global variable under the very generic name "index".
Cause problem with shadow warnings, so no variable can be named "index" now ...

Also : automatically update API manual

added sudo rights for low-mem-address tests

fixed : counting matches which overlap extDict and prefix

modified a few traces for debug

Merge pull request #496 from lz4/circleci

Reduced LZ4 test time on circle-ci

modified versionsTest

to use MOREFLAGS rather CPPFLAGS
as some older versions of LZ4 overwrite CPPFLAGS environment variable.

fixed LZ4_compress_fast_extState_fastReset()

Merge branch 'dev' into lowAddr

allow system-defined CPPFLAGS in /tests

reduced test time on circle-ci

Merge pull request #492 from felixhandte/avoid-prepare-in-continue

Several Changes Concerning Table Preparation in LZ4 Fast

Fix Silly Warning (const-ness in declaration has no effect on value types!)

Minor Fixes

Add a LZ4_STATIC_LINKING_ONLY Macro to Guard Experimental APIs

Expose dictCtx Functionality in LZ4

Rename _extState_noReset -> _extState_fastReset and Edit Comments

Remove Extraneous Assignment (clearedTable == 0)

Expose a Faster Stream Reset Function

fix minor conversion warning

cast from void not implicit for C++

fixed minor conversion warning

ptr diff -> U32

Merge branch 'dev' into lowAddr

Avoid Calling LZ4_prepareTable() in LZ4_compress_fast_continue()

Merge pull request #494 from felixhandte/kill-goto

Return to Allowing Early Returns in LZ4_compress_generic()

Return to Allowing Early Returns in LZ4_compress_generic()

Or: `goto` Considered Harmful

Or: https://xkcd.com/292/

Merge pull request #493 from lz4/statusLine

fixed DISPLAYUPDATE()

fixed DISPLAYUPDATE()

wrong comparison, which was always overflowing (hence was always true)
except when it was not (i386, reported by pmc)
in which case it would never show any information.

noticed a bug when re-using hash table

./fuzzer -vv -s4217 -t7518

added low-memory address test to travis

requires modification linux configuration (sudo)

fixed byPtr mode

switch to byU32 when src address is < 64K

note : byPtr is still useful in 32-bits, as it's about ~10% faster

fixed byPtr match search

fixed immediate match search

changed LZ4_compress_generic() logic

to use indexes (U32) instead of Ptr.

byPtr is still present.

fixed lz4 compression starting at small address

when using byU32 and byU16 modes

Merge branch 'dev' into lowAddr

Merge pull request #490 from kenjichanhkg/dev

added vs2017 projects

added vs2017 projects

Merge pull request #486 from felixhandte/fix-test-makefile-clean-up

Add Dependency to Fix Parallel `make test` Runs

Merge pull request #487 from felixhandte/better-obsoletion-comment

Better Describe Functionality of Obsolete Streaming Functions

Also Fix a Comment

Better Describe Functionality of Obsolete Streaming Functions

Add Dependency to Fix Parallel `make test` Runs

When run with `-jN`, the `rm tmp*` can run in the middle of the `test-lz4-dict`
job, which will then fail, finding its files to have been axed. This adds a
dependency between the two.

added c90 test to c_standards

to catch `//` comments

added low address fuzzer tests

fix comment style

bench: introduced hidden command -S

to benchmark multiple files with separate results

Merge branch 'dev' of github.com:Cyan4973/lz4 into dev

minor man fix on clevels

Merge pull request #484 from lz4/fasterDict

Faster dictionary compression

Merge pull request #406 from felixhandte/ref-dict-table

Use the Dictionary Hash Table in Place

Remove Framebench Tool

Move LZ4_compress_fast_extState_noReset Declaration to Unstable Section

Restore the Other Old Streaming Functions in a Degraded Fashion

Switch ALLOC() to ALLOC_AND_ZERO() to Paper Over Existing Uninitialized Read

Split lz4CtxLevel into Two Fields

Another Allocation Fail Check

Restore LZ4_sizeofStreamState, We Didn't Actually Need to Delete It

Restore checkTag Cleaning

Rename Enums and Add Comment

Whitespace Fixes

Add NULL Checks

Simpler Ternary Statements

Renames and Comment Fixes

Hoist LZ4F Dictionary Setup into Helper LZ4F_applyCDict()

Minor Style Fixes

Preserve currentOffset==0 When Possible

Specialize _extState() for Clean Ctx Rather Than Calling _safeExtState()

Remove Switch In Favor of Ternary Statement

Further Avoid a dictionary==NULL Check

Optimize Dict Check Condition

Move to 4KB Cut-Off

Reset Table on Inputs Larger than 2KB

Avoid DictSmall Checks By Strategically Bumping CurrentOffset

Restore DictIssue Check