BOOTSTRAP (kutils) functions


LIBRARY ROUTINE

kgetenv - get an environment variable from the environ list.

LIBRARY CALL

char *kgetenv(
   const char *name)

INPUT

OUTPUT

none

RETURN VALUE

the environment string upon success, NULL on failure

DESCRIPTION

This module is used to get an environment variable from the environ list. For example, if the user has their TMPDIR environment variable set to /usr/var/tmp, and this routine is called with (name = "TMPDIR"), then "/usr/var/tmp" will be returned.

ADDITIONAL INFORMATION

none

EXAMPLES

none

SIDE EFFECTS

none

RESTRICTIONS

The string returned is simply an address into the environ list, so it should NOT be freed, or changed in any way by the calling routine.

MODIFICATION

none

FILES

$BOOTSTRAP/objects/library/kutils/src/env.c

SEE ALSO

kutils(3)

COPYRIGHT

Copyright (C) 1993 - 1997, Khoral Research, Inc. ("KRI") All rights reserved.