plan9port

fork of plan9port with libvec, libstr and libsdb
Log | Files | Refs | README | LICENSE

getenv.3 (738B)

      1 .TH GETENV 3
      2 .SH NAME
      3 getenv, putenv \- access environment variables
      4 .SH SYNOPSIS
      5 .B #include <u.h>
      6 .br
      7 .B #include <libc.h>
      8 .PP
      9 .nf
     10 .B
     11 char* getenv(char *name)
     12 .br
     13 .B
     14 int   putenv(char *name, char *val)
     15 .fi
     16 .SH DESCRIPTION
     17 .I Getenv
     18 fetches the environment value associated with
     19 .I name
     20 into memory allocated with
     21 .MR malloc (3) ,
     22 0-terminates it,
     23 and returns a pointer to that area.
     24 If no file exists, 0
     25 is returned.
     26 .PP
     27 .I Putenv
     28 sets the environment value associated with
     29 .I name
     30 to
     31 .IR val .
     32 .SH SOURCE
     33 .B \*9/src/lib9/getenv.c
     34 .SH DIAGNOSTICS
     35 Sets
     36 .IR errstr .
     37 .SH BUGS
     38 To avoid name conflicts with the underlying system,
     39 .I getenv
     40 and
     41 .I putenv
     42 are preprocessor macros defined as
     43 .I p9getenv
     44 and
     45 .IR p9putenv ;
     46 see
     47 .MR intro (3) .