متطلبات الواجهة

تصف هذه الصفحة مجموعة فرعية من واجهات نواة Linux التي يستخدمها على العمل بشكل صحيح. ويعد وجود هذه الواجهات وصحتها اختباره كجزء من حزمة اختبار البائعين (VTS): سيزداد عدد هذه المجموعة الفرعية بمرور الوقت لاحتواء جزء أكبر من واجهات نواة Android.

طلبات النظام

من المتوقّع أن توفّر جميع طلبات النظام التوقيعات والدلالات نفسها المُستخدَمة في جميع استدعاءات النظام في نواة Linux الرئيسية للإصدار نفسه.

PRCTl

بالإضافة إلى عمليات prctl الرئيسية لعمليات الدعم بإصدارات النواة kernel، يعتمد Android على عمليات prctl إضافية، والتي يمكن العثور عليها في الكيرنل (النواة android-common).

PR_SET_TIMERSLACK_PID
PR_SET_VMA

أنظمة الملفات

يصدِّر نواة Linux الواجهات عبر أنظمة ملفات متعددة. يتوقع Android هذه الواجهات لإيصال المعلومات نفسها، وبالتنسيق ذاته توفير نفس الدلالة كما في نواة Linux الرئيسية. بالنسبة إلى الواجهات التي لم تكن موجودة قبل التنفيذ، فيتم تحديد السلوك المناسب حسب أحد فروع النواة العامة لنظام Android.

Procfs

الواجهة	الوصف
/proc/asound/	ملف للقراءة فقط يعرض قائمة ببرامج تشغيل ALSA التي تم إعدادها حاليًا
/proc/cmdline	ملف للقراءة فقط يحتوي على وسيطات سطر الأوامر التي تم تمريرها إلى النواة.
/proc/config.gz	ملف للقراءة فقط يحتوي على إعدادات إصدار النواة.
/proc/cpuinfo	ملف للقراءة فقط يحتوي على تفاصيل وحدة المعالجة المركزية الخاصة بالبنية.
/proc/diskstats	ملف للقراءة فقط يعرض إحصاءات وحدات الإدخال والإخراج للأجهزة المحظورة
/proc/filesystems	أنظمة ملفات قائمة الملفات للقراءة فقط المتوافقة حاليًا مع النواة (النواة).
/proc/kmsg	ملف للقراءة فقط يعرض رسائل النواة في الوقت الفعلي
/proc/loadavg	ملف للقراءة فقط يعرض متوسط حِمل وحدة المعالجة المركزية (CPU) ووحدات الإدخال الداخلية بمرور الوقت
/proc/meminfo	ملف للقراءة فقط يعرض تفاصيل النظام الفرعي للذاكرة.
/proc/misc	ملف للقراءة فقط يسرد برامج تشغيل متنوعة مسجلة في أجهزة رئيسية متنوعة.
/proc/modules	ملف للقراءة فقط يحتوي على معلومات حول وحدات النواة التي تم تحميلها.
/proc/mounts	رابط رمزي إلى /proc/self/mounts، وهو ملف للقراءة فقط قائمة المعلومات حول أنظمة الملفات المثبتة.
/proc/net	دليل يحتوي على مجموعة متنوعة من مَعلمات تكديس الشبكة
/proc/net/xt_qtaguid/	ملف للقراءة والكتابة يقدّم معلومات حول المقابس ذات العلامات
/proc/pagetypeinfo	ملف للقراءة فقط يحتوي على معلومات تخصيص الصفحة
/proc/stat	ملف للقراءة فقط يحتوي على إحصاءات النظام والنواة المتنوعة.
/proc/swaps	ملف للقراءة فقط يعرض استخدام مساحة التبديل. هذا الملف اختيارية يتم التحقق من محتواها وأذوناتها في VTS فقط في حال توفُّر الملف
/proc/sys/abi/swp	ملف للقراءة والكتابة الذي يحدد سلوك ARM القديم لعملية محو بيانات المستخدم.
/proc/sys/fs/pipe-max-size	ملف قراءة وكتابة يبلِّغ عن الحد الأقصى لحجم المورد الاحتياطي الفردي للأنبوب.
/proc/sys/fs/protected_hardlinks	ملف للقراءة والكتابة يتحكّم في طريقة إنشاء الروابط الثابتة.
/proc/sys/fs/protected_symlinks	ملف للقراءة والكتابة يتحكم في طريقة إنشاء رموز .
/proc/sys/fs/suid_dumpable	ملف للقراءة والكتابة يتحكّم في وضع التفريغ الأساسي لـ setuid أو غير ذلك البرامج الثنائية المحمية/الملوثة.
/proc/sys/kernel/core_pattern	يشير إلى ملف القراءة والكتابة الذي يحدّد نمط اسم ملف التفريغ الأساسي.
/proc/sys/kernel/core_pipe_limit	ملف للقراءة والكتابة الذي يحدد عدد عمليات التعطّل المتزامنة التي قد تحدث التوجيه إلى تطبيقات المستخدم بالتوازي.
/proc/sys/kernel/dmesg_restrict	ملف خاص بالقراءة والتعديل يتحكّم في إمكانية وصول المستخدمين غير المميّزين dmesg.
/proc/sys/kernel/domainname	ملف قراءة وكتابة يحتوي على اسم مجال YP/NIS للنظام.
/proc/sys/kernel/hostname	ملف للقراءة والكتابة يحدّد اسم المضيف للنظام.
/proc/sys/kernel/hung_task_timeout_secs	ملف "القراءة والكتابة" الذي يتحكّم في المهلة المستخدَمة لتحديد وقت مهمة لم يعد مستجيبًا وينبغي اعتباره معلقًا. هذا الملف اختيارية؛ يتم التحقّق من محتواها وأذوناتها في VTS فقط في حال إذا كان الملف متوفّرًا
/proc/sys/kernel/kptr_restrict	ملف قراءة وكتابة يحدد ما إذا كانت مؤشرات النواة ستتم طباعتها في proc من الملفات والواجهات الأخرى.
/proc/sys/kernel/modules_disabled	ملف للقراءة والكتابة يتحكّم في إمكانية تحميل وحدات الكيرنل (النواة).
/proc/sys/kernel/panic_on_oops	ملف للقراءة والكتابة يتحكّم في سلوك النواة على عذرًا.
/proc/sys/kernel/perf_event_max_sample_rate	ملف للقراءة والكتابة يتحكم في الحد الأقصى لمعدل عينة الأداء أحداث.
/proc/sys/kernel/perf_event_paranoid	ملف القراءة والكتابة الذي يتحكّم في استخدام نظام أحداث الأداء من قبل المستخدمين غير المهمين.
/proc/sys/kernel/pid_max	ملف للقراءة والكتابة الذي يحتوي على قيمة التفاف تخصيص PID
/proc/sys/kernel/random/boot_id	ملف للقراءة فقط يحتوي على رقم تعريف عشوائي جديد في كل عملية تشغيل.
/proc/sys/kernel/randomize_va_space	ملف للقراءة والكتابة يحدّد سياسة التوزيع العشوائي لتنسيق العنوان للنظام.
/proc/sys/kernel/sched_child_runs_first	ملف القراءة والكتابة الذي يتحكّم في ما إذا كانت المهام التي يتم تنفيذها بشكل متشعّب سيتم تفضيلها في وجدولتهم على مهامهم الرئيسية.
/proc/sys/kernel/sched_latency_ns	ملف قراءة وكتابة يحتوي على الحد الأقصى لوقت الاستجابة بالنانو ثانية قد تحدث قبل الموعد المحدد لها.
/proc/sys/kernel/sched_rt_period_us	ملف للقراءة والكتابة والذي يحتوي على طول النقطة المستخدم في الوقت الفعلي على مستوى النظام الحد المسموح به للتنفيذ بالميكرو ثانية.
/proc/sys/kernel/sched_rt_runtime_us	ملف القراءة والكتابة الذي يحتوي على مقدار الوقت، نسبة sched_rt_period_us، أن النظام قد يقوم بتنفيذ مهام RT.
/proc/sys/kernel/sched_tunable_scaling	ملف القراءة والكتابة الذي يتحكم في ما إذا كان يجب استخدام sched_latency_ns يتم تعديلها تلقائيًا بواسطة أداة الجدولة بناءً على عدد وحدات المعالجة المركزية (CPU).
/proc/sys/kernel/sched_wakeup_granularity_ns	ملف للقراءة والتعديل يحتوى على مقدار إضافي من مهمة بيئة التشغيل الافتراضية (أ) أكثر من المهمة "ب" في نانو ثانية للمهمة "ب" لاستباقها.
/proc/sys/kernel/sysrq	ملف للقراءة والكتابة يتحكّم في الدوال المسموح باستدعاءها عبر مفتاح sysrq.
/proc/sys/net/*	دليل يحتوي على مجموعة متنوعة من مَعلمات تكديس الشبكة
/proc/sysrq-trigger	ملف للكتابة فقط يمكن استخدامه لبدء دوال sysrq
/proc/sys/vm/dirty_background_ratio	ملف للقراءة والكتابة يحتوي على، كنسبة مئوية من إجمالي الذاكرة المتاحة (الصفحات المجانية والصفحات القابلة للاسترداد)، وعدد الصفحات التي تبدأ سلاسل بروتوكول نواة الخلفية في كتابة بيانات غير نظيفة.
/proc/sys/vm/dirty_expire_centisecs	ملف قراءة وكتابة يحدد متى تكون البيانات غير النظيفة قديمة بما يكفي لتكون مؤهلة للكتابة باستخدام سلاسل نواة الملاحظات
/proc/sys/vm/drop_caches	ملف للقراءة والكتابة يمكن استخدامه لفرض إزالة النواة من النواة ذاكرات التخزين المؤقت.
/proc/sys/vm/extra_free_kbytes	ملف قراءة/كتابة يمكن استخدامه للاحتفاظ بذاكرة فارغة إضافية بين الحد الذي يبدأ فيه استرداد الخلفية (kswapd)، بالإضافة إلى حيث تبدأ عملية الاسترداد المباشرة (عن طريق تخصيص العمليات). هذا الملف اختيارية؛ يتم التحقّق من محتواها وأذوناتها في VTS فقط في حال إذا كان الملف متوفّرًا
/proc/sys/vm/max_map_count	ملف للقراءة والكتابة الذي يحتوي على الحد الأقصى لعدد مناطق خريطة الذاكرة العملية.
/proc/sys/vm/mmap_min_addr	ملف للقراءة والكتابة يحدّد الحد الأدنى للعنوان mmap.
/proc/sys/vm/mmap_rnd_bits	ملف قراءة وكتابة يحدد مقدار العشوائية في عناوين mmap.
/proc/sys/vm/mmap_rnd_compat_bits	ملف قراءة وكتابة يحدد مقدار العشوائية في عناوين mmap.
/proc/sys/vm/overcommit_memory	ملف للقراءة والكتابة والذي يحدد حساب الذاكرة الافتراضية في النواة الحالي.
/proc/sys/vm/page-cluster	ملف للقراءة والكتابة يتحكم في عدد الصفحات التي تتم قراءة الصفحات المتتالية من التبديل في محاولة واحدة.
/proc/uid_cputime/remove_uid_range	ملف للكتابة فقط، وعند كتابته، يزيل المعرفات الفريدة (UID) من الظهور في /proc/uid_cputime/show_uid_stat
/proc/uid_cputime/show_uid_stat	ملف للقراءة فقط يتضمن الوقت المستغرَق في عمليات UID للمستخدم مساحة kernel.
/proc/uid_io/stats	ملف للقراءة فقط يحتوي على قائمة بإحصائيات وحدات الإدخال والإخراج لكل UID في النظامية
/proc/uid_procstat/set	ملف للكتابة فقط يُستخدَم لضبط معرّف فريد كمقدّمة أو خلفية
/proc/uid_time_in_state	ملف للقراءة فقط يتضمن الوقت الذي تستغرقه كل عمليات UID في التنفيذ في لكل معدل تكرار متاح. هذا الملف اختياري، ومحتواها يتم التحقّق من الأذونات في VTS فقط في حال توفّر الملف.
/proc/uptime	ملف للقراءة فقط يعرض مدة تشغيل النظام.
/proc/version	ملف للقراءة فقط يحتوي على سلسلة تصف إصدار الكيرنل (النواة).
/proc/vmallocinfo	ملف للقراءة فقط يحتوي على نطاقات vmalloc.
/proc/vmstat	ملف للقراءة فقط يحتوي على إحصاءات الذاكرة الظاهرية من النواة.
/proc/zoneinfo	ملف للقراءة فقط يحتوي على معلومات حول مناطق الذاكرة

المطوّر

الواجهة	الوصف
/dev/ashmem	ملف مجهول لجهاز الذاكرة المشترك
/dev/binder	ربط ملف الجهاز
/dev/hwbinder	ملف تثبيت الجهاز
/dev/tun	ملف جهاز TUN/TAP عام.
/dev/xt_qtaguid	ملف QTAGUID لجهاز netfilter.

نظام sysfs

الواجهة	الوصف
/sys/class/net/*/mtu	ملف للقراءة والكتابة يتضمّن الحد الأقصى لوحدة الإرسال في كل من واجهة pyplot.
/sys/class/rtc/*/hctosys	ملف للقراءة فقط يعرض ما إذا كان هناك برنامج RTC معيّن يوفِّر وقت النظام عند التمهيد واستئناف التشغيل.
/sys/devices/system/cpu/	الدليل الذي يحتوي على معلومات حول تكوين وحدة المعالجة المركزية (CPU) والتردد.
/sys/kernel/wakeup_reasons	دليل الملفات للقراءة فقط التي تحتوي على وقت التعليق الأخير والسيرة الذاتية السبب.
/sys/power/state	ملف للقراءة والكتابة يتحكّم في حالات سكون النظام.
/sys/power/wake_lock	ملف للقراءة والكتابة الذي يحتوي على عمليات قفل التنشيط النشطة
/sys/power/wake_unlock	ملف للقراءة والكتابة الذي يحتوي على عمليات قفل تنشيط غير نشطة
/sys/power/wakeup_count	ملف للقراءة والكتابة يمكن استخدامه لوضع النظام في حالة السكون مع مراعاة الوصول المتزامن لأحداث الاستيقاظ.

سيلينوكس

يتم تثبيت إطار العمل selinuxfs في /sys/fs/selinux.

المسار	الوصف
/sys/fs/selinux/checkreqprot	قراءة/كتابة ملف يحتوي على علامة ثنائية تحدد كيفية استخدام selinux يتم التحقّق من إجراءات الحماية في مكالمات mmap وmprotect.
/sys/fs/selinux/null	قراءة/كتابة جهاز فارغ للاستخدام بواسطة selinux.
/sys/fs/selinux/policy	ملف للقراءة فقط يحتوي على سياسة selinux في شكل ثنائي.