3 +description: "Use for real Linux kernel virtual console work: tty1/tty2, /dev/ttyN, Ctrl+Alt+F1 VTs, TERM=linux, getty, vconsole.conf, setfont, loadkeys, setterm, console_codes, fbcon. Not for terminal emulators, /dev/pts ptys, tmux, X11, or Wayland."
10 +Use for kernel virtual consoles only:
14 +- `tty1`, `tty2`, ...
15 +- `Ctrl+Alt+F1` / VT switching
16 +- `getty`, `vconsole.conf`, `setfont`, `loadkeys`, `setterm`, `fbcon`
20 +- graphical terminal emulators
21 +- `/dev/pts/*` pseudo-terminals
23 +- X11 / Wayland / XKB config
27 +Run before advice/changes:
32 +infocmp -1
"${TERM:-linux}" 37 +- `/dev/ttyN` + `TERM=linux` → real VT likely.
38 +- `/dev/pts/N` → terminal emulator/pty; stop unless user asks docs only.
39 +- Missing local man page → fetch current upstream man page.
41 +##
Learn Locally First 43 +Prefer local truth over memory:
46 +man console_codes
| col -b
48 +man vconsole.conf
| col -b
49 +man loadkeys
| col -b
56 +For deeper lookup: `references/research.md`.
60 +- `TERM=linux` describes Linux-console capabilities via terminfo.
61 +- `clear` and `reset` differ; inspect `infocmp -1 linux`.
62 +- Linux console interprets control/escape sequences; verify in
64 +- Existing screen cells may need redraw after display/attribute changes.
65 +- Keymap, font, palette, and persistence scopes differ; classify first.
69 +For every proposed change, state:
71 +- target: current VT | all VTs | boot/persistent
72 +- mechanism: escape seq | terminfo | kbd tool | system config | ioctl
73 +- privilege needs: none | user permissions | root/admin | unknown until probed
74 +- rollback/reset path
78 +- Never apply X11/Wayland/XKB/niri fixes to Linux console.
79 +- Never confuse `/dev/ttyN` with `/dev/pts/N`.
80 +- Do not change keymaps/fonts/persistent config without explicit user intent.
81 +- Prefer `setterm`, `loadkeys`, `setfont`, `vconsole.conf` docs over guesses.
87 +- `references/research.md` — fresh docs, command probes, web fallbacks.
88 +- `references/model.md` — VT model, terminfo, reset/clear, screen memory.
89 +- `references/tools.md` — setterm/loadkeys/setfont/vconsole scope notes.