Subversion Repositories tendra.SVN

/*

    		 Crown Copyright (c) 1997

    This TenDRA(r) Computer Program is subject to Copyright

    owned by the United Kingdom Secretary of State for Defence

    acting through the Defence Evaluation and Research Agency

    (DERA).  It is made available to Recipients with a

    royalty-free licence for its use, reproduction, transfer

    to other parties and amendment for any purpose not excluding

    product development provided that any such use et cetera

    shall be deemed to be acceptance of the following conditions:-

        (1) Its Recipients shall ensure that this Notice is

        reproduced upon any copies or amended versions of it;

        (2) Any amended version of it shall be clearly marked to

        show both the nature of and the organisation responsible

        for the relevant amendment or amendments;

        (3) Its onward transfer from a recipient to another

        party shall be deemed to be that party's acceptance of

        these conditions;

        (4) DERA gives no warranty or assurance as to its

        quality or suitability for any purpose and DERA accepts

        no liability whatsoever in relation to any use to which

        it may be put.

*/

/**** os-interface.h --- Primitive definitions.

 *

 ** Author: Steve Folkes <smf@hermes.mod.uk>

 *

 **** Commentary:

 *

 ***=== INTRODUCTION =========================================================

 *

 * This file specifies an interface to the host system's C library, compiler

 * and operating system.  It provides definitions of basic types, constants

 * and macros, and declarations of functions, that can be used by other

 * components of the program.

 *

 * This file (and others in this directory) makes use of several macros to

 * turn on certain features.  These macros are listed below.  In each case

 * there is a macro that begins with ``FS_NO_'' instead of ``FS_'' that turns

 * the feature off; if both are defined, the ``FS_NO_'' macro takes

 * precedence, and the feature is turned off.  In addition, the ``FS_NO_STDC''

 * macro may be used to turn off the ``__STDC__'' macro (in the cases where

 * the system isn't really ANSI compliant), and the ``FS_NO_FILE_INFO'' macro

 * should be defined if the ``__FILE__'' or ``__LINE__'' macros are

 * unsupported.

 *

 *	FS_FAST

 *

 * This should be defined if you want the program to use macros in place of

 * some function calls.  This will generally speed up the program (although

 * this is not guaranteed).  It is incompatible with ``FS_SHORTNAMES''.  It

 * also turns off the assertion checking (unless ``FS_ASSERT'' is also

 * defined).

 *

 *	FS_SHORTNAMES

 *

 * This is a hack for systems that cannot cope with long external identifier

 * names.  It includes the file "shortnames.h" which should macro define all

 * external identifiers to be a suitable short name.  It is incompatible with

 * ``FS_FAST''.

 *

 *	FS_ASSERT

 *

 * This should be defined if you want assertion checking enabled.  This is on

 * by default, unless ``FS_FAST'' is defined, so it is only really useful to

 * define this if you have also defined ``FS_FAST'', but still want assertions

 * to be checked.  It is possible that less assertions will be checked, as

 * some of the "inlined" functions may have lost their assertions in the

 * macro version.

 *

 *	FS_STDC_HASH

 *

 * This should be defined if the system supports ANSI C style macro hash

 * syntax (``#'' and ``##'').  It is automatically defined if the ``__STDC__''

 * macro is defined.

 *

 *	FS_PROTOTYPES

 *

 * This should be defined if the system supports ANSI C style function

 * prototypes.  It is automatically defined if the ``__STDC__'' macro is

 * defined.

 *

 *	FS_VOID_PTR

 *

 * This should be defined if the system supports ``void *'' as a generic

 * pointer.  If this is not the case, then ``char *'' is used instead.  It is

 * automatically defined if the ``__STDC__'' macro is defined.

 *

 *	FS_VOLATILE

 *

 * This should be defined if this system supports the ANSI C ``volatile''

 * keyword.  It is automatically defined if the ``__STDC__'' macro is defined.

 *

 *	FS_CONST

 *

 * This should be defined if this system supports the ANSI C ``const''

 * keyword.  It is automatically defined if the ``__STDC__'' macro is defined.

 *

 *	FS_UNION_INIT

 *

 * This should be defined if this system supports the ANSI C union

 * initialisation.  It is automatically defined if the ``__STDC__'' macro is

 * defined.

 *

 *	FS_ENUM

 *

 * This should be defined if this system supports enumerated types.  It is

 * automatically defined if ``__STDC__'' is defined.  This macro needs to be

 * tested wherever an enumeration type is declared, and if enumeration types

 * are not supported, then an integer must be used instead.

 *

 *	FS_ANSI_ENVIRON

 *

 * This should be defined if the system has an ANSI C compliant standard

 * library.  If this is not the case, then an attempt is made to approximate

 * that library.  It is automatically defined if the ``__STDC__'' macro is

 * defined to be ``1''.

 *

 *	FS_BINARY_STDIO

 *

 * This should be defined if the system supports the "b" modifier to the

 * standard library ``fopen'' function.  It is automatically defined if

 * ``FS_ANSI_ENVIRON'' is defined.

 *

 *	FS_STRERROR

 *

 * This should be defined if this system supports the ANSI ``strerror''

 * function for getting a textual description of a system error message.  It

 * is automatically defined if ``FS_ANSI_ENVIRON'' is defined.

 *

 *	FS_SYS_ERRLIST

 *

 * This should be defined if this system supports ``sys_nerr'' and

 * ``sys_errlist'' for getting a textual description of the current system

 * error.  If the ``FS_STRERROR'' macro is defined, then the ANSI ``strerror''

 * function will be used instead (overiding this macro).  If neither macro is

 * defined, then the error number will be used as the message.

 *

 *	FS_MKDIR

 *

 * This should be defined if this system supports the POSIX ``mkdir''

 * function.

 *

 * As well as the feature switch macros, there are some portability option

 * macros as well.  These provide values for types and constants when the type

 * cannot be otherwise deduced.  These macros are ignored when the correct

 * value can be obtained automatically (this generally means on an ANSI

 * compliant system).

 *

 *	PO_SIZE_T_TYPE

 *

 * The ``sizeof'' operator returns a value of type ``size_t''.  In an ANSI C

 * compliant standard library, this type should be defined in <stddef.h>.  If

 * the machine doesn't have an ANSI C compliant standard library, then this

 * macro should specify the type of ``size_t''.  If no definition is provided,

 * and the environment is not ANSI C compliant, then ``unsigned'' will be

 * used.

 *

 *	PO_CHAR_BIT

 *

 * This should be defined to be the number of bits in a ``char'' object, used

 * to define ``CHAR_BIT''.  In an ANSI C compliant standard library, this

 * macro is defined in <limits.h>. If the standard library is not ANSI

 * compliant and no value is provided, then ``8'' will be used.

 *

 *	PO_EXIT_SUCCESS

 *	PO_EXIT_FAILURE

 *

 * These two macros should be defined to be the values for ``EXIT_SUCCESS''

 * and ``EXIT_FAILUE''.  In an ANSI C compliant standard library, they are

 * defined in <stdlib.h>.  If the standard library is not ANSI compliant and

 * no value is provided, then ``0'' and ``1'' will be used.

 *

 *	PO_UINT_MAX

 *

 * This should be defined to be the maximum unsinged integer, and is used to

 * define ``UINT_MAX''.  In an ANSI C compliant standard library, this macro

 * is defined in <limits.h>. If the standard library is not ANSI compliant and

 * no value is provided, then ``(~(unsigned) 0)'' will be used.

 *

 *	PO_SEEK_SET

 *	PO_SEEK_CUR

 *	PO_SEEK_END

 *

 * These should be defined to be the values for ``SEEK_SET'', ``SEEK_CUR'' and

 * ``SEEK_END''.  In an ANSI C compliant standard library, they are defined in

 * <stdio.h>.  If the standard library is not ANSI compliant and no value is

 * provided, then ``0'', ``1'' and ``2'' will be used.

 *

 * This file also requires that one external function be provided:

 *

 *	void				E_assertion_failed

 *			PROTO_S ((CStringP, CStringP, unsigned))

 *

 * This function will be called if an assertion fails.  It will be called with

 * the text of the assertion, the name of the file in which the assertion was

 * written, and line on which it occured.

 *

 ***=== FROM ANSI ============================================================

 *

 * The following ANSI C functions are declared:

 *

 *	NoReturnT			abort

 *			PROTO_S ((void))

 *	GenericP			calloc

 *			PROTO_S ((SizeT length, SizeT size))

 *	GenericP			malloc

 *			PROTO_S ((SizeT size))

 *	NoReturnT			exit

 *			PROTO_S ((int exit_code))

 *	void				free

 *			PROTO_S ((GenericP pointer))

 *	CStringP			getenv

 *			PROTO_S ((CStringP name))

 *	int				memcmp

 *			PROTO_S ((GenericP ptr1, GenericP ptr2, SizeT length))

 *	GenericP			memcpy

 *			PROTO_S ((GenericP to, GenericP from, SizeT length))

 *	GenericP			memset

 *			PROTO_S ((GenericP ptr, int val, SizeT length))

 *	GenericP			memchr

 *			PROTO_S ((GenericP ptr, int val, SizeT length))

 *	SizeT				strlen

 *			PROTO_S ((CStringP string))

 *	int				strcmp

 *			PROTO_S ((CStringP string1, CStringP string2))

 *	CStringP			strcpy

 *			PROTO_S ((CStringP to, CStringP from))

 *	CStringP			strchr

 *			PROTO_S ((CStringP string, int c))

 *	CStringP			strrchr

 *			PROTO_S ((CStringP string, int c))

 *

 * Also everything in <setjmp.h> and <stdio.h> is included (hopefully this is

 * sufficiently common to be used even on non-ANSI platforms).  Where features

 * are absent on non-ANSI systems, support for them will need to be added.

 *

 ***=== FUNCTIONS ============================================================

 *

 ** Function:	int			mkdir

 *			PROTO_S ((CStringP path, int mode))

 ** Exceptions:

 *

 * This function is only declared if the ``FS_MKDIR'' macro is defined.  This

 * macro should also be tested before the function is used anywhere.  It is

 * the POSIX directory creation function.

 *

 ** Function:	CStringP		strerror

 *			PROTO_S ((int error))

 ** Exceptions:

 *

 * This function is only declared if the ``FS_STRERROR'' macro is defined.

 * This macro should also be tested before the function is used anywhere.  It

 * is the ANSI function for obtaining a textual description of a system error

 * message.

 *

 ***=== VARIABLES ============================================================

 *

 ** Variable:	int			sys_nerr

 *

 * This variable is only declared if the ``FS_SYS_ERRLIST'' macro is defined.

 * It contains the number of error messages stored in the ``sys_errlist''

 * vector.

 *

 ** Variable:	CStringP		sys_errlist []

 *

 * This variable is only declared if the ``FS_SYS_ERRLIST'' macro is defined.

 * It contains the text of the system error messages.

 *

 ** Variable:	int			errno

 *

 * This variable contains the number of the current system error.

 *

 ***=== TYPES ================================================================

 *

 ** Type:	GenericP

 ** Repr:	void *

 *

 * This is the generic pointer type.  It can be used to store a pointer to any

 * non-function object.

 *

 ** Type:	NoReturnT

 ** Repr:	void

 *

 * This is the return type of a function that doesn't return (e.g.

 * ``longjmp'').  Normally this is just ``void'', however the GNU C compiler

 * can produce better code if this is declared as ``__volatile__ void''.  The

 * TenDRA compiler can be told that a function doesn't return as well.

 *

 ** Type:	SizeT

 ** Type:	SizeP

 ** Repr:	size_t

 *

 * This is the type of the return value of the "sizeof" operator.

 *

 ** Type:	CStringP

 ** Repr:	char *

 *

 * This is the C string type.  It is defined here to avoid a circularity in

 * the "os-interface" directory.  Other directories should access it via the

 * "cstring.h" file.

 *

 ** Type:	ByteT

 ** Type:	ByteP

 ** Repr:	unsigned char

 *

 * This is the byte type.  It is possible that this could be larger than a

 * byte in some implementations.

 *

 ** Type:	BoolT

 ** Type:	BoolP

 ** Repr:	int

 *

 * This is the boolean type.

 *

 ** Type:	CmpT

 ** Type:	CmpP

 ** Repr:	enum {CMP_LT, CMP_EQ, CMP_GT}

 *

 * This is the type returned by comparison functions.  The values represent

 * the fact that the first argument is less than, equal to, or greater than

 * the second argument respectively.

 *

 ***=== CONSTANTS ============================================================

 *

 ** Constant:	TRUE

 ** Constant:	FALSE

 *

 * These expand to values suitable for the boolean constants true and false.

 *

 ** Constant:	EXIT_SUCCESS

 ** Constant:	EXIT_FAILURE

 *

 * These values should be used as arguments to the ``exit'' function to

 * indicate success or failure of the program.

 *

 ** Constant:	UINT_MAX

 *

 * This is the maximum unsigned integer value.

 *

 ** Constant:	CHAR_BIT

 *

 * This is the number of bits in a ``char'' object.

 *

 ***=== MACROS ===============================================================

 *

 ** Macro:	FS_NO_FILE_INFO

 ** Exceptions:

 *

 * This macro is defined if ``__FILE__'' or ``__LINE__'' are unsupported.

 * They will be defined as macros with some default value in this case, but

 * the programmer may wish to do something different.

 *

 ** Macro:	FS_STDC_HASH

 ** Exceptions:

 *

 * This macro is defined if the ANSI C hash operators (``#'' and ``##'') are

 * available.

 *

 ** Macro:	FS_ENUM

 ** Macro:	FS_NO_ENUM

 ** Exceptions:

 *

 * The first of these macros is defined if the compiler supports enumeration

 * types.  The second is defined when the first is undefined (and vice-versa).

 * Either can (and should) be tested when enumeration types are being defined,

 * with integer types and macros being used if enumeration types are not

 * supported.

 *

 ** Macro:	FS_BINARY_STDIO

 ** Exceptions:

 *

 * This macro is defined if ANSI binary input and output is supported

 * (i.e. the "b" modifier is allowed in the second argument to ``fopen'').

 *

 ** Macro:	FS_STRERROR

 ** Exceptions:

 *

 * This macro is defined if the ANSI function ``strerror'' is defined.

 *

 ** Macro:	FS_SYS_ERRLIST

 ** Exceptions:

 *

 * This macro is defined if the BSD ``sys_nerr'' and ``sys_errlist'' variables

 * are defined.  If ``FS_STRERROR'' is defined, then the ``strerror'' function

 * should be used in preference to ``sys_nerr'' and ``sys_errlist''.

 *

 ** Macro:	FS_MKDIR

 ** Exceptions:

 *

 * This macro is defined if the POSIX function ``mkdir'' is defined.

 *

 ** Macro:	NIL(type)

 ** Exceptions:

 *

 * This is the null pointer macro.  The argument is the type for which a null

 * pointer is required.

 *

 ** Macro:	PROTO_S (prototype)

 ** Exceptions:

 *

 * If prototypes are supported, this expands to the prototyped function

 * argument declaration provided.  If they are not supported, it expands to an

 * empty argument list.  It is necessary to use two sets of parentheses, as

 * the prototype may contain commas.  This macro should be used to declare all

 * functions within the program (see the function declarations later on in the

 * file for some examples of its use).

 *

 ** Macro:	PROTO_N (names)

 ** Macro:	PROTO_T (types)

 ** Macro:	X

 ** Macro:	PROTO_Z ()

 ** Exceptions:

 *

 * The "PROTO_N" and "PROTO_T" macros should be used for argument

 * specifications when defining functions.  If prototypes are supported, these

 * macros expand to a prototyped argument specification; if they are not

 * supported, the macros expand to an unprototyped argument specification.

 * The "PROTO_N" macro takes a comma separated list of argument names (in a

 * similar manner to the "PROTO_S" macro).  The "PROTO_T" macro takes a list

 * of declarations for those names, separated by an "X" macro.  If the

 * function takes no parameters, then the "PROTO_Z" macro should be used

 * instead.  An example of the definition of the ``main'' function in a

 * program is:

 *

 *	int

 *	main PROTO_N ((argc, argv))

 *	     PROTO_T (int argc X char **argv)

 *	{

 *	}

 *

 * An example of the definition of a function with no parameters is:

 *

 *	void

 *	no_args_proc PROTO_Z ()

 *	{

 *	}

 * 

 * Other functions should be defined in a similar manner.

 *

 ** Macro:	UNION

 ** Exceptions:

 *

 * This macro should be used to define union types that need initialisation.

 * If union initialisation is supported, it expands to ``union'', otherwise it

 * expands to ``struct''.

 *

 ** Macro:	UB

 ** Macro:	UE

 ** Exceptions:

 *

 * These macros should be used to initialise instances of union types that

 * need initialisation.  The ``UB'' macro should go before the initialiser,

 * and the ``UE'' macro should go after it.

 *

 ** Macro:	INLINE

 ** Exceptions:

 *

 * This macro may be used before a function to indicate that the function

 * should be inlined.  Normally it expands to nothing, however under the GNU C

 * compiler it expands to ``__inline__'' which causes the compiler to inline

 * the function.

 *

 ** Macro:	ASSERT (assertion)

 ** Exceptions:

 *

 * This macro causes the program to abort if the assertion provided does not

 * hold.  Assertion checking is disabled if the ``FS_FAST'' macro is defined

 * or if the ``FS_NO_ASSERT'' macro is defined.  The assertion "ASSERT

 * (FALSE);" is used to indicate that the program should never reach the

 * current line.

 *

 ** Macro:	UNUSED (variable)

 ** Exceptions:

 *

 * This macro documents the fact that the specified variable will no longer be

 * used.  One use is to indicate function parameters that are not used.  On

 * most compilers it will do nothing, but on compilers that support it it will

 * tell the compiler that the variable is not expected to be used.

 *

 ** Macro:	EXHAUSTIVE

 ** Exceptions:

 *

 * This macro documents the fact that the switch statement in which it appears

 * is meant to be exhaustive.  It is used as follows:

 *

 *	switch (expression) EXHAUSTIVE { ... }

 *

 ** Macro:	UNREACHED

 ** Exceptions:

 *

 * This macro documents the fact that the location that it occurs in should be

 * unreachable.

 *

 ** Macro:	FALL_THROUGH

 ** Exceptions:

 *

 * This macro documents the fact that the current case of a switch statement

 * should follow through into the next (immediately following) case.  It is

 * used as follows:

 *

 *	case 1:

 *	  ...

 *	  FALL_THROUGH;

 *	case 2:

 *	  ...

 *

 **** Change Log:

 * $Log: os-interface.h,v $

 * Revision 1.3  1998/03/16  11:26:35  release

 * Modifications prior to version 4.1.2.

 *

 * Revision 1.2  1998/02/04  10:46:57  release

 * Changes during testing.

 *

 * Revision 1.1.1.1  1998/01/17  15:57:45  release

 * First version to be checked into rolling release.

 *

 * Revision 1.3  1995/09/08  16:11:39  smf

 * Put braces into union initialisation macros (as per ANSI spec).

 * Guarded "gcc" builtin functions.

 *

 * Revision 1.2  1994/12/12  11:45:45  smf

 * Performing changes for 'CR94_178.sid+tld-update' - bringing in line with

 * OSSG C Coding Standards.

 *

 * Revision 1.1.1.1  1994/07/25  16:06:11  smf

 * Initial import of os-interface shared files.

 *

**/

/****************************************************************************/

#ifndef H_OS_INTERFACE

#define H_OS_INTERFACE

# ifdef FS_NO_SHORTNAMES

#  undef FS_SHORTNAMES

# endif /* defined (FS_NO_SHORTNAMES) */

# ifdef FS_NO_FAST

#  undef FS_FAST

# endif /* defined (FS_NO_FAST) */

# ifdef FS_SHORTNAMES

#  include "shortnames.h"

#  ifdef FS_FAST

#   include "fast-short.h"

#   undef FS_FAST

#  endif /* defined (FS_FAST) */

# endif /* defined (FS_SHORTNAMES) */

# ifndef FS_FAST

#  define FS_ASSERT

# endif /* !defined (FS_FAST) */

# ifdef FS_NO_ASSERT

#  undef FS_ASSERT

# endif /* defined (FS_NO_ASSERT) */

# ifndef FS_NO_STDC

#  ifdef __STDC__

#   define FS_STDC_HASH

#   define FS_PROTOTYPES

#   define FS_VOID_PTR

#   define FS_VOLATILE

#   define FS_CONST

#   define FS_UNION_INIT

#   define FS_ENUM

#   if __STDC__ == 1

#    define FS_ANSI_ENVIRON

#   endif /* __STDC__ == 1 */

#  endif /* defined (__STDC__) */

# endif /* !defined (FS_NO_STDC) */

# ifdef FS_NO_FILE_INFO

#  define __FILE__ "unknown"

#  define __LINE__ 0

# endif /* defined (FS_NO_FILE_INFO) */

# ifdef FS_NO_STDC_HASH

#  undef FS_STDC_HASH

# endif /* defined (FS_NO_STDC_HASH) */

# ifdef FS_NO_PROTOTYPES

#  undef FS_PROTOTYPES

# endif /* defined (FS_NO_PROTOTYPES) */

# ifdef FS_PROTOTYPES

#  define PROTO_S(ansi) ansi

#  define PROTO_N(names)

#  define PROTO_T(types) (types)

#  define PROTO_X ,

#  define PROTO_Z() (void)

# else

#  ifdef __TenDRA__

#   pragma TenDRA weak prototype analysis on

#   pragma TenDRA keyword KW_WEAK for weak

#   define PROTO_S(ansi) KW_WEAK ansi

#   define PROTO_N(names) names

#   define PROTO_T(types) types;

#   define PROTO_X ;

#   define PROTO_Z() ()

#  else

#   define PROTO_S(ansi) ()

#   define PROTO_N(names) names

#   define PROTO_T(types) types;

#   define PROTO_X ;

#   define PROTO_Z() ()

#  endif /* defined (__TenDRA__) */

# endif /* defined (FS_PROTOTYPES) */

# ifdef FS_NO_VOID_PTR

#  undef FS_VOID_PTR

# endif /* defined (FS_NO_VOID_PTR) */

# ifdef FS_VOID_PTR

typedef void *GenericP;

# else

typedef char *GenericP;

# endif /* defined (FS_VOID_PTR) */

# ifdef FS_NO_VOLATILE

#  undef FS_VOLATILE

# endif /* defined (FS_NO_VOLATILE) */

# ifndef FS_VOLATILE

#  define volatile

# endif /* !defined (FS_VOLATILE) */

# ifdef FS_NO_CONST

#  undef FS_CONST

# endif /* defined (FS_NO_CONST) */

# ifndef FS_CONST

#  define const

# endif /* !defined (FS_CONST) */

# ifdef FS_NO_UNION_INIT

#  undef FS_UNION_INIT

# endif /* defined (FS_NO_UNION_INIT) */

# ifdef FS_UNION_INIT

#  define UNION union

#  define UB {

#  define UE }

# else

#  define UNION struct

#  define UB {

#  define UE }

# endif /* defined (FS_UNION_INIT) */

# ifdef FS_NO_ENUM

#  undef FS_ENUM

# endif /* defined (FS_NO_ENUM) */

# ifndef FS_ENUM

#  ifndef FS_NO_ENUM

#   define FS_NO_ENUM

#  endif /* !defined (FS_NO_ENUM) */

# endif /* !defined (FS_ENUM) */

# ifdef FS_NO_ANSI_ENVIRON

#  undef FS_ANSI_ENVIRON

# endif /* defined (FS_NO_ANSI_ENVIRON) */

# ifdef FS_ANSI_ENVIRON

#  define FS_BINARY_STDIO

#  define FS_STRERROR

# endif /* defined (FS_ANSI_ENVIRON) */

# ifdef FS_NO_BINARY_STDIO

#  undef FS_BINARY_STDIO

# endif /* defined (FS_NO_BINARY_STDIO) */

# ifdef FS_NO_STRERROR

#  undef FS_STRERROR

# endif /* defined (FS_NO_STRERROR) */

# ifdef FS_NO_SYS_ERRLIST

#  undef FS_SYS_ERRLIST

# endif /* defined (FS_NO_SYS_ERRLIST) */

# ifdef FS_NO_MKDIR

#  undef FS_MKDIR

# endif /* defined (FS_NO_MKDIR) */

# ifdef __GNUC__

typedef __volatile__ void NoReturnT;

# else

#  ifdef __TenDRA__

#   pragma TenDRA type NoReturnT for bottom

#  else

#   define NoReturnT void

#  endif /* defined (__TenDRA__) */

# endif /* defined (__GNUC__) */

# ifdef __TenDRA__

#  pragma TenDRA keyword UNUSED for discard variable

# else

#  define UNUSED(v)

# endif /* defined (__TenDRA__) */

typedef char *CStringP;

typedef unsigned char ByteT, *ByteP;

typedef int BoolT, *BoolP;

# ifdef FS_NO_ENUM

typedef int CmpT, *CmpP;

# define CMP_LT	(0)

# define CMP_EQ	(1)

# define CMP_GT	(2)

# else

typedef enum {

    CMP_LT,

    CMP_EQ,

    CMP_GT

} CmpT, *CmpP;

# endif /* defined (FS_NO_ENUM) */

# define NIL(type) ((type) (0))

# define FALSE (0)

# define TRUE (1)

# ifdef __GNUC__

#  define INLINE __inline__

# else

#  define INLINE

# endif /* defined (__GNUC__) */

# ifdef FS_MKDIR

extern int			mkdir

	PROTO_S ((CStringP, int));

# endif /* defined (FS_MKDIR) */

# ifdef FS_ASSERT

extern void			E_assertion_failed

	PROTO_S ((CStringP, CStringP, unsigned));

#  ifdef FS_STDC_HASH

#   define ASSERT(a) \

if (!(a)) { \

    E_assertion_failed (#a, __FILE__, (unsigned) __LINE__); \

    abort (); \

}

#  else

#   define ASSERT(a) \

if (!(a)) { \

    E_assertion_failed ("<unavailable>", __FILE__, (unsigned) __LINE__); \

    abort (); \

}

#  endif /* defined (FS_STDC_HASH) */

# else

#  define ASSERT(a)

# endif /* defined (FS_ASSERT) */

# ifdef __TenDRA__

#  pragma TenDRA keyword EXHAUSTIVE for exhaustive

#  pragma TenDRA keyword FALL_THROUGH for fall into case

#  pragma TenDRA keyword UNREACHED for set unreachable

# else

#  define EXHAUSTIVE

#  define FALL_THROUGH

#  define UNREACHED ASSERT (FALSE)

# endif /* defined (__TenDRA__) */

# ifdef FS_ANSI_ENVIRON

#  include <errno.h>

#  include <limits.h>

#  include <setjmp.h>

#  include <stddef.h>

#  include <stdio.h>

#  include <stdlib.h>

#  include <string.h>

typedef size_t SizeT, *SizeP;

# else

#  ifdef PO_SIZE_T_TYPE

typedef PO_SIZE_T_TYPE SizeT, *SizeP;