نام (NAME)

qemu-pr-helper - برنامه کمکی رزرو پایدار در QEMU

خلاصه دستور (SYNOPSIS)

qemu-pr-helper [گزینه‌ها]

توضیحات (DESCRIPTION)

برنامه کمکی رزرو پایدار (persistent reservation) را برای QEMU پیاده‌سازی می‌کند.

رزروهای پایدار SCSI امکان محدود کردن دسترسی به دستگاه‌های بلوکی را به آغازگرهای (initiators) خاص در یک ساختار ذخیره‌سازی اشتراکی فراهم می‌آورند. هنگام پیاده‌سازی خوشه‌بندی ماشین‌های مجازی، ارسال دستورات رزرو پایدار SCSI توسط ماشین‌های مجازی یک نیاز متداول است. با این حال، سیستم‌عامل ارسال این دستورات را برای برنامه‌های غیرممتاز محدود می‌کند، زیرا استفاده نادرست از آن‌ها می‌تواند کارکرد عادی بستر ذخیره‌سازی را مختل کند. دستگاه‌های عبور مستقیم (passthrough) اسکازی در QEMU شامل scsi-block و scsi-generic از ارسال درخواست‌های رزرو پایدار سیستم میهمان به یک برنامه کمکی ممتاز خارجی پشتیبانی می‌کنند. qemu-pr-helper همان برنامه کمکی خارجی است؛ این برنامه یک سوکت شنونده ایجاد می‌کند که اتصالات ورودی را برای ارتباط با QEMU می‌پذیرد.

اگر مایلید ماشین‌های مجازی را در چنین ساختاری اجرا کنید، این برنامه کمکی باید به‌صورت یک سرویس سیستمی اجرا شود، و برای آگاهی از نحوه پیکربندی QEMU جهت اتصال به سوکت ایجادشده توسط qemu-pr-helper باید بخش "مدیران رزرو پایدار" (persistent reservation managers) در راهنمای QEMU را مطالعه کنید.

پس از اتصال به سوکت، qemu-pr-helper می‌تواند به‌طور اختیاری مجوزهای ریشه (root) را رها کند، به‌جز قابلیت‌هایی (capabilities) که برای کارکرد آن مورد نیاز است.

همچنین qemu-pr-helper می‌تواند از پروتکل فعال‌سازی سوکت systemd استفاده کند. در این حالت، واحد سوکت systemd باید یک سوکت جریانی یونیکس (Unix stream socket) را مشخص کند، مانند زیر:

[Socket]
ListenStream=/var/run/qemu-pr-helper.sock

گزینه‌ها (OPTIONS)

-d, --daemon: اجرا در پس‌زمینه (و ایجاد یک فایل PID).

-q, --quiet: کاهش جزئیات خروجی.

-v, --verbose: افزایش جزئیات خروجی.

-f, --pidfile=PATH: فایل PID هنگام اجرا به‌صورت دیمون. به‌طور پیش‌فرض، فایل PID در دایرکتوری وضعیت زمان اجرای سیستم ایجاد می‌شود، برای مثال /var/run/qemu-pr-helper.pid.

-k, --socket=PATH: مسیر سوکت. به‌طور پیش‌فرض، سوکت در دایرکتوری وضعیت زمان اجرای سیستم ایجاد می‌شود، برای مثال /var/run/qemu-pr-helper.sock.

-T, --trace [[enable=]PATTERN][,events=FILE][,file=FILE]: مشخص کردن گزینه‌های ردیابی.
[enable=]PATTERN

فعال‌سازی فوری رویدادهای منطبق با PATTERN (نام رویداد یا یک الگوی تطبیق glob). این گزینه تنها در صورتی در دسترس است که QEMU با یکی از بک‌اندهای ردیابی simple، log یا ftrace کامپایل شده باشد. برای تعیین چند رویداد یا الگو، گزینه -trace را چندین بار مشخص کنید.

برای چاپ فهرستی از نام‌های نقاط ردیابی، از -trace help استفاده کنید.

events=FILE

فعال‌سازی فوری رویدادهای فهرست‌شده در FILE. این فایل باید در هر خط شامل نام یک رویداد (همان‌طور که در فایل trace-events-all فهرست شده است) باشد؛ الگوهای تطبیق glob نیز پذیرفته می‌شوند. این گزینه تنها در صورتی در دسترس است که QEMU با یکی از بک‌اندهای ردیابی simple، log یا ftrace کامپایل شده باشد.

file=FILE

ثبت ردپاهای خروجی در FILE. این گزینه تنها در صورتی در دسترس است که QEMU با بک‌اند ردیابی simple کامپایل شده باشد.

-u, --user=USER: کاربری که مجوزها به آن کاهش می‌یابد.

-g, --group=GROUP: گروهی که مجوزها به آن کاهش می‌یابد.

-h, --help: نمایش پیام راهنما و خروج.

-V, --version: نمایش اطلاعات نسخه و خروج.

حق نشر (COPYRIGHT)

2026, The QEMU Project Developers