.\" -*- 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-builder-repository 1"
.TH virt-builder-repository 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\-builder\-repository \- ساخت آسان مخزن منبع برای virt\-builder
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "SYNOPSIS"
.Vb 2
\& virt\-builder\-repository /path/to/repository
\&    [\-i|\-\-interactive] [\-\-gpg\-key KEYID]
.Ve
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
ابزار virt\-builder ابزاری برای ساخت سریع ماشین‌های مجازی جدید است. این ابزار
می‌تواند برای استفاده از مخازن الگو پیکربندی شود. با این حال، ایجاد و
نگهداری یک مخزن شامل وظایف متعددی است که می‌توانند خودکار شوند.
دستور virt\-builder\-repository ابزاری برای کمک به مدیریت این مخازن است.
.PP
دستور virt\-builder\-repository روی فایل‌های موجود در دایرکتوری مشخص‌شده به عنوان
آرگومان پیمایش کرده، فایل‌هایی با نام منتهی به \f(CW\*(C`qcow2\*(C'\fR، \f(CW\*(C`raw\*(C'\fR،
\&\f(CW\*(C`img\*(C'\fR یا بدون پسوند را فشرده می‌کند، داده‌ها را از آن‌ها استخراج کرده و
فایل \f(CW\*(C`index\*(C'\fR را ایجاد یا به‌روزرسانی می‌کند.
.PP
بخشی از داده‌های مرتبط با ایمیج که برای فایل index مورد نیاز است، از طریق خود فایل
ایمیج قابل محاسبه نیستند. virt\-builder\-repository ابتدا تلاش می‌کند آن‌ها را
در فایل index موجود بیابد. اگر داده‌ها پس از این مرحله همچنان مفقود باشند،
در حالت تعاملی (interactive) از کاربر درخواست می‌شوند، در غیر این صورت خطایی
رخ خواهد داد.
.PP
اگر یک \f(CW\*(C`KEYID\*(C'\fR ارائه شود، فایل index تولیدشده با این کلید GPG امضا
خواهد شد..SH "مثال‌ها (EXAMPLES)"
.IX Header "EXAMPLES"
.SS "ایجاد مخزن اولیه"
.IX Subsection "Create the initial repository"
یک پوشه ایجاد کرده و فایل‌های الگوی دیسک ایمیج را در آن کپی کنید. سپس
دستوری مانند زیر را اجرا نمایید:
.PP
.Vb 1
\& virt\-builder\-repository \-\-gpg\-key "joe@hacker.org" \-i /path/to/folder
.Ve
.PP
توجه داشته باشید که این دستورِ نمونه در حالت تعاملی (interactive) اجرا می‌شود. برای اجرا در
حالت خودکار، پیش از اجرای دستور باید یک فایل نمایهٔ (index) کمینه ایجاد شود
که حاوی بخش‌هایی مانند این باشد:
.PP
.Vb 2
\& [template_id]
\& file=template_filename.qcow.xz
.Ve
.PP
در صورتی که پارامتر \fI\-\-no\-compression\fR مشخص نشده باشد، مقدار file باید با نام ایمیج همراه با پسوند
\f(CW\*(C`.xz\*(C'\fR مطابقت داشته باشد، یا اگر فشرده‌سازی در کار نباشد، با نام ایمیج یکسان باشد. سایر داده‌های اختیاری را می‌توان از قبل پر کرد. مقادیر پیش‌فرض با بازرسی دیسک ایمیج محاسبه می‌شوند.
برای اطلاعات بیشتر، بخش
«Creating and signing the index file» در \fBvirt\-builder\fR\|(1) را ببینید.
.SS "به‌روزرسانی ایمیج‌ها در یک مخزن موجود"
.IX Subsection "Update images in an existing repository"
در این سناریو، یک ایمیج جدید یا ویرایش جدیدی از یک ایمیج موجود
باید به مخزن اضافه شود. فایل‌های الگوی ایمیج مربوطه را در پوشهٔ
مخزن قرار دهید.
.PP
برای به‌روزرسانی ویرایش یک ایمیج، فایل باید همان نام نسخهٔ موجود
را داشته باشد (بدون پسوند \f(CW\*(C`xz\*(C'\fR).
.PP
همانند سناریوی ایجاد مخزن، می‌توان قطعه‌ای کمینه را برای حالت خودکار
به فایل نمایه اضافه کرد. این کار حتی روی نمایهٔ امضاشده نیز قابل
انجام است، هرچند ممکن است ایدهٔ عجیبی به نظر برسد: نمایه دوباره توسط
ابزار امضا خواهد شد.
.PP
برای حذف یک ایمیج از مخزن، کافی است پیش از اجرای virt\-builder\-repository،
فایل ایمیج مربوطه را حذف کنید.
.PP
سپس اجرای دستور زیر فایل نمایه را تکمیل و به‌روزرسانی خواهد کرد:
.PP
.Vb 1
\& virt\-builder\-repository \-\-gpg\-key "joe@hacker.org" \-i /path/to/folder
.Ve
.PP
برنامهٔ virt\-builder\-repository در یک پوشهٔ موقت درون همان پوشهٔ مخزن کار می‌کند. اگر در هنگام اجرای ابزار مشکلی رخ دهد، مخزن بدون دستکاری و دست‌نخورده باقی می‌ماند.
.SH "گزینه‌ها (OPTIONS)"
.IX Header "OPTIONS"
.IP \fB\-\-help\fR 4
.IX Item "--help"
نمایش راهنما.
.IP "\fB\-\-gpg\fR GPG" 4
.IX Item "--gpg GPG"
مشخص کردن یک باینری جایگزین برای \fBgpg\fR\|(1) (GNU Privacy Guard). همچنین می‌توانید از این گزینه برای افزودن پارامترهای gpg استفاده کنید؛ برای مثال جهت تعیین یک دایرکتوری خانگی جایگزین:
.Sp
.Vb 1
\& virt\-builder\-repository \-\-gpg "gpg \-\-homedir /tmp" [...]
.Ve
.Sp
همچنین می‌توان از این گزینه برای جلوگیری از درخواست عبارت عبور (passphrase) کلید توسط gpg استفاده کرد:
.Sp
.Vb 1
\& virt\-builder\-repository \-\-gpg "gpg \-\-passphrase\-file /tmp/pass \-\-batch" [...]
.Ve
.IP "\fB\-K\fR KEYID" 4
.IX Item "-K KEYID"
.PD 0
.IP "\fB\-\-gpg\-key\fR KEYID" 4
.IX Item "--gpg-key KEYID"
.PD
مشخص کردن کلید GPG مورد استفاده برای امضای فایل نمایهٔ مخزن.
اگر مشخص نشود، نمایه بدون امضا باقی می‌ماند. \f(CW\*(C`KEYID\*(C'\fR برای
شناسایی کلید GPG مورد نظر به کار می‌رود. این مقدار به گزینهٔ
\&\fI\-\-default\-key\fR در gpg فرستاده می‌شود و بنابراین می‌تواند یک نشانی رایانامه یا
یک اثرانگشت (fingerprint) باشد.
.Sp
\&\fBیادداشت\fR: به‌طور پیش‌فرض، virt\-builder\-repository کلید را در جاکلیدی (keyring) کلیدهای GPG کاربر جستجو می‌کند.
.IP \fB\-i\fR 4
.IX Item "-i"
.PD 0
.IP \fB\-\-interactive\fR 4
.IX Item "--interactive"
.PD
درخواست تعاملی برای داده‌های ناموجود. مقادیر پیش‌فرض از روی دیسک
ایمیج محاسبه می‌شوند.
.Sp
هنگام درخواست داده، وارد کردن \f(CW\*(C`\-\*(C'\fR معادل خالی گذاشتن
مقدار است. از این قابلیت می‌توان برای جلوگیری از تنظیم مقدار پیش‌فرض محاسبه‌شده استفاده کرد.
.IP \fB\-\-no\-compression\fR 4
.IX Item "--no-compression"
عدم فشرده‌سازی ایمیج‌های الگو.
.IP \fB\-\-machine\-readable\fR 4
.IX Item "--machine-readable"
.PD 0
.IP \fB\-\-machine\-readable\fR=format 4
.IX Item "--machine-readable=format"
.PD
این گزینه برای ماشین‌پسندتر کردن خروجی هنگام پردازش و تجزیه توسط برنامه‌های دیگر
به کار می‌رود. بخش «MACHINE READABLE OUTPUT» را در ادامه ببینید.
.IP \fB\-\-colors\fR 4
.IX Item "--colors"
.PD 0
.IP \fB\-\-colours\fR 4
.IX Item "--colours"
.PD
استفاده از توالی‌های رنگی ANSI برای رنگی کردن پیام‌ها. این حالت پیش‌فرض
هنگامی است که خروجی یک tty باشد. اگر خروجی برنامه به یک فایل هدایت شود،
توالی‌های رنگی ANSI غیرفعال خواهند شد مگر اینکه از این گزینه استفاده کنید.
.IP \fB\-q\fR 4
.IX Item "-q"
.PD 0
.IP \fB\-\-quiet\fR 4
.IX Item "--quiet"
.PD
عدم چاپ پیام‌های پیشرفت عادی.
.IP \fB\-v\fR 4
.IX Item "-v"
.PD 0
.IP \fB\-\-verbose\fR 4
.IX Item "--verbose"
.PD
فعال‌سازی پیام‌های اشکال‌زدایی (debug) و/یا تولید خروجی پرجزئیات.
.Sp
هنگام گزارش باگ‌ها، از این گزینه استفاده کرده و خروجی کامل را به
گزارش خود پیوست کنید.
.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"
شکستن خطوط (wrap) پیام‌های خطا، هشدار و اطلاعاتی. این حالت پیش‌فرض
هنگامی است که خروجی یک tty باشد. اگر خروجی برنامه به یک فایل هدایت شود،
شکستن خطوط غیرفعال می‌شود مگر اینکه از این گزینه استفاده کنید.
.IP \fB\-x\fR 4
.IX Item "-x"
فعال‌سازی ردگیری (tracing) فراخوانی‌های API کتابخانهٔ libguestfs..SH "خروجی ماشین‌خوان (MACHINE READABLE OUTPUT)"
.IX Header "MACHINE READABLE OUTPUT"
گزینهٔ \fI\-\-machine\-readable\fR می‌تواند برای ماشین‌خوان‌تر کردن خروجی استفاده شود، که هنگام فراخوانی virt\-builder\-repository از دیگر برنامه‌ها، رابط‌های گرافیکی (GUI) و غیره کاربردی است.
.PP
از این گزینه به تنهایی برای بررسی قابلیت‌های باینری virt\-builder\-repository استفاده کنید. یک خروجی معمول به این صورت است:
.PP
.Vb 2
\& $ virt\-builder\-repository \-\-machine\-readable
\& virt\-builder\-repository
.Ve
.PP
فهرستی از قابلیت‌ها، در هر خط یکی چاپ می‌شود و برنامه با وضعیت 0 خارج می‌شود.
.PP
امکان تعیین یک رشتهٔ قالب‌بندی برای کنترل خروجی وجود دارد؛ «ADVANCED MACHINE READABLE OUTPUT» را در \fBguestfs\fR\|(3) ببینید.
.SH "وضعیت خروج (EXIT STATUS)"
.IX Header "EXIT STATUS"
این برنامه در صورت موفقیت 0، یا در صورت بروز خطا مقداری غیر صفر برمی‌گرداند.
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "SEE ALSO"
\&\fBvirt\-builder\fR\|(1)
http://libguestfs.org
.SH "نویسندگان (AUTHORS)"
.IX Header "AUTHOR"
Cédric Bosdonnat mailto:cbosdonnat@suse.com
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
.IX Header "COPYRIGHT"
Copyright (C) 2016\-2025 SUSE Inc.
.SH "مجوز (LICENSE)"
.IX Header "LICENSE"
این برنامه یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط مجوز عمومی همگانی گنو (GNU General Public License) همان‌طور که توسط بنیاد نرم‌افزارهای آزاد (Free Software Foundation) منتشر شده است، چه نسخهٔ 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 را در گزارش باگ قرار دهید.