libalpm_databases(3) Library Functions Manual libalpm_databases(3)

libalpm_databases - bază de date


- Funcții de interogare și manipulare a bazei de date a „libalpm”.


typedef struct _alpm_db_t alpm_db_t
O bază de date.


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.


alpm_db_t * alpm_get_localdb (alpm_handle_t *handle)
Obține baza de date a pachetelor instalate local. alpm_list_t * alpm_get_syncdbs (alpm_handle_t *handle)
Obține lista bazelor de date de sincronizare.. alpm_db_t * alpm_register_syncdb (alpm_handle_t *handle, const char *treename, int level)
Înregistrează o bază de date de sincronizare a pachetelor. int alpm_unregister_all_syncdbs (alpm_handle_t *handle)
Anulează înregistrarea tuturor bazelor de date ale pachetelor. int alpm_db_unregister (alpm_db_t *db)
Anulează înregistrarea unei baze de date de pachete. alpm_handle_t * alpm_db_get_handle (alpm_db_t *db)
Obține identificatorul unei baze de date de pachete. const char * alpm_db_get_name (const alpm_db_t *db)
Obține numele unei baze de date de pachete. int alpm_db_get_siglevel (alpm_db_t *db)
Obține nivelul de verificare a semnăturii pentru o bază de date. int alpm_db_get_valid (alpm_db_t *db)
Verifică validitatea unei baze de date. int alpm_db_update (alpm_handle_t *handle, alpm_list_t *dbs, int force)
Actualizează bazelor de date ale pachetelor. alpm_pkg_t * alpm_db_get_pkg (alpm_db_t *db, const char *name)
Obține o intrare de pachet dintr-o bază de date de pachete. alpm_list_t * alpm_db_get_pkgcache (alpm_db_t *db)
Obține cache-ul unui pachet din baza de date a pachetelor. alpm_group_t * alpm_db_get_group (alpm_db_t *db, const char *name)
Obține o intrare de grup de pachete dintr-o bază de date de pachete. alpm_list_t * alpm_db_get_groupcache (alpm_db_t *db)
Obține cache-ul grupului de pachete dintr-o bază de date de pachete. int alpm_db_search (alpm_db_t *db, const alpm_list_t *needles, alpm_list_t **ret)
Caută într-o bază de date folosind expresii regulate.

Accesări ale serverului


alpm_list_t * alpm_db_get_servers (const alpm_db_t *db)
Obține lista serverelor alocate acestei baze de date. int alpm_db_set_servers (alpm_db_t *db, alpm_list_t *servers)
Stabilește lista de servere pe care baza de date trebuie să le utilizeze. int alpm_db_add_server (alpm_db_t *db, const char *url)
Adaugă un server de descărcare la o bază de date. int alpm_db_remove_server (alpm_db_t *db, const char *url)
Elimină un server de descărcare de la o bază de date. alpm_list_t * alpm_db_get_cache_servers (const alpm_db_t *db)
Obține lista serverelor de cache alocate acestei baze de date. int alpm_db_set_cache_servers (alpm_db_t *db, alpm_list_t *servers)
Stabilește lista serverelor de cache pe care baza de date trebuie să le utilizeze. int alpm_db_add_cache_server (alpm_db_t *db, const char *url)
Adaugă un server de cache pentru descărcări la o bază de date. int alpm_db_remove_cache_server (alpm_db_t *db, const char *url)
Elimină un server de cache pentru descărcări de la o bază de date.

Accesări de utilizare


int alpm_db_set_usage (alpm_db_t *db, int usage)
Configurează utilizarea unei baze de date. int alpm_db_get_usage (alpm_db_t *db, int *usage)
Obține informații despre utilizarea unei baze de date.

Funcții de interogare și manipulare a bazei de date a „libalpm”.

Documentația typedef

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.

Documentație privind tipurile de enumerare

Nivelul de utilizare al unei baze de date.

Enumerator

Activează actualizările pentru această bază de date.
Activează căutarea în această bază de date.
Activează instalarea pachetelor de la această bază de date.
Activează actualizările sistemului (sysupgrades) cu această bază de date.
Activează toate nivelele de utilizare.

Documentația funcției

Adaugă un server de cache pentru descărcări la o bază de date.

Parametrii

db indicator de bază de date
url adresa URL a serverului

Returnează

0 în caz de succes, -1 în caz de eroare (variabila pm_errno este configurată în consecință)

Adaugă un server de descărcare la o bază de date.

Parametrii

db indicator de bază de date
url adresa URL a serverului

Returnează

0 în caz de succes, -1 în caz de eroare (variabila pm_errno este configurată în consecință)

Obține lista serverelor de cache alocate acestei baze de date.

Parametrii

db – indicator către baza de date din care se preiau serverele

Returnează

o listă de servere de tip char*

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 către baza de date a pachetelor, pentru a prelua grupul din aceasta
name numele grupului

Returnează

intrarea grupurilor în caz de succes, NULL în caz de eroare

Obține cache-ul grupului de pachete dintr-o bază de date de pachete.

Parametrii

db indicator către baza de date a pachetelor, pentru a prelua grupul din aceasta

Returnează

lista grupurilor în caz de succes, NULL în caz de eroare

Obține identificatorul unei baze de date de pachete.

Parametrii

db indicator către baza de date a pachetelor

Returnează

gestionarul alpm căruia îi aparține baza de date a pachetelor

Obține numele unei baze de date de pachete.

Parametrii

db indicator către baza de date a pachetelor

Returnează

numele bazei de date a pachetului; NULL în caz de eroare

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 către baza de date a pachetelor, din care se obține pachetul
name numele pachetului

Returnează

intrarea pachetului în caz de succes, NULL în caz de eroare

Get the package cache of a package database. This is a list of all packages the db contains.

Parametrii

db – indicator către baza de date a pachetelor, din care se obține pachetul

Returnează

lista pachetelor în caz de succes, NULL în caz de eroare

Obține lista serverelor alocate acestei baze de date.

Parametrii

db – indicator către baza de date din care se preiau serverele

Returnează

o listă de servere de tip char*

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 către baza de date a pachetelor

Returnează

nivelul de verificare a semnăturii

Obține informații despre utilizarea unei baze de date.

Parametrii

db indicator către baza de date a pachetelor pentru a obține starea
usage indicator către un alpm_db_usage_t pentru a stoca starea bazei de date

Returnează

0 în caz de succes, sau -1 în caz de eșec

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 către baza de date a pachetelor

Returnează

0 dacă este valid, -1 dacă nu este valid (pm_errno este configurată în consecință)

Elimină un server de cache pentru descărcări de la o bază de date.

Parametrii

db indicator de bază de date
url adresa URL a serverului

Returnează

0 on success, 1 on server not present, -1 on error (pm_errno is set accordingly)

Elimină un server de descărcare de la o bază de date.

Parametrii

db indicator de bază de date
url adresa URL a serverului

Returnează

0 on success, 1 on server not present, -1 on error (pm_errno is set accordingly)

Caută într-o bază de date folosind expresii regulate.

Parametrii

indicator către baza de date a pachetelor în care se va efectua căutarea
needles o listă de expresii regulate care trebuie căutate
ret pointer to list for storing packages matching all regular expressions - must point to an empty (NULL) alpm_list_t *.

Returnează

0 în caz de succes, -1 în caz de eroare (variabila pm_errno este configurată în consecință)

Stabilește lista serverelor de cache pe care baza de date trebuie să 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 listă de servere de tip char*.

Stabilește lista de servere pe care baza de date trebuie să 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 listă de servere de tip char*.

Configurează utilizarea unei baze de date.

Parametrii

db indicator către baza de date a pachetelor pentru a stabili starea acesteia
usage o mască de biți compusă din valori de tip alpm_db_usage_t

Returnează

0 în caz de succes, sau -1 în caz de eșec

Unregister a package database. Databases can not be unregistered when there is an active transaction.

Parametrii

db pointer to the package database to unregister

Returnează

0 în caz de succes, -1 în caz de eroare (variabila pm_errno este configurată în consecință)

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 eșuat (%s)\n"),
        alpm_strerror(alpm_errno(config->handle)));
}

Notă

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

Returnează

0 on success, -1 on error (pm_errno is set accordingly), 1 if all databases are up to to date

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.

Returnează

o referință la baza de date locală

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

Returnează

a reference to an internal list of alpm_db_t structures

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

Returnează

an alpm_db_t* on success (the value), NULL on error

Unregister all package databases. Databases can not be unregistered while there is an active transaction.

Parametrii

handle the context handle

Returnează

0 în caz de succes, -1 în caz de eroare (variabila pm_errno este configurată în consecință)

Generat automat de Doxygen pentru „libalpm” din codul sursă.

Traducerea în limba română a acestui manual a fost făcută de Remus-Gabriel Chelu <remusgabriel.chelu@disroot.org>

Această traducere este documentație gratuită; citiți Licența publică generală GNU Versiunea 3 sau o versiune ulterioară cu privire la condiții privind drepturile de autor. NU se asumă NICIO RESPONSABILITATE.

Dacă găsiți erori în traducerea acestui manual, vă rugăm să trimiteți un e-mail la translation-team-ro@lists.sourceforge.net.

libalpm