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

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

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

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

مثال‌ها (EXAMPLES)
       در اینجا یک نمونه واقعی از یک فایل 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) در ابتدا و انتهای خطوط و
       همچنین در اطراف علامت '=' هنگام تخصیص یک پارامتر نادیده گرفته می‌شوند.

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

       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)

فایل‌ها (FILES)
       فایل پیکربندی اصلی
           /etc/kmscon/kmscon.conf

       فایل پیکربندی اختصاصی Seat
           /etc/kmscon/{seat_name}.kmscon.conf

همچنین ببینید (SEE ALSO)
       kmscon(1)

kmscon.conf                      January 2023                   KMSCON.CONF(5)