.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Podwrapper::Man 1.56.0 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\"
.\" Required to disable full justification in groff 1.23.0.
.if n .ds AD l
.\" ========================================================================
.\"
.IX Title "virt-customize 1"
.TH virt-customize 1 2026-07-11 guestfs-tools-1.56.0 "Virtualization Support"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "نام (NAME)"
virt\-customize \- سفارشی‌سازی یک ماشین مجازی
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "SYNOPSIS"
.Vb 10
\& virt\-customize
\&    [ \-a disk.img [ \-a disk.img ... ] | \-d domname ]
\&    [\-\-attach ISOFILE] [\-\-attach\-format FORMAT]
\&    [ \-c URI | \-\-connect URI ] [ \-n | \-\-dry\-run ]
\&    [ \-\-format FORMAT] [ \-m MB | \-\-memsize MB ]
\&    [ \-\-network | \-\-no\-network ]
\&    [ \-q | \-\-quiet ] [\-\-smp N] [ \-v | \-\-verbose ] [\-x]
\&    [\-\-append\-line FILE:LINE] [\-\-chmod PERMISSIONS:FILE]
\&    [\-\-chown UID:GID:PATH] [\-\-commands\-from\-file FILENAME]
\&    [\-\-copy SOURCE:DEST] [\-\-copy\-in LOCALPATH:REMOTEDIR]
\&    [\-\-delete PATH] [\-\-edit FILE:EXPR] [\-\-firstboot SCRIPT]
\&    [\-\-firstboot\-command \*(AqCMD+ARGS\*(Aq] [\-\-firstboot\-install PKG,PKG..]
\&    [\-\-hostname HOSTNAME] [\-\-inject\-blnsvr METHOD]
\&    [\-\-inject\-qemu\-ga METHOD] [\-\-inject\-virtio\-win METHOD]
\&    [\-\-install PKG,PKG..] [\-\-link TARGET:LINK[:LINK..]] [\-\-mkdir DIR]
\&    [\-\-move SOURCE:DEST] [\-\-password USER:SELECTOR]
\&    [\-\-root\-password SELECTOR] [\-\-run SCRIPT]
\&    [\-\-run\-command \*(AqCMD+ARGS\*(Aq] [\-\-scrub FILE]
\&    [\-\-ssh\-inject USER[:SELECTOR]] [\-\-tar\-in TARFILE:REMOTEDIR]
\&    [\-\-timezone TIMEZONE] [\-\-touch FILE] [\-\-truncate FILE]
\&    [\-\-truncate\-recursive PATH] [\-\-uninstall PKG,PKG..] [\-\-update]
\&    [\-\-upload FILE:DEST] [\-\-write FILE:CONTENT] [\-\-no\-logfile]
\&    [\-\-password\-crypto md5|sha256|sha512] [\-\-no\-selinux\-relabel]
\&    [\-\-selinux\-relabel]
\&
\&
\& virt\-customize [ \-V | \-\-version ]
.Ve
.SH "هشدار (WARNING)"
.IX Header "WARNING"
استفاده از \f(CW\*(C`virt\-customize\*(C'\fR
روی ماشین‌های مجازی در حال اجرا، یا به صورت همزمان با سایر ابزارهای ویرایش دیسک می‌تواند خطرناک باشد و به خرابی داده‌های دیسک منجر شود. ماشین مجازی باید پیش از استفاده از این دستور خاموش شده باشد، و ایمیج‌های دیسک نباید به طور همزمان ویرایش شوند.
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
ابزار virt\-customize می‌تواند یک ماشین مجازی (ایمیج دیسک) را با نصب بسته‌ها، ویرایش فایل‌های پیکربندی و کارهای دیگر سفارشی‌سازی کند.
.PP
ابزار virt\-customize مهمان یا ایمیج دیسک را \fIدرجا (in place)\fR تغییر می‌دهد. سیستم مهمان باید خاموش باشد. اگر می‌خواهید محتویات موجود مهمان حفظ شود، \fIباید ابتدا از دیسک اسنپ‌شات بگیرید، کپی کنید یا آن را کلون نمایید\fR.
.PP
شما \fIنیازی ندارید\fR که virt\-customize را با دسترسی ریشه (root) اجرا کنید. در واقع ما عموماً توصیه می‌کنیم که آن را با کاربر ریشه اجرا نکنید.
.PP
ابزارهای مرتبط عبارتند از: \fBvirt\-sysprep\fR\|(1) و \fBvirt\-builder\fR\|(1).
.SH "گزینه‌ها (OPTIONS)"
.IX Header "OPTIONS"
.IP \fB\-\-help\fR 4
.IX Item "--help"
نمایش راهنمای مختصر.
.IP "\fB\-a\fR file" 4
.IX Item "-a file"
.PD 0
.IP "\fB\-\-add\fR file" 4
.IX Item "--add file"
.PD
افزودن \fIfile\fR که باید یک ایمیج دیسک از یک ماشین مجازی باشد.
.Sp
قالب ایمیج دیسک به صورت خودکار تشخیص داده می‌شود. برای لغو این رفتار و تحمیل یک قالب خاص از گزینه \fI\-\-format\fR استفاده کنید.
.IP "\fB\-a\fR URI" 4
.IX Item "-a URI"
.PD 0
.IP "\fB\-\-add\fR URI" 4
.IX Item "--add URI"
.PD
افزودن یک دیسک دوردست (remote). قالب شناسه URI با guestfish سازگار است. بخش "ADDING REMOTE STORAGE" را در \fBguestfish\fR\|(1) ببینید.
.IP "\fB\-\-attach\fR ISOFILE" 4
.IX Item "--attach ISOFILE"
دیسک مشخص‌شده به اپلاینس libguestfs متصل (attach) می‌شود. این ویژگی برای ارائه مخازن نرم‌افزاری اضافی یا سایر داده‌ها جهت سفارشی‌سازی استفاده می‌شود.
.Sp
احتمالاً می‌خواهید مطمئن شوید که حجم(ها) یا سیستم‌های فایل در دیسک‌های متصل‌شده دارای برچسب (label) باشند (یا از نام حجم ISO استفاده کنید) تا بتوانید آن‌ها را بر اساس برچسب در اسکریپت‌های اجرایی خود سوار (mount) کنید:
.Sp
.Vb 2
\& mkdir /tmp/mount
\& mount LABEL=EXTRA /tmp/mount
.Ve
.Sp
می‌توانید از چندین گزینه \fI\-\-attach\fR استفاده کنید، و قالب آن می‌تواند هر قالب دیسکی باشد (نه فقط ISO).
.IP "\fB\-\-attach\-format\fR FORMAT" 4
.IX Item "--attach-format FORMAT"
تعیین قالب دیسک برای گزینه بعدی \fI\-\-attach\fR. مقدار \f(CW\*(C`FORMAT\*(C'\fR معمولاً \f(CW\*(C`raw\*(C'\fR یا \f(CW\*(C`qcow2\*(C'\fR است. برای فایل‌های ISO از \f(CW\*(C`raw\*(C'\fR استفاده کنید.
.IP \fB\-\-colors\fR 4
.IX Item "--colors"
.PD 0
.IP \fB\-\-colours\fR 4
.IX Item "--colours"
.PD
استفاده از دنباله‌های رنگی ANSI برای رنگی کردن پیام‌ها. این حالت در صورتی که خروجی یک tty باشد پیش‌فرض است. اگر خروجی برنامه به یک فایل هدایت شود، دنباله‌های رنگی ANSI غیرفعال می‌شوند مگر اینکه از این گزینه استفاده کنید.
.IP "\fB\-c\fR URI" 4
.IX Item "-c URI"
.PD 0
.IP "\fB\-\-connect\fR URI" 4
.IX Item "--connect URI"
.PD
در صورت استفاده از libvirt، به \fIURI\fR داده‌شده متصل می‌شود. در صورت حذف، به هایپروایزر پیش‌فرض libvirt متصل می‌شویم.
.Sp
اگر دستگاه‌های بلوکی مهمان را مستقیماً مشخص کنید (\fI\-a\fR)، آن‌گاه libvirt اصلاً استفاده نمی‌شود.
.IP "\fB\-d\fR guest" 4
.IX Item "-d guest"
.PD 0
.IP "\fB\-\-domain\fR guest" 4
.IX Item "--domain guest"
.PD
افزودن تمام دیسک‌های مربوط به مهمان نام‌برده‌شده در libvirt. می‌توان از شناسه UUID دامنه نیز به جای نام استفاده کرد.
.IP \fB\-n\fR 4
.IX Item "-n"
.PD 0
.IP \fB\-\-dry\-run\fR 4
.IX Item "--dry-run"
.PD
انجام یک اجرای آزمایشی و فقط‌خواندنی ("dry run") روی مهمان. این کار عملیات sysprep را اجرا می‌کند، اما در پایان هرگونه تغییر اعمال‌شده روی دیسک را دور می‌ریزد.
.IP \fB\-\-echo\-keys\fR 4
.IX Item "--echo-keys"
هنگام درخواست کلیدها و عبارات عبور، virt\-customize به طور معمول بازتاب کاراکترها (echoing) را خاموش می‌کند تا نتوانید آنچه را تایپ می‌کنید ببینید. اگر نگران حملات تمپست (Tempest) نیستید و شخص دیگری در اتاق حضور ندارد، می‌توانید این گزینه را مشخص کنید تا آنچه را تایپ می‌کنید ببینید.
.IP "\fB\-\-format\fR raw|qcow2|.." 4
.IX Item "--format raw|qcow2|.."
.PD 0
.IP "\fB\-\-format\fR auto" 4
.IX Item "--format auto"
.PD
پیش‌فرض برای گزینه \fI\-a\fR تشخیص خودکار قالب ایمیج دیسک است. استفاده از این گزینه، قالب دیسک را برای گزینه‌های بعدی \fI\-a\fR در خط فرمان تحمیل می‌کند. استفاده از \fI\-\-format auto\fR برای گزینه‌های بعدی \fI\-a\fR به حالت تشخیص خودکار بازمی‌گردد.
.Sp
برای مثال:
.Sp
.Vb 1
\& virt\-customize \-\-format raw \-a disk.img
.Ve
.Sp
قالب خام (raw) را بدون تشخیص خودکار برای \fIdisk.img\fR اعمال می‌کند.
.Sp
.Vb 1
\& virt\-customize \-\-format raw \-a disk.img \-\-format auto \-a another.img
.Ve
.Sp
قالب خام را برای \fIdisk.img\fR تحمیل کرده و برای \fIanother.img\fR به تشخیص خودکار بازمی‌گردد.
.Sp
اگر ایمیج‌های دیسک مهمان غیرقابل‌اعتماد با قالب خام دارید، باید از این گزینه برای تعیین قالب دیسک استفاده کنید. این کار از یک مشکل امنیتی احتمالی با مهمان‌های مخرب جلوگیری می‌کند (CVE\-2010\-3851).
.IP "\fB\-\-key\fR SELECTOR" 4
.IX Item "--key SELECTOR"
مشخص کردن کلید برای LUKS، جهت باز کردن خودکار دستگاه LUKS هنگام بازرسی.
.RS 4
.IP "\fB\-\-key\fR NAME\fB:key:\fRKEY_STRING" 4
.IX Item "--key NAME:key:KEY_STRING"
.PD 0
.IP "\fB\-\-key\fR UUID\fB:key:\fRKEY_STRING" 4
.IX Item "--key UUID:key:KEY_STRING"
.IP "\fB\-\-key\fR \fBall:key:\fRKEY_STRING" 4
.IX Item "--key all:key:KEY_STRING"
.PD
مقدار \f(CW\*(C`NAME\*(C'\fR نام دستگاه در libguestfs است (مانند \f(CW\*(C`/dev/sda1\*(C'\fR). مقدار \f(CW\*(C`UUID\*(C'\fR شناسه یکتای دستگاه است. مقدار \f(CW\*(C`all\*(C'\fR به معنی امتحان کردن کلید در برابر هر دستگاه رمزگذاری‌شده است.
.Sp
استفاده از \f(CW\*(C`KEY_STRING\*(C'\fR مشخص‌شده به عنوان عبارت عبور.
.IP "\fB\-\-key\fR NAME\fB:file:\fRFILENAME" 4
.IX Item "--key NAME:file:FILENAME"
.PD 0
.IP "\fB\-\-key\fR UUID\fB:file:\fRFILENAME" 4
.IX Item "--key UUID:file:FILENAME"
.IP "\fB\-\-key\fR \fBall:file:\fRFILENAME" 4
.IX Item "--key all:file:FILENAME"
.PD
خواندن عبارت عبور از \fIFILENAME\fR.
.IP "\fB\-\-key\fR NAME\fB:clevis\fR" 4
.IX Item "--key NAME:clevis"
.PD 0
.IP "\fB\-\-key\fR UUID\fB:clevis\fR" 4
.IX Item "--key UUID:clevis"
.IP "\fB\-\-key\fR \fBall:clevis\fR" 4
.IX Item "--key all:clevis"
.PD
تلاش برای باز کردن قفل دستگاه بدون نیاز به عبارت عبور با استفاده از Clevis و از طریق شبکه. لطفاً برای اطلاعات بیشتر پیرامون رمزگذاری دیسک وابسته به شبکه (NBDE)، به بخش "ENCRYPTED DISKS" در \fBguestfs\fR\|(3) مراجعه کنید.
.Sp
توجه داشته باشید که اگر چنین گزینه‌ای در خط فرمان وجود داشته باشد، شبکه کاربری QEMU به طور خودکار برای اپلاینس libguestfs فعال خواهد شد.
.RE
.RS 4
.RE
.IP \fB\-\-keys\-from\-stdin\fR 4
.IX Item "--keys-from-stdin"
خواندن پارامترهای کلید یا عبارت عبور از ورودی استاندارد (stdin). حالت پیش‌فرض تلاش برای خواندن عبارت عبور از کاربر از طریق باز کردن \fI/dev/tty\fR است.
.Sp
اگر چندین دستگاه رمزگذاری‌شده وجود داشته باشد، ممکن است لازم باشد چندین کلید را در ورودی استاندارد مشخص کنید، هر کدام در یک سطر.
.IP "\fB\-m\fR MB" 4
.IX Item "-m MB"
.PD 0
.IP "\fB\-\-memsize\fR MB" 4
.IX Item "--memsize MB"
.PD
تغییر مقدار حافظه اختصاص‌یافته به اسکریپت‌های \fI\-\-run\fR. اگر مشاهده کردید که اسکریپت‌های \fI\-\-run\fR یا گزینه \fI\-\-install\fR با کمبود حافظه مواجه می‌شوند، این مقدار را افزایش دهید.
.Sp
مقدار پیش‌فرض را می‌توان با این دستور پیدا کرد:
.Sp
.Vb 1
\& guestfish get\-memsize
.Ve
.IP \fB\-\-network\fR 4
.IX Item "--network"
.PD 0
.IP \fB\-\-no\-network\fR 4
.IX Item "--no-network"
.PD
فعال یا غیرفعال کردن دسترسی مهمان به شبکه در طول فرایند نصب.
.Sp
فعال بودن حالت پیش‌فرض است. برای غیرفعال کردن دسترسی از \fI\-\-no\-network\fR استفاده کنید.
.Sp
شبکه تنها اجازه برقراری اتصالات خروجی را می‌دهد و محدودیت‌های جزئی دیگری دارد. بخش "NETWORK" را در \fBvirt\-rescue\fR\|(1) ببینید.
.Sp
اگر از \fI\-\-no\-network\fR استفاده کنید، برخی گزینه‌های دیگر مانند \fI\-\-install\fR کار نخواهند کرد.
.Sp
این گزینه بر دسترسی مهمان به شبکه پس از بوت شدن سیستم تاثیری نمی‌گذارد، زیرا آن موضوع توسط هایپروایزر یا محیط ابری شما کنترل می‌شود و ارتباطی با virt\-customize ندارد.
.Sp
به طور کلی شما \fIنباید\fR از \fI\-\-no\-network\fR استفاده کنید. اما در اینجا چند دلیل وجود دارد که ممکن است بخواهید از آن استفاده کنید:
.RS 4
.IP 1. 4
چون بستر (backend) مورد استفاده libguestfs از شبکه پشتیبانی نمی‌کند. (ببینید: "BACKEND" در \fBguestfs\fR\|(3)).
.IP 2. 4
هر نرم‌افزاری که باید نصب کنید از یک فایل ISO متصل‌شده ارائه می‌شود، بنابراین به شبکه نیازی ندارید.
.IP 3. 4
شما مایل نیستید کد غیرقابل‌اعتماد مهمان هنگام اجرای virt\-customize تلاش کند به شبکه میزبان شما دسترسی پیدا کند. این موضوع به ویژه زمانی اهمیت دارد که به منبع الگوهای سیستم‌عامل اطمینان ندارید. (بخش "امنیت" را در ادامه ببینید).
.IP 4. 4
میزبان شما شبکه ندارد (مثلاً در محیط‌های امنیتی/محدودشده).
.RE
.RS 4
.RE
.IP \fB\-q\fR 4
.IX Item "-q"
.PD 0
.IP \fB\-\-quiet\fR 4
.IX Item "--quiet"
.PD
پیام‌های لاگ چاپ نشوند.
.Sp
برای فعال کردن لاگ تفصیلی عملیات تک‌تک فایل‌ها، از \fI\-x\fR استفاده کنید.
.IP "\fB\-\-smp\fR N" 4
.IX Item "--smp N"
فعال کردن N ≥ 2 پردازنده مجازی (vCPU) برای استفاده توسط اسکریپت‌های \fI\-\-run\fR.
.IP \fB\-v\fR 4
.IX Item "-v"
.PD 0
.IP \fB\-\-verbose\fR 4
.IX Item "--verbose"
.PD
فعال کردن پیام‌های با جزئیات کامل جهت اشکال‌زدایی.
.IP \fB\-V\fR 4
.IX Item "-V"
.PD 0
.IP \fB\-\-version\fR 4
.IX Item "--version"
.PD
نمایش شماره نسخه و خروج.
.IP \fB\-\-wrap\fR 4
.IX Item "--wrap"
شکستن خطوط پیام‌های خطا، هشدار و اطلاعاتی. این حالت در صورتی که خروجی یک tty باشد پیش‌فرض است. اگر خروجی برنامه به یک فایل هدایت شود، شکستن خطوط غیرفعال می‌شود مگر اینکه از این گزینه استفاده کنید.
.IP \fB\-x\fR 4
.IX Item "-x"
فعال کردن ردیابی فراخوانی‌های واسط برنامه‌نویسی (API) libguestfs.
.SS "گزینه‌های سفارشی‌سازی (Customization options)"
.IX Subsection "Customization options"
.IP "\fB\-\-append\-line\fR FILE:LINE" 4
.IX Item "--append-line FILE:LINE"
الحاق یک سطر متنی به انتهای \f(CW\*(C`FILE\*(C'\fR. اگر فایل از قبل با یک خط جدید پایان نیافته باشد، یک خط جدید پیش از سطر الحاقی اضافه می‌شود. همچنین یک خط جدید به صورت خودکار به انتهای رشته \f(CW\*(C`LINE\*(C'\fR افزوده می‌شود.
.Sp
برای مثال (با فرض کوتیشن‌گذاری معمول پوسته) این دستور:
.Sp
.Vb 1
\& \-\-append\-line \*(Aq/etc/hosts:10.0.0.1 foo\*(Aq
.Ve
.Sp
عبارت \f(CW\*(C`10.0.0.1 foo⏎\*(C'\fR یا \f(CW\*(C`⏎10.0.0.1 foo⏎\*(C'\fR را به فایل اضافه خواهد کرد، که مورد دوم تنها در صورتی است که فایل موجود قبلاً با یک خط جدید پایان نیافته باشد.
.Sp
علامت \f(CW\*(C`⏎\*(C'\fR نشان‌دهنده یک کاراکتر خط جدید است که با بررسی محتوای موجود فایل حدس زده می‌شود، بنابراین این دستور برای فایل‌هایی با پایان خط یونیکس یا ویندوز به درستی عمل می‌کند. این دستور همچنین برای فایل‌های خالی یا ناموجود کار می‌کند.
.Sp
برای درج چند سطر، همین گزینه را چند بار استفاده کنید:
.Sp
.Vb 2
\& \-\-append\-line \*(Aq/etc/hosts:10.0.0.1 foo\*(Aq
\& \-\-append\-line \*(Aq/etc/hosts:10.0.0.2 bar\*(Aq
.Ve
.Sp
برای درج یک سطر خالی پیش از سطر الحاقی، این کار را انجام دهید:
.Sp
.Vb 2
\& \-\-append\-line \*(Aq/etc/hosts:\*(Aq
\& \-\-append\-line \*(Aq/etc/hosts:10.0.0.1 foo\*(Aq
.Ve
.IP "\fB\-\-chmod\fR PERMISSIONS:FILE" 4
.IX Item "--chmod PERMISSIONS:FILE"
تغییر مجوزهای دسترسی \f(CW\*(C`FILE\*(C'\fR به \f(CW\*(C`PERMISSIONS\*(C'\fR.
.Sp
\fIنکته\fR: مقدار \f(CW\*(C`PERMISSIONS\*(C'\fR به طور پیش‌فرض ده‌دهی خواهد بود، مگر اینکه پیشوند \f(CW0\fR را برای هشت‌هشتی (octal) قرار دهید؛ یعنی از \f(CW0700\fR استفاده کنید نه \f(CW700\fR.
.IP "\fB\-\-chown\fR UID:GID:PATH" 4
.IX Item "--chown UID:GID:PATH"
تغییر شناسه کاربری (UID) و گروهی (GID) مالک یک فایل یا دایرکتوری در مهمان.
نکته:
.RS 4
.IP \(bu 4
تنها مقادیر عددی UID و GID کار خواهند کرد، و این مقادیر ممکن است در داخل مهمان با مقادیر روی میزبان متفاوت باشند.
.IP \(bu 4
این گزینه در مهمان‌های ویندوزی کار نخواهد کرد.
.RE
.RS 4
.Sp
برای مثال:
.Sp
.Vb 1
\& virt\-customize \-\-chown \*(Aq0:0:/var/log/audit.log\*(Aq
.Ve
.Sp
همچنین ببینید: \fI\-\-upload\fR.
.RE
.IP "\fB\-\-commands\-from\-file\fR FILENAME" 4
.IX Item "--commands-from-file FILENAME"
خواندن دستورات سفارشی‌سازی از یک فایل، یک دستور (و آرگومان‌های آن) در هر سطر.
.Sp
هر سطر حاوی یک دستور سفارشی‌سازی تکی و آرگومان‌های آن است، برای مثال:
.Sp
.Vb 3
\& delete /some/file
\& install some\-package
\& password some\-user:password:its\-new\-password
.Ve
.Sp
سطرهای خالی نادیده گرفته می‌شوند، و سطرهایی که با \f(CW\*(C`#\*(C'\fR آغاز می‌شوند کامنت بوده و آن‌ها نیز نادیده گرفته می‌شوند. علاوه بر این، آرگومان‌ها می‌توانند با افزودن یک \f(CW\*(C`\e\*(C'\fR (کاراکتر ادامه‌دهنده) در انتهای سطر، در چند سطر پخش شوند؛ برای مثال:
.Sp
.Vb 2
\& edit /some/file:\e
\&   s/^OPT=.*/OPT=ok/
.Ve
.Sp
دستورات به همان ترتیبی که در فایل آمده‌اند پردازش می‌شوند، درست مانند اینکه به عنوان \fI\-\-delete /some/file\fR در خط فرمان مشخص شده باشند.
.IP "\fB\-\-copy\fR SOURCE:DEST" 4
.IX Item "--copy SOURCE:DEST"
کپی کردن فایل‌ها یا دایرکتوری‌ها به صورت بازگشتی درون مهمان.
.Sp
نمی‌توان از نویسه‌های عام (wildcards) استفاده کرد.
.IP "\fB\-\-copy\-in\fR LOCALPATH:REMOTEDIR" 4
.IX Item "--copy-in LOCALPATH:REMOTEDIR"
کپی کردن فایل‌ها یا دایرکتوری‌های محلی به صورت بازگشتی به درون ایمیج دیسک، و قرار دادن آن‌ها در دایرکتوری \f(CW\*(C`REMOTEDIR\*(C'\fR (که باید وجود داشته باشد).
.Sp
نمی‌توان از نویسه‌های عام استفاده کرد.
.IP "\fB\-\-delete\fR PATH" 4
.IX Item "--delete PATH"
حذف یک فایل از مهمان، یا حذف یک دایرکتوری (و تمامی محتویات آن، به صورت بازگشتی).
.Sp
می‌توانید از کاراکترهای الگوی پوسته (glob) در مسیر مشخص‌شده استفاده کنید. مراقب باشید در صورت نیاز، کاراکترهای عمومی را برای پوسته میزبان اسکیپ کنید. برای مثال:
.Sp
.Vb 1
\& virt\-customize \-\-delete \*(Aq/var/log/*.log\*(Aq.
.Ve
.Sp
همچنین ببینید: \fI\-\-upload\fR، \fI\-\-scrub\fR.
.IP "\fB\-\-edit\fR FILE:EXPR" 4
.IX Item "--edit FILE:EXPR"
ویرایش \f(CW\*(C`FILE\*(C'\fR با استفاده از عبارت پرل \f(CW\*(C`EXPR\*(C'\fR.
.Sp
مراقب باشید که عبارت را به درستی کوتیشن‌گذاری کنید تا از تغییر آن توسط پوسته جلوگیری شود.
.Sp
توجه داشته باشید که این گزینه تنها زمانی در دسترس است که Perl 5 نصب باشد.
.Sp
بخش "NON\-INTERACTIVE EDITING" را در \fBvirt\-edit\fR\|(1) ببینید.
.IP "\fB\-\-firstboot\fR SCRIPT" 4
.IX Item "--firstboot SCRIPT"
نصب \f(CW\*(C`SCRIPT\*(C'\fR درون مهمان، تا هنگام نخستین بوت مهمان، اسکریپت (به عنوان کاربر root، در اواخر فرایند بوت) اجرا شود.
.Sp
اسکریپت پس از نصب در مهمان به طور خودکار با chmod +x قابل‌اجرا می‌شود.
.Sp
نسخه جایگزین \fI\-\-firstboot\-command\fR مشابه است، اما دستور را به راحتی در یک اسکریپت تک‌خطی برای شما قرار می‌دهد.
.Sp
می‌توانید چندین گزینه \fI\-\-firstboot\fR داشته باشید. آن‌ها به همان ترتیبی که در خط فرمان ظاهر می‌شوند اجرا می‌شوند.
.Sp
همچنین ببینید: "بوت اولیه (FIRSTBOOT)"، \fI\-\-run\fR.
.IP "\fB\-\-firstboot\-command\fR \*(AqCMD+ARGS\*(Aq" 4
.IX Item "--firstboot-command 'CMD+ARGS'"
اجرای دستور (و آرگومان‌ها) درون مهمان هنگامی که مهمان برای نخستین بار بوت می‌شود (به عنوان کاربر root، در اواخر فرایند بوت).
.Sp
می‌توانید چندین گزینه \fI\-\-firstboot\fR داشته باشید. آن‌ها به همان ترتیبی که در خط فرمان ظاهر می‌شوند اجرا می‌شوند.
.Sp
همچنین ببینید: "بوت اولیه (FIRSTBOOT)"، \fI\-\-run\fR.
.IP "\fB\-\-firstboot\-install\fR PKG,PKG.." 4
.IX Item "--firstboot-install PKG,PKG.."
نصب بسته‌های نام‌برده‌شده (فهرستی جداشده با کاما). این بسته‌ها هنگام نخستین بوت مهمان با استفاده از مدیر بسته مهمان (مانند apt، yum و غیره) و اتصال شبکه مهمان نصب می‌شوند.
.Sp
برای مرور کلی روش‌های مختلف نصب بسته‌ها، بخش "INSTALLING PACKAGES" را در \fBvirt\-builder\fR\|(1) ببینید.
.IP "\fB\-\-hostname\fR HOSTNAME" 4
.IX Item "--hostname HOSTNAME"
تنظیم نام میزبان (hostname) مهمان روی \f(CW\*(C`HOSTNAME\*(C'\fR. در صورت تمایل می‌توانید از یک نام دامنه کامل نقطه‌دار (FQDN) مانند hostname.domainname استفاده کنید.
.IP "\fB\-\-inject\-blnsvr\fR METHOD" 4
.IX Item "--inject-blnsvr METHOD"
تزریق سرور بالون (\fIblnsvr.exe\fR) به یک مهمان ویندوزی. این عملیات همچنین یک اسکریپت بوت اولیه تزریق می‌کند تا سرور بالون هنگام بوت شدن مهمان نصب شود.
.Sp
پارامتر مشابه پارامتر مورد استفاده در عملیات \fI\-\-inject\-virtio\-win\fR است.
.Sp
توجه داشته باشید که برای انجام یک تبدیل کامل برای مهمان ویندوزی از یک هایپروایزر دیگر مانند VMware (که شامل عملیات متعددی است)، باید به جای این گزینه از ابزار \fBvirt\-v2v\fR\|(1) استفاده کنید.
.IP "\fB\-\-inject\-qemu\-ga\fR METHOD" 4
.IX Item "--inject-qemu-ga METHOD"
تزریق عامل مهمان QEMU (QEMU Guest Agent) به یک مهمان ویندوزی. عامل مهمان از طریق یک سوکت با qemu ارتباط برقرار می‌کند تا ویژگی‌های پیشرفته‌تری ارائه دهد (ببینید: \fBqemu\-ga\fR\|(8)). این عملیات همچنین یک اسکریپت بوت اولیه تزریق می‌کند تا Guest Agent هنگام بوت شدن مهمان نصب شود.
.Sp
پارامتر مشابه پارامتر مورد استفاده در عملیات \fI\-\-inject\-virtio\-win\fR است.
.Sp
توجه داشته باشید که برای انجام یک تبدیل کامل برای مهمان ویندوزی از یک هایپروایزر دیگر مانند VMware (که شامل عملیات متعددی است)، باید به جای این گزینه از ابزار \fBvirt\-v2v\fR\|(1) استفاده کنید.
.IP "\fB\-\-inject\-virtio\-win\fR METHOD" 4
.IX Item "--inject-virtio-win METHOD"
تزریق درایورهای virtio\-win به یک مهمان ویندوزی. این درایورها، درایورهای شتاب‌یافته virtio را اضافه می‌کنند که هنگام اجرا بر روی هایپروایزرهای پشتیبانی‌کننده از virtio (مانند qemu/KVM) مناسب هستند. این عملیات همچنین رجیستری ویندوز را تنظیم می‌کند تا درایورها هنگام بوت شدن مهمان نصب شوند.
.Sp
پارامتر می‌تواند یکی از موارد زیر باشد:
.RS 4
.IP ISO 4
.IX Item "ISO"
مسیر ایمیج ISO حاوی درایورهای virtio\-win (مانند \fI/usr/share/virtio\-win/virtio\-win.iso\fR).
.IP DIR 4
.IX Item "DIR"
دایرکتوری حاوی درایورهای استخراج‌شده virtio\-win (مانند \fI/usr/share/virtio\-win\fR).
.RE
.RS 4
.Sp
توجه داشته باشید که برای انجام یک تبدیل کامل برای مهمان ویندوزی از یک هایپروایزر خارجی مانند VMware (که شامل عملیات متعدد دیگری است)، باید به جای این گزینه از ابزار \fBvirt\-v2v\fR\|(1) استفاده کنید.
.RE
.IP "\fB\-\-install\fR PKG,PKG.." 4
.IX Item "--install PKG,PKG.."
نصب بسته‌های نام‌برده‌شده (فهرستی جداشده با کاما). این بسته‌ها در طول فرایند ساخت ایمیج با استفاده از مدیر بسته مهمان (مانند apt، yum و غیره) و از طریق اتصال شبکه میزبان نصب می‌شوند.
.Sp
برای مرور کلی روش‌های گوناگون نصب بسته‌ها، بخش "INSTALLING PACKAGES" را در \fBvirt\-builder\fR\|(1) ببینید.
.Sp
همچنین ببینید: \fI\-\-update\fR، \fI\-\-uninstall\fR.
.IP "\fB\-\-link\fR TARGET:LINK[:LINK..]" 4
.IX Item "--link TARGET:LINK[:LINK..]"
ایجاد پیوند(های) نمادین درون مهمان، که از \f(CW\*(C`LINK\*(C'\fR آغاز شده و به \f(CW\*(C`TARGET\*(C'\fR اشاره می‌کنند.
.IP "\fB\-\-mkdir\fR DIR" 4
.IX Item "--mkdir DIR"
ایجاد یک دایرکتوری در مهمان.
.Sp
این گزینه از \f(CW\*(C`mkdir\ \-p\*(C'\fR استفاده می‌کند، بنابراین دایرکتوری‌های میانی نیز ایجاد می‌شوند، و همچنین در صورتی که دایرکتوری از قبل وجود داشته باشد به درستی عمل می‌کند.
.IP "\fB\-\-move\fR SOURCE:DEST" 4
.IX Item "--move SOURCE:DEST"
انتقال یا جابه‌جایی فایل‌ها یا دایرکتوری‌ها درون مهمان.
.Sp
نمی‌توان از نویسه‌های عام استفاده کرد.
.IP \fB\-\-no\-logfile\fR 4
.IX Item "--no-logfile"
پاک‌سازی و امحای \f(CW\*(C`builder.log\*(C'\fR (فایل لاگ دستورات ساخت) از ایمیج پس از پایان فرایند ساخت. اگر نمی‌خواهید دقیقاً مشخص شود که ایمیج چگونه ساخته شده است، از این گزینه استفاده کنید.
.Sp
همچنین ببینید: "فایل لاگ (Log file)".
.IP \fB\-\-no\-selinux\-relabel\fR 4
.IX Item "--no-selinux-relabel"
عدم تلاش برای تصحیح برچسب‌های SELinux فایل‌ها در مهمان.
.Sp
در مهمان‌هایی که از SELinux پشتیبانی می‌کنند، سفارشی‌سازی به طور خودکار برچسب فایل‌ها را مجدداً تنظیم می‌کند تا دارای برچسب صحیح SELinux باشند. (برچسب‌گذاری مجدد بلافاصله انجام می‌شود، اما اگر عملیات با شکست مواجه شود، فرایند سفارشی‌سازی فایل \fI/.autorelabel\fR را روی ایمیج لمس می‌کند تا عملیات برچسب‌گذاری مجدد را برای بوت بعدی ایمیج زمان‌بندی کند.) این گزینه برچسب‌گذاری مجدد خودکار را غیرفعال می‌کند.
.Sp
این گزینه برای مهمان‌هایی که از SELinux پشتیبانی نمی‌کنند بی‌اثر است.
.IP "\fB\-\-password\fR USER:SELECTOR" 4
.IX Item "--password USER:SELECTOR"
تنظیم گذرواژه برای \f(CW\*(C`USER\*(C'\fR. (توجه داشته باشید که این گزینه حساب کاربری ایجاد \fIنمی‌کند\fR).
.Sp
بخش "USERS AND PASSWORDS" را در \fBvirt\-builder\fR\|(1) برای قالب فیلد \f(CW\*(C`SELECTOR\*(C'\fR و همچنین نحوه ایجاد حساب‌های کاربری ببینید.
.IP "\fB\-\-password\-crypto\fR md5|sha256|sha512" 4
.IX Item "--password-crypto md5|sha256|sha512"
هنگامی که ابزارهای virt گذرواژه‌ای را در مهمان تغییر داده یا تنظیم می‌کنند، این گزینه الگوریتم رمزنگاری آن گذرواژه را روی \f(CW\*(C`md5\*(C'\fR، \f(CW\*(C`sha256\*(C'\fR یا \f(CW\*(C`sha512\*(C'\fR تعیین می‌کند.
.Sp
الگوریتم‌های \f(CW\*(C`sha256\*(C'\fR و \f(CW\*(C`sha512\*(C'\fR نیازمند نسخه glibc ≥ 2.7 هستند (بخش \fBcrypt\fR\|(3) را در داخل مهمان بررسی کنید).
.Sp
الگوریتم \f(CW\*(C`md5\*(C'\fR با مهمان‌های نسبتاً قدیمی لینوکس (مانند RHEL 3) کار می‌کند، اما در برابر حملات امروزی ایمن نیست.
.Sp
حالت پیش‌فرض \f(CW\*(C`sha512\*(C'\fR است مگر اینکه libguestfs یک مهمان قدیمی را شناسایی کند که از SHA\-512 پشتیبانی نمی‌کند، که در این حالت از \f(CW\*(C`md5\*(C'\fR استفاده خواهد کرد. می‌توانید با مشخص کردن این گزینه، رفتار پیش‌فرض libguestfs را بازنویسی کنید.
.Sp
توجه داشته باشید که این گزینه الگوریتم رمزنگاری پیش‌فرض استفاده‌شده توسط مهمان را هنگام ایجاد حساب‌های کاربری جدید درون مهمان تغییر نمی‌دهد. اگر می‌خواهید آن را تغییر دهید، باید از گزینه \fI\-\-edit\fR برای ویرایش \f(CW\*(C`/etc/sysconfig/authconfig\*(C'\fR (در Fedora و RHEL) یا \f(CW\*(C`/etc/pam.d/common\-password\*(C'\fR (در Debian و Ubuntu) استفاده کنید.
.IP "\fB\-\-root\-password\fR SELECTOR" 4
.IX Item "--root-password SELECTOR"
تنظیم گذرواژه کاربر ریشه (root).
.Sp
بخش "USERS AND PASSWORDS" را در \fBvirt\-builder\fR\|(1) برای قالب فیلد \f(CW\*(C`SELECTOR\*(C'\fR و همچنین نحوه ایجاد حساب‌های کاربری ببینید.
.Sp
نکته: در virt\-builder، اگر \fI\-\-root\-password\fR را تنظیم \fIنکنید\fR، یک گذرواژه ریشه \fIتصادفی\fR به مهمان اختصاص می‌یابد.
.IP "\fB\-\-run\fR SCRIPT" 4
.IX Item "--run SCRIPT"
اجرای اسکریپت شل (یا هر برنامه دیگری) با نام \f(CW\*(C`SCRIPT\*(C'\fR روی ایمیج دیسک. این اسکریپت به صورت مجازی‌شده درون یک اپلاینس کوچک، و با chroot به سیستم فایل مهمان اجرا می‌شود.
.Sp
اسکریپت به طور خودکار chmod +x می‌شود.
.Sp
اگر libguestfs از آن پشتیبانی کند، یک اتصال شبکه محدود در دسترس خواهد بود که تنها اتصالات خروجی شبکه را مجاز می‌داند. همچنین می‌توانید دیسک‌های داده (مانند فایل‌های ISO) را متصل کنید تا راه دیگری برای ارائه داده‌ها (مانند بسته‌های نرم‌افزاری) به اسکریپت بدون نیاز به اتصال شبکه داشته باشید (\fI\-\-attach\fR). همچنین می‌توانید فایل‌های داده را بارگذاری کنید (\fI\-\-upload\fR).
.Sp
می‌توانید چندین گزینه \fI\-\-run\fR داشته باشید. آن‌ها به همان ترتیبی که در خط فرمان ظاهر می‌شوند اجرا می‌شوند.
.Sp
همچنین ببینید: \fI\-\-firstboot\fR، \fI\-\-attach\fR، \fI\-\-upload\fR.
.IP "\fB\-\-run\-command\fR \*(AqCMD+ARGS\*(Aq" 4
.IX Item "--run-command 'CMD+ARGS'"
اجرای دستور و آرگومان‌ها روی ایمیج دیسک. دستور به صورت مجازی‌شده درون یک اپلاینس کوچک و با chroot به سیستم فایل مهمان اجرا می‌شود.
.Sp
اگر libguestfs از آن پشتیبانی کند، یک اتصال شبکه محدود در دسترس خواهد بود که تنها اتصالات خروجی شبکه را مجاز می‌داند. همچنین می‌توانید دیسک‌های داده (مانند فایل‌های ISO) را متصل کنید تا راه دیگری برای ارائه داده‌ها (مانند بسته‌های نرم‌افزاری) به اسکریپت بدون نیاز به اتصال شبکه داشته باشید (\fI\-\-attach\fR). همچنین می‌توانید فایل‌های داده را بارگذاری نمایید (\fI\-\-upload\fR).
.Sp
می‌توانید چندین گزینه \fI\-\-run\-command\fR داشته باشید. آن‌ها به همان ترتیبی که در خط فرمان ظاهر می‌شوند اجرا می‌گردند.
.Sp
همچنین ببینید: \fI\-\-firstboot\fR، \fI\-\-attach\fR، \fI\-\-upload\fR.
.IP "\fB\-\-scrub\fR FILE" 4
.IX Item "--scrub FILE"
امحا و پاک‌سازی امن یک فایل از مهمان. این گزینه شبیه \fI\-\-delete\fR است به جز اینکه:
.RS 4
.IP \(bu 4
داده‌ها را به طور کامل امحا می‌کند به طوری که مهمان قادر به بازیابی آن نباشد.
.IP \(bu 4
نمی‌تواند دایرکتوری‌ها را حذف کند، بلکه تنها فایل‌های معمولی را حذف می‌کند.
.RE
.RS 4
.RE
.IP \fB\-\-selinux\-relabel\fR 4
.IX Item "--selinux-relabel"
این یک گزینه سازگاری است که هیچ کاری انجام نمی‌دهد.
.IP "\fB\-\-ssh\-inject\fR USER[:SELECTOR]" 4
.IX Item "--ssh-inject USER[:SELECTOR]"
تزریق یک کلید SSH به طوری که کاربر \f(CW\*(C`USER\*(C'\fR داده‌شده بتواند بدون نیاز به گذرواژه از طریق ssh وارد شود. کاربر \f(CW\*(C`USER\*(C'\fR باید از قبل در مهمان وجود داشته باشد.
.Sp
بخش "SSH KEYS" در \fBvirt\-builder\fR\|(1) را برای قالب فیلد \f(CW\*(C`SELECTOR\*(C'\fR ببینید.
.Sp
می‌توانید چندین گزینه \fI\-\-ssh\-inject\fR برای کاربران مختلف و همچنین برای افزودن کلیدهای بیشتر برای هر کاربر داشته باشید.
.IP "\fB\-\-tar\-in\fR TARFILE:REMOTEDIR" 4
.IX Item "--tar-in TARFILE:REMOTEDIR"
کپی کردن فایل‌ها یا دایرکتوری‌های محلی از یک فایل tar محلی با نام \f(CW\*(C`TARFILE\*(C'\fR به درون ایمیج دیسک، و قرار دادن آن‌ها در دایرکتوری \f(CW\*(C`REMOTEDIR\*(C'\fR (که باید وجود داشته باشد). توجه داشته باشید که فایل tar باید غیرفشرده باشد (فایل‌های \fI.tar.gz\fR در اینجا کار نخواهند کرد).
.IP "\fB\-\-timezone\fR TIMEZONE" 4
.IX Item "--timezone TIMEZONE"
تنظیم منطقه زمانی پیش‌فرض مهمان روی \f(CW\*(C`TIMEZONE\*(C'\fR. از یک رشته مکان مانند \f(CW\*(C`Asia/Tehran\*(C'\fR یا \f(CW\*(C`Europe/London\*(C'\fR استفاده کنید.
.IP "\fB\-\-touch\fR FILE" 4
.IX Item "--touch FILE"
این دستور عملیاتی شبیه به دستور \fBtouch\fR\|(1) را روی \f(CW\*(C`FILE\*(C'\fR اجرا می‌کند.
.IP "\fB\-\-truncate\fR FILE" 4
.IX Item "--truncate FILE"
این دستور طول فایل \f(CW\*(C`FILE\*(C'\fR را به صفر می‌رساند (خالی می‌کند). فایل باید از قبل وجود داشته باشد.
.IP "\fB\-\-truncate\-recursive\fR PATH" 4
.IX Item "--truncate-recursive PATH"
این دستور به طور بازگشتی طول تمامی فایل‌های زیرمسیر \f(CW\*(C`PATH\*(C'\fR را به صفر می‌رساند.
.IP "\fB\-\-uninstall\fR PKG,PKG.." 4
.IX Item "--uninstall PKG,PKG.."
حذف بسته‌های نام‌برده‌شده (فهرستی جداشده با کاما). این بسته‌ها در طول فرایند ساخت ایمیج با استفاده از مدیر بسته مهمان (مانند apt، yum و غیره) حذف می‌شوند. بسته‌های وابسته نیز ممکن است برای برآورده کردن این درخواست حذف شوند.
.Sp
همچنین ببینید: \fI\-\-install\fR، \fI\-\-update\fR.
.IP \fB\-\-update\fR 4
.IX Item "--update"
انجام معادل دستورات \f(CW\*(C`yum update\*(C'\fR، \f(CW\*(C`apt\-get upgrade\*(C'\fR یا هر دستوری که برای به‌روزرسانی بسته‌های نصب‌شده در الگو به آخرین نسخه لازم باشد.
.Sp
همچنین ببینید: \fI\-\-install\fR، \fI\-\-uninstall\fR.
.IP "\fB\-\-upload\fR FILE:DEST" 4
.IX Item "--upload FILE:DEST"
بارگذاری فایل محلی \f(CW\*(C`FILE\*(C'\fR به مقصد \f(CW\*(C`DEST\*(C'\fR در ایمیج دیسک. مالک و مجوزهای فایل اصلی حفظ می‌شوند، بنابراین باید آن‌ها را طوری تنظیم کنید که می‌خواهید در ایمیج دیسک باشند.
.Sp
مقدار \f(CW\*(C`DEST\*(C'\fR می‌تواند نام نهایی فایل باشد. این قابلیت می‌تواند برای تغییر نام فایل هنگام بارگذاری استفاده شود.
.Sp
اگر \f(CW\*(C`DEST\*(C'\fR نام یک دایرکتوری باشد (که باید از قبل در مهمان وجود داشته باشد)، فایل در آن دایرکتوری بارگذاری می‌شود و نام آن در سیستم فایل محلی حفظ می‌گردد.
.Sp
همچنین ببینید: \fI\-\-mkdir\fR، \fI\-\-delete\fR، \fI\-\-scrub\fR.
.IP "\fB\-\-write\fR FILE:CONTENT" 4
.IX Item "--write FILE:CONTENT"
نوشتن \f(CW\*(C`CONTENT\*(C'\fR در فایل \f(CW\*(C`FILE\*(C'\fR.
.SH "بوت اولیه (FIRSTBOOT)"
.IX Header "FIRSTBOOT"
گزینه‌های \fI\-\-firstboot\fR و \fI\-\-firstboot\-command\fR به شما امکان می‌دهند دستوراتی را در نخستین بوت مهمان اجرا کنید. برای این منظور، یک اسکریپت init برای سیستم init مهمان نصب می‌شود که وظیفه اجرای تمامی اسکریپت‌ها و دستورات اضافه‌شده را بر عهده می‌گیرد.
.SS "فایل لاگ (Log file)"
.IX Subsection "Log file"
در لینوکس، خروجی اسکریپت‌ها در فایل
\&\fI~root/virt\-sysprep\-firstboot.log\fR
درون مهمان نوشته می‌شود.
.PP
در ویندوز، خروجی در فایل
\&\fIC:\eProgram\ Files\eGuestfs\eFirstboot\elog.txt\fR
درون مهمان نوشته می‌شود.
.SS "کدهای خروج فایل بچ ویندوز در بوت اولیه (Windows firstboot batch file exit codes)"
.IX Subsection "Windows firstboot batch file exit codes"
تنها در مهمان‌های ویندوزی، کد خروج فایل‌های بچ روند اجرا و نیاز به راه‌اندازی مجدد ویندوز بین هر اسکریپت را کنترل می‌کند:
.IP \(bu 4
249
.Sp
فایل بچ به عنوان ناموفق تلقی می‌شود. فایل بچ در راه‌اندازی مجدد بعدی مجدداً اجرا خواهد شد. (مواظب باشید که فایل‌های بچ به طور مداوم این کد خروج را بازنگردانند، در غیر این صورت ویندوز وارد چرخه بی‌پایان بوت خواهد شد.)
.IP \(bu 4
250
.Sp
اسکریپت نشان می‌دهد که در این مرحله نیازی به راه‌اندازی مجدد سیستم نیست. اسکریپت بعدی در توالی بدون آغاز راه‌اندازی مجدد اجرا خواهد شد.
.IP \(bu 4
هر کد دیگر
.Sp
این اسکریپت موفقیت‌آمیز تلقی می‌شود. ویندوز راه‌اندازی مجدد شده و اسکریپت بعدی را اجرا خواهد کرد.
.SS "فایل دیده‌بان ویندوز (Windows sentinel file)"
.IX Subsection "Windows sentinel file"
تنها در مهمان‌های ویندوزی، پس از پایان اجرای تمامی اسکریپت‌های بوت اولیه، یک فایل دیده‌بان (sentinel file) درون مهمان نوشته می‌شود. می‌توانید از این فایل برای تشخیص آماده بودن مهمان ویندوزی (مثلاً اتمام تبدیل توسط \fBvirt\-v2v\fR\|(1)) استفاده کنید. مکان پیش‌فرض این فایل به صورت زیر است:
.PP
.Vb 1
\& C:\eProgram Files\eGuestfs\eFirstboot\ecomplete
.Ve
.SS "ابزارهای کمکی (Auxiliary tools)"
.IX Subsection "Auxiliary tools"
در مهمان‌های ویندوزی، ابزار \fIrhsrvany.exe\fR که سورس آن در https://github.com/rwmjones/rhsrvany موجود است، یا \fIpvvxsvc.exe\fR که با SUSE VMDP ارائه می‌شود، برای اجرای اسکریپت‌های بوت اولیه نصب می‌گردد. وجود یکی از این موارد الزامی است و در صورت عدم وجود، راه‌اندازی اسکریپت‌های بوت اولیه با شکست مواجه خواهد شد.
.PP
ابزار \fIrhsrvany.exe\fR یا \fIpvvxsvc.exe\fR از مکانی کپی می‌شود که متغیر محیطی \f(CW\*(C`VIRT_TOOLS_DATA_DIR\*(C'\fR به آن اشاره می‌کند؛ در صورت عدم تنظیم، از مقدار پیش‌فرض کامپایل‌شده (چیزی شبیه \fI/usr/share/virt\-tools\fR) استفاده خواهد شد.
.SS "\fI\-\-firstboot\fP در مقابل \fI\-\-script\fP"
.IX Subsection "--firstboot vs --script"
هر دو گزینه \fI\-\-firstboot\fR و \fI\-\-script\fR اسکریپت‌های شلی ارائه می‌دهند که بر روی مهمان اجرا می‌شوند. با این حال، این دو گزینه تفاوت‌های بنیادینی با یکدیگر دارند.
.PP
گزینه \fI\-\-firstboot script\fR فایل \f(CW\*(C`script\*(C'\fR را درون مهمان بارگذاری کرده و شرایط را طوری فراهم می‌کند که هنگام بوت بعدی مهمان، در داخل خود مهمان اجرا شود.
.PP
گزینه \fI\-\-script\fR اسکریپت شل را \fIروی میزبان\fR اجرا می‌کند، در حالی که دایرکتوری جاری آن درون سیستم فایل مهمان قرار دارد.
.PP
برای مثال، اگر نیاز دارید بسته‌های جدیدی را با \f(CW\*(C`yum install\*(C'\fR نصب کنید، \fIنباید\fR از \fI\-\-script\fR برای این کار استفاده نمایید، چرا که این کار (الف) دستور \f(CW\*(C`yum\*(C'\fR را روی میزبان اجرا می‌کند و (ب) به منابع یکسان (مخازن، کلیدها و غیره) مشابه مهمان دسترسی نخواهد داشت. هر دستوری که باید روی مهمان اجرا شود \fIباید\fR از طریق \fI\-\-firstboot\fR اجرا گردد.
.PP
از سوی دیگر، اگر نیاز به اعمال تغییرات روی سیستم فایل مهمان دارید (مثلاً کپی کردن فایل‌ها به داخل آن)، گزینه \fI\-\-script\fR ایده‌آل است زیرا (الف) به سیستم فایل میزبان دسترسی دارد و (ب) در صورت بروز خطا بلافاصله بازخورد دریافت می‌کنید.
.PP
هر کدام از این گزینه‌ها یا هر دوی آن‌ها را می‌توان چندین بار در خط فرمان به کار برد.
.SH "امنیت لینوکس (SELINUX)"
.IX Header "SELINUX"
برای مهمان‌هایی که از SELinux استفاده می‌کنند، هنگام استفاده از عملیاتی که فایل‌های جدیدی ایجاد کرده یا فایل‌های موجود را تغییر می‌دهند ممکن است به رفتار ویژه‌ای نیاز باشد.
.PP
برای جزئیات بیشتر، بخش "SELINUX" را در \fBvirt\-builder\fR\|(1) ببینید.
.SH "گزینه‌های منسوخ‌شده (DEPRECATED OPTIONS)"
.IX Header "DEPRECATED OPTIONS"
در نسخه 1.56 گزینه‌های subscription\-manager حذف شدند:
\&\fB\-\-sm\-credentials\fR، \fB\-\-sm\-register\fR، \fB\-\-sm\-unregister\fR،
\&\fB\-\-sm\-attach\fR، \fB\-\-sm\-remove\fR
.PP
برای جزئیات بیشتر، بخش "DEPRECATED OPTIONS" را در \fBvirt\-builder\fR\|(1) ببینید.
.SH "وضعیت خروج (EXIT STATUS)"
.IX Header "EXIT STATUS"
این برنامه در صورت موفقیت 0 و در صورت بروز خطا 1 را برمی‌گرداند.
.SH "متغیرهای محیطی (ENVIRONMENT VARIABLES)"
.IX Header "ENVIRONMENT VARIABLES"
.ie n .IP """VIRT_TOOLS_DATA_DIR""" 4
.el .IP \f(CWVIRT_TOOLS_DATA_DIR\fR 4
.IX Item "VIRT_TOOLS_DATA_DIR"
این متغیر می‌تواند به دایرکتوری حاوی فایل‌های داده مورد استفاده برای نصب بوت اولیه ویندوز اشاره کند.
.Sp
به طور معمول نیازی به تنظیم آن ندارید. در صورت عدم تنظیم، از یک مقدار پیش‌فرض کامپایل‌شده (چیزی مانند \fI/usr/share/virt\-tools\fR) استفاده خواهد شد.
.Sp
این دایرکتوری ممکن است حاوی فایل‌های زیر باشد:
.RS 4
.IP \fIrhsrvany.exe\fR 4
.IX Item "rhsrvany.exe"
این فایل باینری ویندوزی RHSrvAny است که برای نصب یک اسکریپت "firstboot" در مهمان‌های ویندوزی استفاده می‌شود. اگر قصد دارید از گزینه‌های \fI\-\-firstboot\fR یا \fI\-\-firstboot\-command\fR در مهمان‌های ویندوزی استفاده کنید، وجود آن الزامی است.
.Sp
همچنین ببینید: \f(CW\*(C`https://github.com/rwmjones/rhsrvany\*(C'\fR
.IP \fIpvvxsvc.exe\fR 4
.IX Item "pvvxsvc.exe"
این یک فایل باینری ویندوزی است که همراه با SUSE VMDP ارائه می‌شود و برای نصب اسکریپت "firstboot" در مهمان‌های ویندوزی کاربرد دارد. اگر قصد دارید از گزینه‌های \fI\-\-firstboot\fR یا \fI\-\-firstboot\-command\fR در مهمان‌های ویندوزی استفاده کنید، وجود آن الزامی است.
.RE
.RS 4
.RE
.PP
برای مشاهده سایر متغیرهای محیطی، بخش "ENVIRONMENT VARIABLES" را در \fBguestfs\fR\|(3) ببینید.
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "SEE ALSO"
\&\fBguestfs\fR\|(3),
\&\fBguestfish\fR\|(1),
\&\fBvirt\-builder\fR\|(1),
\&\fBvirt\-clone\fR\|(1),
\&\fBvirt\-rescue\fR\|(1),
\&\fBvirt\-resize\fR\|(1),
\&\fBvirt\-sparsify\fR\|(1),
\&\fBvirt\-sysprep\fR\|(1),
\&\fBvirsh\fR\|(1),
\&\fBlvcreate\fR\|(8),
\&\fBqemu\-img\fR\|(1),
\&\fBscrub\fR\|(1),
http://libguestfs.org,
http://libvirt.org.
.SH "نویسندگان (AUTHORS)"
.IX Header "AUTHORS"
Richard W.M. Jones http://people.redhat.com/~rjones
.SH "حق نشر (COPYRIGHT)"
.IX Header "COPYRIGHT"
Copyright (C) 2011\-2025 Red Hat Inc.
.SH "مجوز (LICENSE)"
.IX Header "LICENSE"
این برنامه نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط «مجوز عمومی همگانی گنو» (GNU General Public License) همان‌طور که توسط بنیاد نرم‌افزارهای آزاد منتشر شده است، مجدداً توزیع نموده و/یا تغییر دهید؛ نسخه 2 مجوز یا (به انتخاب خودتان) هر نسخه بعدی.
.PP
این برنامه به این امید توزیع شده است که مفید واقع شود، اما بدون هرگونه ضمانت؛ حتی بدون ضمانت ضمنی قابلیت فروش یا مناسب بودن برای یک هدف خاص. برای جزئیات بیشتر «مجوز عمومی همگانی گنو» را مطالعه کنید.
.PP
شما باید به همراه این برنامه یک نسخه از مجوز عمومی همگانی گنو را دریافت کرده باشید؛ در غیر این صورت، به آدرس زیر نامه بنویسید:
Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110\-1301 USA.
.SH "گزارش اشکالات (BUGS)"
.IX Header "BUGS"
برای مشاهده فهرستی از اشکالات ثبت‌شده برای libguestfs، از این پیوند استفاده کنید:
https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools
.PP
برای گزارش یک اشکال جدید برای libguestfs، از این پیوند استفاده کنید:
https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools
.PP
هنگام گزارش اشکال، لطفاً اطلاعات زیر را ارائه دهید:
.IP \(bu 4
نسخه libguestfs.
.IP \(bu 4
محل تهیه libguestfs (مثلاً کدام توزیع لینوکس، کامپایل از سورس و غیره).
.IP \(bu 4
اشکال را با دقت توصیف نموده و روشی برای بازتولید آن ارائه دهید.
.IP \(bu 4
دستور \fBlibguestfs\-test\-tool\fR\|(1) را اجرا کرده و خروجی \fBکامل و دست‌نخورده\fR آن را درون گزارش اشکال قرار دهید.