'\" t .\" Title: kmscon.conf .\" Author: Mirco Müller .\" Generator: DocBook XSL Stylesheets vsnapshot .\" Date: January 2023 .\" Manual: kmscon.conf .\" Source: kmscon.conf .\" Language: Persian .\" .TH "KMSCON\&.CONF" "5" "January 2023" "kmscon.conf" "kmscon.conf" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .\" http://bugs.debian.org/507673 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" ----------------------------------------------------------------- .\" * set default formatting .\" ----------------------------------------------------------------- .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only) .ad l .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- .SH "نام (NAME)" kmscon.conf \- فایل پیکربندی برای کنسول سیستم مبتنی بر KMS/DRM .SH "توضیحات (DESCRIPTION)" .PP فایل kmscon\&.conf فایل پیکربندی برای کنترل رفتار kmscon و تطبیق آن با ساختار سیستم شما است\&. این فایل امکان بازتعریف کلیدهای میانبر، تعیین چیدمان صفحه‌کلید مورد نظر، انتخاب ویژگی‌های قلم برای رندر متن، شتاب‌دهی سخت‌افزاری، جهت خروجی تصویر و بسیاری موارد دیگر را فراهم می‌کند\&. .PP در ادامه فهرست کاملی از تمام \fIگزینه‌ها (Options)\fR شناخته‌شده، معانی آن‌ها و مقادیر ممکن آورده شده است\&. در بخش \fIمثال‌ها\fR یک نمونه واقعی و متداول از این پیکربندی قرار دارد تا راهنمای شما در ساخت فایل اختصاصی خودتان باشد\&. .SH "مثال‌ها (EXAMPLES)" .PP در اینجا یک نمونه واقعی از یک فایل kmscon\&.conf معمولی آورده شده است: .sp .if n \{\ .RS 4 .\} .nf ### 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 .fi .if n \{\ .RE .\} .PP در هر خط، تمام نویسه‌های پس از علامت # نادیده گرفته شده و توضیح (کامنت) محسوب می‌شوند\&. فاصله‌های خالی (whitespace) در ابتدا و انتهای خطوط و همچنین در اطراف علامت \*(Aq=\*(Aq هنگام تخصیص یک پارامتر نادیده گرفته می‌شوند\&. .SH "گزینه‌ها (OPTIONS)" .PP در ادامه فهرست کاملی از تمامی گزینه‌های شناخته‌شده، معانی آن‌ها و مقادیر ممکن آورده شده است\&. .PP \fBverbose\fR .RS 4 فعال‌سازی پرحرفی kmscon درباره کارهایی که انجام می‌دهد\&. پیام‌ها در صورت عدم تغییر مسیر به خروجی استاندارد (stdout) ارسال می‌شوند\&. در صورت عدم وجود در kmscon\&.conf یا تبدیل شدن به کامنت، غیرفعال است\&. (پیش‌فرض: off) .RE .PP \fBdebug\fR .RS 4 فعال‌سازی گزارش‌دهی اشکال‌زدایی با جزئیات بیشتر\&. خروجی متنی به خروجی استاندارد یا فایلی که به آن هدایت شده فرستاده می‌شود\&. در صورت عدم وجود در kmscon\&.conf یا کامنت بودن، غیرفعال است\&. (پیش‌فرض: off) .RE .PP \fBsilent\fR .RS 4 نادیده گرفتن و سرکوب اعلان‌ها و هشدارها\&. (پیش‌فرض: off) .RE .PP \fBconfigdir\fR .RS 4 مسیر دایرکتوری پیکربندی\&. (پیش‌فرض: /etc/kmscon) .RE .PP \fBvt\fR .RS 4 انتخاب ترمینال مجازی (VT) برای اجرا\&. (پیش‌فرض: auto) .RE .PP \fBswitchvt\fR .RS 4 سوئیچ خودکار به ترمینال مجازی مربوطه\&. (پیش‌فرض: on) .RE .PP \fBlibseat\fR .RS 4 استفاده از libseat برای مدیریت seat\&. (پیش‌فرض: off) .RE .PP \fBsession\-max\fR .RS 4 حداکثر تعداد نشست‌ها (sessions)\&. (پیش‌فرض: 50) .RE .PP \fBsession\-control\fR .RS 4 اجازه کنترل نشست‌ها از طریق صفحه‌کلید\&. (پیش‌فرض: off) .RE .PP \fBlogin\fR .RS 4 اجرای فرایند ورود (login) مشخص‌شده به جای فرایند پیش‌فرض؛ تمام آرگومان‌های بعد از \*(Aq\-\-\*(Aq به عنوان argv به این فرایند ارسال خواهند شد\&. هیچ گزینه دیگری پس از \*(Aq\-\-\*(Aq پردازش نمی‌شود، بنابراین آن را در انتهای رشته آرگومان‌ها قرار دهید\&. (پیش‌فرض: /bin/login \-p) .RE .PP \fBterm\fR .RS 4 مقدار متغیر محیطی TERM برای فرایند فرزند\&. (پیش‌فرض: kmscon) .RE .PP \fBreset\-env\fR .RS 4 بازنشانی محیط قبل از اجرای فرایند فرزند\&. (پیش‌فرض: on) .RE .PP \fBissue\fR .RS 4 نمایش فایل‌های issue قبل از اعلان ورود (login prompt)\&. از no\-issue برای واگذاری مدیریت آن به فرایند ورود استفاده کنید\&. (پیش‌فرض: on) .RE .PP \fBissue\-path\fR .RS 4 فهرستی از فایل‌ها و دایرکتوری‌های issue که با دونقطه (:) از هم جدا شده‌اند، به ترتیب اولویت خوانده می‌شوند\&. این گزینه از ماسک uapi استفاده می‌کند، بنابراین اگر چندین فایل با نام یکسان وجود داشته باشد، تنها اولین مورد پردازش می‌شود\&. (پیش‌فرض: "/etc/issue:/etc/issue\&.d:/run/issue:/run/issue\&.d:/usr/lib/issue:/usr/lib/issue\&.d") .RE .PP \fBasciicast\fR .RS 4 مسیر یک انیمیشن asciicast برای پخش پس از باز شدن نشست ترمینال\&. پخش انیمیشن با فشردن هر کلید متوقف می‌شود\&. (پیش‌فرض: unset) .RE .PP \fBasciicast\-loop\fR .RS 4 تکرار مداوم (حلقه) انیمیشن asciicast\&. (پیش‌فرض: off) .RE .PP \fBbackspace\-delete\fR .RS 4 ارسال نویسه delete هنگام فشردن کلید backspace\&. (پیش‌فرض: on) .RE .PP \fBpalette\fR .RS 4 انتخاب پالت رنگی مورد استفاده\&. (پیش‌فرض: default) .RE .PP \fBsb\-size\fR .RS 4 اندازه بافر پیمایش به عقب (scrollback) بر حسب تعداد خطوط\&. (پیش‌فرض: 1000) .RE .PP \fBbell\fR .RS 4 فعال‌سازی هدایت زنگ (bell) به VT\&. در صورت فعال بودن، نویسه BEL (0x07) از برنامه‌ها به VT زیرین منتقل می‌شود\&. (پیش‌فرض: off) .RE .PP \fBblink\fR .RS 4 فعال‌سازی چشمک زدن مکان‌نما و متن\&. در صورت فعال بودن، مکان‌نما روی صفحه چشمک خواهد زد و متن دارای ویژگی چشمک‌زن نیز چشمک می‌زند\&. (پیش‌فرض: on) .RE .PP \fBxkb\-model\fR .RS 4 تنظیم XkbModel برای دستگاه‌های ورودی\&. (پیش‌فرض: unset) .RE .PP \fBxkb\-layout\fR .RS 4 تنظیم XkbLayout برای دستگاه‌های ورودی\&. (پیش‌فرض: unset) .RE .PP \fBxkb\-variant\fR .RS 4 تنظیم XkbVariant برای دستگاه‌های ورودی\&. (پیش‌فرض: unset) .RE .PP \fBxkb\-options\fR .RS 4 تنظیم XkbOptions برای دستگاه‌های ورودی\&. (پیش‌فرض: unset) .RE .PP \fBxkb\-keymap\fR .RS 4 استفاده از نگاشت کلید (keymap) از پیش تعریف‌شده برای دستگاه‌های ورودی\&. (پیش‌فرض: unset) .RE .PP \fBxkb\-repeat\-delay\fR .RS 4 تاخیر اولیه تکرار کلید به میلی‌ثانیه\&. (پیش‌فرض: 250) .RE .PP \fBxkb\-repeat\-rate\fR .RS 4 فاصله زمانی بین دو تکرار کلید به میلی‌ثانیه\&. (پیش‌فرض: 50) .RE .PP \fBmouse\fR .RS 4 فعال‌سازی ماوس/تاچ‌پد/ترک‌پوینت در kmscon (پیش‌فرض: on)\&. این گزینه امکان انتخاب و رونوشت/جای‌گذاری متن با دستگاه اشاره‌گر و همچنین پیمایش با چرخ ماوس را فراهم می‌کند\&. این قابلیت هنوز آزمایشی است و ممکن است با برخی دستگاه‌های خاص کار نکند\&. .RE .PP \fBnatural\-scrolling\fR .RS 4 معکوس کردن جهت چرخ ماوس (پیمایش طبیعی)\&. در صورت فعال بودن، پیمایش به بالا با چرخ ماوس به سمت پایین پیمایش می‌کند و برعکس\&. (پیش‌فرض: off) .RE .PP \fBsoft\-cursor\fR .RS 4 اجبار به استفاده از مکان‌نمای نرم‌افزاری، در صورتی که مکان‌نمای سخت‌افزاری به درستی کار نکند\&. (پیش‌فرض: off) .RE .PP \fBdpms\-timeout\fR .RS 4 تنظیم زمان خاموشی خودکار صفحه به ثانیه (پیش‌فرض: 600 = 10 دقیقه)\&. در صورت فعال بودن، صفحه پس از مدت زمان مشخص‌شده از عدم فعالیت صفحه‌کلید و ماوس به طور خودکار خاموش می‌شود (DPMS OFF)\&. هرگونه ورودی از صفحه‌کلید یا ماوس صفحه را دوباره روشن کرده و تایمر را بازنشانی می‌کند\&. این ویژگی برای صرفه‌جویی در مصرف انرژی در سیستم‌هایی که صفحه نمایش همیشه مورد نیاز نیست کاربردی است\&. برای غیرفعال کردن روی 0 تنظیم کنید\&. .RE .PP \fBgrab\-scroll\-up\fR .RS 4 میانبر برای پیمایش به بالا\&. (پیش‌فرض: Up) .RE .PP \fBgrab\-scroll\-down\fR .RS 4 میانبر برای پیمایش به پایین\&. (پیش‌فرض: Down) .RE .PP \fBgrab\-page\-up\fR .RS 4 میانبر برای پیمایش یک صفحه به بالا\&. (پیش‌فرض: Prior) .RE .PP \fBgrab\-page\-down\fR .RS 4 میانبر برای پیمایش یک صفحه به پایین\&. (پیش‌فرض: Next) .RE .PP \fBgrab\-zoom\-in\fR .RS 4 میانبر برای افزایش اندازه قلم\&. (پیش‌فرض: Plus) .RE .PP \fBgrab\-zoom\-out\fR .RS 4 میانبر برای کاهش اندازه قلم\&. (پیش‌فرض: Minus) .RE .PP \fBgrab\-session\-next\fR .RS 4 رفتن به نشست بعدی\&. (پیش‌فرض: Right) .RE .PP \fBgrab\-session\-prev\fR .RS 4 رفتن به نشست قبلی\&. (پیش‌فرض: Left) .RE .PP \fBgrab\-session\-close\fR .RS 4 بستن نشست فعلی\&. (پیش‌فرض: BackSpace) .RE .PP \fBgrab\-terminal\-new\fR .RS 4 ایجاد نشست ترمینال جدید\&. (پیش‌فرض: Return) .RE .PP \fBgrab\-rotate\-cw\fR .RS 4 چرخش خروجی تصویر در جهت عقربه‌های ساعت\&. (پیش‌فرض: Plus) .RE .PP \fBgrab\-rotate\-ccw\fR .RS 4 چرخش خروجی تصویر در خلاف جهت عقربه‌های ساعت\&. (پیش‌فرض: Minus) .RE .PP \fBgrab\-reboot\fR .RS 4 راه‌اندازی مجدد سیستم هنگام فشردن این میانبر صفحه‌کلید\&. این گزینه به صورت پیش‌فرض غیرفعال است\&. رفتار راه‌اندازی مجدد از تنظیمات سراسری سیستم در /proc/sys/kernel/ctrl\-alt\-del پیروی می‌کند: هنگامی که روی 0 (پیش‌فرض) تنظیم شده باشد، یک راه‌اندازی مجدد ملایم با ارسال سیگنال SIGINT به فرایند init (با PID 1) انجام می‌شود؛ هنگامی که روی مقداری بزرگتر از 0 تنظیم شده باشد، بلافاصله پس از همگام‌سازی بافرهای دیسک یک راه‌اندازی مجدد سخت‌افزاری انجام می‌گیرد\&. مثال: grab\-reboot=Delete (پیش‌فرض: disabled) .RE .PP \fBdrm\fR .RS 4 استفاده از DRM در صورت موجود بودن\&. (پیش‌فرض: on) .RE .PP \fBhwaccel\fR .RS 4 استفاده از شتاب‌دهنده سخت‌افزاری سه‌بعدی در صورت موجود بودن\&. (پیش‌فرض: off) .RE .PP \fBgpus\fR .RS 4 حالت انتخاب پردازنده گرافیکی (GPU)\&. (پیش‌فرض: all) .RE .PP \fBuse\-original\-mode\fR .RS 4 استفاده از حالت ویدیویی اصلی KMS\&. (پیش‌فرض: on) .RE .PP \fBmode\fR .RS 4 تنظیم وضوح تصویر (رزولوشن) به {width}x{height} .RE .PP \fBmulti\-monitor {clone,largest}\fR .RS 4 هنگامی که چندین نمایشگر وجود دارد، این گزینه نحوه استفاده از آن‌ها را کنترل می‌کند\&. .sp `clone\*(Aq: تمام مانیتورها اندازه یکسانی خواهند داشت\&. کوچک‌ترین مانیتور برای تعیین اندازه استفاده می‌شود\&. .sp `largest\*(Aq: بزرگ‌ترین مانیتور برای تعیین اندازه استفاده می‌شود\&. سایر مانیتورها غیرفعال خواهند شد\&. اگر چندین مانیتور دارای بزرگ‌ترین اندازه باشند، از همه آن‌ها استفاده خواهد شد\&. .sp پیش‌فرض: clone .RE .PP \fBrotate\fR .RS 4 جهت خروجی تصویر مورد استفاده\&. (پیش‌فرض: normal) .RE .PP \fBfont\-engine\fR .RS 4 موتور قلم مورد استفاده\&. (پیش‌فرض: freetype) .RE .PP \fBfont\-size\fR .RS 4 اندازه قلم بر حسب پیکسل\&. (پیش‌فرض: 16) .RE .PP \fBfont\-name\fR .RS 4 نام قلم مورد استفاده\&. (پیش‌فرض: monospace) .RE .SH "فایل‌ها (FILES)" .PP \fBفایل پیکربندی اصلی\fR .RS 4 /etc/kmscon/kmscon\&.conf .RE .PP \fBفایل پیکربندی اختصاصی Seat\fR .RS 4 /etc/kmscon/{seat_name}\&.kmscon\&.conf .RE .SH "همچنین ببینید (SEE ALSO)" .PP \fBkmscon\fR(1)