First public contribution.
1 /* gzio.c -- IO on .gz files
2 * Copyright (C) 1995-1998 Jean-loup Gailly.
3 * For conditions of distribution and use, see copyright notice in zlib.h
5 * Compile this file with -DNO_DEFLATE to avoid the compression code.
14 struct internal_state {int dummy;}; /* for buggy compilers */
18 # define Z_BUFSIZE 4096 /* minimize memory usage for 16-bit DOS */
20 # define Z_BUFSIZE 16384
23 #ifndef Z_PRINTF_BUFSIZE
24 # define Z_PRINTF_BUFSIZE 4096
27 #define ALLOC(size) malloc(size)
28 #define TRYFREE(p) {if (p) free(p);}
30 static int gz_magic[2] = {0x1f, 0x8b}; /* gzip magic header */
33 #define ASCII_FLAG 0x01 /* bit 0 set: file probably ascii text */
34 #define HEAD_CRC 0x02 /* bit 1 set: header CRC present */
35 #define EXTRA_FIELD 0x04 /* bit 2 set: extra field present */
36 #define ORIG_NAME 0x08 /* bit 3 set: original file name present */
37 #define COMMENT 0x10 /* bit 4 set: file comment present */
38 #define RESERVED 0xE0 /* bits 5..7: reserved */
40 typedef struct gz_stream {
42 int z_err; /* error code for last stream operation */
43 int z_eof; /* set if end of input file */
44 FILE *file; /* .gz file */
45 Byte *inbuf; /* input buffer */
46 Byte *outbuf; /* output buffer */
47 uLong crc; /* crc32 of uncompressed data */
48 char *msg; /* error message */
49 char *path; /* path name for debugging only */
50 int transparent; /* 1 if input file is not a .gz file */
51 char mode; /* 'w' or 'r' */
52 long startpos; /* start of compressed data in file (header skipped) */
56 local gzFile gz_open OF((const char *path, const char *mode, int fd));
57 local int do_flush OF((gzFile file, int flush));
58 local int get_byte OF((gz_stream *s));
59 local void check_header OF((gz_stream *s));
60 local int destroy OF((gz_stream *s));
61 local void putLong OF((FILE *file, uLong x));
62 local uLong getLong OF((gz_stream *s));
64 /* ===========================================================================
65 Opens a gzip (.gz) file for reading or writing. The mode parameter
66 is as in fopen ("rb" or "wb"). The file is given either by file descriptor
67 or path name (if fd == -1).
68 gz_open return NULL if the file could not be opened or if there was
69 insufficient memory to allocate the (de)compression state; errno
70 can be checked to distinguish the two cases (if errno is zero, the
71 zlib error is Z_MEM_ERROR).
73 local gzFile gz_open (const char *path, const char *mode, int fd)
76 int level = Z_DEFAULT_COMPRESSION; /* compression level */
77 int strategy = Z_DEFAULT_STRATEGY; /* compression strategy */
78 char *p = (char*)mode;
80 char fmode[80]; /* copy of mode, without the compression level */
83 if (!path || !mode) return Z_NULL;
85 s = (gz_stream *)ALLOC(sizeof(gz_stream));
86 if (!s) return Z_NULL;
88 s->stream.zalloc = (alloc_func)0;
89 s->stream.zfree = (free_func)0;
90 s->stream.opaque = (voidpf)0;
91 s->stream.next_in = s->inbuf = Z_NULL;
92 s->stream.next_out = s->outbuf = Z_NULL;
93 s->stream.avail_in = s->stream.avail_out = 0;
97 s->crc = crc32(0L, Z_NULL, 0);
101 s->path = (char*)ALLOC(strlen(path)+1);
102 if (s->path == NULL) {
103 return destroy(s), (gzFile)Z_NULL;
105 strcpy(s->path, path); /* do this early for debugging */
109 if (*p == 'r') s->mode = 'r';
110 if (*p == 'w' || *p == 'a') s->mode = 'w';
111 if (*p >= '0' && *p <= '9') {
113 } else if (*p == 'f') {
114 strategy = Z_FILTERED;
115 } else if (*p == 'h') {
116 strategy = Z_HUFFMAN_ONLY;
118 *m++ = *p; /* copy the mode */
120 } while (*p++ && m != fmode + sizeof(fmode));
121 if (s->mode == '\0') return destroy(s), (gzFile)Z_NULL;
123 if (s->mode == 'w') {
125 err = Z_STREAM_ERROR;
127 err = deflateInit2(&(s->stream), level,
128 Z_DEFLATED, -MAX_WBITS, DEF_MEM_LEVEL, strategy);
129 /* windowBits is passed < 0 to suppress zlib header */
131 s->stream.next_out = s->outbuf = (Byte*)ALLOC(Z_BUFSIZE);
133 if (err != Z_OK || s->outbuf == Z_NULL) {
134 return destroy(s), (gzFile)Z_NULL;
137 s->stream.next_in = s->inbuf = (Byte*)ALLOC(Z_BUFSIZE);
139 err = inflateInit2(&(s->stream), -MAX_WBITS);
140 /* windowBits is passed < 0 to tell that there is no zlib header.
141 * Note that in this case inflate *requires* an extra "dummy" byte
142 * after the compressed stream in order to complete decompression and
143 * return Z_STREAM_END. Here the gzip CRC32 ensures that 4 bytes are
144 * present after the compressed stream.
146 if (err != Z_OK || s->inbuf == Z_NULL) {
147 return destroy(s), (gzFile)Z_NULL;
150 s->stream.avail_out = Z_BUFSIZE;
153 s->file = fd < 0 ? F_OPEN(path, fmode) : (FILE*)fdopen(fd, fmode);
155 if (s->file == NULL) {
156 return destroy(s), (gzFile)Z_NULL;
158 if (s->mode == 'w') {
159 /* Write a very simple .gz header:
161 fprintf(s->file, "%c%c%c%c%c%c%c%c%c%c", gz_magic[0], gz_magic[1],
162 Z_DEFLATED, 0 /*flags*/, 0,0,0,0 /*time*/, 0 /*xflags*/, OS_CODE);
164 /* We use 10L instead of ftell(s->file) to because ftell causes an
165 * fflush on some systems. This version of the library doesn't use
166 * startpos anyway in write mode, so this initialization is not
170 check_header(s); /* skip the .gz header */
171 s->startpos = (ftell(s->file) - s->stream.avail_in);
177 /* ===========================================================================
178 Opens a gzip (.gz) file for reading or writing.
180 gzFile ZEXPORT gzopen (const char *path, const char *mode)
182 return gz_open (path, mode, -1);
185 /* ===========================================================================
186 Associate a gzFile with the file descriptor fd. fd is not dup'ed here
187 to mimic the behavio(u)r of fdopen.
189 gzFile ZEXPORT gzdopen (int fd, const char *mode)
193 if (fd < 0) return (gzFile)Z_NULL;
194 sprintf(name, "<fd:%d>", fd); /* for debugging */
196 return gz_open (name, mode, fd);
199 /* ===========================================================================
200 * Update the compression level and strategy
202 int ZEXPORT gzsetparams (gzFile file, int level, int strategy)
204 gz_stream *s = (gz_stream*)file;
206 if (s == NULL || s->mode != 'w') return Z_STREAM_ERROR;
208 /* Make room to allow flushing */
209 if (s->stream.avail_out == 0) {
211 s->stream.next_out = s->outbuf;
212 if (fwrite(s->outbuf, 1, Z_BUFSIZE, s->file) != Z_BUFSIZE) {
215 s->stream.avail_out = Z_BUFSIZE;
218 return deflateParams (&(s->stream), level, strategy);
221 /* ===========================================================================
222 Read a byte from a gz_stream; update next_in and avail_in. Return EOF
224 IN assertion: the stream s has been sucessfully opened for reading.
226 local int get_byte(gz_stream *s)
228 if (s->z_eof) return EOF;
229 if (s->stream.avail_in == 0) {
231 s->stream.avail_in = fread(s->inbuf, 1, Z_BUFSIZE, s->file);
232 if (s->stream.avail_in == 0) {
234 if (ferror(s->file)) s->z_err = Z_ERRNO;
237 s->stream.next_in = s->inbuf;
239 s->stream.avail_in--;
240 return *(s->stream.next_in)++;
243 /* ===========================================================================
244 Check the gzip header of a gz_stream opened for reading. Set the stream
245 mode to transparent if the gzip magic header is not present; set s->err
246 to Z_DATA_ERROR if the magic header is present but the rest of the header
248 IN assertion: the stream s has already been created sucessfully;
249 s->stream.avail_in is zero for the first time, but may be non-zero
250 for concatenated .gz files.
252 local void check_header(gz_stream *s)
254 int method; /* method byte */
255 int flags; /* flags byte */
259 /* Check the gzip magic header */
260 for (len = 0; len < 2; len++) {
262 if (c != gz_magic[len]) {
263 if (len != 0) s->stream.avail_in++, s->stream.next_in--;
265 s->stream.avail_in++, s->stream.next_in--;
268 s->z_err = s->stream.avail_in != 0 ? Z_OK : Z_STREAM_END;
272 method = get_byte(s);
274 if (method != Z_DEFLATED || (flags & RESERVED) != 0) {
275 s->z_err = Z_DATA_ERROR;
279 /* Discard time, xflags and OS code: */
280 for (len = 0; len < 6; len++) (void)get_byte(s);
282 if ((flags & EXTRA_FIELD) != 0) { /* skip the extra field */
283 len = (uInt)get_byte(s);
284 len += ((uInt)get_byte(s))<<8;
285 /* len is garbage if EOF but the loop below will quit anyway */
286 while (len-- != 0 && get_byte(s) != EOF) ;
288 if ((flags & ORIG_NAME) != 0) { /* skip the original file name */
289 while ((c = get_byte(s)) != 0 && c != EOF) ;
291 if ((flags & COMMENT) != 0) { /* skip the .gz file comment */
292 while ((c = get_byte(s)) != 0 && c != EOF) ;
294 if ((flags & HEAD_CRC) != 0) { /* skip the header crc */
295 for (len = 0; len < 2; len++) (void)get_byte(s);
297 s->z_err = s->z_eof ? Z_DATA_ERROR : Z_OK;
300 /* ===========================================================================
301 * Cleanup then free the given gz_stream. Return a zlib error code.
302 Try freeing in the reverse order of allocations.
304 local int destroy (gz_stream *s)
308 if (!s) return Z_STREAM_ERROR;
312 if (s->stream.state != NULL) {
313 if (s->mode == 'w') {
315 err = Z_STREAM_ERROR;
317 err = deflateEnd(&(s->stream));
319 } else if (s->mode == 'r') {
320 err = inflateEnd(&(s->stream));
323 if (s->file != NULL && fclose(s->file)) {
325 if (errno != ESPIPE) /* fclose is broken for pipes in HP/UX */
329 if (s->z_err < 0) err = s->z_err;
338 /* ===========================================================================
339 Reads the given number of uncompressed bytes from the compressed file.
340 gzread returns the number of bytes actually read (0 for end of file).
342 int ZEXPORT gzread (gzFile file, voidp buf, unsigned len)
344 gz_stream *s = (gz_stream*)file;
345 Bytef *start = (Bytef*)buf; /* starting point for crc computation */
346 Byte *next_out; /* == stream.next_out but not forced far (for MSDOS) */
348 if (s == NULL || s->mode != 'r') return Z_STREAM_ERROR;
350 if (s->z_err == Z_DATA_ERROR || s->z_err == Z_ERRNO) return -1;
351 if (s->z_err == Z_STREAM_END) return 0; /* EOF */
353 next_out = (Byte*)buf;
354 s->stream.next_out = (Bytef*)buf;
355 s->stream.avail_out = len;
357 while (s->stream.avail_out != 0) {
359 if (s->transparent) {
360 /* Copy first the lookahead bytes: */
361 uInt n = s->stream.avail_in;
362 if (n > s->stream.avail_out) n = s->stream.avail_out;
364 zmemcpy(s->stream.next_out, s->stream.next_in, n);
366 s->stream.next_out = next_out;
367 s->stream.next_in += n;
368 s->stream.avail_out -= n;
369 s->stream.avail_in -= n;
371 if (s->stream.avail_out > 0) {
372 s->stream.avail_out -= fread(next_out, 1, s->stream.avail_out,
375 len -= s->stream.avail_out;
376 s->stream.total_in += (uLong)len;
377 s->stream.total_out += (uLong)len;
378 if (len == 0) s->z_eof = 1;
381 if (s->stream.avail_in == 0 && !s->z_eof) {
384 s->stream.avail_in = fread(s->inbuf, 1, Z_BUFSIZE, s->file);
385 if (s->stream.avail_in == 0) {
387 if (ferror(s->file)) {
392 s->stream.next_in = s->inbuf;
394 s->z_err = inflate(&(s->stream), Z_NO_FLUSH);
396 if (s->z_err == Z_STREAM_END) {
397 /* Check CRC and original size */
398 s->crc = crc32(s->crc, start, (uInt)(s->stream.next_out - start));
399 start = s->stream.next_out;
401 if (getLong(s) != s->crc) {
402 s->z_err = Z_DATA_ERROR;
405 /* The uncompressed length returned by above getlong() may
406 * be different from s->stream.total_out) in case of
407 * concatenated .gz files. Check for such files:
410 if (s->z_err == Z_OK) {
411 uLong total_in = s->stream.total_in;
412 uLong total_out = s->stream.total_out;
414 inflateReset(&(s->stream));
415 s->stream.total_in = total_in;
416 s->stream.total_out = total_out;
417 s->crc = crc32(0L, Z_NULL, 0);
421 if (s->z_err != Z_OK || s->z_eof) break;
423 s->crc = crc32(s->crc, start, (uInt)(s->stream.next_out - start));
425 return (int)(len - s->stream.avail_out);
429 /* ===========================================================================
430 Reads one byte from the compressed file. gzgetc returns this byte
431 or -1 in case of end of file or error.
433 int ZEXPORT gzgetc(gzFile file)
437 return gzread(file, &c, 1) == 1 ? c : -1;
441 /* ===========================================================================
442 Reads bytes from the compressed file until len-1 characters are
443 read, or a newline character is read and transferred to buf, or an
444 end-of-file condition is encountered. The string is then terminated
445 with a null character.
446 gzgets returns buf, or Z_NULL in case of error.
448 The current implementation is not optimized at all.
450 char * ZEXPORT gzgets(gzFile file, char *buf, int len)
453 if (buf == Z_NULL || len <= 0) return Z_NULL;
455 while (--len > 0 && gzread(file, buf, 1) == 1 && *buf++ != '\n') ;
457 return b == buf && len > 0 ? Z_NULL : b;
462 /* ===========================================================================
463 Writes the given number of uncompressed bytes into the compressed file.
464 gzwrite returns the number of bytes actually written (0 in case of error).
466 int ZEXPORT gzwrite (gzFile file, const voidp buf, unsigned len)
468 gz_stream *s = (gz_stream*)file;
470 if (s == NULL || s->mode != 'w') return Z_STREAM_ERROR;
472 s->stream.next_in = (Bytef*)buf;
473 s->stream.avail_in = len;
475 while (s->stream.avail_in != 0) {
477 if (s->stream.avail_out == 0) {
479 s->stream.next_out = s->outbuf;
480 if (fwrite(s->outbuf, 1, Z_BUFSIZE, s->file) != Z_BUFSIZE) {
484 s->stream.avail_out = Z_BUFSIZE;
486 s->z_err = deflate(&(s->stream), Z_NO_FLUSH);
487 if (s->z_err != Z_OK) break;
489 s->crc = crc32(s->crc, (const Bytef *)buf, len);
491 return (int)(len - s->stream.avail_in);
494 /* ===========================================================================
495 Converts, formats, and writes the args to the compressed file under
496 control of the format string, as in fprintf. gzprintf returns the number of
497 uncompressed bytes actually written (0 in case of error).
502 int ZEXPORTVA gzprintf (gzFile file, const char *format, /* args */ ...)
504 char buf[Z_PRINTF_BUFSIZE];
508 va_start(va, format);
510 (void)vsnprintf(buf, sizeof(buf), format, va);
512 (void)vsprintf(buf, format, va);
515 len = strlen(buf); /* some *sprintf don't return the nb of bytes written */
516 if (len <= 0) return 0;
518 return gzwrite(file, buf, (unsigned)len);
520 #else /* not ANSI C */
522 int ZEXPORTVA gzprintf (file, format, a1, a2, a3, a4, a5, a6, a7, a8, a9, a10,
523 a11, a12, a13, a14, a15, a16, a17, a18, a19, a20)
526 int a1, a2, a3, a4, a5, a6, a7, a8, a9, a10,
527 a11, a12, a13, a14, a15, a16, a17, a18, a19, a20;
529 char buf[Z_PRINTF_BUFSIZE];
533 snprintf(buf, sizeof(buf), format, a1, a2, a3, a4, a5, a6, a7, a8,
534 a9, a10, a11, a12, a13, a14, a15, a16, a17, a18, a19, a20);
536 sprintf(buf, format, a1, a2, a3, a4, a5, a6, a7, a8,
537 a9, a10, a11, a12, a13, a14, a15, a16, a17, a18, a19, a20);
539 len = strlen(buf); /* old sprintf doesn't return the nb of bytes written */
540 if (len <= 0) return 0;
542 return gzwrite(file, buf, len);
546 /* ===========================================================================
547 Writes c, converted to an unsigned char, into the compressed file.
548 gzputc returns the value that was written, or -1 in case of error.
550 int ZEXPORT gzputc(gzFile file, int c)
552 unsigned char cc = (unsigned char) c; /* required for big endian systems */
554 return gzwrite(file, &cc, 1) == 1 ? (int)cc : -1;
558 /* ===========================================================================
559 Writes the given null-terminated string to the compressed file, excluding
560 the terminating null character.
561 gzputs returns the number of characters written, or -1 in case of error.
563 int ZEXPORT gzputs(gzFile file, const char *s)
565 return gzwrite(file, (char*)s, (unsigned)strlen(s));
569 /* ===========================================================================
570 Flushes all pending output into the compressed file. The parameter
571 flush is as in the deflate() function.
573 local int do_flush (gzFile file, int flush)
577 gz_stream *s = (gz_stream*)file;
579 if (s == NULL || s->mode != 'w') return Z_STREAM_ERROR;
581 s->stream.avail_in = 0; /* should be zero already anyway */
584 len = Z_BUFSIZE - s->stream.avail_out;
587 if ((uInt)fwrite(s->outbuf, 1, len, s->file) != len) {
591 s->stream.next_out = s->outbuf;
592 s->stream.avail_out = Z_BUFSIZE;
595 s->z_err = deflate(&(s->stream), flush);
597 /* Ignore the second of two consecutive flushes: */
598 if (len == 0 && s->z_err == Z_BUF_ERROR) s->z_err = Z_OK;
600 /* deflate has finished flushing only when it hasn't used up
601 * all the available space in the output buffer:
603 done = (s->stream.avail_out != 0 || s->z_err == Z_STREAM_END);
605 if (s->z_err != Z_OK && s->z_err != Z_STREAM_END) break;
607 return s->z_err == Z_STREAM_END ? Z_OK : s->z_err;
610 int ZEXPORT gzflush (gzFile file, int flush)
612 gz_stream *s = (gz_stream*)file;
613 int err = do_flush (file, flush);
617 return s->z_err == Z_STREAM_END ? Z_OK : s->z_err;
619 #endif /* NO_DEFLATE */
621 /* ===========================================================================
622 Sets the starting position for the next gzread or gzwrite on the given
623 compressed file. The offset represents a number of bytes in the
624 gzseek returns the resulting offset location as measured in bytes from
625 the beginning of the uncompressed stream, or -1 in case of error.
626 SEEK_END is not implemented, returns error.
627 In this version of the library, gzseek can be extremely slow.
629 z_off_t ZEXPORT gzseek (gzFile file, z_off_t offset, int whence)
631 gz_stream *s = (gz_stream*)file;
633 if (s == NULL || whence == SEEK_END ||
634 s->z_err == Z_ERRNO || s->z_err == Z_DATA_ERROR) {
638 if (s->mode == 'w') {
642 if (whence == SEEK_SET) {
643 offset -= s->stream.total_in;
645 if (offset < 0) return -1L;
647 /* At this point, offset is the number of zero bytes to write. */
648 if (s->inbuf == Z_NULL) {
649 s->inbuf = (Byte*)ALLOC(Z_BUFSIZE); /* for seeking */
650 zmemzero(s->inbuf, Z_BUFSIZE);
653 uInt size = Z_BUFSIZE;
654 if (offset < Z_BUFSIZE) size = (uInt)offset;
656 size = gzwrite(file, s->inbuf, size);
657 if (size == 0) return -1L;
661 return (z_off_t)s->stream.total_in;
664 /* Rest of function is for reading only */
666 /* compute absolute position */
667 if (whence == SEEK_CUR) {
668 offset += s->stream.total_out;
670 if (offset < 0) return -1L;
672 if (s->transparent) {
674 s->stream.avail_in = 0;
675 s->stream.next_in = s->inbuf;
676 if (fseek(s->file, offset, SEEK_SET) < 0) return -1L;
678 s->stream.total_in = s->stream.total_out = (uLong)offset;
682 /* For a negative seek, rewind and use positive seek */
683 if ((uLong)offset >= s->stream.total_out) {
684 offset -= s->stream.total_out;
685 } else if (gzrewind(file) < 0) {
688 /* offset is now the number of bytes to skip. */
690 if (offset != 0 && s->outbuf == Z_NULL) {
691 s->outbuf = (Byte*)ALLOC(Z_BUFSIZE);
694 int size = Z_BUFSIZE;
695 if (offset < Z_BUFSIZE) size = (int)offset;
697 size = gzread(file, s->outbuf, (uInt)size);
698 if (size <= 0) return -1L;
701 return (z_off_t)s->stream.total_out;
704 /* ===========================================================================
707 int ZEXPORT gzrewind (gzFile file)
709 gz_stream *s = (gz_stream*)file;
711 if (s == NULL || s->mode != 'r') return -1;
715 s->stream.avail_in = 0;
716 s->stream.next_in = s->inbuf;
717 s->crc = crc32(0L, Z_NULL, 0);
719 if (s->startpos == 0) { /* not a compressed file */
724 (void) inflateReset(&s->stream);
725 return fseek(s->file, s->startpos, SEEK_SET);
728 /* ===========================================================================
729 Returns the starting position for the next gzread or gzwrite on the
730 given compressed file. This position represents a number of bytes in the
731 uncompressed data stream.
733 z_off_t ZEXPORT gztell (gzFile file)
735 return gzseek(file, 0L, SEEK_CUR);
738 /* ===========================================================================
739 Returns 1 when EOF has previously been detected reading the given
740 input stream, otherwise zero.
742 int ZEXPORT gzeof (gzFile file)
744 gz_stream *s = (gz_stream*)file;
746 return (s == NULL || s->mode != 'r') ? 0 : s->z_eof;
749 /* ===========================================================================
750 Outputs a long in LSB order to the given file
752 local void putLong (FILE *file, uLong x)
755 for (n = 0; n < 4; n++) {
756 fputc((int)(x & 0xff), file);
761 /* ===========================================================================
762 Reads a long in LSB order from the given gz_stream. Sets z_err in case
765 local uLong getLong (gz_stream *s)
767 uLong x = (uLong)get_byte(s);
770 x += ((uLong)get_byte(s))<<8;
771 x += ((uLong)get_byte(s))<<16;
773 if (c == EOF) s->z_err = Z_DATA_ERROR;
778 /* ===========================================================================
779 Flushes all pending output if necessary, closes the compressed file
780 and deallocates all the (de)compression state.
782 int ZEXPORT gzclose (gzFile file)
785 gz_stream *s = (gz_stream*)file;
787 if (s == NULL) return Z_STREAM_ERROR;
789 if (s->mode == 'w') {
791 return Z_STREAM_ERROR;
793 err = do_flush (file, Z_FINISH);
794 if (err != Z_OK) return destroy((gz_stream*)file);
796 putLong (s->file, s->crc);
797 putLong (s->file, s->stream.total_in);
800 return destroy((gz_stream*)file);
803 /* ===========================================================================
804 Returns the error message for the last error which occured on the
805 given compressed file. errnum is set to zlib error number. If an
806 error occured in the file system and not in the compression library,
807 errnum is set to Z_ERRNO and the application may consult errno
808 to get the exact error code.
810 const char* ZEXPORT gzerror (gzFile file, int *errnum)
813 gz_stream *s = (gz_stream*)file;
816 *errnum = Z_STREAM_ERROR;
817 return (const char*)ERR_MSG(Z_STREAM_ERROR);
820 if (*errnum == Z_OK) return (const char*)"";
822 m = (char*)(*errnum == Z_ERRNO ? zstrerror(errno) : s->stream.msg);
824 if (m == NULL || *m == '\0') m = (char*)ERR_MSG(s->z_err);
827 s->msg = (char*)ALLOC(strlen(s->path) + strlen(m) + 3);
828 strcpy(s->msg, s->path);
829 strcat(s->msg, ": ");
831 return (const char*)s->msg;