.TH XScreenSaver 1 "6.15 (30-Mar-2026)" "X Version 11"
.SH "نام (NAME)"
xscreensaver-command \- کنترل یک فرآیند در حال اجرای xscreensaver
.SH "خلاصه دستور (SYNOPSIS)"
.B xscreensaver-command
[\-\-display \fIhost:display.screen\fP] \
[\-\-help | \
\-\-quiet | \
\-\-verbose | \
\-\-activate | \
\-\-deactivate | \
\-\-cycle | \
\-\-next | \
\-\-prev | \
\-\-select \fIn\fP | \
\-\-lock | \
\-\-suspend | \
\-\-exit | \
\-\-restart | \
\-\-time | \
\-\-watch | \
\-\-version]
.SH "توضیحات (DESCRIPTION)"
برنامهٔ \fIxscreensaver\-command\fP یک دیمن در حال اجرای
.BR xscreensaver (1)
را کنترل می‌کند.
.SH "گزینه‌ها (OPTIONS)"
دستور \fIxscreensaver-command\fP گزینه‌های خط فرمان زیر را می‌پذیرد:
.TP 8
.B \-\-help
خلاصهٔ کوتاهی از گزینه‌های خط فرمان را چاپ می‌کند.
.TP 8
.B \-\-quiet
خروجی را تنها در صورت بروز خطا چاپ می‌کند.
.TP 8
.B \-\-verbose
نقطهٔ مقابل \-\-quiet. پیش‌فرض.
.TP 8
.B \-\-activate
به xscreensaver اعلام می‌کند که بلافاصله فعال شود (یعنی صفحه را خالی/سیاه کند، گویی کاربر به مدت کافی بی‌کار بوده است). محافظ صفحه طبق معمول، به محض هرگونه فعالیت کاربر غیرفعال می‌شود.
.TP 8
.B \-\-deactivate
به xscreensaver اعلام می‌کند وانمود کند که همین حالا فعالیت کاربری رخ داده است. این یعنی اگر محافظ صفحه فعال باشد (صفحه سیاه شده باشد)، این دستور باعث خروج صفحه از حالت سیاهی می‌شود، گویی با صفحه‌کلید یا موشواره فعالیت شده است. اگر صفحه قفل باشد، کادر گفتگوی گذرواژه ابتدا نمایش داده می‌شود، همان‌طور که معمول است. اگر صفحه سیاه نشده باشد، این شبیه‌سازی فعالیت کاربر شمارش معکوس را از نو آغاز می‌کند (بنابراین، اجرای دوره‌ای دستور \fI\-\-deactivate\fP \fIیکی\fP از روش‌های جلوگیری از سیاه شدن صفحه است).
.TP 8
.B \-\-cycle
اگر محافظ صفحه فعال باشد (صفحه سیاه شده باشد)، اجرای جلوهٔ گرافیکی فعلی را متوقف کرده و نمونهٔ جدیدی را (به‌صورت تصادفی) اجرا می‌کند.
.TP 8
.B \-\-next
بسته به شرایط، عملکردی مشابه \fI\-\-activate\fP یا \fI\-\-cycle\fP دارد؛ با این تفاوت که جلوهٔ گرافیکی بعدی در فهرست به جای یک جلوهٔ تصادفی اجرا خواهد شد. به بیان دیگر، اجرای مکرر \-\-next باعث می‌شود فرآیند xscreensaver هر جلوهٔ گرافیکی را به‌صورت متوالی فراخوانی کند. (هرچند استفاده از گزینهٔ \fI\-\-settings\fP احتمالاً روش آسان‌تری برای رسیدن به این هدف است).
.TP 8
.B \-\-prev
مشابه \fI\-\-next\fP است، اما در جهت عکس حرکت می‌کند.
.TP 8
.B \-\-select\fP \fInumber\fP
مشابه \fI\-\-activate\fP است، اما عضو شمارهٔ \fIN\fPام در فهرست جلوه‌ها را اجرا می‌کند. با دانستن محتوای فهرست \fIprograms\fP و ترتیب آن‌ها، می‌توانید با استفاده از این گزینه محافظ صفحه را با یک جلوهٔ گرافیکی خاص فعال کنید. (شماره‌گذاری عضو نخست در فهرست از ۱ آغاز می‌شود، نه ۰).
.TP 8
.B \-\-lock
به فرآیند در حال اجرای xscreensaver دستور می‌دهد که صفحه را بلافاصله قفل کند. این گزینه مشابه \fI\-\-activate\fP است، اما قفل کردن را نیز اجباری می‌کند، حتی اگر قفل کردن حالت پیش‌فرض نباشد (یعنی حتی اگر منبع \fIlock\fP در xscreensaver غیرفعال (false) باشد و حتی اگر مقدار منبع \fIlockTimeout\fP غیر صفر باشد).

توجه داشته باشید که قفل کردن کار نخواهد کرد مگر اینکه فرآیند \fIxscreensaver\fP تحت حساب کاربری شما اجرا شده باشد. برای جزئیات بیشتر به
.BR xscreensaver (1)
مراجعه کنید.
.TP 8
.B \-\-suspend
مشابه \fI\-\-activate\fP است، اما \fIlockTimeout\fP را نادیده گرفته و بلافاصله بدون ایجاد افکت محوشدن، صفحه را خاموش می‌کند. این گزینه به‌منظور اجرا بلافاصله پس از بستن درب لپ‌تاپ و درست پیش از متوقف شدن پردازنده طراحی شده تا همه‌چیز را سریعاً قفل کند.
.TP 8
.B \-\-exit
باعث خروج آرام و بدون نقص فرآیند xscreensaver می‌شود. اگر نمایشگر در حال حاضر قفل باشد، هیچ کاری انجام نمی‌دهد.
.B هشدار:
هرگز از \fIkill -9\fP برای بستن \fIxscreensaver\fP استفاده نکنید. این کار می‌تواند سیستم را در وضعیتی ناپایدار رها کند و ممکن است برای بازگرداندن سیستم به حالت عادی ناچار به خروج از نشست کاربری (logout) شوید.
.TP 8
.B \-\-restart
باعث خروج فرآیند محافظ صفحه و راه‌اندازی دوبارهٔ آن با همان آرگومان‌های خط فرمان پیشین می‌شود. معمولاً نیازی به انجام این کار نخواهید داشت، زیرا xscreensaver تغییرات فایل \fI.xscreensaver\fP را تشخیص داده و در صورت نیاز مجدداً آن را می‌خواند.
.TP 8
.B \-\-time
زمانی را که محافظ صفحه آخرین بار فعال یا غیرفعال شده است، چاپ می‌کند (تقریباً نشان می‌دهد کاربر چه مدت بی‌کار یا فعال بوده است؛ البته نه کاملاً دقیق، زیرا تنها زمانی را نشان می‌دهد که صفحه سیاه شده یا از حالت سیاه خارج شده است).
.TP 8
.B \-\-watch
هر بار که وضعیت محافظ صفحه تغییر کند، یک خط چاپ می‌کند: هنگام سیاه شدن صفحه، قفل شدن، بازگشت از سیاهی، یا زمانی که جلوهٔ در حال اجرا تغییر می‌یابد. این گزینه هرگز خاتمه نمی‌یابد؛ کاربرد آن در اسکریپت‌های شل است که می‌خواهند به تغییرات محافظ صفحه واکنش نشان دهند. نمونه‌ای از خروجی آن به شرح زیر است:
.nf
.sp
	BLANK Fri Nov  5 01:57:22 1999
	RUN 34
	RUN 79
	RUN 16
	LOCK Fri Nov  5 01:57:22 1999
	RUN 76
	RUN 12
	UNBLANK Fri Nov  5 02:05:59 1999
.sp
.fi
متن بالا فعال شدن محافظ صفحه، اجرای سه جلوهٔ گرافیکی مختلف، سپس قفل شدن (احتمالاً به دلیل پایان مهلت قفل) و در نهایت بازگشت به حالت عادی (به دلیل فعالیت کاربر و وارد کردن گذرواژهٔ صحیح) را نشان می‌دهد. شماره‌های جلوه‌ها، اندیس آن‌ها در فهرست `programs` است (که مانند دستور \fI\-\-select\fP، از ۱ شروع می‌شود نه ۰).

برای نمونه، فرض کنید می‌خواهید برنامه‌ای اجرا کنید که با سیاه شدن صفحه صدای رایانه را قطع کند و با روشن شدن مجدد صفحه صدا را بازگرداند. می‌توانید با اجرای برنامه‌ای به زبان Perl مانند نمونهٔ زیر در پس‌زمینه این کار را انجام دهید. برنامهٔ زیر خروجی دستور \fI\-\-watch\fP را پایش کرده و بر اساس آن عمل می‌کند:
.nf
.sp
	#!/usr/bin/perl

	my $blanked = 0;
	open (my $in, "xscreensaver-command -watch |") || die;
	while (<$in>) {
	  if (m/^(BLANK|LOCK)/) {
	    if (!$blanked) {
	      system ("sound-off");
	      $blanked = 1;
	    }
	  } elsif (m/^UNBLANK/) {
	    system ("sound-on");
	    $blanked = 0;
	  }
	}
.sp
.fi
توجه داشته باشید که LOCK ممکن است همراه با یک BLANK قبلی یا بدون آن رخ دهد (بسته به این که مهلت زمانی قفل غیر صفر باشد یا خیر)، بنابراین برنامهٔ بالا هر دو را ردیابی می‌کند.
.TP 8
.B \-\-version
نسخهٔ xscreensaver در حال اجرا روی نمایشگر را چاپ می‌کند: یعنی شماره نسخهٔ واقعی فرآیند پس‌زمینهٔ xscreensaver، نه نسخهٔ ابزار xscreensaver-command. (برای دیدن نسخهٔ خود \fIxscreensaver-command\fP، از گزینهٔ \fI\-\-help\fP استفاده کنید).
.SH "توقف گرافیک (STOPPING GRAPHICS)"
اگر xscreensaver در حال اجرا است، اما می‌خواهید اجرای جلوه‌های گرافیکی متوقف شود (برای نمونه، اگر از راه دور متصل شده‌اید و می‌خواهید کنسول قفل بماند اما صرفاً سیاه باشد و پردازش گرافیکی اجرا نشود)، می‌توانید این کار را به‌سادگی با خاموش کردن نمایشگر از راه دور انجام دهید. پس از گذشت حدود یک دقیقه، xscreensaver متوجه خاموش بودن نمایشگر شده و اجرای جلوه‌های گرافیکی را متوقف می‌کند. می‌توانید نمایشگر را بدین صورت خاموش کنید:
.nf
.sp
	xset dpms force off
.sp
.fi
برای اطلاعات بیشتر، صفحهٔ راهنمای
.BR xset (1)
را مطالعه کنید.

همچنین می‌توانید از
.BR xscreensaver\-settings (1)
استفاده کنید تا نمایشگر پس از چند ساعت خاموش شود؛ به این معنی که xscreensaver تا زمان سپری شدن مدت زمان بی‌کاری تعیین‌شده جلوه‌های گرافیکی را اجرا می‌کند و پس از آن، نمایشگر خاموش شده و اجرای جلوه‌ها متوقف خواهد شد.
.SH "خطاها (DIAGNOSTICS)"
اگر در برقراری ارتباط با دیمن \fIxscreensaver\fP خطایی رخ دهد یا اگر دیمن خطایی گزارش کند، یک پیام تشخیصی در stderr چاپ خواهد شد و \fIxscreensaver-command\fP با مقداری غیر صفر خارج می‌شود. اگر دستور پذیرفته شود، پیامی حاکی از موفقیت در stdout چاپ شده و مقدار خروج صفر خواهد بود.
.SH "محیط (ENVIRONMENT)"
.PP
.TP 8
.B DISPLAY
جهت دریافت نام میزبان و شمارهٔ صفحهٔ نمایشی که محافظ آن باید کنترل شود.
.TP 8
.B PATH
برای یافتن فایل اجرایی جهت راه‌اندازی دوباره (برای دستور \fI\-\-restart\fP).
توجه داشته باشید که این متغیر در محیط فرآیند \fIxscreensaver\fP بررسی می‌شود، نه فرآیند \fIxscreensaver-command\fP.
.SH "به‌روزرسانی‌ها (UPGRADES)"
همواره می‌توانید جدیدترین نسخهٔ
.BR xscreensaver (1)
و ابزارهای وابسته را در <https://www.jwz.org/xscreensaver> بیابید.
.SH "همچنین ببینید (SEE ALSO)"
.BR X (1),
.BR xscreensaver (1),
.BR xscreensaver\-settings (1),
.BR xset (1)
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
Copyright \(co 1992-2026 by Jamie Zawinski.
اجازه‌نامه برای استفاده، کپی، تغییر، توزیع و فروش این نرم‌افزار و مستندات آن برای هر هدفی بدین‌وسیله به صورت رایگان اعطا می‌شود، مشروط بر اینکه اعلان حق نشر فوق در تمام نسخه‌ها درج شود و هم اعلان حق نشر و هم این مجوزنامه در مستندات پشتیبان ظاهر شوند. هیچ ادعایی در مورد مناسب بودن این نرم‌افزار برای هر هدفی ارائه نشده است. این نرم‌افزار «همان‌طور که هست» و بدون هیچ ضمانت صریح یا ضمنی ارائه می‌شود.
.SH "نویسندگان (AUTHORS)"
Jamie Zawinski <jwz@jwz.org>.

لطفاً در صورت یافتن هرگونه باگ یا اعمال بهبودها، به نویسنده اطلاع دهید.