NAME
geocustoms — configure system language on multi-language systems
DESCRIPTION
The
geocustoms
utility manages default selection and retention/removal
of multiple languages installed on ignited systems.
The geocustoms program is executed at first boot on
ignited (Instant Ignition) systems with multiple languages available.
On subsequent sessions, the command
/usr/sbin/geocustoms
starts
geocustoms.
Options:
- -l locale
Sets the
LANG
variable (and all other appropriate
dependencies, if applicable) to the value of
locale.
If the
locale
argument is not a valid option for that system, the User Interface (UI)
will appear as if the option had not been used.
An additional locale value can be used in this context;
SET_NULL_LOCALE
can be the argument to the
-l
option, the result of which will be
setting locale variables to
NULL
by default.
A null locale will allow programs to execute without using
localized message catalogs. This can increase system
performance. All HP-UX messages appear in English if the
locale is set to
NULL.
EXTERNAL INFLUENCES
Environment Variables
geocustoms
writes default values to system configuration
files regarding the following environmental variables:
LANG,
LC_ALL,
LC_CTYPE,
LC_COLLATE,
LC_MONETARY,
LC_NUMERIC,
LC_TIME,
LC_MESSAGES.
International Code Set Support
Native Language Support (NLS):
If the standard message catalogs exist, then they are in
/usr/lib/nls.
The
geocustoms
command will use the standard message catalogs, if
they are on the system. If the standard message catalogs are not on the
system, then the messages appear in English. (This is in accordance
with standard NLS behavior).
All European languages for CDE will be supported.
For HP-UX 10.30, this includes English, French, German, Italian, Spanish and
Swedish. All prompts and logging messages will be localized.
Locale (Language Variant) names are always localized in accordance with
standard NLS behavior.
NLS is extended to allow multiple "fonts" on the initial screen at the
same time through use of bitmapped images.
RETURN VALUES
- 0
Successful completion and/or clean exit from program.
- 1
Program was unable to complete all objectives.
DIAGNOSTICS
Errors:
geocustoms
writes to
stderr,
and to
/var/adm/sw/lang.log.
Standard Output
geocustoms
does not write to
stdout.
Standard Error
geocustoms
only writes to
stderr
in case of command line error or
request for syntax. Any UI error messages appear via an error window.
Logging
Both interactive and non-interactive sessions log summary events at:
/var/adm/sw/lang.log.
EXAMPLES
To set the default system language non-interactively to German:
/usr/sbin/geocustoms -l de_DE.iso88591
DEPENDENCIES
- ObAM 4.2
- SD-UX 10.30
- HP-UX 10.30
Compatability
This product is designed for compatibility with HP-UX 10.30 with a
Common Desktop Environment (CDE). No attempt has been made to support
the Visual User Environment (VUE).
Notes
If geocustoms
is invoked by the user, it
may be necessary to log out
and log in again for language
changes to take effect.
If language bundles have been marked
for removal, that will occupy the
swagentd()
for some minutes at the next system boot.
Limitations
geocustoms
does
not
do the following:
Manage languages at the codeset level.
Provide a user interface for Asian languages.
Manage keyboard selection.
Create or remove locale definitions.
Provide a special interface for restoring or adding languages
to the system from separate media.
AUTHOR
geocustoms
was developed by HP.
FILES:
geocustoms
creates a text file
/var/adm/sw/lang.log.
geocustoms
creates, if necessary, and modifies
/etc/dt/config/Xconfig
and
/etc/rc.config.d/LANG.
geocustoms
will read NLS files, as discussed in Native Language Support above.
STANDARDS CONFORMANCE
POSIX.2, UNIX95
(SPEC1170 and XPG4).
