1 /* $OpenBSD: mansearch.h,v 1.13 2014/09/01 22:45:11 schwarze Exp $ */ 2 /* 3 * Copyright (c) 2012 Kristaps Dzonsons <kristaps@bsd.lv> 4 * Copyright (c) 2013, 2014 Ingo Schwarze <schwarze@openbsd.org> 5 * 6 * Permission to use, copy, modify, and distribute this software for any 7 * purpose with or without fee is hereby granted, provided that the above 8 * copyright notice and this permission notice appear in all copies. 9 * 10 * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES 11 * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF 12 * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR 13 * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES 14 * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN 15 * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF 16 * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. 17 */ 18 #ifndef MANSEARCH_H 19 #define MANSEARCH_H 20 21 #define MANDOC_DB "mandoc.db" 22 23 #define TYPE_arch 0x0000000000000001ULL 24 #define TYPE_sec 0x0000000000000002ULL 25 #define TYPE_Xr 0x0000000000000004ULL 26 #define TYPE_Ar 0x0000000000000008ULL 27 #define TYPE_Fa 0x0000000000000010ULL 28 #define TYPE_Fl 0x0000000000000020ULL 29 #define TYPE_Dv 0x0000000000000040ULL 30 #define TYPE_Fn 0x0000000000000080ULL 31 #define TYPE_Ic 0x0000000000000100ULL 32 #define TYPE_Pa 0x0000000000000200ULL 33 #define TYPE_Cm 0x0000000000000400ULL 34 #define TYPE_Li 0x0000000000000800ULL 35 #define TYPE_Em 0x0000000000001000ULL 36 #define TYPE_Cd 0x0000000000002000ULL 37 #define TYPE_Va 0x0000000000004000ULL 38 #define TYPE_Ft 0x0000000000008000ULL 39 #define TYPE_Tn 0x0000000000010000ULL 40 #define TYPE_Er 0x0000000000020000ULL 41 #define TYPE_Ev 0x0000000000040000ULL 42 #define TYPE_Sy 0x0000000000080000ULL 43 #define TYPE_Sh 0x0000000000100000ULL 44 #define TYPE_In 0x0000000000200000ULL 45 #define TYPE_Ss 0x0000000000400000ULL 46 #define TYPE_Ox 0x0000000000800000ULL 47 #define TYPE_An 0x0000000001000000ULL 48 #define TYPE_Mt 0x0000000002000000ULL 49 #define TYPE_St 0x0000000004000000ULL 50 #define TYPE_Bx 0x0000000008000000ULL 51 #define TYPE_At 0x0000000010000000ULL 52 #define TYPE_Nx 0x0000000020000000ULL 53 #define TYPE_Fx 0x0000000040000000ULL 54 #define TYPE_Lk 0x0000000080000000ULL 55 #define TYPE_Ms 0x0000000100000000ULL 56 #define TYPE_Bsx 0x0000000200000000ULL 57 #define TYPE_Dx 0x0000000400000000ULL 58 #define TYPE_Rs 0x0000000800000000ULL 59 #define TYPE_Vt 0x0000001000000000ULL 60 #define TYPE_Lb 0x0000002000000000ULL 61 #define TYPE_Nm 0x0000004000000000ULL 62 #define TYPE_Nd 0x0000008000000000ULL 63 64 #define NAME_SYN 0x0000004000000001ULL 65 #define NAME_FILE 0x0000004000000002ULL 66 #define NAME_TITLE 0x000000400000000cULL 67 #define NAME_FIRST 0x0000004000000008ULL 68 #define NAME_HEAD 0x0000004000000010ULL 69 #define NAME_MASK 0x000000000000001fULL 70 71 enum argmode { 72 ARG_FILE = 0, 73 ARG_NAME, 74 ARG_WORD, 75 ARG_EXPR 76 }; 77 78 struct manpage { 79 char *file; /* to be prefixed by manpath */ 80 char *names; /* a list of names with sections */ 81 char *output; /* user-defined additional output */ 82 size_t ipath; /* number of the manpath */ 83 int sec; /* section number, 10 means invalid */ 84 int form; /* 0 == catpage */ 85 }; 86 87 struct mansearch { 88 const char *arch; /* architecture/NULL */ 89 const char *sec; /* mansection/NULL */ 90 const char *outkey; /* show content of this macro */ 91 enum argmode argmode; /* interpretation of arguments */ 92 }; 93 94 __BEGIN_DECLS 95 96 int mansearch_setup(int); 97 int mansearch(const struct mansearch *cfg, /* options */ 98 const struct manpaths *paths, /* manpaths */ 99 int argc, /* size of argv */ 100 char *argv[], /* search terms */ 101 struct manpage **res, /* results */ 102 size_t *ressz); /* results returned */ 103 void mansearch_free(struct manpage *, size_t); 104 105 __END_DECLS 106 107 #endif /* MANSEARCH_H */ 108