/*

 * Copyright 1995 Sun Microsystems, Inc.  All rights reserved.

 * Use is subject to license terms.

 *

 * 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, and/or sell copies of the Software, and to permit persons

 * to whom the Software is furnished to do so, provided that the above

 * copyright notice(s) and this permission notice appear in all copies of

 * the Software and that both the above copyright notice(s) and this

 * permission notice appear in supporting documentation.

 * 

 * 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

 * OF THIRD PARTY RIGHTS. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR

 * HOLDERS INCLUDED IN THIS NOTICE BE LIABLE FOR ANY CLAIM, OR ANY SPECIAL

 * INDIRECT OR CONSEQUENTIAL DAMAGES, OR ANY DAMAGES WHATSOEVER RESULTING

 * FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT,

 * NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION

 * WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

 * 

 * Except as contained in this notice, the name of a copyright holder

 * shall not be used in advertising or otherwise to promote the sale, use

 * or other dealings in this Software without prior written authorization

 * of the copyright holder.

 */

#pragma ident	"@(#)Sunowconfig.h	1.19	09/11/09 SMI"

/*

 *  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_ */