'\" t .\" Title: blkid .\" Author: [بخش "نویسندگان" را ببینید] .\" Generator: Asciidoctor 2.0.26 .\" Date: مه ۲۰۲۵ .\" Manual: دستورات مدیریت سیستم .\" Source: util-linux .\" Language: Persian .\" .TH "BLKID" "8" "مه ۲۰۲۵" "util-linux" "دستورات مدیریت سیستم" .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)" blkid \- مکانیابی و چاپ ویژگیهای ابزارهای بلوکی (UUID و TYPE) .SH "خلاصه دستور (SYNOPSIS)" .sp \fBblkid\fP \fB\-\-label\fP \fIlabel\fP | \fB\-\-uuid\fP \fIuuid\fP .sp \fBblkid\fP [\fB\-\-no\-encoding\fP \fB\-\-garbage\-collect\fP \fB\-\-list\-one\fP \fB\-\-cache\-file\fP \fIfile\fP] [\fB\-\-output\fP \fIformat\fP] [\fB\-\-match\-tag\fP \fItag\fP] [\fB\-\-match\-token\fP \fINAME=value\fP] [\fIdevice\fP.\|.\|.] .sp \fBblkid\fP \fB\-\-probe\fP [\fB\-\-offset\fP \fIoffset\fP] [\fB\-\-output\fP \fIformat\fP] [\fB\-\-size\fP \fIsize\fP] [\fB\-\-match\-tag\fP \fItag\fP] [\fB\-\-match\-types\fP \fIlist\fP] [\fB\-\-usages\fP \fIlist\fP] [\fB\-\-no\-part\-details\fP] \fIdevice\fP.\|.\|. .sp \fBblkid\fP \fB\-\-info\fP [\fB\-\-output format\fP] [\fB\-\-match\-tag\fP \fItag\fP] \fIdevice\fP.\|.\|. .SH "توضیحات (DESCRIPTION)" دستور \fBblkid\fR برای شناسایی نوع فایلسیستم، شناسههای یکتای سراسری (UUID) و برچسبهای دستگاههای بلوکی ذخیرهسازی به کار میرود. .sp برنامه \fBblkid\fP یک رابط خط فرمان برای کار با کتابخانه \fBlibblkid\fP(3) است. این ابزار می‌تواند نوع محتوایی که یک دستگاه بلوکی در خود نگه می‌دارد (مانند فایل‌سیستم یا swap) و همچنین ویژگی‌ها (توکن‌ها، جفت‌های NAME=value) را از متادیتای محتوا (مانند فیلدهای LABEL یا UUID) استخراج و تعیین کند. .sp \fBتوصیه می‌شود برای دریافت اطلاعات درباره دستگاه‌های بلوکی از دستور\fP \fBlsblk\fP(8)\fB، برای مشاهده نمای کلی فایل‌سیستم‌ها از lsblk \-\-fs، یا برای جستجو در میان فایل‌سیستم‌های از پیش سوارشده از\fP \fBfindmnt\fP(8) \fBاستفاده کنید.\fP .RS 3 .ll -.6i .sp دستور \fBlsblk\fP(8) اطلاعات بیشتری ارائه می‌دهد، کنترل بهتری بر قالب‌بندی خروجی دارد، استفاده از آن در اسکریپت‌ها آسان‌تر است و برای دریافت اطلاعات جاری به دسترسی ریشه (root) نیاز ندارد. در مقابل، \fBblkid\fP اطلاعات را مستقیماً از دستگاه‌ها می‌خواند و برای کاربران غیرریشه اطلاعات کش‌شده و تأییدنشده بازمی‌گرداند. دستور \fBblkid\fP بیشتر برای سرویس‌های سیستمی و آزمایش قابلیت‌های کتابخانه \fBlibblkid\fP(3) طراحی شده است. .br .RE .ll .sp هنگامی که \fIdevice\fP مشخص شود، توکن‌های مربوط به تنها همان دستگاه نمایش داده می‌شوند. امکان مشخص کردن چندین آرگومان \fIdevice\fP در خط فرمان وجود دارد. اگر هیچ دستگاهی مشخص نشود، تمامی پارتیشن‌ها یا دستگاه‌های پارتیشن‌بندی‌نشده که در \fI/proc/partitions\fP ظاهر می‌شوند (در صورت شناسایی) نمایش داده خواهند شد. .sp دستور \fBblkid\fP دو حالت اصلی عملکرد دارد: یا جستجوی یک دستگاه با یک جفت خاص از NAME=value، یا نمایش جفت‌های NAME=value برای یک یا چند دستگاه مشخص‌شده. .sp به دلایل امنیتی، \fBblkid\fP تمامی دستگاه‌هایی را که نتیجه کاوش آن‌ها مبهم است (چندین فایل‌سیستم متداخل و متضاد شناسایی شود) بدون اعلان نادیده می‌گیرد. در این حالت، کاوش سطح پایین (\fB\-p\fP) اطلاعات بیشتر و کد خروجی متمایزی ارائه می‌دهد. توصیه می‌شود از \fBwipefs\fP(8) برای بررسی جزئیات و پاک کردن متادیتای منسوخ و قدیمی از روی دستگاه استفاده کنید. .SH "گزینه‌ها (OPTIONS)" .sp پس از شناسه‌های \fIsize\fP و \fIoffset\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\-c\fP, \fB\-\-cache\-file\fP \fIcachefile\fP .RS 4 خواندن از \fIcachefile\fP به جای فایل کش پیش‌فرض (برای جزئیات بیشتر بخش \fBفایل پیکربندی\fP را ببینید). اگر می‌خواهید با یک کش تمیز شروع کنید (یعنی دستگاه‌هایی که قبلاً پویش شده‌اند اما در حال حاضر لزوماً در دسترس نیستند گزارش نشوند)، مسیر \fI/dev/null\fP را مشخص کنید. .RE .sp \fB\-d\fP, \fB\-\-no\-encoding\fP .RS 4 نویسه‌های غیرقابل چاپ را کدگذاری نکن. این نویسه‌ها به طور پیش‌فرض با نمادگذاری ^ و \-M کدگذاری می‌شوند. توجه داشته باشید که قالب خروجی \fB\-\-output udev\fP از کدگذاری متفاوتی استفاده می‌کند که امکان غیرفعال‌سازی آن وجود ندارد. .RE .sp \fB\-D\fP, \fB\-\-no\-part\-details\fP .RS 4 در حالت کاوش سطح پایین، اطلاعات جدول پارتیشن (تگ‌های PART_ENTRY_*) را چاپ نکن. .RE .sp \fB\-g\fP, \fB\-\-garbage\-collect\fP .RS 4 اجرای فرآیند پاکسازی روی کش blkid برای حذف دستگاه‌هایی که دیگر وجود ندارند. .RE .sp \fB\-H\fP, \fB\-\-hint\fP \fIsetting\fP .RS 4 تنظیم راهنمای کاوش (probing hint). راهنماها روشی اختیاری برای واداشتن توابع کاوش به بررسی یک مکان دیگر هستند. در حال حاضر مقدار "session_offset=\fInumber\fP" برای تعیین آفست نشست در دیسک‌های چندنشستی UDF پشتیبانی می‌شود. .RE .sp \fB\-i\fP, \fB\-\-info\fP .RS 4 نمایش اطلاعات درباره محدودیت‌های ورودی/خروجی (I/O Limits یا همان توپولوژی I/O). قالب خروجی \*(Aqexport\*(Aq به طور خودکار فعال می‌شود. این گزینه می‌تواند همراه با گزینه \fB\-\-probe\fP استفاده شود. .RE .sp \fB\-k\fP, \fB\-\-list\-filesystems\fP .RS 4 فهرست کردن تمام فایل‌سیستم‌ها و RAIDهای شناخته‌شده و خروج. .RE .sp \fB\-l\fP, \fB\-\-list\-one\fP .RS 4 تنها یک دستگاه که با پارامتر جستجوی مشخص‌شده توسط گزینه \fB\-\-match\-token\fP مطابقت دارد را پیدا کن. اگر چندین دستگاه با پارامتر جستجو همخوانی داشته باشند، دستگاهی با بالاترین اولویت و/یا اولین دستگاه با اولویت مورد نظر بازگردانده می‌شود (نکته زیر در مورد udev را ببینید). اولویت انواع دستگاه‌ها به ترتیب نزولی عبارتند از: Device Mapper، EVMS، LVM، MD و در نهایت دستگاه‌های بلوکی معمولی. اگر این گزینه مشخص نشود، \fBblkid\fP تمام دستگاه‌های منطبق را نمایش می‌دهد. .sp این گزینه \fBblkid\fP را مجبور می‌کند که برای توکن‌های LABEL یا UUID در \fB\-\-match\-token\fP از udev استفاده کند. هدف این است که در سیستم‌هایی که از یک برچسب یکسان برای چند دستگاه استفاده شده، خروجی سازگار با سایر ابزارها (مانند \fBmount\fP(8) و غیره) تولید شود. .RE .sp \fB\-L\fP, \fB\-\-label\fP \fIlabel\fP .RS 4 پیدا کردن دستگاهی که از این \fIlabel\fP فایل‌سیستم استفاده می‌کند؛ این معادل \fB\-\-list\-one \-\-output device \-\-match\-token LABEL=\fP\fIlabel\fP است. این روش جستجو قادر است به شکل قابل اعتماد از پیوندهای نمادین udev در /dev/disk/by\-label استفاده کند (بسته به تنظیمات موجود در \fI/etc/blkid.conf\fP). از استفاده مستقیم پیوندهای نمادین خودداری کنید؛ استفاده از پیوندها بدون اعتبارسنجی قابل اعتماد نیست. گزینه \fB\-\-label\fP روی سیستم‌های با یا بدون udev به درستی کار می‌کند. .sp متأسفانه نسخه اولیه \fBblkid\fP(8) از بسته e2fsprogs گزینه \fB\-L\fP را به عنوان مترادفی برای \fB\-o list\fP به کار می‌برد. برای سازگاری بهتر، به جای استفاده از گزینه \fB\-L\fP، در اسکریپت‌های خود از \fB\-l \-o device \-t LABEL=\fP\fIlabel\fP و \fB\-o list\fP استفاده کنید. .RE .sp \fB\-n\fP, \fB\-\-match\-types\fP \fIlist\fP .RS 4 محدود کردن توابع کاوش به فهرست مشخص‌شده (جداشده با کاما) از نوع سوپربلاک‌ها (نام‌ها). می‌توان پیشوند "no" را به آیتم‌های فهرست اضافه کرد تا انواع نادیده‌گرفته‌شدنی مشخص شوند. برای نمونه: .sp \fBblkid \-\-probe \-\-match\-types vfat,ext3,ext4 /dev/sda1\fP .sp برای فایل‌سیستم‌های vfat، ext3 و ext4 کاوش می‌کند، و .sp \fBblkid \-\-probe \-\-match\-types nominix /dev/sda1\fP .sp تمامی فرمت‌های پشتیبانی‌شده به جز فایل‌سیستم minix را کاوش می‌کند. این گزینه فقط در ترکیب با \fB\-\-probe\fP کاربرد دارد. .RE .sp \fB\-o\fP, \fB\-\-output\fP \fIformat\fP .RS 4 استفاده از قالب خروجی مشخص‌شده. توجه داشته باشید که ترتیب متغیرها و دستگاه‌ها ثابت نیست. گزینه \fB\-s\fP را نیز ببینید. پارامتر \fIformat\fP می‌تواند یکی از موارد زیر باشد: .sp \fBfull\fP .RS 4 چاپ تمامی تگ‌ها (پیش‌فرض) .RE .sp \fBvalue\fP .RS 4 چاپ مقدار تگ‌ها .RE .sp \fBlist\fP .RS 4 چاپ دستگاه‌ها در قالبی کاربرپسند؛ این قالب خروجی برای کاوش‌های سطح پایین (\fB\-\-probe\fP یا \fB\-\-info\fP) پشتیبانی نمی‌شود. .sp این قالب خروجی \fBمنسوخ شده\fP و توصیه می‌شود از دستور \fBlsblk\fP(8) استفاده شود. .RE .sp \fBdevice\fP .RS 4 فقط چاپ نام دستگاه؛ این قالب خروجی همیشه برای گزینه‌های \fB\-\-label\fP و \fB\-\-uuid\fP فعال است. .RE .sp \fBudev\fP .RS 4 چاپ جفت‌های key="value" برای درون‌ریزی آسان در محیط udev؛ کلیدها دارای پیشوندهای ID_FS_ یا ID_PART_ هستند. ممکن است مقدار برای ایمن بودن در محیط udev تغییر یابد؛ استفاده از اسکی معمولی، کدهای هگزادسیمال و UTF-8 معتبر مجاز است و سایر موارد (از جمله فاصله‌ها) با \*(Aq_\*(Aq جایگزین می‌شوند. کلیدهایی با پسوند \fI_ENC\fP برای نویسه‌های ناامن از کدهای هگزادسیمال استفاده می‌کنند. .sp خروجی udev در صورتی که چندین سوپربلاک شناسایی شوند تگ ID_FS_AMBIVALENT را بازمی‌گرداند، و تگ‌های ID_PART_ENTRY_* همیشه برای تمام پارتیشن‌ها از جمله پارتیشن‌های خالی بازگردانده می‌شوند. .sp این قالب خروجی \fBمنسوخ شده\fP است. .RE .sp \fBexport\fP .RS 4 چاپ جفت‌های key=value برای درون‌ریزی آسان به متغیرهای محیطی؛ این قالب خروجی هنگام درخواست محدودیت‌های ورودی/خروجی (گزینه \fB\-\-info\fP) به طور خودکار فعال می‌شود. .sp نویسه‌های غیرقابل چاپ با نمادگذاری ^ و \-M کدگذاری می‌شوند و تمام نویسه‌های بالقوه ناامن اسکیپ می‌گردند. .RE .sp \fBjson\fP .RS 4 چاپ مدخل‌های تگ‌ها در قالب اشیاء JSON. .RE .RE .sp \fB\-O\fP, \fB\-\-offset\fP \fIoffset\fP .RS 4 کاوش در آفست مشخص‌شده (تنها همراه با \fB\-\-probe\fP مفید است). این گزینه را می‌توان به همراه گزینه \fB\-\-info\fP به کار برد. .RE .sp \fB\-p\fP, \fB\-\-probe\fP .RS 4 تغییر حالت به کاوش سطح پایین سوپربلاک (با دور زدن کش). .sp توجه داشته باشید که کاوش سطح پایین همچنین اطلاعاتی درباره نوع جدول پارتیشن (تگ PTTYPE) و پارتیشن‌ها (تگ‌های PART_ENTRY_*) ارائه می‌دهد. نام‌های تگ تولیدشده توسط کاوش سطح پایین مبتنی بر نام‌های داخلی به کار رفته توسط libblkid هستند و ممکن است با حالت اجرا بدون \fB\-\-probe\fP متفاوت باشند (برای نمونه PART_ENTRY_UUID= در مقابل PARTUUID=). همچنین گزینه \fB\-\-no\-part\-details\fP را ببینید. .RE .sp \fB\-s\fP, \fB\-\-match\-tag\fP \fItag\fP .RS 4 برای هر دستگاه (مشخص‌شده)، تنها تگ‌هایی را نمایش بده که با \fItag\fP مطابقت دارند. مشخص کردن چندباره گزینه \fB\-\-match\-tag\fP امکان‌پذیر است. اگر هیچ تگی مشخص نشود، تمام توکن‌ها برای همه دستگاه‌های مشخص‌شده نمایش داده می‌شوند. برای تازه‌سازی کش بدون نمایش هیچ توکنی، از \fB\-\-match\-tag none\fP بدون هیچ گزینه دیگری استفاده کنید. .RE .sp \fB\-S\fP, \fB\-\-size\fP \fIsize\fP .RS 4 بازنویسی اندازه دستگاه/فایل (تنها همراه با \fB\-\-probe\fP کاربرد دارد). .RE .sp \fB\-t\fP, \fB\-\-match\-token\fP \fINAME=value\fP .RS 4 جستجوی دستگاه‌های بلوکی با توکن‌هایی به نام \fINAME\fP که مقدار آن‌ها \fIvalue\fP است، و نمایش دستگاه‌های پیدا شده. مقادیر معمول برای \fINAME\fP شامل \fBTYPE\fP، \fBLABEL\fP و \fBUUID\fP است. اگر هیچ دستگاهی در خط فرمان مشخص نشده باشد، تمام دستگاه‌های بلوکی جستجو می‌شوند؛ در غیر این صورت فقط دستگاه‌های مشخص‌شده جستجو خواهند شد. .RE .sp \fB\-u\fP, \fB\-\-usages\fP \fIlist\fP .RS 4 محدود کردن توابع کاوش به فهرست مشخص‌شده (جداشده با کاما) از انواع "usage". انواع کاربرد پشتیبانی‌شده عبارتند از: filesystem، raid، crypto و other. می‌توان به آیتم‌های فهرست پیشوند "no" اضافه کرد تا انواع نادیده‌گرفته‌شدنی مشخص شوند. برای نمونه: .sp \fBblkid \-\-probe \-\-usages filesystem,other /dev/sda1\fP .sp تمامی قالب‌های فایل‌سیستم و موارد دیگر (مانند swap) را بررسی می‌کند، و .sp \fBblkid \-\-probe \-\-usages noraid /dev/sda1\fP .sp تمام قالب‌های پشتیبانی‌شده به جز آرایه‌های RAID را بررسی می‌کند. این گزینه تنها در ترکیب با \fB\-\-probe\fP سودمند است. .RE .sp \fB\-U\fP, \fB\-\-uuid\fP \fIuuid\fP .RS 4 پیدا کردن دستگاهی که از این \fIuuid\fP فایل‌سیستم استفاده می‌کند. برای جزئیات بیشتر گزینه \fB\-\-label\fP را ببینید. .RE .sp \fB\-h\fP, \fB\-\-help\fP .RS 4 نمایش متن راهنما و خروج. .RE .sp \fB\-V\fP, \fB\-\-version\fP .RS 4 نمایش نسخه و خروج. .RE .SH "وضعیت خروج (EXIT STATUS)" .sp اگر دستگاه مشخص‌شده یا دستگاه مشخص‌شده با توکن (گزینه \fB\-\-match\-token\fP) پیدا شود و بتوان اطلاعاتی درباره آن به دست آورد، کد وضعیت 0 بازگردانده می‌شود. توجه داشته باشید که گزینه \fB\-\-match\-tag\fP تگ‌های خروجی را فیلتر می‌کند اما تأثیری بر وضعیت خروج ندارد. .sp اگر توکن مشخص‌شده پیدا نشود، یا هیچ‌یک از دستگاه‌های (مشخص‌شده) شناسایی نشوند، یا جمع‌آوری هرگونه اطلاعات درباره شناسه‌ها یا محتوای دستگاه ناممکن باشد، کد وضعیت 2 بازگردانده می‌شود. .sp برای خطاهای استفاده یا سایر خطاها، وضعیت خروج 4 بازگردانده می‌شود. .sp اگر حالت کاوش سطح پایین (\fB\-p\fP) نتیجه کاوش مبهم و متداخلی را تشخیص دهد، وضعیت خروج 8 بازگردانده خواهد شد. .SH "فایل پیکربندی (CONFIGURATION FILE)" .sp مسیر استاندارد فایل پیکربندی \fI/etc/blkid.conf\fP را می‌توان با متغیر محیطی \fBBLKID_CONF\fP تغییر داد. گزینه‌های زیر رفتار کتابخانه libblkid را کنترل می‌کنند: .sp \fISEND_UEVENT=\fP .RS 4 هنگامی که پیوند نمادین \fI/dev/disk/by\-{label,uuid,partuuid,partlabel}/\fP با LABEL، UUID، PARTUUID یا PARTLABEL روی دستگاه مطابقت نداشته باشد، یک uevent ارسال می‌کند. مقدار پیش‌فرض "yes" است. .RE .sp \fICACHE_FILE=\fP .RS 4 مسیر استاندارد فایل کش را بازنویسی می‌کند. این تنظیم را می‌توان توسط متغیر محیطی \fBBLKID_FILE\fP تغییر داد. پیش‌فرض \fI/run/blkid/blkid.tab\fP است، یا در سیستم‌های فاقد دایرکتوری \fI/run\fP برابر با \fI/etc/blkid.tab\fP می‌باشد. .RE .sp \fIEVALUATE=\fP .RS 4 روش(های) ارزیابی LABEL و UUID را تعیین می‌کند. در حال حاضر کتابخانه libblkid از روش‌های "udev" و "scan" پشتیبانی می‌کند. بیش از یک روش را می‌توان در یک فهرست جداشده با کاما مشخص کرد. پیش‌فرض "udev,scan" است. روش "udev" از پیوندهای نمادین \fI/dev/disk/by\-*\fP در udev استفاده می‌کند و روش "scan" تمام دستگاه‌های بلوکی را از فایل \fI/proc/partitions\fP پویش می‌نماید. .RE .SH "محیط (ENVIRONMENT)" .sp تنظیم \fILIBBLKID_DEBUG=all\fP خروجی اشکال‌زدایی را فعال می‌کند. .SH "نویسندگان (AUTHORS)" .sp ابزار \fBblkid\fP توسط Andreas Dilger برای libblkid نوشته شده و توسط Theodore Ts\(cqo و Karel Zak بهبود یافته است. .SH "همچنین ببینید (SEE ALSO)" .sp \fBlibblkid\fP(3), \fBfindfs\fP(8), \fBlsblk\fP(8), \fBwipefs\fP(8) .SH "گزارش باگ‌ها (REPORTING BUGS)" .sp برای گزارش باگ‌ها از \c .URL "https://github.com/util\-linux/util\-linux/issues" "سامانه پیگیری باگ‌ها" "." .SH "در دسترس بودن (AVAILABILITY)" .sp دستور \fBblkid\fP بخشی از بسته util\-linux است که می‌توان آن را از \c .URL "https://www.kernel.org/pub/linux/utils/util\-linux" "آرشیو هسته لینوکس" "."