xref: /xnu-10002.61.3/bsd/sys/sbuf.h (revision 0f4c859e951fba394238ab619495c4e1d54d0f34)
1*0f4c859eSApple OSS Distributions /*-
2*0f4c859eSApple OSS Distributions  * Copyright (c) 2000 Poul-Henning Kamp and Dag-Erling Coïdan Smørgrav
3*0f4c859eSApple OSS Distributions  * All rights reserved.
4*0f4c859eSApple OSS Distributions  *
5*0f4c859eSApple OSS Distributions  * Redistribution and use in source and binary forms, with or without
6*0f4c859eSApple OSS Distributions  * modification, are permitted provided that the following conditions
7*0f4c859eSApple OSS Distributions  * are met:
8*0f4c859eSApple OSS Distributions  * 1. Redistributions of source code must retain the above copyright
9*0f4c859eSApple OSS Distributions  *    notice, this list of conditions and the following disclaimer
10*0f4c859eSApple OSS Distributions  *    in this position and unchanged.
11*0f4c859eSApple OSS Distributions  * 2. Redistributions in binary form must reproduce the above copyright
12*0f4c859eSApple OSS Distributions  *    notice, this list of conditions and the following disclaimer in the
13*0f4c859eSApple OSS Distributions  *    documentation and/or other materials provided with the distribution.
14*0f4c859eSApple OSS Distributions  * 3. The name of the author may not be used to endorse or promote products
15*0f4c859eSApple OSS Distributions  *    derived from this software without specific prior written permission.
16*0f4c859eSApple OSS Distributions  *
17*0f4c859eSApple OSS Distributions  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
18*0f4c859eSApple OSS Distributions  * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
19*0f4c859eSApple OSS Distributions  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
20*0f4c859eSApple OSS Distributions  * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
21*0f4c859eSApple OSS Distributions  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
22*0f4c859eSApple OSS Distributions  * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
23*0f4c859eSApple OSS Distributions  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
24*0f4c859eSApple OSS Distributions  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
25*0f4c859eSApple OSS Distributions  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
26*0f4c859eSApple OSS Distributions  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
27*0f4c859eSApple OSS Distributions  *
28*0f4c859eSApple OSS Distributions  *      $FreeBSD: /repoman/r/ncvs/src/sys/sys/sbuf.h,v 1.14 2004/07/09 11:35:30 des Exp $
29*0f4c859eSApple OSS Distributions  */
30*0f4c859eSApple OSS Distributions 
31*0f4c859eSApple OSS Distributions #ifndef _SYS_SBUF_H_
32*0f4c859eSApple OSS Distributions #define _SYS_SBUF_H_
33*0f4c859eSApple OSS Distributions 
34*0f4c859eSApple OSS Distributions #include <sys/_types.h>
35*0f4c859eSApple OSS Distributions #include <stdarg.h>
36*0f4c859eSApple OSS Distributions #include <stddef.h>
37*0f4c859eSApple OSS Distributions 
38*0f4c859eSApple OSS Distributions /*
39*0f4c859eSApple OSS Distributions  * Structure definition
40*0f4c859eSApple OSS Distributions  */
41*0f4c859eSApple OSS Distributions struct sbuf {
42*0f4c859eSApple OSS Distributions 	char            *s_buf;         /* storage buffer */
43*0f4c859eSApple OSS Distributions 	void            *s_unused;      /* binary compatibility. */
44*0f4c859eSApple OSS Distributions 	int              s_size;        /* size of storage buffer */
45*0f4c859eSApple OSS Distributions 	int              s_len;         /* current length of string */
46*0f4c859eSApple OSS Distributions #define SBUF_FIXEDLEN   0x00000000      /* fixed length buffer (default) */
47*0f4c859eSApple OSS Distributions #define SBUF_AUTOEXTEND 0x00000001      /* automatically extend buffer */
48*0f4c859eSApple OSS Distributions #define SBUF_USRFLAGMSK 0x0000ffff      /* mask of flags the user may specify */
49*0f4c859eSApple OSS Distributions #define SBUF_DYNAMIC    0x00010000      /* s_buf must be freed */
50*0f4c859eSApple OSS Distributions #define SBUF_FINISHED   0x00020000      /* set by sbuf_finish() */
51*0f4c859eSApple OSS Distributions #define SBUF_OVERFLOWED 0x00040000      /* sbuf overflowed */
52*0f4c859eSApple OSS Distributions #define SBUF_DYNSTRUCT  0x00080000      /* sbuf must be freed */
53*0f4c859eSApple OSS Distributions 	int              s_flags;       /* flags */
54*0f4c859eSApple OSS Distributions };
55*0f4c859eSApple OSS Distributions 
56*0f4c859eSApple OSS Distributions __BEGIN_DECLS
57*0f4c859eSApple OSS Distributions #ifdef KERNEL_PRIVATE
58*0f4c859eSApple OSS Distributions struct sbuf     *sbuf_new(struct sbuf *, char *, int, int);
59*0f4c859eSApple OSS Distributions void             sbuf_clear(struct sbuf *);
60*0f4c859eSApple OSS Distributions int              sbuf_setpos(struct sbuf *, int);
61*0f4c859eSApple OSS Distributions int              sbuf_bcat(struct sbuf *, const void *, size_t);
62*0f4c859eSApple OSS Distributions int              sbuf_bcpy(struct sbuf *, const void *, size_t);
63*0f4c859eSApple OSS Distributions int              sbuf_cat(struct sbuf *, const char *);
64*0f4c859eSApple OSS Distributions int              sbuf_cpy(struct sbuf *, const char *);
65*0f4c859eSApple OSS Distributions int              sbuf_printf(struct sbuf *, const char *, ...) __printflike(2, 3);
66*0f4c859eSApple OSS Distributions int              sbuf_vprintf(struct sbuf *, const char *, va_list) __printflike(2, 0);
67*0f4c859eSApple OSS Distributions int              sbuf_putc(struct sbuf *, int);
68*0f4c859eSApple OSS Distributions int              sbuf_trim(struct sbuf *);
69*0f4c859eSApple OSS Distributions int              sbuf_overflowed(struct sbuf *);
70*0f4c859eSApple OSS Distributions void             sbuf_finish(struct sbuf *);
71*0f4c859eSApple OSS Distributions char            *sbuf_data(struct sbuf *);
72*0f4c859eSApple OSS Distributions int              sbuf_len(struct sbuf *);
73*0f4c859eSApple OSS Distributions int              sbuf_done(struct sbuf *);
74*0f4c859eSApple OSS Distributions void             sbuf_delete(struct sbuf *);
75*0f4c859eSApple OSS Distributions #endif
76*0f4c859eSApple OSS Distributions 
77*0f4c859eSApple OSS Distributions __END_DECLS
78*0f4c859eSApple OSS Distributions 
79*0f4c859eSApple OSS Distributions #endif
80