compiler/clib/setenv.c

   1 /*
   2     Copyright © 1995-2003, The AROS Development Team. All rights reserved.
   3     $Id$
   4
   5     ANSI C function setenv().
   6 */
   7
   8 #include <proto/dos.h>
   9 #include <dos/var.h>
  10 #include "__env.h"
  11
  12 /*****************************************************************************
  13
  14     NAME */
  15 #include <stdlib.h>
  16
  17         int setenv (
  18
  19 /*  SYNOPSIS */
  20         const char *name,
  21         const char *value,
  22         int         overwrite)
  23 /*  FUNCTION
  24         Change or add an environment variable.
  25
  26     INPUTS
  27         name      - Name of the environment variable,
  28         value     - Value wich the variable must be set or changed to.
  29         overwrite - If non-zero then, if a variable with the name name already
  30                     exists, its value is changet to value, otherwise is not
  31                     changed
  32
  33     RESULT
  34         Returns zero on success, or -1 if there was insufficient
  35         space in the environment.
  36
  37     NOTES
  38         This function must not be used in a shared library.
  39
  40     EXAMPLE
  41
  42     BUGS
  43
  44     SEE ALSO
  45
  46     INTERNALS
  47
  48 ******************************************************************************/
  49 {
  50     if (!overwrite && FindVar(name, LV_VAR))
  51         return 0;
  52
  53     return -!SetVar(name, value, -1, LV_VAR | GVF_LOCAL_ONLY);
  54 } /* setenv */
  55