Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   3132 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

INSTALL-KEYMAP(8)					     INSTALL-KEYMAP(8)

NAME
       install-keymap  —  expand  a  given  keymap and install it as boot-time
       keymap

SYNOPSIS
       install-keymap [keymap-name | NONE | KERNEL]

DESCRIPTION
       install-keymap usually takes a keymap-name as argument.	 The  file  is
       passed  to loadkeys for loading, so that valid values for this argument
       are the same  than  that	 of  arguments	to  loadkeys.	install-keymap
       expands	include-like  statements  in that file, and puts the result in
       /etc/console/boottime.kmap.gz, which will be loaded into the kernel  at
       boot-time.

       One may also specify KERNEL instead of a keymap name, causing /etc/con‐
       sole/boottime.kmap.gz	 to be removed, making	sure  that  no	custom
       keymap will replace the kernel's builtin keymap at next reboot.

       An argument of NONE tells the command to do nothing.  It can be used by
       caller scripts to avoid	handling  this	special	 case  and  needlessly
       duplicate code.

       The  purpose  of	 this processing is to solve an annoying problem, of 2
       apparently conflicting issues.  The first one is an important  goal  of
       keymap  management in Debian, namely ensuring that whenever the user or
       admin is expected to use the keyboard, the keymap selected as boot-time
       keymap is in use; this means the keymap has to be loaded before a shell
       is ever proposed, which means very early in the	booting	 process,  and
       especially     before	 all	local	 filesystems	are    mounted
       (/etc/rcS.d/S10checkroot.sh can spawn sulogin).

       The second issue	 is  that  for	flexibility  we	 allow	that  /usr  or
       /usr/share   may	  live	 on   their   own   partition(s),   and	  thus
       /usr/share/keymaps, where keymap files live, may not be	available  for
       reading at the time we need a keymap file.  And no, we won't put 1Mb of
       keymaps in the root partition just for this.

       And the problem is, most keymap files are  not  self-contained,	so  it
       does  not  help to just copy the selected file into the root partition.
       The best known solution so far is to expand the keymap file so that  it
       becomes	self-contained, and put it in the root partition.  That's what
       this tool does.

FILES
       /etc/console/boottime.kmap.gz

       Where the boot-time keymap is stored

SEE ALSO
       loadkeys (8).

AUTHOR
       This  program  and  manual  page	 were  written	by  Yann  Dirson  dir‐
       son@debian.org  for  the	 Debian GNU/Linux system, but as it should not
       include any Debian-specific code, it may be used by others.

							     INSTALL-KEYMAP(8)

Vote for polarhome