#ifndef TOKSVC_H

#define TOKSVC_H

#include <stdint.h>

#include <stddef.h>

#include "toksvc_api.h"

#ifdef __cplusplus

extern "C" {

#endif

/* pre-alpha */

#ifndef TOKS_APP

#ifndef TOKS_PRE_ALPHA

#error  libtoks: pre-alpha: ABI is not final!

#error  to use the library, compile with -DTOKS_PRE_ALPHA.

#endif

#endif

/* daemon */

#define TOKS_PORT_GUID_DAEMON		{0x7d36f145,  \

					  0xd8f0,     \

					  0x440f,     \

					 {0x92,0xbe,0xc3,0x53,0x61,0x7b,0xbc,0x96}}

#define TOKS_PORT_NAME_PREFIX		{'t','o','k','s','v','c'}

/* status codes */

#define TOKS_OK				0x00

#define TOKS_USAGE			0x01

#define TOKS_ERROR			0x02

/* driver flags */

#define TOKS_DRIVER_VERBOSITY_NONE	0x0000

#define TOKS_DRIVER_VERBOSITY_ERRORS	0x0001

#define TOKS_DRIVER_VERBOSITY_STATUS	0x0002

#define TOKS_DRIVER_VERBOSITY_USAGE	0x0004

#define TOKS_DRIVER_CLONE_VECTOR	0x0008

#define TOKS_DRIVER_VERSION		0x0010

#define TOKS_DRIVER_DRY_RUN		0x0020

#define TOKS_DRIVER_DAEMON_ALWAYS	0x0040

#define TOKS_DRIVER_DAEMON_NEVER	0x0080

#define TOKS_DRIVER_ANNOTATE_ALWAYS	0x1000

#define TOKS_DRIVER_ANNOTATE_NEVER	0x2000

#define TOKS_DRIVER_ANNOTATE_FULL	0x4000

#define TOKS_DRIVER_MODE_SERVER		0X10000

#define TOKS_DRIVER_MODE_CLIENT		0X20000

#define TOKS_DRIVER_ACTION_ACQUIRE	0X100000

#define TOKS_DRIVER_ACTION_RELEASE	0X200000

#define TOKS_DRIVER_ACTION_ABORT	0X400000

/* error flags */

#define TOKS_ERROR_TOP_LEVEL		0x0001

#define TOKS_ERROR_NESTED		0x0002

#define TOKS_ERROR_CHILD		0x0004

#define TOKS_ERROR_CUSTOM		0x0008

enum toks_custom_error {

	TOKS_ERR_FLOW_ERROR,

	TOKS_ERR_FLEE_ERROR,

	TOKS_ERR_NULL_CONTEXT,

	TOKS_ERR_BAD_DATA,

	TOKS_ERR_CAP,

};

enum toks_warning_level {

	TOKS_WARNING_LEVEL_UNKNOWN,

	TOKS_WARNING_LEVEL_ALL,

	TOKS_WARNING_LEVEL_ERROR,

	TOKS_WARNING_LEVEL_NONE,

};

struct toks_source_version {

	int		major;

	int		minor;

	int		revision;

	const char *	commit;

};

struct toks_token_string{

	char            token[128];

};

struct toks_error_info {

	const struct toks_driver_ctx *	edctx;

	const struct toks_unit_ctx *	euctx;

	const char *			eunit;

	int				esyscode;

	int				elibcode;

	const char *			efunction;

	int				eline;

	unsigned			eflags;

	void *				eany;

};

struct toks_common_ctx {

	uint64_t			drvflags;

	uint64_t			actflags;

	uint64_t			fmtflags;

	int32_t				loglevel;

	const nt_guid *			uuid;

	void *				hroot;

	const char *			sysroot;

	char **				eargv;

};

struct toks_driver_ctx {

	const char **                   units;

	const char *			program;

	const char *			module;

	const struct toks_common_ctx *	cctx;

	struct toks_error_info **	errv;

	void *				any;

};

/* driver api */

toks_api int  toks_get_driver_ctx       (char ** argv, char ** envp, uint32_t flags,

                                         struct toks_driver_ctx **);

toks_api void toks_free_driver_ctx      (struct toks_driver_ctx *);

toks_api void toks_driver_set_timeout   (struct toks_driver_ctx *, int64_t millisecs);

toks_api void toks_driver_unset_timeout (struct toks_driver_ctx *);

/* core api */

toks_api int  toks_service_abort        (struct toks_driver_ctx *);

/* client api */

toks_api int  toks_client_connect       (struct toks_driver_ctx *);

toks_api int  toks_client_acquire       (struct toks_driver_ctx *);

toks_api int  toks_client_release       (struct toks_driver_ctx *);

toks_api int  toks_client_token_to_str  (struct toks_driver_ctx *, struct toks_token_string *);

toks_api int  toks_client_str_to_token  (struct toks_driver_ctx *, const struct toks_token_string *);

/* utility api */

toks_api int  toks_main                 (char **, char **);

/* error trace api */

toks_api int  toks_output_error_record  (const struct toks_driver_ctx *, const struct toks_error_info *);

toks_api int  toks_output_error_vector  (const struct toks_driver_ctx *);

/* package info */

toks_api const struct toks_source_version * toks_source_version(void);

#ifdef __cplusplus

}

#endif

#endif