Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ environ(5) — sys5 — Apollo Domain/OS SR10.3.5

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

ctime(3C)

cftime(4)

passwd(4)

profile(4)

timezone(4)

exec(2)

env(1)

f77(1)

ld(1)

login(1)

sh(1)

nice(1)

nohup(1)

time(1)

tplot(1G)

chrtbl(1M)

ENVIRON(5)                           SysV                           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:

     APOLLO_STATUS   When set to "true," extends system error reporting.  Use
                     perror(3C) to print the more verbose, Domain/OS-specific
                     error messages.

     CFTIME          The default format string to be used by the date(1)
                     command and the ascftime and cftime routines (see
                     ctime(3C)).  If CFTIME is not set or is null, the default
                     format string specified in the /usr/lib/cftime/language
                     file is used in its place (if it exists), where language
                     is the value to which the environment variable LANGUAGE
                     is set.  See cftime(4).

     CHRCLASS        A value corresponding to the name of a file in
                     /usr/lib/chrclass containing language-specific character
                     classification and conversion data.  Programs can
                     initialize the tables used by the ctype(3C) macros to the
                     data contained in the file corresponding to the CHRCLASS
                     value by calling setchrclass with its argument set to
                     (char *)0.  If CHRCLASS is non-existent, null, set to a
                     value for which no file exists in /usr/lib/chrclass, or
                     an error occurs while reading the file, the ascii
                     character set is used.  Programs that check the value of
                     CHRCLASS include cat(1), ed(1), egrep(1), grep(1),
                     sed(1), and sort(1).

                     Programs can initialize character classification and
                     conversion data to a specific language by calling
                     setchrclass with the appropriate argument.  See
                     ctype(3C).  See chrtbl(1M) for information on creating
                     language-specific character classification and conversion
                     tables.

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

     ISP             Instruction set processor type.  The value of this
                     variable determines the resolution of variant links in
                     /usr/lib having names of the general form

                     linkname -> isp_$(ISP)/filename

                     The linknames are those of the various bindable libraries
                     and C initialization routines used by ld and f77:
                     crt0.o, libF77.a, libld.a, and so on.  When ISP=m68k,
                     these variant links resolve to files of the corresponding
                     names in /usr/lib/isp_m68k, a directory containing
                     bindable libraries and C initialization routines for
                     M680X0-based workstations.  When ISP=a88k, these variant
                     links resolve to files of the corresponding names in
                     /usr/lib/isp_a88k, a directory containing bindable
                     libraries and C initialization routines for the Series
                     10000.

                     ld and f77 set ISP according to the option you specify to
                     the -cpu switch, allowing you to link and compile either
                     for M680X0-based workstations (-cpu m68k) or for the
                     Series 10000 (-cpu a88k).

     LANGUAGE        A language for which a format file by that name exists in
                     /usr/lib/cftime.  This information is used by commands
                     such as date(1), ls(1), sort(1), etc. to print date and
                     time information in the language specified.

                     If LANGUAGE is not set, null, or set to a value for which
                     no file exists in /usr/lib/cftime, or an error occurs
                     while reading the file, the last language requested will
                     be used.  If no language has been requested, usa_english
                     is the default.  See cftime(4).

     NODEID          Hexadecimal ID of current network node (4DD0, for
                     example).

     NODETYPE        Model of the Apollo workstation on which the process is
                     running (DN4500, for example).

     ORGANIZATION    Organization associated with log-in name.

     PATH            The sequence of directory prefixes that sh(1), time(1),
                     nice(1), nohup(1), etc., apply in searching for a file
                     known by an incomplete pathname.  The prefixes are
                     separated by colons (:).  login(1) sets
                     PATH=:/bin:/usr/bin:/usr/apollo/bin.

     PROJECT         Project associated with log-in name.

     SYSTYPE         Environment as set by "systype".

     TERM            The kind of terminal for which output is to be prepared.
                     This information is used by commands such as tplot(1G),
                     which may exploit special capabilities of that terminal.

     TZ              Time zone information.  The simplest format is xxxnzzz
                     where xxx is standard local time zone abbreviation, n is
                     the difference in hours from GMT (Greenwich Mean Time),
                     and zzz is the abbreviation for an alternate time zone
                     (usually the daylight-saving local time zone), if any;
                     for example,

                          TZ="EST5EDT"

                     The most complex format allows you to specify the
                     difference in hours of the alternate time zone from GMT
                     and the starting day and time and ending day and time for
                     using this alternate time zone.  For example, in 1985 the
                     complex format corresponding to the above example is:

                          TZ="EST5:00:00EDT4:00:00;118/2:00:00,300/2:00:00"

                     When the complex format is used, it must be surrounded by
                     double quotation marks.  See ctime(3C) and timezone(4).

     Further names may be placed in the environment by the export command and
     "name=value" arguments in sh(1), or by exec(2).  It is unwise to conflict
     with certain shell variables that are frequently exported by .profile
     files:  MAIL, PS1, PS2, IFS (see profile(4)).

SEE ALSO
     ctime(3C), cftime(4), passwd(4), profile(4), timezone(4), exec(2).
     env(1), f77(1), ld(1), login(1), sh(1), nice(1), nohup(1), time(1),
     tplot(1G) in the SysV Command Reference.
     chrtbl(1M) in Managing SysV System Software.

NOTES
     Setting the time to be within the interval between the end of the main
     time zone and the beginning of the alternate time zone, or vice versa, is
     not recommended.  (For example, on the morning Daylight Savings Time is
     scheduled to begin, don't set the time to be within the hour "lost").

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026