libalpm_databases(3) Library Functions Manual libalpm_databases(3)

libalpm_databases - Database


- Functions to query and manipulate the database of libalpm.


typedef struct _alpm_db_t alpm_db_t
Uma base de dados.


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 }
O nível de uso de uma base de dados.


alpm_db_t * alpm_get_localdb (alpm_handle_t *handle)
Obtém a base de dados de pacotes instalados localmente. alpm_list_t * alpm_get_syncdbs (alpm_handle_t *handle)
Obtém a lista de base de dados de sincronização. alpm_db_t * alpm_register_syncdb (alpm_handle_t *handle, const char *treename, int level)
Registra uma base de dados de sincronização de pacotes. int alpm_unregister_all_syncdbs (alpm_handle_t *handle)
Desregistra todas as bases de dados de pacotes. int alpm_db_unregister (alpm_db_t *db)
Desregistra uma base de dados de pacotes. alpm_handle_t * alpm_db_get_handle (alpm_db_t *db)
Obtém o identificador de uma base de dados de pacotes. const char * alpm_db_get_name (const alpm_db_t *db)
Obtém o nome de uma base de dados de pacotes. int alpm_db_get_siglevel (alpm_db_t *db)
Obtém o nível de verificação da asinatura de uma base de dados. int alpm_db_get_valid (alpm_db_t *db)
Verifica a validade de uma base de dados. int alpm_db_update (alpm_handle_t *handle, alpm_list_t *dbs, int force)
Atualiza bases de dados de pacotes. alpm_pkg_t * alpm_db_get_pkg (alpm_db_t *db, const char *name)
Obtém uma entrada de pacote de uma base de dados de pacotes. alpm_list_t * alpm_db_get_pkgcache (alpm_db_t *db)
Obtém o cachoe de pacotes de um base de dados de pacotes. alpm_group_t * alpm_db_get_group (alpm_db_t *db, const char *name)
Obtém uma entrada de grupo de uma base de dados de pacotes. alpm_list_t * alpm_db_get_groupcache (alpm_db_t *db)
Obtém o cache de grupo de uma base de dados de pacotes. int alpm_db_search (alpm_db_t *db, const alpm_list_t *needles, alpm_list_t **ret)
Pesquisa em uma base de dados com expressões regulares.

Métodos para servidores


alpm_list_t * alpm_db_get_servers (const alpm_db_t *db)
Obtém a lista de servidores atribuídos a esta base de dados. int alpm_db_set_servers (alpm_db_t *db, alpm_list_t *servers)
Define a lista de servidores da base de dados para usar. int alpm_db_add_server (alpm_db_t *db, const char *url)
Adiciona uma servidor de download para uma base de dados. int alpm_db_remove_server (alpm_db_t *db, const char *url)
Remove um servidor de download de uma base de dados. alpm_list_t * alpm_db_get_cache_servers (const alpm_db_t *db)
Obtém a lista de servidores de cache atribuídos a esta base de dados. int alpm_db_set_cache_servers (alpm_db_t *db, alpm_list_t *servers)
Define a lista de servidores de cache desta base de dados para usar. int alpm_db_add_cache_server (alpm_db_t *db, const char *url)
Adiciona um servidor de cache de download para uma base de dados. int alpm_db_remove_cache_server (alpm_db_t *db, const char *url)
Remove um servidor de cache de download de uma base de dados.

Métodos de uso


int alpm_db_set_usage (alpm_db_t *db, int usage)
Define o uso de uma base de dados. int alpm_db_get_usage (alpm_db_t *db, int *usage)
Obtém o uso de uma base de dados.

Funções para consultar e manipular a base de dados do libalpm.

Documentação das definições de tipo

Uma base de dados. Uma base de dados é um contêiner que armazena metadados sobre pacotes.

Uma base de dados pode estar localizada no sistema de arquivos local ou em um servidor remoto.

Para usar uma base de dados, ela deve primeiro ser registrada via alpm_register_syncdb. 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 alpm_db_update. Mesmo se a origem da base de dados for o sistema de arquivos local.

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.

Bases de dados são desregistradas automaticamente quando alpm_handle_t é liberada.

Documentação de tipos enumeração

O nível de uso de uma base de dados.

Enumerador

Habilita atualizações para esta base de dados.
Habilita pesquisa para esta base de dados.
HAbilita instalação de pacotes a partir desta base de dados.
Habilita atualização de sistema (sysupgrades).
Habilita todos os níveis de uso.

Documentação das funções

Adiciona um servidor de cache de download para uma base de dados.

Parâmetros

db ponteiro de base de dados
url url do servidor

Retorna

0 em caso de sucsso, -1 em caso de erro (pm_errno é definido de acordo)

Adiciona uma servidor de download para uma base de dados.

Parâmetros

db ponteiro de base de dados
url url do servidor

Retorna

0 em caso de sucsso, -1 em caso de erro (pm_errno é definido de acordo)

Obtém a lista de servidores de cache atribuídos a esta base de dados.

Parâmetros

db ponteiro à base de dados para obter servidores

Retorna

uma lista de char* de servidores

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.

Parâmetros

db ponteiro da base de dados de pacotes para obter o grupo
name do grupo

Retorna

a entada do grupo em caso de sucsso, NULO em caso de servidor

Obtém o cache de grupo de uma base de dados de pacotes.

Parâmetros

db ponteiro da base de dados de pacotes para obter o grupo

Retorna

a lista de grupos em caso de sucsso, NULO em caso de erro

Obtém o identificador de uma base de dados de pacotes.

Parâmetros

db ponteiro da base de dados de pacotes

Retorna

o identificador do alpm à qual a base de dados de pacotes pertence

Obtém o nome de uma base de dados de pacotes.

Parâmetros

db ponteiro da base de dados de pacotes

Retorna

o nome da base de dados de pacotes, NULO em caso de erro

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.

Parâmetros

db ponteiro para a base de dados da qual obtém o pacote
name do pacote

Retorna

a entrada de pacote em caso de sucsso, NULL em caso de erro

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.

Parâmetros

db ponteiro para a base de dados da qual obtém o pacote

Retorna

a lista de pacotes em caso de sucsso, NULO em caso de erro

Obtém a lista de servidores atribuídos a esta base de dados.

Parâmetros

db ponteiro à base de dados para obter servidores

Retorna

uma lista de char* de servidores

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.

Parâmetros

db ponteiro da base de dados de pacotes

Retorna

o nível de verificação de assinatura

Obtém o uso de uma base de dados.

Parâmetros

db ponteiro da base de dados de pacotes para obter o status
usage ponteiro para um alpm_db_usage_t para armazenar o status da base de dados

Retorna

0 em caso de sucesso ou -1 em caso de erro

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.

Parâmetros

db ponteiro da base de dados de pacotes

Retorna

0 se válida, -1 se inválida (pm_errno é definido de acordo)

Remove um servidor de cache de download de uma base de dados.

Parâmetros

db ponteiro de base de dados
url url do servidor

Retorna

0 em caso de sucesso, 1 em caso do servidor não estar presente, -1 em caso de erro (pm_errno é definido de acordo)

Remove um servidor de download de uma base de dados.

Parâmetros

db ponteiro de base de dados
url url do servidor

Retorna

0 em caso de sucesso, 1 em caso do servidor não estar presente, -1 em caso de erro (pm_errno é definido de acordo)

Pesquisa em uma base de dados com expressões regulares.

Parâmetros

db ponteiro para a base de dados de pacotes para pesquisar
needles uma lista de expressões regulares para pesquisar
ret ponteiro para uma lista que armazena pacotes correspondentes a todas as expressões regulares - deve apontar para uma lista alpm_list_t * vazia (NULA).

Retorna

0 em caso de sucsso, -1 em caso de erro (pm_errno é definido de acordo)

Define a lista de servidores de cache desta base de dados para usar.

Parâmetros

db a base de dados para define os servidores. A lista será duplicada e a original ainda precisará ser liberada pelo chamador.
servers uma lista char* de servidores.

Define a lista de servidores da base de dados para usar.

Parâmetros

db a base de dados para define os servidores. A lista será duplicada e a original ainda precisará ser liberada pelo chamador.
servers uma lista char* de servidores.

Define o uso de uma base de dados.

Parâmetros

db ponteiro para a base de dados de pacotes para definir o status
usage uma máscara de bits de valores de alpm_db_usage_t

Retorna

0 em caso de sucesso ou -1 em caso de erro

Desregistra uma base de dados dos pacotes. Base de dados não podem ser desregistradas quando há uma transação ativa.

Parâmetros

db ponteiro para a base de dados de pacotes para desregistrar

Retorna

0 em caso de sucsso, -1 em caso de erro (pm_errno é definido de acordo)

Atualiza bases de dados de pacotes. Uma atualização das bases de dados de pacotes na lista dbs será tentada. A menos que force seja verdadeiro, a atualização só será realizada se as bases de dados remotos tiverem sido modificados desde a última atualização.

Esta operação requer um trava de base de dados e retornará um erro aplicável caso a trava não possa ser obtido.

Exemplo:

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

Nota

Após uma atualização bem sucedida, o cache de pacotes será invalidado

Parâmetros

handle o manipulador do contexto
dbs lista das base de dados de pacotes para atualizar
force se verdadeiro, força a atualizar; do contrário, atualiza apenas em caso das bases de dados não estarem desatualizadas

Retorna

0 em caso de sucesso, -1 em caso de erro (pm_errno está definido de acordo), 1 se todas base de dados estiverem atualizadas

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

Retorna

uma referência à base de dados local

Obtém a lista de bases de dados de sincronização. Retorna uma lista de estruturas alpm_db_t, uma para cada base de dados de sincronização registrada.

Parâmetros

handle o manipulador do contexto

Retorna

uma referência a uma lista interna de estruturas de alpm_db_t

Registra uma base de dados de sincronização de pacotes. Bases de dados não podem ser registradas quando há uma transação ativa.

Parâmetros

handle o manipulador do contexto
treename o nome do repositório de sincronização
level 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'

Retorna

um alpm_db_t* em caso de sucesso (o valor), NULO em caso de erro

Desregistra todas as bases de dados de pacotes. Bases de dados não podem ser desregistradas enquanto há uma transação ativa.

Parâmetros

handle o manipulador do contexto

Retorna

0 em caso de sucsso, -1 em caso de erro (pm_errno é definido de acordo)

Gerado automaticamente por Doxygen para libalpm a partir do código-fonte.

A tradução para português brasileiro desta página man foi criada por Rafael Fontenelle <rafaelff@gnome.org>

Esta tradução é uma documentação livre; leia a Licença Pública Geral GNU Versão 3 ou posterior para as condições de direitos autorais. Nenhuma responsabilidade é aceita.

Se você encontrar algum erro na tradução desta página de manual, envie um e-mail para a lista de discussão de tradutores.

libalpm