libalpm_databases(3) Library Functions Manual libalpm_databases(3) NUME libalpm_databases - baza de date - Funcii de interogare i manipulare a bazei de date a ,,libalpm". SINOPSIS Definiii de tip typedef struct _alpm_db_t alpm_db_t O baza de date. Enumerari enum alpm_db_usage_t { ALPM_DB_USAGE_SYNC = 1, ALPM_DB_USAGE_SEARCH = (1 << 1), ALPM_DB_USAGE_INSTALL = (1 << 2), ALPM_DB_USAGE_UPGRADE = (1 << 3), ALPM_DB_USAGE_ALL = (1 << 4) - 1 } Nivelul de utilizare al unei baze de date. Funcii alpm_db_t * alpm_get_localdb (alpm_handle_t *handle) Obine baza de date a pachetelor instalate local. alpm_list_t * alpm_get_syncdbs (alpm_handle_t *handle) Obine lista bazelor de date de sincronizare.. alpm_db_t * alpm_register_syncdb (alpm_handle_t *handle, const char *treename, int level) Inregistreaza o baza de date de sincronizare a pachetelor. int alpm_unregister_all_syncdbs (alpm_handle_t *handle) Anuleaza inregistrarea tuturor bazelor de date ale pachetelor. int alpm_db_unregister (alpm_db_t *db) Anuleaza inregistrarea unei baze de date de pachete. alpm_handle_t * alpm_db_get_handle (alpm_db_t *db) Obine identificatorul unei baze de date de pachete. const char * alpm_db_get_name (const alpm_db_t *db) Obine numele unei baze de date de pachete. int alpm_db_get_siglevel (alpm_db_t *db) Obine nivelul de verificare a semnaturii pentru o baza de date. int alpm_db_get_valid (alpm_db_t *db) Verifica validitatea unei baze de date. int alpm_db_update (alpm_handle_t *handle, alpm_list_t *dbs, int force) Actualizeaza bazelor de date ale pachetelor. alpm_pkg_t * alpm_db_get_pkg (alpm_db_t *db, const char *name) Obine o intrare de pachet dintr-o baza de date de pachete. alpm_list_t * alpm_db_get_pkgcache (alpm_db_t *db) Obine cache-ul unui pachet din baza de date a pachetelor. alpm_group_t * alpm_db_get_group (alpm_db_t *db, const char *name) Obine o intrare de grup de pachete dintr-o baza de date de pachete. alpm_list_t * alpm_db_get_groupcache (alpm_db_t *db) Obine cache-ul grupului de pachete dintr-o baza de date de pachete. int alpm_db_search (alpm_db_t *db, const alpm_list_t *needles, alpm_list_t **ret) Cauta intr-o baza de date folosind expresii regulate. Accesari ale serverului alpm_list_t * alpm_db_get_servers (const alpm_db_t *db) Obine lista serverelor alocate acestei baze de date. int alpm_db_set_servers (alpm_db_t *db, alpm_list_t *servers) Stabilete lista de servere pe care baza de date trebuie sa le utilizeze. int alpm_db_add_server (alpm_db_t *db, const char *url) Adauga un server de descarcare la o baza de date. int alpm_db_remove_server (alpm_db_t *db, const char *url) Elimina un server de descarcare de la o baza de date. alpm_list_t * alpm_db_get_cache_servers (const alpm_db_t *db) Obine lista serverelor de cache alocate acestei baze de date. int alpm_db_set_cache_servers (alpm_db_t *db, alpm_list_t *servers) Stabilete lista serverelor de cache pe care baza de date trebuie sa le utilizeze. int alpm_db_add_cache_server (alpm_db_t *db, const char *url) Adauga un server de cache pentru descarcari la o baza de date. int alpm_db_remove_cache_server (alpm_db_t *db, const char *url) Elimina un server de cache pentru descarcari de la o baza de date. Accesari de utilizare int alpm_db_set_usage (alpm_db_t *db, int usage) Configureaza utilizarea unei baze de date. int alpm_db_get_usage (alpm_db_t *db, int *usage) Obine informaii despre utilizarea unei baze de date. Descriere detaliata Funcii de interogare i manipulare a bazei de date a ,,libalpm". Documentaia typedef typedef struct _alpm_db_t alpm_db_t A database. A database is a container that stores metadata about packages. A database can be located on the local filesystem or on a remote server. To use a database, it must first be registered via alpm_register_syncdb. If the database is already present in dbpath then it will be usable. Otherwise, the database needs to be downloaded using alpm_db_update. Even if the source of the database is the local filesystem. After this, the database can be used to query packages and groups. Any packages or groups from the database will continue to be owned by the database and do not need to be freed by the user. They will be freed when the database is unregistered. Databases are automatically unregistered when the alpm_handle_t is released. Documentaie privind tipurile de enumerare enum alpm_db_usage_t Nivelul de utilizare al unei baze de date. Enumerator ALPM_DB_USAGE_SYNC Activeaza actualizarile pentru aceasta baza de date. ALPM_DB_USAGE_SEARCH Activeaza cautarea in aceasta baza de date. ALPM_DB_USAGE_INSTALL Activeaza instalarea pachetelor de la aceasta baza de date. ALPM_DB_USAGE_UPGRADE Activeaza actualizarile sistemului (sysupgrades) cu aceasta baza de date. ALPM_DB_USAGE_ALL Activeaza toate nivelele de utilizare. Documentaia funciei int alpm_db_add_cache_server (alpm_db_t * db, const char * url) Adauga un server de cache pentru descarcari la o baza de date. Parametrii db indicator de baza de date url adresa URL a serverului Returneaza 0 in caz de succes, -1 in caz de eroare (variabila pm_errno este configurata in consecina) int alpm_db_add_server (alpm_db_t * db, const char * url) Adauga un server de descarcare la o baza de date. Parametrii db indicator de baza de date url adresa URL a serverului Returneaza 0 in caz de succes, -1 in caz de eroare (variabila pm_errno este configurata in consecina) alpm_list_t * alpm_db_get_cache_servers (const alpm_db_t * db) Obine lista serverelor de cache alocate acestei baze de date. Parametrii db - indicator catre baza de date din care se preiau serverele Returneaza o lista de servere de tip char* alpm_group_t * alpm_db_get_group (alpm_db_t * db, const char * name) Get a group entry from a package database. Looking up a group is O(1) and will be significantly faster than iterating over the groupcahe. Parametrii db indicator catre baza de date a pachetelor, pentru a prelua grupul din aceasta name numele grupului Returneaza intrarea grupurilor in caz de succes, NULL in caz de eroare alpm_list_t * alpm_db_get_groupcache (alpm_db_t * db) Obine cache-ul grupului de pachete dintr-o baza de date de pachete. Parametrii db indicator catre baza de date a pachetelor, pentru a prelua grupul din aceasta Returneaza lista grupurilor in caz de succes, NULL in caz de eroare alpm_handle_t * alpm_db_get_handle (alpm_db_t * db) Obine identificatorul unei baze de date de pachete. Parametrii db indicator catre baza de date a pachetelor Returneaza gestionarul alpm caruia ii aparine baza de date a pachetelor const char * alpm_db_get_name (const alpm_db_t * db) Obine numele unei baze de date de pachete. Parametrii db indicator catre baza de date a pachetelor Returneaza numele bazei de date a pachetului; NULL in caz de eroare alpm_pkg_t * alpm_db_get_pkg (alpm_db_t * db, const char * name) Get a package entry from a package database. Looking up a package is O(1) and will be significantly faster than iterating over the pkgcahe. Parametrii db - indicator catre baza de date a pachetelor, din care se obine pachetul name numele pachetului Returneaza intrarea pachetului in caz de succes, NULL in caz de eroare alpm_list_t * alpm_db_get_pkgcache (alpm_db_t * db) Get the package cache of a package database. This is a list of all packages the db contains. Parametrii db - indicator catre baza de date a pachetelor, din care se obine pachetul Returneaza lista pachetelor in caz de succes, NULL in caz de eroare alpm_list_t * alpm_db_get_servers (const alpm_db_t * db) Obine lista serverelor alocate acestei baze de date. Parametrii db - indicator catre baza de date din care se preiau serverele Returneaza o lista de servere de tip char* int alpm_db_get_siglevel (alpm_db_t * db) Get the signature verification level for a database. Will return the default verification level if this database is set up with ALPM_SIG_USE_DEFAULT. Parametrii db indicator catre baza de date a pachetelor Returneaza nivelul de verificare a semnaturii int alpm_db_get_usage (alpm_db_t * db, int * usage) Obine informaii despre utilizarea unei baze de date. Parametrii db indicator catre baza de date a pachetelor pentru a obine starea usage indicator catre un alpm_db_usage_t pentru a stoca starea bazei de date Returneaza 0 in caz de succes, sau -1 in caz de eec int alpm_db_get_valid (alpm_db_t * db) Check the validity of a database. This is most useful for sync databases and verifying signature status. If invalid, the handle error code will be set accordingly. Parametrii db indicator catre baza de date a pachetelor Returneaza 0 daca este valid, -1 daca nu este valid (pm_errno este configurata in consecina) int alpm_db_remove_cache_server (alpm_db_t * db, const char * url) Elimina un server de cache pentru descarcari de la o baza de date. Parametrii db indicator de baza de date url adresa URL a serverului Returneaza 0 on success, 1 on server not present, -1 on error (pm_errno is set accordingly) int alpm_db_remove_server (alpm_db_t * db, const char * url) Elimina un server de descarcare de la o baza de date. Parametrii db indicator de baza de date url adresa URL a serverului Returneaza 0 on success, 1 on server not present, -1 on error (pm_errno is set accordingly) int alpm_db_search (alpm_db_t * db, const alpm_list_t * needles, alpm_list_t ** ret) Cauta intr-o baza de date folosind expresii regulate. Parametrii indicator catre baza de date a pachetelor in care se va efectua cautarea needles o lista de expresii regulate care trebuie cautate ret pointer to list for storing packages matching all regular expressions - must point to an empty (NULL) alpm_list_t *. Returneaza 0 in caz de succes, -1 in caz de eroare (variabila pm_errno este configurata in consecina) int alpm_db_set_cache_servers (alpm_db_t * db, alpm_list_t * servers) Stabilete lista serverelor de cache pe care baza de date trebuie sa le utilizeze. Parametrii db the database to set the servers. The list will be duped and the original will still need to be freed by the caller. servers o lista de servere de tip char*. int alpm_db_set_servers (alpm_db_t * db, alpm_list_t * servers) Stabilete lista de servere pe care baza de date trebuie sa le utilizeze. Parametrii db the database to set the servers. The list will be duped and the original will still need to be freed by the caller. servers o lista de servere de tip char*. int alpm_db_set_usage (alpm_db_t * db, int usage) Configureaza utilizarea unei baze de date. Parametrii db indicator catre baza de date a pachetelor pentru a stabili starea acesteia usage o masca de bii compusa din valori de tip alpm_db_usage_t Returneaza 0 in caz de succes, sau -1 in caz de eec int alpm_db_unregister (alpm_db_t * db) Unregister a package database. Databases can not be unregistered when there is an active transaction. Parametrii db pointer to the package database to unregister Returneaza 0 in caz de succes, -1 in caz de eroare (variabila pm_errno este configurata in consecina) int alpm_db_update (alpm_handle_t * handle, alpm_list_t * dbs, int force) Update package databases. An update of the package databases in the list dbs will be attempted. Unless force is true, the update will only be performed if the remote databases were modified since the last update. This operation requires a database lock, and will return an applicable error if the lock could not be obtained. Exemplu: alpm_list_t *dbs = alpm_get_syncdbs(config->handle); ret = alpm_db_update(config->handle, dbs, force); if(ret < 0) { pm_printf(ALPM_LOG_ERROR, _("sincronizarea tuturor bazelor de date a euat (%s)\n"), alpm_strerror(alpm_errno(config->handle))); } Nota After a successful update, the package cache will be invalidated Parametrii handle the context handle dbs list of package databases to update force if true, then forces the update, otherwise update only in case the databases aren't up to date Returneaza 0 on success, -1 on error (pm_errno is set accordingly), 1 if all databases are up to to date alpm_db_t * alpm_get_localdb (alpm_handle_t * handle) Get the database of locally installed packages. The returned pointer points to an internal structure of libalpm which should only be manipulated through libalpm functions. Returneaza o referina la baza de date locala alpm_list_t * alpm_get_syncdbs (alpm_handle_t * handle) Get the list of sync databases. Returns a list of alpm_db_t structures, one for each registered sync database. Parametrii handle the context handle Returneaza a reference to an internal list of alpm_db_t structures alpm_db_t * alpm_register_syncdb (alpm_handle_t * handle, const char * treename, int level) Register a sync database of packages. Databases can not be registered when there is an active transaction. Parametrii handle the context handle treename the name of the sync repository level what level of signature checking to perform on the database; note that this must be a '.sig' file type verification Returneaza an alpm_db_t* on success (the value), NULL on error int alpm_unregister_all_syncdbs (alpm_handle_t * handle) Unregister all package databases. Databases can not be unregistered while there is an active transaction. Parametrii handle the context handle Returneaza 0 in caz de succes, -1 in caz de eroare (variabila pm_errno este configurata in consecina) Autor Generat automat de Doxygen pentru ,,libalpm" din codul sursa. TRADUCERE Traducerea in limba romana a acestui manual a fost facuta de Remus- Gabriel Chelu Aceasta traducere este documentaie gratuita; citii Licena publica generala GNU Versiunea 3 sau o versiune ulterioara cu privire la condiii privind drepturile de autor. NU se asuma NICIO RESPONSABILITATE. Daca gasii erori in traducerea acestui manual, va rugam sa trimitei un e-mail la . libalpm libalpm_databases(3)