all files are in root; changed help message

1 files changed, 75 insertions, 0 deletions

diff --git a/cliflags.h b/cliflags.h
new file mode 100644
index 0000000..5bf251b
--- /dev/null
+++ b/cliflags.h
@@ -0,0 +1,75 @@
+/*-
+ * Copyright (c) 2026, Mr. Goblin
+ *
+ * SPDX-License-Identifier: BSD-2-Clause
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ * 1. Redistributions of source code must retain the above copyright
+ * notice, this list of conditions and the following disclaimer.
+ *
+ * 2. Redistributions in binary form must reproduce the above
+ * copyright notice, this list of conditions and the following
+ * disclaimer in the documentation and/or other materials provided
+ * with the distribution.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT
+ * NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
+ * FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL
+ * THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT
+ * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING
+ * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
+ * OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
+ * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY
+ * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
+ * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY
+ * OF SUCH DAMAGE.
+ */
+
+#ifndef BTASKTD_CLIFLAGS_H_SENTRY
+#define BTASKTD_CLIFLAGS_H_SENTRY
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+enum flag_val_res {
+	fvr_ok = 0,
+	fvr_min = fvr_ok,
+	fvr_not_found,
+	fvr_invalid,
+	fvr_max = fvr_invalid
+};
+
+struct str_flag_val {
+	enum flag_val_res code;
+	char *data;
+};
+
+struct int_flag_val {
+	enum flag_val_res code;
+	int data;
+};
+
+struct bool_flag_val {
+	enum flag_val_res code;
+	int data;
+};
+
+/* -f */
+struct bool_flag_val
+extract_bool_flag(char flagletter, int argc, char **argv);
+
+/* -f the_str */
+struct str_flag_val
+extract_str_flag(char flagletter, int argc, char **argv);
+
+/* -f number */
+struct int_flag_val
+extract_int_flag(char flagletter, int argc, char **argv);
+
+#ifdef __cplusplus
+}
+#endif
+#endif /* BTASKTD_CLIFLAGS_H_SENTRY */