snappy 0.0.12 → 0.0.13
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/lib/snappy/version.rb +1 -1
- data/lib/snappy/writer.rb +6 -0
- metadata +3 -41
- data/vendor/snappy/AUTHORS +0 -1
- data/vendor/snappy/COPYING +0 -54
- data/vendor/snappy/ChangeLog +0 -1916
- data/vendor/snappy/Makefile.am +0 -23
- data/vendor/snappy/NEWS +0 -128
- data/vendor/snappy/README +0 -135
- data/vendor/snappy/autogen.sh +0 -7
- data/vendor/snappy/configure.ac +0 -133
- data/vendor/snappy/format_description.txt +0 -110
- data/vendor/snappy/framing_format.txt +0 -135
- data/vendor/snappy/m4/gtest.m4 +0 -74
- data/vendor/snappy/snappy-c.cc +0 -90
- data/vendor/snappy/snappy-c.h +0 -138
- data/vendor/snappy/snappy-internal.h +0 -150
- data/vendor/snappy/snappy-sinksource.cc +0 -71
- data/vendor/snappy/snappy-sinksource.h +0 -137
- data/vendor/snappy/snappy-stubs-internal.cc +0 -42
- data/vendor/snappy/snappy-stubs-internal.h +0 -491
- data/vendor/snappy/snappy-stubs-public.h.in +0 -98
- data/vendor/snappy/snappy-test.cc +0 -606
- data/vendor/snappy/snappy-test.h +0 -582
- data/vendor/snappy/snappy.cc +0 -1306
- data/vendor/snappy/snappy.h +0 -184
- data/vendor/snappy/snappy_unittest.cc +0 -1355
- data/vendor/snappy/testdata/alice29.txt +0 -3609
- data/vendor/snappy/testdata/asyoulik.txt +0 -4122
- data/vendor/snappy/testdata/baddata1.snappy +0 -0
- data/vendor/snappy/testdata/baddata2.snappy +0 -0
- data/vendor/snappy/testdata/baddata3.snappy +0 -0
- data/vendor/snappy/testdata/fireworks.jpeg +0 -0
- data/vendor/snappy/testdata/geo.protodata +0 -0
- data/vendor/snappy/testdata/html +0 -1
- data/vendor/snappy/testdata/html_x_4 +0 -1
- data/vendor/snappy/testdata/kppkn.gtb +0 -0
- data/vendor/snappy/testdata/lcet10.txt +0 -7519
- data/vendor/snappy/testdata/paper-100k.pdf +2 -600
- data/vendor/snappy/testdata/plrabn12.txt +0 -10699
- data/vendor/snappy/testdata/urls.10K +0 -10000
@@ -1,135 +0,0 @@
|
|
1
|
-
Snappy framing format description
|
2
|
-
Last revised: 2013-10-25
|
3
|
-
|
4
|
-
This format decribes a framing format for Snappy, allowing compressing to
|
5
|
-
files or streams that can then more easily be decompressed without having
|
6
|
-
to hold the entire stream in memory. It also provides data checksums to
|
7
|
-
help verify integrity. It does not provide metadata checksums, so it does
|
8
|
-
not protect against e.g. all forms of truncations.
|
9
|
-
|
10
|
-
Implementation of the framing format is optional for Snappy compressors and
|
11
|
-
decompressor; it is not part of the Snappy core specification.
|
12
|
-
|
13
|
-
|
14
|
-
1. General structure
|
15
|
-
|
16
|
-
The file consists solely of chunks, lying back-to-back with no padding
|
17
|
-
in between. Each chunk consists first a single byte of chunk identifier,
|
18
|
-
then a three-byte little-endian length of the chunk in bytes (from 0 to
|
19
|
-
16777215, inclusive), and then the data if any. The four bytes of chunk
|
20
|
-
header is not counted in the data length.
|
21
|
-
|
22
|
-
The different chunk types are listed below. The first chunk must always
|
23
|
-
be the stream identifier chunk (see section 4.1, below). The stream
|
24
|
-
ends when the file ends -- there is no explicit end-of-file marker.
|
25
|
-
|
26
|
-
|
27
|
-
2. File type identification
|
28
|
-
|
29
|
-
The following identifiers for this format are recommended where appropriate.
|
30
|
-
However, note that none have been registered officially, so this is only to
|
31
|
-
be taken as a guideline. We use "Snappy framed" to distinguish between this
|
32
|
-
format and raw Snappy data.
|
33
|
-
|
34
|
-
File extension: .sz
|
35
|
-
MIME type: application/x-snappy-framed
|
36
|
-
HTTP Content-Encoding: x-snappy-framed
|
37
|
-
|
38
|
-
|
39
|
-
3. Checksum format
|
40
|
-
|
41
|
-
Some chunks have data protected by a checksum (the ones that do will say so
|
42
|
-
explicitly). The checksums are always masked CRC-32Cs.
|
43
|
-
|
44
|
-
A description of CRC-32C can be found in RFC 3720, section 12.1, with
|
45
|
-
examples in section B.4.
|
46
|
-
|
47
|
-
Checksums are not stored directly, but masked, as checksumming data and
|
48
|
-
then its own checksum can be problematic. The masking is the same as used
|
49
|
-
in Apache Hadoop: Rotate the checksum by 15 bits, then add the constant
|
50
|
-
0xa282ead8 (using wraparound as normal for unsigned integers). This is
|
51
|
-
equivalent to the following C code:
|
52
|
-
|
53
|
-
uint32_t mask_checksum(uint32_t x) {
|
54
|
-
return ((x >> 15) | (x << 17)) + 0xa282ead8;
|
55
|
-
}
|
56
|
-
|
57
|
-
Note that the masking is reversible.
|
58
|
-
|
59
|
-
The checksum is always stored as a four bytes long integer, in little-endian.
|
60
|
-
|
61
|
-
|
62
|
-
4. Chunk types
|
63
|
-
|
64
|
-
The currently supported chunk types are described below. The list may
|
65
|
-
be extended in the future.
|
66
|
-
|
67
|
-
|
68
|
-
4.1. Stream identifier (chunk type 0xff)
|
69
|
-
|
70
|
-
The stream identifier is always the first element in the stream.
|
71
|
-
It is exactly six bytes long and contains "sNaPpY" in ASCII. This means that
|
72
|
-
a valid Snappy framed stream always starts with the bytes
|
73
|
-
|
74
|
-
0xff 0x06 0x00 0x00 0x73 0x4e 0x61 0x50 0x70 0x59
|
75
|
-
|
76
|
-
The stream identifier chunk can come multiple times in the stream besides
|
77
|
-
the first; if such a chunk shows up, it should simply be ignored, assuming
|
78
|
-
it has the right length and contents. This allows for easy concatenation of
|
79
|
-
compressed files without the need for re-framing.
|
80
|
-
|
81
|
-
|
82
|
-
4.2. Compressed data (chunk type 0x00)
|
83
|
-
|
84
|
-
Compressed data chunks contain a normal Snappy compressed bitstream;
|
85
|
-
see the compressed format specification. The compressed data is preceded by
|
86
|
-
the CRC-32C (see section 3) of the _uncompressed_ data.
|
87
|
-
|
88
|
-
Note that the data portion of the chunk, i.e., the compressed contents,
|
89
|
-
can be at most 16777211 bytes (2^24 - 1, minus the checksum).
|
90
|
-
However, we place an additional restriction that the uncompressed data
|
91
|
-
in a chunk must be no longer than 65536 bytes. This allows consumers to
|
92
|
-
easily use small fixed-size buffers.
|
93
|
-
|
94
|
-
|
95
|
-
4.3. Uncompressed data (chunk type 0x01)
|
96
|
-
|
97
|
-
Uncompressed data chunks allow a compressor to send uncompressed,
|
98
|
-
raw data; this is useful if, for instance, uncompressible or
|
99
|
-
near-incompressible data is detected, and faster decompression is desired.
|
100
|
-
|
101
|
-
As in the compressed chunks, the data is preceded by its own masked
|
102
|
-
CRC-32C (see section 3).
|
103
|
-
|
104
|
-
An uncompressed data chunk, like compressed data chunks, should contain
|
105
|
-
no more than 65536 data bytes, so the maximum legal chunk length with the
|
106
|
-
checksum is 65540.
|
107
|
-
|
108
|
-
|
109
|
-
4.4. Padding (chunk type 0xfe)
|
110
|
-
|
111
|
-
Padding chunks allow a compressor to increase the size of the data stream
|
112
|
-
so that it complies with external demands, e.g. that the total number of
|
113
|
-
bytes is a multiple of some value.
|
114
|
-
|
115
|
-
All bytes of the padding chunk, except the chunk byte itself and the length,
|
116
|
-
should be zero, but decompressors must not try to interpret or verify the
|
117
|
-
padding data in any way.
|
118
|
-
|
119
|
-
|
120
|
-
4.5. Reserved unskippable chunks (chunk types 0x02-0x7f)
|
121
|
-
|
122
|
-
These are reserved for future expansion. A decoder that sees such a chunk
|
123
|
-
should immediately return an error, as it must assume it cannot decode the
|
124
|
-
stream correctly.
|
125
|
-
|
126
|
-
Future versions of this specification may define meanings for these chunks.
|
127
|
-
|
128
|
-
|
129
|
-
4.6. Reserved skippable chunks (chunk types 0x80-0xfd)
|
130
|
-
|
131
|
-
These are also reserved for future expansion, but unlike the chunks
|
132
|
-
described in 4.5, a decoder seeing these must skip them and continue
|
133
|
-
decoding.
|
134
|
-
|
135
|
-
Future versions of this specification may define meanings for these chunks.
|
data/vendor/snappy/m4/gtest.m4
DELETED
@@ -1,74 +0,0 @@
|
|
1
|
-
dnl GTEST_LIB_CHECK([minimum version [,
|
2
|
-
dnl action if found [,action if not found]]])
|
3
|
-
dnl
|
4
|
-
dnl Check for the presence of the Google Test library, optionally at a minimum
|
5
|
-
dnl version, and indicate a viable version with the HAVE_GTEST flag. It defines
|
6
|
-
dnl standard variables for substitution including GTEST_CPPFLAGS,
|
7
|
-
dnl GTEST_CXXFLAGS, GTEST_LDFLAGS, and GTEST_LIBS. It also defines
|
8
|
-
dnl GTEST_VERSION as the version of Google Test found. Finally, it provides
|
9
|
-
dnl optional custom action slots in the event GTEST is found or not.
|
10
|
-
AC_DEFUN([GTEST_LIB_CHECK],
|
11
|
-
[
|
12
|
-
dnl Provide a flag to enable or disable Google Test usage.
|
13
|
-
AC_ARG_ENABLE([gtest],
|
14
|
-
[AS_HELP_STRING([--enable-gtest],
|
15
|
-
[Enable tests using the Google C++ Testing Framework.
|
16
|
-
(Default is enabled.)])],
|
17
|
-
[],
|
18
|
-
[enable_gtest=])
|
19
|
-
AC_ARG_VAR([GTEST_CONFIG],
|
20
|
-
[The exact path of Google Test's 'gtest-config' script.])
|
21
|
-
AC_ARG_VAR([GTEST_CPPFLAGS],
|
22
|
-
[C-like preprocessor flags for Google Test.])
|
23
|
-
AC_ARG_VAR([GTEST_CXXFLAGS],
|
24
|
-
[C++ compile flags for Google Test.])
|
25
|
-
AC_ARG_VAR([GTEST_LDFLAGS],
|
26
|
-
[Linker path and option flags for Google Test.])
|
27
|
-
AC_ARG_VAR([GTEST_LIBS],
|
28
|
-
[Library linking flags for Google Test.])
|
29
|
-
AC_ARG_VAR([GTEST_VERSION],
|
30
|
-
[The version of Google Test available.])
|
31
|
-
HAVE_GTEST="no"
|
32
|
-
AS_IF([test "x${enable_gtest}" != "xno"],
|
33
|
-
[AC_MSG_CHECKING([for 'gtest-config'])
|
34
|
-
AS_IF([test "x${enable_gtest}" = "xyes"],
|
35
|
-
[AS_IF([test -x "${enable_gtest}/scripts/gtest-config"],
|
36
|
-
[GTEST_CONFIG="${enable_gtest}/scripts/gtest-config"],
|
37
|
-
[GTEST_CONFIG="${enable_gtest}/bin/gtest-config"])
|
38
|
-
AS_IF([test -x "${GTEST_CONFIG}"], [],
|
39
|
-
[AC_MSG_RESULT([no])
|
40
|
-
AC_MSG_ERROR([dnl
|
41
|
-
Unable to locate either a built or installed Google Test.
|
42
|
-
The specific location '${enable_gtest}' was provided for a built or installed
|
43
|
-
Google Test, but no 'gtest-config' script could be found at this location.])
|
44
|
-
])],
|
45
|
-
[AC_PATH_PROG([GTEST_CONFIG], [gtest-config])])
|
46
|
-
AS_IF([test -x "${GTEST_CONFIG}"],
|
47
|
-
[AC_MSG_RESULT([${GTEST_CONFIG}])
|
48
|
-
m4_ifval([$1],
|
49
|
-
[_gtest_min_version="--min-version=$1"
|
50
|
-
AC_MSG_CHECKING([for Google Test at least version >= $1])],
|
51
|
-
[_gtest_min_version="--min-version=0"
|
52
|
-
AC_MSG_CHECKING([for Google Test])])
|
53
|
-
AS_IF([${GTEST_CONFIG} ${_gtest_min_version}],
|
54
|
-
[AC_MSG_RESULT([yes])
|
55
|
-
HAVE_GTEST='yes'],
|
56
|
-
[AC_MSG_RESULT([no])])],
|
57
|
-
[AC_MSG_RESULT([no])])
|
58
|
-
AS_IF([test "x${HAVE_GTEST}" = "xyes"],
|
59
|
-
[GTEST_CPPFLAGS=`${GTEST_CONFIG} --cppflags`
|
60
|
-
GTEST_CXXFLAGS=`${GTEST_CONFIG} --cxxflags`
|
61
|
-
GTEST_LDFLAGS=`${GTEST_CONFIG} --ldflags`
|
62
|
-
GTEST_LIBS=`${GTEST_CONFIG} --libs`
|
63
|
-
GTEST_VERSION=`${GTEST_CONFIG} --version`
|
64
|
-
AC_DEFINE([HAVE_GTEST],[1],[Defined when Google Test is available.])],
|
65
|
-
[AS_IF([test "x${enable_gtest}" = "xyes"],
|
66
|
-
[AC_MSG_ERROR([dnl
|
67
|
-
Google Test was enabled, but no viable version could be found.])
|
68
|
-
])])])
|
69
|
-
AC_SUBST([HAVE_GTEST])
|
70
|
-
AM_CONDITIONAL([HAVE_GTEST],[test "x$HAVE_GTEST" = "xyes"])
|
71
|
-
AS_IF([test "x$HAVE_GTEST" = "xyes"],
|
72
|
-
[m4_ifval([$2], [$2])],
|
73
|
-
[m4_ifval([$3], [$3])])
|
74
|
-
])
|
data/vendor/snappy/snappy-c.cc
DELETED
@@ -1,90 +0,0 @@
|
|
1
|
-
// Copyright 2011 Martin Gieseking <martin.gieseking@uos.de>.
|
2
|
-
//
|
3
|
-
// Redistribution and use in source and binary forms, with or without
|
4
|
-
// modification, are permitted provided that the following conditions are
|
5
|
-
// met:
|
6
|
-
//
|
7
|
-
// * Redistributions of source code must retain the above copyright
|
8
|
-
// notice, this list of conditions and the following disclaimer.
|
9
|
-
// * Redistributions in binary form must reproduce the above
|
10
|
-
// copyright notice, this list of conditions and the following disclaimer
|
11
|
-
// in the documentation and/or other materials provided with the
|
12
|
-
// distribution.
|
13
|
-
// * Neither the name of Google Inc. nor the names of its
|
14
|
-
// contributors may be used to endorse or promote products derived from
|
15
|
-
// this software without specific prior written permission.
|
16
|
-
//
|
17
|
-
// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
|
18
|
-
// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
|
19
|
-
// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
|
20
|
-
// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
|
21
|
-
// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
|
22
|
-
// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
|
23
|
-
// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
|
24
|
-
// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
|
25
|
-
// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
|
26
|
-
// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
|
27
|
-
// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
28
|
-
|
29
|
-
#include "snappy.h"
|
30
|
-
#include "snappy-c.h"
|
31
|
-
|
32
|
-
extern "C" {
|
33
|
-
|
34
|
-
snappy_status snappy_compress(const char* input,
|
35
|
-
size_t input_length,
|
36
|
-
char* compressed,
|
37
|
-
size_t *compressed_length) {
|
38
|
-
if (*compressed_length < snappy_max_compressed_length(input_length)) {
|
39
|
-
return SNAPPY_BUFFER_TOO_SMALL;
|
40
|
-
}
|
41
|
-
snappy::RawCompress(input, input_length, compressed, compressed_length);
|
42
|
-
return SNAPPY_OK;
|
43
|
-
}
|
44
|
-
|
45
|
-
snappy_status snappy_uncompress(const char* compressed,
|
46
|
-
size_t compressed_length,
|
47
|
-
char* uncompressed,
|
48
|
-
size_t* uncompressed_length) {
|
49
|
-
size_t real_uncompressed_length;
|
50
|
-
if (!snappy::GetUncompressedLength(compressed,
|
51
|
-
compressed_length,
|
52
|
-
&real_uncompressed_length)) {
|
53
|
-
return SNAPPY_INVALID_INPUT;
|
54
|
-
}
|
55
|
-
if (*uncompressed_length < real_uncompressed_length) {
|
56
|
-
return SNAPPY_BUFFER_TOO_SMALL;
|
57
|
-
}
|
58
|
-
if (!snappy::RawUncompress(compressed, compressed_length, uncompressed)) {
|
59
|
-
return SNAPPY_INVALID_INPUT;
|
60
|
-
}
|
61
|
-
*uncompressed_length = real_uncompressed_length;
|
62
|
-
return SNAPPY_OK;
|
63
|
-
}
|
64
|
-
|
65
|
-
size_t snappy_max_compressed_length(size_t source_length) {
|
66
|
-
return snappy::MaxCompressedLength(source_length);
|
67
|
-
}
|
68
|
-
|
69
|
-
snappy_status snappy_uncompressed_length(const char *compressed,
|
70
|
-
size_t compressed_length,
|
71
|
-
size_t *result) {
|
72
|
-
if (snappy::GetUncompressedLength(compressed,
|
73
|
-
compressed_length,
|
74
|
-
result)) {
|
75
|
-
return SNAPPY_OK;
|
76
|
-
} else {
|
77
|
-
return SNAPPY_INVALID_INPUT;
|
78
|
-
}
|
79
|
-
}
|
80
|
-
|
81
|
-
snappy_status snappy_validate_compressed_buffer(const char *compressed,
|
82
|
-
size_t compressed_length) {
|
83
|
-
if (snappy::IsValidCompressedBuffer(compressed, compressed_length)) {
|
84
|
-
return SNAPPY_OK;
|
85
|
-
} else {
|
86
|
-
return SNAPPY_INVALID_INPUT;
|
87
|
-
}
|
88
|
-
}
|
89
|
-
|
90
|
-
} // extern "C"
|
data/vendor/snappy/snappy-c.h
DELETED
@@ -1,138 +0,0 @@
|
|
1
|
-
/*
|
2
|
-
* Copyright 2011 Martin Gieseking <martin.gieseking@uos.de>.
|
3
|
-
*
|
4
|
-
* Redistribution and use in source and binary forms, with or without
|
5
|
-
* modification, are permitted provided that the following conditions are
|
6
|
-
* met:
|
7
|
-
*
|
8
|
-
* * Redistributions of source code must retain the above copyright
|
9
|
-
* notice, this list of conditions and the following disclaimer.
|
10
|
-
* * Redistributions in binary form must reproduce the above
|
11
|
-
* copyright notice, this list of conditions and the following disclaimer
|
12
|
-
* in the documentation and/or other materials provided with the
|
13
|
-
* distribution.
|
14
|
-
* * Neither the name of Google Inc. nor the names of its
|
15
|
-
* contributors may be used to endorse or promote products derived from
|
16
|
-
* this software without specific prior written permission.
|
17
|
-
*
|
18
|
-
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
|
19
|
-
* "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
|
20
|
-
* LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
|
21
|
-
* A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
|
22
|
-
* OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
|
23
|
-
* SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
|
24
|
-
* LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
|
25
|
-
* DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
|
26
|
-
* THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
|
27
|
-
* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
|
28
|
-
* OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
29
|
-
*
|
30
|
-
* Plain C interface (a wrapper around the C++ implementation).
|
31
|
-
*/
|
32
|
-
|
33
|
-
#ifndef UTIL_SNAPPY_OPENSOURCE_SNAPPY_C_H_
|
34
|
-
#define UTIL_SNAPPY_OPENSOURCE_SNAPPY_C_H_
|
35
|
-
|
36
|
-
#ifdef __cplusplus
|
37
|
-
extern "C" {
|
38
|
-
#endif
|
39
|
-
|
40
|
-
#include <stddef.h>
|
41
|
-
|
42
|
-
/*
|
43
|
-
* Return values; see the documentation for each function to know
|
44
|
-
* what each can return.
|
45
|
-
*/
|
46
|
-
typedef enum {
|
47
|
-
SNAPPY_OK = 0,
|
48
|
-
SNAPPY_INVALID_INPUT = 1,
|
49
|
-
SNAPPY_BUFFER_TOO_SMALL = 2
|
50
|
-
} snappy_status;
|
51
|
-
|
52
|
-
/*
|
53
|
-
* Takes the data stored in "input[0..input_length-1]" and stores
|
54
|
-
* it in the array pointed to by "compressed".
|
55
|
-
*
|
56
|
-
* <compressed_length> signals the space available in "compressed".
|
57
|
-
* If it is not at least equal to "snappy_max_compressed_length(input_length)",
|
58
|
-
* SNAPPY_BUFFER_TOO_SMALL is returned. After successful compression,
|
59
|
-
* <compressed_length> contains the true length of the compressed output,
|
60
|
-
* and SNAPPY_OK is returned.
|
61
|
-
*
|
62
|
-
* Example:
|
63
|
-
* size_t output_length = snappy_max_compressed_length(input_length);
|
64
|
-
* char* output = (char*)malloc(output_length);
|
65
|
-
* if (snappy_compress(input, input_length, output, &output_length)
|
66
|
-
* == SNAPPY_OK) {
|
67
|
-
* ... Process(output, output_length) ...
|
68
|
-
* }
|
69
|
-
* free(output);
|
70
|
-
*/
|
71
|
-
snappy_status snappy_compress(const char* input,
|
72
|
-
size_t input_length,
|
73
|
-
char* compressed,
|
74
|
-
size_t* compressed_length);
|
75
|
-
|
76
|
-
/*
|
77
|
-
* Given data in "compressed[0..compressed_length-1]" generated by
|
78
|
-
* calling the snappy_compress routine, this routine stores
|
79
|
-
* the uncompressed data to
|
80
|
-
* uncompressed[0..uncompressed_length-1].
|
81
|
-
* Returns failure (a value not equal to SNAPPY_OK) if the message
|
82
|
-
* is corrupted and could not be decrypted.
|
83
|
-
*
|
84
|
-
* <uncompressed_length> signals the space available in "uncompressed".
|
85
|
-
* If it is not at least equal to the value returned by
|
86
|
-
* snappy_uncompressed_length for this stream, SNAPPY_BUFFER_TOO_SMALL
|
87
|
-
* is returned. After successful decompression, <uncompressed_length>
|
88
|
-
* contains the true length of the decompressed output.
|
89
|
-
*
|
90
|
-
* Example:
|
91
|
-
* size_t output_length;
|
92
|
-
* if (snappy_uncompressed_length(input, input_length, &output_length)
|
93
|
-
* != SNAPPY_OK) {
|
94
|
-
* ... fail ...
|
95
|
-
* }
|
96
|
-
* char* output = (char*)malloc(output_length);
|
97
|
-
* if (snappy_uncompress(input, input_length, output, &output_length)
|
98
|
-
* == SNAPPY_OK) {
|
99
|
-
* ... Process(output, output_length) ...
|
100
|
-
* }
|
101
|
-
* free(output);
|
102
|
-
*/
|
103
|
-
snappy_status snappy_uncompress(const char* compressed,
|
104
|
-
size_t compressed_length,
|
105
|
-
char* uncompressed,
|
106
|
-
size_t* uncompressed_length);
|
107
|
-
|
108
|
-
/*
|
109
|
-
* Returns the maximal size of the compressed representation of
|
110
|
-
* input data that is "source_length" bytes in length.
|
111
|
-
*/
|
112
|
-
size_t snappy_max_compressed_length(size_t source_length);
|
113
|
-
|
114
|
-
/*
|
115
|
-
* REQUIRES: "compressed[]" was produced by snappy_compress()
|
116
|
-
* Returns SNAPPY_OK and stores the length of the uncompressed data in
|
117
|
-
* *result normally. Returns SNAPPY_INVALID_INPUT on parsing error.
|
118
|
-
* This operation takes O(1) time.
|
119
|
-
*/
|
120
|
-
snappy_status snappy_uncompressed_length(const char* compressed,
|
121
|
-
size_t compressed_length,
|
122
|
-
size_t* result);
|
123
|
-
|
124
|
-
/*
|
125
|
-
* Check if the contents of "compressed[]" can be uncompressed successfully.
|
126
|
-
* Does not return the uncompressed data; if so, returns SNAPPY_OK,
|
127
|
-
* or if not, returns SNAPPY_INVALID_INPUT.
|
128
|
-
* Takes time proportional to compressed_length, but is usually at least a
|
129
|
-
* factor of four faster than actual decompression.
|
130
|
-
*/
|
131
|
-
snappy_status snappy_validate_compressed_buffer(const char* compressed,
|
132
|
-
size_t compressed_length);
|
133
|
-
|
134
|
-
#ifdef __cplusplus
|
135
|
-
} // extern "C"
|
136
|
-
#endif
|
137
|
-
|
138
|
-
#endif /* UTIL_SNAPPY_OPENSOURCE_SNAPPY_C_H_ */
|
@@ -1,150 +0,0 @@
|
|
1
|
-
// Copyright 2008 Google Inc. All Rights Reserved.
|
2
|
-
//
|
3
|
-
// Redistribution and use in source and binary forms, with or without
|
4
|
-
// modification, are permitted provided that the following conditions are
|
5
|
-
// met:
|
6
|
-
//
|
7
|
-
// * Redistributions of source code must retain the above copyright
|
8
|
-
// notice, this list of conditions and the following disclaimer.
|
9
|
-
// * Redistributions in binary form must reproduce the above
|
10
|
-
// copyright notice, this list of conditions and the following disclaimer
|
11
|
-
// in the documentation and/or other materials provided with the
|
12
|
-
// distribution.
|
13
|
-
// * Neither the name of Google Inc. nor the names of its
|
14
|
-
// contributors may be used to endorse or promote products derived from
|
15
|
-
// this software without specific prior written permission.
|
16
|
-
//
|
17
|
-
// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
|
18
|
-
// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
|
19
|
-
// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
|
20
|
-
// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
|
21
|
-
// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
|
22
|
-
// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
|
23
|
-
// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
|
24
|
-
// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
|
25
|
-
// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
|
26
|
-
// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
|
27
|
-
// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
28
|
-
//
|
29
|
-
// Internals shared between the Snappy implementation and its unittest.
|
30
|
-
|
31
|
-
#ifndef UTIL_SNAPPY_SNAPPY_INTERNAL_H_
|
32
|
-
#define UTIL_SNAPPY_SNAPPY_INTERNAL_H_
|
33
|
-
|
34
|
-
#include "snappy-stubs-internal.h"
|
35
|
-
|
36
|
-
namespace snappy {
|
37
|
-
namespace internal {
|
38
|
-
|
39
|
-
class WorkingMemory {
|
40
|
-
public:
|
41
|
-
WorkingMemory() : large_table_(NULL) { }
|
42
|
-
~WorkingMemory() { delete[] large_table_; }
|
43
|
-
|
44
|
-
// Allocates and clears a hash table using memory in "*this",
|
45
|
-
// stores the number of buckets in "*table_size" and returns a pointer to
|
46
|
-
// the base of the hash table.
|
47
|
-
uint16* GetHashTable(size_t input_size, int* table_size);
|
48
|
-
|
49
|
-
private:
|
50
|
-
uint16 small_table_[1<<10]; // 2KB
|
51
|
-
uint16* large_table_; // Allocated only when needed
|
52
|
-
|
53
|
-
DISALLOW_COPY_AND_ASSIGN(WorkingMemory);
|
54
|
-
};
|
55
|
-
|
56
|
-
// Flat array compression that does not emit the "uncompressed length"
|
57
|
-
// prefix. Compresses "input" string to the "*op" buffer.
|
58
|
-
//
|
59
|
-
// REQUIRES: "input_length <= kBlockSize"
|
60
|
-
// REQUIRES: "op" points to an array of memory that is at least
|
61
|
-
// "MaxCompressedLength(input_length)" in size.
|
62
|
-
// REQUIRES: All elements in "table[0..table_size-1]" are initialized to zero.
|
63
|
-
// REQUIRES: "table_size" is a power of two
|
64
|
-
//
|
65
|
-
// Returns an "end" pointer into "op" buffer.
|
66
|
-
// "end - op" is the compressed size of "input".
|
67
|
-
char* CompressFragment(const char* input,
|
68
|
-
size_t input_length,
|
69
|
-
char* op,
|
70
|
-
uint16* table,
|
71
|
-
const int table_size);
|
72
|
-
|
73
|
-
// Return the largest n such that
|
74
|
-
//
|
75
|
-
// s1[0,n-1] == s2[0,n-1]
|
76
|
-
// and n <= (s2_limit - s2).
|
77
|
-
//
|
78
|
-
// Does not read *s2_limit or beyond.
|
79
|
-
// Does not read *(s1 + (s2_limit - s2)) or beyond.
|
80
|
-
// Requires that s2_limit >= s2.
|
81
|
-
//
|
82
|
-
// Separate implementation for x86_64, for speed. Uses the fact that
|
83
|
-
// x86_64 is little endian.
|
84
|
-
#if defined(ARCH_K8)
|
85
|
-
static inline int FindMatchLength(const char* s1,
|
86
|
-
const char* s2,
|
87
|
-
const char* s2_limit) {
|
88
|
-
assert(s2_limit >= s2);
|
89
|
-
int matched = 0;
|
90
|
-
|
91
|
-
// Find out how long the match is. We loop over the data 64 bits at a
|
92
|
-
// time until we find a 64-bit block that doesn't match; then we find
|
93
|
-
// the first non-matching bit and use that to calculate the total
|
94
|
-
// length of the match.
|
95
|
-
while (PREDICT_TRUE(s2 <= s2_limit - 8)) {
|
96
|
-
if (PREDICT_FALSE(UNALIGNED_LOAD64(s2) == UNALIGNED_LOAD64(s1 + matched))) {
|
97
|
-
s2 += 8;
|
98
|
-
matched += 8;
|
99
|
-
} else {
|
100
|
-
// On current (mid-2008) Opteron models there is a 3% more
|
101
|
-
// efficient code sequence to find the first non-matching byte.
|
102
|
-
// However, what follows is ~10% better on Intel Core 2 and newer,
|
103
|
-
// and we expect AMD's bsf instruction to improve.
|
104
|
-
uint64 x = UNALIGNED_LOAD64(s2) ^ UNALIGNED_LOAD64(s1 + matched);
|
105
|
-
int matching_bits = Bits::FindLSBSetNonZero64(x);
|
106
|
-
matched += matching_bits >> 3;
|
107
|
-
return matched;
|
108
|
-
}
|
109
|
-
}
|
110
|
-
while (PREDICT_TRUE(s2 < s2_limit)) {
|
111
|
-
if (PREDICT_TRUE(s1[matched] == *s2)) {
|
112
|
-
++s2;
|
113
|
-
++matched;
|
114
|
-
} else {
|
115
|
-
return matched;
|
116
|
-
}
|
117
|
-
}
|
118
|
-
return matched;
|
119
|
-
}
|
120
|
-
#else
|
121
|
-
static inline int FindMatchLength(const char* s1,
|
122
|
-
const char* s2,
|
123
|
-
const char* s2_limit) {
|
124
|
-
// Implementation based on the x86-64 version, above.
|
125
|
-
assert(s2_limit >= s2);
|
126
|
-
int matched = 0;
|
127
|
-
|
128
|
-
while (s2 <= s2_limit - 4 &&
|
129
|
-
UNALIGNED_LOAD32(s2) == UNALIGNED_LOAD32(s1 + matched)) {
|
130
|
-
s2 += 4;
|
131
|
-
matched += 4;
|
132
|
-
}
|
133
|
-
if (LittleEndian::IsLittleEndian() && s2 <= s2_limit - 4) {
|
134
|
-
uint32 x = UNALIGNED_LOAD32(s2) ^ UNALIGNED_LOAD32(s1 + matched);
|
135
|
-
int matching_bits = Bits::FindLSBSetNonZero(x);
|
136
|
-
matched += matching_bits >> 3;
|
137
|
-
} else {
|
138
|
-
while ((s2 < s2_limit) && (s1[matched] == *s2)) {
|
139
|
-
++s2;
|
140
|
-
++matched;
|
141
|
-
}
|
142
|
-
}
|
143
|
-
return matched;
|
144
|
-
}
|
145
|
-
#endif
|
146
|
-
|
147
|
-
} // end namespace internal
|
148
|
-
} // end namespace snappy
|
149
|
-
|
150
|
-
#endif // UTIL_SNAPPY_SNAPPY_INTERNAL_H_
|