.TH "VGIMPORTDEVICES" "8" "مه ۲۰۲۵" "lvm2" "دستورهای مدیریتی و نگهداری"
.
.SH "نام (NAME)"
vgimportdevices \- افزودن دستگاههای یک گروه حجم به فایل دستگاههای محلی LVM
.
.SH "خلاصه دستور (SYNOPSIS)"
\fBvgimportdevices\fP [\fIگزینهها\fR] \fIگروه_حجم\fR...
.
.SH "توضیحات (DESCRIPTION)"
دستور \fBvgimportdevices\fR حجمهای فیزیکی متعلق به یک گروه حجم مشخص را پیدا کرده و شناسههای آنها را به فایل دستگاههای محلی LVM (devices file) اضافه میکند تا برای سیستم قابل شناسایی باشند.
این عملیات مشابه با استفاده از \fBlvmdevices \-\-adddev\fP برای افزودن تک‌تک حجم‌های فیزیکی (PV) به فایل دستگاه‌ها به صورت جداگانه است. دستور \fBvgimportdevices\fR همچنین فراداده‌های (metadata) گروه حجم را به‌روزرسانی می‌کند تا شامل شناسه‌های دستگاه هر PV باشد. اگر فایل دستگاه‌ها از قبل وجود نداشته باشد، \fBvgimportdevices\fR یک فایل دستگاه‌های جدید ایجاد خواهد کرد.
.P
هنگامی که از فایل دستگاه‌ها استفاده می‌شود، فیلتر عبارات باقاعده (regex filter) نادیده گرفته می‌شود؛ به جز در مورد \fBvgimportdevices\fR که هنگام جستجوی گروه‌های حجم (VG) جهت واردسازی به فایل دستگاه‌ها، فیلتر عبارات باقاعده را اعمال می‌کند. برای واردسازی تمام گروه‌های حجم موجود در سیستم به فایل دستگاه‌ها از \fBvgimportdevices \-a\fP استفاده کنید.
.
.SH "کاربرد (USAGE)"
افزودن دستگاه‌های گروه‌های حجم مشخص‌شده به فایل دستگاه‌ها:
.br
.P
\fBvgimportdevices\fP \fIVG\fP|\fITag\fP|\fISelect\fP ...
.br
.RS 4
.na
[ \fB\-S\fP|\fB\-\-select\fP \fIString\fP ]
.br
[ \fB\-\-foreign\fP ]
.br
[ گزینه‌های_عمومی ]
.ad
.RE
.P
افزودن دستگاه‌های تمام گروه‌های حجم قابل‌دسترسی به فایل دستگاه‌ها:
.br
.P
\fBvgimportdevices\fP \fB\-a\fP|\fB\-\-all\fP
.br
.RS 4
.na
[ \fB\-\-foreign\fP ]
.br
[ گزینه‌های_عمومی ]
.ad
.RE
.P
افزودن دستگاه‌های گروه حجم ریشه (root VG) به فایل دستگاه‌ها:
.br
.P
\fBvgimportdevices\fP \fB\-\-rootvg\fP
.br
.RS 4
.na
[ \fB\-\-auto\fP ]
.br
[ گزینه‌های_عمومی ]
.ad
.RE
.P
گزینه‌های عمومی برای دستور:
.RS 4
.na
[ \fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP|\fBjson_std\fP ]
.ad
.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 \fIString\fP ]
.br
[ \fB\-\-config\fP \fIString\fP ]
.br
[ \fB\-\-devices\fP \fIPV\fP ]
.br
[ \fB\-\-devicesfile\fP \fIString\fP ]
.br
[ \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP ]
.br
[ \fB\-\-journal\fP \fIString\fP ]
.br
[ \fB\-\-lockopt\fP \fIString\fP ]
.br
[ \fB\-\-longhelp\fP ]
.br
[ \fB\-\-nohints\fP ]
.br
[ \fB\-\-nolocking\fP ]
.br
[ \fB\-\-profile\fP \fIString\fP ]
.br
[ \fB\-\-version\fP ]
.ad
.RE
.
.SH "گزینه‌ها (OPTIONS)"
.
.HP
\fB\-a\fP|\fB\-\-all\fP
.br
واردسازی دستگاه‌های تمامی گروه‌های حجم (VG) قابل‌دسترسی به فایل دستگاه‌ها.
.
.HP
\fB\-\-auto\fP
.br
این گزینه هنگام واردسازی خودکار دستگاه‌ها برای گروه حجم ریشه (root VG) به کار می‌رود. واردسازی خودکار به‌منظور یک‌بار اجرا در نخستین راه‌اندازی سیستم طراحی شده است تا فایل اولیه system.devices را برای گروه حجم ریشه ایجاد کند. هنگامی که از این گزینه استفاده می‌شود، اگر فایل system.devices از پیش وجود داشته باشد یا فایل auto-import-rootvg وجود نداشته باشد (هر دو در دایرکتوری \fI/etc/lvm/devices/\fP)، دستور \fBvgimportdevices \-\-rootvg\fP هیچ عملی انجام نمی‌دهد.
.
.HP
\fB\-\-commandprofile\fP \fIString\fP
.br
نمایه دستوری مورد استفاده برای پیکربندی دستور. برای اطلاعات بیشتر درباره نمایه‌ها به \fBlvm.conf\fP(5) مراجعه فرمایید.
.
.HP
\fB\-\-config\fP \fIString\fP
.br
تنظیمات پیکربندی برای دستور. این تنظیمات بر مقادیر پیکربندی در \fBlvm.conf\fP(5) تقدم دارند. آرگومان String از همان قالب \fBlvm.conf\fP(5) بهره می‌برد یا می‌تواند از نحو بخش/فیلد استفاده کند. برای اطلاعات بیشتر درباره پیکربندی به \fBlvm.conf\fP(5) مراجعه فرمایید.
.
.HP
\fB\-d\fP|\fB\-\-debug\fP ...
.br
تنظیم سطح اشکال‌زدایی (دیباگ). این گزینه را از ۱ تا ۶ بار تکرار کنید تا جزئیات پیام‌های ارسالی به فایل لاگ و/یا syslog (در صورت فعال بودن) افزایش یابد.
.
.HP
\fB\-\-devices\fP \fIPV\fP
.br
محدود کردن دستگاه‌هایی که برای دستور قابل مشاهده و دسترسی هستند. دستگاه‌هایی که در این لیست نباشند مفقود به نظر خواهند رسید. این گزینه می‌تواند تکرار شود، یا فهرستی جدا شده با ویرگول از دستگاه‌ها را بپذیرد. این گزینه بر فایل دستگاه‌ها اولویت دارد.
.
.HP
\fB\-\-devicesfile\fP \fIString\fP
.br
فایلی شامل فهرست دستگاه‌هایی که LVM باید استفاده کند. این فایل باید در مسیر \fI/etc/lvm/devices/\fP وجود داشته باشد و با دستور \fBlvmdevices\fP(8) مدیریت می‌شود. این گزینه تنظیمات \fBdevices/devicesfile\fP و \fBdevices/use_devicesfile\fP در \fBlvm.conf\fP(5) را بازنویسی می‌کند.
.
.HP
\fB\-\-driverloaded\fP \fBy\fP|\fBn\fP
.br
در صورت تنظیم بر روی n، دستور تلاشی برای استفاده از device-mapper نخواهد کرد. این گزینه برای مقاصد آزمایش و اشکال‌زدایی کاربرد دارد.
.
.HP
\fB\-\-foreign\fP
.br
گزارش و نمایش گروه‌های حجم خارجی (foreign) که در حالت عادی نادیده گرفته می‌شوند. برای اطلاعات بیشتر درباره گروه‌های حجم خارجی به \fBlvmsystemid\fP(7) مراجعه فرمایید.
.
.HP
\fB\-h\fP|\fB\-\-help\fP
.br
نمایش متن راهنما.
.
.HP
\fB\-\-journal\fP \fIString\fP
.br
ثبت اطلاعات در ژورنال systemd. این اطلاعات علاوه بر اطلاعاتی است که توسط تنظیم log/journal در lvm.conf فعال می‌شود.
\fBcommand\fP: ثبت اطلاعات درباره دستور؛
\fBoutput\fP: ثبت خروجی پیش‌فرض دستور؛
\fBdebug\fP: ثبت کامل اطلاعات اشکال‌زدایی دستور.
.
.HP
\fB\-\-lockopt\fP \fIString\fP
.br
برای ارسال گزینه‌ها در شرایط خاص به lvmlockd استفاده می‌شود. برای اطلاعات بیشتر به \fBlvmlockd\fP(8) مراجعه فرمایید.
.
.HP
\fB\-\-longhelp\fP
.br
نمایش متن راهنمای بلند و جامع.
.
.HP
\fB\-\-nohints\fP
.br
عدم استفاده از فایل راهنماها (hints) برای یافتن دستگاه‌ها به عنوان PV. هنگامی که از راهنماها استفاده نشود، ممکن است دستور دستگاه‌های بیشتری را برای یافتن PVها اسکن کند. دستور همچنان باطل‌سازی استاندارد فایل راهنما را در زمان مقتضی انجام خواهد داد.
.
.HP
\fB\-\-nolocking\fP
.br
غیرفعال کردن قفل‌گذاری. با احتیاط استفاده شود؛ دستورات همزمان ممکن است نتایج نادرستی به همراه داشته باشند.
.
.HP
\fB\-\-profile\fP \fIString\fP
.br
نام مستعار برای \fB\-\-commandprofile\fP یا \fB\-\-metadataprofile\fP بسته به نوع دستور.
.
.HP
\fB\-q\fP|\fB\-\-quiet\fP ...
.br
فرونشاندن خروجی و پیام‌های لاگ. بر گزینه‌های \fB\-\-debug\fP و \fB\-\-verbose\fP اولویت دارد. با یک بار تکرار بیشتر، همچنین از تمامی اعلان‌ها با پاسخ پیش‌فرض 'no' رد می‌شود.
.
.HP
\fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP|\fBjson_std\fP
.br
قالب خروجی فعلی گزارش‌ها را که به صورت سراسری با تنظیم report/output_format در \fBlvm.conf\fP(5) تعریف شده است، بازنویسی می‌کند.
مقدار \fBbasic\fP همان قالب اصلی با ستون‌ها و ردیف‌ها است. اگر بیش از یک گزارش به ازای هر دستور وجود داشته باشد، هر گزارش با نام گزارش برای شناسایی پیشوند می‌گیرد.
مقدار \fBjson\fP خروجی گزارش را در قالب JSON تولید می‌کند.
مقدار \fBjson_std\fP خروجی گزارش را در قالبی از JSON سازگارتر با استانداردهای رسمی JSON ارائه می‌دهد.
برای اطلاعات بیشتر به \fBlvmreport\fP(7) مراجعه فرمایید.
.
.HP
\fB\-\-rootvg\fP
.br
واردسازی دستگاه‌های مورد استفاده برای گروه حجم ریشه (root VG) به فایل دستگاه‌ها.
.
.HP
\fB\-S\fP|\fB\-\-select\fP \fIString\fP
.br
انتخاب شیءها برای پردازش و گزارش‌گیری بر اساس معیارهای مشخص‌شده.
نحو معیارها در \fB\-\-select help\fP و \fBlvmreport\fP(7) شرح داده شده است.
برای دستورهای گزارش‌گیری، به ازای هر شیء منطبق با معیار یک سطر نمایش داده می‌شود.
برای فیلدهای قابل انتخاب شیء، به \fB\-\-options help\fP مراجعه فرمایید.
سطرها می‌توانند همراه با یک فیلد اضافی «selected» نمایش داده شوند (\fB\-o selected\fP) که در صورت انطباق سطر با معیار، عدد ۱ و در غیر این صورت ۰ را نشان می‌دهد.
برای دستورهای غیرگزارش‌گیری که موجودیت‌های LVM را پردازش می‌کنند، این انتخاب برای تعیین مواردی که باید پردازش شوند به کار می‌رود.
.
.HP
\fB\-t\fP|\fB\-\-test\fP
.br
اجرا در حالت آزمایش. دستورات اقدام به به‌روزرسانی متادیتا نخواهند کرد. این قابلیت با غیرفعال کردن تمامی عملیات‌های نوشتن متادیتا و همزمان بازگرداندن وضعیت موفقیت‌آمیز به تابع فراخواننده پیاده‌سازی شده است. این امر ممکن است در عملیات‌های چندمرحله‌ای منجر به پیام‌های خطای نامتعارف شود، اگر ابزاری وابسته به بازخوانی مجدد متادیتایی باشد که می‌پندارد تغییر یافته است اما در واقع تغییر نیافته است.
.
.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). برای نام‌های معتبر به \fBlvm\fP(8) مراجعه فرمایید.
.TP
.I Tag
نام برچسب (Tag). برای اطلاعات درباره نام‌های برچسب و استفاده از برچسب‌ها به جای VG، LV یا PV به \fBlvm\fP(8) مراجعه فرمایید.
.TP
.I Select
شناسه Select نشان می‌دهد که در صورت استفاده از گزینه \fB\-\-select\fP، پارامتر مکانی الزامی می‌تواند حذف شود. هیچ آرگومانی در این موقعیت ظاهر نمی‌شود.
.TP
.I String
برای اطلاعات در مورد محتوای رشته، به توضیحات همان گزینه رجوع فرمایید.
.TP
.IR Size [UNIT]
اندازه یک عدد ورودی است که یک واحد اختیاری را می‌پذیرد. واحدهای ورودی همواره صرف‌نظر از بزرگی یا کوچکی حروف به عنوان مقادیر بر مبنای دو تفسیر می‌شوند؛ برای نمونه 'k' و 'K' هر دو به معنی ۱۰۲۴ هستند. واحد پیش‌فرض ورودی با حرف و در ادامه با |UNIT مشخص شده است. مقدار UNIT بیانگر دیگر واحدهای ورودی ممکن است:
.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).
(این مورد نباید با کنترل خروجی \fB\-\-units\fP اشتباه گرفته شود که در آن حروف بزرگ به معنای مضاربی از ۱۰۰۰ هستند).
.
.SH "متغیرهای محیطی (ENVIRONMENT VARIABLES)"
.
برای اطلاعات بیشتر درباره متغیرهای محیطی مورد استفاده در lvm به \fBlvm\fP(8) مراجعه فرمایید. به عنوان نمونه، \fBLVM_VG_NAME\fP معمولاً می‌تواند به جای یک پارامتر الزامی VG جایگزین شود.
.
.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)