BitHeaven
/
xkblayout-state
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
20 Commits 1 Branch 0 Tags 59 KiB
C++ 96.3%
Makefile 2.1%
Dockerfile 1.6%
Go to file
selurvedu 58fa6eb1f9 Support symbol strings with '_' in place of '+' 
This fixes a segfault that occurs for the following reason:

 - In XKeyboard::initializeXkb(), the XkbSymbolParser::parse() is called
   with three arguments - string to process (symName),
   vector to push symbol names to (_symbolNames)
   and vector to push variant names to (_variantNames).

 - In XkbSymbolParser::parse(), it looks for char '+' in symName string,
   but Xkb may use '_' instead when creating that string. If the char
   is not found, parse() doesn't append anything to vectors and they
   remain empty.

 - Later, XKeyboard::initializeXkb() tries to access nonexistent data in
   _symbolNames, which causes a segmentation fault (on lines 162-163).
 		2015-07-20 01:05:59 +03:00
.gitignore .gitignore is back... 2010-01-07 22:00:38 +02:00
Makefile Added a somewhat non-automatic dist target 2010-01-07 22:50:07 +02:00
README.md Wording 2010-01-08 15:31:15 +02:00
X11Exception.h Original XKeyboard class 2010-01-02 23:01:20 +02:00
XKeyboard.cpp Support symbol strings with '_' in place of '+' 2015-07-20 01:05:59 +03:00
XKeyboard.h Added layout variant code to XKeyboard class 2010-01-02 23:01:53 +02:00
wrapper.cpp Added code to validate arg for the set command 2010-01-07 22:23:02 +02:00

README.md

README

Description

xkblayout-state is a small command-line program to get/set the current XKB keyboard layout.

It's a thin wrapper around a slightly version of Jay Bromley's XKeyboard class, the original of which is included in http://members.dslextreme.com/users/jbromley/files/ruby-xkb.tar.bz2.

Compilation and installation

  • To compile just say: make
  • To install copy the resulting executable xkblayout-state somewhere in your path

Usage

xkblayout-state can be used to either print keyboard layout information on stdout or set the currently active layout.

Printing keyboard layout information

The command to print keyboard layout information is

xkblayout-state print format

format is printed to stdout with the following substitutions (to include a literal % use %%):

  • %c -> The number of the currently active layout
  • %n -> The name of the currently active layout
  • %s -> The symbol of the currently active layout
  • %v -> The variant of the currently active layout (this is empty if no variant is specified)
  • %e -> The variant of the currently active layout (this is the same as %s if no variant is specified)
  • %C -> The number of defined layouts
  • %N -> A list containing the names of the layouts (one per line)
  • %S -> A list containing the symbols of the layouts (one per line)
  • %V -> A list containing the variants of the layouts (one per line; an empty line if no variant is specified for the respective layout)
  • %E -> A list containing the variants of the layouts (one per line; if no variant is specified for the respective symbol, the layout symbol is used)

Setting the active keyboard layout

The command to set the currently active keyboard layout is

xkblayout-state set [+-]number

number is the number of the layout to activate. It corresponds to the layouts in the order they appear in, for example, xkblayout-state print %N, starting from zero. If number begins with a plus or minus sign, the number'th layout counting from the currently active layout down or up the list is activated. It wraps around if the list is exceeded.

License

xkblayout-state is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 2 of the License, or (at your option) any later version.

xkblayout-state is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. http://www.gnu.org/licenses/