rhughes@241: /* rhughes@241: * Copyright (C) 2008 Kristian Høgsberg rhughes@241: * Copyright (C) 2008 Red Hat, Inc rhughes@241: * rhughes@241: * This program is free software; you can redistribute it and/or modify rhughes@241: * it under the terms of the GNU General Public License as published by rhughes@241: * the Free Software Foundation; either version 2 of the License, or rhughes@241: * (at your option) any later version. rhughes@241: * rhughes@241: * This program is distributed in the hope that it will be useful, rhughes@241: * but WITHOUT ANY WARRANTY; without even the implied warranty of rhughes@241: * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the rhughes@241: * GNU General Public License for more details. rhughes@241: * rhughes@241: * You should have received a copy of the GNU General Public License along rhughes@241: * with this program; if not, write to the Free Software Foundation, Inc., rhughes@241: * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. rhughes@241: */ rhughes@241: rhughes@241: #ifndef _RAZOR_H_ rhughes@241: #define _RAZOR_H_ rhughes@241: rhughes@241: #define ARRAY_SIZE(a) (sizeof(a) / sizeof((a)[0])) rhughes@241: rhughes@241: struct razor_set; rhughes@241: struct razor_package; rhughes@241: struct razor_property; rhughes@241: rhughes@241: enum razor_property_type { rhughes@241: RAZOR_PROPERTY_REQUIRES, rhughes@241: RAZOR_PROPERTY_PROVIDES, rhughes@241: RAZOR_PROPERTY_CONFLICTS, rhughes@241: RAZOR_PROPERTY_OBSOLETES rhughes@241: }; rhughes@241: rhughes@241: enum razor_version_relation { rhughes@241: RAZOR_VERSION_LESS, rhughes@241: RAZOR_VERSION_LESS_OR_EQUAL, rhughes@241: RAZOR_VERSION_EQUAL, rhughes@241: RAZOR_VERSION_GREATER_OR_EQUAL, rhughes@241: RAZOR_VERSION_GREATER rhughes@241: }; rhughes@241: extern const char * const razor_version_relations[]; rhughes@241: rhughes@241: struct razor_set *razor_set_create(void); rhughes@241: struct razor_set *razor_set_open(const char *filename); rhughes@241: void razor_set_destroy(struct razor_set *set); rhughes@241: int razor_set_write_to_fd(struct razor_set *set, int fd); rhughes@241: int razor_set_write(struct razor_set *set, const char *filename); rhughes@241: rhughes@241: struct razor_package * rhughes@241: razor_set_get_package(struct razor_set *set, const char *package); rhughes@241: rhughes@241: struct razor_package_iterator; rhughes@241: struct razor_package_iterator * rhughes@241: razor_package_iterator_create(struct razor_set *set); rhughes@241: struct razor_package_iterator * rhughes@241: razor_package_iterator_create_for_property(struct razor_set *set, rhughes@241: struct razor_property *property); rhughes@241: struct razor_package_iterator * rhughes@241: razor_package_iterator_create_for_file(struct razor_set *set, rhughes@241: const char *filename); rhughes@241: rhughes@241: int razor_package_iterator_next(struct razor_package_iterator *pi, rhughes@241: struct razor_package **package, rhughes@241: const char **name, rhughes@241: const char **version, rhughes@241: const char **arch); rhughes@241: void razor_package_iterator_destroy(struct razor_package_iterator *pi); rhughes@241: rhughes@241: struct razor_package_query * rhughes@241: razor_package_query_create(struct razor_set *set); rhughes@241: void rhughes@241: razor_package_query_add_package(struct razor_package_query *pq, rhughes@241: struct razor_package *p); rhughes@241: void rhughes@241: razor_package_query_add_iterator(struct razor_package_query *pq, rhughes@241: struct razor_package_iterator *pi); rhughes@241: struct razor_package_iterator * rhughes@241: razor_package_query_finish(struct razor_package_query *pq); rhughes@241: rhughes@241: struct razor_property_iterator; rhughes@241: struct razor_property_iterator * rhughes@241: razor_property_iterator_create(struct razor_set *set, rhughes@241: struct razor_package *package); rhughes@241: int razor_property_iterator_next(struct razor_property_iterator *pi, rhughes@241: struct razor_property **property, rhughes@241: const char **name, rhughes@241: enum razor_version_relation *relation, rhughes@241: const char **version, rhughes@241: enum razor_property_type *type); rhughes@241: void rhughes@241: razor_property_iterator_destroy(struct razor_property_iterator *pi); rhughes@241: rhughes@241: void razor_set_list_files(struct razor_set *set, const char *prefix); rhughes@241: void razor_set_list_package_files(struct razor_set *set, const char *name); rhughes@241: rhughes@241: void razor_set_list_unsatisfied(struct razor_set *set); rhughes@241: rhughes@241: typedef void (*razor_package_callback_t)(const char *name, rhughes@241: const char *old_version, rhughes@241: const char *new_version, rhughes@241: const char *arch, rhughes@241: void *data); rhughes@241: void rhughes@241: razor_set_diff(struct razor_set *set, struct razor_set *upstream, rhughes@241: razor_package_callback_t callback, void *data); rhughes@241: rhughes@241: /* Package transactions */ rhughes@241: rhughes@241: struct razor_transaction * rhughes@241: razor_transaction_create(struct razor_set *system, struct razor_set *upstream); rhughes@241: void razor_transaction_install_package(struct razor_transaction *transaction, rhughes@241: struct razor_package *package); rhughes@241: void razor_transaction_remove_package(struct razor_transaction *transaction, rhughes@241: struct razor_package *package); rhughes@241: void razor_transaction_update_package(struct razor_transaction *trans, rhughes@241: struct razor_package *package); rhughes@241: void razor_transaction_update_all(struct razor_transaction *transaction); rhughes@241: int razor_transaction_resolve(struct razor_transaction *trans); rhughes@241: int razor_transaction_describe(struct razor_transaction *trans); rhughes@241: struct razor_set *razor_transaction_finish(struct razor_transaction *trans); rhughes@241: void razor_transaction_destroy(struct razor_transaction *trans); rhughes@241: rhughes@241: /* Temporary helper for test suite. */ rhughes@241: int razor_transaction_unsatisfied_property(struct razor_transaction *trans, rhughes@241: const char *name, rhughes@241: enum razor_version_relation rel, rhughes@241: const char *version, rhughes@241: enum razor_property_type type); rhughes@241: rhughes@241: /* Importer interface; for building a razor set from external sources, rhughes@241: * like yum, rpmdb or razor package files. */ rhughes@241: rhughes@241: struct razor_importer; rhughes@241: struct razor_rpm; rhughes@241: rhughes@241: struct razor_importer *razor_importer_new(void); rhughes@241: void razor_importer_destroy(struct razor_importer *importer); rhughes@241: void razor_importer_begin_package(struct razor_importer *importer, rhughes@241: const char *name, rhughes@241: const char *version, rhughes@241: const char *arch); rhughes@241: void razor_importer_add_property(struct razor_importer *importer, rhughes@241: const char *name, rhughes@241: enum razor_version_relation relation, rhughes@241: const char *version, rhughes@241: enum razor_property_type type); rhughes@241: void razor_importer_add_file(struct razor_importer *importer, rhughes@241: const char *name); rhughes@241: void razor_importer_finish_package(struct razor_importer *importer); rhughes@241: rhughes@241: int razor_importer_add_rpm(struct razor_importer *importer, rhughes@241: struct razor_rpm *rpm); rhughes@241: rhughes@241: struct razor_set *razor_importer_finish(struct razor_importer *importer); rhughes@241: rhughes@241: void razor_build_evr(char *evr_buf, int size, const char *epoch, rhughes@241: const char *version, const char *release); rhughes@241: rhughes@241: struct razor_set *razor_set_create_from_yum(void); rhughes@241: struct razor_set *razor_set_create_from_rpmdb(void); rhughes@241: rhughes@241: /* RPM functions */ rhughes@241: rhughes@241: struct razor_rpm *razor_rpm_open(const char *filename); rhughes@241: int razor_rpm_install(struct razor_rpm *rpm, const char *root); rhughes@241: int razor_rpm_close(struct razor_rpm *rpm); rhughes@241: rhughes@241: rhughes@241: /* Razor root functions. The root data struct encapsulates filesystem rhughes@241: * conventions and the locking protocol. */ rhughes@241: rhughes@241: struct razor_root; rhughes@241: #define RAZOR_ROOT_OPEN_WRITE 0x01 rhughes@241: rhughes@241: int razor_root_create(const char *root); rhughes@241: struct razor_root *razor_root_open(const char *root, int flags); rhughes@241: struct razor_set *razor_root_open_read_only(const char *root); rhughes@241: struct razor_transaction * rhughes@241: razor_root_create_transaction(struct razor_root *image, rhughes@241: struct razor_set *upstream); rhughes@241: int razor_root_close(struct razor_root *image); rhughes@241: void razor_root_update(struct razor_root *image, struct razor_set *next); rhughes@241: int razor_root_commit(struct razor_root *image); rhughes@241: void razor_root_diff(struct razor_root *root, rhughes@241: razor_package_callback_t callback, void *data); rhughes@241: rhughes@241: #endif /* _RAZOR_H_ */