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, 675 Mass Ave, Cambridge, MA 02139, USA. */
21 #if !defined (_GENERAL_H_)
26 #include "bashtypes.h"
28 #if defined (HAVE_STRING_H)
32 #endif /* !HAVE_STRING_H */
34 /* Generic pointer type. */
35 #if defined (__STDC__)
41 /* NULL pointer type. */
43 # if defined (__STDC__)
44 # define NULL ((void *) 0)
47 # endif /* !__STDC__ */
50 #define pointer_to_int(x) (int)((long)(x))
52 extern char *xmalloc (), *xrealloc ();
54 #if defined (alpha) && defined (__GNUC__) && !defined (strchr) && !defined (__STDC__)
55 extern char *strchr (), *strrchr ();
59 extern char *strcpy ();
62 #if !defined (savestring)
63 # define savestring(x) (char *)strcpy (xmalloc (1 + strlen (x)), (x))
67 # define member(c, s) ((c) ? ((char *)strchr ((s), (c)) != (char *)NULL) : 0)
71 #define whitespace(c) (((c) == ' ') || ((c) == '\t'))
75 #define digit(c) ((c) >= '0' && (c) <= '9')
79 #define isletter(c) (((c) >= 'A' && (c) <= 'Z') || ((c) >= 'a' && (c) <= 'z'))
83 #define digit_value(c) ((c) - '0')
86 /* Define exactly what a legal shell identifier consists of. */
87 #define legal_variable_starter(c) (isletter(c) || (c == '_'))
88 #define legal_variable_char(c) (isletter (c) || digit (c) || c == '_')
90 /* Definitions used in subst.c and by the `read' builtin for field
92 #define spctabnl(c) ((c) == ' ' || (c) == '\t' || (c) == '\n')
94 /* All structs which contain a `next' field should have that field
95 as the first field in the struct. This means that functions
96 can be written to handle the general case for linked lists. */
97 typedef struct g_list {
101 /* Here is a generic structure for associating character strings
102 with integers. It is used in the parser for shell tokenization. */
108 /* A macro to avoid making an uneccessary function call. */
109 #define REVERSE_LIST(list, type) \
110 ((list && list->next) ? (type)reverse_list ((GENERIC_LIST *)list) \
114 # define FASTCOPY(s, d, n) __builtin_memcpy (d, s, n)
115 #else /* !__GNUC__ */
116 # if !defined (HAVE_BCOPY)
117 # if !defined (HAVE_MEMMOVE)
118 # define FASTCOPY(s, d, n) memcpy (d, s, n)
120 # define FASTCOPY(s, d, n) memmove (d, s, n)
121 # endif /* !HAVE_MEMMOVE */
122 # else /* HAVE_BCOPY */
123 # define FASTCOPY(s, d, n) bcopy (s, d, n)
124 # endif /* HAVE_BCOPY */
125 #endif /* !__GNUC__ */
127 /* String comparisons that possibly save a function call each. */
128 #define STREQ(a, b) ((a)[0] == (b)[0] && strcmp(a, b) == 0)
129 #define STREQN(a, b, n) ((a)[0] == (b)[0] && strncmp(a, b, n) == 0)
131 /* More convenience definitions that possibly save system or libc calls. */
132 #define STRLEN(s) (((s) && (s)[0]) ? ((s)[1] ? ((s)[2] ? strlen(s) : 2) : 1) : 0)
133 #define FREE(s) do { if (s) free (s); } while (0)
134 #define MEMBER(c, s) (((c) && !(s)[1] && c == s[0]) || (member(c, s)))
136 /* A fairly hairy macro to check whether an allocated string has more room,
137 and to resize it using xrealloc if it does not.
138 STR is the string (char *)
139 CIND is the current index into the string (int)
140 ROOM is the amount of additional room we need in the string (int)
141 CSIZE is the currently-allocated size of STR (int)
142 SINCR is how much to increment CSIZE before calling xrealloc (int) */
144 #define RESIZE_MALLOCED_BUFFER(str, cind, room, csize, sincr) \
146 if ((cind) + (room) >= csize) \
148 while ((cind) + (room) >= csize) \
150 str = xrealloc (str, csize); \
154 /* Function pointers can be declared as (Function *)foo. */
155 #if !defined (_FUNCTION_DEF)
156 # define _FUNCTION_DEF
157 typedef int Function ();
158 typedef void VFunction ();
159 typedef char *CPFunction ();
160 typedef char **CPPFunction ();
161 #endif /* _FUNCTION_DEF */
163 #define NOW ((time_t) time ((time_t *) 0))
165 /* Some defines for calling file status functions. */
166 #define FS_EXISTS 0x1
167 #define FS_EXECABLE 0x2
168 #define FS_EXEC_PREFERRED 0x4
169 #define FS_EXEC_ONLY 0x8
170 #define FS_DIRECTORY 0x10
171 #define FS_NODIRS 0x20
173 /* Declarations for functions defined in xmalloc.c */
174 extern char *xmalloc __P((size_t));
175 extern char *xrealloc __P((void *, size_t));
176 extern void xfree __P((char *));
178 /* Declarations for functions defined in general.c */
179 extern void posix_initialize __P((int));
181 extern char *itos __P((int));
182 extern long string_to_long __P((char *));
184 #if defined (RLIMTYPE)
185 extern RLIMTYPE string_to_rlimtype __P((char *));
186 extern void print_rlimtype __P((RLIMTYPE, int));
189 extern void timeval_to_secs ();
190 extern void print_timeval ();
191 extern void clock_t_to_secs ();
192 extern void print_time_in_hz ();
194 extern int all_digits __P((char *));
195 extern int legal_number __P((char *, long *));
196 extern int legal_identifier __P((char *));
197 extern int check_identifier __P((WORD_DESC *, int));
199 extern void unset_nodelay_mode __P((int));
200 extern void check_dev_tty __P((void));
201 extern int same_file (); /* too many problems with prototype */
202 extern int move_to_high_fd __P((int, int, int));
203 extern int check_binary_file __P((unsigned char *, int));
205 extern char *canonicalize_pathname __P((char *));
206 extern char *make_absolute __P((char *, char *));
207 extern int absolute_pathname __P((char *));
208 extern int absolute_program __P((char *));
209 extern char *base_pathname __P((char *));
210 extern char *full_pathname __P((char *));
211 extern char *polite_directory_format __P((char *));
213 extern char *extract_colon_unit __P((char *, int *));
215 extern void tilde_initialize __P((void));
216 extern char *bash_tilde_expand __P((char *));
218 #if defined (__STDC__) && defined (gid_t)
219 extern int group_member __P((int));
221 extern int group_member __P((gid_t));
223 extern char **get_group_list __P((int *));
225 #endif /* _GENERAL_H_ */