1/*	$OpenBSD: iobuf.h,v 1.7 2021/07/28 19:39:50 benno Exp $	*/
2/*
3 * Copyright (c) 2012 Eric Faurot <eric@openbsd.org>
4 *
5 * Permission to use, copy, modify, and distribute this software for any
6 * purpose with or without fee is hereby granted, provided that the above
7 * copyright notice and this permission notice appear in all copies.
8 *
9 * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
10 * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
11 * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
12 * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
13 * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
14 * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
15 * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
16 */
17
18struct ioqbuf {
19	struct ioqbuf	*next;
20	char		*buf;
21	size_t		 size;
22	size_t		 wpos;
23	size_t		 rpos;
24};
25
26struct iobuf {
27	char		*buf;
28	size_t		 max;
29	size_t		 size;
30	size_t		 wpos;
31	size_t		 rpos;
32
33	size_t		 queued;
34	struct ioqbuf	*outq;
35	struct ioqbuf	*outqlast;
36};
37
38struct tls;
39
40#define IOBUF_WANT_READ		-1
41#define IOBUF_WANT_WRITE	-2
42#define IOBUF_CLOSED		-3
43#define IOBUF_ERROR		-4
44
45int	iobuf_init(struct iobuf *, size_t, size_t);
46void	iobuf_clear(struct iobuf *);
47
48int	iobuf_extend(struct iobuf *, size_t);
49void	iobuf_normalize(struct iobuf *);
50void	iobuf_drop(struct iobuf *, size_t);
51size_t	iobuf_space(struct iobuf *);
52size_t	iobuf_len(struct iobuf *);
53size_t	iobuf_left(struct iobuf *);
54char   *iobuf_data(struct iobuf *);
55char   *iobuf_getline(struct iobuf *, size_t *);
56ssize_t	iobuf_read(struct iobuf *, int);
57ssize_t	iobuf_read_tls(struct iobuf *, struct tls *);
58
59size_t  iobuf_queued(struct iobuf *);
60void*   iobuf_reserve(struct iobuf *, size_t);
61int	iobuf_queue(struct iobuf *, const void*, size_t);
62int	iobuf_queuev(struct iobuf *, const struct iovec *, int);
63int	iobuf_fqueue(struct iobuf *, const char *, ...)
64    __attribute__((__format__ (printf, 2, 3)));
65int	iobuf_vfqueue(struct iobuf *, const char *, va_list);
66int	iobuf_flush(struct iobuf *, int);
67int	iobuf_flush_tls(struct iobuf *, struct tls *);
68ssize_t	iobuf_write(struct iobuf *, int);
69ssize_t	iobuf_write_tls(struct iobuf *, struct tls *);
70