svcadm(1M)을 검색하려면 섹션에서 1M 을 선택하고, 맨 페이지 이름에 svcadm을 입력하고 검색을 누른다.
nlsadm(8)
System Administration Commands nlsadm(8)
NAME
nlsadm - configure national language properties
SYNOPSIS
nlsadm get-console-keymap |
get-system-locale [-e <locale-environment>] |
get-timezone
nlsadm list-console-keymap |
list-locale [-aH] [-o <property>[,...]]
[property=value[,...]] |
list-timezone
nlsadm set-console-keymap [-f] <keymap> |
set-system-locale [-f] [-e <locale-environment>] <locale> |
set-timezone [-f] <timezone>
nlsadm install-locale [-fnv] [-R <dir>] <locale> [...]
uninstall-locale [-fnv] [-R <dir>] <locale> [...]
nlsadm -? [subcommand]
DESCRIPTION
The nlsadm utility provides a way to get and set information on spe‐
cific national language properties. This utility provides a consoli‐
dated and convenient way to administer language support features.
The get subcommands gather information on national language properties
set in the corresponding SMF service for the given property. It also
displays the required information according to the selected input
options, in the standard output.
The list subcommands provide information about all supported locales
either installed or available for installation. The printed information
can be altered by using various options, for example, to include the
localized strings for locale names, to print only locales for a given
language, to suppress headers, and so on. The list subcommands also
provide lists of all supported national language properties such as
console-keymaps, timezones, and so on.
The set subcommands set the value of national language properties by
modifying the value of the corresponding SMF services for a given
national language property such as default system locale, console
keymap or timezone.
The install/uninstall locale subcommands install or uninstall necessary
packages and set corresponding facets for a given locale.
To set the values of national language properties and to install/unin‐
stall locales, an administrator needs to be granted with the National
Languages Support Management rights.
OPTIONS
The following option is supported:
-? [subcommand] Displays help information. This option stops further
--help argument processing and successfully exits after
displaying the appropriate output.
SUB-COMMANDS
The following options are supported for the get subcommands:
get-console-keymap
Shows the value of the currently set console keymap.
get-system-locale [-e <locale-environment>] | [--locale-environ‐
ment=<locale-environment>]
Prints the currently set default system locale. If <locale-environ‐
ment> is not specified, all locale environments are displayed.
-e <locale-environment> | --locale-environment=<locale-environment>
Displays the system locale of the specified environment. The
supported values for <locale-environment> are: LANG, LC_CTYPE,
LC_NUMERIC, LC_TIME, LC_COLLATE, LC_MONETARY, LC_MESSAGES and
LC_ALL.
get-timezone
Displays the name of the default system time zone.
The following options are supported for the list subcommands:
list-console-keymap
Shows a list of all supported console keymaps available in the sys‐
tem.
list-locale [-aH] [-o property[,...]]
[property=value[,...]]
[--all-locales] [--no-headers] [--output-
fields=property[,...]]
Displays a list of available locales. By default only the locales
available in the installed packages are shown in the list.
Unless -o option is specified, the default property fields are:
locale, lang, territory, codeset, modifier, and flags. By default
the output is shown in columns and headers with property field
names are printed.
-a, --all-locales
The output contains not only locales available in the installed
packages but it also contains all locales available for instal‐
lation from IPS package repositories. This could take several
minutes depending on the availability of the IPS repositories
configured.
-H, --no-headers
Does not show headers and displays the output in 'ofmt' format
(colon-separated format with backslashes in front of colons and
backslashes in the data). This format is useful for scripting
mode.
-o <property>[,...]
--output-fields=<property>[,...]
Prints only the specified output fields. Valid <property> val‐
ues are: codeset, facet, flags, lang, lang_wx[_YZ], locale,
modifier, pkg, territory, territory_wx[_YZ], and timezone.
lang_wx[_YZ] and territory_wx[_YZ], report the name of the lan‐
guage or territory written in the specified locale where wx is
an ISO 639 two-letter code (for example, en) and YZ is an ISO
3166 two-letter code (for example, US). When the localized
string is not found for the given language or territory, a
minus sign '-' is returned.
The flags column contains a set of flags that indicates the
status of the locale:
o A c in the flags column indicates that the locale is
the current locale.
o An i in the flags column indicates that the locale
is installed.
o An l in the flags column indicates that the locale
is a legacy locale.
o An s in the flags column indicates that the locale
is currently set as the default system locale.
The <property> arguments should be presented as a comma-sepa‐
rated list without spaces.
<property>=value[,...]
Filters the output and only displays information that matches
the input property value. For example, it is possible to spec‐
ify a concrete territory value, and the output in that case
will show only locales for the given territory. Valid <prop‐
erty> specifiers are: codeset, facet, flags, lang, locale, mod‐
ifier, pkg, territory, and timezone.
Valid lang value is an ISO 639 two-letter code (for example,
en) and valid territory value is an ISO 3166 two-letter code
(for example, US).
list-timezone
Shows a list of all supported time zones. The list includes also
time zones of the locales available for installation.
The following options are supported for the set subcommands:
set-console-keymap [-f] | [--force] <keymap>
Sets the given console keymap for the system.
-f Force setting a non-valid or unknown value.
--force
set-system-locale [-f] [-e <locale-environment>] <locale> |
[--force] [--locale-environment=<locale-environment>] <locale>
Sets the default system locale to given value. Unless -e option is
specified, only the LANG environment is set to the given locale.
-f
--force
Force setting a non-valid or unknown value.
-e <locale-environment>
--locale-environment=<locale-environment>
Sets the given locale only to the specified locale-environment.
The supported values for <locale-environment> are: LANG,
LC_CTYPE, LC_NUMERIC, LC_TIME, LC_COLLATE, LC_MONETARY, LC_MES‐
SAGES, and LC_ALL.
The following options are supported for the install/uninstall subcom‐
mands:
install-locale [-n] [-f] [-R <dir>] [-v] <locale> [...] |
[--dry-run] [--force] [--image-dir=<dir>]
[--verbose] <locale>
[...]
uninstall-locale [-n] [-f] [-R <dir>]
[-v] <locale> [...] |
[--dry-run] [--force] [--image-dir=<dir>]
[--verbose] < locale>
[...]
Installs or uninstalls necessary packages for the given locale. If
additional packages or locales need to be installed or uninstalled
because of locales or package dependencies, the command reports a
list of additional packages and/or locales to install or uninstall.
If --force option is used, the additional packages and locales are
also installed or uninstalled.
-n Perform a trial run of the operation with no
--dry-run package changes made.
-v Issue verbose progress messages during the
--verbose requested operation and display detailed
information such as commands used to
install/uninstall locales or to change
facets.
-R Operate on the image rooted at dir. If no
--image-dir=<dir> directory was specified or determined based
on environment, the default is /. For more
information, see the Environment Variables
section from pkg(1) man page.
EXIT STATUS
zero On successful completion
non-zero When an error is found
EXAMPLES
Example 1 Show the Default System Locale Currently set in the locale
environment LC_TIME
The following command shows the default system locale currently set in
the locale environment LC_TIME:
$ nlsadm get-system-locale -e LC_TIME
Example 2 Set System Timezone to Europe/Paris
The following command shows how to set the system time zone to
Europe/Paris:
$ nlsadm set-timezone Europe/Paris
Example 3 Show the Current Default Time Zone
The following command shows the name of the default system time zone:
$ nlsadm get-timezone
Example 4 Show a List of all Supported Locales Either Installed or
Available for Installation
The following command shows a list of all supported locales either
installed or available for installation:
$ nlsadm list-locale -a
LOCALE LANG(en) TERRITORY(en) CODESET MODIFIER FLAGS
cs_CZ.UTF-8@euro Czech Czech Republic UTF-8 euro il
en_US.UTF-8 English United State UTF-8 - ics
es_ES.UTF-8 Spanish Spain UTF-8 - -
Example 5 Show a List of all Installed Locales According to Specified
Fields and do not Show Headers
The following command shows a list of all installed locales according
to specified fields and do not show headers:
$ nlsadm list-locale -o locale,lang_en,timezone -H flags=i
Example 6 Set the Default System Locale to fr_FR.UTF-8
The following command shows how to set the default system locale to
fr_FR.UTF-8:
$ nlsadm set-system-locale fr_FR.UTF-8
Example 7 Set the LC_CTYPE locale-environment to en_US.UTF-8
The following command sets the LC_CTYPE locale-environment to
en_US.UTF-8:
$ nlsadm set-system-locale -e LC_CTYPE en_US.UTF-8
Example 8 Set Console Keyboard Keymap to UK-English
The following command sets the Console Keyboard keymap to UK-English:
$ nlsadm set-console-keymap UK-English
Example 9 Install fr_FR.UTF-8 Locale in the System
The following command shows how to install fr_FR.UTF-8 locale in the
system:
$ nlsadm install-locale fr_FR.UTF-8
Example 10 Show Information on a Given Locale
The following command shows information on a given locale by displaying
only specified property fields and omitting headers:
$ nlsadm list-locale -o locale,lang,territory -H locale=en_US.UTF-8
en_US.UTF-8:en:US
Example 11 Set Empty Value as Default System Locale
The following command shows how to set the default system locale with
an empty value:
$ nlsadm set-system-locale ""
ATTRIBUTES
See attributes(7) for descriptions of the following attributes:
tab() box; cw(2.75i) |cw(2.75i) lw(2.75i) |lw(2.75i) ATTRIBUTE TYPEAT‐
TRIBUTE VALUE _ Availabilitysystem/locale/nls-administration _ Inter‐
face StabilityUncommitted
SEE ALSO
pkg(1), setlocale(3C), libscf(3LIB), locale_alias(7), smf(7)
NOTES
The values for the console-keymap, system-locale, and timezone are man‐
aged through the Service Management Facility (SMF) under the following
service identifiers. For more information on the Service Management
Facility, see smf(7).
svc:/system/keymap:default (console-keymap)
svc:/system/environment:init (system-locale)
svc:/system/timezone:default (timezone)
Oracle Solaris 11.4 11 May 2021 nlsadm(8)