summaryrefslogtreecommitdiffhomepage
path: root/include/ntux/ntux.h
diff options
context:
space:
mode:
Diffstat (limited to 'include/ntux/ntux.h')
-rw-r--r--include/ntux/ntux.h84
1 files changed, 84 insertions, 0 deletions
diff --git a/include/ntux/ntux.h b/include/ntux/ntux.h
new file mode 100644
index 0000000..896f301
--- /dev/null
+++ b/include/ntux/ntux.h
@@ -0,0 +1,84 @@
+#ifndef NTUX_H
+#define NTUX_H
+
+#include <stdint.h>
+
+#include "ntux_api.h"
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/* pre-alpha */
+#ifndef NTUX_APP
+#ifndef NTUX_PRE_ALPHA
+#error libntux: pre-alpha: ABI is not final!
+#error to use the library, please pass -DNTUX_PRE_ALPHA to the compiler.
+#endif
+#endif
+
+/* status codes */
+#define NTUX_OK 0x00
+#define NTUX_USAGE 0x01
+#define NTUX_ERROR 0x02
+
+/* driver flags */
+#define NTUX_DRIVER_VERBOSITY_NONE 0x0000
+#define NTUX_DRIVER_VERBOSITY_ERRORS 0x0001
+#define NTUX_DRIVER_VERBOSITY_STATUS 0x0002
+#define NTUX_DRIVER_VERBOSITY_USAGE 0x0004
+#define NTUX_DRIVER_CLONE_VECTOR 0x0008
+
+#define NTUX_DRIVER_VERSION 0x0010
+#define NTUX_DRIVER_DRY_RUN 0x0020
+
+struct ntux_source_version {
+ int major;
+ int minor;
+ int revision;
+ const char * commit;
+};
+
+struct ntux_error_info {
+ const struct ntux_driver_ctx * edctx;
+ const struct ntux_unit_ctx * euctx;
+ const char * eunit;
+ int esyscode;
+ int elibcode;
+ const char * efunction;
+ int eline;
+ unsigned eflags;
+ void * eany;
+};
+
+struct ntux_common_ctx {
+ uint64_t drvflags;
+ uint64_t actflags;
+ uint64_t fmtflags;
+};
+
+struct ntux_driver_ctx {
+ const char ** units;
+ const char * program;
+ const char * module;
+ const struct ntux_common_ctx * cctx;
+ struct ntux_error_info ** errv;
+ void * any;
+};
+
+/* package info */
+ntux_api const struct ntux_source_version * ntux_source_version(void);
+
+/* driver api */
+ntux_api int ntux_get_driver_ctx (char ** argv, char ** envp, uint32_t flags, struct ntux_driver_ctx **);
+ntux_api int ntux_create_driver_ctx (const struct ntux_common_ctx *, struct ntux_driver_ctx **);
+ntux_api void ntux_free_driver_ctx (struct ntux_driver_ctx *);
+
+/* utility api */
+ntux_api int ntux_main (int, char **, char **);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif