virt-tar-in(1)              Virtualization Support              virt-tar-in(1)


نام (NAME)
       virt-tar-in - استخراج و ریختن محتویات آرشیو tar به درون ایمیج دیسک
       ماشین مجازی

خلاصه دستور (SYNOPSIS)
        virt-tar-in -a disk.img data.tar /destination

        virt-tar-in -d domain data.tar /destination

        zcat data.tar.gz | virt-tar-in -d domain - /destination

هشدار (WARNING)
       استفاده از "virt-tar-in" روی ماشین‌های مجازی روشن، یا به‌طور هم‌زمان با
       سایر ابزارهای ویرایش دیسک می‌تواند خطرناک باشد و احتمالاً منجر به خرابی
       دیسک شود. ماشین مجازی باید پیش از استفاده از این دستور خاموش شود، و
       ایمیج‌های دیسک نباید هم‌زمان ویرایش شوند.

توضیحات (DESCRIPTION)
       دستور "virt-tar-in" محتویات یک آرشیو tar غیرفشرده را به درون یک ایمیج
       دیسک ماشین مجازی یا دامنه نام‌گذاری‌شده libvirt استخراج می‌کند.

       پارامتر اول فایل tar است. از "-" برای خواندن فایل tar از ورودی
       استاندارد استفاده کنید. پارامتر دوم دایرکتوری مقصد مطلق برای استخراج
       فایل‌ها است.

مثال‌ها (EXAMPLES)
       آپلود و انتقال دایرکتوری خانه به یک ماشین مهمان:

        virt-tar-in -d MyGuest homes.tar /home

پوسته‌اسکریپت واسط برای GUESTFISH (JUST A SHELL SCRIPT WRAPPER AROUND
       GUESTFISH)
       این دستور صرفاً یک اسکریپت پوسته ساده به عنوان واسط (wrapper) پیرامون
       دستور guestfish(1) "tar-in" است. برای هر کاری پیچیده‌تر از یک کپی ساده،
       احتمالاً بهتر است مستقیماً از guestfish استفاده کنید.

گزینه‌ها (OPTIONS)
       از آنجا که این اسکریپت پوسته گزینه‌ها را مستقیماً به guestfish منتقل
       می‌کند، برای مشاهده فهرست کامل گزینه‌ها صفحه راهنمای guestfish(1) را
       مطالعه کنید.

همچنین ببینید (SEE ALSO)
       guestfish(1), virt-cat(1), virt-copy-in(1), virt-copy-out(1),
       virt-edit(1), virt-make-fs(1), virt-tar-out(1), http://libguestfs.org.

نویسندگان (AUTHORS)
       Richard W.M. Jones ("rjones at redhat dot com")

حق نشر (COPYRIGHT)
       Copyright (C) 2011-2025 Red Hat Inc.

مجوز (LICENSE)
       این برنامه نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط «مجوز عمومی
       همگانی گنو» (GNU General Public License) همان‌گونه که توسط «بنیاد
       نرم‌افزار آزاد» (Free Software Foundation) منتشر شده است؛ چه نسخه ۲ مجوز
       یا (به انتخاب خودتان) هر نسخه بعدی، بازتوزیع کرده یا تغییر دهید.

       این برنامه به این امید توزیع شده است که مفید واقع شود، اما بدون هرگونه
       ضمانت؛ حتی بدون ضمانت ضمنی قابل فروش بودن یا مناسب بودن برای یک هدف
       خاص. برای جزئیات بیشتر به مجوز عمومی همگانی گنو مراجعه کنید.

       شما باید همراه با این برنامه یک نسخه از مجوز عمومی همگانی گنو دریافت
       کرده باشید؛ در غیر این صورت با بنیاد نرم‌افزار آزاد به نشانی زیر مکاتبه
       کنید:

       Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.

اشکالات (BUGS)
       برای دریافت فهرست باگ‌های libguestfs، از این پیوند استفاده کنید:
       https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools

       برای گزارش یک باگ جدید در libguestfs، از این پیوند استفاده کنید:
       https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools

       هنگام گزارش باگ، لطفاً موارد زیر را ارائه دهید:

       •   نسخه libguestfs.

       •   محل و نحوه دریافت libguestfs (مانند کدام توزیع لینوکس، کامپایل از
           سورس و غیره).

       •   اشکال را با دقت شرح دهید و روشی برای بازتولید آن مشخص کنید.

       •   دستور libguestfs-test-tool(1) را اجرا کرده و خروجی کامل و
           ویرایش‌نشده آن را درون گزارش اشکال قرار دهید.

libguestfs-1.60.1                 2026-07-14                    virt-tar-in(1)