NAME
	  putenv - Sets	an environment variable

     LIBRARY
	  Standard C Library (libc.a)

     SYNOPSIS
	  #include <stdlib.h>

	  int putenv (
	       char *string );

     PARAMETERS
	  string
	       Points to a name=value string.

     DESCRIPTION
	  The putenv() function	sets the value of an environment vari-
	  able by altering an existing variable	or by creating a new
	  one.	The string parameter points to a string	of the form
	  name=value, where name is the	environment variable and value
	  is the new value for it.

     NOTES
	  The putenv() function	manipulates the	environ	external vari-
	  able,	and it can be used in conjunction with the getenv()
	  function. However, the third parameter to the	main function
	  (the environment pointer), is	not changed.

	  The putenv() function	uses the malloc() function to enlarge
	  the environment.

	  AES Support Level: Trial use

     RETURN VALUES
	  Upon successful completion, a	value of 0 (zero) is returned.
	  If the malloc() function is unable to	obtain sufficient
	  space	to expand the environment, then	the putenv() function
	  returns a nonzero value.

     RELATED INFORMATION
	  Functions: clearenv(3), exec(2), getenv(3), malloc(3)










Acknowledgement and Disclaimer