.\" -*- coding: UTF-8 -*- .\" -*- nroff -*- .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH libalpm_databases 3 libalpm .ad l .nh .SH NOME libalpm_databases \- Database .PP \- Functions to query and manipulate the database of libalpm\&. .SH SINOPSE .br .PP .SS "Definições de tipos" .in +1c .ti -1c typedef struct _alpm_db_t \fBalpm_db_t\fP .br Uma base de dados\&. .in -1c .SS Enumerações .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 O nível de uso de uma base de dados\&. .in -1c .SS Funções .in +1c .ti -1c \fBalpm_db_t\fP * \fBalpm_get_localdb\fP (\fBalpm_handle_t\fP *handle) .br Obtém a base de dados de pacotes instalados localmente\&. .ti -1c \fBalpm_list_t\fP * \fBalpm_get_syncdbs\fP (\fBalpm_handle_t\fP *handle) .br Obtém a lista de base de dados de sincronização\&. .ti -1c \fBalpm_db_t\fP * \fBalpm_register_syncdb\fP (\fBalpm_handle_t\fP *handle, const char *treename, int level) .br Registra uma base de dados de sincronização de pacotes\&. .ti -1c int \fBalpm_unregister_all_syncdbs\fP (\fBalpm_handle_t\fP *handle) .br Desregistra todas as bases de dados de pacotes\&. .ti -1c int \fBalpm_db_unregister\fP (\fBalpm_db_t\fP *db) .br Desregistra uma base de dados de pacotes\&. .ti -1c \fBalpm_handle_t\fP * \fBalpm_db_get_handle\fP (\fBalpm_db_t\fP *db) .br Obtém o identificador de uma base de dados de pacotes\&. .ti -1c const char * \fBalpm_db_get_name\fP (const \fBalpm_db_t\fP *db) .br Obtém o nome de uma base de dados de pacotes\&. .ti -1c int \fBalpm_db_get_siglevel\fP (\fBalpm_db_t\fP *db) .br Obtém o nível de verificação da asinatura de uma base de dados\&. .ti -1c int \fBalpm_db_get_valid\fP (\fBalpm_db_t\fP *db) .br Verifica a validade de uma base de dados\&. .ti -1c int \fBalpm_db_update\fP (\fBalpm_handle_t\fP *handle, \fBalpm_list_t\fP *dbs, int force) .br Atualiza bases de dados de pacotes\&. .ti -1c \fBalpm_pkg_t\fP * \fBalpm_db_get_pkg\fP (\fBalpm_db_t\fP *db, const char *name) .br Obtém uma entrada de pacote de uma base de dados de pacotes\&. .ti -1c \fBalpm_list_t\fP * \fBalpm_db_get_pkgcache\fP (\fBalpm_db_t\fP *db) .br Obtém o cachoe de pacotes de um base de dados de pacotes\&. .ti -1c \fBalpm_group_t\fP * \fBalpm_db_get_group\fP (\fBalpm_db_t\fP *db, const char *name) .br Obtém uma entrada de grupo de uma base de dados de pacotes\&. .ti -1c \fBalpm_list_t\fP * \fBalpm_db_get_groupcache\fP (\fBalpm_db_t\fP *db) .br Obtém o cache de grupo de uma base de dados de pacotes\&. .ti -1c int \fBalpm_db_search\fP (\fBalpm_db_t\fP *db, const \fBalpm_list_t\fP *needles, \fBalpm_list_t\fP **ret) .br Pesquisa em uma base de dados com expressões regulares\&. .in -1c .SS "Métodos para servidores" .in +1c .ti -1c \fBalpm_list_t\fP * \fBalpm_db_get_servers\fP (const \fBalpm_db_t\fP *db) .br Obtém a lista de servidores atribuídos a esta base de dados\&. .ti -1c int \fBalpm_db_set_servers\fP (\fBalpm_db_t\fP *db, \fBalpm_list_t\fP *servers) .br Define a lista de servidores da base de dados para usar\&. .ti -1c int \fBalpm_db_add_server\fP (\fBalpm_db_t\fP *db, const char *url) .br Adiciona uma servidor de download para uma base de dados\&. .ti -1c int \fBalpm_db_remove_server\fP (\fBalpm_db_t\fP *db, const char *url) .br Remove um servidor de download de uma base de dados\&. .ti -1c \fBalpm_list_t\fP * \fBalpm_db_get_cache_servers\fP (const \fBalpm_db_t\fP *db) .br Obtém a lista de servidores de cache atribuídos a esta base de dados\&. .ti -1c int \fBalpm_db_set_cache_servers\fP (\fBalpm_db_t\fP *db, \fBalpm_list_t\fP *servers) .br Define a lista de servidores de cache desta base de dados para usar\&. .ti -1c int \fBalpm_db_add_cache_server\fP (\fBalpm_db_t\fP *db, const char *url) .br Adiciona um servidor de cache de download para uma base de dados\&. .ti -1c int \fBalpm_db_remove_cache_server\fP (\fBalpm_db_t\fP *db, const char *url) .br Remove um servidor de cache de download de uma base de dados\&. .in -1c .SS "Métodos de uso" .in +1c .ti -1c int \fBalpm_db_set_usage\fP (\fBalpm_db_t\fP *db, int usage) .br Define o uso de uma base de dados\&. .ti -1c int \fBalpm_db_get_usage\fP (\fBalpm_db_t\fP *db, int *usage) .br Obtém o uso de uma base de dados\&. .in -1c .SH "Descrição detalhada" .PP Funções para consultar e manipular a base de dados do libalpm\&. .SH "Documentação das definições de tipo" .PP .SS "typedef struct _alpm_db_t alpm_db_t" .PP Uma base de dados\&. Uma base de dados é um contêiner que armazena metadados sobre pacotes\&. .PP Uma base de dados pode estar localizada no sistema de arquivos local ou em um servidor remoto\&. .PP Para usar uma base de dados, ela deve primeiro ser registrada via \fBalpm_register_syncdb\fP\&. Se a base de dados já estiver presente no dbpath, ela ficará usável\&. Do contrário, a base de dados precisa ser baixada usando \fBalpm_db_update\fP\&. Mesmo se a origem da base de dados for o sistema de arquivos local\&. .PP Após isso, a base de dados poderá ser usada para consultar pacotes e grupos\&. Quaisquer pacotes ou grupos da base de dados continuarão sendo de propriedade da base de dados e não precisarão ser liberados pelo usuário\&. Eles serão liberados quando a base de dados for desregistrada\&. .PP Bases de dados são desregistradas automaticamente quando \fBalpm_handle_t\fP é liberada\&. .SH "Documentação de tipos enumeração" .PP .SS "enum alpm_db_usage_t" .PP O nível de uso de uma base de dados\&. .PP \fBEnumerador\fP .in +1c .TP \f(BIALPM_DB_USAGE_SYNC \fR Habilita atualizações para esta base de dados\&. .TP \f(BIALPM_DB_USAGE_SEARCH \fR Habilita pesquisa para esta base de dados\&. .TP \f(BIALPM_DB_USAGE_INSTALL \fR HAbilita instalação de pacotes a partir desta base de dados\&. .TP \f(BIALPM_DB_USAGE_UPGRADE \fR Habilita atualização de sistema (sysupgrades)\&. .TP \f(BIALPM_DB_USAGE_ALL \fR Habilita todos os níveis de uso\&. .SH "Documentação das funções" .PP .SS "int alpm_db_add_cache_server (alpm_db_t * db, const char * url)" .PP Adiciona um servidor de cache de download para uma base de dados\&. .PP \fBParâmetros\fP .RS 4 \fIdb\fP ponteiro de base de dados .br \fIurl\fP url do servidor .RE .PP \fBRetorna\fP .RS 4 0 em caso de sucsso, \-1 em caso de erro (pm_errno é definido de acordo) .RE .PP .SS "int alpm_db_add_server (alpm_db_t * db, const char * url)" .PP Adiciona uma servidor de download para uma base de dados\&. .PP \fBParâmetros\fP .RS 4 \fIdb\fP ponteiro de base de dados .br \fIurl\fP url do servidor .RE .PP \fBRetorna\fP .RS 4 0 em caso de sucsso, \-1 em caso de erro (pm_errno é definido de acordo) .RE .PP .SS "alpm_list_t * alpm_db_get_cache_servers (const alpm_db_t * db)" .PP Obtém a lista de servidores de cache atribuídos a esta base de dados\&. .PP \fBParâmetros\fP .RS 4 \fIdb\fP ponteiro à base de dados para obter servidores .RE .PP \fBRetorna\fP .RS 4 uma lista de char* de servidores .RE .PP .SS "alpm_group_t * alpm_db_get_group (alpm_db_t * db, const char * name)" .PP Obtém uma entrada de grupo de uma base de dados de pacotes\&. A busca por um grupo é O(1) e será significativamente mais rápida do que iterar sobre o groupcahe\&. .PP \fBParâmetros\fP .RS 4 \fIdb\fP ponteiro da base de dados de pacotes para obter o grupo .br \fIname\fP do grupo .RE .PP \fBRetorna\fP .RS 4 a entada do grupo em caso de sucsso, NULO em caso de servidor .RE .PP .SS "alpm_list_t * alpm_db_get_groupcache (alpm_db_t * db)" .PP Obtém o cache de grupo de uma base de dados de pacotes\&. .PP \fBParâmetros\fP .RS 4 \fIdb\fP ponteiro da base de dados de pacotes para obter o grupo .RE .PP \fBRetorna\fP .RS 4 a lista de grupos em caso de sucsso, NULO em caso de erro .RE .PP .SS "alpm_handle_t * alpm_db_get_handle (alpm_db_t * db)" .PP Obtém o identificador de uma base de dados de pacotes\&. .PP \fBParâmetros\fP .RS 4 \fIdb\fP ponteiro da base de dados de pacotes .RE .PP \fBRetorna\fP .RS 4 o identificador do alpm à qual a base de dados de pacotes pertence .RE .PP .SS "const char * alpm_db_get_name (const alpm_db_t * db)" .PP Obtém o nome de uma base de dados de pacotes\&. .PP \fBParâmetros\fP .RS 4 \fIdb\fP ponteiro da base de dados de pacotes .RE .PP \fBRetorna\fP .RS 4 o nome da base de dados de pacotes, NULO em caso de erro .RE .PP .SS "alpm_pkg_t * alpm_db_get_pkg (alpm_db_t * db, const char * name)" .PP Obtém uma entrada de pacote de uma base de dados de pacotes\&. A busca por um pacote é O(1) e será significativamente mais rápida do que iterar sobre o pkgcahe\&. .PP \fBParâmetros\fP .RS 4 \fIdb\fP ponteiro para a base de dados da qual obtém o pacote .br \fIname\fP do pacote .RE .PP \fBRetorna\fP .RS 4 a entrada de pacote em caso de sucsso, NULL em caso de erro .RE .PP .SS "alpm_list_t * alpm_db_get_pkgcache (alpm_db_t * db)" .PP Obtém o cache de pacotes de uma base de dados do pacote\&. Isso é uma lista de todos os pacotes que a base de dados contém\&. .PP \fBParâmetros\fP .RS 4 \fIdb\fP ponteiro para a base de dados da qual obtém o pacote .RE .PP \fBRetorna\fP .RS 4 a lista de pacotes em caso de sucsso, NULO em caso de erro .RE .PP .SS "alpm_list_t * alpm_db_get_servers (const alpm_db_t * db)" .PP Obtém a lista de servidores atribuídos a esta base de dados\&. .PP \fBParâmetros\fP .RS 4 \fIdb\fP ponteiro à base de dados para obter servidores .RE .PP \fBRetorna\fP .RS 4 uma lista de char* de servidores .RE .PP .SS "int alpm_db_get_siglevel (alpm_db_t * db)" .PP Obtém o nível de verificação de assinatura para uma base de dados\&. Retornará o nível de verificação padrão se esta base de dados estiver configurado com ALPM_SIG_USE_DEFAULT\&. .PP \fBParâmetros\fP .RS 4 \fIdb\fP ponteiro da base de dados de pacotes .RE .PP \fBRetorna\fP .RS 4 o nível de verificação de assinatura .RE .PP .SS "int alpm_db_get_usage (alpm_db_t * db, int * usage)" .PP Obtém o uso de uma base de dados\&. .PP \fBParâmetros\fP .RS 4 \fIdb\fP ponteiro da base de dados de pacotes para obter o status .br \fIusage\fP ponteiro para um \fBalpm_db_usage_t\fP para armazenar o status da base de dados .RE .PP \fBRetorna\fP .RS 4 0 em caso de sucesso ou \-1 em caso de erro .RE .PP .SS "int alpm_db_get_valid (alpm_db_t * db)" .PP Verifica a validade de uma base de dados\&. Isso é muito útil para sincronizar bases de dados e verificar o status da assinatura\&. Se inválido, o código de erro do manipulador será definido de acordo\&. .PP \fBParâmetros\fP .RS 4 \fIdb\fP ponteiro da base de dados de pacotes .RE .PP \fBRetorna\fP .RS 4 0 se válida, \-1 se inválida (pm_errno é definido de acordo) .RE .PP .SS "int alpm_db_remove_cache_server (alpm_db_t * db, const char * url)" .PP Remove um servidor de cache de download de uma base de dados\&. .PP \fBParâmetros\fP .RS 4 \fIdb\fP ponteiro de base de dados .br \fIurl\fP url do servidor .RE .PP \fBRetorna\fP .RS 4 0 em caso de sucesso, 1 em caso do servidor não estar presente, \-1 em caso de erro (pm_errno é definido de acordo) .RE .PP .SS "int alpm_db_remove_server (alpm_db_t * db, const char * url)" .PP Remove um servidor de download de uma base de dados\&. .PP \fBParâmetros\fP .RS 4 \fIdb\fP ponteiro de base de dados .br \fIurl\fP url do servidor .RE .PP \fBRetorna\fP .RS 4 0 em caso de sucesso, 1 em caso do servidor não estar presente, \-1 em caso de erro (pm_errno é definido de acordo) .RE .PP .SS "int alpm_db_search (alpm_db_t * db, const alpm_list_t * needles, alpm_list_t ** ret)" .PP Pesquisa em uma base de dados com expressões regulares\&. .PP \fBParâmetros\fP .RS 4 \fIdb\fP ponteiro para a base de dados de pacotes para pesquisar .br \fIneedles\fP uma lista de expressões regulares para pesquisar .br \fIret\fP ponteiro para uma lista que armazena pacotes correspondentes a todas as expressões regulares \- deve apontar para uma lista \fBalpm_list_t\fP * vazia (NULA)\&. .RE .PP \fBRetorna\fP .RS 4 0 em caso de sucsso, \-1 em caso de erro (pm_errno é definido de acordo) .RE .PP .SS "int alpm_db_set_cache_servers (alpm_db_t * db, alpm_list_t * servers)" .PP Define a lista de servidores de cache desta base de dados para usar\&. .PP \fBParâmetros\fP .RS 4 \fIdb\fP a base de dados para define os servidores\&. A lista será duplicada e a original ainda precisará ser liberada pelo chamador\&. .br \fIservers\fP uma lista char* de servidores\&. .RE .PP .SS "int alpm_db_set_servers (alpm_db_t * db, alpm_list_t * servers)" .PP Define a lista de servidores da base de dados para usar\&. .PP \fBParâmetros\fP .RS 4 \fIdb\fP a base de dados para define os servidores\&. A lista será duplicada e a original ainda precisará ser liberada pelo chamador\&. .br \fIservers\fP uma lista char* de servidores\&. .RE .PP .SS "int alpm_db_set_usage (alpm_db_t * db, int usage)" .PP Define o uso de uma base de dados\&. .PP \fBParâmetros\fP .RS 4 \fIdb\fP ponteiro para a base de dados de pacotes para definir o status .br \fIusage\fP uma máscara de bits de valores de \fBalpm_db_usage_t\fP .RE .PP \fBRetorna\fP .RS 4 0 em caso de sucesso ou \-1 em caso de erro .RE .PP .SS "int alpm_db_unregister (alpm_db_t * db)" .PP Desregistra uma base de dados dos pacotes\&. Base de dados não podem ser desregistradas quando há uma transação ativa\&. .PP \fBParâmetros\fP .RS 4 \fIdb\fP ponteiro para a base de dados de pacotes para desregistrar .RE .PP \fBRetorna\fP .RS 4 0 em caso de sucsso, \-1 em caso de erro (pm_errno é definido de acordo) .RE .PP .SS "int alpm_db_update (alpm_handle_t * handle, alpm_list_t * dbs, int force)" .PP Atualiza bases de dados de pacotes\&. Uma atualização das bases de dados de pacotes na lista \fIdbs\fP será tentada\&. A menos que \fIforce\fP seja verdadeiro, a atualização só será realizada se as bases de dados remotos tiverem sido modificados desde a última atualização\&. .PP Esta operação requer um trava de base de dados e retornará um erro aplicável caso a trava não possa ser obtido. .PP Exemplo: .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, _("failed to synchronize all databases (%s)\en"), alpm_strerror(alpm_errno(config\->handle))); } .fi .PP .PP \fBNota\fP .RS 4 Após uma atualização bem sucedida, o \fBcache de pacotes \fP será invalidado .RE .PP \fBParâmetros\fP .RS 4 \fIhandle\fP o manipulador do contexto .br \fIdbs\fP lista das base de dados de pacotes para atualizar .br \fIforce\fP se verdadeiro, força a atualizar; do contrário, atualiza apenas em caso das bases de dados não estarem desatualizadas .RE .PP \fBRetorna\fP .RS 4 0 em caso de sucesso, \-1 em caso de erro (pm_errno está definido de acordo), 1 se todas base de dados estiverem atualizadas .RE .PP .SS "alpm_db_t * alpm_get_localdb (alpm_handle_t * handle)" .PP Obtém a base de dados de pacotes instalados localmente\&. O ponteiro retornado aponta para uma estrutura interna da libalpm que só deve ser manipulada por meio de funções da libalpm\*. .PP \fBRetorna\fP .RS 4 uma referência à base de dados local .RE .PP .SS "alpm_list_t * alpm_get_syncdbs (alpm_handle_t * handle)" .PP Obtém a lista de bases de dados de sincronização\&. Retorna uma lista de estruturas \fBalpm_db_t\fP, uma para cada base de dados de sincronização registrada\&. .PP \fBParâmetros\fP .RS 4 \fIhandle\fP o manipulador do contexto .RE .PP \fBRetorna\fP .RS 4 uma referência a uma lista interna de estruturas de \fBalpm_db_t\fP .RE .PP .SS "alpm_db_t * alpm_register_syncdb (alpm_handle_t * handle, const char * treename, int level)" .PP Registra uma base de dados de sincronização de pacotes\&. Bases de dados não podem ser registradas quando há uma transação ativa\&. .PP \fBParâmetros\fP .RS 4 \fIhandle\fP o manipulador do contexto .br \fItreename\fP o nome do repositório de sincronização .br \fIlevel\fP qual o nível de verificação de assinatura para realizar a base de dados; note que isso deve ser uma verificação do tipo de arquivo '\&.sig' .RE .PP \fBRetorna\fP .RS 4 um alpm_db_t* em caso de sucesso (o valor), NULO em caso de erro .RE .PP .SS "int alpm_unregister_all_syncdbs (alpm_handle_t * handle)" .PP Desregistra todas as bases de dados de pacotes\&. Bases de dados não podem ser desregistradas enquanto há uma transação ativa\&. .PP \fBParâmetros\fP .RS 4 \fIhandle\fP o manipulador do contexto .RE .PP \fBRetorna\fP .RS 4 0 em caso de sucsso, \-1 em caso de erro (pm_errno é definido de acordo) .RE .PP .SH Autor .PP Gerado automaticamente por Doxygen para libalpm a partir do código\-fonte\&. .PP .SH TRADUÇÃO A tradução para português brasileiro desta página man foi criada por Rafael Fontenelle . .PP Esta tradução é uma documentação livre; leia a .UR https://www.gnu.org/licenses/gpl-3.0.html Licença Pública Geral GNU Versão 3 .UE ou posterior para as condições de direitos autorais. Nenhuma responsabilidade é aceita. .PP Se você encontrar algum erro na tradução desta página de manual, envie um e-mail para .MT debian-l10n-portuguese@lists.debian.org a lista de discussão de tradutores .ME .