KMSCON.CONF(5) kmscon.conf KMSCON.CONF(5)

kmscon.conf - فایل پیکربندی برای کنسول سیستم مبتنی بر KMS/DRM

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

در ادامه فهرست کاملی از تمام گزینه‌ها (Options) شناخته‌شده، معانی آن‌ها و مقادیر ممکن آورده شده است. در بخش مثال‌ها یک نمونه واقعی و متداول از این پیکربندی قرار دارد تا راهنمای شما در ساخت فایل اختصاصی خودتان باشد.

در اینجا یک نمونه واقعی از یک فایل kmscon.conf معمولی آورده شده است:

### General Options ###
verbose
### Seat Options ###
vt=1
switchvt
### Session Options ###
session-max=6
session-control
### Terminal Options ###
term=kmscon
### Input Options ###
xkb-model=pc102
xkb-layout=de
xkb-repeat-delay=200
xkb-repeat-rate=65
mouse
dpms-timeout=600
### Video Options ###
drm
hwaccel
gpus=all
multi-monitor=clone
rotate=normal
### Font Options ###
font-engine=freetype
font-size=18
font-name=Ubuntu Mono

در هر خط، تمام نویسه‌های پس از علامت # نادیده گرفته شده و توضیح (کامنت) محسوب می‌شوند. فاصله‌های خالی (whitespace) در ابتدا و انتهای خطوط و همچنین در اطراف علامت '=' هنگام تخصیص یک پارامتر نادیده گرفته می‌شوند.

در ادامه فهرست کاملی از تمامی گزینه‌های شناخته‌شده، معانی آن‌ها و مقادیر ممکن آورده شده است.

verbose

فعال‌سازی پرحرفی kmscon درباره کارهایی که انجام می‌دهد. پیام‌ها در صورت عدم تغییر مسیر به خروجی استاندارد (stdout) ارسال می‌شوند. در صورت عدم وجود در kmscon.conf یا تبدیل شدن به کامنت، غیرفعال است. (پیش‌فرض: off)

debug

فعال‌سازی گزارش‌دهی اشکال‌زدایی با جزئیات بیشتر. خروجی متنی به خروجی استاندارد یا فایلی که به آن هدایت شده فرستاده می‌شود. در صورت عدم وجود در kmscon.conf یا کامنت بودن، غیرفعال است. (پیش‌فرض: off)

silent

نادیده گرفتن و سرکوب اعلان‌ها و هشدارها. (پیش‌فرض: off)

configdir

مسیر دایرکتوری پیکربندی. (پیش‌فرض: /etc/kmscon)

vt

انتخاب ترمینال مجازی (VT) برای اجرا. (پیش‌فرض: auto)

switchvt

سوئیچ خودکار به ترمینال مجازی مربوطه. (پیش‌فرض: on)

libseat

استفاده از libseat برای مدیریت seat. (پیش‌فرض: off)

session-max

حداکثر تعداد نشست‌ها (sessions). (پیش‌فرض: 50)

session-control

اجازه کنترل نشست‌ها از طریق صفحه‌کلید. (پیش‌فرض: off)

login

اجرای فرایند ورود (login) مشخص‌شده به جای فرایند پیش‌فرض؛ تمام آرگومان‌های بعد از '--' به عنوان argv به این فرایند ارسال خواهند شد. هیچ گزینه دیگری پس از '--' پردازش نمی‌شود، بنابراین آن را در انتهای رشته آرگومان‌ها قرار دهید. (پیش‌فرض: /bin/login -p)

term

مقدار متغیر محیطی TERM برای فرایند فرزند. (پیش‌فرض: kmscon)

reset-env

بازنشانی محیط قبل از اجرای فرایند فرزند. (پیش‌فرض: on)

issue

نمایش فایل‌های issue قبل از اعلان ورود (login prompt). از no-issue برای واگذاری مدیریت آن به فرایند ورود استفاده کنید. (پیش‌فرض: on)

issue-path

فهرستی از فایل‌ها و دایرکتوری‌های issue که با دونقطه (:) از هم جدا شده‌اند، به ترتیب اولویت خوانده می‌شوند. این گزینه از ماسک uapi استفاده می‌کند، بنابراین اگر چندین فایل با نام یکسان وجود داشته باشد، تنها اولین مورد پردازش می‌شود. (پیش‌فرض: "/etc/issue:/etc/issue.d:/run/issue:/run/issue.d:/usr/lib/issue:/usr/lib/issue.d")

asciicast

مسیر یک انیمیشن asciicast برای پخش پس از باز شدن نشست ترمینال. پخش انیمیشن با فشردن هر کلید متوقف می‌شود. (پیش‌فرض: unset)

asciicast-loop

تکرار مداوم (حلقه) انیمیشن asciicast. (پیش‌فرض: off)

backspace-delete

ارسال نویسه delete هنگام فشردن کلید backspace. (پیش‌فرض: on)

palette

انتخاب پالت رنگی مورد استفاده. (پیش‌فرض: default)

sb-size

اندازه بافر پیمایش به عقب (scrollback) بر حسب تعداد خطوط. (پیش‌فرض: 1000)

bell

فعال‌سازی هدایت زنگ (bell) به VT. در صورت فعال بودن، نویسه BEL (0x07) از برنامه‌ها به VT زیرین منتقل می‌شود. (پیش‌فرض: off)

blink

فعال‌سازی چشمک زدن مکان‌نما و متن. در صورت فعال بودن، مکان‌نما روی صفحه چشمک خواهد زد و متن دارای ویژگی چشمک‌زن نیز چشمک می‌زند. (پیش‌فرض: on)

xkb-model

تنظیم XkbModel برای دستگاه‌های ورودی. (پیش‌فرض: unset)

xkb-layout

تنظیم XkbLayout برای دستگاه‌های ورودی. (پیش‌فرض: unset)

xkb-variant

تنظیم XkbVariant برای دستگاه‌های ورودی. (پیش‌فرض: unset)

xkb-options

تنظیم XkbOptions برای دستگاه‌های ورودی. (پیش‌فرض: unset)

xkb-keymap

استفاده از نگاشت کلید (keymap) از پیش تعریف‌شده برای دستگاه‌های ورودی. (پیش‌فرض: unset)

xkb-repeat-delay

تاخیر اولیه تکرار کلید به میلی‌ثانیه. (پیش‌فرض: 250)

xkb-repeat-rate

فاصله زمانی بین دو تکرار کلید به میلی‌ثانیه. (پیش‌فرض: 50)

mouse

فعال‌سازی ماوس/تاچ‌پد/ترک‌پوینت در kmscon (پیش‌فرض: on). این گزینه امکان انتخاب و رونوشت/جای‌گذاری متن با دستگاه اشاره‌گر و همچنین پیمایش با چرخ ماوس را فراهم می‌کند. این قابلیت هنوز آزمایشی است و ممکن است با برخی دستگاه‌های خاص کار نکند.

natural-scrolling

معکوس کردن جهت چرخ ماوس (پیمایش طبیعی). در صورت فعال بودن، پیمایش به بالا با چرخ ماوس به سمت پایین پیمایش می‌کند و برعکس. (پیش‌فرض: off)

soft-cursor

اجبار به استفاده از مکان‌نمای نرم‌افزاری، در صورتی که مکان‌نمای سخت‌افزاری به درستی کار نکند. (پیش‌فرض: off)

dpms-timeout

تنظیم زمان خاموشی خودکار صفحه به ثانیه (پیش‌فرض: 600 = 10 دقیقه). در صورت فعال بودن، صفحه پس از مدت زمان مشخص‌شده از عدم فعالیت صفحه‌کلید و ماوس به طور خودکار خاموش می‌شود (DPMS OFF). هرگونه ورودی از صفحه‌کلید یا ماوس صفحه را دوباره روشن کرده و تایمر را بازنشانی می‌کند. این ویژگی برای صرفه‌جویی در مصرف انرژی در سیستم‌هایی که صفحه نمایش همیشه مورد نیاز نیست کاربردی است. برای غیرفعال کردن روی 0 تنظیم کنید.

grab-scroll-up

میانبر برای پیمایش به بالا. (پیش‌فرض: <Shift>Up)

grab-scroll-down

میانبر برای پیمایش به پایین. (پیش‌فرض: <Shift>Down)

grab-page-up

میانبر برای پیمایش یک صفحه به بالا. (پیش‌فرض: <Shift>Prior)

grab-page-down

میانبر برای پیمایش یک صفحه به پایین. (پیش‌فرض: <Shift>Next)

grab-zoom-in

میانبر برای افزایش اندازه قلم. (پیش‌فرض: <Ctrl>Plus)

grab-zoom-out

میانبر برای کاهش اندازه قلم. (پیش‌فرض: <Ctrl>Minus)

grab-session-next

رفتن به نشست بعدی. (پیش‌فرض: <Ctrl><Logo>Right)

grab-session-prev

رفتن به نشست قبلی. (پیش‌فرض: <Ctrl><Logo>Left)

grab-session-close

بستن نشست فعلی. (پیش‌فرض: <Ctrl><Logo>BackSpace)

grab-terminal-new

ایجاد نشست ترمینال جدید. (پیش‌فرض: <Ctrl><Logo>Return)

grab-rotate-cw

چرخش خروجی تصویر در جهت عقربه‌های ساعت. (پیش‌فرض: <Logo>Plus)

grab-rotate-ccw

چرخش خروجی تصویر در خلاف جهت عقربه‌های ساعت. (پیش‌فرض: <Logo>Minus)

grab-reboot

راه‌اندازی مجدد سیستم هنگام فشردن این میانبر صفحه‌کلید. این گزینه به صورت پیش‌فرض غیرفعال است. رفتار راه‌اندازی مجدد از تنظیمات سراسری سیستم در /proc/sys/kernel/ctrl-alt-del پیروی می‌کند: هنگامی که روی 0 (پیش‌فرض) تنظیم شده باشد، یک راه‌اندازی مجدد ملایم با ارسال سیگنال SIGINT به فرایند init (با PID 1) انجام می‌شود؛ هنگامی که روی مقداری بزرگتر از 0 تنظیم شده باشد، بلافاصله پس از همگام‌سازی بافرهای دیسک یک راه‌اندازی مجدد سخت‌افزاری انجام می‌گیرد. مثال: grab-reboot=<Ctrl><Alt>Delete (پیش‌فرض: disabled)

drm

استفاده از DRM در صورت موجود بودن. (پیش‌فرض: on)

hwaccel

استفاده از شتاب‌دهنده سخت‌افزاری سه‌بعدی در صورت موجود بودن. (پیش‌فرض: off)

gpus

حالت انتخاب پردازنده گرافیکی (GPU). (پیش‌فرض: all)

use-original-mode

استفاده از حالت ویدیویی اصلی KMS. (پیش‌فرض: on)

mode

تنظیم وضوح تصویر (رزولوشن) به {width}x{height}

multi-monitor {clone,largest}

هنگامی که چندین نمایشگر وجود دارد، این گزینه نحوه استفاده از آن‌ها را کنترل می‌کند.

`clone': تمام مانیتورها اندازه یکسانی خواهند داشت. کوچک‌ترین مانیتور برای تعیین اندازه استفاده می‌شود.

`largest': بزرگ‌ترین مانیتور برای تعیین اندازه استفاده می‌شود. سایر مانیتورها غیرفعال خواهند شد. اگر چندین مانیتور دارای بزرگ‌ترین اندازه باشند، از همه آن‌ها استفاده خواهد شد.

پیش‌فرض: clone

rotate

جهت خروجی تصویر مورد استفاده. (پیش‌فرض: normal)

font-engine

موتور قلم مورد استفاده. (پیش‌فرض: freetype)

font-size

اندازه قلم بر حسب پیکسل. (پیش‌فرض: 16)

font-name

نام قلم مورد استفاده. (پیش‌فرض: monospace)

فایل پیکربندی اصلی

/etc/kmscon/kmscon.conf

فایل پیکربندی اختصاصی Seat

/etc/kmscon/{seat_name}.kmscon.conf

kmscon(1)

January 2023 kmscon.conf