'\" t .\" Title: kmscon.conf .\" Author: Mirco Müller .\" Generator: DocBook XSL Stylesheets vsnapshot .\" Date: January 2023 .\" Manual: kmscon.conf .\" Source: kmscon.conf .\" Language: English .\" .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 \- Configuration file for KMS/DRM based System Console .SH "DESCRIPTION" .PP kmscon\&.conf is the configuration file to control the behavior of kmscon and adjust it to your system\-setup\&. It allows to remap the bindings of keyboard\-shortcuts, define the desired keyboard\-layout, select font attributes for text\-rendering, hardware\-accelerationn, orientation of output and much more\&. .PP Below is a complete list of all recognized \fIOptions\fR, their meaning and possible values\&. In section \fIExample\fR is a typical real\-world sample of a configuration to guide you in creating your own\&. .SH "EXAMPLE" .PP Here is a real\-world example of a typical kmscon\&.conf file: .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 In any line, every character are ignored after a # and considered to be a comment\&. whitespace are ignored at begining and ending of a line, and around the \*(Aq=\*(Aq when assigning a parameter .SH "OPTIONS" .PP Below is a complete list of all recognized options, their meaning and possible values\&. .PP \fBverbose\fR .RS 4 Make kmscon be very chatty about what it is doing\&. It prints to stdout unless redirected\&. Off if not present in kmsconf\&.conf or commented out\&. (default: off) .RE .PP \fBdebug\fR .RS 4 Let kmscon be even more chatty\&. The text\-output goes to stdout or any file it was redirected to\&. Off if not present in kmsconf\&.conf or commented out\&. (default: off) .RE .PP \fBsilent\fR .RS 4 Suppress notices and warnings\&. (default: off) .RE .PP \fBconfigdir\fR .RS 4 Path to config directory\&. (default: /etc/kmscon) .RE .PP \fBvt\fR .RS 4 Select which VT to run on\&. (default: auto) .RE .PP \fBswitchvt\fR .RS 4 Automatically switch to VT\&. (default: on) .RE .PP \fBlibseat\fR .RS 4 Use libseat for seat management\&. (default: off) .RE .PP \fBsession\-max\fR .RS 4 Maximum number of sessions\&. (default: 50) .RE .PP \fBsession\-control\fR .RS 4 Allow keyboard session\-control\&. (default: off) .RE .PP \fBlogin\fR .RS 4 Start the given login process instead of the default process; all arguments following \*(Aq\-\-\*(Aq will be be parsed as argv to this process\&. No more options after \*(Aq\-\-\*(Aq will be parsed so use it at the end of the argument string\&. (default: /bin/login \-p) .RE .PP \fBterm\fR .RS 4 Value of the TERM environment variable for the child process\&. (default: kmscon) .RE .PP \fBreset\-env\fR .RS 4 Reset environment before running child process\&. (default: on) .RE .PP \fBissue\fR .RS 4 Display issue files before the login prompt\&. Use no\-issue to let the login process handle it\&. (default: on) .RE .PP \fBissue\-path\fR .RS 4 Colon\-separated list of issue files and directories to read, ordered by precedence\&. It implements uapi masking, so if there are multiple files, with the same name, only the first will be parsed\&. (default: "/etc/issue:/etc/issue\&.d:/run/issue:/run/issue\&.d:/usr/lib/issue:/usr/lib/issue\&.d") .RE .PP \fBasciicast\fR .RS 4 Path to an asciicast animation to play after opening the terminal session\&. The animation is stopped on keyboard input\&. (default: unset) .RE .PP \fBasciicast\-loop\fR .RS 4 Loop the asciicast animation\&. (default: off) .RE .PP \fBbackspace\-delete\fR .RS 4 Send delete character when backspace is pressed\&. (default: on) .RE .PP \fBpalette\fR .RS 4 Select the used color palette\&. (default: default) .RE .PP \fBsb\-size\fR .RS 4 Size of the scrollback\-buffer in lines\&. (default: 1000) .RE .PP \fBbell\fR .RS 4 Enable bell forwarding to the VT\&. When enabled, the BEL character (0x07) from applications is forwarded to the underlying VT\&. (default: off) .RE .PP \fBblink\fR .RS 4 Enable cursor and text blink\&. When enabled, the cursor will blink on the screen, and text with blink attribute will blink too\&. (default: on) .RE .PP \fBxkb\-model\fR .RS 4 Set XkbModel for input devices\&. (default: unset) .RE .PP \fBxkb\-layout\fR .RS 4 Set XkbLayout for input devices\&. (default: unset) .RE .PP \fBxkb\-variant\fR .RS 4 Set XkbVariant for input devices\&. (default: unset) .RE .PP \fBxkb\-options\fR .RS 4 Set XkbOptions for input devices\&. (default: unset) .RE .PP \fBxkb\-keymap\fR .RS 4 Use a predefined keymap for input devices\&. (default: unset) .RE .PP \fBxkb\-repeat\-delay\fR .RS 4 Initial delay for key\-repeat in ms\&. (default: 250) .RE .PP \fBxkb\-repeat\-rate\fR .RS 4 Delay between two key\-repeats in ms\&. (default: 50) .RE .PP \fBmouse\fR .RS 4 Enable mouse/touchpad/trackpoint in kmscon (default: on)\&. It allows to select, and copy/paste text with a pointing device, and also to scroll with the mouse wheel\&. It\*(Aqs still experimental, and may not work with specific devices\&. .RE .PP \fBnatural\-scrolling\fR .RS 4 Invert the mouse wheel direction (natural scrolling)\&. When enabled, scrolling up with the wheel scrolls down and vice versa\&. (default: off) .RE .PP \fBsoft\-cursor\fR .RS 4 Force software cursor, if hardware cursor is not working properly\&. (default: off) .RE .PP \fBdpms\-timeout\fR .RS 4 Set screen timeout in seconds (default: 600 = 10 minutes)\&. When enabled, the screen will automatically turn off (DPMS OFF) after the specified period of keyboard and mouse inactivity\&. Any keyboard or mouse input will turn the screen back on and reset the timer\&. This feature is useful for power saving on systems where the screen is not always needed\&. Set to 0 to disable\&. .RE .PP \fBgrab\-scroll\-up\fR .RS 4 Shortcut to scroll up\&. (default: Up) .RE .PP \fBgrab\-scroll\-down\fR .RS 4 Shortcut to scroll down\&. (default: Down) .RE .PP \fBgrab\-page\-up\fR .RS 4 Shortcut to scroll page up\&. (default: Prior) .RE .PP \fBgrab\-page\-down\fR .RS 4 Shortcut to scroll page down\&. (default: Next) .RE .PP \fBgrab\-zoom\-in\fR .RS 4 Shortcut to increase font size\&. (default: Plus) .RE .PP \fBgrab\-zoom\-out\fR .RS 4 Shortcut to decrease font size\&. (default: Minus) .RE .PP \fBgrab\-session\-next\fR .RS 4 Switch to next session\&. (default: Right) .RE .PP \fBgrab\-session\-prev\fR .RS 4 Switch to previous session\&. (default: Left) .RE .PP \fBgrab\-session\-close\fR .RS 4 Close current session\&. (default: BackSpace) .RE .PP \fBgrab\-terminal\-new\fR .RS 4 Create new terminal session\&. (default: Return) .RE .PP \fBgrab\-rotate\-cw\fR .RS 4 Rotate output clock\-wise\&. (default: Plus) .RE .PP \fBgrab\-rotate\-ccw\fR .RS 4 Rotate output counter\-clock\-wise\&. (default: Minus) .RE .PP \fBgrab\-reboot\fR .RS 4 Reboot the system when this keyboard shortcut is pressed\&. This option is disabled by default\&. The reboot behavior follows the system\-wide setting in /proc/sys/kernel/ctrl\-alt\-del: when set to 0 (default), a graceful reboot is performed by sending SIGINT to init (PID 1); when set to a value greater than 0, an immediate hard reboot is performed after syncing disk buffers\&. Example: grab\-reboot=Delete (default: disabled) .RE .PP \fBdrm\fR .RS 4 Use DRM if available\&. (default: on) .RE .PP \fBhwaccel\fR .RS 4 Use 3D hardware\-acceleration if available\&. (default: off) .RE .PP \fBgpus\fR .RS 4 GPU selection mode\&. (default: all) .RE .PP \fBuse\-original\-mode\fR .RS 4 Use the original KMS video mode\&. (default: on) .RE .PP \fBmode\fR .RS 4 Set the resolution to {width}x{height} .RE .PP \fBmulti\-monitor {clone,largest}\fR .RS 4 When there are multiple monitors, this option controls how the monitors are used\&. .sp `clone\*(Aq: All monitors will have the same size\&. The smallest monitor will be used to determine the size\&. .sp `largest\*(Aq: The largest monitor will be used to determine the size\&. The other monitors will be disabled\&. If multiple monitors have the largest size, they will all be used\&. .sp default: clone .RE .PP \fBrotate\fR .RS 4 Orientation of output to use\&. (default: normal) .RE .PP \fBfont\-engine\fR .RS 4 Font engine to use\&. (default: freetype) .RE .PP \fBfont\-size\fR .RS 4 Font size in pixels\&. (default: 16) .RE .PP \fBfont\-name\fR .RS 4 Font name to use\&. (default: monospace) .RE .SH "FILES" .PP \fBMain configuration file\fR .RS 4 /etc/kmscon/kmscon\&.conf .RE .PP \fBSeat specific configuration file\fR .RS 4 /etc/kmscon/{seat_name}\&.kmscon\&.conf .RE .SH "SEE ALSO" .PP \fBkmscon\fR(1)