ali@452: /* ali@452: * Copyright (C) 2008 Kristian Høgsberg ali@452: * Copyright (C) 2008 Red Hat, Inc ali@499: * Copyright (C) 2009, 2011, 2012, 2014, 2016, 2018 ali@499: * J. Ali Harlow ali@452: * ali@452: * This program is free software; you can redistribute it and/or modify ali@452: * it under the terms of the GNU General Public License as published by ali@452: * the Free Software Foundation; either version 2 of the License, or ali@452: * (at your option) any later version. ali@452: * ali@452: * This program is distributed in the hope that it will be useful, ali@452: * but WITHOUT ANY WARRANTY; without even the implied warranty of ali@452: * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the ali@452: * GNU General Public License for more details. ali@452: * ali@452: * You should have received a copy of the GNU General Public License along ali@452: * with this program; if not, write to the Free Software Foundation, Inc., ali@452: * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. ali@452: */ ali@452: ali@452: #ifndef _RAZOR_H_ ali@452: #define _RAZOR_H_ ali@452: ali@457: #include ali@452: #include ali@475: #include ali@452: ali@452: /* GCC extensions */ ali@452: #if defined(__GNUC__) ali@452: #if __GNUC__ > 2 || (__GNUC__ == 2 && __GNUC_MINOR__ >= 96) ali@452: #define RAZOR_MALLOC __attribute__((__malloc__)) ali@452: #else ali@452: #define RAZOR_MALLOC ali@452: #endif ali@452: #if __GNUC__ >= 4 ali@452: #define RAZOR_NULL_TERMINATED __attribute__ ((__sentinel__)) ali@452: #else ali@452: #define RAZOR_NULL_TERMINATED ali@452: #endif ali@452: #endif /* __GNUC__ */ ali@452: ali@452: enum razor_section_type { ali@452: RAZOR_SECTION_MAIN = 0x01, ali@452: RAZOR_SECTION_DETAILS = 0x02, ali@452: RAZOR_SECTION_FILES = 0x04, ali@452: RAZOR_SECTION_ALL = 0x07 ali@452: }; ali@452: ali@452: enum razor_stage_type { ali@452: RAZOR_STAGE_SCRIPTS_PRE = 0x1, ali@452: RAZOR_STAGE_FILES = 0x2, ali@452: RAZOR_STAGE_SCRIPTS_POST = 0x4, ali@452: RAZOR_STAGE_SCRIPTS = 0x5, ali@452: RAZOR_STAGE_ALL = 0x7 ali@452: }; ali@452: ali@452: enum razor_detail_type { ali@452: RAZOR_DETAIL_LAST = 0, /* the sentinel */ ali@452: RAZOR_DETAIL_NAME, ali@452: RAZOR_DETAIL_VERSION, ali@452: RAZOR_DETAIL_ARCH, ali@452: RAZOR_DETAIL_SUMMARY, ali@452: RAZOR_DETAIL_DESCRIPTION, ali@452: RAZOR_DETAIL_URL, ali@452: RAZOR_DETAIL_LICENSE, ali@452: RAZOR_DETAIL_PREUNPROG, ali@452: RAZOR_DETAIL_PREUN, ali@452: RAZOR_DETAIL_POSTUNPROG, ali@452: RAZOR_DETAIL_POSTUN, ali@452: RAZOR_DETAIL_PREFIXES ali@452: }; ali@452: ali@452: enum razor_property_flags { ali@452: RAZOR_PROPERTY_LESS = 1 << 0, ali@452: RAZOR_PROPERTY_GREATER = 1 << 1, ali@452: RAZOR_PROPERTY_EQUAL = 1 << 2, ali@452: RAZOR_PROPERTY_RELATION_MASK = ali@452: RAZOR_PROPERTY_LESS | ali@452: RAZOR_PROPERTY_GREATER | ali@452: RAZOR_PROPERTY_EQUAL, ali@452: ali@452: RAZOR_PROPERTY_REQUIRES = 0 << 3, ali@452: RAZOR_PROPERTY_PROVIDES = 1 << 3, ali@452: RAZOR_PROPERTY_CONFLICTS = 2 << 3, ali@452: RAZOR_PROPERTY_OBSOLETES = 3 << 3, ali@452: RAZOR_PROPERTY_TYPE_MASK = 3 << 3, ali@452: ali@452: RAZOR_PROPERTY_PRE = 1 << 5, ali@452: RAZOR_PROPERTY_POST = 1 << 6, ali@452: RAZOR_PROPERTY_PREUN = 1 << 7, ali@452: RAZOR_PROPERTY_POSTUN = 1 << 8, ali@452: RAZOR_PROPERTY_SCRIPT_MASK = ali@452: RAZOR_PROPERTY_PRE | ali@452: RAZOR_PROPERTY_POST | ali@452: RAZOR_PROPERTY_PREUN | ali@452: RAZOR_PROPERTY_POSTUN ali@452: }; ali@452: ali@452: enum razor_set_flags { ali@452: /* ali@452: * Create a private copy of the razor set such that changes made ali@452: * to the underlying file are not visible in the razor set. ali@452: * If this flag is not set then the caller must ensure that the ali@452: * underlying file (if any) is not changed. ali@452: */ ali@452: RAZOR_SET_PRIVATE = 1 << 0, ali@452: }; ali@452: ali@452: /** ali@452: * SECTION:error ali@452: * @title: Error reporting ali@452: * @short_description: A system for reporting errors. ali@452: * ali@452: * This object represents an error condition. ali@452: */ ali@452: struct razor_error; ali@452: ali@452: struct razor_error *razor_error_new_str(int domain, int code, ali@452: const char *object, const char *str); ali@452: struct razor_error *razor_error_dup(struct razor_error *src, ali@452: const char *summary); ali@452: ali@452: #define razor_set_error(error, domain, code, object, str) \ ali@452: if (error) \ ali@452: *(error) = razor_error_new_str(domain, code, object, str); \ ali@452: else ali@452: ali@452: #define razor_propagate_error(dest, src, summary) \ ali@452: if (dest) \ ali@452: *(dest) = razor_error_dup(src, summary); \ ali@452: else ali@452: ali@475: #define razor_error_matches(error, domain, code) \ ali@475: ((error) && razor_error_get_domain(error) == (domain) && \ ali@475: razor_error_get_code(error) == (code)) ali@475: ali@452: #define RAZOR_ERROR_DOMAIN(i1,i2,i3,c) \ ali@452: (((i1)&0xff)<<24|((i2)&0xff)<<16|((i3)&0xff)<<8|(c)&0xff) ali@452: ali@452: #define RAZOR_GENERAL_ERROR RAZOR_ERROR_DOMAIN('R','z','r',0) ali@452: #define RAZOR_POSIX_ERROR RAZOR_ERROR_DOMAIN('R','z','r',1) ali@452: #define RAZOR_MSWIN_ERROR RAZOR_ERROR_DOMAIN('R','z','r',2) ali@452: #define RAZOR_ZLIB_ERROR RAZOR_ERROR_DOMAIN('R','z','r',3) ali@452: ali@452: enum razor_general_error { ali@452: RAZOR_GENERAL_ERROR_FAILED, ali@452: RAZOR_GENERAL_ERROR_DATABASE_CORRUPTED, ali@452: RAZOR_GENERAL_ERROR_DATABASE_INCOMPATIBLE, ali@452: RAZOR_GENERAL_ERROR_DATABASE_EXISTS, ali@452: RAZOR_GENERAL_ERROR_DATABASE_LOCKED, ali@452: RAZOR_GENERAL_ERROR_RPM_UNSUPPORTED, ali@475: RAZOR_GENERAL_ERROR_UNSUPPORTED_URI, ali@475: RAZOR_GENERAL_ERROR_BAD_URI, ali@483: RAZOR_GENERAL_ERROR_UNSUPPORTED_ARCHIVE, ali@499: RAZOR_GENERAL_ERROR_ALREADY_LOCKED, ali@499: RAZOR_GENERAL_ERROR_EXTERNALLY_LOCKED, ali@452: }; ali@452: ali@452: int razor_error_get_domain(struct razor_error *error); ali@452: int razor_error_get_code(struct razor_error *error); ali@452: const char *razor_error_get_object(struct razor_error *error); ali@452: const char *razor_error_get_primary_text(struct razor_error *error); ali@452: const char *razor_error_get_secondary_text(struct razor_error *error); ali@452: const char *razor_error_get_msg(struct razor_error *error); ali@452: void razor_error_free(struct razor_error *error); ali@452: ali@452: /** ali@452: * SECTION:atomic ali@452: * @title: Atomic transactions ali@452: * @short_description: File-based transactions that shouldn't half-succeed ali@452: * ali@452: * This is a helper object for issuing a sequence of file-based actions ali@452: * that should either all succeed or all fail. ali@452: * ali@452: * Note that currently only Windows 7 has a native implementation and that ali@452: * while the emulated fallback implementation attempts to rollback the ali@452: * transaction if it fails, this is not guaranteed to succeed and that ali@452: * the transaction is held in core (and thus vulnernable to program crashes, ali@452: * power loss, etc.). This could (and should) be improved. ali@452: * ali@452: * Atomic transactions can be disabled via configure, in which case all ali@452: * bets are off. ali@452: **/ ali@452: ali@452: @RAZOR_HAVE_ATOMIC_ROLLBACK@ ali@452: ali@452: struct razor_atomic; ali@452: ali@452: struct razor_atomic *razor_atomic_open(const char *description); ali@452: int razor_atomic_commit(struct razor_atomic *atomic); ali@452: struct razor_error *razor_atomic_get_error(struct razor_atomic *atomic); ali@452: const char *razor_atomic_get_error_msg(struct razor_atomic *atomic); ali@452: void razor_atomic_destroy(struct razor_atomic *atomic); ali@452: ali@452: /** ali@452: * razor_atomic_make_dirs ali@452: * ali@479: * Create all sub-directories leading up to uri. We know root_uri exists ali@479: * and is a dir, root_uri does not end in a '/', and uri either has a ali@479: * leading '/' or (on MS-Windows only) root_uri is the empty string ali@479: * and uri starts with drive (eg., "c:/windows"). ali@479: * Note: uri itself is not created, only the directory in which it ali@452: * (would) exist. ali@452: * ali@452: * Returns: non-zero on error. ali@452: **/ ali@475: int razor_atomic_make_dirs(struct razor_atomic *atomic, const char *root_uri, ali@475: const char *uri); ali@452: int razor_atomic_remove(struct razor_atomic *atomic, const char *path); ali@475: int razor_atomic_rename_file(struct razor_atomic *atomic, const char *old_uri, ali@475: const char *new_uri); ali@452: ali@452: /** ali@452: * razor_atomic_create_dir ali@452: * ali@452: * Create a directory, replacing any existing object at this path except ali@452: * an existing directory (which is not counted as a error). ali@452: * ali@452: * Returns: non-zero on error. ali@452: */ ali@475: int razor_atomic_create_dir(struct razor_atomic *atomic, const char *uri, ali@475: mode_t mode); ali@452: ali@452: /** ali@452: * razor_atomic_create_symlink ali@452: * ali@452: * Create a symbolic link, replacing any existing object at this path except ali@452: * a non-empty directory. ali@452: * ali@452: * Note: This function will always fail on platforms that don't support ali@452: * symbolic links. ali@452: * ali@452: * Returns: non-zero on error. ali@452: */ ali@452: int razor_atomic_create_symlink(struct razor_atomic *atomic, const char *target, ali@475: const char *uri); ali@452: /** ali@452: * razor_atomic_create_file ali@452: * ali@452: * Create a file, replacing any existing object at this path except ali@452: * a non-empty directory. ali@452: * ali@452: * Returns: A handle to be passed to razor_atomic_write() and ali@452: * razor_atomic_close() or a negative value on error. ali@452: */ ali@475: int razor_atomic_create_file(struct razor_atomic *atomic, const char *uri, ali@475: mode_t mode); ali@452: int razor_atomic_write(struct razor_atomic *atomic, int handle, ali@475: const void *data, size_t size); ali@452: int razor_atomic_close(struct razor_atomic *atomic, int handle); ali@452: int razor_atomic_sync(struct razor_atomic *atomic, int handle); ali@452: void razor_atomic_abort(struct razor_atomic *atomic, int domain, int code, ali@475: const char *error_msg); ali@475: void ali@475: razor_atomic_propagate_error(struct razor_atomic *atomic, ali@475: struct razor_error *error, const char *summary); ali@452: int razor_atomic_in_error_state(struct razor_atomic *atomic); ali@452: ali@452: /** ali@452: * SECTION:set ali@452: * @title: Package Set ali@452: * @short_description: Represents a set of packages and their metadata. ali@452: * ali@452: * This object represents a set of packages, their dependency ali@452: * information, the file lists and a number of other details. ali@452: **/ ali@452: ali@452: struct razor_set; ali@452: struct razor_package; ali@452: struct razor_property; ali@452: ali@452: #define RAZOR_HEADER_VERSION 2 /* Current version */ ali@452: #define RAZOR_HEADER_VERSION_MIN 1 /* Minimum version we support */ ali@452: ali@452: /** ali@452: * razor_set_create: ali@452: * ali@452: * Create a new #razor_set object. ali@452: * ali@452: * Returns: the new #razor_set object. ali@452: **/ ali@452: struct razor_set *razor_set_create_without_root(void); ali@452: struct razor_set *razor_set_create(void); ali@452: struct razor_set * ali@475: razor_set_open(const char *uri, enum razor_set_flags flags, ali@452: struct razor_error **error); ali@452: uint32_t razor_set_get_header_version(struct razor_set *set); ali@452: int razor_set_set_header_version(struct razor_set *set, ali@452: uint32_t header_version); ali@452: void razor_set_unref(struct razor_set *set); ali@452: struct razor_set *razor_set_ref(struct razor_set *set); ali@452: void razor_set_write_to_handle(struct razor_set *set, ali@452: struct razor_atomic *atomic, int handle, ali@452: uint32_t section_mask); ali@452: int razor_set_write(struct razor_set *set, struct razor_atomic *atomic, ali@475: const char *uri, uint32_t setions); ali@452: int ali@475: razor_set_bind_sections(struct razor_set *set, const char *uri, ali@452: enum razor_set_flags flags, struct razor_error **error); ali@452: ali@452: void ali@452: razor_package_get_details(struct razor_set *set, ali@452: struct razor_package *package, ...); ali@452: int ali@452: razor_package_remove(struct razor_set *prev, struct razor_set *next, ali@452: struct razor_atomic *atomic, struct razor_package *package, ali@479: const char *root_uri, int install_count, ali@452: enum razor_stage_type stage); ali@452: ali@452: /** ali@452: * SECTION:iterator ali@452: * @title: Iterators ali@452: * @short_description: Objects for traversing packages or properties. ali@452: * ali@452: * The razor iterator objects provides a way to iterate through a set ali@452: * of packages or properties. ali@452: **/ ali@452: ali@452: struct razor_package_iterator; ali@452: ali@452: /** ali@452: * razor_package_iterator_create: ali@452: * ali@452: * Create a new #razor_package_iterator object. ali@452: * ali@452: * Returns: the new #razor_package_iterator object. ali@452: **/ ali@452: ali@452: struct razor_package_iterator * ali@452: razor_package_iterator_create(struct razor_set *set); ali@452: ali@452: /** ali@452: * razor_package_iterator_create_for_property: ali@452: * ali@452: * Create a new #razor_package_iterator object for the packages that ali@452: * own the given property. ali@452: * ali@452: * Returns: the new #razor_package_iterator object. ali@452: **/ ali@452: struct razor_package_iterator * ali@452: razor_package_iterator_create_for_property(struct razor_set *set, ali@452: struct razor_property *property); ali@452: ali@452: /** ali@452: * razor_package_iterator_create_for_file: ali@452: * ali@452: * Create a new #razor_package_iterator object for the packages that ali@452: * contain the given file name. ali@452: * ali@452: * Returns: the new #razor_package_iterator object. ali@452: **/ ali@452: struct razor_package_iterator * ali@452: razor_package_iterator_create_for_file(struct razor_set *set, ali@452: const char *filename); ali@452: ali@452: int razor_package_iterator_next(struct razor_package_iterator *pi, ali@452: struct razor_package **package, ...); ali@452: void razor_package_iterator_destroy(struct razor_package_iterator *pi); ali@452: ali@452: struct razor_package_query * ali@452: razor_package_query_create(struct razor_set *set); ali@452: void ali@452: razor_package_query_add_package(struct razor_package_query *pq, ali@452: struct razor_package *p); ali@452: void ali@452: razor_package_query_add_iterator(struct razor_package_query *pq, ali@452: struct razor_package_iterator *pi); ali@452: struct razor_package_iterator * ali@452: razor_package_query_finish(struct razor_package_query *pq); ali@452: ali@452: struct razor_property_iterator; ali@452: struct razor_property_iterator * ali@452: razor_property_iterator_create(struct razor_set *set, ali@452: struct razor_package *package); ali@452: int razor_property_iterator_next(struct razor_property_iterator *pi, ali@452: struct razor_property **property, ali@452: const char **name, ali@452: uint32_t *flags, ali@452: const char **version); ali@452: void ali@452: razor_property_iterator_destroy(struct razor_property_iterator *pi); ali@452: ali@452: struct razor_file_iterator; ali@452: struct razor_file_iterator * ali@452: razor_file_iterator_create(struct razor_set *set, ali@452: struct razor_package *package, int post_order); ali@452: int razor_file_iterator_next(struct razor_file_iterator *fi, ali@452: const char **name); ali@452: void razor_file_iterator_destroy(struct razor_file_iterator *fi); ali@452: ali@452: void razor_set_list_files(struct razor_set *set, const char *prefix); ali@452: void razor_set_list_package_files(struct razor_set *set, ali@452: struct razor_package *package); ali@452: ali@462: struct razor_string_iterator; ali@462: struct razor_string_iterator * ali@462: razor_install_prefix_iterator_create(struct razor_set *set, ali@462: struct razor_package *package); ali@462: int razor_string_iterator_next(struct razor_string_iterator *si, ali@462: const char **string); ali@462: void razor_string_iterator_destroy(struct razor_string_iterator *si); ali@462: ali@452: enum razor_diff_action { ali@452: RAZOR_DIFF_ACTION_ADD, ali@452: RAZOR_DIFF_ACTION_REMOVE, ali@452: }; ali@452: ali@452: typedef void (*razor_diff_callback_t)(enum razor_diff_action action, ali@452: struct razor_package *package, ali@452: const char *name, ali@452: const char *version, ali@452: const char *arch, ali@452: void *data); ali@452: ali@452: void ali@452: razor_set_diff(struct razor_set *set, struct razor_set *upstream, ali@452: razor_diff_callback_t callback, void *data); ali@452: ali@452: struct razor_install_iterator; ali@452: ali@452: enum razor_install_action { ali@452: RAZOR_INSTALL_ACTION_ADD, ali@452: RAZOR_INSTALL_ACTION_REMOVE, ali@452: RAZOR_INSTALL_ACTION_COMMIT ali@452: }; ali@452: ali@452: struct razor_install_iterator * ali@452: razor_set_create_install_iterator(struct razor_set *set, ali@452: struct razor_set *next); ali@452: ali@452: int razor_install_iterator_next(struct razor_install_iterator *ii, ali@452: struct razor_package **package, ali@452: enum razor_install_action *action, ali@452: int *count); ali@452: ali@452: /** ali@452: * razor_install_iterator_commit_set ali@452: * ali@452: * Immediately after razor_install_iterator_next() returns ali@452: * RAZOR_INSTALL_ACTION_COMMIT, this function will return the razor_set ali@452: * which should be committed. ali@452: * ali@452: * Returns: a new #razor_set object. ali@452: **/ ali@452: struct razor_set * ali@452: razor_install_iterator_commit_set(struct razor_install_iterator *ii); ali@452: ali@452: void razor_install_iterator_rewind(struct razor_install_iterator *ii); ali@452: size_t razor_install_iterator_tell(struct razor_install_iterator *ii); ali@452: size_t razor_install_iterator_seek(struct razor_install_iterator *ii, ali@452: size_t pos); ali@452: void razor_install_iterator_destroy(struct razor_install_iterator *ii); ali@452: ali@452: /** ali@452: * SECTION:transaction ali@452: * @title: Transaction ali@452: * @short_description: Create a new package set by merging two or more sets. ali@452: * ali@452: * The razor transaction object provides a way to create a new package set ali@452: * from packages from one or more other package sets. ali@452: **/ ali@452: ali@452: struct razor_rpm; ali@452: ali@452: struct razor_transaction * ali@452: razor_transaction_create(struct razor_set *system, struct razor_set *upstream); ali@452: void razor_transaction_install_package(struct razor_transaction *transaction, ali@452: struct razor_package *package); ali@452: void razor_transaction_remove_package(struct razor_transaction *transaction, ali@452: struct razor_package *package); ali@452: void razor_transaction_update_package(struct razor_transaction *trans, ali@452: struct razor_package *package); ali@452: void razor_transaction_fixup_package(struct razor_transaction *trans, ali@452: struct razor_package *package, ali@452: struct razor_rpm *rpm); ali@452: void razor_transaction_update_all(struct razor_transaction *transaction); ali@452: int razor_transaction_resolve(struct razor_transaction *trans); ali@452: ali@452: typedef void (*razor_unsatisfied_callback_t)(const char *requirement, ali@452: struct razor_package *package, ali@452: const char *name, ali@452: const char *version, ali@452: const char *arch, ali@452: void *data); ali@452: ali@452: int razor_transaction_unsatisfied(struct razor_transaction *trans, ali@452: razor_unsatisfied_callback_t callback, ali@452: void *data); ali@452: int razor_transaction_describe(struct razor_transaction *trans); ali@452: struct razor_set *razor_transaction_commit(struct razor_transaction *trans); ali@452: void razor_transaction_destroy(struct razor_transaction *trans); ali@452: ali@452: /* Temporary helper for test suite. */ ali@452: int razor_transaction_unsatisfied_property(struct razor_transaction *trans, ali@452: const char *name, ali@452: uint32_t flags, ali@452: const char *version); ali@452: ali@452: /** ali@452: * SECTION:rpm ali@452: * @title: Razor RPM ali@452: * @short_description: Operating on RPM files. ali@452: * ali@452: * Functions for open RPM files and extracting information and ali@452: * installing or removing RPM files. ali@452: **/ ali@452: ali@452: struct razor_relocations; ali@452: ali@452: struct razor_relocations *razor_relocations_create(void); ali@452: void razor_relocations_add(struct razor_relocations *relocations, ali@452: const char *oldpath, const char *newpath); ali@452: void razor_relocations_set_rpm(struct razor_relocations *relocations, ali@452: struct razor_rpm *rpm); ali@452: const char *razor_relocations_apply(struct razor_relocations *relocations, ali@452: const char *path); ali@452: void razor_relocations_destroy(struct razor_relocations *relocations); ali@452: ali@475: struct razor_rpm *razor_rpm_open(const char *uri, struct razor_error **error); ali@452: void razor_rpm_get_details(struct razor_rpm *rpm, ...); ali@452: void razor_rpm_set_relocations(struct razor_rpm *rpm, ali@452: struct razor_relocations *relocations); ali@452: int razor_rpm_install(struct razor_rpm *rpm, struct razor_atomic *atomic, ali@475: const char *root_uri, int install_count, ali@452: enum razor_stage_type stage); ali@452: int razor_rpm_close(struct razor_rpm *rpm); ali@452: ali@452: /** ali@452: * SECTION:importer ali@452: * @title: Importer ali@452: * @short_description: A mechanism for building #razor_set objects ali@452: * ali@452: * The %razor_importer is a helper object for building a razor set ali@452: * from external sources, like yum metadata, the RPM database or RPM ali@452: * files. ali@452: * ali@452: * The importer is a stateful object; it has the notion of a current ali@452: * package, and the caller can provide meta data such as properties, ali@452: * files and similiar for the package as it becomes available. Once a ali@452: * package is fully described, the next pacakge can begin. When all ali@452: * packages have been described to the importer, the importer will ali@452: * create a new %razor_set with the specified packages. ali@452: * ali@452: * A typical use ali@452: * of the importer will follow this template: ali@452: * |[ ali@452: * importer = razor_importer_create(); ali@452: * ali@452: * while ( /* more packages to import */; ) { ali@452: * /* get name, version and arch of next package */ ali@452: * razor_importer_begin_package(importer, name, version, arch); ali@452: * razor_importer_add_details(importer, summary, description, url, license); ali@452: * ali@452: * while ( /* more properties to add */ ) ali@452: * razor_importer_add_property(importer, name, flags, version); ali@452: * ali@452: * while ( /* [more files to add */ ) ali@452: * razor_importer_add_file(importer, name); ali@452: * ali@452: * razor_importer_finish_package(importer); ali@452: * } ali@452: * ali@452: * return razor_importer_finish(importer); ali@452: * ]| ali@452: **/ ali@452: struct razor_importer; ali@452: ali@452: struct razor_importer *razor_importer_create(void); ali@452: void razor_importer_destroy(struct razor_importer *importer); ali@452: void razor_importer_begin_package(struct razor_importer *importer, ali@452: const char *name, ali@452: const char *version, ali@452: const char *arch); ali@452: void razor_importer_add_details(struct razor_importer *importer, ali@452: const char *summary, ali@452: const char *description, ali@452: const char *url, ali@452: const char *license); ali@452: void razor_importer_add_script(struct razor_importer *importer, ali@452: enum razor_property_flags script, ali@452: const char *program, ali@452: const char *body); ali@452: void razor_importer_add_install_prefix(struct razor_importer *importer, ali@452: const char *install_prefix); ali@452: void razor_importer_add_property(struct razor_importer *importer, ali@452: const char *name, ali@452: uint32_t flags, ali@452: const char *version); ali@452: void razor_importer_add_file(struct razor_importer *importer, ali@452: const char *name); ali@452: void razor_importer_finish_package(struct razor_importer *importer); ali@452: ali@452: int razor_importer_add_rpm(struct razor_importer *importer, ali@452: struct razor_rpm *rpm); ali@452: ali@452: struct razor_set *razor_importer_finish(struct razor_importer *importer); ali@452: ali@452: /** ali@452: * SECTION:root ali@452: * @title: Root ali@452: * @short_description: Functions for accessing an install root. ali@452: * ali@452: * The #razor_root object encapsulate access to and locking of a razor ali@452: * install root. ali@452: **/ ali@452: struct razor_root; ali@452: ali@475: const char *razor_get_database_uri(void); ali@475: void razor_set_database_uri(const char *database_uri); ali@475: int razor_root_create(const char *root_uri, struct razor_error **error); ali@452: struct razor_root * ali@475: razor_root_open(const char *root_uri, struct razor_error **error); ali@452: struct razor_set * ali@475: razor_root_open_read_only(const char *root_uri, struct razor_error **error); ali@452: struct razor_set *razor_root_get_system_set(struct razor_root *root); ali@452: int razor_root_close(struct razor_root *root); ali@452: int ali@452: razor_root_update(struct razor_root *root, struct razor_set *next, ali@452: struct razor_atomic *atomic); ali@452: ali@452: /** ali@475: * SECTION:uri-io ali@475: * @title: URI Input/Output ali@475: * @short_description: Functions to support non-file URI handlers ali@475: * ali@475: * Libraries that want to support URIs other than file URIs (which razor ali@475: * handles internally), can install their own URI handlers. Unsupported ali@475: * virtual functions should be set to %NULL. A fallback URI handler (which ali@475: * will be used if no scheme-specific handler is found) can be installed ali@475: * by passing scheme as %NULL. Finally, URI handlers can be removed by ali@475: * passing vtable as %NULL. ali@475: **/ ali@475: ali@475: struct razor_uri_vtable { ali@475: unsigned structure_size; ali@475: int (*mkdir)(const char *path, mode_t mode, struct razor_error **error); ali@475: int (*unlink)(const char *path, struct razor_error **error); ali@475: int (*open)(const char *path, int flags, mode_t mode, ali@475: struct razor_error **error); ali@475: int (*move)(const char *path, const char *dest, ali@475: struct razor_error **error); ali@475: void *(*get_contents)(const char *path, size_t *length, int _private, ali@475: struct razor_error **error); ali@475: int (*free_contents)(void *addr, size_t length); ali@475: int (*is_directory)(const char *path, struct razor_error **error); ali@475: char *(*mkdtemp_near)(const char *path, const char *_template, ali@475: struct razor_error **error); ali@475: void *(*opendir)(const char *path, struct razor_error **error); ali@475: char *(*readdir)(void *dir, struct razor_error **error); ali@475: int (*closedir)(void *dir, struct razor_error **error); ali@475: }; ali@475: ali@476: int razor_uri_mkdir(const char *uri, mode_t mode, struct razor_error **error); ali@476: int razor_uri_unlink(const char *uri, struct razor_error **error); ali@476: int razor_uri_open(const char *uri, int flags, mode_t mode, ali@476: struct razor_error **error); ali@476: int razor_uri_move(const char *uri, const char *dest, ali@476: struct razor_error **error); ali@476: int razor_uri_is_directory(const char *uri, struct razor_error **error); ali@476: char *razor_uri_mkdtemp_near(const char *uri, const char *_template, ali@476: struct razor_error **error) RAZOR_MALLOC; ali@476: void *razor_uri_opendir(const char *uri, struct razor_error **error); ali@476: char *razor_uri_readdir(void *dir, struct razor_error **error) RAZOR_MALLOC; ali@476: int razor_uri_closedir(void *dir, struct razor_error **error); ali@476: void *razor_uri_get_contents(const char *uri, size_t *length, int _private, ali@476: struct razor_error **error); ali@476: int razor_uri_free_contents(void *addr, size_t length); ali@476: ali@475: int razor_uri_set_vtable(const char *scheme, struct razor_uri_vtable *vtable, ali@475: struct razor_error **error); ali@475: ali@475: /** ali@452: * SECTION:misc ali@452: * @title: Miscellaneous Functions ali@452: * @short_description: Various helper functions ali@452: * ali@452: * Functions that doesn't fit anywhere else. ali@452: **/ ali@452: ali@452: const char * ali@452: razor_property_relation_to_string(struct razor_property *p); ali@452: const char * ali@452: razor_property_type_to_string(struct razor_property *p); ali@452: ali@452: void razor_build_evr(char *evr_buf, int size, const char *epoch, ali@452: const char *version, const char *release); ali@452: int razor_versioncmp(const char *s1, const char *s2); ali@452: ali@452: void razor_disable_root_name_checks(int disable); ali@452: ali@452: void razor_set_lua_loader(const char *modname, void (*loader)()); ali@452: void (*razor_get_lua_loader(const char *modname))(); ali@452: ali@452: char *razor_concat(const char *s, ...) RAZOR_MALLOC RAZOR_NULL_TERMINATED; ali@452: ali@475: char *razor_path_from_uri(const char *uri, struct razor_error **error) ali@475: RAZOR_MALLOC; ali@475: char *razor_path_to_uri(const char *path) RAZOR_MALLOC; ali@476: char *razor_path_relative_to_uri(const char *uri, const char *path, ali@475: struct razor_error **error) RAZOR_MALLOC; ali@452: ali@477: /* According to RFC 3986 § 5.2 */ ali@477: char *razor_resolve_relative_uri(const char *base_uri, const char *relative_uri, ali@477: struct razor_error **error); ali@477: ali@452: const char *razor_system_arch(void); ali@452: ali@475: int razor_dump_database(FILE *fp, const char *root_uri, const char *filename, ali@457: struct razor_error **error); ali@457: ali@452: #endif /* _RAZOR_H_ */