version.h

Go to the documentation of this file.

/*
 * 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
 
struct dpkg_version {
        unsigned int epoch;
        const char *version;
        const char *revision;
};
 
#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 dpkg_relation {
        DPKG_RELATION_NONE      = 0,
        DPKG_RELATION_EQ        = DPKG_BIT(0),
        DPKG_RELATION_LT        = DPKG_BIT(1),
        DPKG_RELATION_LE        = DPKG_RELATION_LT | DPKG_RELATION_EQ,
        DPKG_RELATION_GT        = DPKG_BIT(2),
        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 */