'\" t .\" Title: kmscon .\" Author: David Herrmann .\" Generator: DocBook XSL Stylesheets vsnapshot .\" Date: October 2024 .\" Manual: KMSCON .\" Source: KMSCON .\" Language: English .\" .TH "KMSCON" "1" "October 2024" "KMSCON" "KMSCON" .\" ----------------------------------------------------------------- .\" * 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 \- کنسول سیستمی مبتنی بر KMS/DRM .SH "خلاصه دستور (SYNOPSIS)" .HP \w'\fBkmscon\ \fR\fB[OPTIONS...]\fR\ 'u \fBkmscon \fR\fB[OPTIONS...]\fR .HP \w'\fBkmscon\ \-l\ \fR\fB[OPTIONS...]\fR\fB\ \-\-\ /bin/login\ \fR\fB[/bin/login\-OPTIONS...]\fR\ 'u \fBkmscon \-l \fR\fB[OPTIONS...]\fR\fB \-\- /bin/login \fR\fB[/bin/login\-OPTIONS...]\fR .SH "توضیحات (DESCRIPTION)" .PP برنامه KMSCON یک کنسول سیستمی مبتنی بر KMS/DRM همراه با شبیه‌ساز ترمینال یکپارچه برای سیستم‌عامل‌های لینوکس است\&. این ابزار به‌عنوان جایگزینی برای کنسول هسته لینوکس و ترمینال‌های مجازی طراحی شده است\&. .PP هنگام اجرا در حالت پیش‌فرض، KMSCON یک ترمینال مجازی تخصیص داده و یک شبیه‌ساز ترمینال روی آن ارائه می‌دهد\&. بنابراین می‌توان از آن به‌عنوان جایگزینی برای کنسول لینوکس و \fBagetty\fR(1) روی ترمینال‌های مجازی استفاده کرد\&. در مقایسه با کنسول لینوکس، KMSCON مجموعه‌ای غنی از امکانات ارتقایافته شامل پشتیبانی کامل از صفحه‌کلیدهای بین‌المللی، پشتیبانی کامل از قلم و ورودی UTF\-8، رندرینگ دارای شتاب سخت‌افزاری، پشتیبانی از seat و قابلیت‌های دیگر را ارائه می‌دهد\&. .SH "گزینه‌ها (OPTIONS)" .PP گزینه‌های بولی هیچ آرگومانی نمی‌پذیرند\&. اگر مقدار پیش‌فرض true باشد، می‌توانید با افزودن پیشوند \fIno\-\fR آن گزینه را غیرفعال کنید\&. .PP گزینه‌های عمومی: .PP \fB\-h\fR, \fB\-\-help\fR .RS 4 نمایش یک متن راهنمای کوتاه و خروج\&. .RE .PP \fB\-V\fR, \fB\-\-version\fR .RS 4 نمایش اطلاعات نسخه و خروج\&. در صورت ترکیب با \fB\-\-verbose\fR، اطلاعات ساخت تکمیلی شامل تاریخ و زمان کامپایل، و گزینه‌های فعال هنگام ساخت (پشتیبانی از DRM 2D/3D، پشتیبانی از FBDEV و پشتیبانی از قلم‌های Freetype) نمایش داده می‌شوند\&. .RE .PP \fB\-v\fR, \fB\-\-verbose\fR .RS 4 ارائه توضیحات پرجزئیات‌تر\&. (پیش‌فرض: غیرفعال) .RE .PP \fB\-\-debug\fR .RS 4 چاپ پیام‌های اشکال‌زدایی (debug)\&. فقط در صورتی کار می‌کند که KMSCON با حالت اشکال‌زدایی فعال کامپایل شده باشد\&. (پیش‌فرض: غیرفعال) .RE .PP \fB\-\-silent\fR .RS 4 فرونشاندن اعلان‌ها و هشدارها\&. (پیش‌فرض: غیرفعال) .RE .PP \fB\-\-configdir {/path/to/config/dir/}\fR .RS 4 تعیین مسیر دایرکتوری پیکربندی\&. (پیش‌فرض: /etc/kmscon) .RE .PP گزینه‌های Seat: .PP \fB\-\-vt {/path/to/vt|ttyX|X}\fR .RS 4 استفاده از این VT\&. آرگومان می‌تواند مسیر کامل `/dev/ttyX\*(Aq، نام دستگاه `ttyX\*(Aq یا صرفاً شماره tty باشد\&. در صورت عدم تعیین، KMSCON تلاش می‌کند خودش یک VT پیدا کند\&. در seatهای فاقد VT، برنامه KMSCON به‌طور خودکار بدون استفاده از هیچ VT فعال می‌شود\&. لطفاً توجه داشته باشید در صورتی که KMSCON روی چندین seat اجرا شود (گزینه \fB\-\-seats\fR را ببینید)، نمی‌توانید از این گزینه استفاده کنید\&. برای جلوگیری از این حالت، این گزینه را در پیکربندی seat در مسیر /etc/kmscon/{seat}\&.kmscon\&.conf مشخص کنید\&. .sp شما نباید چندین برنامه را روی یک VT مشترک اجرا کنید، در غیر این صورت ممکن است با سیستمی مواجه شوید که پاسخگو نیست\&. همچنین در نظر داشته باشید که به‌طور پیش‌فرض، KMSCON تلاش می‌کند از ترمینال کنترل‌کننده خود به‌عنوان VT استفاده کند و اگر موفق نشود، سعی می‌کند یک VT جدید و استفاده‌نشده را تخصیص دهد\&. .RE .PP \fB\-\-switchvt\fR .RS 4 اگر KMSCON روی یک VT اجرا شود که در آن لحظه فعال نیست، این گزینه باعث می‌شود KMSCON هنگام راه‌اندازی، این VT را فعال کند\&. به همین ترتیب، در هنگام خاموش شدن نیز KMSCON همان VTی را که پیش از آن فعال بوده مجدداً فعال خواهد کرد\&. (پیش‌فرض: فعال) .RE .PP \fB\-\-libseat\fR .RS 4 استفاده از libseat برای مدیریت seat، دستگاه‌های ورودی و دستگاه‌های تصویر\&. این گزینه تنها در صورتی موجود است که KMSCON همراه با پشتیبانی از libseat کامپایل شده باشد\&. برای غیرفعال کردن آن از \-\-no\-libseat استفاده کنید\&. (پیش‌فرض: غیرفعال) .RE .PP گزینه‌های نشست (Session): .PP \fB\-\-session\-max {num}\fR .RS 4 تغییر حداکثر تعداد نشست‌های مجاز روی هر seat\&. برای حالت نامحدود از \*(Aq0\*(Aq استفاده کنید\&. (پیش‌فرض: 50) .RE .PP \fB\-\-session\-control\fR .RS 4 اجازه دادن به میانبرهای صفحه‌کلید برای کنترل مدیر نشست\&. این گزینه به کاربر امکان می‌دهد از طریق ورودی صفحه‌کلید، نشست‌های جدید ایجاد کند، آن‌ها را خاتمه دهد و میان نشست‌ها جابه‌جا شود\&. (پیش‌فرض: غیرفعال) .RE .PP گزینه‌های ترمینال: .PP \fB\-l\fR, \fB\-\-login\fR .RS 4 مشخص کردن برنامه‌ای که در نشست‌های جدید ترمینال آغاز می‌شود\&. این گزینه هیچ آرگومانی نمی‌پذیرد، بلکه هر آنچه بعد از پردازش تمام گزینه‌ها باقی بماند، به‌عنوان آرگومان برای این گزینه در نظر گرفته خواهد شد\&. توجه داشته باشید که هیچ مقداری بعد از دو خط‌تیره \fB\-\-\fR توسط kmscon به‌عنوان یک گزینه معمولی پردازش نمی‌شود\&. (پیش‌فرض: /bin/login \-p) .sp اگر این گزینه در فایل پیکربندی مشخص شود، آرگومان بر اساس قواعد شل POSIX به واژه‌ها تقسیم می‌گردد\&. با قرار دادن آرگومان در گیومه تکی یا جفتی، یا با افزودن یک بک‌اسلش در ابتدای آن، می‌توان فاصله‌ها را در آرگومان لحاظ کرد\&. .sp این مثال \*(Aq/bin/bash \-i\*(Aq را در هر نشست جدید ترمینال اجرا می‌کند: \&./kmscon \-\-login \-\-debug \-\-no\-switchvt \-\- /bin/bash \-i .RE .PP \fB\-\-oneshot\fR .RS 4 پس از خروج فرایند ورود (login)، اجرای kmscon را متوقف کن\&. این مورد برای اسکریپت‌های راه‌اندازی یا درخواست رمزنگاری دیسک مفید است\&. (پیش‌فرض: غیرفعال) .RE .PP \fB\-t {term}\fR, \fB\-\-term {term}\fR .RS 4 مشخص کردن متغیر محیطی \fI$TERM\fR که روی نشست‌های جدید ترمینال مقداردهی می‌شود\&. (پیش‌فرض: kmscon) .RE .PP \fB\-\-reset\-env\fR .RS 4 بازنشانی محیط قبل از راه‌اندازی فرایند فرزند\&. (پیش‌فرض: فعال) .RE .PP \fB\-\-issue\fR .RS 4 نمایش فایل‌های issue پیش از اعلان ورود\&. برای سپردن مدیریت این موضوع به فرایند login، از گزینه \-\-no\-issue استفاده کنید\&. (پیش‌فرض: فعال) .RE .PP \fB\-\-issue\-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 \fB\-\-asciicast {path}\fR .RS 4 پخش یک پویانمایی asciicast پس از باز شدن نشست ترمینال\&. با دریافت هرگونه ورودی صفحه‌کلید، پویانمایی متوقف می‌شود\&. (پیش‌فرض: تنظیم‌نشده) .RE .PP \fB\-\-asciicast\-loop\fR .RS 4 تکرار مداوم پویانمایی asciicast به‌صورت حلقه\&. (پیش‌فرض: غیرفعال) .RE .PP \fB\-\-backspace\-delete\fR .RS 4 ارسال نویسه delete هنگام فشردن کلید backspace\&. (پیش‌فرض: فعال) .RE .PP \fB\-\-sb\-size {size}\fR .RS 4 مشخص کردن اندازه بافر پیمایش به بالا (scrollback) بر حسب تعداد خطوط\&. (پیش‌فرض: 1000) .RE .PP \fB\-\-bell\fR .RS 4 فعال‌سازی ارسال صدای زنگ (bell) به VT\&. در صورت فعال بودن، نویسه BEL (0x07) از برنامه‌ها به VT زیرین منتقل می‌شود\&. (پیش‌فرض: غیرفعال) .RE .PP \fB\-\-blink\fR .RS 4 فعال‌سازی چشمک زدن مکان‌نما و متن\&. در صورت فعال بودن، مکان‌نما روی صفحه چشمک می‌زند و متن‌های دارای ویژگی چشمک‌زن نیز چشمک خواهند زد\&. (پیش‌فرض: فعال) .RE .PP گزینه‌های ورودی: .PP \fB\-\-xkb\-model {model}\fR .RS 4 مشخص کردن مدل صفحه‌کلید (xkb)\&. در حالت معمول نباید این مورد تغییر داده شود\&. (پیش‌فرض: {xkb default}) .RE .PP \fB\-\-xkb\-layout {layout}\fR .RS 4 مشخص کردن چیدمان صفحه‌کلید (xkb)\&. (پیش‌فرض: {xkb default}) .sp مثال برای صفحه‌کلید آلمانی: \-\-xkb\-layout=de .RE .PP \fB\-\-xkb\-variant {variant}\fR .RS 4 مشخص کردن گونه (variant) صفحه‌کلید (xkb)\&. (پیش‌فرض: {xkb default}) .RE.PP \fB\-\-xkb\-options {options}\fR .RS 4 مشخص کردن سایر گزینه‌های صفحه‌کلید (xkb)\&. (پیش‌فرض: {xkb default}) .RE .PP \fB\-\-xkb\-keymap {file}\fR .RS 4 مسیر به یک فایل نگاشت کلید (keymap) از پیش تعریف‌شده\&. این گزینه بر گزینه‌های بالا اولویت دارد\&. یک مسیر خالی "" به‌معنای عدم استفاده از نگاشت کلید تفسیر می‌شود\&. (پیش‌فرض: استفاده نمی‌شود) .RE .PP \fB\-\-xkb\-compose\-file {file}\fR .RS 4 مسیر به یک فایل ترکیب (compose file) از پیش تعریف‌شده\&. یک مسیر خالی "" به‌معنای استفاده از فایل پیش‌فرض ترکیب در نظر گرفته می‌شود\&. ترتیب جستجوی فایل پیش‌فرض ترکیب در \fBCompose\fR(5) شرح داده شده است\&. لوکال از نخستین متغیر میان \fBLC_ALL\fR، \fBLC_CTYPE\fR یا \fBLANG\fR که روی مقداری غیرخالی تنظیم شده باشد تعیین می‌شود\&. اگر لوکال قابل تشخیص نباشد، C فرض می‌شود\&. اگر هیچ فایل ترکیبی یافت نشود، ترکیب حروف غیرفعال می‌گردد\&. (پیش‌فرض: جستجوی فایل ترکیب متناظر با لوکال جاری) .RE .PP \fB\-\-xkb\-repeat\-delay {delay}\fR .RS 4 تأخیر پس از فشرده‌شدن کلید تا آغاز تکرار کلید (به میلی‌ثانیه)\&. (پیش‌فرض: 250) .RE .PP \fB\-\-xkb\-repeat\-rate {rate}\fR .RS 4 زمان بین دو تکرار کلید (به میلی‌ثانیه)\&. (پیش‌فرض: 50) .RE .PP \fB\-\-mouse\fR .RS 4 فعال‌سازی ماوس/تاچ‌پد/ترک‌پوینت در kmscon (پیش‌فرض: روشن)\&. این گزینه امکان انتخاب، و رونوشت/جای‌گذاری متن با یک دستگاه اشاره‌گر، و همچنین پیمایش با چرخ ماوس را فراهم می‌کند\&. این قابلیت هنوز آزمایشی است و ممکن است با برخی دستگاه‌های خاص کار نکند\&. .RE .PP \fB\-\-soft\-cursor\fR .RS 4 اجبار به استفاده از نشانگر نرم‌افزاری، در صورتی که نشانگر سخت‌افزاری به‌درستی کار نمی‌کند\&. (پیش‌فرض: خاموش) .RE .PP \fB\-\-dpms\-timeout\fR .RS 4 تنظیم زمان خاموشی صفحه نمایش به ثانیه (پیش‌فرض: 600 = 10 دقیقه)\&. هنگام فعال بودن، پس از گذشت مدت زمان مشخص‌شده از عدم فعالیت صفحه‌کلید و ماوس، صفحه نمایش به‌طور خودکار خاموش می‌شود (DPMS OFF)\&. هرگونه ورودی صفحه‌کلید یا ماوس صفحه را دوباره روشن کرده و زمان‌سنج را بازنشانی می‌کند\&. این قابلیت برای صرفه‌جویی در مصرف انرژی در سیستم‌هایی که صفحه نمایش همیشه مورد نیاز نیست مفید است\&. برای غیرفعال کردن روی 0 تنظیم کنید\&. .RE .PP میانبرها / تسخیرهای صفحه‌کلید (Grabs / Keyboard Shortcuts): .PP تمام میانبرهای صفحه‌کلید (در اینجا: تسخیرها یا grabs) در KMSCON را می‌توان با این گزینه‌ها تغییر داد\&. آرگومان چنین گزینه‌ای فهرستی از میانبرهای صفحه‌کلید جداشده با ویرگول است که باید اقدام مشخص‌شده را فعال کنند\&. .PP برای غیرفعال کردن یک میانبر، یک آرگومان خالی (فهرست خالی) ارسال کنید\&. یک میانبر صفحه‌کلید شامل فهرستی از کلیدهای تبدیل (modifiers) است که به دنبال آن یک تک‌کلید می‌آید\&. برای اینکه میانبر شناسایی شود، همه کلیدهای تبدیل باید هنگام فشردن کلید، پایین نگه داشته شده باشند\&. کلید تبدیل با \*(Aq<\*(Aq و \*(Aq>\*(Aq احاطه می‌شود (مانند \*(Aq\*(Aq)\&. یک کلید، نام یک keysym است (مانند \*(Aqa\*(Aq یا \*(AqReturn\*(Aq)\&. نام‌های keysym به کوچک و بزرگی حروف حساس هستند و در صورت وارد کردن اندازه نادرست حروف، KMSCON یک نام keysym پیشنهاد می‌دهد\&. با این حال، KMSCON همیشه نمی‌تواند حالت درست را حدس بزند چرا که keysym‌های فقط‌کوچک مبهم هستند\&. .PP اگر کلیدی در چیدمان صفحه‌کلید شما چندین keysym تولید می‌کند، می‌توانید با الحاق کردن keysymها با \*(Aq+\*(Aq آنها را مطابقت دهید (مانند \*(AqH+E+L+L+O\*(Aq)\&. این به این معنی نیست که همه کلیدهای فهرست‌شده باید فشرده شوند! بلکه روشی برای تطبیق کلیدهای چند\-keysym است\&. .PP کلیدهای تبدیل معتبر: Shift، Control/Ctrl، Alt، Logo (کلید Windows/Apple)\&. .PP \fB\-\-grab\-scroll\-up {grab}\fR .RS 4 پیمایش به بالا در بافر پیمایش به میزان یک خط\&. (پیش‌فرض: Up) .RE .PP \fB\-\-grab\-scroll\-down {grab}\fR .RS 4 پیمایش به پایین در بافر پیمایش به میزان یک خط\&. (پیش‌فرض: Down) .RE .PP \fB\-\-grab\-page\-up {grab}\fR .RS 4 پیمایش به بالا در بافر پیمایش به میزان یک صفحه\&. (پیش‌فرض: Prior/PageUp) .RE .PP \fB\-\-grab\-page\-down {grab}\fR .RS 4 پیمایش به پایین در بافر پیمایش به میزان یک صفحه\&. (پیش‌فرض: Next/PageDown) .RE .PP \fB\-\-grab\-zoom\-in {grab}\fR .RS 4 افزایش اندازه قلم ترمینال جاری\&. (پیش‌فرض: plus) .RE .PP \fB\-\-grab\-zoom\-out {grab}\fR .RS 4 کاهش اندازه قلم ترمینال جاری\&. (پیش‌فرض: minus) .RE .PP \fB\-\-grab\-session\-next {grab}\fR .RS 4 جابجایی به نشست بعدی\&. (پیش‌فرض: Right) .RE .PP \fB\-\-grab\-session\-prev {grab}\fR .RS 4 جابجایی به نشست قبلی\&. (پیش‌فرض: Left) .RE .PP \fB\-\-grab\-session\-close {grab}\fR .RS 4 دوبار فشردن برای بستن نشست جاری\&. (پیش‌فرض: BackSpace) .RE .PP \fB\-\-grab\-terminal\-new {grab}\fR .RS 4 ایجاد نشست ترمینال جدید در کنار نشست جاری\&. (پیش‌فرض: Return) .RE .PP \fB\-\-grab\-rotate\-cw {grab}\fR .RS 4 چرخش خروجی در جهت عقربه‌های ساعت: Normal \-> Right \-> Inverted \-> Left و غیره\&. (پیش‌فرض: Plus) .RE .PP \fB\-\-grab\-rotate\-ccw {grab}\fR .RS 4 چرخش خروجی در خلاف جهت عقربه‌های ساعت: Normal \-> Left \-> Inverted \-> Right و غیره\&. (پیش‌فرض: Minus) .RE .PP \fB\-\-grab\-reboot {grab}\fR .RS 4 راه‌اندازی مجدد سیستم هنگام فشرده‌شدن این میانبر صفحه‌کلید\&. این گزینه به‌طور پیش‌فرض غیرفعال است (هیچ کلید پیش‌فرضی اختصاص داده نشده است)\&. با احتیاط استفاده شود زیرا راه‌اندازی مجدد فوری و بدون تأیید انجام می‌گیرد\&. مثال: \-\-grab\-reboot=Delete (پیش‌فرض: غیرفعال) .RE .PP گزینه‌های ویدیو (Video Options): .PP \fB\-\-drm\fR .RS 4 استفاده از دستگاه‌های DRM (مدیر رندر مستقیم، معمولاً پردازنده‌های گرافیکی) به‌عنوان دستگاه‌های نمایشگر\&. دستگاه‌های fbdev (فریم‌بافر) همیشه استفاده می‌شوند، اما دستگاه‌های DRM فقط در صورتی استفاده می‌شوند که این گزینه فعال باشد\&. (پیش‌فرض: روشن) .RE .PP \fB\-\-hwaccel\fR .RS 4 استفاده از شتاب‌دهنده سخت‌افزاری سه‌بعدی\&. روی سخت‌افزارهای جدیدتر، این می‌تواند سرعت رندر را چندین برابر افزایش دهد\&. با این حال، روی سخت‌افزارهای قدیمی‌تر ممکن است سرعت رندر را کاهش دهد\&. (پیش‌فرض: خاموش) .sp نکته: این گزینه باید همراه با \fB\-\-drm\fR فعال شود\&. .RE .PP \fB\-\-gpus {all,aux,primary}\fR .RS 4 مشخص کردن اینکه کدام GPU(ها) می‌توانند برای خروجی ترمینال استفاده شوند\&. اگر `all\*(Aq مشخص شود، تمام GPUهای یافت‌شده استفاده می‌شوند\&. اگر `aux\*(Aq مشخص شود، هم GPUهای اصلی و هم کمکی استفاده می‌شوند\&. اگر `primary\*(Aq مشخص شود، تنها GPUهای اصلی استفاده می‌شوند\&. (پیش‌فرض: all) .sp نکته: GPUهای اصلی (Primary GPUs)، پردازنده گرافیکی پیش‌فرض روی یک seat هستند\&. در هر seat همیشه فقط یک GPU اصلی وجود دارد\&. GPUهای کمکی (Auxiliary GPUs)، پردازنده‌های گرافیکی با قابلیت اتصال گرم (hot\-pluggable) هستند که نمایشگرهای مستقل اضافی فراهم می‌کنند\&. .RE .PP \fB\-\-use\-original\-mode\fR .RS 4 استفاده از حالت اولیه KMS برای جلوگیری از تنظیم حالت (modesetting)\&. (پیش‌فرض: روشن) .sp این گزینه با \-\-mode ناسازگار است\&. .RE .PP \fB\-\-mode {width}x{height}\fR .RS 4 تنظیم حالت خروجی دلخواه\&. عرض و ارتفاع داده‌شده باید دقیقاً با یک حالت پشتیبانی‌شده مطابقت داشته باشد تا این گزینه تأثیری داشته باشد؛ اگر حالت پشتیبانی‌شده‌ای وجود نداشته باشد که دقیقاً مطابقت کند، یا در صورت بروز خطا هنگام استفاده از حالت مورد نظر، از حالت پیش‌فرض (نخستین حالت معتبر یافت‌شده) استفاده خواهد شد\&. .sp برای استفاده از این گزینه، باید \-\-use\-original\-mode غیرفعال باشد\&. .sp قابلیت Modesetting فقط در حالت DRM پشتیبانی می‌شود، بنابراین این گزینه در fbdev هیچ کاری انجام نمی‌دهد\&. با این حال، هنگام استفاده از fbdev همچنان می‌توان از fbset برای تنظیم حالت به‌صورت خارجی استفاده کرد\&. .sp سایر اجزای سیستم ممکن است برای استفاده مؤثر از حالت مورد نظر نیاز به پیکربندی داشته باشند\&. برای نمونه، ممکن است پارامتر هسته `video={width}x{height}` لازم باشد تا اطمینان حاصل شود که حافظه کافی برای ذخیره فریم‌بافرها در وضوح‌های بالا وجود دارد\&. .RE .PP \fB\-\-multi\-monitor {clone,largest}\fR .RS 4 هنگامی که چندین نمایشگر وجود دارد، این گزینه نحوه استفاده از نمایشگرها را کنترل می‌کند\&. .sp `clone\*(Aq: همه نمایشگرها اندازه یکسانی خواهند داشت\&. کوچک‌ترین نمایشگر برای تعیین اندازه استفاده خواهد شد\&. .sp `largest\*(Aq: بزرگ‌ترین نمایشگر برای تعیین اندازه استفاده خواهد شد\&. سایر نمایشگرها غیرفعال خواهند شد\&. اگر چندین نمایشگر دارای بزرگ‌ترین اندازه باشند، از همه آنها استفاده خواهد شد\&. .sp پیش‌فرض: clone .RE .PP \fB\-\-rotate {orientation}\fR .RS 4 انتخاب جهت‌گیری دلخواه خروجی\&. جهت‌گیری‌های موجود عبارتند از \*(Aqnormal\*(Aq به این معنی که خروجی چرخانده نمی‌شود، \*(Aqright\*(Aq به این معنی که خروجی 90\(de در جهت عقربه‌های ساعت می‌چرخد، \*(Aqupside\-down\*(Aq به این معنی که خروجی 180\(de در جهت عقربه‌های ساعت می‌چرخد، و \*(Aqleft\*(Aq به این معنی که خروجی 90\(de در خلاف جهت عقربه‌های ساعت می‌چرخد\&. (پیش‌فرض: \*(Aqnormal\*(Aq) .RE .PP گزینه‌های قلم (Font Options): .PP \fB\-\-font\-engine {engine}\fR .RS 4 مشخص کردن موتور رندر قلم\&. موتورهای موجود عبارتند از `freetype\*(Aq، `pango\*(Aq، `unifont\*(Aq، `psf\*(Aq و `8x16\*(Aq\&. (پیش‌فرض: freetype) .RE .PP \fB\-\-font\-size {pixels}\fR .RS 4 اندازه قلم به پیکسل\&. (پیش‌فرض: 16) .RE .PP \fB\-\-font\-name {name}\fR .RS 4 نام (یا مسیر برای psf) قلم مورد استفاده؛ توجه داشته باشید که اگر موتور رندر قلم `freetype\*(Aq یا `pango\*(Aq مشخص شده باشد، ممکن است از قلم جایگزین Fontconfig استفاده شود\&. (پیش‌فرض: monospace) .RE .PP گزینه‌های پالت رنگ (Palette Options): .PP \fB\-\-palette {name}\fR .RS 4 مشخص کردن پالت رنگ پیش‌فرض\&. مقدار custom را مشخص کنید تا از پالت رنگ گزینه‌های بعدی استفاده شود\&. .RE.PP در گزینه‌های زیر، \fIcolors\fR به‌صورت مقدار رنگی RGB مشخص می‌شوند که با سه عدد صحیحِ جداشده با کاما بین 0 و 255 (شامل هر دو) نوشته می‌شوند\&. .PP \fB\-\-palette\-black {color}\fR .RS 4 تنظیم رنگ سیاه در پالت سفارشی روی \fIcolor\fR\&. (پیش‌فرض: 0, 0, 0) .RE .PP \fB\-\-palette\-red {color}\fR .RS 4 تنظیم رنگ قرمز در پالت سفارشی روی \fIcolor\fR\&. (پیش‌فرض: 205, 0, 0) .RE .PP \fB\-\-palette\-green {color}\fR .RS 4 تنظیم رنگ سبز در پالت سفارشی روی \fIcolor\fR\&. (پیش‌فرض: 0, 205, 0) .RE .PP \fB\-\-palette\-yellow {color}\fR .RS 4 تنظیم رنگ زرد در پالت سفارشی روی \fIcolor\fR\&. (پیش‌فرض: 205, 205, 0) .RE .PP \fB\-\-palette\-blue {color}\fR .RS 4 تنظیم رنگ آبی در پالت سفارشی روی \fIcolor\fR\&. (پیش‌فرض: 0, 0, 238) .RE .PP \fB\-\-palette\-magenta {color}\fR .RS 4 تنظیم رنگ سرخابی در پالت سفارشی روی \fIcolor\fR\&. (پیش‌فرض: 205, 0, 205) .RE .PP \fB\-\-palette\-cyan {color}\fR .RS 4 تنظیم رنگ فیروزه‌ای در پالت سفارشی روی \fIcolor\fR\&. (پیش‌فرض: 0, 205, 205) .RE .PP \fB\-\-palette\-light\-grey {color}\fR .RS 4 تنظیم رنگ خاکستری روشن در پالت سفارشی روی \fIcolor\fR\&. (پیش‌فرض: 229, 229, 229) .RE .PP \fB\-\-palette\-dark\-grey {color}\fR .RS 4 تنظیم رنگ خاکستری تیره در پالت سفارشی روی \fIcolor\fR\&. (پیش‌فرض: 127, 127, 127) .RE .PP \fB\-\-palette\-light\-red {color}\fR .RS 4 تنظیم رنگ قرمز روشن در پالت سفارشی روی \fIcolor\fR\&. (پیش‌فرض: 255, 0, 0) .RE .PP \fB\-\-palette\-light\-green {color}\fR .RS 4 تنظیم رنگ سبز روشن در پالت سفارشی روی \fIcolor\fR\&. (پیش‌فرض: 0, 255, 0) .RE .PP \fB\-\-palette\-light\-yellow {color}\fR .RS 4 تنظیم رنگ زرد روشن در پالت سفارشی روی \fIcolor\fR\&. (پیش‌فرض: 255, 255, 0) .RE .PP \fB\-\-palette\-light\-blue {color}\fR .RS 4 تنظیم رنگ آبی روشن در پالت سفارشی روی \fIcolor\fR\&. (پیش‌فرض: 92, 92, 255) .RE .PP \fB\-\-palette\-light\-magenta {color}\fR .RS 4 تنظیم رنگ سرخابی روشن در پالت سفارشی روی \fIcolor\fR\&. (پیش‌فرض: 255, 0, 255) .RE .PP \fB\-\-palette\-light\-cyan {color}\fR .RS 4 تنظیم رنگ فیروزه‌ای روشن در پالت سفارشی روی \fIcolor\fR\&. (پیش‌فرض: 0, 255, 255) .RE .PP \fB\-\-palette\-white {color}\fR .RS 4 تنظیم رنگ سفید در پالت سفارشی روی \fIcolor\fR\&. (پیش‌فرض: 255, 255, 255) .RE .PP \fB\-\-palette\-foreground {color}\fR .RS 4 تنظیم رنگ پیش‌زمینهٔ پیش‌فرض در پالت سفارشی روی \fIcolor\fR\&. (پیش‌فرض: 229, 229, 229) .RE .PP \fB\-\-palette\-background {color}\fR .RS 4 تنظیم رنگ پس‌زمینهٔ پیش‌فرض در پالت سفارشی روی \fIcolor\fR\&. (پیش‌فرض: 0, 0, 0) .RE .SH "پیکربندی (CONFIGURATION)" .PP دایرکتوری پیش‌فرض پیکربندی /etc/kmscon است و فایل پیکربندی اصلی /etc/kmscon/kmscon\&.conf نام دارد\&. می‌توانید برای هر جایگاه (seat) یک فایل پیکربندی اضافی از طریق /etc/kmscon/{seatname}\&.kmscon\&.conf ارائه دهید\&. هر گزینهٔ خط فرمانی را که بتوان به KMSCON فرستاد، می‌توان درون این فایل‌های پیکربندی نیز قرار داد\&. برای نمونه: .sp .if n \{\ .RS 4 .\} .nf font\-name=Meslo LG M font\-size=14 login=/bin/bash \-i palette\-foreground=255, 0, 0 .fi .if n \{\ .RE .\} .PP گزینه‌های خط فرمان، گزینه‌های فایل پیکربندی را بازنویسی می‌کنند\&. همچنین فایل‌های پیکربندی به‌ازای هر seat، فایل پیکربندی سراسری را بازنویسی می‌کنند\&..SH "حالت پیش‌فرض (DEFAULT MODE)" .PP در حالت پیش‌فرض، KMSCON به عنوان جایگزینی برای \fBagetty\fR(1)\& عمل می‌کند\&. KMSCON یک پایانه مجازی باز کرده و یک کنسول سیستم روی آن فراهم می‌آورد\&. این برنامه جایگزین linux\-console روی این VT می‌شود\&. می‌توانید پایانه مجازی را با گزینه \fB\-\-vt\fR انتخاب کنید\&. KMSCON به‌طور یکپارچه با ساختارهای موجود هماهنگ می‌شود تا بتوانید هم‌زمان از X، Wayland یا هر سامانه گرافیکی دیگری استفاده کنید\&. حتی می‌توانید روی تمام پایانه‌های مجازی دیگر از linux\-console استفاده نمایید\&. .PP به‌طور پیش‌فرض، KMSCON روی seat جاری اجرا می‌شود\&. (معمولاً \fIseat0\fR است)\&. برای seatهایی که فاقد پایانه‌های مجازی هستند، KMSCON به‌طور خودکار فعال شده و به‌صورت انحصاری روی آن seat اجرا می‌شود\&. اگر پایانه مجازی یا seatی که kmscon روی آن اجرا می‌شود از بین برود، KMSCON به‌طور خودکار خارج خواهد شد\&. .PP برنامه KMSCON روی هر پایانه جدید \fBlogin\fR(1) را اجرا می‌کند\&. پس از خروج از یک نشست، KMSCON به‌طور خودکار نشست بعدی را مجدداً اجرا می‌نماید\&. می‌توانید برنامه‌ای را که فراخوانی می‌شود با گزینه \fB\-\-login\fR تغییر دهید\&. برای متوقف کردن kmscon، سیگنال SIGTERM را به فرایند KMSCON ارسال کنید\&. .PP ورودی صفحه‌کلید توسط \fIlibxkbcommon\fR انجام می‌شود\&. این کتابخانه همان قابلیت‌های سامانه صفحه‌کلید X11 را بدون هیچ‌گونه وابستگی به کتابخانه‌های X11 فراهم می‌کند\&. برای روش‌های تغییر چیدمان صفحه‌کلید، مدل، نرخ تکرار و موارد بیشتر، گزینه‌های \fI\-\-xkb\-{option}\fR را ببینید\&. به عنوان مثال \fB\-\-xkb\-layout=de\fR چیدمان صفحه‌کلید را به آلمانی تغییر می‌دهد\&. .PP برنامه KMSCON از KMS/DRM برای دسترسی به دستگاه‌های گرافیکی استفاده می‌کند (مشابه کاری که X\-Server انجام می‌دهد)\&. در مقایسه با کنسول لینوکس، این سازوکار به KMSCON اجازه می‌دهد تا رندر قلم (font\-rendering) بسیار بهتر و کنترل نمایشگر پیشرفته‌تری ارائه دهد\&. با این حال، برای سازگاری با گذشته، KMSCON می‌تواند از دستگاه‌های fbdev نیز استفاده کند\&. دستگاه‌های گرافیکی با قابلیت اتصال گرم به عنوان دستگاه‌های کمکی (auxiliary) علامت‌گذاری می‌شوند و GPUهای اصلی در یک seat به عنوان اصلی (primary) علامت می‌خورند\&. سایر GPUها بدون علامت باقی می‌مانند\&. به‌طور پیش‌فرض KMSCON از تمام دستگاه‌های گرافیکی استفاده می‌کند، اما می‌توانید با استفاده از گزینه \fB\-\-gpus\fR آن را محدود به استفاده از دستگاه‌های اصلی یا کمکی کنید\&. .SH "نشست‌ها (SESSIONS)" .PP اگر KMSCON روی یک seat فعال باشد، مدیر نشست داخلی بیدار می‌شود\&. در بیشتر مواقع، تنها نشست پایانه (terminal\-session) فعال است\&. می‌توانید با کلیدهای میان‌بر بین نشست‌ها جابه‌جا شوید و در زمان اجرا نشست‌های پایانه را ایجاد یا حذف کنید\&. .PP نشست‌های پایانه یک شبیه‌ساز پایانه ارائه می‌دهند\&. آن‌ها تنها نوع نشست هستند و تمام عملکردهای شبیه‌سازی پایانه را ارائه می‌کنند\&. .SH "پایانه‌های مجازی (VIRTUAL TERMINALS)" .PP از لحاظ تاریخی، لینوکس پایانه‌های مجازی (VT) را تنها روی جایگاه \fIseat0\fR ارائه می‌دهد\&. دلیل این امر آن است که در هر لحظه تنها یک VT می‌تواند فعال باشد، اما در محیط‌های چندکاربره (multi\-seat) شما خواهان چندین VT فعال، یکی به ازای هر seat هستید\&. اجرای KMSCON روی seat0 بر روی یک VT آسان است، اما اگر بخواهید KMSCON را روی seat دیگری اجرا کنید، هیچ VTای وجود ندارد\&. این بدان معناست که شما روی این seatها تنها می‌توانید یک برنامه اجرا کنید که از دستگاه‌های گرافیکی استفاده می‌کند\&. در بیشتر محیط‌ها این برنامه X\-Server است\&. اما اگر بخواهید KMSCON را همراه با X\-Server (یا هر کارساز گرافیکی دیگر) اجرا کنید، به سازوکاری نیاز دارید تا به این کارسازها اطلاع دهد چه زمانی فعال هستند\&. این کار از طریق رابط‌های برنامه‌نویسی VT روی seat0 انجام می‌شود\&. اما توجه داشته باشید اگر هسته بدون CONFIG_VT (که در دسترس بودن VTها را کنترل می‌کند) کامپایل شده باشد، در این صورت حتی seat0 نیز VT نخواهد داشت\&. .SH "همچنین ببینید (SEE ALSO)" .PP \fBconsole\fR(4), \fBCompose\fR(5)