.\" Man page generated from reStructuredText
.\" by the Docutils 0.23 manpage writer.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "QEMU-PR-HELPER" "8" "Aug 28, 2026" "11.1.1" "QEMU"
.SH "نام (NAME)"
qemu-pr-helper \- برنامه کمکی رزرو پایدار در QEMU
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBqemu\-pr\-helper\fP [\fIگزینه‌ها\fP]
.SH "توضیحات (DESCRIPTION)"
.sp
برنامه کمکی رزرو پایدار (persistent reservation) را برای QEMU پیاده‌سازی می‌کند.
.sp
رزروهای پایدار SCSI امکان محدود کردن دسترسی به دستگاه‌های بلوکی را به آغازگرهای (initiators) خاص در یک ساختار ذخیره‌سازی اشتراکی فراهم می‌آورند. هنگام پیاده‌سازی خوشه‌بندی ماشین‌های مجازی، ارسال دستورات رزرو پایدار SCSI توسط ماشین‌های مجازی یک نیاز متداول است. با این حال، سیستم‌عامل ارسال این دستورات را برای برنامه‌های غیرممتاز محدود می‌کند، زیرا استفاده نادرست از آن‌ها می‌تواند کارکرد عادی بستر ذخیره‌سازی را مختل کند. دستگاه‌های عبور مستقیم (passthrough) اسکازی در QEMU شامل
\fBscsi\-block\fP
و
\fBscsi\-generic\fP
از ارسال درخواست‌های رزرو پایدار سیستم میهمان به یک برنامه کمکی ممتاز خارجی پشتیبانی می‌کنند.
\fBqemu\-pr\-helper\fP
همان برنامه کمکی خارجی است؛ این برنامه یک سوکت شنونده ایجاد می‌کند که اتصالات ورودی را برای ارتباط با QEMU می‌پذیرد.
.sp
اگر مایلید ماشین‌های مجازی را در چنین ساختاری اجرا کنید، این برنامه کمکی باید به‌صورت یک سرویس سیستمی اجرا شود، و برای آگاهی از نحوه پیکربندی QEMU جهت اتصال به سوکت ایجادشده توسط
\fBqemu\-pr\-helper\fP
باید بخش \(dqمدیران رزرو پایدار\(dq (persistent reservation managers) در راهنمای QEMU را مطالعه کنید.
.sp
پس از اتصال به سوکت،
\fBqemu\-pr\-helper\fP
می‌تواند به‌طور اختیاری مجوزهای ریشه (root) را رها کند، به‌جز قابلیت‌هایی (capabilities) که برای کارکرد آن مورد نیاز است.
.sp
همچنین
\fBqemu\-pr\-helper\fP
می‌تواند از پروتکل فعال‌سازی سوکت systemd استفاده کند. در این حالت، واحد سوکت systemd باید یک سوکت جریانی یونیکس (Unix stream socket) را مشخص کند، مانند زیر:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[Socket]
ListenStream=/var/run/qemu\-pr\-helper.sock
.EE
.UNINDENT
.UNINDENT
.SH "گزینه‌ها (OPTIONS)"
.INDENT 0.0
.TP
.B \-d, \-\-daemon
اجرا در پس‌زمینه (و ایجاد یک فایل PID).
.UNINDENT
.INDENT 0.0
.TP
.B \-q, \-\-quiet
کاهش جزئیات خروجی.
.UNINDENT
.INDENT 0.0
.TP
.B \-v, \-\-verbose
افزایش جزئیات خروجی.
.UNINDENT
.INDENT 0.0
.TP
.B \-f, \-\-pidfile=PATH
فایل PID هنگام اجرا به‌صورت دیمون. به‌طور پیش‌فرض، فایل PID در دایرکتوری وضعیت زمان اجرای سیستم ایجاد می‌شود، برای مثال
\fB/var/run/qemu\-pr\-helper.pid\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \-k, \-\-socket=PATH
مسیر سوکت. به‌طور پیش‌فرض، سوکت در دایرکتوری وضعیت زمان اجرای سیستم ایجاد می‌شود، برای مثال
\fB/var/run/qemu\-pr\-helper.sock\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \-T, \-\-trace [[enable=]PATTERN][,events=FILE][,file=FILE]
مشخص کردن گزینه‌های ردیابی.
.sp
\fB[enable=]PATTERN\fP
.INDENT 7.0
.INDENT 3.5
فعال‌سازی فوری رویدادهای منطبق با
\fIPATTERN\fP
(نام رویداد یا یک الگوی تطبیق glob). این گزینه تنها در صورتی در دسترس است که QEMU با یکی از بک‌اندهای ردیابی
\fBsimple\fP\fR،\fP \fBlog\fP
یا
\fBftrace\fP
کامپایل شده باشد. برای تعیین چند رویداد یا الگو، گزینه
\fB\-trace\fP
را چندین بار مشخص کنید.
.sp
برای چاپ فهرستی از نام‌های نقاط ردیابی، از
\fB\-trace help\fP
استفاده کنید.
.UNINDENT
.UNINDENT
.sp
\fBevents=FILE\fP
.INDENT 7.0
.INDENT 3.5
فعال‌سازی فوری رویدادهای فهرست‌شده در
\fIFILE\fP\&.
این فایل باید در هر خط شامل نام یک رویداد (همان‌طور که در فایل
\fBtrace\-events\-all\fP
فهرست شده است) باشد؛ الگوهای تطبیق glob نیز پذیرفته می‌شوند. این گزینه تنها در صورتی در دسترس است که QEMU با یکی از بک‌اندهای ردیابی
\fBsimple\fP\fR،\fP \fBlog\fP
یا
\fBftrace\fP
کامپایل شده باشد.
.UNINDENT
.UNINDENT
.sp
\fBfile=FILE\fP
.INDENT 7.0
.INDENT 3.5
ثبت ردپاهای خروجی در
\fIFILE\fP\&.
این گزینه تنها در صورتی در دسترس است که QEMU با بک‌اند ردیابی
\fBsimple\fP
کامپایل شده باشد.
.UNINDENT
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B \-u, \-\-user=USER
کاربری که مجوزها به آن کاهش می‌یابد.
.UNINDENT
.INDENT 0.0
.TP
.B \-g, \-\-group=GROUP
گروهی که مجوزها به آن کاهش می‌یابد.
.UNINDENT
.INDENT 0.0
.TP
.B \-h, \-\-help
نمایش پیام راهنما و خروج.
.UNINDENT
.INDENT 0.0
.TP
.B \-V, \-\-version
نمایش اطلاعات نسخه و خروج.
.UNINDENT
.SH "حق نشر (COPYRIGHT)"
2026, The QEMU Project Developers
.\" End of generated man page.