libalpm_cb(3) Library Functions Manual libalpm_cb(3)

libalpm_cb - reapelări


- Funcții și structuri pentru reapelările din „libalpm”


struct alpm_event_any_t
Un eveniment care poate reprezenta orice eveniment. struct alpm_event_package_operation_t
A avut loc un eveniment de operare a pachetului. struct alpm_event_optdep_removal_t
O dependență opțională a fost eliminată. struct alpm_event_scriptlet_info_t
Un script a fost rulat. struct alpm_event_database_missing_t
Lipsește o bază de date.O bază de date lipsește struct alpm_event_pkgdownload_t
A fost descărcat un pachet. struct alpm_event_pacnew_created_t
Un fișier pacnew a fost creat. struct alpm_event_pacsave_created_t
Un fișier pacsave a fost creat. struct alpm_event_hook_t
Cârligele pre/post tranzacție trebuie să fie rulate. struct alpm_event_hook_run_t
Un cârlig pre/post tranzacție a fost rulat. struct alpm_event_pkg_retrieve_t
Descărcarea pachetelor urmează să înceapă. union alpm_event_t
Evenimente. struct alpm_question_any_t
O întrebare care poate reprezenta orice altă întrebare. struct alpm_question_install_ignorepkg_t
Ar trebui ca ținta din ignorepkg să fie instalată oricum? struct alpm_question_replace_t
Trebuie înlocuit un pachet? struct alpm_question_conflict_t
Trebuie eliminat un pachet conflictual? struct alpm_question_corrupted_t
Trebuie șters un pachet corupt? struct alpm_question_remove_pkgs_t
Trebuie ca țintele nerezolvabile să fie eliminate din tranzacție? struct alpm_question_select_provider_t
Selectarea furnizorului. struct alpm_question_import_key_t
Trebuie importată o cheie? union alpm_question_t
Întrebări. struct alpm_download_event_init_t
Structura contextuală pentru momentul în care începe o descărcare struct alpm_download_event_progress_t
Structura contextuală pentru evoluția descărcării. struct alpm_download_event_retry_t
Structura contextuală pentru momentul în care o descărcare este reluată. struct alpm_download_event_completed_t
Struct contextuală pentru momentul finalizării unei descărcări.


typedef void(* alpm_cb_event) (void *ctx, alpm_event_t *event)
Apel de răspuns la eveniment. typedef void(* alpm_cb_question) (void *ctx, alpm_question_t *question)
Apel de răspuns la întrebare. typedef void(* alpm_cb_progress) (void *ctx, alpm_progress_t progress, const char *pkg, int percent, size_t howmany, size_t current)
Apel de răspuns la progres (evoluția operației). typedef void(* alpm_cb_download) (void *ctx, const char *filename, alpm_download_event_type_t event, void *data)
Tipul de reapelări privind progresul descărcării. typedef int(* alpm_cb_fetch) (void *ctx, const char *url, const char *localpath, int force)
O reapelare pentru descărcarea fișierelor.


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 }
Tipuri de evenimente. enum alpm_package_operation_t { ALPM_PACKAGE_INSTALL = 1, ALPM_PACKAGE_UPGRADE, ALPM_PACKAGE_REINSTALL, ALPM_PACKAGE_DOWNGRADE, ALPM_PACKAGE_REMOVE }
O enumerare a tipurilor de operații ale pachetului enum alpm_hook_when_t { ALPM_HOOK_PRE_TRANSACTION = 1, ALPM_HOOK_POST_TRANSACTION }
Tipul de cârlig. 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) }
Tipul de întrebare. 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 }
O enumerare a diferitelor tipuri de alerte de progres. enum alpm_download_event_type_t { ALPM_DOWNLOAD_INIT, ALPM_DOWNLOAD_PROGRESS, ALPM_DOWNLOAD_RETRY, ALPM_DOWNLOAD_COMPLETED }
Eveniment de descărcare a fișierului.

Funcții și structuri pentru reapelările din „libalpm”.

Documentația structurii de date

Un eveniment care poate reprezenta orice eveniment.

Câmpuri de date :

alpm_event_type_t type Tip de eveniment.

A avut loc un eveniment de operare a pachetului.

Câmpuri de date :

alpm_pkg_t * newpkg Pachet nou.

alpm_pkg_t * oldpkg Pachet vechi.

alpm_package_operation_t operation Tip de operație.

alpm_event_type_t type Tip de eveniment.

O dependență opțională a fost eliminată.

Câmpuri de date :

alpm_depend_t * optdep Dependența opțională în curs de eliminare.

alpm_pkg_t * pkg Pachetul cu dependența opțională.

alpm_event_type_t type Tip de eveniment.

Un script a fost rulat.

Câmpuri de date :

const char * line Linia de ieșire a scriptului.

alpm_event_type_t type Tip de eveniment.

Lipsește o bază de date.O bază de date lipsește

Baza de date este înregistrată, dar nu a fost descărcată

Câmpuri de date :

const char * dbname Numele bazei de date.

alpm_event_type_t type Tip de eveniment.

A fost descărcat un pachet.

Câmpuri de date :

const char * file Numele fișierului.

alpm_event_type_t type Tip de eveniment.

Un fișier pacnew a fost creat.

Câmpuri de date :

const char * file Numele fișierului fără sufixul .pacnew.

int from_noupgrade Dacă crearea a fost rezultatul unei opțiuni NoUpgrade sau nu.

alpm_pkg_t * newpkg Pachet nou.

alpm_pkg_t * oldpkg Pachet vechi.

alpm_event_type_t type Tip de eveniment.

Un fișier pacsave a fost creat.

Câmpuri de date :

const char * file Numele fișierului fără sufixul .pacsave.

alpm_pkg_t * oldpkg Pachet vechi.

alpm_event_type_t type Tip de eveniment.

Cârligele pre/post tranzacție trebuie să fie rulate.

Câmpuri de date :

alpm_event_type_t type Tip de eveniment.

alpm_hook_when_t when Tip de cârlig.

Un cârlig pre/post tranzacție a fost rulat.

Câmpuri de date :

const char * desc Descrierea cârligului care urmează să fie afișată.

const char * name Numele cârligului.

size_t position poziția cârligului în curs de execuție

numărul total de cârlige în curs de execuție

alpm_event_type_t type Tip de eveniment.

Descărcarea pachetelor urmează să înceapă.

Câmpuri de date :

size_t num Numărul de pachete de descărcat.

off_t total_size Dimensiunea totală a pachetelor de descărcat.

alpm_event_type_t type Tip de eveniment.

Evenimente.

Aceasta este o uniune transmisă către reapelare care permite interfeței să știe ce tip de eveniment a fost declanșat (prin tip). Este apoi posibil să se trimită indicatorul la structura corectă sau să se utilizeze câmpul de uniune, pentru a accesa datele specifice evenimentului.

Câmpuri de date :

alpm_event_any_t any Tipul oricărui eveniment.
Accesarea acestuia este întotdeauna sigură.

alpm_event_database_missing_t database_missing Lipsește o bază de date&.

alpm_event_hook_t hook Cârligele de pre/post tranzacție sunt rulate.

alpm_event_hook_run_t hook_run Un cârlig a fost executat.

alpm_event_optdep_removal_t optdep_removal O dependență opțională a fost eliminată.

alpm_event_package_operation_t package_operation Operația pachetului.

alpm_event_pacnew_created_t pacnew_created Un fișier pacnew a fost creat.

alpm_event_pacsave_created_t pacsave_created Un fișier pacsave a fost creat.

alpm_event_pkg_retrieve_t pkg_retrieve Descarcă pachete.

alpm_event_pkgdownload_t pkgdownload Un pachet a fost descărcat.

alpm_event_scriptlet_info_t scriptlet_info Un script a fost rulat.

alpm_event_type_t type Tip de eveniment pe care este întotdeauna sigur să îl accesați.

O întrebare care poate reprezenta orice altă întrebare.

Câmpuri de date :

int answer Răspuns.

alpm_question_type_t type Tip de întrebare.

Ar trebui ca ținta din ignorepkg să fie instalată oricum?

Câmpuri de date :

int install Răspuns: dacă instalați sau nu pachetul oricum.

alpm_pkg_t * pkg Pachetul ignorat pe care decidem dacă să îl instalăm.

alpm_question_type_t type Tip de întrebare.

Trebuie înlocuit un pachet?

Câmpuri de date :

alpm_db_t * newdb BD a newpkg.

alpm_pkg_t * newpkg Pachet de înlocuit cu.

alpm_pkg_t * oldpkg Pachet care urmează să fie înlocuit.

int replace Răspuns: dacă se înlocuiește sau nu oldpkg cu newpkg.

alpm_question_type_t type Tip de întrebare.

Trebuie eliminat un pachet conflictual?

Câmpuri de date :

alpm_conflict_t * conflict Informații privind conflictele.

int remove Răspuns: dacă se elimină sau nu conflictul >package2.

alpm_question_type_t type Tip de întrebare.

Trebuie șters un pachet corupt?

Câmpuri de date :

const char * filepath Fișier de eliminat.

alpm_errno_t reason Cod de eroare care indică motivul invalidării pachetului.

int remove Răspuns: dacă se elimină sau nu ruta fișierului.

alpm_question_type_t type Tip de întrebare.

Trebuie ca țintele nerezolvabile să fie eliminate din tranzacție?

Câmpuri de date :

alpm_list_t * packages Lista de alpm_pkg_t* cu dependențe nerezolvate.

int skip Răspuns: dacă se omit sau nu pachetele.

alpm_question_type_t type Tip de întrebare.

Selectarea furnizorului.

Câmpuri de date :

alpm_depend_t * depend Ce furnizează furnizorii pentru.

alpm_list_t * providers Lista de alpm_pkg_t* ca posibili furnizori.

alpm_question_type_t type Tip de întrebare.

int use_index Răspuns: ce furnizor să se utilizeze (index de la furnizori)

Trebuie importată o cheie?

Câmpuri de date :

const char * fingerprint Amprenta digitală a cheii pentru import.

int import Răspuns: dacă se importă sau nu cheia.

alpm_question_type_t type Tip de întrebare.

const char * uid UID-ul cheii de importat.

Întrebări.

Aceasta este o uniune transmisă către reapelare care permite interfeței să știe ce tip de întrebare a fost declanșată (prin tip). Este apoi posibil să se atribuie indicatorul la structura corectă sau să se utilizeze câmpul de uniune pentru a accesa datele specifice întrebării.

Câmpuri de date :

alpm_question_any_t any O întrebare care poate reprezenta orice întrebare.
Accesarea acestuia este întotdeauna sigură.

alpm_question_conflict_t conflict Ar trebui eliminat un pachet conflictual?

alpm_question_corrupted_t corrupted Ar trebui să fie șters un pachet corupt?

alpm_question_import_key_t import_key Trebuie să fie importată o cheie?

alpm_question_install_ignorepkg_t install_ignorepkg Trebuie ca ținta din ignorepkg să fie instalată oricum?

alpm_question_remove_pkgs_t remove_pkgs Trebuie ca obiectivele nerezolvabile să fie eliminate din tranzacție?

alpm_question_replace_t replace Trebuie un pachet să fie înlocuit?

alpm_question_select_provider_t select_provider Selectarea furnizorului.

alpm_question_type_t type Tipul de întrebare.
Accesarea acestuia este întotdeauna sigură.

Structura contextuală pentru momentul în care începe o descărcare

Câmpuri de date :

int optional dacă acest fișier este opțional și astfel erorile ar putea fi ignorate

Structura contextuală pentru evoluția descărcării.

Câmpuri de date :

off_t downloaded Cantitatea de date descărcate.

off_t total Cantitatea totală ce trebuie să fie descărcată.

Structura contextuală pentru momentul în care o descărcare este reluată.

Câmpuri de date :

int resume Dacă descărcarea va fi reluată sau va porni de la început.

Struct contextuală pentru momentul finalizării unei descărcări.

Câmpuri de date :

int result codul rezultatului descărcării: 0 - descărcare finalizată cu succes; 1 - fișierul este actualizat și -1 - eroare

off_t total Numărul total de octeți din fișier.

Documentația privind definițiile tipurilor (typedef)

Tipul de reapelări privind progresul descărcării.

Parametri

ctx context furnizat de utilizator
filename numele fișierului care este descărcat
event tipul de eveniment
data datele evenimentului de tip alpm_download_event_*_t

Apel de răspuns la eveniment. Apelat atunci când are loc un eveniment

Parametri

ctx context furnizat de utilizator
event evenimentul care a avut loc

O reapelare pentru descărcarea fișierelor.

Parametri

ctx context furnizat de utilizator
url adresa URL a fișierului care urmează să fie descărcat
localpath directorul în care trebuie descărcat fișierul
force dacă să se forțeze o actualizare, chiar dacă fișierul este același

Returnează

0 la succes, 1 dacă fișierul există și este identic, -1 la eroare..

Răspunsul la apelul de progres. Avertizează interfața cu privire la progresul anumitor evenimente. Permite implementarea de bare de încărcare pentru evenimentele a căror finalizare durează ceva timp.

Parametri

ctx context furnizat de utilizator
progress tipul de eveniment care progresează
pkg pentru operațiile cu pachete, numele pachetului asupra căruia se efectuează operația
percent procentul de finalizare a acțiunii
howmany numărul total de elemente din acțiune
current numărul curent de elemente finalizate în răspunsul apelului de progres

Răspunsul apelului de întrebare. Acest răspuns de apel permite utilizatorului să ofere informații și să decidă ce să facă în timpul anumitor evenimente.

Parametri

ctx context furnizat de utilizator
question întrebarea care se pune.

Documentația tipurilor de enumerare

Evenimente de descărcare a fișierelor. Aceste evenimente sunt raportate de ALPM prin intermediul răspunsului la apelul de descărcare.

Enumerator

A fost inițiată o descărcare.
O descărcare a progresat.
Descărcarea va fi reîncercată.
O descărcare a fost finalizată.

Tipuri de evenimente.

Enumerator

Vor fi calculate dependențele pentru un pachet.
S-au calculat dependențele pentru un pachet.
Vor fi calculate conflictele de fișiere pentru un pachet.
S-au calculat conflictele de fișiere pentru un pachet.
Vor fi rezolvate dependențele pentru pachetul țintă.
S-au rezolvat dependențele pentru pachetul țintă.
Vor fi verificate inter-conflictele pentru pachetul țintă.
S-au verificat inter-conflictele pentru pachetul țintă.
Începe procesarea tranzacției pachetului.
Procesarea tranzacției pachetului s-a încheiat.
Pachetul va fi instalat/actualizat/retrogradat/reinstalat/eliminat; consultați alpm_event_package_operation_t pentru argumente.
Pachetul a fost instalat/actualizat/retrogradat/reinstalat/eliminat; consultați alpm_event_package_operation_t pentru argumente.
Integritatea pachetului țintă va fi verificată.
Integritatea pachetului țintă a fost verificată.
Pachetul țintă va fi încărcat.
Pachetul țintă a fost încărcat.
Scriptul a imprimat informații; consultați alpm_event_scriptlet_info_t pentru argumente.
Fișierele bazei de date vor fi descărcate dintr-un depozit.
Fișierele bazei de date au fost descărcate dintr-un depozit.
Nu toate fișierele bazei de date au fost descărcate cu succes dintr-un depozit.
Fișierele pachetului vor fi descărcate dintr-un depozit.
Fișierele pachetelor au fost descărcate dintr-un depozit.
Nu toate fișierele pachetului au fost descărcate cu succes dintr-un depozit.
Va fi calculată utilizarea spațiului pe disc pentru un pachet.
S-a calculat utilizarea spațiului pe disc pentru un pachet.
O dependență opțională „optdepend” pentru un alt pachet este eliminată; consultați alpm_event_optdep_removal_t pentru argumente.
Lipsește o bază de date de depozit configurată; consultați alpm_event_database_missing_t pentru argumente.
Se verifică dacă cheile utilizate pentru crearea semnăturilor sunt în inelul de chei.
Verificarea inelului de chei s-a încheiat.
Se descarcă cheile lipsă în inelul de chei.
Descărcarea cheilor s-a încheiat.
A fost creat un fișier .pacnew; consultați alpm_event_pacnew_created_t pentru argumente.
A fost creat un fișier .pacsave; consultați alpm_event_pacsave_created_t pentru argumente.
Va fi inițiată procesarea cârligelor.
Procesarea cârligelor s-a încheiat.
Un cârlig este lansat.
Un cârlig și-a finalizat execuția.

Tipul de cârlig.

O enumerare a tipurilor de operații ale pachetului

Enumerator

Pachet (pentru a fi) instalat. (Fără oldpkg)
Pachet (pentru a fi) actualizat.
Pachet (pentru a fi) reinstalat.
Pachet (pentru a fi) retrogradat.
Pachet (pentru a fi) eliminat. (Fără newpkg)

O enumerare a diferitelor tipuri de alerte de progres.

Enumerator

Instalare pachet.
Actualizare pachet.
Retrogradare pachet.
Reinstalare pachet.
Eliminare pachet.
Se verifică conflictele.
Se verifică spațiul pe disc.
Se verifică integritatea pachetului.
Se încarcă pachete de pe disc.
Se verifică semnăturile pachetelor.

Tipul de întrebare. Spre deosebire de enumerările evenimentelor sau progresului, această enumerare are valori de mască de biți, astfel încât o interfață poate utiliza o hartă de mască de biți pentru a furniza răspunsuri preselectate la diferitele tipuri de întrebări.

Enumerator

Ar trebui ca ținta din ignorepkg să fie instalată oricum?
Trebuie înlocuit un pachet?
Trebuie eliminat un pachet conflictual?
Trebuie șters un pachet corupt?
Trebuie ca țintele nerezolvabile să fie eliminate din tranzacție?
Selectarea furnizorului.
Trebuie importată o cheie?

Generat automat de Doxygen pentru „libalpm” din codul sursă.

Traducerea în limba română a acestui manual a fost făcută de Remus-Gabriel Chelu <remusgabriel.chelu@disroot.org>

Această traducere este documentație gratuită; citiți Licența publică generală GNU Versiunea 3 sau o versiune ulterioară cu privire la condiții privind drepturile de autor. NU se asumă NICIO RESPONSABILITATE.

Dacă găsiți erori în traducerea acestui manual, vă rugăm să trimiteți un e-mail la translation-team-ro@lists.sourceforge.net.

libalpm