summaryrefslogtreecommitdiffstats
path: root/lib/dpkg/version.h
diff options
context:
space:
mode:
Diffstat (limited to 'lib/dpkg/version.h')
-rw-r--r--lib/dpkg/version.h91
1 files changed, 91 insertions, 0 deletions
diff --git a/lib/dpkg/version.h b/lib/dpkg/version.h
new file mode 100644
index 0000000..cbc7607
--- /dev/null
+++ b/lib/dpkg/version.h
@@ -0,0 +1,91 @@
+/*
+ * libdpkg - Debian packaging suite library routines
+ * version.h - version handling routines
+ *
+ * Copyright © 1994,1995 Ian Jackson <ijackson@chiark.greenend.org.uk>
+ * Copyright © 2011-2014 Guillem Jover <guillem@debian.org>
+ *
+ * This 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 2 of the License, or
+ * (at your option) any later version.
+ *
+ * This 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 this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+
+#ifndef LIBDPKG_VERSION_H
+#define LIBDPKG_VERSION_H
+
+#include <stdbool.h>
+
+#include <dpkg/macros.h>
+
+DPKG_BEGIN_DECLS
+
+/**
+ * @defgroup version Version handling
+ * @ingroup dpkg-public
+ * @{
+ */
+
+/**
+ * Data structure representing a Debian version.
+ *
+ * @see deb-version(5)
+ */
+struct dpkg_version {
+ /** The epoch. It will be zero if no epoch is present. */
+ unsigned int epoch;
+ /** The upstream part of the version. */
+ const char *version;
+ /** The Debian revision part of the version. */
+ const char *revision;
+};
+
+/**
+ * Compound literal for a dpkg_version.
+ */
+#define DPKG_VERSION_OBJECT(e, v, r) \
+ (struct dpkg_version){ .epoch = (e), .version = (v), .revision = (r) }
+
+#define DPKG_VERSION_INIT \
+ DPKG_VERSION_OBJECT(0, NULL, NULL)
+
+/**
+ * Enum constants for the supported relation operations that can be done
+ * on Debian versions.
+ */
+enum dpkg_relation {
+ /** The “none” relation, sentinel value. */
+ DPKG_RELATION_NONE = 0,
+ /** Equality relation (‘=’). */
+ DPKG_RELATION_EQ = DPKG_BIT(0),
+ /** Less than relation (‘<<’). */
+ DPKG_RELATION_LT = DPKG_BIT(1),
+ /** Less than or equal to relation (‘<=’). */
+ DPKG_RELATION_LE = DPKG_RELATION_LT | DPKG_RELATION_EQ,
+ /** Greater than relation (‘>>’). */
+ DPKG_RELATION_GT = DPKG_BIT(2),
+ /** Greater than or equal to relation (‘>=’). */
+ DPKG_RELATION_GE = DPKG_RELATION_GT | DPKG_RELATION_EQ,
+};
+
+void dpkg_version_blank(struct dpkg_version *version);
+bool dpkg_version_is_informative(const struct dpkg_version *version);
+int dpkg_version_compare(const struct dpkg_version *a,
+ const struct dpkg_version *b);
+bool dpkg_version_relate(const struct dpkg_version *a,
+ enum dpkg_relation rel,
+ const struct dpkg_version *b);
+
+/** @} */
+
+DPKG_END_DECLS
+
+#endif /* LIBDPKG_VERSION_H */