DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH
 

/usr/man2/cat.3/setenviron.3.Z(/usr/man2/cat.3/setenviron.3.Z)





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)

Man(1) output converted with man2html