Interface of the argument parser

src/lib/Makefile.dir

+LIBRARIES += src/lib/libupdater
+
+libupdater_MODULES := \
+	arguments

src/lib/arguments.c

+/*
+ * Copyright 2016, CZ.NIC z.s.p.o. (http://www.nic.cz/)
+ *
+ * This file is part of NUCI configuration server.
+ *
+ * NUCI is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ *  (at your option) any later version.
+ *
+ * NUCI is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with NUCI.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+#include "arguments.h"
+
+struct cmd_op *cmd_args_parse(int argc, char *argv[]) {
+	// TODO
+}

src/lib/arguments.h

+/*
+ * Copyright 2016, CZ.NIC z.s.p.o. (http://www.nic.cz/)
+ *
+ * This file is part of NUCI configuration server.
+ *
+ * NUCI is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ *  (at your option) any later version.
+ *
+ * NUCI is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with NUCI.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+#ifndef UPDATER_ARGUMENTS_H
+#define UPDATER_ARGUMENTS_H
+
+// An operation type to be performed
+enum cmd_op_type {
+	// Terminate with non-zero exit code.
+	COT_CRASH,
+	// Terminate with zero exit code.
+	COT_EXIT,
+	// Print help.
+	COT_HELP,
+	// Clean up any unfinished journal work and roll back whatever can be.
+	COT_JOURNAL_ABORT,
+	// Resume interrupted operation from journal, if any is there.
+	COT_JOURNAL_RESUME,
+	// Install a package. A parameter is passed, with the path to the .ipk file.
+	COT_INSTALL,
+	// Remove a package from the system. A parameter is passed with the name of the package.
+	COT_REMOVE
+};
+
+// A whole operation to be performed, with any needed parameter.
+struct cmd_op {
+	// What to do.
+	enum cmd_op_type type;
+	// With what. If the type doesn't expect a parameter, it is set to NULL.
+	const char *parameter;
+};
+
+/*
+ * Parse the command line arguments (or any other string array,
+ * as passed) and produce list of requested operations. Note that
+ * the operations don't have to correspond one to one with the
+ * arguments.
+ *
+ * The result is allocated on the heap. The parameters are not
+ * allocated, they point to the strings passed in argv.
+ *
+ * The result is always terminated by an operation of type COT_CRASH
+ * or COT_EXIT.
+ */
+struct cmd_op *cmd_args_parse(int argc, char *argv[]) __attribute__((nonnull)) __attribute__((returns_nonnull));
+
+#endif

src/opkg-trans/Makefile.dir

+BINARIES += src/opkg-trans/opkg-trans
+
+opkg-trans_MODULES := main
+opkg-trans_LOCAL_LIBS := updater

src/opkg-trans/main.c

+/*
+ * Copyright 2016, CZ.NIC z.s.p.o. (http://www.nic.cz/)
+ *
+ * This file is part of NUCI configuration server.
+ *
+ * NUCI is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ *  (at your option) any later version.
+ *
+ * NUCI is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with NUCI.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+#include "../lib/arguments.h"
+
+#include <stdlib.h>
+
+int main(int argc, char *argv[]) {
+	struct cmd_op *ops = cmd_args_parse(argc, argv);
+	// TODO: Perform the operations
+	free(ops);
+	return 0;
+}