These functions extract and use capabilities from a keyboard capability data
base, usually
/usr/share/misc/keycap.pcvt,
the format of which is described in
keycap(5).
The
kgetent
function
extracts the entry for keyboard mapping
name
into the buffer at
bp.
The
bp
argument
should be a character buffer of size
1024 and must be retained through all subsequent calls to
kgetnum,
kgetflag,
and
kgetstr.
The
kgetent
function
returns -1 if none of the
keycap
data base files could be opened,
0 if the map name given does not have an entry,
and 1 if all goes well.
The
kgetnum
function
gets the numeric value of capability
id,
returning -1 if is not given for the map.
The
kgetflag
function
returns 1 if the specified capability is present in
the maps entry, 0 if it is not.
The
kgetstr
function
returns the string value of the capability
id,
places it in the buffer at
area,
and advances the
area
pointer.
The
kgetstr
function
returns
NULL
if the capability was not found.