'\" t
.\"     Title: losetup
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-05-18
.\"    Manual: إدارة النظام
.\"    Source: util-linux 2.42.1
.\"  Language: English
.\"
.TH "LOSETUP" "8" "2026-05-18" "util\-linux 2.42.1" "إدارة النظام"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "الاسم"
losetup \- إعداد والتحكم في أجهزة الحلقة
.SH "موجز"
.sp
إعداد جهاز حلقة:
.sp
\fBlosetup\fP [خيارات] \fB\-f\fP|\fIجهاز_حلقة ملف\fP
.sp
الحصول على المعلومات:
.sp
\fBlosetup\fP [\fB\-l\fP] [\fB\-a\fP|\fIجهاز_حلقة\fP]
.sp
\fBlosetup\fP \fB\-j\fP \fIملف\fP [\fB\-o\fP \fIإزاحة\fP]
.sp
إعادة معايرة حجم جهاز حلقة:
.sp
\fBlosetup\fP \fB\-c\fP \fIloopdev\fP
.sp
فصل أجهزة الحلقة:
.sp
\fBlosetup\fP \fB\-d\fP \fIloopdev\fP .\|.\|.
.sp
\fBlosetup\fP \fB\-D\fP
.sp
منع أجهزة الحلقة من أن تُدرج في القائمة:
.sp
\fBlosetup\fP \fB\-\-remove\fP \fIجهاز_حلقة\fP .\|.\|.
.SH "الوصف"
.sp
يُستخدم \fBlosetup\fP لربط أجهزة الحلقة بملفات عادية أو أجهزة كتلية، ولفصل أجهزة الحلقة، وللاستعلام عن حالة جهاز الحلقة. إذا أُعطي المعامل \fIloopdev\fP فقط، تُعرض حالة جهاز الحلقة المقابل. وإذا لم يُعطَ أي خيار، تُعرض جميع أجهزة الحلقة.
.sp
لاحظ أن تنسيق المخرج القديم (أي \fBlosetup \-a\fP) ذو السلاسل النصية المفصولة بفاصلة مهجور لصالح تنسيق المخرج \fB\-\-list\fP.
.sp
من الممكن إنشاء عدة أجهزة حلقة مستقلة لنفس ملف النسخ الاحتياطي. \fBهذا الإعداد قد يكون خطيراً، ويمكن أن يسبب فقداناً للبيانات وفساداً وتجاوزاً للكتابة.\fP استخدم \fB\-\-nooverlap\fP مع \fB\-\-find\fP أثناء الإعداد لتجنب هذه المشكلة.
.sp
إعداد جهاز الحلقة ليس عملية ذرية عند استخدامه مع \fB\-\-find\fP، ولا يحمي \fBlosetup\fP هذه العملية بأي قفل. عدد المحاولات مقيد داخلياً بحد أقصى 16. يُوصى باستخدام \fBflock\fP(1) مثلاً لتجنب التصادم في حالات الاستخدام المتوازي بكثافة.
.SH "الخيارات"
.sp
يمكن أن يتبع معاملات الحجم (\fIحجم\fP) والإزاحة (\fIإزاحة\fP) لواحق مضاعفة 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.
.sp
\fB\-a\fP، \fB\-\-all\fP
.RS 4
تُعرض حالة جميع أجهزة الحلقة. لاحظ أنه لا يمكن للمستخدمين غير الجذر (non\-root) الوصول إلى جميع المعلومات. انظر أيضاً \fB\-\-list\fP. تنسيق المخرج القديم (كما يُطبع دون \fB\-\-list\fP) مهجور.
.RE
.sp
\fB\-d\fP، \fB\-\-detach\fP \fIloopdev\fP.\|.\|.
.RS 4
فصل الملف أو الجهاز المرتبط بجهاز (أجهزة) الحلقة المحددة. لاحظ أنه منذ الإصدار v3.7 من نواة لينكس تُستخدم تقنية "تدمير الجهاز الكسول". عملية الفصل لم تعد تُرجع خطأ \fBEBUSY\fP إذا كان الجهاز مستخدماً بنشاط من قبل النظام، ولكن تُوضع عليه علامة التصفية الآلية ويُدمر لاحقاً. وحتى لو لم يكن الجهاز مستخدماً، يمكن تدمير جهاز الحلقة لاحقاً. إذا كنت بحاجة إلى انتظار الإزالة الكاملة لجهاز الحلقة، استدعِ \fBudevadm settle\fP بعد \fBlosetup\fP.
.RE
.sp
\fB\-D\fP، \fB\-\-detach\-all\fP
.RS 4
تُفصل جميع أجهزة الحلقة المرتبطة.
.RE
.sp
\fB\-f\fP، \fB\-\-find\fP [\fIملف\fP]
.RS 4
يُبحث عن أول جهاز حلقة غير مستخدم. إذا وُجد معامل \fIملف\fP، يُستخدم الجهاز الذي عُثر عليه كجهاز حلقة. بخلاف ذلك، يُطبع اسمه فقط.
.RE
.sp
\fB\-\-show\fP
.RS 4
يُعرض اسم جهاز الحلقة المعين إذا وُجد الخيار \fB\-f\fP ومعامل \fIملف\fP.
.RE
.sp
\fB\-L\fP، \fB\-\-nooverlap\fP
.RS 4
التحقق من وجود تعارضات بين أجهزة الحلقة لتجنب الموقف الذي يتم فيه مشاركة ملف النسخ الاحتياطي نفسه بين أكثر من جهاز حلقة. إذا كان الملف مستخدماً بالفعل بواسطة جهاز آخر، فأعد استخدام الجهاز بدلاً من إنشاء جهاز جديد. هذا الخيار منطقي فقط مع \fB\-\-find\fP.
.RE
.sp
\fB\-j\fP، \fB\-\-associated\fP \fIملف\fP [\fB\-o\fP \fIإزاحة\fP]
.RS 4
تُعرض حالة جميع أجهزة الحلقة المرتبطة بالملف (\fIملف\fP) المعطى.
.RE
.sp
\fB\-o\fP، \fB\-\-offset\fP \fIالإزاحة\fP
.RS 4
تُحرك بداية البيانات بمقدار \fIإزاحة\fP بايت داخل الملف أو الجهاز المحدد. يمكن أن يتبع \fIإزاحة\fP لواحق مضاعفة؛ انظر أعلاه.
.RE
.sp
\fB\-\-loop\-ref\fP \fIسلسلة_محارف\fP
.RS 4
اضبط سلسلة المرجع. المبدئي المتوافق مع الإصدارات السابقة هو استخدام اسم ملف النسخ الاحتياطي كمرجع في ioctl لإعداد الحلقة (المعروف باسم lo_file_name). يتجاوز هذا الخيار هذا السلوك المبدئي ويضبط المرجع على الـ \fIسلسلة\fP. يمكن استخدام المرجع بواسطة udevd في /dev/loop/by\-ref. لا تستخدم نواة لينكس المرجع على الإطلاق، ولكن يمكن استخدامه بواسطة بعض الأدوات القديمة التي لا تستطيع قراءة ملف النسخ الاحتياطي من sysfs. المرجع قابل للقراءة فقط للمستخدم الجذر (انظر \fB\-\-output\fP +REF) وهو محدود بـ 64 بايت.
.RE
.sp
\fB\-\-sizelimit\fP \fIحجم\fP
.RS 4
تُضبط نهاية البيانات بما لا يتجاوز \fIحجم\fP بايت بعد بداية البيانات. يمكن أن يتبع \fIحجم\fP لواحق مضاعفة؛ انظر أعلاه.
.RE
.sp
\fB\-b\fP، \fB\-\-sector\-size\fP \fIحجم\fP
.RS 4
ضبط حجم القطاع المنطقي لجهاز الحلقة بالبايت (منذ لينكس 4.14). يمكن استخدام الخيار عند إنشاء جهاز حلقة جديد وكذلك كأمر مستقل لتعديل حجم قطاع جهاز حلقة موجود بالفعل.
.RE
.sp
\fB\-c\fP، \fB\-\-set\-capacity\fP \fIloopdev\fP
.RS 4
يُجبر برنامج تشغيل الحلقة على إعادة قراءة حجم الملف المرتبط بجهاز الحلقة المحدد.
.RE
.sp
\fB\-P\fP، \fB\-\-partscan\fP
.RS 4
إجبار النواة على مسح جدول الأقسام على جهاز حلقة تم إنشاؤه حديثاً. لاحظ أن تحليل جدول الأقسام يعتمد على أحجام القطاعات. الحجم المبدئي للقطاع هو 512 بايت، وإلا فستحتاج إلى استخدام الخيار \fB\-\-sector\-size\fP جنباً إلى جنب مع \fB\-\-partscan\fP.
.RE
.sp
\fB\-r\fP، \fB\-\-read\-only\fP
.RS 4
يُعد جهاز حلقة للقراءة فقط.
.RE
.sp
\fB\-\-direct\-io\fP[\fB=on\fP|\fBoff\fP]
.RS 4
تمكين أو تعطيل الإدخال/الإخراج المباشر لملف النسخ الاحتياطي. المبدئي هو \fBoff\fP. سيؤدي تحديد \fB\-\-direct\-io\fP أو \fB\-\-direct\-io=on\fP إلى تمكينه. ولكن، يمكن توفير \fB\-\-direct\-io=off\fP لإيقاف تشغيله صراحةً.
.RE
.sp
\fB\-l\fP، \fB\-\-list\fP
.RS 4
إذا حُدد جهاز حلقة أو الخيار \fB\-a\fP، فستُطبع الأعمدة المبدئية إما لجهاز الحلقة المحدد أو لجميع أجهزة الحلقة؛ المبدئي هو طباعة معلومات حول جميع الأجهزة. انظر أيضاً \fB\-\-output\fP، و \fB\-\-noheadings\fP، و \fB\-\-raw\fP، و \fB\-\-json\fP.
.RE
.sp
\fB\-O\fP، \fB\-\-output\fP \fIعمود\fP[,\fI‎عمود\fP].\|.\|.
.RS 4
تحديد الأعمدة التي ستُطبع لمخرجات \fB\-\-list\fP. استخدم \fB\-\-help\fP للحصول على قائمة بجميع الأعمدة المتاحة.
.RE
.sp
\fB\-\-output\-all\fP
.RS 4
أخرج كافة الأعمدة المتاحة.
.RE
.sp
\fB\-n\fP، \fB\-\-noheadings\fP
.RS 4
عدم طباعة العناوين لتنسيق مخرجات \fB\-\-list\fP.
.RE
.sp
\fB\-\-raw\fP
.RS 4
يُستخدم تنسيق المخرج الخام لـ \fB\-\-list\fP.
.RE
.sp
\fB\-J\fP، \fB\-\-json\fP
.RS 4
يُستخدم تنسيق JSON لمخرج \fB\-\-list\fP.
.RE
.sp
\fB\-\-remove\fP \fIجهاز_حلقة\fP.\|.\|.
.RS 4
أزل جهاز (أو أجهزة) الحلقة المحددة. يجب أن يكون جهاز الحلقة غير مستخدم (غير مرتبط بأي ملف نسخ احتياطي). يزيل هذا الخيار عقدة الجهاز من النظام. في معظم الحالات، يكون \fB\-\-detach\fP كافياً للاستخدام العادي. انظر قسم \fBدورة حياة جهاز الحلقة\fP أدناه.
.RE
.sp
\fB\-h\fP، \fB\-\-help\fP
.RS 4
اعرض نص المساعدة ثم اخرج.
.RE
.sp
\fB\-V\fP، \fB\-\-version\fP
.RS 4
اعرض الإصدار واخرج.
.RE
.SH "دورة حياة جهاز الحلقة"
.sp
تمر أجهزة الحلقة بعدة حالات خلال دورة حياتها:
.sp
\fBإنشاء\fP
.RS 4
عندما يربط \fBlosetup\fP جهاز حلقة بملف نسخ احتياطي، فإنه ينشئ عقدة الجهاز آلياً (مثلاً، \fI/dev/loop0\fP) إذا لم تكن موجودة بالفعل. يحدث هذا عند الطلب عند استخدام خيارات مثل \fB\-f\fP أو تحديد جهاز حلقة صراحةً. وُشئ الجهاز باستخدام ioctl المسمى \fBLOOP_CTL_ADD\fP.
.RE
.sp
\fBفصل\fP
.RS 4
يفصل الخيار \fB\-d\fP (\fB\-\-detach\fP) ملف النسخ الاحتياطي عن جهاز الحلقة باستخدام ioctl المسمى \fBLOOP_CLR_FD\fP. بعد الفصل، تبقى عقدة جهاز الحلقة في \fI/dev\fP ويمكن إعادة استخدامها لملف نسخ احتياطي آخر. استخدم \fBlsblk \-a\fP لرؤية جميع عقد أجهزة الحلقة، بما في ذلك غير المستخدمة.
.RE
.sp
\fBإزالة\fP
.RS 4
يزيل الخيار \fB\-\-remove\fP عقدة جهاز الحلقة تماماً من النظام باستخدام ioctl المسمى \fBLOOP_CTL_REMOVE\fP. يجب فصل الجهاز أولاً (ألا يكون مرتبطاً بأي ملف نسخ احتياطي). بعد الإزالة، تختفي عقدة الجهاز من \fI/dev\fP.
.RE
.SH "التعمية"
.sp
\fBلم يعد Cryptoloop متاحاً لصالح dm\-crypt.\fP لمزيد من التفاصيل انظر \fBcryptsetup\fP(8).
.SH "حالة الخروج"
.sp
يُرجع \fBlosetup\fP القيمة 0 عند النجاح، وقيمة غير صفرية عند الفشل. عندما يعرض \fBlosetup\fP حالة جهاز حلقة، فإنه يُرجع 1 إذا كان الجهاز غير مضبوط، و2 إذا حدث خطأ منع من تحديد حالة الجهاز.
.SH "ملاحظات"
.sp
منذ الإصدار 2.37 يستخدم \fBlosetup\fP تقنية \fBLOOP_CONFIGURE\fP ioctl لإعداد جهاز حلقة جديد بواسطة نداء ioctl واحد. تستخدم الإصدارات القديمة \fBLOOP_SET_FD\fP و \fBLOOP_SET_STATUS64\fP ioctls للقيام بنفس الشيء.
.SH "البيئة"
.sp
\fBLOOPDEV_DEBUG\fP=all
.RS 4
يفعّل مخرجات التنقيح.
.RE
.sp
\fBLIBSMARTCOLS_DEBUG\fP=all
.RS 4
يُفعّل مخرجات تصحيح أخطاء libsmartcols.
.RE
.sp
\fBLIBSMARTCOLS_DEBUG_PADDING\fP=on
.RS 4
يستخدم محارف حشو مرئية.
.RE
.SH "الملفات"
.sp
\fI/dev/loop[0..N]\fP
.RS 4
أجهزة كتلية حلقية
.RE
.sp
\fI/dev/loop\-control\fP
.RS 4
جهاز التحكم بالحلقة
.RE
.SH "مثال"
.sp
يمكن استخدام الأوامر التالية كمثال على استخدام جهاز الحلقة.
.sp
.if n .RS 4
.nf
.fam C
# dd if=/dev/zero of=~/file.img bs=1024k count=10
# losetup \-\-find \-\-show ~/file.img
/dev/loop0
# mkfs \-t ext2 /dev/loop0
# mount /dev/loop0 /mnt
\&...
# umount /dev/loop0
# losetup \-\-detach /dev/loop0
.fam
.fi
.if n .RE
.SH "المؤلفين"
.sp
.MTO "kzak\(atredhat.com" "Karel Zak" "،"
بناءً على الإصدارة الأصلية من
.MTO "tytso\(atathena.mit.edu" "Theodore Ts\(cqo" "."
.SH "التبليغ عن الأخطاء"
.sp
لتقارير العِلل، استخدم \c
.URL "https://github.com/util\-linux/util\-linux/issues" "مُتتبع المشكلات" "."
.SH "التوفر"
.sp
الأمر \fBlosetup\fP جزء من حزمة util\-linux التي يمكن تنزيلها من \c
.URL "https://www.kernel.org/pub/linux/utils/util\-linux/" "أرشيف نواة لينكس" "."