libalpm_databases(3)

NOME
libalpm_databases - Database

 - Functions to query and manipulate the database of libalpm.

SINOPSE

  Definições de tipos
typedef struct _alpm_db_t alpm_db_t
Uma base de dados.

  Enumerações
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.

  Funções
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.

Descrição detalhada

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

Documentação das definições de tipo

  typedef struct _alpm_db_t alpm_db_t

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

  enum alpm_db_usage_t

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

Enumerador

ALPM_DB_USAGE_SYNC
    Habilita atualizações para esta base de dados.

ALPM_DB_USAGE_SEARCH
    Habilita pesquisa para esta base de dados.

ALPM_DB_USAGE_INSTALL
    HAbilita instalação de pacotes a partir desta base de dados.

ALPM_DB_USAGE_UPGRADE
    Habilita atualização de sistema (sysupgrades).

ALPM_DB_USAGE_ALL
    Habilita todos os níveis de uso.

Documentação das funções

  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.

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)

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

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)

  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.

Parâmetros
    db ponteiro à base de dados para obter servidores

Retorna
    uma lista de char* de servidores

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

  alpm_list_t * alpm_db_get_groupcache (alpm_db_t * db)

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

  alpm_handle_t * alpm_db_get_handle (alpm_db_t * db)

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

  const char * alpm_db_get_name (const alpm_db_t * db)

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

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

  alpm_list_t * alpm_db_get_pkgcache (alpm_db_t * db)

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

  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.

Parâmetros
    db ponteiro à base de dados para obter servidores

Retorna
    uma lista de char* de servidores

  int alpm_db_get_siglevel (alpm_db_t * db)

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

  int alpm_db_get_usage (alpm_db_t * db, int * usage)

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

  int alpm_db_get_valid (alpm_db_t * db)

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)

  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.

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)

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

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)

  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.

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)

  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.

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.

  int alpm_db_set_servers (alpm_db_t * db, alpm_list_t * servers)

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.

  int alpm_db_set_usage (alpm_db_t * db, int usage)

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

  int alpm_db_unregister (alpm_db_t * db)

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)

  int alpm_db_update (alpm_handle_t * handle, alpm_list_t * dbs, int force)

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

  alpm_db_t * alpm_get_localdb (alpm_handle_t * handle)

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

  alpm_list_t * alpm_get_syncdbs (alpm_handle_t * handle)

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

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

  int alpm_unregister_all_syncdbs (alpm_handle_t * handle)

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)

Autor

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

TRADUÇÃO
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 (https://www.gnu.org/licenses/gpl-3.0.html) 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 (debian-l10n-portuguese@lists.debian.org).