diff options
Diffstat (limited to 'doc')
-rw-r--r-- | doc/admin/CMakeLists.txt | 6 | ||||
-rw-r--r-- | doc/admin/locale/index.rst | 39 | ||||
-rw-r--r-- | doc/admin/locale/usage.rst | 71 |
3 files changed, 116 insertions, 0 deletions
diff --git a/doc/admin/CMakeLists.txt b/doc/admin/CMakeLists.txt index 96e7616..d33427f 100644 --- a/doc/admin/CMakeLists.txt +++ b/doc/admin/CMakeLists.txt @@ -62,6 +62,12 @@ if (WITH-SOFTWARE) set(PROVIDER_MOFS ${PROVIDER_MOFS} "60_LMI_Software.mof") endif (WITH-SOFTWARE) +if (WITH-LOCALE) + set(PROVIDERS ${PROVIDERS} "locale") + set(PROVIDER_CAPTIONS ${PROVIDER_CAPTIONS} "Locale") + set(PROVIDER_MOFS ${PROVIDER_MOFS} "60_LMI_Locale.mof") +endif (WITH-LOCALE) + list(LENGTH PROVIDERS LEN) math(EXPR LEN '${LEN}-1') diff --git a/doc/admin/locale/index.rst b/doc/admin/locale/index.rst new file mode 100644 index 0000000..179c659 --- /dev/null +++ b/doc/admin/locale/index.rst @@ -0,0 +1,39 @@ +OpenLMI Locale Provider documentation +===================================== +OpenLMI Locale is CIM provider for managing Linux locale settings (using the +`systemd/localed D-Bus interface <http://www.freedesktop.org/wiki/Software/systemd/localed/>`_). + +It allows to set system locale represented by environment variables (LANG, +LC_CTYPE, LC_NUMERIC, LC_TIME, LC_COLLATE, LC_MONETARY, LC_MESSAGES, LC_PAPER, +LC_NAME, LC_ADDRESS, LC_TELEPHONE, LC_MEASUREMENT and LC_IDENTIFICATION), +set the default key mapping of the X11 servers (keyboard layouts, model, variant +and options) and the default key mapping for virtual console. + +If you set a new system locale with SetLocale() method, all old system locale +settings will be dropped, and the new settings will be saved to disk. It will +also be passed to the system manager, and subsequently started daemons will +inherit the new system locale from it. + +Note that already running daemons will not learn about the new system locale. + +Also note that setting key mapping with SetVConsoleKeyboard() method instantly +applies the new keymapping to the console, while setting the key mapping of X11 +server using SetX11Keyboard() method simply sets a default that may be used by +later sessions. + +Contents: + +.. toctree:: + :maxdepth: 2 + + usage + +.. ifconfig:: includeClasses + + OpenLMI Locale CIM Classes: + + .. toctree:: + :maxdepth: 1 + + mof/tree + mof/index diff --git a/doc/admin/locale/usage.rst b/doc/admin/locale/usage.rst new file mode 100644 index 0000000..2afad86 --- /dev/null +++ b/doc/admin/locale/usage.rst @@ -0,0 +1,71 @@ +OpenLMI Locale usage +==================== + +Some common use cases are described in the following parts. + +Getting locale settings +----------------------- +Create connection, get instance (assuming the default namespace 'root/cimv2' is used):: + + c = connect("https://myhost") + # optionally create namespace alias + ns = c.root.cimv2 + locale = ns.LMI_Locale.first_instance() + +Print what you're interested in:: + + # get LANG setting + print locale.Lang + # get X11Layouts + print locale.X11Layouts + # get VConsoleKeymap + print locale.VConsoleKeymap + +Or print everything:: + + # get all available settings + locale.doc() + +Setting system locale +--------------------- +Set LANG and/or set individual locale variables. Lang, LCCType, LCAddress, LCNumeric, +LCTelephone, LCCollate, LCPaper, LCMonetary, LCTime, LCMessages, LCIdentification, +LCName and LCMeasurement properties correspond to likewise named Linux locale +environmental variables:: + + # set LANG (LANG value is used also for all other locale categories by default) + locale.SetLocale(Lang="en_US.UTF-8") + # set LANG and set different value for LC_TELEPHONE + # note that SetLocale() clears previous setting - if you want to preserve + # LANG value, you have to set it again + locale.SetLocale(Lang="en_US.UTF-8",LCTelephone="cs_CZ.UTF-8") + +Setting default key mapping of the X11 servers +---------------------------------------------- +Set default key mapping for X11 server:: + + locale.SetX11Keyboard(Layouts="de") + +Optionally set keyboard model and variant:: + + locale.SetX11Keyboard(Layouts="us",Model="dellsk8125",Variant="qwertz") + +Set more than one layout and set option for switching between them:: + + locale.SetX11Keyboard(Layouts="us,cz,de",Options="grp:alt_shift_toggle") + +You can set Convert parameter to 'True', mapping for virtual console will be set +also then (nearest console keyboard setting for the chosen X11 setting):: + + locale.SetX11Keyboard(Layouts="us",Convert="True") + +Setting default key mapping of the virtual console +-------------------------------------------------- +Set default key mapping for virtual console:: + + locale.SetVConsoleKeyboard(Keymap="us") + +Again, setting Convert to 'True' will set the nearest X11 keyboard setting for +the chosen console setting:: + + locale.SetVConsoleKeyboard(Keymap="us",Convert="True") |