environ.5 (2010 09)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages

environ(5) environ(5)

NAME

environ - user environment

DESCRIPTION

An array of strings called the environment is made available by exec(2) when a process begins. By con-

vention, these strings have the form name=value. The following names are used by various commands

(listed in alphabetical order):

HOME Name of the user’s login directory, set by login (1) from the password ﬁle (see passwd (4)).

LANG Identiﬁes the user’s requirements for native language, local customs and coded character set,

if the environment variables LC_ALL, LC_COLLATE,

LC_CTYPE, LC_MESSAGES,

LC_MONETARY, LC_NUMERIC, and LC_TIME are unset or null.

The format of

LANG is:

LANG=language[_territory ][.codeset

]

The valid values for LANG are supported locales. (See lang(5).) Native Language Support

(NLS) is initiated at run-time by calling setlocale (3C). The following call to

setlocale()

binds the execution of a program to the user’s language requirements:

setlocale(LC_ALL,"");

This setlocale() call initializes the program locale from the environment variables asso-

ciated with setlocale(). LANG provides the necessary defaults if any of the category-

speciﬁc environment variables are not set or set to the empty string.

The

LANG environment variable can have a maximum length of SL_NAME_SIZE bytes (see

header ﬁle <locale.h>).

LANGOPTS Deﬁnes language options for mode and data order in the form:

LANGOPTS=[mode][_order]

LANGOPTS values are given in English as an ASCII character string. mode describes the

mode of a ﬁle where l (ell) represents Latin mode and n represents non-Latin mode. Non-

Latin mode is assumed for values other than l and n. order describes the data order of a

ﬁle where k is keyboard order and s is screen order.

LC_ALL Determines the values for all locale categories. The value of LC_ALL has precedence over

any of the other environment variables LC_COLLATE, LC_CTYPE, LC_MESSAGES,

LC_MONETARY, LC_NUMERIC, LC_TIME, and LANG.

LC_COLLATE, LC_CTYPE, LC_MESSAGES, LC_MONETARY, LC_NUMERIC, and LC_TIME

Determines the user’s requirements for language, territory, and codeset with respect to char-

acter collation, character classiﬁcation and conversion, output messages, currency symbol

and monetary value format, numeric data presentation, and time formats, respectively. If

LC_ALL and any of these are not deﬁned in the environment, LANG provides the defaults.

Syntax for the environment variables

LC_COLLATE, LC_CTYPE, LC_MESSAGES,

LC_MONETARY, LC_NUMERIC, and LC_TIME is:

language

[_territory][.codeset][@modiﬁer]

The language ﬁeld conforms with ISO 639 standard for language names and the territory

ﬁeld conforms with the ISO 3166 territory names. For a list of the locale names, see lang (5).

The

@modiﬁer ﬁeld allows the user to select between more than one value of a category

within the same language deﬁnition. HP-UX does not currently provide locales with

modiﬁers.

The values of the locale categories are determined by a precedence order; the ﬁrst condition

met below determines the value:

1. If the

LC_ALL environment variable is deﬁned and is not null, the value of LC_ALL is

used.

2. If the

LC_* environment variable (LC_COLLATE, LC_CTYPE, LC_MESSAGES,

LC_MONETARY, LC_NUMERIC, LC_TIME) is deﬁned and is not null, the value of the

environment variable is used to initialize the category that corresponds to the environ-

ment variable.

HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1

Summary of content (6 pages)

PAGE 1
environ(5) environ(5) NAME environ - user environment DESCRIPTION An array of strings called the environment is made available by exec (2) when a process begins. By convention, these strings have the form name=value. The following names are used by various commands (listed in alphabetical order): HOME Name of the user’s login directory, set by login (1) from the password file (see passwd (4)).
PAGE 2
environ(5) environ(5) 3. If the LANG environment variable is defined and is not null, the value of the LANG environment variable is used. 4. If the LANG environment variable is not set or is set to the empty string, the POSIX/C default locale is used. (See lang (5).) LC_COLLATE Determines the locale category for character collation.
PAGE 3
environ(5) environ(5) catopen (3C) attempts to open the file /system/nlslib/$LC_MESSAGES/name .cat as a message catalog. A null string is substituted if the specified value is not defined. Separators are not included in %t and %c substitutions. Note that a default value is not supplied for %L. If LC_MESSAGES is not set and NLSPATH had the value in the previous example, catopen (3C) would attempt to open the file /system/nlslib/name .cat as a message catalog.
PAGE 4
environ(5) environ(5) hh[:mm[:ss]] Hour (hh) is any value from 0 through 23. The optional minutes (mm) and seconds (ss) fields are a value from 0 through 59. The hour field is required. If offset is preceded by a -, the time zone is east of the Prime Meridian. A + preceding offset indicates that the time zone is west of the Prime Meridian. The default case is west of the Prime Meridian. rule rule indicates when to change to and from summer (daylight-savings) time.
PAGE 5
environ(5) environ(5) AUTHOR environ was developed by AT&T and HP. SEE ALSO env(1), login(1), sh(1), exec(2), catopen(3C), ctime(3C), getenv(3C), setlocale(3C), nlspath(4), profile(4), tztab(4), lang(5), term(5). STANDARDS CONFORMANCE environ: AES, SVID3, XPG2, XPG3, XPG4, FIPS 151-2, POSIX.
PAGE 6
(Notes) A (Notes) eA 6 Hewlett-Packard Company −1− HP-UX 11i Version 3: September 2010