SeekGzip
                              Version 1.0
                 http://github.com/chokkan/seekgzip



* INTRODUCTION
SeekGzip provides a utility and library for random seek on gzip streams.
Because gzip streams do not support random seek, SeekGzip builds an
index file that stores necessary information for random seek. An index
file has a postfix ".idx" to the corresponding gzip file. The SeekGzip
API provides the functionality for building index files, seeking on a
gzip stream (with an index file associated), and reading partial data
from the gzip stream.

SeekGzip also provides a C++/SWIG API for reading (seekable) gzip
streams.


* HOW TO BUILD THE UTILITY
$ make all

* HOW TO INSTALL THE UTILITY
$ make install

* HOW TO USE THE UTILITY

(1) Building an index for a gzip file
$ seekgzip -b <FILE>
This builds an index file for the specified gzip file ${FILE}. This
utility creates an index file ${FILE}.idx

(2) Reading the data in the specified range
$ seekgzip <FILE> [BEGIN-END]
This reads the data in the gzip file ${FILE} from the offset ${BEGIN}
to ${END}, and outputs the data to STDOUT.


* COPYRIGHT AND LICENSING INFORMATION

This program is distributed under the zlib license.

Portions of this software are based on zlib and zran.c

The zlib License

  Copyright (C) 1995-2009 Jean-loup Gailly and Mark Adler

  This software is provided 'as-is', without any express or implied
  warranty.  In no event will the authors be held liable for any damages
  arising from the use of this software.

  Permission is granted to anyone to use this software for any purpose,
  including commercial applications, and to alter it and redistribute it
  freely, subject to the following restrictions:

  1. The origin of this software must not be misrepresented; you must not
     claim that you wrote the original software. If you use this software
     in a product, an acknowledgment in the product documentation would be
     appreciated but is not required.
  2. Altered source versions must be plainly marked as such, and must not be
     misrepresented as being the original software.
  3. This notice may not be removed or altered from any source distribution.

  Jean-loup Gailly        Mark Adler
  [email protected]          [email protected]