.\" -*- 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-tail 1" .TH virt-tail 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\-tail \- دنبال کردن و نمایش انتهای فایل‌های لاگ ماشین مجازی .SH "خلاصه دستور (SYNOPSIS)" .IX Header "SYNOPSIS" .Vb 1 \& virt\-tail [\-\-options] \-d domname file [file ...] \& \& virt\-tail [\-\-options] \-a disk.img [\-a disk.img ...] file [file ...] .Ve .SH "توضیحات (DESCRIPTION)" .IX Header "DESCRIPTION" دستور \&\f(CW\*(C`virt\-tail\*(C'\fR ابزاری در خط فرمان برای دنبال کردن (tail) محتویات \&\f(CW\*(C`file\*(C'\fR است، در حالی که \&\f(CW\*(C`file\*(C'\fR درون ماشین مجازی مشخص‌شده (یا ایمیج دیسک) قرار دارد. عملکرد آن مشابه دستور معمول \&\f(CW\*(C`tail\ \-f\*(C'\fR است. .PP می‌توان چندین نام فایل را مشخص کرد که در این صورت هر یک به‌طور جداگانه دنبال می‌شوند. هر نام فایل باید یک مسیر کامل باشد که از دایرکتوری ریشه (شروع با \*(Aq/\*(Aq) آغاز می‌شود. .PP اجرای این دستور تا زمان رخ دادن یکی از شرایط زیر ادامه می‌یابد: .IP \(bu 4 کاربر کلیدهای ^C را بفشارد یا یک سیگنال وقفه دریافت شود. .IP \(bu 4 هیچ‌یک از فایل‌های فهرست‌شده در سیستم مهمان یافت نشود یا همگی حذف شوند. .IP \(bu 4 یک خطای غیرقابل‌برگشت رخ دهد. .SH "مثال‌ها (EXAMPLES)" .IX Header "EXAMPLES" دنبال کردن فایل \&\fI/var/log/messages\fR درون یک ماشین مجازی با نام \&\f(CW\*(C`mydomain\*(C'\fR: .PP .Vb 1 \& virt\-tail \-d mydomain /var/log/messages .Ve .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 که باید یک ایمیج دیسک از ماشین مجازی باشد. اگر ماشین مجازی دارای چندین دستگاه بلاکی است، باید همه آن‌ها را با گزینه‌های \&\fI\-a\fR جداگانه مشخص کنید. .Sp قالب ایمیج دیسک به‌طور خودکار تشخیص داده می‌شود. برای بازنویسی این حالت و تحمیل یک قالب خاص، از گزینه \&\fI\-\-format=..\fR استفاده کنید. .IP "\fB\-a URI\fR" 4 .IX Item "-a URI" .PD 0 .IP "\fB\-\-add URI\fR" 4 .IX Item "--add URI" .PD افزودن یک دیسک دوردست. بخش "ADDING REMOTE STORAGE" در \&\fBguestfish\fR\|(1) را ببینید. .IP \fB\-\-blocksize=512\fR 4 .IX Item "--blocksize=512" .PD 0 .IP \fB\-\-blocksize=4096\fR 4 .IX Item "--blocksize=4096" .IP \fB\-\-blocksize\fR 4 .IX Item "--blocksize" .PD این پارامتر اندازه سکتور ایمیج دیسک را تعیین می‌کند. این مقدار بر روی تمام دیسک‌های بعدی که پس از این پارامتر به‌طور صریح اضافه می‌شوند تأثیر می‌گذارد. استفاده از \&\fI\-\-blocksize\fR بدون آرگومان، اندازه سکتور دیسک را به مقدار پیش‌فرض که معمولاً ۵۱۲ بایت است تغییر می‌دهد. همچنین بخش "guestfs_add_drive_opts" در \&\fBguestfs\fR\|(3) را ببینید. .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\-\-echo\-keys\fR 4 .IX Item "--echo-keys" هنگام درخواست کلیدها و گذرواژه‌ها، virt\-tail معمولاً اکو کردن را غیرفعال می‌کند تا نتوانید آنچه تایپ می‌کنید را ببینید. اگر نگران حملات تمپست (Tempest) نیستید و شخص دیگری در اتاق حضور ندارد، می‌توانید این فلگ را مشخص کنید تا متن تایپ‌شده را ببینید. .IP \fB\-f\fR 4 .IX Item "-f" .PD 0 .IP \fB\-\-follow\fR 4 .IX Item "--follow" .PD این گزینه نادیده گرفته می‌شود. دستور virt\-tail همیشه مانند \&\fBtail\fR\|(1)\ \fI\-f\fR عمل می‌کند. نیازی به مشخص کردن گزینه \&\fI\-f\fR نیست. .IP \fB\-\-format=raw|qcow2|..\fR 4 .IX Item "--format=raw|qcow2|.." .PD 0 .IP \fB\-\-format\fR 4 .IX Item "--format" .PD حالت پیش‌فرض برای گزینه \&\fI\-a\fR تشخیص خودکار قالب ایمیج دیسک است. استفاده از این گزینه، قالب دیسک را برای گزینه‌های \&\fI\-a\fR بعدی در خط فرمان اجباری می‌کند. استفاده از \&\fI\-\-format\fR بدون آرگومان، حالت تشخیص خودکار را برای گزینه‌های \&\fI\-a\fR بعدی بازمی‌گرداند. .Sp برای مثال: .Sp .Vb 1 \& virt\-tail \-\-format=raw \-a disk.img file .Ve .Sp قالب خام (بدون تشخیص خودکار) را برای \&\fIdisk.img\fR اجباری می‌کند. .Sp .Vb 1 \& virt\-tail \-\-format=raw \-a disk.img \-\-format \-a another.img file .Ve .Sp قالب خام (بدون تشخیص خودکار) را برای \&\fIdisk.img\fR اجباری کرده و برای \&\fIanother.img\fR به حالت تشخیص خودکار بازمی‌گردد. .Sp اگر ایمیج‌های دیسک مهمان با قالب خام غیرقابل‌اعتماد دارید، باید از این گزینه برای تعیین قالب دیسک استفاده کنید. این کار از یک مشکل امنیتی احتمالی با مهمان‌های مخرب جلوگیری می‌کند (CVE\-2010\-3851). .IP "\fB\-\-key\fR SELECTOR" 4 .IX Item "--key SELECTOR" مشخص کردن کلید برای LUKS، جهت بازگشایی خودکار دستگاه LUKS هنگام استفاده از بازرسی (inspection). .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 شناسه یکتای (UUID) دستگاه است. عبارت \&\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 dev[:mountpoint[:options[:fstype]]]" 4 .IX Item "-m dev[:mountpoint[:options[:fstype]]]" .PD 0 .IP "\fB\-\-mount\fR dev[:mountpoint[:options[:fstype]]]" 4 .IX Item "--mount dev[:mountpoint[:options[:fstype]]]" .PD سوار کردن (mount) پارتیشن یا حجم منطقی نام‌برده‌شده روی نقطه اتصال (mountpoint) داده‌شده. .Sp اگر نقطه اتصال مشخص نشود، مقدار پیش‌فرض آن \&\fI/\fR خواهد بود. .Sp مشخص کردن هر نقطه اتصال، بازرسی مهمان و سوار کردن ریشه و تمام نقاط اتصال آن را غیرفعال می‌کند؛ بنابراین اطمینان حاصل کنید که تمام نقاط اتصال لازم برای کار با نام فایل‌های ارائه‌شده به عنوان آرگومان را سوار کرده‌اید. .Sp اگر نمی‌دانید یک ایمیج دیسک شامل چه سیستم‌فایل‌هایی است، می‌توانید guestfish را بدون این گزینه اجرا کرده و پارتیشن‌ها، سیستم‌فایل‌ها و LVهای موجود را فهرست کنید (دستورات "list\-partitions"، "list\-filesystems" و "lvs" را ببینید)، یا می‌توانید از برنامه \&\fBvirt\-filesystems\fR\|(1) استفاده کنید. .Sp بخش سوم (و به‌ندرت استفاده‌شده) پارامتر mount، فهرستی از گزینه‌های mount است که برای سوار کردن سیستم‌فایل زیرین استفاده می‌شود. اگر این بخش مشخص نشود، گزینه‌های mount یا رشته خالی یا \&\f(CW\*(C`ro\*(C'\fR خواهند بود (حالت دوم در صورت استفاده از فلگ \&\fI\-\-ro\fR است). با تعیین گزینه‌های mount، این انتخاب پیش‌فرض را بازنویسی می‌کنید. احتمالاً تنها زمانی از این قابلیت استفاده می‌کنید که بخواهید در صورت پشتیبانی سیستم‌فایل، ACLها و/یا ویژگی‌های گسترش‌یافته (extended attributes) را فعال کنید: .Sp .Vb 1 \& \-m /dev/sda1:/:acl,user_xattr .Ve .Sp استفاده از این فلگ معادل استفاده از دستور \&\f(CW\*(C`mount\-options\*(C'\fR است. .Sp بخش چهارم پارامتر، درایور سیستم‌فایلی است که باید استفاده شود، مانند \&\f(CW\*(C`ext3\*(C'\fR یا \&\f(CW\*(C`ntfs\*(C'\fR. این بخش به‌ندرت مورد نیاز است، اما اگر چندین درایور برای یک سیستم‌فایل معتبر باشند (مانند \f(CW\*(C`ext2\*(C'\fR و \f(CW\*(C`ext3\*(C'\fR) یا اگر libguestfs سیستم‌فایل را اشتباه تشخیص دهد، می‌تواند مفید باشد. .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\-x\fR 4 .IX Item "-x" فعال کردن ردگیری فراخوانی‌های API در libguestfs. .SH "فایل‌های لاگ (LOG FILES)" .IX Header "LOG FILES" برای فهرست کردن فایل‌های لاگ از سیستم‌های مهمان، ابزار مرتبط \&\fBvirt\-log\fR\|(1) را ببینید. این ابزار قالب‌های باینری لاگ مانند ژورنال systemd را درک می‌کند. .SH "مسیرهای ویندوز (WINDOWS PATHS)" .IX Header "WINDOWS PATHS" دستور \&\f(CW\*(C`virt\-tail\*(C'\fR توانایی محدودی در درک حروف درایو و مسیرهای ویندوز دارد (مانند \fIE:\efoo\ebar.txt\fR). .PP اگر و فقط اگر سیستم مهمان در حال اجرای ویندوز باشد: .IP \(bu 4 پیشوندهای حرف درایو مانند \&\f(CW\*(C`C:\*(C'\fR با مراجعه به رجیستری ویندوز با سیستم‌فایل صحیح تطبیق داده می‌شوند. .IP \(bu 4 هر نویسه بک‌اسلش (\f(CW\*(C`\e\*(C'\fR) در مسیر با اسلش جایگزین می‌شود تا libguestfs بتواند آن را پردازش کند. .IP \(bu 4 مسیر بدون حساسیت به حروف کوچک و بزرگ پردازش می‌شود تا فایلی که باید نمایش داده شود مشخص گردد. .PP برخی کاستی‌های شناخته‌شده وجود دارد: .IP \(bu 4 ممکن است برخی پیوندهای نمادین NTFS به‌درستی دنبال نشوند. .IP \(bu 4 نقاط اتصال (junction points) در NTFS که بین سیستم‌فایل‌های مختلف عبور می‌کنند دنبال نمی‌شوند. .SH "وضعیت خروج (EXIT STATUS)" .IX Header "EXIT STATUS" این برنامه در صورت موفقیت مقدار ۰ و در صورت بروز خطا مقداری غیر از صفر را برمی‌گرداند. .SH "همچنین ببینید (SEE ALSO)" .IX Header "SEE ALSO" \&\fBguestfs\fR\|(3), \&\fBguestfish\fR\|(1), \&\fBvirt\-copy\-out\fR\|(1), \&\fBvirt\-cat\fR\|(1), \&\fBvirt\-log\fR\|(1), \&\fBvirt\-tar\-out\fR\|(1), \&\fBtail\fR\|(1), . .SH "نویسنده (AUTHOR)" .IX Header "AUTHOR" Richard W.M. Jones .SH "حق نشر (COPYRIGHT)" .IX Header "COPYRIGHT" Copyright (C) 2016 Red Hat Inc. .SH "مجوز (LICENSE)" .IX Header "LICENSE" این برنامه یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط «مجوز عمومی همگانی گنو» (GNU General Public License) همان‌طور که توسط «بنیاد نرم‌افزار آزاد» (Free Software Foundation) منتشر شده است؛ چه نسخه ۲ مجوز یا (به انتخاب خودتان) هر نسخه بعدی، بازتوزیع کرده و/یا تغییر دهید. .PP این برنامه به این امید توزیع شده است که مفید واقع شود، اما بدون هیچ‌گونه ضمانت؛ حتی بدون ضمانت ضمنی قابل فروش بودن یا مناسب بودن برای یک هدف خاص. برای جزئیات بیشتر «مجوز عمومی همگانی گنو» را ببینید. .PP شما باید یک نسخه از «مجوز عمومی همگانی گنو» را به همراه این برنامه دریافت کرده باشید؛ در غیر این صورت، به بنیاد نرم‌افزار آزاد به آدرس زیر بنویسید: .PP .nf Free Software Foundation, Inc. 51 Franklin Street, Fifth Floor Boston, MA 02110-1301 USA .fi .SH "اشکالات (BUGS)" .IX Header "BUGS" برای دریافت فهرستی از اشکالات مربوط به libguestfs، از این پیوند استفاده کنید: .PP .PP برای گزارش یک اشکال جدید در libguestfs، از این پیوند استفاده کنید: .PP .PP هنگام گزارش اشکال، لطفاً موارد زیر را ارائه دهید: .IP \(bu 4 نسخه libguestfs. .IP \(bu 4 محل دریافت libguestfs (برای مثال کدام توزیع لینوکس، کامپایل از کد منبع و غیره). .IP \(bu 4 اشکال را به‌دقت شرح دهید و روشی برای بازتولید آن ارائه دهید. .IP \(bu 4 برنامه \&\fBlibguestfs\-test\-tool\fR\|(1) را اجرا کرده و خروجی \fBکامل و ویرایش‌نشده\fR آن را درون گزارش اشکال قرار دهید.