xref: /freebsd/contrib/mandoc/dba.h (revision 3c4ba5f55438f7afd4f4b0b56f88f2bb505fd6a6)
1 /*	$Id: dba.h,v 1.2 2016/08/17 20:46:56 schwarze Exp $ */
2 /*
3  * Copyright (c) 2016 Ingo Schwarze <schwarze@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  * Public interface of the allocation-based version
18  * of the mandoc database, for read-write access.
19  * To be used by dba.c, dba_read.c, and makewhatis(8).
20  */
21 
22 #define	DBP_NAME	0
23 #define	DBP_SECT	1
24 #define	DBP_ARCH	2
25 #define	DBP_DESC	3
26 #define	DBP_FILE	4
27 #define	DBP_MAX		5
28 
29 struct dba_array;
30 
31 struct dba {
32 	struct dba_array	*pages;
33 	struct dba_array	*macros;
34 };
35 
36 
37 struct dba	*dba_new(int32_t);
38 void		 dba_free(struct dba *);
39 struct dba	*dba_read(const char *);
40 int		 dba_write(const char *, struct dba *);
41 
42 struct dba_array *dba_page_new(struct dba_array *, const char *,
43 			const char *, const char *, enum form);
44 void		 dba_page_add(struct dba_array *, int32_t, const char *);
45 void		 dba_page_alias(struct dba_array *, const char *, uint64_t);
46 
47 void		 dba_macro_new(struct dba *, int32_t,
48 			const char *, const int32_t *);
49 void		 dba_macro_add(struct dba_array *, int32_t,
50 			const char *, struct dba_array *);
51