الاسم

blkzone - تشغيل أمر المنطقة على جهاز ما

موجز

blkzone أمر [خيارات] جهاز

الوصف

يُستخدم blkzone لتشغيل أمر المنطقة على جهاز يدعم أوامر الكتل المنطقية (ZBC) أو أوامر ATA للأجهزة المنطقية (ZAC). يمكن تحديد المناطق المراد العمل عليها باستخدام خيارات الإزاحة، والعدد، والطول.

معطى جهاز هو مسار الجهاز الكتلي.

الأوامر

report

يُستخدم الأمر blkzone report للإبلاغ عن معلومات منطقة الجهاز.

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

مخرجات التقرير:

 start      قطاع بداية المنطقة
 len        طول المنطقة بعدد القطاعات
 cap        سعة المنطقة بعدد القطاعات
 wptr       موضع مؤشر كتابة المنطقة
 reset      يُوصى بإعادة ضبط مؤشر الكتابة
 non-seq    موارد الكتابة غير المتسلسلة نشطة
 cond       حالة المنطقة
 type       نوع المنطقة

حالات المنطقة:

 cl    مغلقة
 nw    ليست مؤشر كتابة
 em    فارغة
 fu    ممتلئة
 oe    مفتوحة صراحةً
 oi    مفتوحة ضمنياً
 ol    غير متصلة
 ro    للقراءة فقط
 xN    حالات محجوزة (لا ينبغي الإبلاغ عنها)

capacity

يُستخدم الأمر blkzone capacity للإبلاغ عن معلومات سعة الجهاز.

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

reset

يُستخدم الأمر blkzone reset لإعادة ضبط منطقة واحدة أو أكثر. وعلى عكس sg_reset_wp(8)، يعمل هذا الأمر من الطبقة الكتلية ويمكنه إعادة ضبط نطاق من المناطق.

open

يُستخدم الأمر blkzone open لفتح منطقة واحدة أو أكثر صراحةً. وعلى عكس إجراء الفتح في sg_zone(8)، يعمل هذا الأمر من الطبقة الكتلية ويمكنه فتح نطاق من المناطق.

close

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

finish

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

ستعمل أوامر reset و open و close و finish مبدئيًا من المنطقة الموجودة عند القطاع 0 في الجهاز وتطبق على كافة المناطق. يمكن استخدام الخيارات لتعديل هذا السلوك كما هو موضح أدناه.

الخيارات

يمكن أن تتبع وسيطات الخيارين إزاحة و طول لواحق مضاعفة مثل KiB (=1024)، و MiB (=1024*1024)، وهكذا بالنسبة لـ GiB و TiB و PiB و EiB و ZiB و YiB (اللاحقة "iB" اختيارية، فمثلًا "K" لها نفس معنى "KiB") أو اللواحق KB (=1000)، و MB (=1000*1000)، وهكذا بالنسبة لـ GB و TB و PB و EB و ZB و YB. بالإضافة إلى ذلك، يمكن استخدام البادئة 0x لتحديد إزاحة و طول بالنظام الست عشري.

-o، --offset قطاع

منطقة البداية المحددة كإزاحة للقطاع. يجب أن تطابق الإزاحة المقدمة بوحدات القطاع (512 بايت) بداية منطقة ما. القيمة المبدئية هي صفر.

-l، --length قطاعات

العدد الأقصى للقطاعات التي يجب أن يعمل عليها الأمر. القيمة المبدئية هي عدد القطاعات المتبقية بعد إزاحة. لا يمكن استخدام هذا الخيار مع الخيار --count.

-c، --count count

العدد الأقصى للمناطق التي يجب أن يعمل عليها الأمر. القيمة المبدئية هي عدد المناطق بدءًا من إزاحة. لا يمكن استخدام هذا الخيار مع الخيار --length.

-f، --force

فرض الأوامر لتغيير حالة المنطقة على الأجهزة الكتلية المستخدمة بواسطة النظام.

-v، --verbose

عرض عدد المناطق المرجعة في التقرير أو نطاق القطاعات المعاد ضبطها.

-h، --help

اعرض نص المساعدة ثم اخرج.

-V، --version

اعرض الإصدار واخرج.

المؤلفين

Shaun Tancheff <shaun@tancheff.com>, Karel Zak <kzak@redhat.com>

انظر أيضاً

sg_rep_zones(8)

التبليغ عن الأخطاء

لتقارير العِلل، استخدم مُتتبع المشكلات https://github.com/util-linux/util-linux/issues.

التوفر

الأمر blkzone جزء من حزمة util-linux التي يمكن تنزيلها من أرشيف نواة لينكس https://www.kernel.org/pub/linux/utils/util-linux/.