svcadm(8)을 검색하려면 섹션에서 8 을 선택하고, 맨 페이지 이름에 svcadm을 입력하고 검색을 누른다.
nlsadm(8)
nlsadm(8) System Administration Commands nlsadm(8)
NAME
nlsadm - configure national language properties
SYNOPSIS
nlsadm get-console-keymap
nlsadm get-system-locale [-e locale-environment]
nlsadm get-timezone
nlsadm list-console-keymap
nlsadm list-locale [-aH] [-o property[,...]] [property=value[,...]]
nlsadm list-timezone
nlsadm set-console-keymap [-f] keymap
nlsadm set-system-locale [-f] [-e locale-environment] locale
nlsadm set-timezone [-f] timezone
nlsadm install-locale [-fnv] [-R dir] locale [...]
nlsadm 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 op‐
tions, 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 na‐
tional 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]
--help
Displays help information. This option stops further argument pro‐
cessing 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-environment=lo‐
cale-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: lo‐
cale, 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 values
are: codeset, facet, flags, lang, lang_wx[_YZ], locale, modi‐
fier, 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 mi‐
nus 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-separated
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 property
specifiers are: codeset, facet, flags, lang, locale, modifier,
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
Force setting a non-valid or unknown value.
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
--dry-run
Perform a trial run of the operation with no package changes
made.
-v
--verbose
Issue verbose progress messages during the requested operation
and display detailed information such as commands used to in‐
stall/uninstall locales or to change facets.
-R
--image-dir=dir
Operate on the image rooted at dir. If no directory was speci‐
fied or determined based on environment, the default is /. For
more information, see the Environment Variables section from
the 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 Eu‐
rope/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 in‐
stalled 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)
International Language Environments Guide for Oracle Solaris 11.4
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 Fa‐
cility, see smf(7).
svc:/system/keymap:default (console-keymap)
svc:/system/environment:init (system-locale)
svc:/system/timezone:default (timezone)
Oracle Solaris 11.4 25 Nov 2024 nlsadm(8)