'\" t
.\"     Title: losetup
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-06-16
.\"    Manual: System Administration
.\"    Source: util-linux 2.41.5
.\"  Language: Persian
.\"
.TH "LOSETUP" "8" "2026-06-16" "util\-linux 2.41.5" "System Administration"
.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 "نام (NAME)"
losetup \- راه‌اندازی و کنترل دستگاه‌های حلقه (Loop Devices)
.SH "خلاصه دستور (SYNOPSIS)"
.sp
دریافت اطلاعات:
.sp
\fBlosetup\fP [\fIloopdev\fP]
.sp
\fBlosetup\fP \fB\-l\fP [\fB\-a\fP]
.sp
\fBlosetup\fP \fB\-j\fP \fIfile\fP [\fB\-o\fP \fIoffset\fP]
.sp
جدا کردن یک دستگاه حلقه:
.sp
\fBlosetup\fP \fB\-d\fP \fIloopdev\fP .\|.\|.
.sp
جدا کردن تمام دستگاه‌های حلقه مرتبط:
.sp
\fBlosetup\fP \fB\-D\fP
.sp
راه‌اندازی یک دستگاه حلقه:
.sp
\fBlosetup\fP [\fB\-o\fP \fIoffset\fP] [\fB\-\-sizelimit\fP \fIsize\fP] [\fB\-\-sector\-size\fP \fIsize\fP] [\fB\-\-loop\-ref\fP \fIname\fP] [\fB\-Pr\fP] [\fB\-\-show\fP] \fB\-f\fP|\fIloopdev file\fP
.sp
تغییر اندازه یک دستگاه حلقه:
.sp
\fBlosetup\fP \fB\-c\fP \fIloopdev\fP
.SH "توضیحات (DESCRIPTION)"
.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 این عملیات را با هیچ قفلی محافظت نمی‌کند. تعداد تلاش‌ها در داخل برنامه به حداکثر ۱۶ محدود شده است. توصیه می‌شود برای جلوگیری از تداخل در موارد استفاده به شدت موازی، به عنوان مثال از \fBflock\fP(1) استفاده شود.
.SH "گزینه‌ها (OPTIONS)"
.sp
پسوندهای ضرب‌شونده 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 می‌توانند پس از آرگومان‌های \fIsize\fP و \fIoffset\fP بیایند.
.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
جدا کردن پرونده یا دستگاه مرتبط با دستگاه(های) حلقه مشخص‌شده. توجه داشته باشید که از نسخه 3.7 لینوکس، هسته از «تخریب تنبل دستگاه» (lazy device destruction) استفاده می‌کند. عملیات جدا کردن در صورتی که دستگاه به طور فعال توسط سیستم استفاده شود، دیگر خطای \fBEBUSY\fP بازنمی‌گرداند، بلکه با پرچم autoclear علامت‌گذاری شده و بعداً نابود می‌شود. حتی اگر از دستگاه استفاده نشود، دستگاه حلقه می‌تواند بعداً نابود شود. اگر نیاز دارید منتظر حذف کامل دستگاه حلقه بمانید، پس از \fBlosetup\fP دستور \fBudevadm settle\fP را فراخوانی کنید.
.RE
.sp
\fB\-D\fP, \fB\-\-detach\-all\fP
.RS 4
جدا کردن تمام دستگاه‌های حلقه مرتبط.
.RE
.sp
\fB\-f\fP, \fB\-\-find\fP [\fIfile\fP]
.RS 4
یافتن نخستین دستگاه حلقه استفاده‌نشده. اگر یک آرگومان \fIfile\fP وجود داشته باشد، از دستگاه یافته‌شده به عنوان دستگاه حلقه استفاده می‌کند. در غیر این صورت، تنها نام آن را چاپ می‌کند.
.RE
.sp
\fB\-\-show\fP
.RS 4
نمایش نام دستگاه حلقه اختصاص‌یافته در صورتی که گزینه \fB\-f\fP و یک آرگومان \fIfile\fP وجود داشته باشند.
.RE
.sp
\fB\-L\fP, \fB\-\-nooverlap\fP
.RS 4
بررسی تداخل میان دستگاه‌های حلقه برای جلوگیری از وضعیتی که یک پرونده پشتیبان یکسان بین چند دستگاه حلقه به اشتراک گذاشته شود. اگر پرونده از قبل توسط دستگاه دیگری استفاده شده است، به جای یک دستگاه جدید از همان دستگاه مجدداً استفاده می‌شود. این گزینه تنها همراه با \fB\-\-find\fP معنا دارد.
.RE
.sp
\fB\-j\fP, \fB\-\-associated\fP \fIfile\fP [\fB\-o\fP \fIoffset\fP]
.RS 4
نمایش وضعیت تمام دستگاه‌های حلقه مرتبط با \fIfile\fP داده‌شده.
.RE
.sp
\fB\-o\fP, \fB\-\-offset\fP \fIoffset\fP
.RS 4
شروع داده‌ها به میزان \fIoffset\fP بایت به درون پرونده یا دستگاه مشخص‌شده منتقل می‌شود. \fIoffset\fP می‌تواند با پسوندهای ضرب‌شونده همراه باشد؛ بالا را ببینید.
.RE
.sp
\fB\-\-loop\-ref\fP \fIstring\fP
.RS 4
تنظیم رشته مرجع (reference string). مقدار پیش‌فرض سازگار با گذشته، استفاده از نام پرونده پشتیبان به عنوان مرجع در ioctl راه‌اندازی حلقه است (با نام lo_file_name). این گزینه می‌تواند این رفتار پیش‌فرض را بازنویسی کرده و مرجع را روی \fIstring\fP تنظیم کند. مرجع ممکن است توسط udevd در /dev/loop/by\-ref استفاده شود. هسته لینوکس اصلاً از مرجع استفاده نمی‌کند، اما می‌تواند توسط برخی ابزارهای قدیمی که قادر به خواندن پرونده پشتیبان از sysfs نیستند استفاده شود. مرجع تنها برای کاربر ریشه (root) خواندنی است (\fB\-\-output\fP +REF را ببینید) و به ۶۴ بایت محدود شده است.
.RE
.sp
\fB\-\-sizelimit\fP \fIsize\fP
.RS 4
پایان داده‌ها به حداکثر \fIsize\fP بایت پس از شروع داده‌ها تنظیم می‌شود. \fIsize\fP می‌تواند با پسوندهای ضرب‌شونده همراه باشد؛ بالا را ببینید.
.RE
.sp
\fB\-b\fP, \fB\-\-sector\-size\fP \fIsize\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
وادار کردن هسته به پویش جدول پارتیشن روی یک دستگاه حلقه تازه‌ساخته‌شده. توجه داشته باشید که تجزیه جدول پارتیشن به اندازه‌های سکتور بستگی دارد. اندازه سکتور پیش‌فرض ۵۱۲ بایت است، در غیر این صورت باید از گزینه \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
فعال یا غیرفعال کردن ورودی/خروجی مستقیم (Direct I/O) برای پرونده پشتیبان. مقدار پیش‌فرض \fBoff\fP است. مشخص کردن \fB\-\-direct\-io\fP یا \fB\-\-direct\-io=on\fP آن را فعال می‌کند. اما برای غیرفعال کردن صریح آن می‌توان از \fB\-\-direct\-io=off\fP استفاده کرد.
.RE
.sp
\fB\-v\fP, \fB\-\-verbose\fP
.RS 4
حالت با جزئیات (verbose).
.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 \fIcolumn\fP[,\fIcolumn\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
.SH "رمزگذاری (ENCRYPTION)"
.sp
\fBCryptoloop دیگر پشتیبانی نمی‌شود و dm\-crypt جایگزین آن شده است.\fP برای جزئیات بیشتر \fBcryptsetup\fP(8) را ببینید.
.SH "وضعیت خروج (EXIT STATUS)"
.sp
دستور \fBlosetup\fP در صورت موفقیت 0 و در صورت شکست مقداری غیرصفر بازمی‌گرداند. هنگامی که \fBlosetup\fP وضعیت یک دستگاه حلقه را نمایش می‌دهد، اگر دستگاه پیکربندی نشده باشد 1 و اگر خطایی رخ دهد که مانع از تعیین وضعیت دستگاه شود 2 را بازمی‌گرداند.
.SH "نکات (NOTES)"
.sp
از نسخه 2.37 دستور \fBlosetup\fP از ioctl مربوط به \fBLOOP_CONFIGURE\fP برای راه‌اندازی دستگاه حلقه جدید با یک فراخوانی ioctl استفاده می‌کند. نسخه‌های قدیمی از ioctlهای \fBLOOP_SET_FD\fP و \fBLOOP_SET_STATUS64\fP برای انجام همین کار استفاده می‌کردند.
.SH "محیط (ENVIRONMENT)"
.sp
\fBLOOPDEV_DEBUG\fP=all
.RS 4
خروجی اشکال‌زدایی را فعال می‌کند.
.RE
.SH "پرونده‌ها (FILES)"
.sp
\fI/dev/loop[0..N]\fP
.RS 4
دستگاه‌های بلوکی حلقه
.RE
.sp
\fI/dev/loop\-control\fP
.RS 4
دستگاه کنترل حلقه
.RE
.SH "مثال‌ها (EXAMPLE)"
.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 "نویسندگان (AUTHORS)"
.sp
.MTO "kzak\(atredhat.com" "Karel Zak" "،"
بر پایه نسخه اصلی از
.MTO "tytso\(atathena.mit.edu" "Theodore Ts\(cqo" "."
.SH "گزارش اشکال (REPORTING BUGS)"
.sp
برای گزارش اشکال، از \c
.URL "https://github.com/util\-linux/util\-linux/issues" "سامانه پیگیری مشکلات" "."
.SH "در دسترس بودن (AVAILABILITY)"
.sp
دستور \fBlosetup\fP بخشی از بسته util\-linux است که می‌تواند از \c
.URL "https://www.kernel.org/pub/linux/utils/util\-linux" "بایگانی هسته لینوکس" "."
دریافت شود.