libalpm_databases(3)

NUME
libalpm_databases - bază de date

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

SINOPSIS

  Definiții de tip
typedef struct _alpm_db_t alpm_db_t
O bază de date.

  Enumerări
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.

  Funcții
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.

Descriere detaliată

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

Documentația 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.

Documentație privind tipurile de enumerare

  enum alpm_db_usage_t

Nivelul de utilizare al unei baze de date.

Enumerator

ALPM_DB_USAGE_SYNC
    Activează actualizările pentru această bază de date.

ALPM_DB_USAGE_SEARCH
    Activează căutarea în această bază de date.

ALPM_DB_USAGE_INSTALL
    Activează instalarea pachetelor de la această bază de date.

ALPM_DB_USAGE_UPGRADE
    Activează actualizările sistemului (sysupgrades) cu această bază de date.

ALPM_DB_USAGE_ALL
    Activează toate nivelele de utilizare.

Documentația funcției

  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.

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ță)

  int alpm_db_add_server (alpm_db_t * db, const char * url)

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ță)

  alpm_list_t * alpm_db_get_cache_servers (const alpm_db_t * db)

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*

  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 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

  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.

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

  alpm_handle_t * alpm_db_get_handle (alpm_db_t * db)

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

  const char * alpm_db_get_name (const alpm_db_t * db)

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

  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 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

  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 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

  alpm_list_t * alpm_db_get_servers (const alpm_db_t * db)

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*

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

Returnează
    nivelul de verificare a semnăturii

  int alpm_db_get_usage (alpm_db_t * db, int * usage)

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

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

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

  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.

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)

  int alpm_db_remove_server (alpm_db_t * db, const char * url)

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)

  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.

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ță)

  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.

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*.

  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.

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*.

  int alpm_db_set_usage (alpm_db_t * db, int usage)

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

  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

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

  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 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

  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.

Returnează
    o referință la baza de date locală

  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

Returnează
    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

Returnează
    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

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

Autor

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

TRADUCERE
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 (https://www.gnu.org/licenses/gpl-3.0.html) 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.