1 /* general.h -- defines that everybody likes to use. */
3 /* Copyright (C) 1993 Free Software Foundation, Inc.
5 This file is part of GNU Bash, the Bourne Again SHell.
7 Bash is free software; you can redistribute it and/or modify it under
8 the terms of the GNU General Public License as published by the Free
9 Software Foundation; either version 2, or (at your option) any later
12 Bash is distributed in the hope that it will be useful, but WITHOUT ANY
13 WARRANTY; without even the implied warranty of MERCHANTABILITY or
14 FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
17 You should have received a copy of the GNU General Public License along
18 with Bash; see the file COPYING. If not, write to the Free Software
19 Foundation, 59 Temple Place, Suite 330, Boston, MA 02111 USA. */
21 #if !defined (_GENERAL_H_)
26 #include "bashtypes.h"
28 #if defined (HAVE_SYS_RESOURCE_H) && defined (RLIMTYPE)
29 # if defined (HAVE_SYS_TIME_H)
30 # include <sys/time.h>
32 # include <sys/resource.h>
35 #if defined (HAVE_STRING_H)
39 #endif /* !HAVE_STRING_H */
41 /* Generic pointer type. */
42 #if defined (__STDC__)
48 /* NULL pointer type. */
50 # if defined (__STDC__)
51 # define NULL ((void *) 0)
54 # endif /* !__STDC__ */
57 #define pointer_to_int(x) (int)((long)(x))
59 extern char *xmalloc (), *xrealloc ();
61 #if defined (alpha) && defined (__GNUC__) && !defined (strchr) && !defined (__STDC__)
62 extern char *strchr (), *strrchr ();
66 extern char *strcpy ();
69 #if !defined (savestring)
70 # define savestring(x) (char *)strcpy (xmalloc (1 + strlen (x)), (x))
74 # define member(c, s) ((c) ? ((char *)strchr ((s), (c)) != (char *)NULL) : 0)
78 #define whitespace(c) (((c) == ' ') || ((c) == '\t'))
82 #define digit(c) (isdigit(c))
86 #define isletter(c) (isalpha(c))
90 #define digit_value(c) ((c) - '0')
94 #define ISOCTAL(c) ((c) >= '0' && (c) <= '7')
97 /* Define exactly what a legal shell identifier consists of. */
98 #define legal_variable_starter(c) (isletter(c) || (c == '_'))
99 #define legal_variable_char(c) (isletter (c) || digit (c) || c == '_')
101 /* Definitions used in subst.c and by the `read' builtin for field
103 #define spctabnl(c) ((c) == ' ' || (c) == '\t' || (c) == '\n')
105 /* All structs which contain a `next' field should have that field
106 as the first field in the struct. This means that functions
107 can be written to handle the general case for linked lists. */
108 typedef struct g_list
{
112 /* Here is a generic structure for associating character strings
113 with integers. It is used in the parser for shell tokenization. */
119 /* A macro to avoid making an uneccessary function call. */
120 #define REVERSE_LIST(list, type) \
121 ((list && list->next) ? (type)reverse_list ((GENERIC_LIST *)list) \
125 # define FASTCOPY(s, d, n) __builtin_memcpy (d, s, n)
126 #else /* !__GNUC__ */
127 # if !defined (HAVE_BCOPY)
128 # if !defined (HAVE_MEMMOVE)
129 # define FASTCOPY(s, d, n) memcpy (d, s, n)
131 # define FASTCOPY(s, d, n) memmove (d, s, n)
132 # endif /* !HAVE_MEMMOVE */
133 # else /* HAVE_BCOPY */
134 # define FASTCOPY(s, d, n) bcopy (s, d, n)
135 # endif /* HAVE_BCOPY */
136 #endif /* !__GNUC__ */
138 /* String comparisons that possibly save a function call each. */
139 #define STREQ(a, b) ((a)[0] == (b)[0] && strcmp(a, b) == 0)
140 #define STREQN(a, b, n) ((n == 0) ? (1) \
141 : ((a)[0] == (b)[0] && strncmp(a, b, n) == 0))
143 /* More convenience definitions that possibly save system or libc calls. */
144 #define STRLEN(s) (((s) && (s)[0]) ? ((s)[1] ? ((s)[2] ? strlen(s) : 2) : 1) : 0)
145 #define FREE(s) do { if (s) free (s); } while (0)
146 #define MEMBER(c, s) (((c) && c == (s)[0] && !(s)[1]) || (member(c, s)))
148 /* A fairly hairy macro to check whether an allocated string has more room,
149 and to resize it using xrealloc if it does not.
150 STR is the string (char *)
151 CIND is the current index into the string (int)
152 ROOM is the amount of additional room we need in the string (int)
153 CSIZE is the currently-allocated size of STR (int)
154 SINCR is how much to increment CSIZE before calling xrealloc (int) */
156 #define RESIZE_MALLOCED_BUFFER(str, cind, room, csize, sincr) \
158 if ((cind) + (room) >= csize) \
160 while ((cind) + (room) >= csize) \
162 str = xrealloc (str, csize); \
166 /* Function pointers can be declared as (Function *)foo. */
167 #if !defined (_FUNCTION_DEF)
168 # define _FUNCTION_DEF
169 typedef int Function ();
170 typedef void VFunction ();
171 typedef char *CPFunction ();
172 typedef char **CPPFunction ();
173 #endif /* _FUNCTION_DEF */
175 #define NOW ((time_t) time ((time_t *) 0))
177 /* Some defines for calling file status functions. */
178 #define FS_EXISTS 0x1
179 #define FS_EXECABLE 0x2
180 #define FS_EXEC_PREFERRED 0x4
181 #define FS_EXEC_ONLY 0x8
182 #define FS_DIRECTORY 0x10
183 #define FS_NODIRS 0x20
185 /* Some useful definitions for Unix pathnames. Argument convention:
186 x == string, c == character */
188 #if !defined (__CYGWIN__)
189 # define ABSPATH(x) ((x)[0] == '/')
190 # define RELPATH(x) ((x)[0] != '/')
191 #else /* __CYGWIN__ */
192 # define ABSPATH(x) (((x)[0] && isalpha((x)[0]) && (x)[1] == ':' && (x)[2] == '/') || (x)[0] == '/')
193 # define RELPATH(x) (!(x)[0] || ((x)[1] != ':' && (x)[0] != '/'))
194 #endif /* __CYGWIN__ */
196 #define ROOTEDPATH(x) (ABSPATH(x))
199 #define ISDIRSEP(c) ((c) == '/')
200 #define PATHSEP(c) (ISDIRSEP(c) || (c) == 0)
202 /* Declarations for functions defined in xmalloc.c */
203 extern char *xmalloc
__P((size_t));
204 extern char *xrealloc
__P((void *, size_t));
205 extern void xfree
__P((void *));
207 /* Declarations for functions defined in general.c */
208 extern void posix_initialize
__P((int));
210 #if defined (RLIMTYPE)
211 extern RLIMTYPE string_to_rlimtype
__P((char *));
212 extern void print_rlimtype
__P((RLIMTYPE
, int));
215 extern int all_digits
__P((char *));
216 extern int legal_number
__P((char *, long *));
217 extern int legal_identifier
__P((char *));
218 extern int check_identifier
__P((WORD_DESC
*, int));
220 extern int sh_unset_nodelay_mode
__P((int));
221 extern void check_dev_tty
__P((void));
222 extern int same_file (); /* too many problems with prototype */
223 extern int move_to_high_fd
__P((int, int, int));
224 extern int check_binary_file
__P((unsigned char *, int));
226 extern char *make_absolute
__P((char *, char *));
227 extern int absolute_pathname
__P((char *));
228 extern int absolute_program
__P((char *));
229 extern char *base_pathname
__P((char *));
230 extern char *full_pathname
__P((char *));
231 extern char *polite_directory_format
__P((char *));
233 extern char *extract_colon_unit
__P((char *, int *));
235 extern void tilde_initialize
__P((void));
236 extern char *bash_tilde_expand
__P((char *));
238 extern int group_member
__P((gid_t
));
239 extern char **get_group_list
__P((int *));
240 extern int *get_group_array
__P((int *));
242 #endif /* _GENERAL_H_ */