libalpm_databases(3) Library Functions Manual libalpm_databases(3) NOME libalpm_databases - Database - Functions to query and manipulate the database of libalpm. SINOPSE Definicoes de tipos typedef struct _alpm_db_t alpm_db_t Uma base de dados. Enumeracoes 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 nivel de uso de uma base de dados. Funcoes alpm_db_t * alpm_get_localdb (alpm_handle_t *handle) Obtem a base de dados de pacotes instalados localmente. alpm_list_t * alpm_get_syncdbs (alpm_handle_t *handle) Obtem a lista de base de dados de sincronizacao. alpm_db_t * alpm_register_syncdb (alpm_handle_t *handle, const char *treename, int level) Registra uma base de dados de sincronizacao 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) Obtem o identificador de uma base de dados de pacotes. const char * alpm_db_get_name (const alpm_db_t *db) Obtem o nome de uma base de dados de pacotes. int alpm_db_get_siglevel (alpm_db_t *db) Obtem o nivel de verificacao 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) Obtem uma entrada de pacote de uma base de dados de pacotes. alpm_list_t * alpm_db_get_pkgcache (alpm_db_t *db) Obtem 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) Obtem uma entrada de grupo de uma base de dados de pacotes. alpm_list_t * alpm_db_get_groupcache (alpm_db_t *db) Obtem 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 expressoes regulares. Metodos para servidores alpm_list_t * alpm_db_get_servers (const alpm_db_t *db) Obtem a lista de servidores atribuidos 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) Obtem a lista de servidores de cache atribuidos 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. Metodos 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) Obtem o uso de uma base de dados. Descricao detalhada Funcoes para consultar e manipular a base de dados do libalpm. Documentacao das definicoes de tipo typedef struct _alpm_db_t alpm_db_t Uma base de dados. Uma base de dados e um conteiner 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 ja estiver presente no dbpath, ela ficara usavel. Do contrario, 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. Apos isso, a base de dados podera ser usada para consultar pacotes e grupos. Quaisquer pacotes ou grupos da base de dados continuarao sendo de propriedade da base de dados e nao precisarao ser liberados pelo usuario. Eles serao liberados quando a base de dados for desregistrada. Bases de dados sao desregistradas automaticamente quando alpm_handle_t e liberada. Documentacao de tipos enumeracao enum alpm_db_usage_t O nivel de uso de uma base de dados. Enumerador ALPM_DB_USAGE_SYNC Habilita atualizacoes para esta base de dados. ALPM_DB_USAGE_SEARCH Habilita pesquisa para esta base de dados. ALPM_DB_USAGE_INSTALL HAbilita instalacao de pacotes a partir desta base de dados. ALPM_DB_USAGE_UPGRADE Habilita atualizacao de sistema (sysupgrades). ALPM_DB_USAGE_ALL Habilita todos os niveis de uso. Documentacao das funcoes 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. Parametros db ponteiro de base de dados url url do servidor Retorna 0 em caso de sucsso, -1 em caso de erro (pm_errno e 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. Parametros db ponteiro de base de dados url url do servidor Retorna 0 em caso de sucsso, -1 em caso de erro (pm_errno e definido de acordo) alpm_list_t * alpm_db_get_cache_servers (const alpm_db_t * db) Obtem a lista de servidores de cache atribuidos a esta base de dados. Parametros db ponteiro a 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) Obtem uma entrada de grupo de uma base de dados de pacotes. A busca por um grupo e O(1) e sera significativamente mais rapida do que iterar sobre o groupcahe. Parametros 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) Obtem o cache de grupo de uma base de dados de pacotes. Parametros 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) Obtem o identificador de uma base de dados de pacotes. Parametros db ponteiro da base de dados de pacotes Retorna o identificador do alpm a qual a base de dados de pacotes pertence const char * alpm_db_get_name (const alpm_db_t * db) Obtem o nome de uma base de dados de pacotes. Parametros 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) Obtem uma entrada de pacote de uma base de dados de pacotes. A busca por um pacote e O(1) e sera significativamente mais rapida do que iterar sobre o pkgcahe. Parametros db ponteiro para a base de dados da qual obtem 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) Obtem o cache de pacotes de uma base de dados do pacote. Isso e uma lista de todos os pacotes que a base de dados contem. Parametros db ponteiro para a base de dados da qual obtem 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) Obtem a lista de servidores atribuidos a esta base de dados. Parametros db ponteiro a base de dados para obter servidores Retorna uma lista de char* de servidores int alpm_db_get_siglevel (alpm_db_t * db) Obtem o nivel de verificacao de assinatura para uma base de dados. Retornara o nivel de verificacao padrao se esta base de dados estiver configurado com ALPM_SIG_USE_DEFAULT. Parametros db ponteiro da base de dados de pacotes Retorna o nivel de verificacao de assinatura int alpm_db_get_usage (alpm_db_t * db, int * usage) Obtem o uso de uma base de dados. Parametros 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 e muito util para sincronizar bases de dados e verificar o status da assinatura. Se invalido, o codigo de erro do manipulador sera definido de acordo. Parametros db ponteiro da base de dados de pacotes Retorna 0 se valida, -1 se invalida (pm_errno e 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. Parametros db ponteiro de base de dados url url do servidor Retorna 0 em caso de sucesso, 1 em caso do servidor nao estar presente, -1 em caso de erro (pm_errno e 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. Parametros db ponteiro de base de dados url url do servidor Retorna 0 em caso de sucesso, 1 em caso do servidor nao estar presente, -1 em caso de erro (pm_errno e 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 expressoes regulares. Parametros db ponteiro para a base de dados de pacotes para pesquisar needles uma lista de expressoes regulares para pesquisar ret ponteiro para uma lista que armazena pacotes correspondentes a todas as expressoes regulares - deve apontar para uma lista alpm_list_t * vazia (NULA). Retorna 0 em caso de sucsso, -1 em caso de erro (pm_errno e 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. Parametros db a base de dados para define os servidores. A lista sera duplicada e a original ainda precisara 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. Parametros db a base de dados para define os servidores. A lista sera duplicada e a original ainda precisara 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. Parametros db ponteiro para a base de dados de pacotes para definir o status usage uma mascara 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 nao podem ser desregistradas quando ha uma transacao ativa. Parametros db ponteiro para a base de dados de pacotes para desregistrar Retorna 0 em caso de sucsso, -1 em caso de erro (pm_errno e definido de acordo) int alpm_db_update (alpm_handle_t * handle, alpm_list_t * dbs, int force) Atualiza bases de dados de pacotes. Uma atualizacao das bases de dados de pacotes na lista dbs sera tentada. A menos que force seja verdadeiro, a atualizacao so sera realizada se as bases de dados remotos tiverem sido modificados desde a ultima atualizacao. Esta operacao requer um trava de base de dados e retornara um erro aplicavel caso a trava nao 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 Apos uma atualizacao bem sucedida, o cache de pacotes sera invalidado Parametros handle o manipulador do contexto dbs lista das base de dados de pacotes para atualizar force se verdadeiro, forca a atualizar; do contrario, atualiza apenas em caso das bases de dados nao estarem desatualizadas Retorna 0 em caso de sucesso, -1 em caso de erro (pm_errno esta definido de acordo), 1 se todas base de dados estiverem atualizadas alpm_db_t * alpm_get_localdb (alpm_handle_t * handle) Obtem a base de dados de pacotes instalados localmente. O ponteiro retornado aponta para uma estrutura interna da libalpm que so deve ser manipulada por meio de funcoes da libalpm Retorna uma referencia a base de dados local alpm_list_t * alpm_get_syncdbs (alpm_handle_t * handle) Obtem a lista de bases de dados de sincronizacao. Retorna uma lista de estruturas alpm_db_t, uma para cada base de dados de sincronizacao registrada. Parametros handle o manipulador do contexto Retorna uma referencia 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 sincronizacao de pacotes. Bases de dados nao podem ser registradas quando ha uma transacao ativa. Parametros handle o manipulador do contexto treename o nome do repositorio de sincronizacao level qual o nivel de verificacao de assinatura para realizar a base de dados; note que isso deve ser uma verificacao 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 nao podem ser desregistradas enquanto ha uma transacao ativa. Parametros handle o manipulador do contexto Retorna 0 em caso de sucsso, -1 em caso de erro (pm_errno e definido de acordo) Autor Gerado automaticamente por Doxygen para libalpm a partir do codigo-fonte. TRADUCAO A traducao para portugues brasileiro desta pagina man foi criada por Rafael Fontenelle Esta traducao e uma documentacao livre; leia a Licenca Publica Geral GNU Versao 3 ou posterior para as condicoes de direitos autorais. Nenhuma responsabilidade e aceita. Se voce encontrar algum erro na traducao desta pagina de manual, envie um e-mail para a lista de discussao de tradutores . libalpm libalpm_databases(3)