.TH "pw-reserve" 1 "1.6.8" "PipeWire" \" -*- nroff -*-
.ad l
.nh
.SH "نام (NAME)"
pw-reserve \- ابزار رزرو دستگاه PipeWire

.PP
.SH "خلاصه دستور (SYNOPSIS)"
.PP

.PP
\fBpw-reserve\fP [\fIگزینه‌ها\fP]

.PP
.SH "توضیحات (DESCRIPTION)"
.PP

.PP
یک دستگاه را با استفاده از طرح رزرو دستگاه DBus با نام \fRorg\&.freedesktop\&.ReserveDevice1\fP [1] رزرو کرده و تا زمان خاتمه یافتن توسط \fRSIGINT\fP یا سیگنالی دیگر منتظر می‌ماند\&.

.PP
همچنین می‌تواند از سایر برنامه‌ها درخواست کند که یک دستگاه را آزاد کنند\&. این قابلیت می‌تواند برای وادار کردن سرورهای صوتی مانند PipeWire، Pulseaudio، JACK یا سایر برنامه‌هایی که از پروتکل رزرو دستگاه پیروی می‌کنند استفاده شود تا یک دستگاه را نادیده بگیرند، یا دستگاه صوتی در حال استفاده را آزاد کنند تا سایر برنامه‌ها بتوانند از آن بهره ببرند\&.

.PP
.SH "گزینه‌ها (OPTIONS)"
.PP

.PP
\fB-r | --release\fP
.RS 4
از هر کلاینتی که در حال حاضر دستگاه را در اختیار دارد درخواست می‌کند تا آن را آزاد کند، و پس از آن برای رزرو آن تلاش می‌نماید\&. اگر این گزینه داده نشود و دستگاه از قبل در حال استفاده باشد، \fBpw-reserve\fP با وضعیت خطا خارج می‌شود\&.
.RE
.PP
\fB-n NAME | --name=NAME\fP
.RS 4
نام دستگاه برای رزرو\&. طبق قرارداد، این مقدار عبارت است از:

.PP
.IP "\(bu" 2
Audio\fIN\fP: برای کارت ALSA با شماره \fIN\fP
.PP

.PP
دستور \fBpw-reserve\fP می‌تواند هر نام دستگاهی را رزرو کند، با این حال در حال حاضر PipeWire از مقادیری به غیر از موارد ذکرشده در بالا پشتیبانی نمی‌کند\&.
.RE
.PP

.PP
\fB-a NAME | --appname=NAME\fP
.RS 4
نام برنامه‌ای که هنگام رزرو دستگاه استفاده می‌شود\&.
.RE
.PP
\fB-p PRIO | --priority=PRIO\fP
.RS 4
اولویت مورد استفاده هنگام رزرو دستگاه\&.
.RE
.PP
\fB-m | --monitor\fP
.RS 4
پایش رزروهای یک دستگاه مشخص، به جای رزرو کردن آن\&.
.RE
.PP
\fB-h | --help\fP
.RS 4
نمایش راهنما\&.
.RE
.PP
\fB--version\fP
.RS 4
نمایش اطلاعات نسخه\&.
.RE
.PP
.SH "وضعیت خروج (EXIT STATUS)"
.PP

.PP
اگر رزرو دستگاه با موفقیت انجام شود، \fBpw-reserve\fP تا زمانی که با یک سیگنال متوقف نشود خاتمه نمی‌یابد\&. در این حالت، اگر با SIGINT یا SIGTERM پایان یابد، با وضعیت 0 خارج می‌شود\&.

.PP
در غیر این صورت، با وضعیت خروج غیرصفر خارج خواهد شد\&.

.PP
.SH "مثال‌ها (EXAMPLES)"
.PP

.PP
\fBpw-reserve\fP -n Audio0

.PP
کارت ALSA شماره 0 را رزرو کرده، و در صورتی که از قبل رزرو شده باشد با خطا خارج می‌شود\&.

.PP
\fBpw-reserve\fP -n Audio0 -r

.PP
کارت ALSA شماره 0 را رزرو کرده و از هر برنامه‌ای که دستگاه را رزرو کرده می‌خواهد تا آن را برای ما آزاد کند\&.

.PP
.SH "نویسندگان (AUTHORS)"
.PP

.PP
توسعه‌دهندگان PipeWire <https://gitlab.freedesktop.org/pipewire/pipewire/issues>؛ پروژه PipeWire در <https://pipewire.org> در دسترس است\&.

.PP
.SH "همچنین ببینید (SEE ALSO)"
.PP

.PP
[1] https://git.0pointer.net/reserve.git/tree/reserve.txt \- طرحی ساده برای رزرو دستگاه با DBus