/*
 * Copyright (c) 1993, 1995, Oracle and/or its affiliates. All rights reserved.
 *
 * Permission is hereby granted, free of charge, to any person obtaining a
 * copy of this software and associated documentation files (the "Software"),
 * to deal in the Software without restriction, including without limitation
 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
 * and/or sell copies of the Software, and to permit persons to whom the
 * Software is furnished to do so, subject to the following conditions:
 *
 * The above copyright notice and this permission notice (including the next
 * paragraph) shall be included in all copies or substantial portions of the
 * Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
 * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
 * DEALINGS IN THE SOFTWARE.
 */


/*
 *  This file defines the private and public interfaces to the OWconfig API.
 */

#ifndef  _X_CONFIG_H_
#define  _X_CONFIG_H_

#include <stdio.h>
#include <sys/types.h>
#include <X11/X.h>

#define OWCFG_OK		(Success)
#define OWCFG_OPEN1FAIL		(Success+1)
#define OWCFG_OPEN2FAIL		(Success+2)
#define OWCFG_OPENBOTHFAIL	(Success+3)
#define OWCFG_FSTAT1FAIL	(Success+4)
#define OWCFG_FSTAT2FAIL	(Success+5)
#define OWCFG_LOCK1FAIL		(Success+6)
#define OWCFG_LOCK2FAIL		(Success+7)
#define OWCFG_SYNTAX1		(Success+8)
#define OWCFG_SYNTAX2		(Success+9)
#define OWCFG_PKGNAME		(Success+10)
#define OWCFG_CLASSNAME		(Success+11)
#define OWCFG_INSTANCENAME	(Success+12)
#define OWCFG_ALLOC		(Success+13)
#define OWCFG_ARGS		(Success+14)
#define OWCFG_OPENTMPFAIL	(Success+15)
#define OWCFG_OPENWFAIL		(Success+16)
#define OWCFG_LOCKWFAIL		(Success+17)
#define OWCFG_RENAMEFAIL	(Success+18)


typedef struct {
	char *attribute;
	char *value;
} OWconfigAttribute, *OWconfigAttributePtr;





#if defined(__cplusplus) || defined(c_plusplus)
extern "C" {
#endif /* __cplusplus */




/*
 * The functions:
 *		OWconfigGetClassNames
 *		OWconfigFreeClassNames
 *		OWconfigGetAttribute
 *		OWconfigFreeAttribute
 *		OWconfigGetInstance
 *		OWconfigFreeInstance
 *
 * are provided for the use of those wishing to develop DDX drivers
 * for the Xsun server.  Please refer to the OpenWindows Server
 * Device Developer's Guide for more information.
 */

#if defined(__STDC__)

extern char **
OWconfigGetClassNames(char * /*class*/);

extern void
OWconfigFreeClassNames(char ** /*list*/);

extern char *
OWconfigGetAttribute(char * /*class*/, char * /*name*/, char * /*attribute*/);

extern void
OWconfigFreeAttribute(char * /*attribute*/);

extern OWconfigAttributePtr
OWconfigGetInstance(char * /*class*/, char * /*name*/, int * /*numberInattr*/);

extern void
OWconfigFreeInstance(OWconfigAttributePtr /*attr*/, int /*numberInAttr*/);


#else /* ! __STDC__ */

extern char **
OWconfigGetClassNames(/*char *class*/);

extern void
OWconfigFreeClassNames(/*char **list*/);

extern char *
OWconfigGetAttribute(/*char *class, char *name, char *attribute*/);

extern void
OWconfigFreeAttribute(/*char *attribute*/);

extern OWconfigAttributePtr
OWconfigGetInstance(/*char *class, char *name, int *numberInattr*/);

extern void
OWconfigFreeInstance(/*OWconfigAttributePtr attr, int numberInAttr*/);

#endif /* __STDC__ */





/*
 * The functions:
 *		OWconfigInit
 *		OWconfigValidate
 *		OWconfigSetInstance
 *		OWconfigRemoveInstance
 *		OWconfigSetAttribute
 *		OWconfigSetPackage
 *		OWconfigRemovePackage
 *		OWconfigClose
 *
 * are categorized as "Sun Private".  They should not be used by
 * developers outside of Sun Microsystems Inc., or its subsidiaries.
 */

#define OWFLAG_RETAIN 1

#if defined(__STDC__)

extern int
OWconfigInit(char * /*readfile1*/, char * /*readfile2*/, int /*flags*/,
             void *(* /*allocmem*/)(unsigned), void (* /*freemem*/)(void *));

extern int
OWconfigValidate(void);

extern int
OWconfigSetInstance(char * /*class*/, char * /*name*/, 
                    OWconfigAttributePtr /*attr*/,
                    int /*numberInattr*/);

extern int
OWconfigRemoveInstance(char * /*class*/, char * /*name*/);

extern int
OWconfigSetAttribute(char * /*class*/, char * /*name*/, char * /*attribute*/, 
                     char * /*value*/);

extern void
OWconfigSetPackage(char * /*package*/);

extern int
OWconfigRemovePackage(char * /*package*/);

extern int
OWconfigClose(char */*writeFile*/);


#else /* ! __STDC__ */


extern int
OWconfigInit(/*char *readfile1, char *readfile2, int flags,
             void *(*allocmem)(), void (*freemem)()*/);

extern int
OWconfigValidate(/*void*/);

extern int
OWconfigSetInstance(/*char *class, char *name, 
                    OWconfigAttributePtr attr,
                    int numberInattr*/);

extern int
OWconfigRemoveInstance(/*char *class, char *name*/);

extern int
OWconfigSetAttribute(/*char *class, char *name, char *attribute, 
                     char *value*/);

extern void
OWconfigSetPackage(/*char *package*/);

extern int
OWconfigRemovePackage(/*char *package*/);

extern int
OWconfigClose(/*char *writeFile*/);


#endif /* __STDC__ */




#if defined(__cplusplus) || defined(c_plusplus)
}
#endif /* __cplusplus */

#endif /* _X_CONFIG_H_ */