created lib-app skeleton (foss21.org lib-app model).

3 files changed, 177 insertions, 0 deletions

diff --git a/include/empty.dir b/include/empty.dir
deleted file mode 100644
index e69de29..0000000
--- a/include/empty.dir
+++ /dev/null
diff --git a/include/tpax/tpax.h b/include/tpax/tpax.h
new file mode 100644
index 0000000..e89076d
--- /dev/null
+++ b/include/tpax/tpax.h
@@ -0,0 +1,142 @@
+#ifndef TPAX_H
+#define TPAX_H
+
+#include <stdint.h>
+#include <stddef.h>
+
+#include "tpax_api.h"
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/* pre-alpha */
+#ifndef TPAX_APP
+#ifndef TPAX_PRE_ALPHA
+#error  libtpax: pre-alpha: ABI is not final!
+#error  to use the library, compile with -DTPAX_PRE_ALPHA.
+#endif
+#endif
+
+/* status codes */
+#define TPAX_OK				0x00
+#define TPAX_USAGE			0x01
+#define TPAX_ERROR			0x02
+
+/* driver flags */
+#define TPAX_DRIVER_VERBOSITY_NONE	0x0000
+#define TPAX_DRIVER_VERBOSITY_ERRORS	0x0001
+#define TPAX_DRIVER_VERBOSITY_STATUS	0x0002
+#define TPAX_DRIVER_VERBOSITY_USAGE	0x0004
+#define TPAX_DRIVER_CLONE_VECTOR	0x0008
+
+#define TPAX_DRIVER_VERSION		0x0010
+#define TPAX_DRIVER_DRY_RUN		0x0020
+
+#define TPAX_DRIVER_ANNOTATE_ALWAYS	0x1000
+#define TPAX_DRIVER_ANNOTATE_NEVER	0x2000
+#define TPAX_DRIVER_ANNOTATE_FULL	0x4000
+
+/* error flags */
+#define TPAX_ERROR_TOP_LEVEL		0x0001
+#define TPAX_ERROR_NESTED		0x0002
+#define TPAX_ERROR_CHILD		0x0004
+#define TPAX_ERROR_CUSTOM		0x0008
+
+enum tpax_custom_error {
+	TPAX_ERR_FLOW_ERROR,
+	TPAX_ERR_FLEE_ERROR,
+	TPAX_ERR_NULL_CONTEXT,
+	TPAX_ERR_BAD_DATA,
+	TPAX_ERR_CAP,
+};
+
+enum tpax_warning_level {
+	TPAX_WARNING_LEVEL_UNKNOWN,
+	TPAX_WARNING_LEVEL_ALL,
+	TPAX_WARNING_LEVEL_ERROR,
+	TPAX_WARNING_LEVEL_NONE,
+};
+
+struct tpax_source_version {
+	int		major;
+	int		minor;
+	int		revision;
+	const char *	commit;
+};
+
+struct tpax_fd_ctx {
+	int		fdin;
+	int		fdout;
+	int		fderr;
+	int		fdlog;
+	int		fdcwd;
+	int		fddst;
+};
+
+struct tpax_error_info {
+	const struct tpax_driver_ctx *	edctx;
+	const struct tpax_unit_ctx *	euctx;
+	const char *			eunit;
+	int				esyscode;
+	int				elibcode;
+	const char *			efunction;
+	int				eline;
+	unsigned			eflags;
+	void *				eany;
+};
+
+struct tpax_common_ctx {
+	uint64_t			drvflags;
+	uint64_t			actflags;
+	uint64_t			fmtflags;
+};
+
+struct tpax_driver_ctx {
+	const char **                   units;
+	const char *			program;
+	const char *			module;
+	const struct tpax_common_ctx *	cctx;
+	struct tpax_error_info **	errv;
+	void *				any;
+};
+
+struct tpax_unit_ctx {
+	const char * const *		path;
+	void *				any;
+};
+
+/* driver api */
+tpax_api int  tpax_get_driver_ctx       (char ** argv, char ** envp, uint32_t flags,
+                                         const struct tpax_fd_ctx *,
+                                         struct tpax_driver_ctx **);
+
+tpax_api void tpax_free_driver_ctx      (struct tpax_driver_ctx *);
+
+tpax_api int  tpax_get_unit_ctx         (const struct tpax_driver_ctx *, const char * path,
+                                         struct tpax_unit_ctx **);
+
+tpax_api void tpax_free_unit_ctx        (struct tpax_unit_ctx *);
+
+tpax_api int  tpax_get_driver_fdctx     (const struct tpax_driver_ctx *, struct tpax_fd_ctx *);
+tpax_api int  tpax_set_driver_fdctx     (struct tpax_driver_ctx *, const struct tpax_fd_ctx *);
+
+/* core api */
+
+/* helper api */
+
+/* utility api */
+tpax_api int  tpax_main                 (char **, char **,
+                                         const struct tpax_fd_ctx *);
+/* error trace api */
+tpax_api int  tpax_output_error_record  (const struct tpax_driver_ctx *, const struct tpax_error_info *);
+tpax_api int  tpax_output_error_vector  (const struct tpax_driver_ctx *);
+
+/* package info */
+tpax_api const struct tpax_source_version * tpax_source_version(void);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif
diff --git a/include/tpax/tpax_api.h b/include/tpax/tpax_api.h
new file mode 100644
index 0000000..0e6db99
--- /dev/null
+++ b/include/tpax/tpax_api.h
@@ -0,0 +1,35 @@
+#ifndef TPAX_API_H
+#define TPAX_API_H
+
+#include <limits.h>
+
+/* tpax_export */
+#if	defined(__dllexport)
+#define tpax_export __dllexport
+#else
+#define tpax_export
+#endif
+
+/* tpax_import */
+#if	defined(__dllimport)
+#define tpax_import __dllimport
+#else
+#define tpax_import
+#endif
+
+/* tpax_api */
+#ifndef TPAX_APP
+#if     defined (TPAX_EXPORT)
+#define tpax_api tpax_export
+#elif   defined (TPAX_IMPORT)
+#define tpax_api tpax_import
+#elif   defined (TPAX_STATIC)
+#define tpax_api
+#else
+#define tpax_api
+#endif
+#else
+#define tpax_api
+#endif
+
+#endif