libalpm_cb(3) Library Functions Manual libalpm_cb(3)

libalpm_cb - Retorno de chamadas


struct alpm_event_any_t
Um eventos que pode representar qualquer evento. struct alpm_event_package_operation_t
Ocorreu um evento de operação de pacote. struct alpm_event_optdep_removal_t
Uma dependência opcional foi removida. struct alpm_event_scriptlet_info_t
Um scriptlet foi executado. struct alpm_event_database_missing_t
Está faltando uma base de dados. struct alpm_event_pkgdownload_t
Um pacote foi baixado. struct alpm_event_pacnew_created_t
Um arquivo pacnew foi criado. struct alpm_event_pacsave_created_t
Um arquivo pacsave foi criado. struct alpm_event_hook_t
Hooks pré/pós-transação devem ser executados. struct alpm_event_hook_run_t
Um hook de transação pré/pós foi executado. struct alpm_event_pkg_retrieve_t
Download de pacotes prestes a começar. union alpm_event_t
Eventos. struct alpm_question_any_t
Uma pergunta que pode representar qualquer outra pergunta. struct alpm_question_install_ignorepkg_t
O alvo no ignorepkg deve ser instalado de qualquer maneira? struct alpm_question_replace_t
Um pacote deve ser substituído? struct alpm_question_conflict_t
Um pacote conflitante deve ser removido? struct alpm_question_corrupted_t
Um pacote corrompido deve ser excluído? struct alpm_question_remove_pkgs_t
Os alvos não resolvidos devem ser removidos da transação? struct alpm_question_select_provider_t
Seleção de provedor. struct alpm_question_import_key_t
Uma chave deve ser importada? union alpm_question_t
Perguntas. struct alpm_download_event_init_t
Estrutura de contexto para quando um download é iniciado. struct alpm_download_event_progress_t
Estrutura de contexto para quando um download progride. struct alpm_download_event_retry_t
Estrutura de contexto para quando um download é repetido. struct alpm_download_event_completed_t
Estrutura de contexto para quando um download for concluído.


typedef void(* alpm_cb_event) (void *ctx, alpm_event_t *event)
Retorno de chamada de evento. typedef void(* alpm_cb_question) (void *ctx, alpm_question_t *question)
Retorno de chamada de pergunta. typedef void(* alpm_cb_progress) (void *ctx, alpm_progress_t progress, const char *pkg, int percent, size_t howmany, size_t current)
Retorno de chamada de progresso. typedef void(* alpm_cb_download) (void *ctx, const char *filename, alpm_download_event_type_t event, void *data)
Tipo de retornos de chamada do progresso do download. typedef int(* alpm_cb_fetch) (void *ctx, const char *url, const char *localpath, int force)
Um retorno de chamada para download de arquivos.


enum alpm_event_type_t { ALPM_EVENT_CHECKDEPS_START = 1, ALPM_EVENT_CHECKDEPS_DONE, ALPM_EVENT_FILECONFLICTS_START, ALPM_EVENT_FILECONFLICTS_DONE, ALPM_EVENT_RESOLVEDEPS_START, ALPM_EVENT_RESOLVEDEPS_DONE, ALPM_EVENT_INTERCONFLICTS_START, ALPM_EVENT_INTERCONFLICTS_DONE, ALPM_EVENT_TRANSACTION_START, ALPM_EVENT_TRANSACTION_DONE, ALPM_EVENT_PACKAGE_OPERATION_START, ALPM_EVENT_PACKAGE_OPERATION_DONE, ALPM_EVENT_INTEGRITY_START, ALPM_EVENT_INTEGRITY_DONE, ALPM_EVENT_LOAD_START, ALPM_EVENT_LOAD_DONE, ALPM_EVENT_SCRIPTLET_INFO, ALPM_EVENT_DB_RETRIEVE_START, ALPM_EVENT_DB_RETRIEVE_DONE, ALPM_EVENT_DB_RETRIEVE_FAILED, ALPM_EVENT_PKG_RETRIEVE_START, ALPM_EVENT_PKG_RETRIEVE_DONE, ALPM_EVENT_PKG_RETRIEVE_FAILED, ALPM_EVENT_DISKSPACE_START, ALPM_EVENT_DISKSPACE_DONE, ALPM_EVENT_OPTDEP_REMOVAL, ALPM_EVENT_DATABASE_MISSING, ALPM_EVENT_KEYRING_START, ALPM_EVENT_KEYRING_DONE, ALPM_EVENT_KEY_DOWNLOAD_START, ALPM_EVENT_KEY_DOWNLOAD_DONE, ALPM_EVENT_PACNEW_CREATED, ALPM_EVENT_PACSAVE_CREATED, ALPM_EVENT_HOOK_START, ALPM_EVENT_HOOK_DONE, ALPM_EVENT_HOOK_RUN_START, ALPM_EVENT_HOOK_RUN_DONE }
Tipo de eventos. enum alpm_package_operation_t { ALPM_PACKAGE_INSTALL = 1, ALPM_PACKAGE_UPGRADE, ALPM_PACKAGE_REINSTALL, ALPM_PACKAGE_DOWNGRADE, ALPM_PACKAGE_REMOVE }
Uma enumeração sobre o tipo de operações do pacote. enum alpm_hook_when_t { ALPM_HOOK_PRE_TRANSACTION = 1, ALPM_HOOK_POST_TRANSACTION }
Tipo de hook. enum alpm_question_type_t { ALPM_QUESTION_INSTALL_IGNOREPKG = (1 << 0), ALPM_QUESTION_REPLACE_PKG = (1 << 1), ALPM_QUESTION_CONFLICT_PKG = (1 << 2), ALPM_QUESTION_CORRUPTED_PKG = (1 << 3), ALPM_QUESTION_REMOVE_PKGS = (1 << 4), ALPM_QUESTION_SELECT_PROVIDER = (1 << 5), ALPM_QUESTION_IMPORT_KEY = (1 << 6) }
Tipo de pergunta. enum alpm_progress_t { ALPM_PROGRESS_ADD_START, ALPM_PROGRESS_UPGRADE_START, ALPM_PROGRESS_DOWNGRADE_START, ALPM_PROGRESS_REINSTALL_START, ALPM_PROGRESS_REMOVE_START, ALPM_PROGRESS_CONFLICTS_START, ALPM_PROGRESS_DISKSPACE_START, ALPM_PROGRESS_INTEGRITY_START, ALPM_PROGRESS_LOAD_START, ALPM_PROGRESS_KEYRING_START }
Uma enumeração sobre diferentes tipos de alertas de progresso. enum alpm_download_event_type_t { ALPM_DOWNLOAD_INIT, ALPM_DOWNLOAD_PROGRESS, ALPM_DOWNLOAD_RETRY, ALPM_DOWNLOAD_COMPLETED }
Eventos de download de arquivo.

Funções e estruturas para retornos de chamada do libalpm

Documentação da estrutura de dados

Um eventos que pode representar qualquer evento.

Campos de dados:

alpm_event_type_t type Tipo de evento.

Ocorreu um evento de operação de pacote.

Campos de dados:

alpm_pkg_t * newpkg Novo pacote.

alpm_pkg_t * oldpkg Pacote antigo.

alpm_package_operation_t operation Tipo de operação.

alpm_event_type_t type Tipo de evento.

Uma dependência opcional foi removida.

Campos de dados:

alpm_depend_t * optdep Dependência opcional sendo removida.

alpm_pkg_t * pkg Pacote com a dependência opcional.

alpm_event_type_t type Tipo de evento.

Um scriptlet foi executado.

Campos de dados:

const char * line Linha do scriptlet emitida.

alpm_event_type_t type Tipo de evento.

Está faltando uma base de dados.

A base de dados está registrada, mas não foi baixada

Campos de dados:

const char * dbname Nome da base de dados.

alpm_event_type_t type Tipo de evento.

Um pacote foi baixado.

Campos de dados:

const char * file Nome do arquivo.

alpm_event_type_t type Tipo de evento.

Um arquivo pacnew foi criado.

Campos de dados:

const char * file Nome do arquivo sem o sufixo .pacnew.

int from_noupgrade Se a criação foi resultado de um NoUpgrade ou não.

alpm_pkg_t * newpkg Novo pacote.

alpm_pkg_t * oldpkg Pacote antigo.

alpm_event_type_t type Tipo de evento.

Um arquivo pacsave foi criado.

Campos de dados:

const char * file Nome o arquivo sem o sufixo .pacsave.

alpm_pkg_t * oldpkg Pacote antigo.

alpm_event_type_t type Tipo de evento.

Hooks pré/pós-transação devem ser executados.

Campos de dados:

alpm_event_type_t type Tipo de evento.

alpm_hook_when_t when Tipo do hook.

Um hook de transação pré/pós foi executado.

Campos de dados:

const char * desc Descrição do hook a ser emitido.

const char * name Nome do hook.

size_t position Posição do hook a ser executado

size_t total Total de hooks sendo executados

alpm_event_type_t type Tipo de evento.

Download de pacotes prestes a começar.

Campos de dados:

size_t num Número de pacotes para download.

off_t total_size Tamanho total dos pacotes para download.

alpm_event_type_t type Tipo de evento.

Eventos.

Esta é uma união passada para o retorno de chamada que permite ao frontend saber qual tipo de evento foi acionado (via tipo). É então possível tipificar o ponteiro para a estrutura correta, ou usar o campo de união, para acessar dados específicos do evento.

Campos de dados:

alpm_event_any_t any O tipo de evento any.
É sempre seguro acessar isso.

alpm_event_database_missing_t database_missing Uma base de dados está faltando.

alpm_event_hook_t hook Hooks de pré/pós-transação estão sendo executados.

alpm_event_hook_run_t hook_run Um hook foi executado.

alpm_event_optdep_removal_t optdep_removal Uma dependência opcional foi removida.

alpm_event_package_operation_t package_operation Operação de pacote.

alpm_event_pacnew_created_t pacnew_created Um arquivo pacnew foi criado.

alpm_event_pacsave_created_t pacsave_created Um arquivo pacsave foi criado.

alpm_event_pkg_retrieve_t pkg_retrieve Baixa pacotes.

alpm_event_pkgdownload_t pkgdownload Um pacote foi baixado.

alpm_event_scriptlet_info_t scriptlet_info Um scriptlet foi executado.

alpm_event_type_t type Tipo de evento, é sempre seguro acessar este.

Uma pergunta que pode representar qualquer outra pergunta.

Campos de dados:

int answer Resposta.

alpm_question_type_t type Tipo de pergunta.

O alvo no ignorepkg deve ser instalado de qualquer maneira?

Campos de dados:

int install Resposta: se deve ou não instalar o pacote de qualquer maneira.

alpm_pkg_t * pkg O pacote ignorado que estamos decidindo instalar.

alpm_question_type_t type Tipo de pergunta.

Um pacote deve ser substituído?

Campos de dados:

alpm_db_t * newdb BD do newpkg.

alpm_pkg_t * newpkg Pacote que vai substituir.

alpm_pkg_t * oldpkg Pacote a ser substituído.

int replace Resposta: se deve ou não substituir oldpkg por newpkg.

alpm_question_type_t type Tipo de pergunta.

Um pacote conflitante deve ser removido?

Campos de dados:

alpm_conflict_t * conflict Informações de conflito.

int remove Resposta: se deve ou não remover o conflito com o pacote2.

alpm_question_type_t type Tipo de pergunta.

Um pacote corrompido deve ser excluído?

Campos de dados:

const char * filepath Arquivo para remover.

alpm_errno_t reason Código de erro indicando o motivo para invalidade do pacote.

int remove Resposta: se deve ou não remover o caminho do arquivo.

alpm_question_type_t type Tipo de pergunta.

Os alvos não resolvidos devem ser removidos da transação?

Campos de dados:

alpm_list_t * packages Lista de alpm_pkg_t* com dependências não resolvidas.

int skip Resposta: se deve ou não pular pacotes.

alpm_question_type_t type Tipo de pergunta.

Seleção de provedor.

Campos de dados:

alpm_depend_t * depend O que os provedores fornecem para.

alpm_list_t * providers Lista de alpm_pkg_t* como possíveis provedores.

alpm_question_type_t type Tipo de pergunta.

int use_index Resposta: qual provedor usar (índice de provedores)

Uma chave deve ser importada?

Campos de dados:

const char * fingerprint Impressão digital, a chave para importar.

int import Resposta: se importa ou não a chave.

alpm_question_type_t type Tipo de pergunta.

const char * uid UID da chave para importar.

Perguntas.

Esta é uma união passada para o retorno de chamada que permite ao frontend saber qual tipo de pergunta foi acionada (via tipo). É então possível tipificar o ponteiro para a estrutura correta, ou usar o campo de união, para acessar dados específicos da questão.

Campos de dados:

alpm_question_any_t any Uma pergunta que pode representar qualquer pergunta.
É sempre seguro acessar isso.

alpm_question_conflict_t conflict Um pacote conflitante deve ser removido?

alpm_question_corrupted_t corrupted Um pacote corrompido deve ser excluído?

alpm_question_import_key_t import_key Uma chave deve ser importada?

alpm_question_install_ignorepkg_t install_ignorepkg O alvo no ignorepkg deve ser instalado de qualquer maneira?

alpm_question_remove_pkgs_t remove_pkgs Os alvos não resolvidos devem ser removidos da transação?

alpm_question_replace_t replace Um pacote deve ser substituído?

alpm_question_select_provider_t select_provider Seleção de provedor.

alpm_question_type_t type O tipo da pergunta.
É sempre seguro acessar isso.

Estrutura de contexto para quando um download é iniciado.

Campos de dados:

int optional se este arquivo é opcional e, portanto, os erros podem ser ignorados

Estrutura de contexto para quando um download progride.

Campos de dados:

off_t downloaded Quantidade de dados baixados.

off_t total O valor total precisa ser baixado.

Estrutura de contexto para quando um download é repetido.

Campos de dados:

int resume Se o download será retomado ou recomeçado.

Estrutura de contexto para quando um download for concluído.

Campos de dados:

int result código de resultado do download: 0 - download concluído com sucesso 1 - o arquivo está atualizado -1 - erro

off_t total Total de bytes no arquivo.

Documentação das definições de tipo

Tipo de retornos de chamada do progresso do download.

Parâmetros

ctx contexto fornecido pelo usuário
filename o nome do arquivo que está sendo baixado
event o tipo do evento
data os dados do evento de tipo alpm_download_event_*_t

Retorno de chamada do evento. Chamado quando ocorre um evento

Parâmetros

ctx contexto fornecido pelo usuário
event o evento que ocorreu

Um retorno de chamada para download de arquivos.

Parâmetros

ctx contexto fornecido pelo usuário
url a URL do arquivo a ser baixado
localpath o diretório para o qual o arquivo deve ser baixado
force se deve forçar uma atualização, mesmo que o arquivo seja o mesmo

Retorna

0 em caso de sucesso, 1 se o arquivo existir e for idêntico, -1 em caso de erro.

Retorno de chamada de progresso. Alerta o frontend sobre o andamento de determinados eventos. Permite a implementação de barras de carregamento para eventos que demoram um pouco para serem concluídos.

Parâmetros

ctx contexto fornecido pelo usuário
progress o tipo de evento que está progredindo
pkg para operações de pacote, o nome do pacote que está sendo operado
percent a porcentagem de conclusão da ação
howmany a quantidade total de itens na ação
current a quantidade atual de itens concluídos Retorno de chamada de progresso

Retorno de chamada de pergunta. Este retorno de chamada permite que o usuário dê entrada e decida o que fazer durante determinados eventos

Parâmetros

ctx contexto fornecido pelo usuário
question a pergunta sendo feita.

Documentação dos tipos de enumeração

Eventos de download de arquivo. Esses eventos são relatados pelo ALPM por meio de retorno de chamada de download.

Enumerador

Um download foi iniciado.
Um download progrediu.
O download será repetido.
Um download foi concluído.

Tipo de eventos.

Enumerador

As dependências serão computadas para um pacote.
As dependências foram computadas para um pacote.
Os conflitos de arquivo serão computados para um pacote.
Os conflitos de arquivo foram computados para um pacote.
As dependências serão resolvidas para o pacote de destino.
As dependências foram resolvidas para o pacote de destino.
Interconflitos serão verificados para o pacote de destino.
Interconflitos foram verificados para o pacote de destino.
O processamento da transação do pacote está começando.
O processamento da transação do pacote foi finalizado.
O pacote será instalado/atualizado/feito downgrade/reinstalado/removido; Consulte alpm_event_package_operation_t para argumentos.
O pacote foi instalado/atualizado/feito downgrade/reinstalado/removido; Consulte alpm_event_package_operation_t para argumentos.
A integridade do pacote de destino será verificada.
A integridade do pacote de destino foi verificada.
O pacote de destino será carregado.
O pacote de destino finalizou o carregamento.
Scriptlet emitiu informações; Veja alpm_event_scriptlet_info_t para argumentos.
Os arquivos de base de dados serão baixados de um repositório.
Os arquivos de base de dados foram baixados de um repositório.
Nem todos os arquivos de base de dados foram baixados com sucesso de um repositório.
Os arquivos de pacote serão baixados de um repositório.
Os arquivos de pacote foram baixados de um repositório.
Nem todos os arquivos de pacote foram baixados com sucesso de um repositório.
O uso do espaço em disco será calculado para um pacote.
O uso do espaço em disco foi calculado para um pacote.
Uma dependência opcional para outro pacote está sendo removido; Consulte alpm_event_optdep_removal_t para argumentos.
Uma base de dados de repositório configurada está ausente; Consulte alpm_event_database_missing_t para argumentos.
As chaves de verificação usadas para criar assinaturas estão no chaveiro.
A verificação do chaveiro foi concluída.
Baixando chaves ausentes no chaveiro.
O download da chave foi concluído.
Um arquivo .pacnew foi criado; Veja alpm_event_pacnew_created_t para argumentos.
Um arquivo .pacsave foi criado; Veja alpm_event_pacsave_created_t para argumentos.
Os hooks de processamento serão iniciados.
O processamento de hooks foi concluído.
Um hook está iniciando.
Um hook finalizou a execução.

Tipo de hook.

Uma enumeração sobre o tipo de operações do pacote.

Enumerador

Pacote (a ser) instalado. (Sem oldpkg)
Pacote (a ser) atualizado.
Pacote (a ser) reinstalado.
Pacote que teve downgrade feito (ou a ser feito).
Pacote (a ser) removido (Sem newpkg)

Uma enumeração sobre diferentes tipos de alertas de progresso.

Enumerador

Instalação de pacote.
Atualização de pacote.
Downgrade de pacote.
Reinstalação de pacote.
Remoção de pacote.
Verificação de conflitos.
Verificação do espaço em disco.
Verificação da integridade do pacote.
Carregando pacotes do disco.
Verificando assinaturas de pacotes.

Tipo de pergunta. Ao contrário dos eventos ou enumerações de progresso, esta enumeração tem valores de máscara de bits para que um frontend possa usar um mapa de máscara de bits para fornecer respostas pré-selecionadas para os diferentes tipos de perguntas.

Enumerador

O alvo no ignorepkg deve ser instalado de qualquer maneira?
Um pacote deve ser substituído?
Um pacote conflitante deve ser removido?
Um pacote corrompido deve ser excluído?
Os alvos não resolvidos devem ser removidos da transação?
Seleção de provedor.
Uma chave deve ser importada?

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