.TH "VGMKNODES" "8" "مه ۲۰۲۵" "lvm2" "دستورهای مدیریتی و نگهداری"
.
.SH "نام (NAME)"
vgmknodes \- ایجاد فایلهای دستگاه ویژه برای حجمهای منطقی در دایرکتوری /dev
.
.SH "خلاصه دستور (SYNOPSIS)"
\fBvgmknodes\fP [\fIگزینهها\fR] [\fIگروه_حجم\fR...]
.
.SH "توضیحات (DESCRIPTION)"
دستور \fBvgmknodes\fR ساختار فایلهای گره دستگاه (device nodes) مربوط به حجمهای منطقی فعال را در شاخه /dev بررسی و در صورت نبود ایجاد میکند.
.P
در صورتی که تمام اجزای سیستم به درستی با یکدیگر تعامل داشته باشند، معمولاً نیازی به اجرای این دستور نیست.
.P
همچنین یادداشت‌های انتهای این صفحه راهنما را برای استفاده از vgmknodes به همراه udev ببینید.
.
.SH "کاربرد (USAGE)"
.
\fBvgmknodes\fP
.br
.RS 4
.na
[    \fB\-\-ignorelockingfailure\fP ]
.br
[    \fB\-\-refresh\fP ]
.br
[    \fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP|\fBjson_std\fP ]
.br
[ \fIگزینه‌های_عمومی\fR ]
.ad
.RE
.RS 4
[ \fIVG\fP|\fILV\fP|\fITag\fP ... ]
.RE
.P
گزینه‌های عمومی lvm:
.
.RS 4
.na
[ \fB\-d\fP|\fB\-\-debug\fP ]
.br
[ \fB\-h\fP|\fB\-\-help\fP ]
.br
[ \fB\-q\fP|\fB\-\-quiet\fP ]
.br
[ \fB\-t\fP|\fB\-\-test\fP ]
.br
[ \fB\-v\fP|\fB\-\-verbose\fP ]
.br
[ \fB\-y\fP|\fB\-\-yes\fP ]
.br
[    \fB\-\-commandprofile\fP \fIرشته\fP ]
.br
[    \fB\-\-config\fP \fIرشته\fP ]
.br
[    \fB\-\-devices\fP \fIPV\fP ]
.br
[    \fB\-\-devicesfile\fP \fIرشته\fP ]
.br
[    \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP ]
.br
[    \fB\-\-journal\fP \fIرشته\fP ]
.br
[    \fB\-\-lockopt\fP \fIرشته\fP ]
.br
[    \fB\-\-longhelp\fP ]
.br
[    \fB\-\-nohints\fP ]
.br
[    \fB\-\-nolocking\fP ]
.br
[    \fB\-\-profile\fP \fIرشته\fP ]
.br
[    \fB\-\-version\fP ]
.ad
.RE
.
.SH "گزینه‌ها (OPTIONS)"
.
.HP
\fB\-\-commandprofile\fP \fIرشته\fP
.br
پروفایل فرمانی که برای پیکربندی دستور استفاده می‌شود. برای اطلاعات بیشتر درباره پروفایل‌ها،
.BR lvm.conf (5)
را ببینید.
.
.HP
\fB\-\-config\fP \fIرشته\fP
.br
تنظیمات پیکربندی برای دستور که بر تنظیمات
.BR lvm.conf (5)
ارجحیت دارند. آرگومان رشته از همان ساختار
.BR lvm.conf (5)
استفاده می‌کند یا می‌تواند از ساختار بخش/فیلد بهره ببرد. برای اطلاعات بیشتر درباره پیکربندی،
.BR lvm.conf (5)
را ببینید.
.
.HP
\fB\-d\fP|\fB\-\-debug\fP ...
.br
تعیین سطح اشکال‌زدایی (دیباگ). برای افزایش جزئیات پیام‌های ارسالی به فایل گزارش وقایع (لاگ) و/یا syslog (در صورت پیکربندی)، این گزینه را از ۱ تا ۶ بار تکرار کنید.
.
.HP
\fB\-\-devices\fP \fIPV\fP
.br
دستگاه‌های قابل مشاهده و در دسترس دستور را محدود می‌کند. دستگاه‌هایی که در این فهرست نباشند ناموجود به نظر می‌رسند. این گزینه می‌تواند تکرار شود یا فهرستی از دستگاه‌ها را که با کاما از هم جدا شده‌اند بپذیرد. این گزینه بر فایل devices ارجحیت دارد.
.
.HP
\fB\-\-devicesfile\fP \fIرشته\fP
.br
فایلی شامل فهرستی از دستگاه‌هایی که LVM باید استفاده کند. این فایل باید در مسیر
.I /etc/lvm/devices/
موجود باشد و با استفاده از دستور
.BR lvmdevices (8)
مدیریت می‌شود. این گزینه تنظیمات
.B devices/devicesfile
و
.B devices/use_devicesfile
در
.BR lvm.conf (5)
را بازنویسی می‌کند.
.
.HP
\fB\-\-driverloaded\fP \fBy\fP|\fBn\fP
.br
در صورت تنظیم بر روی no یا n، دستور تلاشی برای استفاده از device-mapper نخواهد کرد. برای آزمون و اشکال‌زدایی.
.
.HP
\fB\-h\fP|\fB\-\-help\fP
.br
نمایش متن راهنما.
.
.HP
\fB\-\-ignorelockingfailure\fP
.br
به دستور اجازه می‌دهد پس از شکست‌های قفل‌گذاری، با عملیات متادیتای فقط‌خواندنی ادامه دهد.
.
.HP
\fB\-\-journal\fP \fIرشته\fP
.br
ثبت اطلاعات در ژورنال systemd. این اطلاعات علاوه بر اطلاعات فعال‌شده از طریق تنظیم log/journal در lvm.conf است:
.BR command :
ثبت اطلاعات درباره دستور.
.BR output :
ثبت خروجی پیش‌فرض دستور.
.BR debug :
ثبت اشکال‌زدایی کامل دستور.
.
.HP
\fB\-\-lockopt\fP \fIرشته\fP
.br
برای ارسال گزینه‌ها در موارد خاص به lvmlockd استفاده می‌شود. برای اطلاعات بیشتر،
.BR lvmlockd (8)
را ببینید.
.
.HP
\fB\-\-longhelp\fP
.br
نمایش متن راهنمای تفصیلی و کامل.
.
.HP
\fB\-\-nohints\fP
.br
عدم استفاده از فایل راهنما (hints) برای مکان‌یابی دستگاه‌ها برای PVها. هنگامی که از hints استفاده نشود، ممکن است دستور دستگاه‌های بیشتری را برای یافتن PVها بخواند. این دستور همچنان باطل‌سازی استاندارد فایل hints را در صورت نیاز انجام خواهد داد.
.
.HP
\fB\-\-nolocking\fP
.br
غیرفعال کردن قفل‌گذاری. با احتیاط استفاده شود؛ دستورات همزمان ممکن است نتایج نادرستی ایجاد کنند.
.
.HP
\fB\-\-profile\fP \fIرشته\fP
.br
نام مستعاری برای \-\-commandprofile یا \-\-metadataprofile بسته به دستور.
.
.HP
\fB\-q\fP|\fB\-\-quiet\fP ...
.br
فرونشاندن خروجی‌ها و پیام‌های گزارش وقایع. این گزینه بر \-\-debug و \-\-verbose ارجحیت دارد. تکرار مجدد آن، هرگونه اعلان تأیید با پاسخ «نه» (no) را فرومی‌نشاند.
.
.HP
\fB\-\-refresh\fP
.br
اگر LV فعال است، متادیتای آن را مجدداً بارگذاری می‌کند. در محیطی که udev برای مدیریت محتوای /dev استفاده می‌شود، استفاده از این گزینه به شدت توصیه می‌شود؛ زیرا refresh همچنین رویدادهای udev را برای یک LV بازتولید می‌کند که بر اساس آن‌ها قوانین udev موجود جهت تعیین محتوا و مجوزهای /dev اعمال می‌شوند. همچنین، این عملیات ممکن است در صورت بروز مشکل، یا در صورت استفاده از نوعی اشتراک‌گذاری دستی LV مفید باشد.
.
.HP
\fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP|\fBjson_std\fP
.br
قالب فعلی خروجی گزارش‌ها را که به صورت سراسری توسط تنظیم report/output_format در
.BR lvm.conf (5)
تعریف شده است بازنویسی می‌کند. مقدار
.B basic
قالب اصلی جدول‌بندی‌شده با ستون‌ها و سطرها است. اگر بیش از یک گزارش در هر دستور وجود داشته باشد، ابتدای هر گزارش برای شناسایی، نام گزارش درج می‌شود. مقدار
.B json
خروجی گزارش را در قالب JSON تولید می‌کند. مقدار
.B json_std
خروجی گزارش را در قالب استانداردتر JSON تولید می‌کند. برای اطلاعات بیشتر،
.BR lvmreport (7)
را ببینید.
.
.HP
\fB\-t\fP|\fB\-\-test\fP
.br
اجرا در حالت آزمایشی (Test mode). دستورات متادیتا را به‌روزرسانی نخواهند کرد. این ویژگی با غیرفعال کردن تمام عملیات نوشتن متادیتا اما در عین حال بازگرداندن وضعیت موفقیت به تابع فراخواننده پیاده‌سازی شده است. چنانچه ابزاری در عملیات‌های چندمرحله‌ای متکی به خواندن مجدد متادیتایی باشد که فرض می‌کند تغییر یافته اما تغییری نکرده است، ممکن است این امر منجر به پیام‌های خطای غیرمعمول شود.
.
.HP
\fB\-v\fP|\fB\-\-verbose\fP ...
.br
تعیین سطح پرحرفی (جزئیات). برای افزایش جزئیات پیام‌های ارسالی به stdout و stderr، از ۱ تا ۴ بار تکرار کنید.
.
.HP
\fB\-\-version\fP
.br
نمایش اطلاعات نسخه نرم‌افزار.
.
.HP
\fB\-y\fP|\fB\-\-yes\fP
.br
عدم درخواست تأییدیه به صورت تعاملی و پیش‌فرض در نظر گرفتن همیشگی پاسخ مثبت (yes). با احتیاط بسیار زیاد استفاده شود. (برای پاسخ منفی خودکار، گزینه \-qq را ببینید.)
.
.SH "متغیرها (VARIABLES)"
.
.TP
.I VG
نام گروه حجم (Volume Group). برای نام‌های معتبر،
.BR lvm (8)
را ببینید.
.TP
.I LV
نام حجم منطقی (Logical Volume). برای نام‌های معتبر،
.BR lvm (8)
را ببینید. آرگومان مکانی LV معمولاً شامل نام VG و نام LV است، مانند VG/LV.
.TP
.I Tag
نام برچسب (تگ). برای اطلاعات بیشتر درباره نام‌های برچسب و استفاده از آن‌ها به جای VG، LV یا PV،
.BR lvm (8)
را ببینید.
.TP
.I رشته
برای اطلاعات بیشتر در مورد محتوای رشته، توضیحات مربوط به هر گزینه را ببینید.
.TP
.IR اندازه [واحد]
اندازه یک عدد ورودی است که یک واحد اختیاری را می‌پذیرد. واحدهای ورودی بدون توجه به بزرگی یا کوچکی حروف همیشه به عنوان مقادیر بر مبنای دو (باینری) در نظر گرفته می‌شوند؛ به عنوان مثال 'k' و 'K' هر دو نشان‌دهنده ۱۰۲۴ هستند. واحد ورودی پیش‌فرض با حرف و به دنبال آن |واحد مشخص می‌شود. واحد نشان‌دهنده سایر واحدهای ورودی ممکن است:
.BR b | B
بایت،
.BR s | S
سکتورهای ۵۱۲ بایتی،
.BR k | K
کیبی‌بایت (KiB)،
.BR m | M
مبی‌بایت (MiB)،
.BR g | G
گیبی‌بایت (GiB)،
.BR t | T
تبی‌بایت (TiB)،
.BR p | P
پبی‌بایت (PiB)،
.BR e | E
اگزی‌بایت (EiB).
(این مورد نباید با گزینه خروجی \-\-units اشتباه گرفته شود که در آن حروف بزرگ مضاربی از ۱۰۰۰ هستند.)
.
.SH "متغیرهای محیطی (ENVIRONMENT VARIABLES)"
.
برای اطلاعات بیشتر درباره متغیرهای محیطی استفاده‌شده توسط lvm،
.BR lvm (8)
را ببینید. به عنوان مثال، LVM_VG_NAME معمولاً می‌تواند به جای یک پارامتر الزامی VG جایگزین شود.
.
.SH "یادداشت‌ها (NOTES)"
.
هنگام استفاده از
.BR udev (7)
جهت مدیریت محتوای /dev، استفاده از گزینه
.B \-\-refresh
نیز به شدت توصیه می‌شود. با این کار، رویدادهای لازم udev نیز ایجاد شده و قوانین udev مرتبط به درستی اعمال می‌شوند. اگر گزینه
.B \-\-refresh
در این حالت استفاده نشود، LVM محتوای /dev را مستقیماً بازتولید می‌کند و udev سوابق مناسبی از پیوندهای نمادین و گره‌های تغییریافته نخواهد داشت. همچنین، هرگونه مجوز گره که توسط قوانین udev تعریف شده باشد اعمال نمی‌شود. این امر به نوبه خود ممکن است برای سایر مؤلفه‌های سیستم که برای دریافت فهرست پیوندهای نمادین و گره‌های /dev به خواندن پایگاه‌داده udev متکی هستند و وابسته به مجوزهای مبتنی بر قوانین udev هستند، مشکلاتی ایجاد کند.
.
.SH "همچنین ببینید (SEE ALSO)"
.
.nh
.na
.BR lvm (8),
.BR lvm.conf (5),
.BR lvmconfig (8),
.BR lvmdevices (8),
.P
.BR pvchange (8),
.BR pvck (8),
.BR pvcreate (8),
.BR pvdisplay (8),
.BR pvmove (8),
.BR pvremove (8),
.BR pvresize (8),
.BR pvs (8),
.BR pvscan (8),
.P
.BR vgcfgbackup (8),
.BR vgcfgrestore (8),
.BR vgchange (8),
.BR vgck (8),
.BR vgcreate (8),
.BR vgconvert (8),
.BR vgdisplay (8),
.BR vgexport (8),
.BR vgextend (8),
.BR vgimport (8),
.BR vgimportclone (8),
.BR vgimportdevices (8),
.BR vgmerge (8),
.BR vgmknodes (8),
.BR vgreduce (8),
.BR vgremove (8),
.BR vgrename (8),
.BR vgs (8),
.BR vgscan (8),
.BR vgsplit (8),
.P
.BR lvcreate (8),
.BR lvchange (8),
.BR lvconvert (8),
.BR lvdisplay (8),
.BR lvextend (8),
.BR lvreduce (8),
.BR lvremove (8),
.BR lvrename (8),
.BR lvresize (8),
.BR lvs (8),
.BR lvscan (8),
.P
.BR lvm\-fullreport (8),
.BR lvm\-lvpoll (8),
.BR blkdeactivate (8),
.BR lvmdump (8),
.P
.BR dmeventd (8),
.BR lvmpolld (8),
.BR lvmlockd (8),
.BR lvmlockctl (8),
.BR cmirrord (8),
.BR lvmdbusd (8),
.BR fsadm (8),
.P
.BR lvmsystemid (7),
.BR lvmreport (7),
.BR lvmcache (7),
.BR lvmraid (7),
.BR lvmthin (7),
.BR lvmvdo (7),
.BR lvmautoactivation (7)