mirror of
https://github.com/MariaDB/server.git
synced 2025-10-31 10:56:12 +01:00
78 lines
4.5 KiB
C++
78 lines
4.5 KiB
C++
/* -*- mode: C++; c-basic-offset: 4; indent-tabs-mode: nil -*- */
|
|
// vim: ft=cpp:expandtab:ts=8:sw=4:softtabstop=4:
|
|
#ident "$Id$"
|
|
/*======
|
|
This file is part of PerconaFT.
|
|
|
|
|
|
Copyright (c) 2006, 2015, Percona and/or its affiliates. All rights reserved.
|
|
|
|
PerconaFT is free software: you can redistribute it and/or modify
|
|
it under the terms of the GNU General Public License, version 2,
|
|
as published by the Free Software Foundation.
|
|
|
|
PerconaFT is distributed in the hope that it will be useful,
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
GNU General Public License for more details.
|
|
|
|
You should have received a copy of the GNU General Public License
|
|
along with PerconaFT. If not, see <http://www.gnu.org/licenses/>.
|
|
|
|
----------------------------------------
|
|
|
|
PerconaFT is free software: you can redistribute it and/or modify
|
|
it under the terms of the GNU Affero General Public License, version 3,
|
|
as published by the Free Software Foundation.
|
|
|
|
PerconaFT is distributed in the hope that it will be useful,
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
GNU Affero General Public License for more details.
|
|
|
|
You should have received a copy of the GNU Affero General Public License
|
|
along with PerconaFT. If not, see <http://www.gnu.org/licenses/>.
|
|
======= */
|
|
|
|
#ident "Copyright (c) 2006, 2015, Percona and/or its affiliates. All rights reserved."
|
|
|
|
#pragma once
|
|
|
|
#include <zlib.h>
|
|
#include <db.h>
|
|
|
|
// The following provides an abstraction of quicklz and zlib.
|
|
// We offer three compression methods: ZLIB, QUICKLZ, and LZMA, as well as a "no compression" option. These options are declared in make_tdb.c.
|
|
// The resulting byte string includes enough information for us to decompress it. That is, we can tell whether it's z-compressed or qz-compressed or xz-compressed.
|
|
|
|
size_t toku_compress_bound (enum toku_compression_method a, size_t size);
|
|
// Effect: Return the number of bytes needed to compress a buffer of size SIZE using compression method A.
|
|
// Typically, the result is a little bit larger than SIZE, since some data cannot be compressed.
|
|
// Usage note: It may help to know roughly how much space is involved.
|
|
// zlib's bound is something like (size + (size>>12) + (size>>14) + (size>>25) + 13.
|
|
// quicklz's bound is something like size+400.
|
|
|
|
void toku_compress (enum toku_compression_method a,
|
|
// the following types and naming conventions come from zlib.h
|
|
Bytef *dest, uLongf *destLen,
|
|
const Bytef *source, uLong sourceLen);
|
|
// Effect: Using compression method A, compress SOURCE into DEST. The number of bytes to compress is passed in SOURCELEN.
|
|
// On input: *destLen is the size of the buffer.
|
|
// On output: *destLen is the size of the actual compressed data.
|
|
// Usage note: sourceLen may be be zero (unlike for quicklz, which requires sourceLen>0).
|
|
// Requires: The buffer must be big enough to hold the compressed data. (That is *destLen >= compressBound(a, sourceLen))
|
|
// Requires: sourceLen < 2^32.
|
|
// Usage note: Although we *try* to assert if the DESTLEN isn't big enough, it's possible that it's too late by then (in the case of quicklz which offers
|
|
// no way to avoid a buffer overrun.) So we require that that DESTLEN is big enough.
|
|
// Rationale: zlib's argument order is DEST then SOURCE with the size of the buffer passed in *destLen, and the size of the result returned in *destLen.
|
|
// quicklz's argument order is SOURCE then DEST with the size returned (and it has no way to verify that an overright didn't happen).
|
|
// We use zlib's calling conventions partly because it is safer, and partly because it is more established.
|
|
// We also use zlib's ugly camel case convention for destLen and sourceLen.
|
|
// Unlike zlib, we return no error codes. Instead, we require that the data be OK and the size of the buffers is OK, and assert if there's a problem.
|
|
|
|
void toku_decompress (Bytef *dest, uLongf destLen,
|
|
const Bytef *source, uLongf sourceLen);
|
|
// Effect: Decompress source (length sourceLen) into dest (length destLen)
|
|
// This function can decompress data compressed with either zlib or quicklz compression methods (calling toku_compress(), which puts an appropriate header on so we know which it is.)
|
|
// Requires: destLen is equal to the actual decompressed size of the data.
|
|
// Requires: The source must have been properly compressed.
|