.\" -*- coding: UTF-8 -*-
.\" -*- nroff -*-
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH libalpm_databases 3 libalpm  
.ad l
.nh
.SH NUME
libalpm_databases \- bază de date
.PP
 \- Funcții de interogare și manipulare a bazei de date a „libalpm”\&. 

.SH SINOPSIS
.br
.PP
.SS "Definiții de tip"

.in +1c
.ti -1c
typedef struct _alpm_db_t \fBalpm_db_t\fP
.br
O bază de date\&.
.in -1c
.SS Enumerări

.in +1c
.ti -1c
enum \fBalpm_db_usage_t\fP { \fBALPM_DB_USAGE_SYNC\fP = 1, \fBALPM_DB_USAGE_SEARCH\fP
= (1 << 1), \fBALPM_DB_USAGE_INSTALL\fP = (1 << 2),
\fBALPM_DB_USAGE_UPGRADE\fP = (1 << 3), \fBALPM_DB_USAGE_ALL\fP = (1
<< 4) \- 1 }
.br
Nivelul de utilizare al unei baze de date\&.
.in -1c
.SS Funcții

.in +1c
.ti -1c
\fBalpm_db_t\fP * \fBalpm_get_localdb\fP (\fBalpm_handle_t\fP *handle)
.br
Obține baza de date a pachetelor instalate local\&.
.ti -1c
\fBalpm_list_t\fP * \fBalpm_get_syncdbs\fP (\fBalpm_handle_t\fP *handle)
.br
Obține lista bazelor de date de sincronizare.\&.
.ti -1c
\fBalpm_db_t\fP * \fBalpm_register_syncdb\fP (\fBalpm_handle_t\fP *handle, const char
*treename, int level)
.br
Înregistrează o bază de date de sincronizare a pachetelor\&.
.ti -1c
int \fBalpm_unregister_all_syncdbs\fP (\fBalpm_handle_t\fP *handle)
.br
Anulează înregistrarea tuturor bazelor de date ale pachetelor\&.
.ti -1c
int \fBalpm_db_unregister\fP (\fBalpm_db_t\fP *db)
.br
Anulează înregistrarea unei baze de date de pachete\&.
.ti -1c
\fBalpm_handle_t\fP * \fBalpm_db_get_handle\fP (\fBalpm_db_t\fP *db)
.br
Obține identificatorul unei baze de date de pachete\&.
.ti -1c
const char * \fBalpm_db_get_name\fP (const \fBalpm_db_t\fP *db)
.br
Obține numele unei baze de date de pachete\&.
.ti -1c
int \fBalpm_db_get_siglevel\fP (\fBalpm_db_t\fP *db)
.br
Obține nivelul de verificare a semnăturii pentru o bază de date\&.
.ti -1c
int \fBalpm_db_get_valid\fP (\fBalpm_db_t\fP *db)
.br
Verifică validitatea unei baze de date\&.
.ti -1c
int \fBalpm_db_update\fP (\fBalpm_handle_t\fP *handle, \fBalpm_list_t\fP *dbs, int
force)
.br
Actualizează bazelor de date ale pachetelor\&.
.ti -1c
\fBalpm_pkg_t\fP * \fBalpm_db_get_pkg\fP (\fBalpm_db_t\fP *db, const char *name)
.br
Obține o intrare de pachet dintr\-o bază de date de pachete\&.
.ti -1c
\fBalpm_list_t\fP * \fBalpm_db_get_pkgcache\fP (\fBalpm_db_t\fP *db)
.br
Obține cache\-ul unui pachet din baza de date a pachetelor\&.
.ti -1c
\fBalpm_group_t\fP * \fBalpm_db_get_group\fP (\fBalpm_db_t\fP *db, const char *name)
.br
Obține o intrare de grup de pachete dintr\-o bază de date de pachete\&.
.ti -1c
\fBalpm_list_t\fP * \fBalpm_db_get_groupcache\fP (\fBalpm_db_t\fP *db)
.br
Obține cache\-ul grupului de pachete dintr\-o bază de date de pachete\&.
.ti -1c
int \fBalpm_db_search\fP (\fBalpm_db_t\fP *db, const \fBalpm_list_t\fP *needles,
\fBalpm_list_t\fP **ret)
.br
Caută într\-o bază de date folosind expresii regulate\&.
.in -1c
.SS "Accesări ale serverului"

.in +1c
.ti -1c
\fBalpm_list_t\fP * \fBalpm_db_get_servers\fP (const \fBalpm_db_t\fP *db)
.br
Obține lista serverelor alocate acestei baze de date\&.
.ti -1c
int \fBalpm_db_set_servers\fP (\fBalpm_db_t\fP *db, \fBalpm_list_t\fP *servers)
.br
Stabilește lista de servere pe care baza de date trebuie să le utilizeze\&.
.ti -1c
int \fBalpm_db_add_server\fP (\fBalpm_db_t\fP *db, const char *url)
.br
Adaugă un server de descărcare la o bază de date\&.
.ti -1c
int \fBalpm_db_remove_server\fP (\fBalpm_db_t\fP *db, const char *url)
.br
Elimină un server de descărcare de la o bază de date\&.
.ti -1c
\fBalpm_list_t\fP * \fBalpm_db_get_cache_servers\fP (const \fBalpm_db_t\fP *db)
.br
Obține lista serverelor de cache alocate acestei baze de date\&.
.ti -1c
int \fBalpm_db_set_cache_servers\fP (\fBalpm_db_t\fP *db, \fBalpm_list_t\fP *servers)
.br
Stabilește lista serverelor de cache pe care baza de date trebuie să le
utilizeze\&.
.ti -1c
int \fBalpm_db_add_cache_server\fP (\fBalpm_db_t\fP *db, const char *url)
.br
Adaugă un server de cache pentru descărcări la o bază de date\&.
.ti -1c
int \fBalpm_db_remove_cache_server\fP (\fBalpm_db_t\fP *db, const char *url)
.br
Elimină un server de cache pentru descărcări de la o bază de date\&.
.in -1c
.SS "Accesări de utilizare"

.in +1c
.ti -1c
int \fBalpm_db_set_usage\fP (\fBalpm_db_t\fP *db, int usage)
.br
Configurează utilizarea unei baze de date\&.
.ti -1c
int \fBalpm_db_get_usage\fP (\fBalpm_db_t\fP *db, int *usage)
.br
Obține informații despre utilizarea unei baze de date\&.
.in -1c
.SH "Descriere detaliată"
.PP
Funcții de interogare și manipulare a bazei de date a „libalpm”\&.


.SH "Documentația typedef"
.PP
.SS "typedef struct _alpm_db_t alpm_db_t"

.PP
A database\&. A database is a container that stores metadata about
packages\&.

.PP
A database can be located on the local filesystem or on a remote server\&.

.PP
To use a database, it must first be registered via
\fBalpm_register_syncdb\fP\&. If the database is already present in dbpath then
it will be usable\&. Otherwise, the database needs to be downloaded using
\fBalpm_db_update\fP\&. Even if the source of the database is the local
filesystem\&.

.PP
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\&.

.PP
Databases are automatically unregistered when the \fBalpm_handle_t\fP is
released\&.
.SH "Documentație privind tipurile de enumerare"
.PP
.SS "enum alpm_db_usage_t"

.PP
Nivelul de utilizare al unei baze de date\&.
.PP
\fBEnumerator\fP
.in +1c
.TP 
\f(BIALPM_DB_USAGE_SYNC \fR
Activează actualizările pentru această bază de date\&.
.TP 
\f(BIALPM_DB_USAGE_SEARCH \fR
Activează căutarea în această bază de date\&.
.TP 
\f(BIALPM_DB_USAGE_INSTALL \fR
Activează instalarea pachetelor de la această bază de date\&.
.TP 
\f(BIALPM_DB_USAGE_UPGRADE \fR
Activează actualizările sistemului (sysupgrades) cu această bază de date\&.
.TP 
\f(BIALPM_DB_USAGE_ALL \fR
Activează toate nivelele de utilizare\&.
.SH "Documentația funcției"
.PP
.SS "int alpm_db_add_cache_server (alpm_db_t * db, const char * url)"

.PP
Adaugă un server de cache pentru descărcări la o bază de date\&.
.PP
\fBParametrii\fP
.RS 4
\fIdb\fP indicator de bază de date
.br
\fIurl\fP adresa URL a serverului
.RE
.PP
\fBReturnează\fP
.RS 4
0 în caz de succes, \-1 în caz de eroare (variabila pm_errno este configurată
în consecință)
.RE
.PP

.SS "int alpm_db_add_server (alpm_db_t * db, const char * url)"

.PP
Adaugă un server de descărcare la o bază de date\&.
.PP
\fBParametrii\fP
.RS 4
\fIdb\fP indicator de bază de date
.br
\fIurl\fP adresa URL a serverului
.RE
.PP
\fBReturnează\fP
.RS 4
0 în caz de succes, \-1 în caz de eroare (variabila pm_errno este configurată
în consecință)
.RE
.PP

.SS "alpm_list_t * alpm_db_get_cache_servers (const alpm_db_t * db)"

.PP
Obține lista serverelor de cache alocate acestei baze de date\&.
.PP
\fBParametrii\fP
.RS 4
\fIdb\fP – indicator către baza de date din care se preiau serverele
.RE
.PP
\fBReturnează\fP
.RS 4
o listă de servere de tip char*
.RE
.PP

.SS "alpm_group_t * alpm_db_get_group (alpm_db_t * db, const char * name)"

.PP
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\&.
.PP
\fBParametrii\fP
.RS 4
\fIdb\fP indicator către baza de date a pachetelor, pentru a prelua grupul din
aceasta
.br
\fIname\fP numele grupului
.RE
.PP
\fBReturnează\fP
.RS 4
intrarea grupurilor în caz de succes, NULL în caz de eroare
.RE
.PP

.SS "alpm_list_t * alpm_db_get_groupcache (alpm_db_t * db)"

.PP
Obține cache\-ul grupului de pachete dintr\-o bază de date de pachete\&.
.PP
\fBParametrii\fP
.RS 4
\fIdb\fP indicator către baza de date a pachetelor, pentru a prelua grupul din
aceasta
.RE
.PP
\fBReturnează\fP
.RS 4
lista grupurilor în caz de succes, NULL în caz de eroare
.RE
.PP

.SS "alpm_handle_t * alpm_db_get_handle (alpm_db_t * db)"

.PP
Obține identificatorul unei baze de date de pachete\&.
.PP
\fBParametrii\fP
.RS 4
\fIdb\fP indicator către baza de date a pachetelor
.RE
.PP
\fBReturnează\fP
.RS 4
gestionarul alpm căruia îi aparține baza de date a pachetelor
.RE
.PP

.SS "const char * alpm_db_get_name (const alpm_db_t * db)"

.PP
Obține numele unei baze de date de pachete\&.
.PP
\fBParametrii\fP
.RS 4
\fIdb\fP indicator către baza de date a pachetelor
.RE
.PP
\fBReturnează\fP
.RS 4
numele bazei de date a pachetului; NULL în caz de eroare
.RE
.PP

.SS "alpm_pkg_t * alpm_db_get_pkg (alpm_db_t * db, const char * name)"

.PP
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\&.
.PP
\fBParametrii\fP
.RS 4
\fIdb\fP – indicator către baza de date a pachetelor, din care se obține
pachetul
.br
\fIname\fP numele pachetului
.RE
.PP
\fBReturnează\fP
.RS 4
intrarea pachetului în caz de succes, NULL în caz de eroare
.RE
.PP

.SS "alpm_list_t * alpm_db_get_pkgcache (alpm_db_t * db)"

.PP
Get the package cache of a package database\&. This is a list of all
packages the db contains\&.
.PP
\fBParametrii\fP
.RS 4
\fIdb\fP – indicator către baza de date a pachetelor, din care se obține
pachetul
.RE
.PP
\fBReturnează\fP
.RS 4
lista pachetelor în caz de succes, NULL în caz de eroare
.RE
.PP

.SS "alpm_list_t * alpm_db_get_servers (const alpm_db_t * db)"

.PP
Obține lista serverelor alocate acestei baze de date\&.
.PP
\fBParametrii\fP
.RS 4
\fIdb\fP – indicator către baza de date din care se preiau serverele
.RE
.PP
\fBReturnează\fP
.RS 4
o listă de servere de tip char*
.RE
.PP

.SS "int alpm_db_get_siglevel (alpm_db_t * db)"

.PP
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\&.
.PP
\fBParametrii\fP
.RS 4
\fIdb\fP indicator către baza de date a pachetelor
.RE
.PP
\fBReturnează\fP
.RS 4
nivelul de verificare a semnăturii
.RE
.PP

.SS "int alpm_db_get_usage (alpm_db_t * db, int * usage)"

.PP
Obține informații despre utilizarea unei baze de date\&.
.PP
\fBParametrii\fP
.RS 4
\fIdb\fP indicator către baza de date a pachetelor pentru a obține starea
.br
\fIusage\fP indicator către un \fBalpm_db_usage_t\fP pentru a stoca starea bazei
de date
.RE
.PP
\fBReturnează\fP
.RS 4
0 în caz de succes, sau \-1 în caz de eșec
.RE
.PP

.SS "int alpm_db_get_valid (alpm_db_t * db)"

.PP
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\&.
.PP
\fBParametrii\fP
.RS 4
\fIdb\fP indicator către baza de date a pachetelor
.RE
.PP
\fBReturnează\fP
.RS 4
0 dacă este valid, \-1 dacă nu este valid (pm_errno este configurată în
consecință)
.RE
.PP

.SS "int alpm_db_remove_cache_server (alpm_db_t * db, const char * url)"

.PP
Elimină un server de cache pentru descărcări de la o bază de date\&.
.PP
\fBParametrii\fP
.RS 4
\fIdb\fP indicator de bază de date
.br
\fIurl\fP adresa URL a serverului
.RE
.PP
\fBReturnează\fP
.RS 4
0 on success, 1 on server not present, \-1 on error (pm_errno is set
accordingly)
.RE
.PP

.SS "int alpm_db_remove_server (alpm_db_t * db, const char * url)"

.PP
Elimină un server de descărcare de la o bază de date\&.
.PP
\fBParametrii\fP
.RS 4
\fIdb\fP indicator de bază de date
.br
\fIurl\fP adresa URL a serverului
.RE
.PP
\fBReturnează\fP
.RS 4
0 on success, 1 on server not present, \-1 on error (pm_errno is set
accordingly)
.RE
.PP

.SS "int alpm_db_search (alpm_db_t * db, const alpm_list_t * needles, alpm_list_t ** ret)"

.PP
Caută într\-o bază de date folosind expresii regulate\&.
.PP
\fBParametrii\fP
.RS 4
indicator către baza de date a pachetelor în care se va efectua căutarea
.br
\fIneedles\fP o listă de expresii regulate care trebuie căutate
.br
\fIret\fP pointer to list for storing packages matching all regular expressions
\- must point to an empty (NULL) \fBalpm_list_t\fP *\&.
.RE
.PP
\fBReturnează\fP
.RS 4
0 în caz de succes, \-1 în caz de eroare (variabila pm_errno este configurată
în consecință)
.RE
.PP

.SS "int alpm_db_set_cache_servers (alpm_db_t * db, alpm_list_t * servers)"

.PP
Stabilește lista serverelor de cache pe care baza de date trebuie să le
utilizeze\&.
.PP
\fBParametrii\fP
.RS 4
\fIdb\fP the database to set the servers\&. The list will be duped and the
original will still need to be freed by the caller\&.
.br
\fIservers\fP o listă de servere de tip char*\&.
.RE
.PP

.SS "int alpm_db_set_servers (alpm_db_t * db, alpm_list_t * servers)"

.PP
Stabilește lista de servere pe care baza de date trebuie să le utilizeze\&.
.PP
\fBParametrii\fP
.RS 4
\fIdb\fP the database to set the servers\&. The list will be duped and the
original will still need to be freed by the caller\&.
.br
\fIservers\fP o listă de servere de tip char*\&.
.RE
.PP

.SS "int alpm_db_set_usage (alpm_db_t * db, int usage)"

.PP
Configurează utilizarea unei baze de date\&.
.PP
\fBParametrii\fP
.RS 4
\fIdb\fP indicator către baza de date a pachetelor pentru a stabili starea
acesteia
.br
\fIusage\fP o mască de biți compusă din valori de tip \fBalpm_db_usage_t\fP
.RE
.PP
\fBReturnează\fP
.RS 4
0 în caz de succes, sau \-1 în caz de eșec
.RE
.PP

.SS "int alpm_db_unregister (alpm_db_t * db)"

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

.PP
\fBParametrii\fP
.RS 4
\fIdb\fP pointer to the package database to unregister
.RE
.PP
\fBReturnează\fP
.RS 4
0 în caz de succes, \-1 în caz de eroare (variabila pm_errno este configurată
în consecință)
.RE
.PP

.SS "int alpm_db_update (alpm_handle_t * handle, alpm_list_t * dbs, int force)"

.PP
Update package databases\&. An update of the package databases in the list
\fIdbs\fP will be attempted\&. Unless \fIforce\fP is true, the update will only be
performed if the remote databases were modified since the last update\&.

.PP
This operation requires a database lock, and will return an applicable error
if the lock could not be obtained\&.

.PP
Exemplu:
.PP
.nf
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)\en"),
        alpm_strerror(alpm_errno(config\->handle)));
}

.fi
.PP

.PP
\fBNotă\fP
.RS 4
After a successful update, the \fBpackage cache \fP will be invalidated
.RE
.PP
\fBParametrii\fP
.RS 4
\fIhandle\fP the context handle
.br
\fIdbs\fP list of package databases to update
.br
\fIforce\fP if true, then forces the update, otherwise update only in case the
databases aren't up to date
.RE
.PP
\fBReturnează\fP
.RS 4
0 on success, \-1 on error (pm_errno is set accordingly), 1 if all databases
are up to to date
.RE
.PP

.SS "alpm_db_t * alpm_get_localdb (alpm_handle_t * handle)"

.PP
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\&.
.PP
\fBReturnează\fP
.RS 4
o referință la baza de date locală
.RE
.PP

.SS "alpm_list_t * alpm_get_syncdbs (alpm_handle_t * handle)"

.PP
Get the list of sync databases\&. Returns a list of \fBalpm_db_t\fP structures,
one for each registered sync database\&.

.PP
\fBParametrii\fP
.RS 4
\fIhandle\fP the context handle
.RE
.PP
\fBReturnează\fP
.RS 4
a reference to an internal list of \fBalpm_db_t\fP structures
.RE
.PP

.SS "alpm_db_t * alpm_register_syncdb (alpm_handle_t * handle, const char * treename, int level)"

.PP
Register a sync database of packages\&. Databases can not be registered when
there is an active transaction\&.

.PP
\fBParametrii\fP
.RS 4
\fIhandle\fP the context handle
.br
\fItreename\fP the name of the sync repository
.br
\fIlevel\fP what level of signature checking to perform on the database; note
that this must be a '\&.sig' file type verification
.RE
.PP
\fBReturnează\fP
.RS 4
an alpm_db_t* on success (the value), NULL on error
.RE
.PP

.SS "int alpm_unregister_all_syncdbs (alpm_handle_t * handle)"

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

.PP
\fBParametrii\fP
.RS 4
\fIhandle\fP the context handle
.RE
.PP
\fBReturnează\fP
.RS 4
0 în caz de succes, \-1 în caz de eroare (variabila pm_errno este configurată
în consecință)
.RE
.PP

.SH Autor
.PP
Generat automat de Doxygen pentru „libalpm” din codul sursă\&.
.PP
.SH TRADUCERE
Traducerea în limba română a acestui manual a fost făcută de
Remus-Gabriel Chelu <remusgabriel.chelu@disroot.org>
.
.PP
Această traducere este documentație gratuită; citiți
.UR https://www.gnu.org/licenses/gpl-3.0.html
Licența publică generală GNU Versiunea 3
.UE
sau o versiune ulterioară cu privire la condiții privind drepturile de autor.
NU se asumă NICIO RESPONSABILITATE.
.PP
Dacă găsiți erori în traducerea acestui manual,
vă rugăm să trimiteți un e-mail la
.MT translation-team-ro@lists.sourceforge.net
.ME .