setenviron(3)

NAME

       setenviron - set environment value

SYNOPSIS

              #include <ast.h>

              char*     setenviron(const char* key);

DESCRIPTION

       setenviron    controls    environment   name=value   pairs.    setenvi-
       ron("name=value") adds name to the environment and returns a pointer to
       a  strdup(3)  copy of name=value.  setenviron("name") removes name from
       the environment and returns the empty string.  setenviron(0) reserves a
       few  slots  in  an  internal  array  and  is usually called by a parent
       process that expects many children.  0 is returned on error.   setenvi-
       ron preserves the ksh(1) convention of _ as the first environment vari-
       able name.

SEE ALSO

       env(1), exec(2)

BUGS

       POSIX will eventually settle on an interface.  It has already picked  a
       few  of  the  names  we did in .2 drafts.  This is about the third name
       change for ours.

                                                                     LIBAST(3)