.\" -*- coding: UTF-8 -*- .\" -*- nroff -*- .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH libalpm_databases 3 libalpm .ad l .nh .SH الاسم libalpm_databases \- قاعدة البيانات .PP \- دوال للاستعلام عن قاعدة بيانات libalpm ومعالجتها\&. .SH موجز .br .PP .SS Typedefs .in +1c .ti -1c typedef struct _alpm_db_t \fBalpm_db_t\fP .br قاعدة بيانات\&. .in -1c .SS التعدادات .in +1c .ti -1c enum \fBalpm_db_usage_t\fP { \fBALPM_DB_USAGE_SYNC\fP = 1, \fBALPM_DB_USAGE_SEARCH\fP = (1 << 1), \fBALPM_DB_USAGE_INSTALL\fP = (1 << 2), \fBALPM_DB_USAGE_UPGRADE\fP = (1 << 3), \fBALPM_DB_USAGE_ALL\fP = (1 << 4) \- 1 } .br مستوى استخدام قاعدة البيانات\&. .in -1c .SS دوال .in +1c .ti -1c \fBalpm_db_t\fP * \fBalpm_get_localdb\fP (\fBalpm_handle_t\fP *handle) .br احصل على قاعدة بيانات الحزم المثبتة محليًا\&. .ti -1c \fBalpm_list_t\fP * \fBalpm_get_syncdbs\fP (\fBalpm_handle_t\fP *handle) .br احصل على قائمة قواعد بيانات المزامنة\&. .ti -1c \fBalpm_db_t\fP * \fBalpm_register_syncdb\fP (\fBalpm_handle_t\fP *handle, const char *treename, int level) .br سجّل قاعدة بيانات مزامنة للحزم\&. .ti -1c int \fBalpm_unregister_all_syncdbs\fP (\fBalpm_handle_t\fP *handle) .br ألغِ تسجيل جميع قواعد بيانات الحزم\&. .ti -1c int \fBalpm_db_unregister\fP (\fBalpm_db_t\fP *db) .br ألغِ تسجيل قاعدة بيانات حزمة\&. .ti -1c \fBalpm_handle_t\fP * \fBalpm_db_get_handle\fP (\fBalpm_db_t\fP *db) .br احصل على مقبض قاعدة بيانات الحزمة\&. .ti -1c const char * \fBalpm_db_get_name\fP (const \fBalpm_db_t\fP *db) .br احصل على اسم قاعدة بيانات الحزمة\&. .ti -1c int \fBalpm_db_get_siglevel\fP (\fBalpm_db_t\fP *db) .br الحصول على مستوى التحقق من التوقيع لقاعدة بيانات\&. .ti -1c int \fBalpm_db_get_valid\fP (\fBalpm_db_t\fP *db) .br التحقق من صحة قاعدة بيانات\&. .ti -1c int \fBalpm_db_update\fP (\fBalpm_handle_t\fP *handle, \fBalpm_list_t\fP *dbs, int force) .br تحديث قواعد بيانات الحزم\&. .ti -1c \fBalpm_pkg_t\fP * \fBalpm_db_get_pkg\fP (\fBalpm_db_t\fP *db, const char *name) .br الحصول على مدخل حزمة من قاعدة بيانات الحزم\&. .ti -1c \fBalpm_list_t\fP * \fBalpm_db_get_pkgcache\fP (\fBalpm_db_t\fP *db) .br الحصول على خبيئة الحزم لقاعدة بيانات الحزم\&. .ti -1c \fBalpm_group_t\fP * \fBalpm_db_get_group\fP (\fBalpm_db_t\fP *db, const char *name) .br الحصول على مدخل مجموعة من قاعدة بيانات الحزم\&. .ti -1c \fBalpm_list_t\fP * \fBalpm_db_get_groupcache\fP (\fBalpm_db_t\fP *db) .br الحصول على خبيئة المجموعات لقاعدة بيانات الحزم\&. .ti -1c int \fBalpm_db_search\fP (\fBalpm_db_t\fP *db, const \fBalpm_list_t\fP *needles, \fBalpm_list_t\fP **ret) .br البحث في قاعدة بيانات باستخدام تعابير نمطية\&. .in -1c .SS "مستخلصات الخادم" .in +1c .ti -1c \fBalpm_list_t\fP * \fBalpm_db_get_servers\fP (const \fBalpm_db_t\fP *db) .br الحصول على قائمة الخوادم المخصصة لقاعدة البيانات هذه\&. .ti -1c int \fBalpm_db_set_servers\fP (\fBalpm_db_t\fP *db, \fBalpm_list_t\fP *servers) .br يضبط قائمة الخوادم التي ستستخدمها قاعدة البيانات. .ti -1c int \fBalpm_db_add_server\fP (\fBalpm_db_t\fP *db, const char *url) .br يُضيف خادم تنزيل إلى قاعدة بيانات. .ti -1c int \fBalpm_db_remove_server\fP (\fBalpm_db_t\fP *db, const char *url) .br يُزيل خادم تنزيل من قاعدة بيانات. .ti -1c \fBalpm_list_t\fP * \fBalpm_db_get_cache_servers\fP (const \fBalpm_db_t\fP *db) .br يحصل على قائمة خوادم الخبيئة المخصصة لقاعدة البيانات هذه. .ti -1c int \fBalpm_db_set_cache_servers\fP (\fBalpm_db_t\fP *db, \fBalpm_list_t\fP *servers) .br يضبط قائمة خوادم الخبيئة التي ستستخدمها قاعدة البيانات. .ti -1c int \fBalpm_db_add_cache_server\fP (\fBalpm_db_t\fP *db, const char *url) .br يُضيف خادم خبيئة تنزيل إلى قاعدة بيانات. .ti -1c int \fBalpm_db_remove_cache_server\fP (\fBalpm_db_t\fP *db, const char *url) .br يُزيل خادم خبيئة تنزيل من قاعدة بيانات. .in -1c .SS "دوال الوصول للاستخدام" .in +1c .ti -1c int \fBalpm_db_set_usage\fP (\fBalpm_db_t\fP *db, int usage) .br يضبط استخدام قاعدة بيانات. .ti -1c int \fBalpm_db_get_usage\fP (\fBalpm_db_t\fP *db, int *usage) .br يحصل على استخدام قاعدة بيانات. .in -1c .SH "وصف مفصل" .PP دوال للاستعلام عن قاعدة بيانات libalpm ومعالجتها\&. .SH "توثيق Typedef" .PP .SS "typedef struct _alpm_db_t alpm_db_t" .PP قاعدة بيانات. قاعدة البيانات هي حاوية تخزن بيانات وصفية عن الحزم. .PP يمكن أن توجد قاعدة البيانات على نظام الملفات المحلي أو على خادم بعيد\&. .PP لاستخدام قاعدة بيانات، يجب أولاً تسجيلها عبر \fBalpm_register_syncdb\fP\&. إذا كانت قاعدة البيانات موجودة بالفعل في dbpath فستكون قابلة للاستخدام\&. وإلا، يجب تنزيل قاعدة البيانات باستخدام \fBalpm_db_update\fP\&. حتى لو كان مصدر قاعدة البيانات هو نظام الملفات المحلي\&. .PP بعد ذلك، يمكن استخدام قاعدة البيانات للاستعلام عن الحزم والمجموعات\&. أي حزم أو مجموعات من قاعدة البيانات ستظل مملوكة لقاعدة البيانات ولا يحتاج المستخدم لتحريرها\&. سيتم تحريرها عند إلغاء تسجيل قاعدة البيانات\&. .PP تُلغى تسجيلات قواعد البيانات آليًا عند تحرير \fBalpm_handle_t\fP\&. .SH "توثيق أنواع التعداد" .PP .SS "enum alpm_db_usage_t" .PP مستوى استخدام قاعدة البيانات\&. .PP \fBEnumerator\fP .in +1c .TP \f(BIALPM_DB_USAGE_SYNC \fR فعّل التحديثات لهذه قاعدة البيانات\&. .TP \f(BIALPM_DB_USAGE_SEARCH \fR فعّل البحث لهذه قاعدة البيانات\&. .TP \f(BIALPM_DB_USAGE_INSTALL \fR فعّل تثبيت الحزم من هذه قاعدة البيانات\&. .TP \f(BIALPM_DB_USAGE_UPGRADE \fR فعّل ترقيات النظام باستخدام هذه قاعدة البيانات\&. .TP \f(BIALPM_DB_USAGE_ALL \fR فعّل جميع مستويات الاستخدام\&. .SH "توثيق الدوال" .PP .SS "int alpm_db_add_cache_server (alpm_db_t * db, const char * url)" .PP يُضيف خادم خبيئة تنزيل إلى قاعدة بيانات. .PP \fBالمعاملات\fP .RS 4 \fIdb\fP مؤشر قاعدة البيانات .br \fIurl\fP رابط الخادم .RE .PP \fBالنتائج\fP .RS 4 0 عند النجاح، \-1 عند الخطأ (يُضبط pm_errno وفقًا لذلك) .RE .PP .SS "int alpm_db_add_server (alpm_db_t * db, const char * url)" .PP يُضيف خادم تنزيل إلى قاعدة بيانات. .PP \fBالمعاملات\fP .RS 4 \fIdb\fP مؤشر قاعدة البيانات .br \fIurl\fP رابط الخادم .RE .PP \fBالنتائج\fP .RS 4 0 عند النجاح، \-1 عند الخطأ (يُضبط pm_errno وفقًا لذلك) .RE .PP .SS "alpm_list_t * alpm_db_get_cache_servers (const alpm_db_t * db)" .PP يحصل على قائمة خوادم الخبيئة المخصصة لقاعدة البيانات هذه. .PP \fBالمعاملات\fP .RS 4 \fIdb\fP مؤشر إلى قاعدة البيانات لجلب الخوادم منها .RE .PP \fBالنتائج\fP .RS 4 قائمة من نوع char* بالخوادم .RE .PP .SS "alpm_group_t * alpm_db_get_group (alpm_db_t * db, const char * name)" .PP الحصول على مدخل مجموعة من قاعدة بيانات الحزم\&. البحث عن مجموعة هو O(1) وسيكون أسرع بكثير من التكرار عبر خبيئة المجموعة\&. .PP \fBالمعاملات\fP .RS 4 \fIdb\fP مؤشر إلى قاعدة بيانات الحزم لجلب المجموعة منها .br \fIname\fP اسم المجموعة .RE .PP \fBالنتائج\fP .RS 4 مدخل المجموعة عند النجاح، NULL عند الخطأ .RE .PP .SS "alpm_list_t * alpm_db_get_groupcache (alpm_db_t * db)" .PP الحصول على خبيئة المجموعات لقاعدة بيانات الحزم\&. .PP \fBالمعاملات\fP .RS 4 \fIdb\fP مؤشر إلى قاعدة بيانات الحزم لجلب المجموعة منها .RE .PP \fBالنتائج\fP .RS 4 قائمة المجموعات عند النجاح، NULL عند الخطأ .RE .PP .SS "alpm_handle_t * alpm_db_get_handle (alpm_db_t * db)" .PP احصل على مقبض قاعدة بيانات الحزمة\&. .PP \fBالمعاملات\fP .RS 4 \fIdb\fP مؤشر إلى قاعدة بيانات الحزم .RE .PP \fBالنتائج\fP .RS 4 مقبض alpm الذي تنتمي إليه قاعدة بيانات الحزم .RE .PP .SS "const char * alpm_db_get_name (const alpm_db_t * db)" .PP احصل على اسم قاعدة بيانات الحزمة\&. .PP \fBالمعاملات\fP .RS 4 \fIdb\fP مؤشر إلى قاعدة بيانات الحزم .RE .PP \fBالنتائج\fP .RS 4 اسم قاعدة بيانات الحزم، NULL عند الخطأ .RE .PP .SS "alpm_pkg_t * alpm_db_get_pkg (alpm_db_t * db, const char * name)" .PP الحصول على مدخل حزمة من قاعدة بيانات الحزم\&. البحث عن حزمة هو O(1) وسيكون أسرع بكثير من التكرار عبر خبيئة الحزم\&. .PP \fBالمعاملات\fP .RS 4 \fIdb\fP مؤشر إلى قاعدة بيانات الحزم لجلب الحزمة منها .br \fIname\fP اسم الحزمة .RE .PP \fBالنتائج\fP .RS 4 إدخال الحزمة عند النجاح، NULL عند الخطأ .RE .PP .SS "alpm_list_t * alpm_db_get_pkgcache (alpm_db_t * db)" .PP الحصول على خبيئة الحزم لقاعدة بيانات الحزم\&. هذه قائمة بجميع الحزم التي تحتويها قاعدة البيانات\&. .PP \fBالمعاملات\fP .RS 4 \fIdb\fP مؤشر إلى قاعدة بيانات الحزم لجلب الحزمة منها .RE .PP \fBالنتائج\fP .RS 4 قائمة الحزم عند النجاح، NULL عند الخطأ .RE .PP .SS "alpm_list_t * alpm_db_get_servers (const alpm_db_t * db)" .PP الحصول على قائمة الخوادم المخصصة لقاعدة البيانات هذه\&. .PP \fBالمعاملات\fP .RS 4 \fIdb\fP مؤشر إلى قاعدة البيانات لجلب الخوادم منها .RE .PP \fBالنتائج\fP .RS 4 قائمة من نوع char* بالخوادم .RE .PP .SS "int alpm_db_get_siglevel (alpm_db_t * db)" .PP الحصول على مستوى التحقق من التوقيع لقاعدة بيانات\&. سيعيد مستوى التحقق المبدئي إذا كانت قاعدة البيانات هذه مضبوطة بـ ALPM_SIG_USE_DEFAULT\&. .PP \fBالمعاملات\fP .RS 4 \fIdb\fP مؤشر إلى قاعدة بيانات الحزم .RE .PP \fBالنتائج\fP .RS 4 مستوى التحقق من التوقيع .RE .PP .SS "int alpm_db_get_usage (alpm_db_t * db, int * usage)" .PP يحصل على استخدام قاعدة بيانات. .PP \fBالمعاملات\fP .RS 4 \fIdb\fP مؤشر لقاعدة بيانات الحزم للحصول على حالتها .br \fIusage\fP مؤشر إلى \fBalpm_db_usage_t\fP لتخزين حالة قاعدة البيانات .RE .PP \fBالنتائج\fP .RS 4 0 عند النجاح، أو \-1 عند الخطأ .RE .PP .SS "int alpm_db_get_valid (alpm_db_t * db)" .PP التحقق من صحة قاعدة بيانات\&. هذا مفيد جدًا لقواعد بيانات المزامنة والتحقق من حالة التوقيع\&. إذا كانت غير صالحة، سيُضبط رمز خطأ المقبض وفقًا لذلك\&. .PP \fBالمعاملات\fP .RS 4 \fIdb\fP مؤشر إلى قاعدة بيانات الحزم .RE .PP \fBالنتائج\fP .RS 4 0 إذا كانت صالحة، \-1 إذا كانت غير صالحة (يُضبط pm_errno وفقًا لذلك) .RE .PP .SS "int alpm_db_remove_cache_server (alpm_db_t * db, const char * url)" .PP يُزيل خادم خبيئة تنزيل من قاعدة بيانات. .PP \fBالمعاملات\fP .RS 4 \fIdb\fP مؤشر قاعدة البيانات .br \fIurl\fP رابط الخادم .RE .PP \fBالنتائج\fP .RS 4 0 عند النجاح، 1 عند عدم وجود الخادم، \-1 عند الخطأ (يُضبط pm_errno وفقًا لذلك) .RE .PP .SS "int alpm_db_remove_server (alpm_db_t * db, const char * url)" .PP يُزيل خادم تنزيل من قاعدة بيانات. .PP \fBالمعاملات\fP .RS 4 \fIdb\fP مؤشر قاعدة البيانات .br \fIurl\fP رابط الخادم .RE .PP \fBالنتائج\fP .RS 4 0 عند النجاح، 1 عند عدم وجود الخادم، \-1 عند الخطأ (يُضبط pm_errno وفقًا لذلك) .RE .PP .SS "int alpm_db_search (alpm_db_t * db, const alpm_list_t * needles, alpm_list_t ** ret)" .PP البحث في قاعدة بيانات باستخدام تعابير نمطية\&. .PP \fBالمعاملات\fP .RS 4 \fIdb\fP مؤشر لقاعدة بيانات الحزم للبحث فيها .br \fIneedles\fP قائمة بتعبيرات نمطية للبحث عنها .br \fIret\fP مؤشر لقائمة لتخزين الحزم المطابقة لجميع التعبيرات النمطية \- يجب أن يشير إلى \fBalpm_list_t\fP * فارغ (NULL)\&. .RE .PP \fBالنتائج\fP .RS 4 0 عند النجاح، \-1 عند الخطأ (يُضبط pm_errno وفقًا لذلك) .RE .PP .SS "int alpm_db_set_cache_servers (alpm_db_t * db, alpm_list_t * servers)" .PP يضبط قائمة خوادم الخبيئة التي ستستخدمها قاعدة البيانات. .PP \fBالمعاملات\fP .RS 4 \fIdb\fP قاعدة البيانات لتعيين الخوادم\&. ستُنسخ القائمة وستظل القائمة الأصلية بحاجة إلى تحريرها من قبل المستدعي\&. .br \fIservers\fP قائمة من نوع char* بالخوادم\&. .RE .PP .SS "int alpm_db_set_servers (alpm_db_t * db, alpm_list_t * servers)" .PP يضبط قائمة الخوادم التي ستستخدمها قاعدة البيانات. .PP \fBالمعاملات\fP .RS 4 \fIdb\fP قاعدة البيانات لتعيين الخوادم\&. ستُنسخ القائمة وستظل القائمة الأصلية بحاجة إلى تحريرها من قبل المستدعي\&. .br \fIservers\fP قائمة من نوع char* بالخوادم\&. .RE .PP .SS "int alpm_db_set_usage (alpm_db_t * db, int usage)" .PP يضبط استخدام قاعدة بيانات. .PP \fBالمعاملات\fP .RS 4 \fIdb\fP مؤشر لقاعدة بيانات الحزم لتعيين الحالة لها .br \fIusage\fP قناع بت لقيم \fBalpm_db_usage_t\fP .RE .PP \fBالنتائج\fP .RS 4 0 عند النجاح، أو \-1 عند الخطأ .RE .PP .SS "int alpm_db_unregister (alpm_db_t * db)" .PP إلغاء تسجيل قاعدة بيانات حزم\&. لا يمكن إلغاء تسجيل قواعد البيانات عند وجود معاملة نشطة\&. .PP \fBالمعاملات\fP .RS 4 \fIdb\fP مؤشر لقاعدة بيانات الحزم لإلغاء تسجيلها .RE .PP \fBالنتائج\fP .RS 4 0 عند النجاح، \-1 عند الخطأ (يُضبط pm_errno وفقًا لذلك) .RE .PP .SS "int alpm_db_update (alpm_handle_t * handle, alpm_list_t * dbs, int force)" .PP تحديث قواعد بيانات الحزم\&. ستُحاول عملية تحديث لقواعد بيانات الحزم في القائمة \fIdbs\fP\&. ما لم يكن \fIforce\fP صحيحًا، سيُجرى التحديث فقط إذا عُدلت قواعد البيانات البعيدة منذ آخر تحديث\&. .PP تتطلب هذه العملية قفل قاعدة بيانات، وسيُعاد خطأ مناسب إذا تعذر الحصول على القفل\&. .PP مثال: .PP .nf 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)\en"), alpm_strerror(alpm_errno(config\->handle))); } .fi .PP .PP \fBملاحظة\fP .RS 4 بعد تحديث ناجح، ستُبطل \fBخبيئة الحزم\fP .RE .PP \fBالمعاملات\fP .RS 4 \fIhandle\fP مقبض السياق .br \fIdbs\fP قائمة بقواعد بيانات الحزم لتحديثها .br \fIforce\fP إذا كان صحيحًا، يُجبر التحديث، وإلا يُحدّث فقط في حال لم تكن قواعد البيانات محدثة .RE .PP \fBالنتائج\fP .RS 4 0 عند النجاح، \-1 عند الخطأ (يُعيَّن pm_errno وفقًا لذلك)، 1 إذا كانت جميع قواعد البيانات محدَّثة .RE .PP .SS "alpm_db_t * alpm_get_localdb (alpm_handle_t * handle)" .PP احصل على قاعدة بيانات الحزم المُثبَّتة محليًا\&. يُشير المؤشر المُرجَع إلى بنية داخلية لـ libalpm يجب التعامل معها فقط عبر دوال libalpm\&. .PP \fBالنتائج\fP .RS 4 مرجع إلى قاعدة البيانات المحلية .RE .PP .SS "alpm_list_t * alpm_get_syncdbs (alpm_handle_t * handle)" .PP احصل على قائمة قواعد بيانات المزامنة\&. تُرجع قائمة من بنى \fBalpm_db_t\fP، واحدة لكل قاعدة بيانات مزامنة مُسجَّلة\&. .PP \fBالمعاملات\fP .RS 4 \fIhandle\fP مقبض السياق .RE .PP \fBالنتائج\fP .RS 4 مرجع إلى قائمة داخلية من بنى \fBalpm_db_t\fP .RE .PP .SS "alpm_db_t * alpm_register_syncdb (alpm_handle_t * handle, const char * treename, int level)" .PP سجِّل قاعدة بيانات مزامنة للحزم\&. لا يمكن تسجيل قواعد البيانات عند وجود معاملة نشطة\&. .PP \fBالمعاملات\fP .RS 4 \fIhandle\fP مقبض السياق .br \fItreename\fP اسم مستودع المزامنة .br \fIlevel\fP مستوى التحقق من التوقيع الذي سيُجرى على قاعدة البيانات؛ لاحظ أن هذا يجب أن يكون تحققًا من نوع ملف '\&.sig' .RE .PP \fBالنتائج\fP .RS 4 مؤشر alpm_db_t* عند النجاح (القيمة)، NULL عند الخطأ .RE .PP .SS "int alpm_unregister_all_syncdbs (alpm_handle_t * handle)" .PP ألغِ تسجيل جميع قواعد بيانات الحزم\&. لا يمكن إلغاء تسجيل قواعد البيانات أثناء وجود معاملة نشطة\&. .PP \fBالمعاملات\fP .RS 4 \fIhandle\fP مقبض السياق .RE .PP \fBالنتائج\fP .RS 4 0 عند النجاح، \-1 عند الخطأ (يُضبط pm_errno وفقًا لذلك) .RE .PP .SH المؤلف .PP أُنشئ تلقائيًا بواسطة Doxygen لـ libalpm من الكود المصدري\&. .PP .SH ترجمة تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي . .PP هذه الترجمة هي وثيقة مجانية؛ راجع .UR https://www.gnu.org/licenses/gpl-3.0.html رخصة جنو العامة الإصدار 3 .UE أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات. .PP إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: .MT kde-l10n-ar@kde.org .ME .