.\" Process this file with
.\" groff -man -Tascii aj-snapshot.1
.\"
.TH AJ-SNAPSHOT 1 "NOVEMBER 2011" Linux "User Manuals"
.SH "نام (NAME)"
aj-snapshot \- ذخیره و بازیابی اتصالات صوتی ALSA و JACK
.SH "خلاصه دستور (SYNOPSIS)"
.B aj-snapshot \fR[ \fB-adfjqrx\fR ] [ \fB-p \fIpolling_interval\fR ] [ \fB-i \fIclient_name\fR ]... [ \fIFILE\fR ]
.SH "توضیحات (DESCRIPTION)"
برنامه \fBaj-snapshot\fR ابزار کوچکی است که برای تهیه وضعیت فوری (اسنپ‌شات) از اتصالات برقرار شده میان کلاینت‌های JACK و/یا ALSA استفاده می‌شود. از آنجا که JACK می‌تواند هر دو پشتیبانی صوتی و MIDI را برای برنامه‌ها فراهم کند، \fBaj-snapshot\fR می‌تواند هر دو نوع اتصال را برای JACK ذخیره کند. از سوی دیگر، ALSA تنها امکانات مسیریابی را برای کلاینت‌های MIDI فراهم می‌کند. اگر \fBaj-snapshot\fR را بدون هیچ گزینه‌ای اجرا کنید، تمام اتصالات فعلی ALSA \fBو\fR JACK را در \fIFILE\fR ذخیره می‌کند. این پرونده یک پرونده XML خواهد بود و در صورت تمایل به ویرایش دستی، می‌توانید از یک ویرایشگر متن استفاده کنید.
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB-a \fR, \fB--alsa\fR
.IP ""
تنها ذخیره یا بازیابی اتصالات MIDI در ALSA. در حالت دیمن (daemon) نیز کار می‌کند.
.PP
\fB-d \fR, \fB--daemon\fR
.IP ""
اجرای \fBaj-snapshot\fR در حالت دیمن. برنامه \fBaj-snapshot\fR ابتدا تلاش می‌کند تا اتصالات را از پرونده اسنپ‌شات مشخص‌شده بازیابی کند. پس از آن، منتظر می‌ماند تا درگاه‌های جدیدی در ALSA یا JACK ثبت شوند. به‌طور پیش‌فرض، \fBaj-snapshot\fR هر ثانیه بررسی می‌کند که آیا درگاه‌های جدیدی در ALSA یا JACK ثبت شده‌اند یا خیر. در این صورت، تلاش می‌کند اتصالات را از پرونده اسنپ‌شات شما بازیابی نماید. اگر \fBaj-snapshot\fR را در حالت دیمن اجرا کنید، نیازی به مشخص کردن پرچم \fB-r\fR،\fB--restore\fR نیست چرا که به هر حال به صورت ضمنی اعمال می‌شود.
.IP ""
اگر سیگنال HUP را به دیمن بفرستید، دیمن پرونده اسنپ‌شات را دوباره بارگذاری می‌کند. این امکان را به شما می‌دهد تا بازیابی اتصالات را فعال کنید. برای مشاهده مثالی از نحوه انجام این کار، بخش «مثال‌ها» را در ادامه ببینید. هنگامی که حالت دیمن را با گزینه \fB-x\fR،\fB--remove\fR ترکیب کنید، ارسال سیگنال HUP به دیمن پیش از بازیابی، تمامی اتصالات را پاک خواهد کرد.
.IP ""
هنگامی که سرور JACK در حین اجرای \fBaj-snapshot\fR در حالت دیمن متوقف شود (یا دچار فروپاشی گردد)، \fBaj-snapshot\fR تلاش می‌کند تا به اجرای خود ادامه دهد. هنگامی که سرور JACK بعداً دوباره راه‌اندازی شود، \fBaj-snapshot\fR به‌طور خودکار مجدداً متصل می‌شود و در صورت نیاز اتصالات شما را بازیابی می‌کند.
.PP
\fB-f \fR, \fB--force\fR
.IP ""
هنگامی که تلاش می‌کنید یک اسنپ‌شات را روی یک پرونده موجود ذخیره کنید، \fBaj-snapshot\fR از شما می‌پرسد که آیا می‌خواهید آن پرونده را بازنویسی کنید. با این گزینه، می‌توانید \fBaj-snapshot\fR را مجبور به بازنویسی آن پرونده کنید.
.PP
\fB-j \fR, \fB--jack\fR
.IP ""
تنها ذخیره یا بازیابی اتصالات صوتی و MIDI در JACK. در حالت دیمن نیز کار می‌کند.
.PP
\fB-p \fIinterval\fR, \fB--poll=\fIinterval
.IP ""
هر زمان که برنامه‌ای درگاهی را در ALSA یا JACK ثبت کند، \fBaj-snapshot\fR بررسی می‌کند که آیا اتصالاتی در پرونده اسنپ‌شات وجود دارند که باید بازیابی شوند یا خیر. به‌طور پیش‌فرض، \fBaj-snapshot\fR هر ثانیه (۱۰۰۰ میلی‌ثانیه) وجود درگاه‌های جدید را بررسی (poll) می‌کند. با این گزینه می‌توانید تعیین کنید که \fBaj-snapshot\fR هر چند وقت یک‌بار باید درگاه‌های جدید را بررسی کند. مقدار \fIinterval\fR باید بر حسب میلی‌ثانیه مشخص شود.
.PP
\fB-q \fR, \fB--quiet\fR
.IP ""
هیچ اطلاعاتی درباره اتصالاتی که ذخیره یا بازیابی می‌شوند چاپ نشود.
.PP
\fB-r \fR, \fB--restore\fR
.IP ""
هنگامی که پرچم \fB-r\fR را مشخص می‌کنید، \fBaj-snapshot\fR تلاش می‌کند تمامی اتصالات ALSA و JACK را از \fIFILE\fR بازیابی کند (بدون آن، \fBaj-snapshot\fR تلاش خواهد کرد تا اتصالات را در \fIFILE\fR \fBذخیره\fR کند). اگر می‌خواهید تنها اتصالات ALSA یا JACK را بازیابی کنید، می‌توانید این گزینه را با گزینه‌های \fB-a\fR یا \fB-j\fR ترکیب کنید.
.PP
\fB-x \fR, \fB--remove\fR
.IP ""
گزینه \fB-x\fR می‌تواند هنگام بازیابی اتصالات یا هنگام اجرا در حالت دیمن استفاده شود. با این گزینه، \fBaj-snapshot\fR تمام اتصالات موجود را پیش از بازیابی پرونده اسنپ‌شات حذف می‌کند. هنگامی که آن را با گزینه \fB-a\fR یا \fB-j\fR ترکیب کنید، تنها اتصالات مربوط به زیرسیستم مشخص‌شده (ALSA یا JACK) حذف خواهند شد. بدون گزینه \fB-x\fR، \fBaj-snapshot\fR تلاش خواهد کرد تا اتصالات را بر روی اتصالاتی که در حال حاضر فعال هستند بازیابی کند.
.IP ""
یک روش دیگر نیز برای استفاده از گزینه \fB-x\fR وجود دارد. اگر \fBaj-snapshot\fR را بدون آرگومان \fIFILE\fR فراخوانی کنید، می‌توانید از گزینه \fB-x\fR برای حذف تمامی اتصالات موجود ALSA و JACK (بدون انجام هیچ کار دیگری) استفاده کنید. همانند قبل می‌توانید آن را با گزینه‌های \fB-a\fR یا \fB-j\fR ترکیب کنید.
.PP
\fB-i \fIclient_name\fR, \fB--ignore=\fIclient_name
.IP ""
می‌توانید از این گزینه برای مشخص کردن یک یا چند کلاینت که باید توسط \fBaj-snapshot\fR نادیده گرفته شوند استفاده کنید. می‌توانید نام کلاینت را بعد از گزینه \fB-i\fR بنویسید، و مجاز به استفاده از الگوهای نویسه عام (wildcard / انطباق معمولی شل) در آن رشته هستید. اگر آن نام شامل فاصله یا نویسه‌های دیگری باشد که برای شل معنای خاصی دارند، باید نام را درون نقل‌قول تکی (امن‌ترین حالت) یا دوگانه قرار دهید. برای دانستن نام یک کلاینت، می‌توانید یک اسنپ‌شات ذخیره کرده و نام را در پرونده اسنپ‌شات جستجو کنید. اگر می‌خواهید چندین کلاینت را نادیده بگیرید، باید گزینه \fB-i\fR را با نام کلاینت‌های مختلف تکرار کنید (حداکثر ۵۰ کلاینت).
.PP
\fB-h \fR, \fB--help\fR
.IP ""
چاپ یک پیام راهنمای کوتاه
.SH "مثال‌ها (EXAMPLES)"
.PP
.B aj-snapshot test.snap
.IP ""
یک اسنپ‌شات از تمامی اتصالات فعلی ALSA و JACK را در پرونده‌ای به نام \(dqtest.snap\(dq ذخیره می‌کند. اگر آن پرونده از قبل وجود داشته باشد، aj-snapshot از شما می‌پرسد که آیا می‌خواهید آن را بازنویسی کنید.
.PP
.B aj-snapshot -r test.snap
.IP ""
تمامی اتصالات ALSA و JACK را از پرونده \(dqtest.snap\(dq بازیابی می‌کند. این کار هرگونه اتصال فعال دیگر را دست‌نخورده باقی می‌گذارد.
.PP
.B aj-snapshot -xr test.snap
.IP ""
تمامی اتصالات ALSA و JACK را از پرونده \(dqtest.snap\(dq بازیابی می‌کند، اما ابتدا همه اتصالات موجود را حذف می‌نماید.
.PP
.B aj-snapshot -a test.snap
.IP ""
تمامی اتصالات فعلی ALSA را در \(dqtest.snap\(dq ذخیره می‌کند.
.PP
.B aj-snapshot -rj test.snap
.IP ""
تمامی اتصالات JACK را از \(dqtest.snap\(dq بازیابی می‌کند. این بدان معناست که اتصالات ALSA که ممکن است در پرونده ذخیره شده باشند بازیابی نخواهند شد.
.PP
.B aj-snapshot -qfj test.snap
.IP ""
تمامی اتصالات فعلی JACK را در \(dqtest.snap\(dq ذخیره می‌کند. هیچ اطلاعاتی را در خروجی استاندارد چاپ نمی‌کند (بی‌صدا)، و در صورتی که \(dqtest.snap\(dq از قبل وجود داشته باشد آن را با اجبار بازنویسی می‌کند.
.PP
.B aj-snapshot -ax
.IP ""
تمامی اتصالات ALSA را حذف می‌کند.
.PP
.B aj-snapshot -d test.snap &
.IP ""
برنامه aj-snapshot را در حالت دیمن اجرا کرده و آن را به یک فرآیند پس‌زمینه (&) تبدیل می‌کند. هر زمان که یک کلاینت جدید ALSA یا JACK درگاهی را ثبت کند، اتصالات از test.snap بازیابی خواهند شد.
.PP
.B aj-snapshot -djx test.snap &
.IP ""
برنامه aj-snapshot را در حالت دیمن برای اتصالات JACK در \(dqtest.snap\(dq اجرا می‌کند. هر زمان که اتصالات از test.snap بازیابی شوند، تمامی اتصالات موجود JACK حذف خواهند شد.
.PP
1)
.B aj-snapshot -d test.snap &
.br
2)
.B aj-snapshot -f test.snap
.br
3)
.B kill -HUP $(pidof aj-snapshot)
.IP ""
1) ابتدا aj-snapshot را در حالت دیمن با پرونده \(dqtest.snap\(dq راه‌اندازی کنید.
.br
2) پس از ایجاد تغییراتی در اتصالات، نمونه دومی از aj-snapshot (که در حالت دیمن اجرا نمی‌شود) آن پرونده را با وضعیت جدید اتصالات بازنویسی می‌کند.
.br
3) سیگنال HANGUP را به دیمن بفرستید تا پرونده را با وضعیت جدید اتصالات دوباره بارگذاری کند (به \(aqman kill\(aq و \(aqman pidof\(aq مراجعه کنید).
.SH "نویسندگان (AUTHORS)"
نوشته شده توسط Lieven Moors و Jari Suominen
.SH "گزارش اشکالات (REPORTING BUGS)"
برای گزارش اشکالات aj-snapshot، یا اگر درخواست ویژگی جدیدی دارید:
.br
.UR http://sourceforge.net/projects/aj-snapshot
.UE
.PP
صفحه خانگی Aj-snapshot:
.br
.UR http://aj-snapshot.sourceforge.net
.UE
.PP
کلون کردن مخزن گیت:
.br
git clone
.UR https://lievenmoors@git.code.sf.net/p/aj-snapshot/code
.UE
.SH "حق نشر (COPYRIGHT)"
حق نشر \(co 2009-2012 Lieven Moors و Jari Suominen.
.br
مجوز GPLv3+: گنو GPL نسخه ۳ یا بالاتر <http://gnu.org/licenses/gpl.html>.
.br
این نرم‌افزار آزاد است: شما در تغییر و بازتوزیع آن آزاد هستید.
هیچ ضمانتی وجود ندارد، تا حدی که قانون مجاز می‌داند.