unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (HP-UX-11.11)
Page:
Section:
Apropos / Subsearch:
optional field



 geocustoms(1M)						      geocustoms(1M)




 NAME
      geocustoms - configure system language on multi-language systems

 SYNOPSIS
      geocustoms[-l locale]

 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 11.11, 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.





 Hewlett-Packard Company	    - 1 -   HP-UX Release 11i: November 2000






 geocustoms(1M)						      geocustoms(1M)




 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 11.00 or greater

      HP-UX 11.00 or greater

    Compatibility
      This product is designed for compatibility with releases including and
      after HP-UX 11.00 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.





 Hewlett-Packard Company	    - 2 -   HP-UX Release 11i: November 2000






 geocustoms(1M)						      geocustoms(1M)




	   +  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.

 SEE ALSO:
      locale(1), swinstall(1M), swlist(1M), swremove(1M), setlocale(3C).

 STANDARDS CONFORMANCE
      POSIX.2, UNIX95 (SPEC1170 and XPG4).




























 Hewlett-Packard Company	    - 3 -   HP-UX Release 11i: November 2000