These routines initialize the keyboard to raw mode. No ASCII codes are produced, instead svgalib keeps track of each single keypress or depress. The return_fd version returns the file descriptor of the console device to allow you to do further tricks with it (though it is unclear which). The other version just returns 0 if successful. Both return -1 on error.
keyboard_close(3) returns to normal operation.
When in raw keyboard mode you can no longer use vga_getch(3) or vga_getkey(3) but you must use keyboard_getstate(3) or keyboard_keypressed(3).
Depending on the setting of keyboard_translatekeys(3) even in raw mode a <Ctrl>-C will cause a SIGINT. In any case svgalib will check for <Alt>-F1 - <Alt>-F10 and perform console switches accordingly.
svgalib(7), vgagl(7), libvga.config(5), keytest(6), eventtest(6), keyboard_seteventhandler(3), keyboard_close(3), keyboard_update(3), keyboard_waitforupdate(3), keyboard_setdefaulteventhandler(3), keyboard_getstate(3), keyboard_clearstate(3), keyboard_translatekeys(3), keyboard_keypressed(3), vga_waitevent(3)
This manual page was edited by Michael Weller <firstname.lastname@example.org>. The exact source of the referenced function as well as of the original documentation is unknown.
It is very likely that both are at least to some extent are due to Harm Hanemaayer <H.Hanemaayer@inter.nl.net>.
Occasionally this might be wrong. I hereby asked to be excused by the original author and will happily accept any additions or corrections to this first version of the svgalib manual.
keyboard_clearstate(3), keyboard_close(3), keyboard_getstate(3), keyboard_keypressed(3), keyboard_seteventhandler(3), keyboard_translatekeys(3), keyboard_update(3), svgalib(7), vga_getkey(3).
The man page keyboard_init_return_fd(3) is an alias of keyboard_init(3).