xref: /openbsd/usr.bin/m4/extern.h (revision ce7279d8)
1 /*	$OpenBSD: extern.h,v 1.56 2024/05/21 05:00:48 jsg Exp $	*/
2 /*	$NetBSD: extern.h,v 1.3 1996/01/13 23:25:24 pk Exp $	*/
3 
4 /*-
5  * Copyright (c) 1991, 1993
6  *	The Regents of the University of California.  All rights reserved.
7  *
8  * This code is derived from software contributed to Berkeley by
9  * Ozan Yigit at York University.
10  *
11  * Redistribution and use in source and binary forms, with or without
12  * modification, are permitted provided that the following conditions
13  * are met:
14  * 1. Redistributions of source code must retain the above copyright
15  *    notice, this list of conditions and the following disclaimer.
16  * 2. Redistributions in binary form must reproduce the above copyright
17  *    notice, this list of conditions and the following disclaimer in the
18  *    documentation and/or other materials provided with the distribution.
19  * 3. Neither the name of the University nor the names of its contributors
20  *    may be used to endorse or promote products derived from this software
21  *    without specific prior written permission.
22  *
23  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
24  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
25  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
26  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
27  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
28  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
29  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
30  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
31  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
32  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
33  * SUCH DAMAGE.
34  *
35  *	@(#)extern.h	8.1 (Berkeley) 6/6/93
36  */
37 
38 /* eval.c */
39 extern void	eval(const char *[], int, int, int);
40 extern void	dodefine(const char *, const char *);
41 extern unsigned long expansion_id;
42 
43 /* expr.c */
44 extern int	expr(const char *);
45 
46 /* gnum4.c */
47 extern void	addtoincludepath(const char *);
48 extern struct input_file *fopen_trypath(struct input_file *, const char *);
49 extern void doindir(const char *[], int);
50 extern void dobuiltin(const char *[], int);
51 extern void dopatsubst(const char *[], int);
52 extern void doregexp(const char *[], int);
53 
54 extern void doprintlineno(struct input_file *);
55 extern void doprintfilename(struct input_file *);
56 
57 extern void doesyscmd(const char *);
58 extern void getdivfile(const char *);
59 extern void doformat(const char *[], int);
60 
61 extern void m4_warnx(const char *, ...);
62 
63 /* look.c */
64 
65 #define FLAG_UNTRACED 0
66 #define FLAG_TRACED 1
67 #define FLAG_NO_TRACE 2
68 
69 extern void	init_macros(void);
70 extern ndptr	lookup(const char *);
71 extern void mark_traced(const char *, int);
72 extern struct ohash macros;
73 
74 extern struct macro_definition *lookup_macro_definition(const char *);
75 extern void	macro_define(const char *, const char *);
76 extern void	macro_pushdef(const char *, const char *);
77 extern void	macro_popdef(const char *);
78 extern void	macro_undefine(const char *);
79 extern void	setup_builtin(const char *, unsigned int);
80 extern void	macro_for_all(void (*)(const char *, struct macro_definition *));
81 #define macro_getdef(p)		((p)->d)
82 #define macro_name(p)		((p)->name)
83 #define macro_builtin_type(p)	((p)->builtin_type)
84 #define is_traced(p) ((p)->trace_flags == FLAG_NO_TRACE ? (trace_flags & TRACE_ALL) : (p)->trace_flags)
85 
86 extern ndptr macro_getbuiltin(const char *);
87 
88 /* main.c */
89 extern void outputstr(const char *);
90 extern void do_emit_synchline(void);
91 extern int exit_code;
92 #define emit_synchline() do { if (synch_lines) do_emit_synchline(); } while(0)
93 
94 /* misc.c */
95 extern void	chrsave(int);
96 extern void	getdiv(int);
97 extern ptrdiff_t indx(const char *, const char *);
98 extern void	initspaces(void);
99 extern void	killdiv(void);
100 extern void	onintr(int);
101 extern void	pbnum(int);
102 extern void	pbnumbase(int, int, int);
103 extern void	pbunsigned(unsigned long);
104 extern void	pbstr(const char *);
105 extern void	pushback(int);
106 extern void	*xalloc(size_t, const char *, ...);
107 extern void	*xcalloc(size_t, size_t, const char *, ...);
108 extern void	*xrealloc(void *, size_t, const char *, ...);
109 extern void	*xreallocarray(void *, size_t, size_t, const char *, ...);
110 extern char	*xstrdup(const char *);
111 extern void	usage(void);
112 extern void	resizedivs(int);
113 extern size_t	buffer_mark(void);
114 extern void	dump_buffer(FILE *, size_t);
115 extern void	__dead m4errx(int, const char *, ...);
116 
117 extern int	obtain_char(struct input_file *);
118 extern void	set_input(struct input_file *, FILE *, const char *);
119 extern void	release_input(struct input_file *);
120 
121 /* speeded-up versions of chrsave/pushback */
122 #define PUSHBACK(c)				\
123 	do {					\
124 		if (bp >= endpbb)		\
125 			enlarge_bufspace();	\
126 		*bp++ = (c);			\
127 	} while(0)
128 
129 #define CHRSAVE(c)				\
130 	do {					\
131 		if (ep >= endest)		\
132 			enlarge_strspace();	\
133 		*ep++ = (c);			\
134 	} while(0)
135 
136 /* and corresponding exposure for local symbols */
137 extern void enlarge_bufspace(void);
138 extern void enlarge_strspace(void);
139 extern unsigned char *endpbb;
140 extern char *endest;
141 
142 /* trace.c */
143 extern unsigned int trace_flags;
144 #define TRACE_ALL	512
145 extern void trace_file(const char *);
146 extern size_t trace(const char **, int, struct input_file *);
147 extern void finish_trace(size_t);
148 extern void set_trace_flags(const char *);
149 extern FILE *traceout;
150 
151 extern stae *mstack;		/* stack of m4 machine */
152 extern char *sstack;		/* shadow stack, for string space extension */
153 extern FILE *active;		/* active output file pointer */
154 extern struct input_file infile[];/* input file stack (0=stdin) */
155 extern FILE **outfile;		/* diversion array(0=bitbucket) */
156 extern int maxout;		/* maximum number of diversions */
157 extern int fp;			/* m4 call frame pointer */
158 extern int ilevel;		/* input file stack pointer */
159 extern int oindex;		/* diversion index. */
160 extern int sp;			/* current m4 stack pointer */
161 extern unsigned char *bp;	/* first available character */
162 extern unsigned char *buf;	/* push-back buffer */
163 extern unsigned char *bufbase;	/* buffer base for this ilevel */
164 extern unsigned char *bbase[];	/* buffer base per ilevel */
165 extern char ecommt[MAXCCHARS+1];/* end character for comment */
166 extern char *ep;		/* first free char in strspace */
167 extern char lquote[MAXCCHARS+1];/* left quote character (`) */
168 extern char **m4wraps;		/* m4wrap string default. */
169 extern int maxwraps;		/* size of m4wraps array */
170 extern int wrapindex;		/* current index in m4wraps */
171 
172 extern char *null;		/* as it says.. just a null. */
173 extern char rquote[MAXCCHARS+1];/* right quote character (') */
174 extern char scommt[MAXCCHARS+1];/* start character for comment */
175 extern int  synch_lines;	/* line synchronisation directives */
176 
177 extern int mimic_gnu;		/* behaves like gnu-m4 */
178 extern int prefix_builtins;	/* prefix builtin macros with m4_ */
179 extern int error_warns;		/* make warnings cause exit_code = 1 */
180 extern int fatal_warns;		/* make warnings fatal */
181 
182