cabde247f900dcf6e58d009bbdd15099c028c6fcvboxsyncCopyright 1995, 1998 The Open Group
cabde247f900dcf6e58d009bbdd15099c028c6fcvboxsyncPermission to use, copy, modify, distribute, and sell this software and its
cabde247f900dcf6e58d009bbdd15099c028c6fcvboxsyncdocumentation for any purpose is hereby granted without fee, provided that
cabde247f900dcf6e58d009bbdd15099c028c6fcvboxsyncthe above copyright notice appear in all copies and that both that
cabde247f900dcf6e58d009bbdd15099c028c6fcvboxsynccopyright notice and this permission notice appear in supporting
cabde247f900dcf6e58d009bbdd15099c028c6fcvboxsyncdocumentation.
cabde247f900dcf6e58d009bbdd15099c028c6fcvboxsyncThe above copyright notice and this permission notice shall be
cabde247f900dcf6e58d009bbdd15099c028c6fcvboxsyncincluded in all copies or substantial portions of the Software.
cabde247f900dcf6e58d009bbdd15099c028c6fcvboxsyncTHE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
cabde247f900dcf6e58d009bbdd15099c028c6fcvboxsyncEXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
cabde247f900dcf6e58d009bbdd15099c028c6fcvboxsyncMERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
cabde247f900dcf6e58d009bbdd15099c028c6fcvboxsyncIN NO EVENT SHALL THE OPEN GROUP BE LIABLE FOR ANY CLAIM, DAMAGES OR
cabde247f900dcf6e58d009bbdd15099c028c6fcvboxsyncOTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
cabde247f900dcf6e58d009bbdd15099c028c6fcvboxsyncARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
cabde247f900dcf6e58d009bbdd15099c028c6fcvboxsyncOTHER DEALINGS IN THE SOFTWARE.
cabde247f900dcf6e58d009bbdd15099c028c6fcvboxsyncExcept as contained in this notice, the name of The Open Group shall
cabde247f900dcf6e58d009bbdd15099c028c6fcvboxsyncnot be used in advertising or otherwise to promote the sale, use or
cabde247f900dcf6e58d009bbdd15099c028c6fcvboxsyncother dealings in this Software without prior written authorization
cabde247f900dcf6e58d009bbdd15099c028c6fcvboxsyncfrom The Open Group.
cabde247f900dcf6e58d009bbdd15099c028c6fcvboxsync * The purpose of this header is to define the macros ALLOCATE_LOCAL and
cabde247f900dcf6e58d009bbdd15099c028c6fcvboxsync * DEALLOCATE_LOCAL appropriately for the platform being compiled on.
cabde247f900dcf6e58d009bbdd15099c028c6fcvboxsync * These macros are used to make fast, function-local memory allocations.
cabde247f900dcf6e58d009bbdd15099c028c6fcvboxsync * Their characteristics are as follows:
cabde247f900dcf6e58d009bbdd15099c028c6fcvboxsync * void *ALLOCATE_LOCAL(int size)
cabde247f900dcf6e58d009bbdd15099c028c6fcvboxsync * Returns a pointer to size bytes of memory, or NULL if the allocation
cabde247f900dcf6e58d009bbdd15099c028c6fcvboxsync * failed. The memory must be freed with DEALLOCATE_LOCAL before the
cabde247f900dcf6e58d009bbdd15099c028c6fcvboxsync * function that made the allocation returns. You should not ask for
cabde247f900dcf6e58d009bbdd15099c028c6fcvboxsync * large blocks of memory with this function, since on many platforms
cabde247f900dcf6e58d009bbdd15099c028c6fcvboxsync * the memory comes from the stack, which may have limited size.
cabde247f900dcf6e58d009bbdd15099c028c6fcvboxsync * void DEALLOCATE_LOCAL(void *)
cabde247f900dcf6e58d009bbdd15099c028c6fcvboxsync * Frees the memory allocated by ALLOCATE_LOCAL. Omission of this
cabde247f900dcf6e58d009bbdd15099c028c6fcvboxsync * step may be harmless on some platforms, but will result in
cabde247f900dcf6e58d009bbdd15099c028c6fcvboxsync * memory leaks or worse on others.
cabde247f900dcf6e58d009bbdd15099c028c6fcvboxsync * Before including this file, you should define two macros,
cabde247f900dcf6e58d009bbdd15099c028c6fcvboxsync * ALLOCATE_LOCAL_FALLBACK and DEALLOCATE_LOCAL_FALLBACK, that have the
cabde247f900dcf6e58d009bbdd15099c028c6fcvboxsync * same characteristics as ALLOCATE_LOCAL and DEALLOCATE_LOCAL. The
cabde247f900dcf6e58d009bbdd15099c028c6fcvboxsync * header uses the fallbacks if it doesn't know a "better" way to define
cabde247f900dcf6e58d009bbdd15099c028c6fcvboxsync * ALLOCATE_LOCAL and DEALLOCATE_LOCAL. Typical usage would be:
cabde247f900dcf6e58d009bbdd15099c028c6fcvboxsync * #define ALLOCATE_LOCAL_FALLBACK(_size) malloc(_size)
cabde247f900dcf6e58d009bbdd15099c028c6fcvboxsync * #define DEALLOCATE_LOCAL_FALLBACK(_ptr) free(_ptr)
cabde247f900dcf6e58d009bbdd15099c028c6fcvboxsync/* Need to add more here to match Imake *.cf's */
cabde247f900dcf6e58d009bbdd15099c028c6fcvboxsync# if defined(HAVE_ALLOCA_H) || defined(__SUNPRO_C) || defined(__SUNPRO_CC)
cabde247f900dcf6e58d009bbdd15099c028c6fcvboxsync * os-dependent definition of local allocation and deallocation
cabde247f900dcf6e58d009bbdd15099c028c6fcvboxsync * If you want something other than (DE)ALLOCATE_LOCAL_FALLBACK
cabde247f900dcf6e58d009bbdd15099c028c6fcvboxsync * for ALLOCATE/DEALLOCATE_LOCAL then you add that in here.
cabde247f900dcf6e58d009bbdd15099c028c6fcvboxsync# endif /* !alloca */
cabde247f900dcf6e58d009bbdd15099c028c6fcvboxsync# else /* ! __GNUC__ */
cabde247f900dcf6e58d009bbdd15099c028c6fcvboxsync * warning: old mips alloca (pre 2.10) is unusable, new one is built in
cabde247f900dcf6e58d009bbdd15099c028c6fcvboxsync * Test is easy, the new one is named __builtin_alloca and comes
cabde247f900dcf6e58d009bbdd15099c028c6fcvboxsync * from alloca.h which #defines alloca.
cabde247f900dcf6e58d009bbdd15099c028c6fcvboxsync * Some System V boxes extract alloca.o from /lib/libPW.a; if you
cabde247f900dcf6e58d009bbdd15099c028c6fcvboxsync * decide that you don't want to use alloca, you might want to fix it here.
cabde247f900dcf6e58d009bbdd15099c028c6fcvboxsync/* alloca might be a macro taking one arg (hi, Sun!), so give it one. */
cabde247f900dcf6e58d009bbdd15099c028c6fcvboxsync# if !defined(__cplusplus)
cabde247f900dcf6e58d009bbdd15099c028c6fcvboxsync# endif /* who does alloca */
cabde247f900dcf6e58d009bbdd15099c028c6fcvboxsync# endif /* __GNUC__ */
cabde247f900dcf6e58d009bbdd15099c028c6fcvboxsync#endif /* NO_ALLOCA */
cabde247f900dcf6e58d009bbdd15099c028c6fcvboxsync# if defined(ALLOCATE_LOCAL_FALLBACK) && defined(DEALLOCATE_LOCAL_FALLBACK)
cabde247f900dcf6e58d009bbdd15099c028c6fcvboxsync# define ALLOCATE_LOCAL(_size) ALLOCATE_LOCAL_FALLBACK(_size)
cabde247f900dcf6e58d009bbdd15099c028c6fcvboxsync# define DEALLOCATE_LOCAL(_ptr) DEALLOCATE_LOCAL_FALLBACK(_ptr)
cabde247f900dcf6e58d009bbdd15099c028c6fcvboxsync# else /* no fallbacks supplied; error */
cabde247f900dcf6e58d009bbdd15099c028c6fcvboxsync# define ALLOCATE_LOCAL(_size) ALLOCATE_LOCAL_FALLBACK undefined!
cabde247f900dcf6e58d009bbdd15099c028c6fcvboxsync# define DEALLOCATE_LOCAL(_ptr) DEALLOCATE_LOCAL_FALLBACK undefined!
cabde247f900dcf6e58d009bbdd15099c028c6fcvboxsync# endif /* defined(ALLOCATE_LOCAL_FALLBACK && DEALLOCATE_LOCAL_FALLBACK) */
cabde247f900dcf6e58d009bbdd15099c028c6fcvboxsync#endif /* defined(ALLOCATE_LOCAL) */
cabde247f900dcf6e58d009bbdd15099c028c6fcvboxsync#endif /* XALLOCA_H */