153 lines
4.8 KiB
C
153 lines
4.8 KiB
C
/*-
|
|
* Copyright (c) 2008 Juan Romero Pardines.
|
|
* All rights reserved.
|
|
*
|
|
* Redistribution and use in source and binary forms, with or without
|
|
* modification, are permitted provided that the following conditions
|
|
* are met:
|
|
* 1. Redistributions of source code must retain the above copyright
|
|
* notice, this list of conditions and the following disclaimer.
|
|
* 2. Redistributions in binary form must reproduce the above copyright
|
|
* notice, this list of conditions and the following disclaimer in the
|
|
* documentation and/or other materials provided with the distribution.
|
|
*
|
|
* THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
|
|
* IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
|
|
* OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
|
|
* IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
|
|
* INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
|
|
* NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
|
|
* DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
|
|
* THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
|
|
* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
|
|
* THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
*/
|
|
|
|
#ifndef _XBPS_PLIST_H_
|
|
#define _XBPS_PLIST_H_
|
|
|
|
/*
|
|
* Adds an opaque object with specified key into a dictionary.
|
|
*
|
|
* Arguments:
|
|
* - prop_dictionary_t: dictionary to store the object.
|
|
* - prop_object_t: the object to be stored.
|
|
* - const char *: the key associated with the object.
|
|
*
|
|
* Returns true on success, false on failure.
|
|
*/
|
|
bool
|
|
xbps_add_obj_to_dict(prop_dictionary_t, prop_object_t, const char *);
|
|
|
|
/*
|
|
* Adds an opaque object into an array.
|
|
*
|
|
* Arguments:
|
|
* - prop_array_t: the array storing the object.
|
|
* - prop_object_t: the opaque object to be stored.
|
|
*
|
|
* Returns true on success, false on failure.
|
|
*/
|
|
bool
|
|
xbps_add_obj_to_array(prop_array_t, prop_object_t);
|
|
|
|
/*
|
|
* Executes a function callback to process all objects that are
|
|
* found in array with specified key inside of a dictionary.
|
|
*
|
|
* Arguments:
|
|
* - prop_dictionary_t: dictionary to search on.
|
|
* - const char *: key of the array.
|
|
* - func(prop_object_t, void *, bool *): callback associated.
|
|
* - void *: argument for the callback.
|
|
*
|
|
* Returns true on success, false otherwise and the loop is terminated.
|
|
*/
|
|
bool
|
|
xbps_callback_array_iter_in_dict(prop_dictionary_t, const char *,
|
|
bool (*func)(prop_object_t, void *, bool *),
|
|
void *);
|
|
|
|
/*
|
|
* Finds a package's dictionary into the main dictionary.
|
|
*
|
|
* Arguments:
|
|
* - prop_dictionary_t: main dictionary to search the object.
|
|
* - const char *: string of package name.
|
|
*
|
|
* Returns the package's dictionary object, otherwise NULL.
|
|
*/
|
|
prop_dictionary_t
|
|
xbps_find_pkg_in_dict(prop_dictionary_t, const char *);
|
|
|
|
/*
|
|
* Finds a string object in an array.
|
|
*
|
|
* Arguments:
|
|
* - prop_array_t: array to search for the string.
|
|
* - const char *: string value of the object to be found.
|
|
*
|
|
* Returns true on success, false otherwise.
|
|
*/
|
|
bool
|
|
xbps_find_string_in_array(prop_array_t, const char *);
|
|
|
|
/*
|
|
* Gets an array iterator from a dictionary with a specified key.
|
|
*
|
|
* Arguments:
|
|
* - prop_dictionary_t: dictionary to search the array.
|
|
* - const char *: key of the array.
|
|
*
|
|
* Returns the object iterator, NULL otherwise.
|
|
*/
|
|
prop_object_iterator_t
|
|
xbps_get_array_iter_from_dict(prop_dictionary_t, const char *);
|
|
|
|
/*
|
|
* (Un)registers a repository specified by an URI from/into the pool.
|
|
*
|
|
* Arguments:
|
|
* - const char *: URI to (un)register.
|
|
*
|
|
* Returns true on success, or false and an appropiate errno value otherwise.
|
|
*/
|
|
bool xbps_register_repository(const char *);
|
|
bool xbps_unregister_repository(const char *);
|
|
|
|
/*
|
|
* Remove package's dictionary from the "packages" array in
|
|
* the specified plist file.
|
|
*
|
|
* Arguments:
|
|
* - 1st const char *: package name.
|
|
* - 2nd const char *: full path to plist file.
|
|
*
|
|
* Returns true on success, or false and an appropiate errno value otherwise.
|
|
*/
|
|
bool
|
|
xbps_remove_pkg_dict_from_file(const char *, const char *);
|
|
|
|
/*
|
|
* Shows information of a package by looking at its dictionary.
|
|
* All known objects on it will be showed up.
|
|
*
|
|
* Arguments:
|
|
* - prop_dictionary_t: the package dictionary.
|
|
*/
|
|
void xbps_show_pkg_info(prop_dictionary_t);
|
|
|
|
/*
|
|
* Internal functions.
|
|
*/
|
|
bool xbps_list_pkgs_in_dict(prop_object_t, void *, bool *);
|
|
bool xbps_list_strings_in_array(prop_object_t, void *, bool *);
|
|
bool xbps_list_strings_in_array2(prop_object_t, void *, bool *);
|
|
bool xbps_remove_string_from_array(prop_object_t, void *, bool *);
|
|
bool xbps_show_pkg_info_from_repolist(prop_object_t obj, void *, bool *);
|
|
bool xbps_show_pkg_namedesc(prop_object_t, void *, bool *);
|
|
bool xbps_search_string_in_pkgs(prop_object_t, void *, bool *);
|
|
const char *xbps_get_pkgidx_string(const char *);
|
|
|
|
#endif /* !_XBPS_PLIST_H_ */
|