XDG-SCREENSAVER(1) xdg-screensaver Manual XDG-SCREENSAVER(1)

xdg-screensaver - ابزار خط فرمان برای کنترل محافظ صفحه نمایش

xdg-screensaver suspend WindowID

xdg-screensaver resume WindowID

xdg-screensaver {activate | lock | reset | status}

xdg-screensaver {--help | --manual | --version}

دستور xdg-screensaver دستوراتی را برای کنترل محافظ صفحه نمایش فراهم می‌کند.

دستور xdg-screensaver تنها برای استفاده درون یک نشست میزکار (desktop session) است. استفاده از xdg-screensaver با دسترسی ریشه (root) توصیه نمی‌شود.

suspend WindowID

محافظ صفحه نمایش و مدیریت توان مانیتور را به حالت تعلیق درمی‌آورد. WindowID باید شناسه پنجره X (شناسه X Window ID) یک پنجره موجود از برنامه فراخواننده باشد. این پنجره باید در تمام مدت تعلیق پابرجا بماند.

شناسه WindowID را می‌توان به‌صورت یک عدد ده‌دهی یا یک عدد هگزادسیمال شامل پیشوند 0x به همراه یک یا چند رقم هگزادسیمال مشخص کرد.

محافظ صفحه نمایش می‌تواند نسبت به چندین پنجره به‌طور هم‌زمان به حالت تعلیق درآید. در این حالت عملکرد محافظ صفحه نمایش تنها زمانی بازگردانی می‌شود که برای تک‌تک آن پنجره‌ها وضعیت ازسرگیری اجرا شده باشد.

resume WindowID

محافظ صفحه نمایش و مدیریت توان مانیتور را پس از تعلیق از سر می‌گیرد. WindowID باید همان شناسه پنجره X باشد که به فراخوانی پیشینِ xdg-screensaver suspend داده شده بود.

activate

محافظ صفحه نمایش را فوراً فعال می‌کند. این عمل ممکن است بسته به سیاست‌های موجود سیستم منجر به قفل شدن صفحه نمایش شود.

lock

صفحه نمایش را فوراً قفل می‌کند.

reset

محافظ صفحه نمایش را فوراً خاموش می‌کند. اگر صفحه نمایش قفل شده باشد، ممکن است ابتدا از کاربر خواسته شود احراز هویت کند.

status

اگر محافظ صفحه نمایش برای فعال شدن پس از یک دوره عدم فعالیت فعال باشد، عبارت enabled و در صورتی که فعال نباشد عبارت disabled را در خروجی استاندارد (stdout) چاپ می‌کند.

--help

خلاصه نحوه استفاده از دستور را نمایش می‌دهد.

--manual

این صفحه راهنما را نمایش می‌دهد.

--version

اطلاعات نسخه xdg-utils را نمایش می‌دهد.

کد خروج 0 نشان‌دهنده موفقیت است در حالی که کد خروج غیرصفر نشان‌دهنده شکست است. کدهای خطای زیر ممکن است بازگردانده شوند:

1

خطا در نحو خط فرمان.

3

یک ابزار مورد نیاز یافت نشد.

4

عملیات ناموفق بود.

xdg-screensaver suspend 0x1c00007

باعث غیرفعال ماندن محافظ صفحه نمایش می‌شود تا زمانی که xdg-screensaver resume 0x1c00007 فراخوانی شود. 0x1c00007 باید شناسه پنجره X یک پنجره موجود باشد.

Bryce Harrington

نویسنده.

Copyright © 2006

12/06/2025 xdg-utils 1.0