Sync usage with man page.
[netbsd-mini2440.git] / common / dist / zlib / gzio.c
blob54316698cd6eba324af081d2a1afafe573f466ab
1 /* $NetBSD: gzio.c,v 1.1.1.1 2006/01/14 20:10:29 christos Exp $ */
3 /* gzio.c -- IO on .gz files
4 * Copyright (C) 1995-2005 Jean-loup Gailly.
5 * For conditions of distribution and use, see copyright notice in zlib.h
7 * Compile this file with -DNO_GZCOMPRESS to avoid the compression code.
8 */
10 /* @(#) Id */
12 #include <stdio.h>
14 #include "zutil.h"
16 #ifdef NO_DEFLATE /* for compatibility with old definition */
17 # define NO_GZCOMPRESS
18 #endif
20 #ifndef NO_DUMMY_DECL
21 struct internal_state {int dummy;}; /* for buggy compilers */
22 #endif
24 #ifndef Z_BUFSIZE
25 # ifdef MAXSEG_64K
26 # define Z_BUFSIZE 4096 /* minimize memory usage for 16-bit DOS */
27 # else
28 # define Z_BUFSIZE 16384
29 # endif
30 #endif
31 #ifndef Z_PRINTF_BUFSIZE
32 # define Z_PRINTF_BUFSIZE 4096
33 #endif
35 #ifdef __MVS__
36 # pragma map (fdopen , "\174\174FDOPEN")
37 FILE *fdopen(int, const char *);
38 #endif
40 #ifndef STDC
41 extern voidp malloc OF((uInt size));
42 extern void free OF((voidpf ptr));
43 #endif
45 #define ALLOC(size) malloc(size)
46 #define TRYFREE(p) {if (p) free(p);}
48 static int const gz_magic[2] = {0x1f, 0x8b}; /* gzip magic header */
50 /* gzip flag byte */
51 #define ASCII_FLAG 0x01 /* bit 0 set: file probably ascii text */
52 #define HEAD_CRC 0x02 /* bit 1 set: header CRC present */
53 #define EXTRA_FIELD 0x04 /* bit 2 set: extra field present */
54 #define ORIG_NAME 0x08 /* bit 3 set: original file name present */
55 #define COMMENT 0x10 /* bit 4 set: file comment present */
56 #define RESERVED 0xE0 /* bits 5..7: reserved */
58 typedef struct gz_stream {
59 z_stream stream;
60 int z_err; /* error code for last stream operation */
61 int z_eof; /* set if end of input file */
62 FILE *file; /* .gz file */
63 Byte *inbuf; /* input buffer */
64 Byte *outbuf; /* output buffer */
65 uLong crc; /* crc32 of uncompressed data */
66 char *msg; /* error message */
67 char *path; /* path name for debugging only */
68 int transparent; /* 1 if input file is not a .gz file */
69 char mode; /* 'w' or 'r' */
70 z_off_t start; /* start of compressed data in file (header skipped) */
71 z_off_t in; /* bytes into deflate or inflate */
72 z_off_t out; /* bytes out of deflate or inflate */
73 int back; /* one character push-back */
74 int last; /* true if push-back is last character */
75 } gz_stream;
78 local gzFile gz_open OF((const char *path, const char *mode, int fd));
79 local int do_flush OF((gzFile file, int flush));
80 local int get_byte OF((gz_stream *s));
81 local void check_header OF((gz_stream *s));
82 local int destroy OF((gz_stream *s));
83 local void putLong OF((FILE *file, uLong x));
84 local uLong getLong OF((gz_stream *s));
86 /* ===========================================================================
87 Opens a gzip (.gz) file for reading or writing. The mode parameter
88 is as in fopen ("rb" or "wb"). The file is given either by file descriptor
89 or path name (if fd == -1).
90 gz_open returns NULL if the file could not be opened or if there was
91 insufficient memory to allocate the (de)compression state; errno
92 can be checked to distinguish the two cases (if errno is zero, the
93 zlib error is Z_MEM_ERROR).
95 local gzFile gz_open (path, mode, fd)
96 const char *path;
97 const char *mode;
98 int fd;
100 int err;
101 int level = Z_DEFAULT_COMPRESSION; /* compression level */
102 int strategy = Z_DEFAULT_STRATEGY; /* compression strategy */
103 const char *p = mode;
104 gz_stream *s;
105 char fmode[80]; /* copy of mode, without the compression level */
106 char *m = fmode;
108 if (!path || !mode) return Z_NULL;
110 s = (gz_stream *)ALLOC(sizeof(gz_stream));
111 if (!s) return Z_NULL;
113 s->stream.zalloc = (alloc_func)0;
114 s->stream.zfree = (free_func)0;
115 s->stream.opaque = (voidpf)0;
116 s->stream.next_in = s->inbuf = Z_NULL;
117 s->stream.next_out = s->outbuf = Z_NULL;
118 s->stream.avail_in = s->stream.avail_out = 0;
119 s->file = NULL;
120 s->z_err = Z_OK;
121 s->z_eof = 0;
122 s->in = 0;
123 s->out = 0;
124 s->back = EOF;
125 s->crc = crc32(0L, Z_NULL, 0);
126 s->msg = NULL;
127 s->transparent = 0;
129 s->path = (char*)ALLOC(strlen(path)+1);
130 if (s->path == NULL) {
131 return destroy(s), (gzFile)Z_NULL;
133 strcpy(s->path, path); /* do this early for debugging */
135 s->mode = '\0';
136 do {
137 if (*p == 'r') s->mode = 'r';
138 if (*p == 'w' || *p == 'a') s->mode = 'w';
139 if (*p >= '0' && *p <= '9') {
140 level = *p - '0';
141 } else if (*p == 'f') {
142 strategy = Z_FILTERED;
143 } else if (*p == 'h') {
144 strategy = Z_HUFFMAN_ONLY;
145 } else if (*p == 'R') {
146 strategy = Z_RLE;
147 } else {
148 *m++ = *p; /* copy the mode */
150 } while (*p++ && m != fmode + sizeof(fmode));
151 if (s->mode == '\0') return destroy(s), (gzFile)Z_NULL;
153 if (s->mode == 'w') {
154 #ifdef NO_GZCOMPRESS
155 err = Z_STREAM_ERROR;
156 #else
157 err = deflateInit2(&(s->stream), level,
158 Z_DEFLATED, -MAX_WBITS, DEF_MEM_LEVEL, strategy);
159 /* windowBits is passed < 0 to suppress zlib header */
161 s->stream.next_out = s->outbuf = (Byte*)ALLOC(Z_BUFSIZE);
162 #endif
163 if (err != Z_OK || s->outbuf == Z_NULL) {
164 return destroy(s), (gzFile)Z_NULL;
166 } else {
167 s->stream.next_in = s->inbuf = (Byte*)ALLOC(Z_BUFSIZE);
169 err = inflateInit2(&(s->stream), -MAX_WBITS);
170 /* windowBits is passed < 0 to tell that there is no zlib header.
171 * Note that in this case inflate *requires* an extra "dummy" byte
172 * after the compressed stream in order to complete decompression and
173 * return Z_STREAM_END. Here the gzip CRC32 ensures that 4 bytes are
174 * present after the compressed stream.
176 if (err != Z_OK || s->inbuf == Z_NULL) {
177 return destroy(s), (gzFile)Z_NULL;
180 s->stream.avail_out = Z_BUFSIZE;
182 errno = 0;
183 s->file = fd < 0 ? F_OPEN(path, fmode) : (FILE*)fdopen(fd, fmode);
185 if (s->file == NULL) {
186 return destroy(s), (gzFile)Z_NULL;
188 if (s->mode == 'w') {
189 /* Write a very simple .gz header:
191 fprintf(s->file, "%c%c%c%c%c%c%c%c%c%c", gz_magic[0], gz_magic[1],
192 Z_DEFLATED, 0 /*flags*/, 0,0,0,0 /*time*/, 0 /*xflags*/, OS_CODE);
193 s->start = 10L;
194 /* We use 10L instead of ftell(s->file) to because ftell causes an
195 * fflush on some systems. This version of the library doesn't use
196 * start anyway in write mode, so this initialization is not
197 * necessary.
199 } else {
200 check_header(s); /* skip the .gz header */
201 s->start = ftell(s->file) - s->stream.avail_in;
204 return (gzFile)s;
207 /* ===========================================================================
208 Opens a gzip (.gz) file for reading or writing.
210 gzFile ZEXPORT gzopen (path, mode)
211 const char *path;
212 const char *mode;
214 return gz_open (path, mode, -1);
217 /* ===========================================================================
218 Associate a gzFile with the file descriptor fd. fd is not dup'ed here
219 to mimic the behavio(u)r of fdopen.
221 gzFile ZEXPORT gzdopen (fd, mode)
222 int fd;
223 const char *mode;
225 char name[46]; /* allow for up to 128-bit integers */
227 if (fd < 0) return (gzFile)Z_NULL;
228 sprintf(name, "<fd:%d>", fd); /* for debugging */
230 return gz_open (name, mode, fd);
233 /* ===========================================================================
234 * Update the compression level and strategy
236 int ZEXPORT gzsetparams (file, level, strategy)
237 gzFile file;
238 int level;
239 int strategy;
241 gz_stream *s = (gz_stream*)file;
243 if (s == NULL || s->mode != 'w') return Z_STREAM_ERROR;
245 /* Make room to allow flushing */
246 if (s->stream.avail_out == 0) {
248 s->stream.next_out = s->outbuf;
249 if (fwrite(s->outbuf, 1, Z_BUFSIZE, s->file) != Z_BUFSIZE) {
250 s->z_err = Z_ERRNO;
252 s->stream.avail_out = Z_BUFSIZE;
255 return deflateParams (&(s->stream), level, strategy);
258 /* ===========================================================================
259 Read a byte from a gz_stream; update next_in and avail_in. Return EOF
260 for end of file.
261 IN assertion: the stream s has been sucessfully opened for reading.
263 local int get_byte(s)
264 gz_stream *s;
266 if (s->z_eof) return EOF;
267 if (s->stream.avail_in == 0) {
268 errno = 0;
269 s->stream.avail_in = (uInt)fread(s->inbuf, 1, Z_BUFSIZE, s->file);
270 if (s->stream.avail_in == 0) {
271 s->z_eof = 1;
272 if (ferror(s->file)) s->z_err = Z_ERRNO;
273 return EOF;
275 s->stream.next_in = s->inbuf;
277 s->stream.avail_in--;
278 return *(s->stream.next_in)++;
281 /* ===========================================================================
282 Check the gzip header of a gz_stream opened for reading. Set the stream
283 mode to transparent if the gzip magic header is not present; set s->err
284 to Z_DATA_ERROR if the magic header is present but the rest of the header
285 is incorrect.
286 IN assertion: the stream s has already been created sucessfully;
287 s->stream.avail_in is zero for the first time, but may be non-zero
288 for concatenated .gz files.
290 local void check_header(s)
291 gz_stream *s;
293 int method; /* method byte */
294 int flags; /* flags byte */
295 uInt len;
296 int c;
298 /* Assure two bytes in the buffer so we can peek ahead -- handle case
299 where first byte of header is at the end of the buffer after the last
300 gzip segment */
301 len = s->stream.avail_in;
302 if (len < 2) {
303 if (len) s->inbuf[0] = s->stream.next_in[0];
304 errno = 0;
305 len = (uInt)fread(s->inbuf + len, 1, (size_t)(Z_BUFSIZE >> len),
306 s->file);
307 if (len == 0 && ferror(s->file)) s->z_err = Z_ERRNO;
308 s->stream.avail_in += len;
309 s->stream.next_in = s->inbuf;
310 if (s->stream.avail_in < 2) {
311 s->transparent = s->stream.avail_in;
312 return;
316 /* Peek ahead to check the gzip magic header */
317 if (s->stream.next_in[0] != gz_magic[0] ||
318 s->stream.next_in[1] != gz_magic[1]) {
319 s->transparent = 1;
320 return;
322 s->stream.avail_in -= 2;
323 s->stream.next_in += 2;
325 /* Check the rest of the gzip header */
326 method = get_byte(s);
327 flags = get_byte(s);
328 if (method != Z_DEFLATED || (flags & RESERVED) != 0) {
329 s->z_err = Z_DATA_ERROR;
330 return;
333 /* Discard time, xflags and OS code: */
334 for (len = 0; len < 6; len++) (void)get_byte(s);
336 if ((flags & EXTRA_FIELD) != 0) { /* skip the extra field */
337 len = (uInt)get_byte(s);
338 len += ((uInt)get_byte(s))<<8;
339 /* len is garbage if EOF but the loop below will quit anyway */
340 while (len-- != 0 && get_byte(s) != EOF) ;
342 if ((flags & ORIG_NAME) != 0) { /* skip the original file name */
343 while ((c = get_byte(s)) != 0 && c != EOF) ;
345 if ((flags & COMMENT) != 0) { /* skip the .gz file comment */
346 while ((c = get_byte(s)) != 0 && c != EOF) ;
348 if ((flags & HEAD_CRC) != 0) { /* skip the header crc */
349 for (len = 0; len < 2; len++) (void)get_byte(s);
351 s->z_err = s->z_eof ? Z_DATA_ERROR : Z_OK;
354 /* ===========================================================================
355 * Cleanup then free the given gz_stream. Return a zlib error code.
356 Try freeing in the reverse order of allocations.
358 local int destroy (s)
359 gz_stream *s;
361 int err = Z_OK;
363 if (!s) return Z_STREAM_ERROR;
365 TRYFREE(s->msg);
367 if (s->stream.state != NULL) {
368 if (s->mode == 'w') {
369 #ifdef NO_GZCOMPRESS
370 err = Z_STREAM_ERROR;
371 #else
372 err = deflateEnd(&(s->stream));
373 #endif
374 } else if (s->mode == 'r') {
375 err = inflateEnd(&(s->stream));
378 if (s->file != NULL && fclose(s->file)) {
379 #ifdef ESPIPE
380 if (errno != ESPIPE) /* fclose is broken for pipes in HP/UX */
381 #endif
382 err = Z_ERRNO;
384 if (s->z_err < 0) err = s->z_err;
386 TRYFREE(s->inbuf);
387 TRYFREE(s->outbuf);
388 TRYFREE(s->path);
389 TRYFREE(s);
390 return err;
393 /* ===========================================================================
394 Reads the given number of uncompressed bytes from the compressed file.
395 gzread returns the number of bytes actually read (0 for end of file).
397 int ZEXPORT gzread (file, buf, len)
398 gzFile file;
399 voidp buf;
400 unsigned len;
402 gz_stream *s = (gz_stream*)file;
403 Bytef *start = (Bytef*)buf; /* starting point for crc computation */
404 Byte *next_out; /* == stream.next_out but not forced far (for MSDOS) */
406 if (s == NULL || s->mode != 'r') return Z_STREAM_ERROR;
408 if (s->z_err == Z_DATA_ERROR || s->z_err == Z_ERRNO) return -1;
409 if (s->z_err == Z_STREAM_END) return 0; /* EOF */
411 next_out = (Byte*)buf;
412 s->stream.next_out = (Bytef*)buf;
413 s->stream.avail_out = len;
415 if (s->stream.avail_out && s->back != EOF) {
416 *next_out++ = s->back;
417 s->stream.next_out++;
418 s->stream.avail_out--;
419 s->back = EOF;
420 s->out++;
421 start++;
422 if (s->last) {
423 s->z_err = Z_STREAM_END;
424 return 1;
428 while (s->stream.avail_out != 0) {
430 if (s->transparent) {
431 /* Copy first the lookahead bytes: */
432 uInt n = s->stream.avail_in;
433 if (n > s->stream.avail_out) n = s->stream.avail_out;
434 if (n > 0) {
435 zmemcpy(s->stream.next_out, s->stream.next_in, n);
436 next_out += n;
437 s->stream.next_out = next_out;
438 s->stream.next_in += n;
439 s->stream.avail_out -= n;
440 s->stream.avail_in -= n;
442 if (s->stream.avail_out > 0) {
443 s->stream.avail_out -=
444 (uInt)fread(next_out, 1, s->stream.avail_out, s->file);
446 len -= s->stream.avail_out;
447 s->in += len;
448 s->out += len;
449 if (len == 0) s->z_eof = 1;
450 return (int)len;
452 if (s->stream.avail_in == 0 && !s->z_eof) {
454 errno = 0;
455 s->stream.avail_in = (uInt)fread(s->inbuf, 1, Z_BUFSIZE, s->file);
456 if (s->stream.avail_in == 0) {
457 s->z_eof = 1;
458 if (ferror(s->file)) {
459 s->z_err = Z_ERRNO;
460 break;
463 s->stream.next_in = s->inbuf;
465 s->in += s->stream.avail_in;
466 s->out += s->stream.avail_out;
467 s->z_err = inflate(&(s->stream), Z_NO_FLUSH);
468 s->in -= s->stream.avail_in;
469 s->out -= s->stream.avail_out;
471 if (s->z_err == Z_STREAM_END) {
472 /* Check CRC and original size */
473 s->crc = crc32(s->crc, start, (uInt)(s->stream.next_out - start));
474 start = s->stream.next_out;
476 if (getLong(s) != s->crc) {
477 s->z_err = Z_DATA_ERROR;
478 } else {
479 (void)getLong(s);
480 /* The uncompressed length returned by above getlong() may be
481 * different from s->out in case of concatenated .gz files.
482 * Check for such files:
484 check_header(s);
485 if (s->z_err == Z_OK) {
486 inflateReset(&(s->stream));
487 s->crc = crc32(0L, Z_NULL, 0);
491 if (s->z_err != Z_OK || s->z_eof) break;
493 s->crc = crc32(s->crc, start, (uInt)(s->stream.next_out - start));
495 if (len == s->stream.avail_out &&
496 (s->z_err == Z_DATA_ERROR || s->z_err == Z_ERRNO))
497 return -1;
498 return (int)(len - s->stream.avail_out);
502 /* ===========================================================================
503 Reads one byte from the compressed file. gzgetc returns this byte
504 or -1 in case of end of file or error.
506 int ZEXPORT gzgetc(file)
507 gzFile file;
509 unsigned char c;
511 return gzread(file, &c, 1) == 1 ? c : -1;
515 /* ===========================================================================
516 Push one byte back onto the stream.
518 int ZEXPORT gzungetc(c, file)
519 int c;
520 gzFile file;
522 gz_stream *s = (gz_stream*)file;
524 if (s == NULL || s->mode != 'r' || c == EOF || s->back != EOF) return EOF;
525 s->back = c;
526 s->out--;
527 s->last = (s->z_err == Z_STREAM_END);
528 if (s->last) s->z_err = Z_OK;
529 s->z_eof = 0;
530 return c;
534 /* ===========================================================================
535 Reads bytes from the compressed file until len-1 characters are
536 read, or a newline character is read and transferred to buf, or an
537 end-of-file condition is encountered. The string is then terminated
538 with a null character.
539 gzgets returns buf, or Z_NULL in case of error.
541 The current implementation is not optimized at all.
543 char * ZEXPORT gzgets(file, buf, len)
544 gzFile file;
545 char *buf;
546 int len;
548 char *b = buf;
549 if (buf == Z_NULL || len <= 0) return Z_NULL;
551 while (--len > 0 && gzread(file, buf, 1) == 1 && *buf++ != '\n') ;
552 *buf = '\0';
553 return b == buf && len > 0 ? Z_NULL : b;
557 #ifndef NO_GZCOMPRESS
558 /* ===========================================================================
559 Writes the given number of uncompressed bytes into the compressed file.
560 gzwrite returns the number of bytes actually written (0 in case of error).
562 int ZEXPORT gzwrite (file, buf, len)
563 gzFile file;
564 voidpc buf;
565 unsigned len;
567 gz_stream *s = (gz_stream*)file;
569 if (s == NULL || s->mode != 'w') return Z_STREAM_ERROR;
571 s->stream.next_in = __UNCONST(buf);
572 s->stream.avail_in = len;
574 while (s->stream.avail_in != 0) {
576 if (s->stream.avail_out == 0) {
578 s->stream.next_out = s->outbuf;
579 if (fwrite(s->outbuf, 1, Z_BUFSIZE, s->file) != Z_BUFSIZE) {
580 s->z_err = Z_ERRNO;
581 break;
583 s->stream.avail_out = Z_BUFSIZE;
585 s->in += s->stream.avail_in;
586 s->out += s->stream.avail_out;
587 s->z_err = deflate(&(s->stream), Z_NO_FLUSH);
588 s->in -= s->stream.avail_in;
589 s->out -= s->stream.avail_out;
590 if (s->z_err != Z_OK) break;
592 s->crc = crc32(s->crc, (const Bytef *)buf, len);
594 return (int)(len - s->stream.avail_in);
598 /* ===========================================================================
599 Converts, formats, and writes the args to the compressed file under
600 control of the format string, as in fprintf. gzprintf returns the number of
601 uncompressed bytes actually written (0 in case of error).
603 #ifdef STDC
604 #include <stdarg.h>
606 int ZEXPORTVA gzprintf (gzFile file, const char *format, /* args */ ...)
608 char buf[Z_PRINTF_BUFSIZE];
609 va_list va;
610 int len;
612 buf[sizeof(buf) - 1] = 0;
613 va_start(va, format);
614 #ifdef NO_vsnprintf
615 # ifdef HAS_vsprintf_void
616 (void)vsprintf(buf, format, va);
617 va_end(va);
618 for (len = 0; len < sizeof(buf); len++)
619 if (buf[len] == 0) break;
620 # else
621 len = vsprintf(buf, format, va);
622 va_end(va);
623 # endif
624 #else
625 # ifdef HAS_vsnprintf_void
626 (void)vsnprintf(buf, sizeof(buf), format, va);
627 va_end(va);
628 len = strlen(buf);
629 # else
630 len = vsnprintf(buf, sizeof(buf), format, va);
631 va_end(va);
632 # endif
633 #endif
634 if (len <= 0 || len >= (int)sizeof(buf) || buf[sizeof(buf) - 1] != 0)
635 return 0;
636 return gzwrite(file, buf, (unsigned)len);
638 #else /* not ANSI C */
640 int ZEXPORTVA gzprintf (file, format, a1, a2, a3, a4, a5, a6, a7, a8, a9, a10,
641 a11, a12, a13, a14, a15, a16, a17, a18, a19, a20)
642 gzFile file;
643 const char *format;
644 int a1, a2, a3, a4, a5, a6, a7, a8, a9, a10,
645 a11, a12, a13, a14, a15, a16, a17, a18, a19, a20;
647 char buf[Z_PRINTF_BUFSIZE];
648 int len;
650 buf[sizeof(buf) - 1] = 0;
651 #ifdef NO_snprintf
652 # ifdef HAS_sprintf_void
653 sprintf(buf, format, a1, a2, a3, a4, a5, a6, a7, a8,
654 a9, a10, a11, a12, a13, a14, a15, a16, a17, a18, a19, a20);
655 for (len = 0; len < sizeof(buf); len++)
656 if (buf[len] == 0) break;
657 # else
658 len = sprintf(buf, format, a1, a2, a3, a4, a5, a6, a7, a8,
659 a9, a10, a11, a12, a13, a14, a15, a16, a17, a18, a19, a20);
660 # endif
661 #else
662 # ifdef HAS_snprintf_void
663 snprintf(buf, sizeof(buf), format, a1, a2, a3, a4, a5, a6, a7, a8,
664 a9, a10, a11, a12, a13, a14, a15, a16, a17, a18, a19, a20);
665 len = strlen(buf);
666 # else
667 len = snprintf(buf, sizeof(buf), format, a1, a2, a3, a4, a5, a6, a7, a8,
668 a9, a10, a11, a12, a13, a14, a15, a16, a17, a18, a19, a20);
669 # endif
670 #endif
671 if (len <= 0 || len >= sizeof(buf) || buf[sizeof(buf) - 1] != 0)
672 return 0;
673 return gzwrite(file, buf, len);
675 #endif
677 /* ===========================================================================
678 Writes c, converted to an unsigned char, into the compressed file.
679 gzputc returns the value that was written, or -1 in case of error.
681 int ZEXPORT gzputc(file, c)
682 gzFile file;
683 int c;
685 unsigned char cc = (unsigned char) c; /* required for big endian systems */
687 return gzwrite(file, &cc, 1) == 1 ? (int)cc : -1;
691 /* ===========================================================================
692 Writes the given null-terminated string to the compressed file, excluding
693 the terminating null character.
694 gzputs returns the number of characters written, or -1 in case of error.
696 int ZEXPORT gzputs(file, s)
697 gzFile file;
698 const char *s;
700 return gzwrite(file, __UNCONST(s), (unsigned)strlen(s));
704 /* ===========================================================================
705 Flushes all pending output into the compressed file. The parameter
706 flush is as in the deflate() function.
708 local int do_flush (file, flush)
709 gzFile file;
710 int flush;
712 uInt len;
713 int done = 0;
714 gz_stream *s = (gz_stream*)file;
716 if (s == NULL || s->mode != 'w') return Z_STREAM_ERROR;
718 s->stream.avail_in = 0; /* should be zero already anyway */
720 for (;;) {
721 len = Z_BUFSIZE - s->stream.avail_out;
723 if (len != 0) {
724 if ((uInt)fwrite(s->outbuf, 1, len, s->file) != len) {
725 s->z_err = Z_ERRNO;
726 return Z_ERRNO;
728 s->stream.next_out = s->outbuf;
729 s->stream.avail_out = Z_BUFSIZE;
731 if (done) break;
732 s->out += s->stream.avail_out;
733 s->z_err = deflate(&(s->stream), flush);
734 s->out -= s->stream.avail_out;
736 /* Ignore the second of two consecutive flushes: */
737 if (len == 0 && s->z_err == Z_BUF_ERROR) s->z_err = Z_OK;
739 /* deflate has finished flushing only when it hasn't used up
740 * all the available space in the output buffer:
742 done = (s->stream.avail_out != 0 || s->z_err == Z_STREAM_END);
744 if (s->z_err != Z_OK && s->z_err != Z_STREAM_END) break;
746 return s->z_err == Z_STREAM_END ? Z_OK : s->z_err;
749 int ZEXPORT gzflush (file, flush)
750 gzFile file;
751 int flush;
753 gz_stream *s = (gz_stream*)file;
754 int err = do_flush (file, flush);
756 if (err) return err;
757 fflush(s->file);
758 return s->z_err == Z_STREAM_END ? Z_OK : s->z_err;
760 #endif /* NO_GZCOMPRESS */
762 /* ===========================================================================
763 Sets the starting position for the next gzread or gzwrite on the given
764 compressed file. The offset represents a number of bytes in the
765 gzseek returns the resulting offset location as measured in bytes from
766 the beginning of the uncompressed stream, or -1 in case of error.
767 SEEK_END is not implemented, returns error.
768 In this version of the library, gzseek can be extremely slow.
770 z_off_t ZEXPORT gzseek (file, offset, whence)
771 gzFile file;
772 z_off_t offset;
773 int whence;
775 gz_stream *s = (gz_stream*)file;
777 if (s == NULL || whence == SEEK_END ||
778 s->z_err == Z_ERRNO || s->z_err == Z_DATA_ERROR) {
779 return -1L;
782 if (s->mode == 'w') {
783 #ifdef NO_GZCOMPRESS
784 return -1L;
785 #else
786 if (whence == SEEK_SET) {
787 offset -= s->in;
789 if (offset < 0) return -1L;
791 /* At this point, offset is the number of zero bytes to write. */
792 if (s->inbuf == Z_NULL) {
793 s->inbuf = (Byte*)ALLOC(Z_BUFSIZE); /* for seeking */
794 if (s->inbuf == Z_NULL) return -1L;
795 zmemzero(s->inbuf, Z_BUFSIZE);
797 while (offset > 0) {
798 uInt size = Z_BUFSIZE;
799 if (offset < Z_BUFSIZE) size = (uInt)offset;
801 size = gzwrite(file, s->inbuf, size);
802 if (size == 0) return -1L;
804 offset -= size;
806 return s->in;
807 #endif
809 /* Rest of function is for reading only */
811 /* compute absolute position */
812 if (whence == SEEK_CUR) {
813 offset += s->out;
815 if (offset < 0) return -1L;
817 if (s->transparent) {
818 /* map to fseek */
819 s->back = EOF;
820 s->stream.avail_in = 0;
821 s->stream.next_in = s->inbuf;
822 if (fseek(s->file, offset, SEEK_SET) < 0) return -1L;
824 s->in = s->out = offset;
825 return offset;
828 /* For a negative seek, rewind and use positive seek */
829 if (offset >= s->out) {
830 offset -= s->out;
831 } else if (gzrewind(file) < 0) {
832 return -1L;
834 /* offset is now the number of bytes to skip. */
836 if (offset != 0 && s->outbuf == Z_NULL) {
837 s->outbuf = (Byte*)ALLOC(Z_BUFSIZE);
838 if (s->outbuf == Z_NULL) return -1L;
840 if (offset && s->back != EOF) {
841 s->back = EOF;
842 s->out++;
843 offset--;
844 if (s->last) s->z_err = Z_STREAM_END;
846 while (offset > 0) {
847 int size = Z_BUFSIZE;
848 if (offset < Z_BUFSIZE) size = (int)offset;
850 size = gzread(file, s->outbuf, (uInt)size);
851 if (size <= 0) return -1L;
852 offset -= size;
854 return s->out;
857 /* ===========================================================================
858 Rewinds input file.
860 int ZEXPORT gzrewind (file)
861 gzFile file;
863 gz_stream *s = (gz_stream*)file;
865 if (s == NULL || s->mode != 'r') return -1;
867 s->z_err = Z_OK;
868 s->z_eof = 0;
869 s->back = EOF;
870 s->stream.avail_in = 0;
871 s->stream.next_in = s->inbuf;
872 s->crc = crc32(0L, Z_NULL, 0);
873 if (!s->transparent) (void)inflateReset(&s->stream);
874 s->in = 0;
875 s->out = 0;
876 return fseek(s->file, s->start, SEEK_SET);
879 /* ===========================================================================
880 Returns the starting position for the next gzread or gzwrite on the
881 given compressed file. This position represents a number of bytes in the
882 uncompressed data stream.
884 z_off_t ZEXPORT gztell (file)
885 gzFile file;
887 return gzseek(file, 0L, SEEK_CUR);
890 /* ===========================================================================
891 Returns 1 when EOF has previously been detected reading the given
892 input stream, otherwise zero.
894 int ZEXPORT gzeof (file)
895 gzFile file;
897 gz_stream *s = (gz_stream*)file;
899 /* With concatenated compressed files that can have embedded
900 * crc trailers, z_eof is no longer the only/best indicator of EOF
901 * on a gz_stream. Handle end-of-stream error explicitly here.
903 if (s == NULL || s->mode != 'r') return 0;
904 if (s->z_eof) return 1;
905 return s->z_err == Z_STREAM_END;
908 /* ===========================================================================
909 Returns 1 if reading and doing so transparently, otherwise zero.
911 int ZEXPORT gzdirect (file)
912 gzFile file;
914 gz_stream *s = (gz_stream*)file;
916 if (s == NULL || s->mode != 'r') return 0;
917 return s->transparent;
920 /* ===========================================================================
921 Outputs a long in LSB order to the given file
923 local void putLong (file, x)
924 FILE *file;
925 uLong x;
927 int n;
928 for (n = 0; n < 4; n++) {
929 fputc((int)(x & 0xff), file);
930 x >>= 8;
934 /* ===========================================================================
935 Reads a long in LSB order from the given gz_stream. Sets z_err in case
936 of error.
938 local uLong getLong (s)
939 gz_stream *s;
941 uLong x = (uLong)get_byte(s);
942 int c;
944 x += ((uLong)get_byte(s))<<8;
945 x += ((uLong)get_byte(s))<<16;
946 c = get_byte(s);
947 if (c == EOF) s->z_err = Z_DATA_ERROR;
948 x += ((uLong)c)<<24;
949 return x;
952 /* ===========================================================================
953 Flushes all pending output if necessary, closes the compressed file
954 and deallocates all the (de)compression state.
956 int ZEXPORT gzclose (file)
957 gzFile file;
959 gz_stream *s = (gz_stream*)file;
961 if (s == NULL) return Z_STREAM_ERROR;
963 if (s->mode == 'w') {
964 #ifdef NO_GZCOMPRESS
965 return Z_STREAM_ERROR;
966 #else
967 if (do_flush (file, Z_FINISH) != Z_OK)
968 return destroy((gz_stream*)file);
970 putLong (s->file, s->crc);
971 putLong (s->file, (uLong)(s->in & 0xffffffff));
972 #endif
974 return destroy((gz_stream*)file);
977 #ifdef STDC
978 # define zstrerror(errnum) strerror(errnum)
979 #else
980 # define zstrerror(errnum) ""
981 #endif
983 /* ===========================================================================
984 Returns the error message for the last error which occurred on the
985 given compressed file. errnum is set to zlib error number. If an
986 error occurred in the file system and not in the compression library,
987 errnum is set to Z_ERRNO and the application may consult errno
988 to get the exact error code.
990 const char * ZEXPORT gzerror (file, errnum)
991 gzFile file;
992 int *errnum;
994 const char *m;
995 gz_stream *s = (gz_stream*)file;
997 if (s == NULL) {
998 *errnum = Z_STREAM_ERROR;
999 return (const char*)ERR_MSG(Z_STREAM_ERROR);
1001 *errnum = s->z_err;
1002 if (*errnum == Z_OK) return (const char*)"";
1004 m = *errnum == Z_ERRNO ? zstrerror(errno) : s->stream.msg;
1006 if (m == NULL || *m == '\0') m = ERR_MSG(s->z_err);
1008 TRYFREE(s->msg);
1009 s->msg = (char*)ALLOC(strlen(s->path) + strlen(m) + 3);
1010 if (s->msg == Z_NULL) return ERR_MSG(Z_MEM_ERROR);
1011 strcpy(s->msg, s->path);
1012 strcat(s->msg, ": ");
1013 strcat(s->msg, m);
1014 return (const char*)s->msg;
1017 /* ===========================================================================
1018 Clear the error and end-of-file flags, and do the same for the real file.
1020 void ZEXPORT gzclearerr (file)
1021 gzFile file;
1023 gz_stream *s = (gz_stream*)file;
1025 if (s == NULL) return;
1026 if (s->z_err != Z_STREAM_END) s->z_err = Z_OK;
1027 s->z_eof = 0;
1028 clearerr(s->file);