NetBSD/gnu/dist/postfix/global/rec_streamlf.c

107 lines
2.8 KiB
C
Raw Normal View History

/*++
/* NAME
/* rec_streamlf 3
/* SUMMARY
/* record interface to stream-lf files
/* SYNOPSIS
/* #include <rec_streamlf.h>
/*
/* int rec_streamlf_get(stream, buf, maxlen)
/* VSTREAM *stream;
/* VSTRING *buf;
/* int maxlen;
/*
/* int rec_streamlf_put(stream, type, data, len)
/* VSTREAM *stream;
/* int type;
/* const char *data;
/* int len;
/* AUXILIARY FUNCTIONS
/* int REC_STREAMLF_PUT_BUF(stream, type, buf)
/* VSTREAM *stream;
/* int type;
/* VSTRING *buf;
/* DESCRIPTION
/* This module implements record I/O on top of stream-lf files.
/*
/* rec_streamlf_get() reads one record from the specified stream.
/* The result is not null-terminated and may contain embedded null
/* characters.
/* The \fImaxlen\fR argument specifies an upper bound to the amount
/* of data read. The result is REC_TYPE_NORM when the record was
/* terminated by newline, REC_TYPE_CONT when no terminating newline
/* was found (the record was larger than \fImaxlen\fR characters or
/* EOF was reached), and REC_TYPE_EOF when no data could be read or
/* when an I/O error was detected.
/*
/* rec_streamlf_put() writes one record to the named stream.
/* When the record type is REC_TYPE_NORM, a newline character is
/* appended to the output. The result is the record type, or
/* REC_TYPE_EOF in case of problems.
/*
/* REC_STREAMLF_PUT_BUF() is a wrapper for rec_streamlf_put() that
/* makes it more convenient to output VSTRING buffers.
/* REC_STREAMLF_PUT_BUF() is an unsafe macro that evaluates some
/* arguments more than once.
/* SEE ALSO
/* record(3) typed records
/* LICENSE
/* .ad
/* .fi
/* The Secure Mailer license must be distributed with this software.
/* AUTHOR(S)
/* Wietse Venema
/* IBM T.J. Watson Research
/* P.O. Box 704
/* Yorktown Heights, NY 10598, USA
/*--*/
/* System library. */
#include <sys_defs.h>
/* Utility library. */
#include <vstring.h>
#include <vstream.h>
/* Global library. */
#include <record.h>
#include <rec_type.h>
#include <rec_streamlf.h>
/* rec_streamlf_get - read record from stream-lf file */
int rec_streamlf_get(VSTREAM *stream, VSTRING *buf, int maxlen)
{
int n = maxlen;
int ch;
/*
* If this one character ar a time code proves to be a performance
* bottleneck, switch to block search (memchr()) and to block move
* (memcpy()) operations.
*/
VSTRING_RESET(buf);
while (n-- > 0) {
if ((ch = VSTREAM_GETC(stream)) == VSTREAM_EOF)
return (VSTRING_LEN(buf) > 0 ? REC_TYPE_CONT : REC_TYPE_EOF);
if (ch == '\n')
return (REC_TYPE_NORM);
VSTRING_ADDCH(buf, ch);
}
return (REC_TYPE_CONT);
}
/* rec_streamlf_put - write record to stream-lf file */
int rec_streamlf_put(VSTREAM *stream, int type, const char *data, int len)
{
if (len > 0)
(void) vstream_fwrite(stream, data, len);
if (type == REC_TYPE_NORM)
(void) VSTREAM_PUTC('\n', stream);
return (vstream_ferror(stream) ? REC_TYPE_EOF : type);
}