libalpm_databases(3)

الاسم
libalpm_databases - قاعدة البيانات

 - دوال للاستعلام عن قاعدة بيانات libalpm ومعالجتها.

موجز

  Typedefs
typedef struct _alpm_db_t alpm_db_t
قاعدة بيانات.

  التعدادات
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 }
مستوى استخدام قاعدة البيانات.

  دوال
alpm_db_t * alpm_get_localdb (alpm_handle_t *handle)
احصل على قاعدة بيانات الحزم المثبتة محليًا.
alpm_list_t * alpm_get_syncdbs (alpm_handle_t *handle)
احصل على قائمة قواعد بيانات المزامنة.
alpm_db_t * alpm_register_syncdb (alpm_handle_t *handle, const char *treename, int level)
سجّل قاعدة بيانات مزامنة للحزم.
int alpm_unregister_all_syncdbs (alpm_handle_t *handle)
ألغِ تسجيل جميع قواعد بيانات الحزم.
int alpm_db_unregister (alpm_db_t *db)
ألغِ تسجيل قاعدة بيانات حزمة.
alpm_handle_t * alpm_db_get_handle (alpm_db_t *db)
احصل على مقبض قاعدة بيانات الحزمة.
const char * alpm_db_get_name (const alpm_db_t *db)
احصل على اسم قاعدة بيانات الحزمة.
int alpm_db_get_siglevel (alpm_db_t *db)
الحصول على مستوى التحقق من التوقيع لقاعدة بيانات.
int alpm_db_get_valid (alpm_db_t *db)
التحقق من صحة قاعدة بيانات.
int alpm_db_update (alpm_handle_t *handle, alpm_list_t *dbs, int force)
تحديث قواعد بيانات الحزم.
alpm_pkg_t * alpm_db_get_pkg (alpm_db_t *db, const char *name)
الحصول على مدخل حزمة من قاعدة بيانات الحزم.
alpm_list_t * alpm_db_get_pkgcache (alpm_db_t *db)
الحصول على خبيئة الحزم لقاعدة بيانات الحزم.
alpm_group_t * alpm_db_get_group (alpm_db_t *db, const char *name)
الحصول على مدخل مجموعة من قاعدة بيانات الحزم.
alpm_list_t * alpm_db_get_groupcache (alpm_db_t *db)
الحصول على خبيئة المجموعات لقاعدة بيانات الحزم.
int alpm_db_search (alpm_db_t *db, const alpm_list_t *needles, alpm_list_t **ret)
البحث في قاعدة بيانات باستخدام تعابير نمطية.

  مستخلصات الخادم
alpm_list_t * alpm_db_get_servers (const alpm_db_t *db)
الحصول على قائمة الخوادم المخصصة لقاعدة البيانات هذه.
int alpm_db_set_servers (alpm_db_t *db, alpm_list_t *servers)
يضبط قائمة الخوادم التي ستستخدمها قاعدة البيانات.
int alpm_db_add_server (alpm_db_t *db, const char *url)
يُضيف خادم تنزيل إلى قاعدة بيانات.
int alpm_db_remove_server (alpm_db_t *db, const char *url)
يُزيل خادم تنزيل من قاعدة بيانات.
alpm_list_t * alpm_db_get_cache_servers (const alpm_db_t *db)
يحصل على قائمة خوادم الخبيئة المخصصة لقاعدة البيانات هذه.
int alpm_db_set_cache_servers (alpm_db_t *db, alpm_list_t *servers)
يضبط قائمة خوادم الخبيئة التي ستستخدمها قاعدة البيانات.
int alpm_db_add_cache_server (alpm_db_t *db, const char *url)
يُضيف خادم خبيئة تنزيل إلى قاعدة بيانات.
int alpm_db_remove_cache_server (alpm_db_t *db, const char *url)
يُزيل خادم خبيئة تنزيل من قاعدة بيانات.

  دوال الوصول للاستخدام
int alpm_db_set_usage (alpm_db_t *db, int usage)
يضبط استخدام قاعدة بيانات.
int alpm_db_get_usage (alpm_db_t *db, int *usage)
يحصل على استخدام قاعدة بيانات.

وصف مفصل

دوال للاستعلام عن قاعدة بيانات libalpm ومعالجتها.

توثيق Typedef

  typedef struct _alpm_db_t alpm_db_t

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

يمكن أن توجد قاعدة البيانات على نظام الملفات المحلي أو على خادم بعيد.

لاستخدام قاعدة بيانات، يجب أولاً تسجيلها عبر alpm_register_syncdb. إذا كانت قاعدة البيانات موجودة بالفعل في dbpath فستكون قابلة للاستخدام. وإلا، يجب تنزيل قاعدة البيانات باستخدام alpm_db_update. حتى لو كان مصدر قاعدة البيانات هو نظام الملفات المحلي.

بعد ذلك، يمكن استخدام قاعدة البيانات للاستعلام عن الحزم والمجموعات. أي حزم أو مجموعات من قاعدة البيانات ستظل مملوكة لقاعدة البيانات ولا يحتاج المستخدم لتحريرها. سيتم تحريرها عند إلغاء تسجيل قاعدة البيانات.

تُلغى تسجيلات قواعد البيانات آليًا عند تحرير alpm_handle_t.

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

  enum alpm_db_usage_t

مستوى استخدام قاعدة البيانات.

Enumerator

ALPM_DB_USAGE_SYNC
    فعّل التحديثات لهذه قاعدة البيانات.

ALPM_DB_USAGE_SEARCH
    فعّل البحث لهذه قاعدة البيانات.

ALPM_DB_USAGE_INSTALL
    فعّل تثبيت الحزم من هذه قاعدة البيانات.

ALPM_DB_USAGE_UPGRADE
    فعّل ترقيات النظام باستخدام هذه قاعدة البيانات.

ALPM_DB_USAGE_ALL
    فعّل جميع مستويات الاستخدام.

توثيق الدوال

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

يُضيف خادم خبيئة تنزيل إلى قاعدة بيانات.

المعاملات
    db مؤشر قاعدة البيانات
    url رابط الخادم

النتائج
    0 عند النجاح، -1 عند الخطأ (يُضبط pm_errno وفقًا لذلك)

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

يُضيف خادم تنزيل إلى قاعدة بيانات.

المعاملات
    db مؤشر قاعدة البيانات
    url رابط الخادم

النتائج
    0 عند النجاح، -1 عند الخطأ (يُضبط pm_errno وفقًا لذلك)

  alpm_list_t * alpm_db_get_cache_servers (const alpm_db_t * db)

يحصل على قائمة خوادم الخبيئة المخصصة لقاعدة البيانات هذه.

المعاملات
    db مؤشر إلى قاعدة البيانات لجلب الخوادم منها

النتائج
    قائمة من نوع char* بالخوادم

  alpm_group_t * alpm_db_get_group (alpm_db_t * db, const char * name)

الحصول على مدخل مجموعة من قاعدة بيانات الحزم. البحث عن مجموعة هو O(1) وسيكون أسرع بكثير من التكرار عبر خبيئة المجموعة.

المعاملات
    db مؤشر إلى قاعدة بيانات الحزم لجلب المجموعة منها
    name اسم المجموعة

النتائج
    مدخل المجموعة عند النجاح، NULL عند الخطأ

  alpm_list_t * alpm_db_get_groupcache (alpm_db_t * db)

الحصول على خبيئة المجموعات لقاعدة بيانات الحزم.

المعاملات
    db مؤشر إلى قاعدة بيانات الحزم لجلب المجموعة منها

النتائج
    قائمة المجموعات عند النجاح، NULL عند الخطأ

  alpm_handle_t * alpm_db_get_handle (alpm_db_t * db)

احصل على مقبض قاعدة بيانات الحزمة.

المعاملات
    db مؤشر إلى قاعدة بيانات الحزم

النتائج
    مقبض alpm الذي تنتمي إليه قاعدة بيانات الحزم

  const char * alpm_db_get_name (const alpm_db_t * db)

احصل على اسم قاعدة بيانات الحزمة.

المعاملات
    db مؤشر إلى قاعدة بيانات الحزم

النتائج
    اسم قاعدة بيانات الحزم، NULL عند الخطأ

  alpm_pkg_t * alpm_db_get_pkg (alpm_db_t * db, const char * name)

الحصول على مدخل حزمة من قاعدة بيانات الحزم. البحث عن حزمة هو O(1) وسيكون أسرع بكثير من التكرار عبر خبيئة الحزم.

المعاملات
    db مؤشر إلى قاعدة بيانات الحزم لجلب الحزمة منها
    name اسم الحزمة

النتائج
    إدخال الحزمة عند النجاح، NULL عند الخطأ

  alpm_list_t * alpm_db_get_pkgcache (alpm_db_t * db)

الحصول على خبيئة الحزم لقاعدة بيانات الحزم. هذه قائمة بجميع الحزم التي تحتويها قاعدة البيانات.

المعاملات
    db مؤشر إلى قاعدة بيانات الحزم لجلب الحزمة منها

النتائج
    قائمة الحزم عند النجاح، NULL عند الخطأ

  alpm_list_t * alpm_db_get_servers (const alpm_db_t * db)

الحصول على قائمة الخوادم المخصصة لقاعدة البيانات هذه.

المعاملات
    db مؤشر إلى قاعدة البيانات لجلب الخوادم منها

النتائج
    قائمة من نوع char* بالخوادم

  int alpm_db_get_siglevel (alpm_db_t * db)

الحصول على مستوى التحقق من التوقيع لقاعدة بيانات. سيعيد مستوى التحقق المبدئي إذا كانت قاعدة البيانات هذه مضبوطة بـ ALPM_SIG_USE_DEFAULT.

المعاملات
    db مؤشر إلى قاعدة بيانات الحزم

النتائج
    مستوى التحقق من التوقيع

  int alpm_db_get_usage (alpm_db_t * db, int * usage)

يحصل على استخدام قاعدة بيانات.

المعاملات
    db مؤشر لقاعدة بيانات الحزم للحصول على حالتها
    usage مؤشر إلى alpm_db_usage_t لتخزين حالة قاعدة البيانات

النتائج
    0 عند النجاح، أو -1 عند الخطأ

  int alpm_db_get_valid (alpm_db_t * db)

التحقق من صحة قاعدة بيانات. هذا مفيد جدًا لقواعد بيانات المزامنة والتحقق من حالة التوقيع. إذا كانت غير صالحة، سيُضبط رمز خطأ المقبض وفقًا لذلك.

المعاملات
    db مؤشر إلى قاعدة بيانات الحزم

النتائج
    0 إذا كانت صالحة، -1 إذا كانت غير صالحة (يُضبط pm_errno وفقًا لذلك)

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

يُزيل خادم خبيئة تنزيل من قاعدة بيانات.

المعاملات
    db مؤشر قاعدة البيانات
    url رابط الخادم

النتائج
    0 عند النجاح، 1 عند عدم وجود الخادم، -1 عند الخطأ (يُضبط pm_errno وفقًا لذلك)

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

يُزيل خادم تنزيل من قاعدة بيانات.

المعاملات
    db مؤشر قاعدة البيانات
    url رابط الخادم

النتائج
    0 عند النجاح، 1 عند عدم وجود الخادم، -1 عند الخطأ (يُضبط pm_errno وفقًا لذلك)

  int alpm_db_search (alpm_db_t * db, const alpm_list_t * needles, alpm_list_t ** ret)

البحث في قاعدة بيانات باستخدام تعابير نمطية.

المعاملات
    db مؤشر لقاعدة بيانات الحزم للبحث فيها
    needles قائمة بتعبيرات نمطية للبحث عنها
    ret مؤشر لقائمة لتخزين الحزم المطابقة لجميع التعبيرات النمطية - يجب أن يشير إلى alpm_list_t * فارغ (NULL).

النتائج
    0 عند النجاح، -1 عند الخطأ (يُضبط pm_errno وفقًا لذلك)

  int alpm_db_set_cache_servers (alpm_db_t * db, alpm_list_t * servers)

يضبط قائمة خوادم الخبيئة التي ستستخدمها قاعدة البيانات.

المعاملات
    db قاعدة البيانات لتعيين الخوادم. ستُنسخ القائمة وستظل القائمة الأصلية بحاجة إلى تحريرها من قبل المستدعي.
    servers قائمة من نوع char* بالخوادم.

  int alpm_db_set_servers (alpm_db_t * db, alpm_list_t * servers)

يضبط قائمة الخوادم التي ستستخدمها قاعدة البيانات.

المعاملات
    db قاعدة البيانات لتعيين الخوادم. ستُنسخ القائمة وستظل القائمة الأصلية بحاجة إلى تحريرها من قبل المستدعي.
    servers قائمة من نوع char* بالخوادم.

  int alpm_db_set_usage (alpm_db_t * db, int usage)

يضبط استخدام قاعدة بيانات.

المعاملات
    db مؤشر لقاعدة بيانات الحزم لتعيين الحالة لها
    usage قناع بت لقيم alpm_db_usage_t

النتائج
    0 عند النجاح، أو -1 عند الخطأ

  int alpm_db_unregister (alpm_db_t * db)

إلغاء تسجيل قاعدة بيانات حزم. لا يمكن إلغاء تسجيل قواعد البيانات عند وجود معاملة نشطة.

المعاملات
    db مؤشر لقاعدة بيانات الحزم لإلغاء تسجيلها

النتائج
    0 عند النجاح، -1 عند الخطأ (يُضبط pm_errno وفقًا لذلك)

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

تحديث قواعد بيانات الحزم. ستُحاول عملية تحديث لقواعد بيانات الحزم في القائمة dbs. ما لم يكن force صحيحًا، سيُجرى التحديث فقط إذا عُدلت قواعد البيانات البعيدة منذ آخر تحديث.

تتطلب هذه العملية قفل قاعدة بيانات، وسيُعاد خطأ مناسب إذا تعذر الحصول على القفل.

مثال:

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)));
}

ملاحظة
    بعد تحديث ناجح، ستُبطل خبيئة الحزم

المعاملات
    handle مقبض السياق
    dbs قائمة بقواعد بيانات الحزم لتحديثها
    force إذا كان صحيحًا، يُجبر التحديث، وإلا يُحدّث فقط في حال لم تكن قواعد البيانات محدثة

النتائج
    0 عند النجاح، -1 عند الخطأ (يُعيَّن pm_errno وفقًا لذلك)، 1 إذا كانت جميع قواعد البيانات محدَّثة

  alpm_db_t * alpm_get_localdb (alpm_handle_t * handle)

احصل على قاعدة بيانات الحزم المُثبَّتة محليًا. يُشير المؤشر المُرجَع إلى بنية داخلية لـ libalpm يجب التعامل معها فقط عبر دوال libalpm.

النتائج
    مرجع إلى قاعدة البيانات المحلية

  alpm_list_t * alpm_get_syncdbs (alpm_handle_t * handle)

احصل على قائمة قواعد بيانات المزامنة. تُرجع قائمة من بنى alpm_db_t، واحدة لكل قاعدة بيانات مزامنة مُسجَّلة.

المعاملات
    handle مقبض السياق

النتائج
    مرجع إلى قائمة داخلية من بنى alpm_db_t

  alpm_db_t * alpm_register_syncdb (alpm_handle_t * handle, const char * treename, int level)

سجِّل قاعدة بيانات مزامنة للحزم. لا يمكن تسجيل قواعد البيانات عند وجود معاملة نشطة.

المعاملات
    handle مقبض السياق
    treename اسم مستودع المزامنة
    level مستوى التحقق من التوقيع الذي سيُجرى على قاعدة البيانات؛ لاحظ أن هذا يجب أن يكون تحققًا من نوع ملف '.sig'

النتائج
    مؤشر alpm_db_t* عند النجاح (القيمة)، NULL عند الخطأ

  int alpm_unregister_all_syncdbs (alpm_handle_t * handle)

ألغِ تسجيل جميع قواعد بيانات الحزم. لا يمكن إلغاء تسجيل قواعد البيانات أثناء وجود معاملة نشطة.

المعاملات
    handle مقبض السياق

النتائج
    0 عند النجاح، -1 عند الخطأ (يُضبط pm_errno وفقًا لذلك)

المؤلف

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

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

هذه الترجمة هي وثيقة مجانية؛ راجع رخصة جنو العامة الإصدار 3 (https://www.gnu.org/licenses/gpl-3.0.html) أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

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