XSET(1) X Version 11 XSET(1)

xset - ابزار سفارشی‌سازی تنظیمات کاربر برای X

xset [-display display]
     [-b] [b {on|off}] [b [volume [pitch [duration]]]]
     [-bc] [bc]
     [-c] [c {on|off}] [c [volume]]
     [+dpms] [-dpms]
	[dpms standby [ suspend [ off]]]
	[dpms force {standby|suspend|off|on}]
     [fp=pathlist] [-fp=pathlist] [+fp=pathlist]
     [fp-pathlist] [fp+pathlist] [fp default] [fp rehash]
     [-led [integer|named indicator]] [led [integer|named indicator]]
     [led {on|off}]
     [mouse [accel_mult[/accel_div] [threshold]]] [mouse default]
     [p pixel color]
     [-r [keycode]]  [r [keycode]] [r {on|off}] [r rate delay [rate]]
     [s [length [period]]] [s {blank|noblank}] [s {expose|noexpose}]
     [s {on|off}] [s default] [s activate] [s reset]
     [q]
     [-version]

این برنامه برای پیکربندی یا پرس‌وجوی گزینه‌های گوناگون تنظیمات برگزیده کاربر در نمایشگر به کار می‌رود.

این گزینه سرور مورد استفاده را مشخص می‌کند؛ نگاه کنید به X(7).
گزینه b بلندی صدا، زیروبمی (Pitch) و مدت زمان بوق سیستم (Bell) را کنترل می‌کند. این گزینه حداکثر سه پارامتر عددی، یک خط تیره پیشین (-)، یا پرچم‌های on/off را می‌پذیرد. اگر هیچ پارامتری داده نشود یا از پرچم on استفاده شود، مقادیر پیش‌فرض سیستم به کار گرفته خواهند شد. اگر خط تیره یا off داده شود، بوق سیستم خاموش خواهد شد. در صورت ارائه تنها یک پارامتر عددی، بلندی صدای بوق سیستم بر حسب درصدی از حداکثر مقدار آن تنظیم می‌شود. به همین ترتیب، پارامتر عددی دوم زیروبمی بوق را بر حسب هرتز و پارامتر عددی سوم مدت زمان آن را بر حسب میلی‌ثانیه تعیین می‌کند. توجه داشته باشید که همه سخت‌افزارها قادر به تغییر مشخصه‌های بوق سیستم نیستند. کارگزار X تا جای ممکن ویژگی‌های بوق را نزدیک به مشخصات درخواستی کاربر تنظیم خواهد کرد.
گزینه bc حالت سازگاری با باگ‌ها (bug compatibility) را در صورت امکان در کارگزار کنترل می‌کند؛ یک خط تیره پیشین (-) این حالت را غیرفعال کرده و در غیر این صورت فعال می‌شود. برخی از کلاینت‌های قدیمی پیش از R4، مقادیر نامعتبری را در پاره‌ای از درخواست‌های پروتکل ارسال می‌کردند و سرورهای پیش از R4 در این موارد به درستی خطا ایجاد نمی‌کردند. چنین برنامه‌هایی هنگام اجرا در برابر سرور R4 به طور غیرعادی متوقف شده یا دچار اختلال می‌شوند. حالت سازگاری با باگ‌ها به طور صریح برخی باگ‌ها را دوباره به کارگزار X بازمی‌گرداند تا بسیاری از این کلاینت‌ها همچنان قابل اجرا باشند. از این حالت باید با احتیاط استفاده شود؛ توسعه برنامه‌های جدید باید با غیرفعال بودن این حالت صورت گیرد. برای کارکرد این گزینه، سرور باید از افزونه پروتکل MIT-SUNDRY-NONSTANDARD پشتیبانی کند. کارگزار X.Org نسخه 1.2 و جدیدتر از فعال‌سازی این حالت پشتیبانی نمی‌کنند.
گزینه c صدای کلیک کلیدها (Key Click) را کنترل می‌کند. این گزینه می‌تواند یک مقدار اختیاری، یک خط تیره پیشین (-)، یا پرچم‌های on/off را بپذیرد. اگر هیچ پارامتری یا پرچم on داده نشود، مقادیر پیش‌فرض سیستم استفاده خواهند شد. اگر خط تیره یا پرچم off استفاده شود، صدای کلیک کلیدها غیرفعال می‌گردد. در صورت ارائه مقداری بین 0 تا 100، این عدد به عنوان بلندی صدا بر حسب درصدی از حداکثر در نظر گرفته می‌شود. کارگزار X بلندی صدا را روی نزدیک‌ترین مقداری که سخت‌افزار قادر به پشتیبانی از آن است تنظیم خواهد کرد.
گزینه -dpms ویژگی‌های سیگنالینگ مدیریت مصرف برق نمایشگر (DPMS) را غیرفعال می‌کند.
+dpms
گزینه +dpms ویژگی‌های سیگنالینگ مدیریت مصرف برق نمایشگر (DPMS) را فعال می‌کند.
dpms flags...
گزینه dpms امکان تنظیم پارامترهای سیگنالینگ مدیریت مصرف برق نمایشگر (DPMS) را فراهم می‌آورد. این گزینه می‌تواند تا سه مقدار عددی یا پرچم force به همراه یک وضعیت DPMS را دریافت کند. پرچم force کارگزار را وادار می‌کند تا فوراً به وضعیت DPMS مشخص‌شده تغییر حالت دهد. وضعیت DPMS می‌تواند یکی از مقادیر standby، suspend، off یا on باشد. هنگامی که مقادیر عددی داده شوند، دوره عدم فعالیت (بر حسب ثانیه) را پیش از فعال شدن این سه حالت تعیین می‌کنند. نخستین مقدار برای حالت standby، دومین مقدار برای حالت suspend و سومین مقدار برای حالت off است. تنظیم این مقادیر، قابلیت‌های DPMS را به صورت ضمنی فعال می‌کند. مقدار صفر یک حالت خاص را غیرفعال می‌سازد.
گزینه fp= مسیر فونت‌ها را به موارد ارائه‌شده در آرگومان مسیر تنظیم می‌کند. این ورودی‌ها توسط سرور تفسیر می‌شوند، نه کلاینت. این ورودی‌ها معمولاً نام دایرکتوری‌ها یا نام سرورهای فونت هستند، اما تفسیر آن‌ها وابسته به سرور است.
آرگومان default باعث بازنشانی مسیر فونت به مقدار پیش‌فرض سرور می‌شود.
آرگومان rehash مسیر فونت را به مقدار فعلی آن بازنشانی می‌کند، که سبب می‌شود سرور پایگاه‌های داده قلم را در مسیر فونت فعلی مجدداً بخواند. این حالت معمولاً تنها هنگام افزودن قلم‌های جدید به یک دایرکتوری فونت (پس از اجرای mkfontdir برای بازسازی پایگاه داده فونت) استفاده می‌شود.
گزینه‌های -fp و fp- عناصر را از مسیر فونت فعلی حذف می‌کنند. این گزینه‌ها باید با فهرستی از ورودی‌ها که با کاما از هم جدا شده‌اند همراه باشند.
+fp or fp+
گزینه‌های +fp و fp+ به ترتیب عناصر را به ابتدای و انتهای مسیر فونت فعلی اضافه می‌کنند. این گزینه‌ها باید با فهرستی از ورودی‌ها که با کاما از هم جدا شده‌اند همراه باشند.
گزینه led چراغ‌های نشانگر (LED) صفحه‌کلید را کنترل می‌کند. این گزینه روشن یا خاموش کردن یک یا همه چراغ‌ها را مدیریت می‌کند. این گزینه یک عدد صحیح اختیاری، یک خط تیره پیشین (-) یا پرچم‌های on/off را می‌پذیرد. اگر هیچ پارامتری یا پرچم on داده نشود، تمام LEDها روشن می‌شوند. اگر خط تیره پیشین یا پرچم off داده شود، تمام LEDها خاموش می‌شوند. اگر مقداری بین 1 تا 32 داده شود، آن چراغ LED خاص بسته به وجود خط تیره پیشین روشن یا خاموش می‌شود. دستور «xset led 3» چراغ شماره ۳ را روشن می‌کند و «xset -led 3» آن را خاموش می‌سازد. مقادیر مشخص LED ممکن است در سخت‌افزارهای مختلف به چراغ‌های متفاوتی اشاره داشته باشند. اگر کارگزار X از افزونه XKEYBOARD (XKB) پشتیبانی کند، می‌توان با تعیین کلیدواژه named و نام نشانگر، به LEDها با نام نشانگر XKB اشاره کرد. برای نمونه، جهت روشن کردن چراغ Scroll Lock:
xset led named "Scroll Lock"
گزینه mouse پارامترهای موشواره (ماوس) را کنترل می‌کند؛ می‌توان آن را به m خلاصه کرد. البته این تنظیم برای بیشتر دستگاه‌های اشاره‌گر اعمال می‌شود، نه فقط موشواره‌ها. پارامترهای دستگاه اشاره‌گر عبارتند از acceleration (شتاب) و threshold (آستانه). acceleration می‌تواند به عنوان یک عدد صحیح یا یک کسر ساده مشخص شود. threshold تنها یک عدد صحیح است. این تنظیم بر روی تمام دستگاه‌های اشاره‌گر متصل اعمال می‌شود. اگر به تنظیمات اختصاصی برای هر دستگاه نیاز دارید، باید از xinput(1) استفاده شود.

به طور پیش‌فرض، هنگامی که دستگاه اشاره‌گر بیش از threshold میکی (یعنی پیکسل‌های فرضی) را در مدت ۱۰ میلی‌ثانیه بپیماید، نشانگر (نمایش روی صفحه دستگاه اشاره‌گر) با سرعتی معادل acceleration برابر سریع‌تر حرکت خواهد کرد، که شامل یک محدوده انتقال کوچک نیز می‌شود. به این ترتیب، می‌توان از دستگاه اشاره‌گر برای تراز دقیق در حرکت‌های آهسته استفاده کرد، در حالی که در صورت تمایل می‌توان آن را طوری تنظیم نمود که با یک چرخش سریع مچ دست در سراسر صفحه حرکت کند. یک یا هر دو پارامتر گزینه mouse را می‌توان حذف کرد، اما اگر تنها یک پارامتر ارائه شود، به عنوان acceleration تفسیر خواهد شد. اگر پارامتری ارائه نشود یا از پرچم default استفاده شود، مقادیر پیش‌فرض سیستم به کار خواهند رفت.

اگر پارامتر threshold ارائه شده و برابر 0 باشد، پارامتر acceleration در توان یک فرمول طبیعی‌تر و پیوسته استفاده خواهد شد، که کنترل دقیق در حرکات آهسته و پیمایش بزرگ در حرکات سریع را ممکن می‌سازد و گذاری تدریجی را میان این دو حالت فراهم می‌آورد. مقدار توصیه شده برای acceleration در این حالت 3/2 تا 3 است، اما به این محدوده محدود نمی‌شود.

در کارگزار X.Org نسخه 1.6 و بالاتر، رفتار شرح داده شده تا به اینجا به نمایه پیش‌فرض پیوند خورده است. نمایه‌های دیگری نیز وجود دارند (یعنی توابعی که شتاب نشانگر را از سرعت دستگاه محاسبه می‌کنند) و تنظیمات اضافی دیگری نیز در دسترس هستند، بنابراین توضیحات فوق ممکن است در موارد غیر پیش‌فرض اعمال نشوند. در سرور X.Org نسخه 1.7، این موارد به عنوان ویژگی‌های دستگاه ورودی در دسترس هستند (نگاه کنید به xinput(1)).

گزینه p مقادیر رنگ پیکسل را کنترل می‌کند. پارامترها عبارتند از شماره ورودی جدول رنگ (Colormap) در مبنای ۱۰، و مشخصه رنگ. رنگ‌های پس‌زمینه ریشه (Root background) را می‌توان در برخی سرورها با تغییر ورودی‌های BlackPixel و WhitePixel تغییر داد. اگرچه این مقادیر غالباً 0 و 1 هستند، اما الزامی بر آن نیست. همچنین، سرور ممکن است تصمیم بگیرد این رنگ‌ها را به صورت اختصاصی تخصیص دهد، که در این حالت خطا رخ خواهد داد. ورودی جدول رنگ نباید یک رنگ فقط‌خواندنی باشد، در غیر این صورت با خطا مواجه خواهد شد.
گزینه r تکرار خودکار کلیدها (Autorepeat) را کنترل می‌کند. اجرا با «-r» یا «r off» تکرار خودکار را غیرفعال کرده، در حالی که «r» یا «r on» آن را فعال می‌کند. درج یک کد کلید (keycode) عددی صحیح بین 0 تا 255 پس از گزینه «-r» یا «r» به ترتیب تکرار خودکار آن کلید را غیرفعال یا فعال می‌کند، اما فقط در صورتی که این عمل برای آن کد کلید معنادار باشد. کدهای کلید کمتر از 8 معمولاً برای این دستور معتبر نیستند. مثال: «xset -r 10» تکرار خودکار را برای کلید «1» در ردیف بالای صفحه‌کلیدهای سازگار با IBM PC غیرفعال می‌کند.
اگر سرور از افزونه XFree86-Misc یا افزونه XKB پشتیبانی کند، پارامتر rate پذیرفته می‌شود و باید صفر، یک یا دو مقدار عددی به دنبال آن بیاید. مقدار نخست، delay (تاخیر) پیش از شروع تکرار خودکار را مشخص کرده و مقدار دوم، نرخ تکرار (rate) را تعیین می‌کند. در صورتی که سرور از افزونه XKB پشتیبانی کند، delay تعداد میلی‌ثانیه‌ها پیش از آغاز تکرار خودکار است و rate تعداد تکرار در هر ثانیه می‌باشد. اگر rate یا delay داده نشوند، به مقدار پیش‌فرض تنظیم خواهند شد.
گزینه s به شما امکان می‌دهد پارامترهای محافظ صفحه نمایش (Screen Saver) را تنظیم کنید. این گزینه حداکثر دو پارامتر عددی، پرچم‌های blank/noblank، پرچم‌های expose/noexpose، پرچم‌های on/off، پرچم‌های activate/reset یا پرچم default را می‌پذیرد. اگر هیچ پارامتری داده نشود یا از پرچم default استفاده شود، سیستم روی مشخصات پیش‌فرض محافظ صفحه نمایش تنظیم خواهد شد. پرچم‌های on/off به سادگی عملکرد محافظ صفحه نمایش را روشن یا خاموش می‌کنند. پرچم activate فعال‌سازی محافظ صفحه نمایش را تحمیل می‌کند، حتی اگر خاموش شده باشد. پرچم reset در صورت فعال بودن محافظ صفحه، آن را غیرفعال می‌سازد. پرچم blank اولویت را بر سیاه کردن تصویر (در صورت توانایی سخت‌افزار) به جای نمایش الگوی پس‌زمینه قرار می‌دهد، در حالی که noblank اولویت را بر نمایش یک الگو به جای سیاه کردن صفحه قرار می‌دهد. پرچم expose تنظیم را بر اجازه دادن به نمایان شدن پنجره‌ها (Window exposures ‏- که سرور آزاد است محتویات پنجره را دور بریزد) می‌گذارد، در حالی که noexpose تنظیم را بر غیرفعال کردن محافظ صفحه قرار می‌دهد مگر اینکه سرور بتواند صفحات را بدون ایجاد رویدادهای exposure بازسازی کند. پارامترهای length و period برای عملکرد محافظ صفحه نمایش، تعیین می‌کنند که سرور چه مدت باید غیرفعال باشد تا محافظ صفحه فعال شود، و دوره زمانی تغییر الگوی پس‌زمینه برای جلوگیری از سوختگی فسفر تصویر (Burn-in) چقدر باشد. این آرگومان‌ها بر حسب ثانیه مشخص می‌شوند. اگر تنها یک پارامتر عددی داده شود، برای length استفاده خواهد شد.
گزینه q اطلاعات مربوط به تنظیمات فعلی را به شما ارائه می‌دهد.
گزینه -version نسخه برنامه را چاپ کرده و بدون انجام هر کار دیگری خارج می‌شود.

هنگامی که از نشست کاربری خود خارج شوید (Log out)، این تنظیمات به مقادیر پیش‌فرض بازنشانی خواهند شد.

توجه داشته باشید که رعایت تمامی این گزینه‌ها در تمام پیاده‌سازی‌های X تضمین نشده است.

X(7), Xserver(1), xinput(1), xmodmap(1), xrdb(1), xsetroot(1)

Bob Scheifler, MIT Laboratory for Computer Science
David Krikorian, MIT Project Athena (X11 version)
XFree86-Misc support added by David Dawes and Joe Moss
Manpage updates added by Mike A. Harris <mharris@redhat.com>

2025-04-12 xset 1.2.6