libalpm_cb(3) Library Functions Manual libalpm_cb(3)

الاسم

libalpm_cb - دوال الاسترجاع


- دوال وهياكل دوال الاسترجاع في libalpm

موجز

بنى البيانات


هيكل alpm_event_any_t
حدث قد يمثل أي حدث. هيكل alpm_event_package_operation_t
وقع حدث عملية حزمة. هيكل alpm_event_optdep_removal_t
أُزيل اعتماد اختياري. هيكل alpm_event_scriptlet_info_t
شُغّل سكريبت صغير. هيكل alpm_event_database_missing_t
قاعدة بيانات مفقودة. هيكل alpm_event_pkgdownload_t
نُزّلت حزمة. هيكل alpm_event_pacnew_created_t
أُنشئ ملف pacnew. هيكل alpm_event_pacsave_created_t
أُنشئ ملف pacsave. هيكل alpm_event_hook_t
خطافات ما قبل/بعد المعاملة سيُشغّل. هيكل alpm_event_hook_run_t
تم تشغيل خطاف قبل/بعد المعاملة. هيكل alpm_event_pkg_retrieve_t
حزم التحميل على وشك البدء. اتحاد alpm_event_t
الأحداث. هيكل alpm_question_any_t
سؤال يمكن أن يمثل أي سؤال آخر. هيكل alpm_question_install_ignorepkg_t
هل يجب تثبيت الهدف في ignorepkg على أي حال؟ هيكل alpm_question_replace_t
هل يجب استبدال حزمة؟ هيكل alpm_question_conflict_t
هل يجب إزالة حزمة متعارضة؟ هيكل alpm_question_corrupted_t
هل يجب حذف حزمة تالفة؟ هيكل alpm_question_remove_pkgs_t
هل يجب إزالة الأهداف غير القابلة للحل من المعاملة؟ هيكل alpm_question_select_provider_t
اختيار المزود. هيكل alpm_question_import_key_t
هل يجب استيراد مفتاح؟ اتحاد alpm_question_t
أسئلة. هيكل alpm_download_event_init_t
هيكل سياق عند بدء تنزيل. هيكل alpm_download_event_progress_t
هيكل سياق عند تقدم تنزيل. هيكل alpm_download_event_retry_t
هيكل سياق عند إعادة محاولة تنزيل. هيكل alpm_download_event_completed_t
هيكل سياق عند اكتمال تنزيل.


typedef void(* alpm_cb_event) (void *ctx, alpm_event_t *event)
استدعاء حدث. typedef void(* alpm_cb_question) (void *ctx, alpm_question_t *question)
استدعاء سؤال. typedef void(* alpm_cb_progress) (void *ctx, alpm_progress_t progress, const char *pkg, int percent, size_t howmany, size_t current)
استدعاء تقدم. typedef void(* alpm_cb_download) (void *ctx, const char *filename, alpm_download_event_type_t event, void *data)
نوع استدعاءات تقدم التنزيل. typedef int(* alpm_cb_fetch) (void *ctx, const char *url, const char *localpath, int force)
دالة رد لتنزيل الملفات.

التعدادات


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 }
نوع الأحداث. enum alpm_package_operation_t { ALPM_PACKAGE_INSTALL = 1, ALPM_PACKAGE_UPGRADE, ALPM_PACKAGE_REINSTALL, ALPM_PACKAGE_DOWNGRADE, ALPM_PACKAGE_REMOVE }
تعداد لأنواع عمليات الحزمة. enum alpm_hook_when_t { ALPM_HOOK_PRE_TRANSACTION = 1, ALPM_HOOK_POST_TRANSACTION }
نوع الخطاف. 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) }
نوع السؤال. 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 }
تعداد لأنواع مختلفة من تنبيهات التقدم. enum alpm_download_event_type_t { ALPM_DOWNLOAD_INIT, ALPM_DOWNLOAD_PROGRESS, ALPM_DOWNLOAD_RETRY, ALPM_DOWNLOAD_COMPLETED }
أحداث تنزيل الملفات.

وصف مفصل

دوال وهياكل لنداءات libalpm الراجعة

توثيق بنية البيانات

حدث قد يمثل أي حدث.

حقول البيانات:

alpm_event_type_t type نوع الحدث.

وقع حدث عملية حزمة.

حقول البيانات:

alpm_pkg_t * newpkg الحزمة الجديدة.

alpm_pkg_t * oldpkg الحزمة القديمة.

alpm_package_operation_t operation نوع العملية.

alpm_event_type_t type نوع الحدث.

هيكل alpm_event_optdep_removal_t

أُزيل اعتماد اختياري.

حقول البيانات:

alpm_depend_t * optdep التبعية الاختيارية التي تُزال.

alpm_pkg_t * pkg الحزمة التي تحوي التبعية الاختيارية.

alpm_event_type_t type نوع الحدث.

هيكل alpm_event_scriptlet_info_t

شُغّل سكريبت صغير.

حقول البيانات:

const char * line سطر مخرجات السكريبتليت.

alpm_event_type_t type نوع الحدث.

هيكل alpm_event_database_missing_t

قاعدة بيانات مفقودة.

قاعدة البيانات مسجلة لكنها لم تُنزّل

حقول البيانات:

const char * dbname اسم قاعدة البيانات.

alpm_event_type_t type نوع الحدث.

هيكل alpm_event_pkgdownload_t

نُزّلت حزمة.

حقول البيانات:

const char * file اسم الملف.

alpm_event_type_t type نوع الحدث.

هيكل alpm_event_pacnew_created_t

أُنشئ ملف pacnew.

حقول البيانات:

const char * file اسم الملف دون اللاحقة .pacnew.

int from_noupgrade هل كان الإنشاء نتيجة NoUpgrade أم لا.

alpm_pkg_t * newpkg الحزمة الجديدة.

alpm_pkg_t * oldpkg الحزمة القديمة.

alpm_event_type_t type نوع الحدث.

هيكل alpm_event_pacsave_created_t

أُنشئ ملف pacsave.

حقول البيانات:

const char * file اسم الملف دون اللاحقة .pacsave.

alpm_pkg_t * oldpkg الحزمة القديمة.

alpm_event_type_t type نوع الحدث.

هيكل alpm_event_hook_t

خطافات ما قبل/بعد المعاملة سيُشغّل.

حقول البيانات:

alpm_event_type_t type نوع الحدث.

alpm_hook_when_t when نوع الخطاف.

هيكل alpm_event_hook_run_t

تم تشغيل خطاف قبل/بعد المعاملة.

حقول البيانات:

const char * desc وصف الخطاف الذي سيُخرج.

const char * name اسم الخطاف.

size_t position موضع الخطاف الجاري تشغيله

size_t total إجمالي الخطافات الجاري تشغيلها

alpm_event_type_t type نوع الحدث.

حزم التحميل على وشك البدء.

حقول البيانات:

size_t num عدد الحزم المطلوب تنزيلها.

off_t total_size الحجم الإجمالي للحزم المطلوب تنزيلها.

alpm_event_type_t type نوع الحدث.

الأحداث.

هذا اتحاد يُمرر إلى دالة الاستدعاء الذي يسمح للواجهة الأمامية بمعرفة أي نوع من الأحداث تم تشغيله (عبر النوع). من ثم يمكن تحويل المؤشر إلى البنية الصحيحة، أو استخدام حقل الاتحاد، للوصول إلى البيانات الخاصة بالحدث.

حقول البيانات:

alpm_event_any_t any نوع الحدث العام.
من الآمن دائمًا الوصول إلى هذا.

alpm_event_database_missing_t database_missing قاعدة بيانات مفقودة.

alpm_event_hook_t hook خطافات قبل/بعد المعاملة قيد التشغيل.

alpm_event_hook_run_t hook_run تم تشغيل خطاف.

alpm_event_optdep_removal_t optdep_removal تمت إزالة تبعية اختيارية.

alpm_event_package_operation_t package_operation عملية حزمة.

alpm_event_pacnew_created_t pacnew_created تم إنشاء ملف pacnew.

alpm_event_pacsave_created_t pacsave_created تم إنشاء ملف pacsave.

alpm_event_pkg_retrieve_t pkg_retrieve تنزيل الحزم.

alpm_event_pkgdownload_t pkgdownload تم تنزيل حزمة.

alpm_event_scriptlet_info_t scriptlet_info تم تشغيل سكريبت.

alpm_event_type_t type نوع الحدث، من الآمن دائمًا الوصول إليه.

هيكل alpm_question_any_t

سؤال يمكن أن يمثل أي سؤال آخر.

حقول البيانات:

int answer الإجابة.

alpm_question_type_t type نوع السؤال.

هيكل alpm_question_install_ignorepkg_t

هل يجب تثبيت الهدف في ignorepkg على أي حال؟

حقول البيانات:

int install الإجابة: هل سيُثبَّت الحزمة على أي حال أم لا.

alpm_pkg_t * pkg الحزمة المتجاهلة التي نقرر ما إذا كنا سنثبتها.

alpm_question_type_t type نوع السؤال.

هيكل alpm_question_replace_t

هل يجب استبدال حزمة؟

حقول البيانات:

alpm_db_t * newdb قاعدة بيانات الحزمة الجديدة.

alpm_pkg_t * newpkg الحزمة التي سيُستبدل بها.

alpm_pkg_t * oldpkg الحزمة التي ستُستبدل.

int replace الإجابة: هل سيُستبدل oldpkg بـ newpkg أم لا.

alpm_question_type_t type نوع السؤال.

هيكل alpm_question_conflict_t

هل يجب إزالة حزمة متعارضة؟

حقول البيانات:

alpm_conflict_t * conflict معلومات التعارض.

int remove الإجابة: هل ستُحذف الحزمة conflict->package2 أم لا.

alpm_question_type_t type نوع السؤال.

هيكل alpm_question_corrupted_t

هل يجب حذف حزمة تالفة؟

حقول البيانات:

const char * filepath الملف المراد حذفه.

alpm_errno_t reason رمز الخطأ الذي يشير إلى سبب عدم صلاحية الحزمة.

int remove الإجابة: هل سيُحذف filepath أم لا.

alpm_question_type_t type نوع السؤال.

هيكل alpm_question_remove_pkgs_t

هل يجب إزالة الأهداف غير القابلة للحل من المعاملة؟

حقول البيانات:

alpm_list_t * حزم قائمة من alpm_pkg_t* مع تبعيات غير محلولة.

int تجاوز الإجابة: هل يتم تجاوز الحزم أم لا.

alpm_question_type_t type نوع السؤال.

اختيار المزود.

حقول البيانات:

alpm_depend_t * اعتماد ما يوفره المزودون.

alpm_list_t * مزودون قائمة من alpm_pkg_t* كمزودين محتملين.

alpm_question_type_t type نوع السؤال.

int استخدم_فهرس الإجابة: أي مزود يُستخدم (فهرس من المزودين).

هل يجب استيراد مفتاح؟

حقول البيانات:

const char * بصمة بصمة المفتاح المراد استيراده.

int استيراد الإجابة: هل يُستورد المفتاح أم لا.

alpm_question_type_t type نوع السؤال.

const char * uid معرف المستخدم للمفتاح المراد استيراده.

أسئلة.

هذا اتحاد يُمرر إلى دالة الاستدعاء التي تسمح للواجهة الأمامية بمعرفة أي نوع من الأسئلة أُثير (عبر النوع). من ثم يمكن تحويل المؤشر إلى البنية الصحيحة، أو استخدام حقل الاتحاد، للوصول إلى بيانات خاصة بالسؤال.

حقول البيانات:

alpm_question_any_t أي سؤال يمكن أن يمثل أي سؤال.
من الآمن دائمًا الوصول إلى هذا.

alpm_question_conflict_t تعارض هل تُزال حزمة متعارضة؟

alpm_question_corrupted_t تالف هل تُحذف حزمة تالفة؟

alpm_question_import_key_t استيراد_مفتاح هل يُستورد مفتاح؟

alpm_question_install_ignorepkg_t تثبيت_تجاهل_حزمة هل يُثبت الهدف في تجاهل_حزمة على أي حال؟

alpm_question_remove_pkgs_t إزالة_حزم هل تُزال الأهداف غير القابلة للحل من المعاملة؟

alpm_question_replace_t استبدال هل تُستبدل حزمة؟

alpm_question_select_provider_t اختيار_مزود اختيار المزود.

alpm_question_type_t النوع نوع السؤال.
من الآمن دائمًا الوصول إلى هذا.

هيكل alpm_download_event_init_t

هيكل سياق عند بدء تنزيل.

حقول البيانات:

int اختياري هل هذا الملف اختياري وبالتالي يمكن تجاهل الأخطاء

هيكل alpm_download_event_progress_t

هيكل سياق عند تقدم تنزيل.

حقول البيانات:

off_t مُنزَّل كمية البيانات المُنزَّلة.

off_t الإجمالي المقدار الإجمالي المطلوب تنزيله.

هيكل alpm_download_event_retry_t

هيكل سياق عند إعادة محاولة تنزيل.

حقول البيانات:

int استئناف هل سيُستأنف التنزيل أم يُبدأ من جديد.

هيكل alpm_download_event_completed_t

هيكل سياق عند اكتمال تنزيل.

حقول البيانات:

int النتيجة رمز نتيجة التنزيل: 0 - اكتمل التنزيل بنجاح 1 - الملف محدث -1 - خطأ

off_t الإجمالي إجمالي البايتات في الملف.

توثيق Typedef

نوع استدعاءات تقدم التنزيل.

المعاملات

ctx سياق مقدم من المستخدم
filename اسم الملف الجاري تنزيله
event نوع الحدث
data بيانات الحدث من نوع alpm_download_event_*_t

استدعاء حدث. يُستدعى عند حدوث حدث

المعاملات

ctx سياق مقدم من المستخدم
event الحدث الذي حدث

دالة رد لتنزيل الملفات.

المعاملات

ctx سياق مقدم من المستخدم
url رابط الملف المراد تنزيله
localpath الدليل الذي يجب تنزيل الملف إليه
force ما إذا كان يجب فرض تحديث، حتى لو كان الملف نفسه

النتائج

0 عند النجاح، 1 إذا كان الملف موجودًا ومطابقًا، -1 عند الخطأ.

استدعاء تقدم. يُنبّه الواجهة الأمامية عن تقدم أحداث معينة. يسمح بتنفيذ أشرطة تحميل للأحداث التي قد تستغرق وقتًا لإكمالها.

المعاملات

ctx سياق مقدم من المستخدم
progress نوع الحدث الجاري تقدمه
pkg لعمليات الحزم، اسم الحزمة التي يتم التعامل معها
percent النسبة المئوية لإكمال الإجراء
howmany العدد الإجمالي للعناصر في الإجراء
current العدد الحالي للعناصر المكتملة استدعاء التقدم

استدعاء سؤال. يسمح هذا الاستدعاء للمستخدم بإدخال وتحديد ما يجب فعله أثناء أحداث معينة

المعاملات

ctx سياق مقدم من المستخدم
question السؤال المطروح.

توثيق أنواع التعداد

أحداث تنزيل الملفات. تُبلغ هذه الأحداث بواسطة ALPM عبر استدعاء التنزيل.

Enumerator

بُدئ تنزيل.
أحرز تنزيل تقدمًا.
ستُعاد محاولة التنزيل.
اكتمل تنزيل.

تعداد alpm_event_type_t

نوع الأحداث.

Enumerator

ستُحسب التبعيات لحزمة.
حُسبت التبعيات لحزمة.
ستُحسب تعارضات الملفات لحزمة.
حُسبت تعارضات الملفات لحزمة.
ستُحل التبعيات للحزمة الهدف.
حُلّت التبعيات للحزمة الهدف.
ستُفحص التعارضات البينية للحزمة الهدف.
فُحصت التعارضات البينية للحزمة الهدف.
بدء معالجة معاملة الحزمة.
انتهت معالجة معاملة الحزمة.
ستُثبَّت/تُرقَّى/تُخفَّض/تُعاد تثبيت/تُحذف الحزمة؛ انظر alpm_event_package_operation_t للمعاملات.
ثُبِّتت/رُقِّيت/خُفِّضت/أُعيد تثبيتها/حُذفت الحزمة؛ انظر alpm_event_package_operation_t للمعاملات.
سيُفحص تكامل الحزمة الهدف.
فُحص تكامل الحزمة الهدف.
ستُحمَّل الحزمة الهدف.
انتهى تحميل الحزمة الهدف.
طبع السكريبت معلومات؛ انظر alpm_event_scriptlet_info_t للمعاملات.
سيُحمل ملفات قاعدة البيانات من مستودع.
حُملت ملفات قاعدة البيانات من مستودع.
لم تُحمل جميع ملفات قاعدة البيانات بنجاح من مستودع.
سيُحمل ملفات الحزمة من مستودع.
حُملت ملفات الحزمة من مستودع.
لم تُحمل جميع ملفات الحزمة بنجاح من مستودع.
سيُحسب استخدام مساحة القرص لحزمة.
حُسب استخدام مساحة القرص لحزمة.
يُزال اعتماد اختياري لحزمة أخرى؛ انظر alpm_event_optdep_removal_t للوسائط.
قاعدة بيانات مستودع مهيأة مفقودة؛ انظر alpm_event_database_missing_t للوسائط.
التحقق من أن المفاتيح المستخدمة لإنشاء التوقيعات موجودة في سلسلة المفاتيح.
انتهى التحقق من سلسلة المفاتيح.
تنزيل المفاتيح المفقودة إلى سلسلة المفاتيح.
انتهى تنزيل المفاتيح.
وُجد ملف .pacnew؛ انظر alpm_event_pacnew_created_t للمعاملات.
وُجد ملف .pacsave؛ انظر alpm_event_pacsave_created_t للمعاملات.
ستبدأ معالجة الخطاطيف.
انتهت معالجة الخطاطيف.
يبدأ خطاف.
انتهى تشغيل خطاف.

نوع الخطاف.

تعداد alpm_package_operation_t

تعداد لأنواع عمليات الحزمة.

Enumerator

الحزمة (التي سيتم) تثبيتها. (لا توجد حزمة قديمة)
الحزمة (التي سيتم) ترقيتها.
الحزمة (التي سيتم) إعادة تثبيتها.
الحزمة (التي سيتم) خفض إصدارها.
الحزمة (التي سيتم) إزالتها (لا توجد حزمة جديدة).

تعداد alpm_progress_t

تعداد لأنواع مختلفة من تنبيهات التقدم.

Enumerator

تثبيت الحزمة.
ترقية الحزمة.
خفض إصدار الحزمة.
إعادة تثبيت الحزمة.
إزالة الحزمة.
التحقق من التعارضات.
التحقق من مساحة القرص.
التحقق من سلامة الحزمة.
تحميل الحزم من القرص.
التحقق من توقيعات الحزم.

تعداد alpm_question_type_t

نوع السؤال. على عكس تعدادات الأحداث أو التقدم، يحتوي هذا التعداد على قيم قناع بتات بحيث يمكن للواجهة الأمامية استخدام خريطة قناع بتات لتقديم إجابات محددة مسبقًا لأنواع الأسئلة المختلفة.

Enumerator

هل يجب تثبيت الهدف في ignorepkg على أي حال؟
هل يجب استبدال حزمة؟
هل يجب إزالة حزمة متعارضة؟
هل يجب حذف حزمة تالفة؟
هل يجب إزالة الأهداف غير القابلة للحل من المعاملة؟
اختيار المزود.
سؤال_ألبيإم_استيراد_مفتاح
هل يجب استيراد مفتاح؟

المؤلف

أُنشئ تلقائيًا بواسطة Doxygen لـ libalpm من الكود المصدري.

ترجمة

تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي <zayed.alsaidi@gmail.com>

هذه الترجمة هي وثيقة مجانية؛ راجع رخصة جنو العامة الإصدار 3 أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: kde-l10n-ar@kde.org.

libalpm