LMI_Locale¶
Subclass of CIM_SystemSetting
Class representing Linux Locale. The system locale controls the language settings of system services and of the UI before the user logs in, such as the display manager, as well as the default for users after login.
Key properties¶
Local properties¶
string
LCIdentification
Defines the settings that relate to the metadata for the locale.
The property should be in format [language[_territory][.codeset][@modifier]], for example, ‘en_AU.UTF-8’ (Australian English using the UTF-8 encoding).
string
X11Model
Model of default keyboard mapping for X11. The property should be a keyboard model name (such as ‘pc105’ or ‘thinkpad60’).
string
VConsoleKeymap
System keyboard mapping used on the text console. The property should be a keyboard mapping name (such as ‘de’ or ‘us’).
string
LCMeasurement
Defines the settings relating to the measurement system in the locale (i.e., metric versus US customary units).
The property should be in format [language[_territory][.codeset][@modifier]], for example, ‘en_AU.UTF-8’ (Australian English using the UTF-8 encoding).
string
X11Layouts
System default keyboard mapping for X11 - the graphical UI before the user logs in, such as the display manager, as well as the default for users after login. The property should be a keyboard mapping name (such as ‘de’ or ‘us’). Individual layouts are comma separated (e. g. ‘us,cz,de’).
boolean
CanNTP
Indicates whether there’s avalilable NTP service on the system. If true, the NTP service is available. If false, the NTP service is not available.
string
LCAddress
Defines the rules for the formats (e.g., postal addresses) used to describe locations and geography-related items.
The property should be in format [language[_territory][.codeset][@modifier]], for example, ‘en_AU.UTF-8’ (Australian English using the UTF-8 encoding).
string
LCNumeric
Defines the information used by the input/output functions, when they are advised to use the locale settings.
The property should be in format [language[_territory][.codeset][@modifier]], for example, ‘en_AU.UTF-8’ (Australian English using the UTF-8 encoding).
string
LCTelephone
Defines the settings that describe the formats to be used with telephone services.
The property should be in format [language[_territory][.codeset][@modifier]], for example, ‘en_AU.UTF-8’ (Australian English using the UTF-8 encoding).
string
LCPaper
Defines the settings relating to the dimensions of the standard paper size (e.g., US letter versus A4).
The property should be in format [language[_territory][.codeset][@modifier]], for example, ‘en_AU.UTF-8’ (Australian English using the UTF-8 encoding).
string
VConsoleKeymapToggle
Toggle keyboard mapping used on the text console. The property should be a keyboard mapping name (such as ‘de’ or ‘us’).
string
Lang
Main locale property. When defined, its value is used as default for all other non-defined LC* categories.
The property should be in format [language[_territory][.codeset][@modifier]], for example, ‘en_AU.UTF-8’ (Australian English using the UTF-8 encoding).
string
LCCType
Defines behavior of the character handling and classification functions.
The property should be in format [language[_territory][.codeset][@modifier]], for example, ‘en_AU.UTF-8’ (Australian English using the UTF-8 encoding).
string
Language
Sets a priority list of languages. GNU gettext gives preference to it over LC_ALL and LANG for the purpose of message handling.
The property should be in format [language][:[language]]..., for example, ‘ru:en’ (Russian preffered, but if it is not available, use English.)
boolean
LocalRTC
Indicates whether the system RTC is in local or UTC timezone. If true, the system RTC is in local timezone. If false, the system RTC is in UTC timezone.
string
X11Options
Options for default keyboard mapping for X11. The property should be a keyboard option name (such as ‘altwin:menu’ or ‘grp:lalt_toggle’). Individual options are comma separated (e. g. ‘grp:alt_shift_toggle,shift:both_capslock’).
string
LCCollate
Defines the behavior of the functions, which are used to compare and/or sort strings in the local alphabet.
The property should be in format [language[_territory][.codeset][@modifier]], for example, ‘en_AU.UTF-8’ (Australian English using the UTF-8 encoding).
string
X11Variant
Variant of default keyboard mapping for X11. The property should be a keyboard variant name (such as ‘dvorak’ or ‘qwerty’).
boolean
NTP
Indicates whether the NTP service is enabled/started or disabled/stopped. If true, the NTP service is enabled/started. If false, the NTP service is disabled/stopped.
string
LCName
Defines the settings that describe the formats used to address persons.
The property should be in format [language[_territory][.codeset][@modifier]], for example, ‘en_AU.UTF-8’ (Australian English using the UTF-8 encoding).
string
LCMonetary
Defines the way numbers are usually printed, with details such as decimal point versus decimal comma.
The property should be in format [language[_territory][.codeset][@modifier]], for example, ‘en_AU.UTF-8’ (Australian English using the UTF-8 encoding).
string
Timezone
The system timezone. The property should be a zone name in the uniform naming convention form used by tz database (e. g. ‘Europe/Prague’).
string
LCTime
Defines how to display the current time in a locally acceptable form; for example, most of Europe uses a 24-hour clock versus the 12-hour clock used in the United States.
The property should be in format [language[_territory][.codeset][@modifier]], for example, ‘en_AU.UTF-8’ (Australian English using the UTF-8 encoding).
string
LCMessages
Defines the language messages are displayed in and what an affirmative or negative answer looks like.
The property should be in format [language[_territory][.codeset][@modifier]], for example, ‘en_AU.UTF-8’ (Australian English using the UTF-8 encoding).
Local methods¶
uint32
SetLocale (string
Lang, string
Language, string
LCCType, string
LCNumeric, string
LCTime, string
LCCollate, string
LCMonetary, string
LCMessages, string
LCPaper, string
LCName, string
LCAddress, string
LCTelephone, string
LCMeasurement, string
LCIdentification)
Method used to set the system locale. If you set a new system locale, 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.
Parameters
- IN
string
LangSets the Lang property.
The value should be in format [language[_territory][.codeset][@modifier]], for example, ‘en_AU.UTF-8’ (Australian English using the UTF-8 encoding).
- IN
string
LanguageSets the LANGUAGE property.
The value should be in format [language][:[language]]..., for example, ‘ru:en’ (Russian preffered, but if it is not available, use English).
- IN
string
LCCTypeSets the LCCType property.
The value should be in format [language[_territory][.codeset][@modifier]], for example, ‘en_AU.UTF-8’ (Australian English using the UTF-8 encoding).
- IN
string
LCNumericSets the LCNumeric property.
The value should be in format [language[_territory][.codeset][@modifier]], for example, ‘en_AU.UTF-8’ (Australian English using the UTF-8 encoding).
- IN
string
LCTimeSets the LCTime property.
The value should be in format [language[_territory][.codeset][@modifier]], for example, ‘en_AU.UTF-8’ (Australian English using the UTF-8 encoding).
- IN
string
LCCollateSets the LCCollate property.
The value should be in format [language[_territory][.codeset][@modifier]], for example, ‘en_AU.UTF-8’ (Australian English using the UTF-8 encoding).
- IN
string
LCMonetarySets the LCMonetar property.
The value should be in format [language[_territory][.codeset][@modifier]], for example, ‘en_AU.UTF-8’ (Australian English using the UTF-8 encoding).
- IN
string
LCMessagesSets the LCMessages property.
The value should be in format [language[_territory][.codeset][@modifier]], for example, ‘en_AU.UTF-8’ (Australian English using the UTF-8 encoding).
- IN
string
LCPaperSets the LCPaper property.
The value should be in format [language[_territory][.codeset][@modifier]], for example, ‘en_AU.UTF-8’ (Australian English using the UTF-8 encoding).
- IN
string
LCNameSets the LCName property.
The value should be in format [language[_territory][.codeset][@modifier]], for example, ‘en_AU.UTF-8’ (Australian English using the UTF-8 encoding).
- IN
string
LCAddressSets the LCAddress property.
The value should be in format [language[_territory][.codeset][@modifier]], for example, ‘en_AU.UTF-8’ (Australian English using the UTF-8 encoding).
- IN
string
LCTelephoneSets the LCTelephone property.
The value should be in format [language[_territory][.codeset][@modifier]], for example, ‘en_AU.UTF-8’ (Australian English using the UTF-8 encoding).
- IN
string
LCMeasurementSets the LCMeasurement property.
The value should be in format [language[_territory][.codeset][@modifier]], for example, ‘en_AU.UTF-8’ (Australian English using the UTF-8 encoding).
- IN
string
LCIdentificationSets the LCIdentification property.
The value should be in format [language[_territory][.codeset][@modifier]], for example, ‘en_AU.UTF-8’ (Australian English using the UTF-8 encoding).
uint32
SetX11Keyboard (string
Layouts, string
Model, string
Variant, string
Options, boolean
Convert)
Method used to set the default key mapping of the X11 server.
Parameters
- IN
string
Layouts- Sets X11 keyboard mapping (such as ‘de’ or ‘us’). Individual layouts are comma separated (e. g. ‘us,cz,de’). Required parameter.
- IN
string
Model- Sets X11 keyboard model (such as ‘pc105’ or ‘thinkpad60’). Optional parameter.
- IN
string
Variant- Sets X11 keyboard variant (such as ‘dvorak’ or ‘qwerty’). Optional parameter.
- IN
string
Options- Sets X11 keyboard options (such as ‘altwin:menu’ or ‘grp:lalt_toggle’). Individual options are comma separated (e. g. ‘grp:alt_shift_toggle,shift:both_capslock’). Optional parameter.
- IN
boolean
Convert- Convert may be set to optionally convert the X11 keyboard mapping to console keyboard configuration. Optional parameter. If set to TRUE, the nearest console keyboard setting for the chosen X11 setting is set.
uint32
SetNTP (boolean
UseNTP)
Method used to set whether the system clock is synchronized with the network using systemd-timesyncd. This will enable/start resp. disable/stop the systemd-timesyncd service.
Parameters
- IN
boolean
UseNTP- If set to TRUE, systemd-timesyncd service will be will enabled/started. If it is FALSE, systemd-timesyncd service will be disableed/stopped.
uint32
SetTime (sint64
UsecUTC, boolean
Relative)
Method used to set the system clock.
Parameters
- IN
sint64
UsecUTC- New system clock (microseconds since 1 Jan 1970 UTC).
- IN
boolean
Relative- If set to TRUE, the passed UsecUTC value will be added to the current system time. If it is FALSE, the current system time will be set to the passed UsecUTC value.
uint32
SetVConsoleKeyboard (string
Keymap, string
KeymapToggle, boolean
Convert)
Method used to set the key mapping on the virtual console.
Parameters
- IN
string
Keymap- Sets the keyboard mapping on the virtual console (such as ‘us’ or ‘cz-qwerty’), new mapping is applied instantly. Required parameter.
- IN
string
KeymapToggle- Sets toggle keyboard mapping on the virtual console (such as ‘us’ or ‘cz-qwerty’). Optional parameter.
- IN
boolean
Convert- Convert may be set to optionally convert the console keyboard configuration to X11 keyboard mappings. Optional parameter. If set to TRUE, the nearest X11 keyboard setting for the chosen console setting is set.
uint32
SetTimezone (string
Timezone)
Method used to set the system timezone.
Parameters
- IN
string
Timezone- New timezone (such as ‘Europe/Prague’).
uint32
SetLocalRTC (boolean
LocalRTC, boolean
FixSystem)
Method used to set whether the RTC is in local time or UTC.
Parameters
- IN
boolean
LocalRTC- If set to TRUE, the RTC value is assumed to be stored in local time. If it is FALSE, the RTC value is assumed to be stored in UTC.
- IN
boolean
FixSystem- If set to TRUE, the time from the RTC is read again and the system is clock adjusted according to the new setting. If it is FALSE, the system time is written to the RTC taking the new setting into account.
Inherited properties¶
string
InstanceIDstring
SystemNamestring
Descriptionstring
ElementNamestring
Captionstring
SettingIDstring
CreationClassNameuint64
Generationstring
SystemCreationClassName