1 cfa37a7b 2004-04-10 devnull .TH GETENV 3
 2 cfa37a7b 2004-04-10 devnull .SH NAME
 3 cfa37a7b 2004-04-10 devnull getenv, putenv \- access environment variables
 4 cfa37a7b 2004-04-10 devnull .SH SYNOPSIS
 5 cfa37a7b 2004-04-10 devnull .B #include <u.h>
 6 cfa37a7b 2004-04-10 devnull .br
 7 cfa37a7b 2004-04-10 devnull .B #include <libc.h>
 8 cfa37a7b 2004-04-10 devnull .PP
 9 cfa37a7b 2004-04-10 devnull .nf
10 cfa37a7b 2004-04-10 devnull .B
11 cfa37a7b 2004-04-10 devnull char* getenv(char *name)
12 cfa37a7b 2004-04-10 devnull .br
13 cfa37a7b 2004-04-10 devnull .B
14 cfa37a7b 2004-04-10 devnull int   putenv(char *name, char *val)
15 cfa37a7b 2004-04-10 devnull .fi
16 cfa37a7b 2004-04-10 devnull .SH DESCRIPTION
17 cfa37a7b 2004-04-10 devnull .I Getenv
18 cfa37a7b 2004-04-10 devnull reads the contents of
19 cfa37a7b 2004-04-10 devnull .BI /env/ name
20 cfa37a7b 2004-04-10 devnull (see
21 cfa37a7b 2004-04-10 devnull .IR env (3))
22 cfa37a7b 2004-04-10 devnull into memory allocated with
23 bf8a59fa 2004-04-11 devnull .IR malloc (3),
24 cfa37a7b 2004-04-10 devnull 0-terminates it,
25 cfa37a7b 2004-04-10 devnull and returns a pointer to that area.
26 cfa37a7b 2004-04-10 devnull If no file exists, 0
27 cfa37a7b 2004-04-10 devnull is returned.
28 cfa37a7b 2004-04-10 devnull .PP
29 cfa37a7b 2004-04-10 devnull .I Putenv
30 cfa37a7b 2004-04-10 devnull creates the file
31 cfa37a7b 2004-04-10 devnull .BI /env/ name
32 cfa37a7b 2004-04-10 devnull and writes the string
33 cfa37a7b 2004-04-10 devnull .I val
34 cfa37a7b 2004-04-10 devnull to it.  The terminating
35 cfa37a7b 2004-04-10 devnull .B 0
36 cfa37a7b 2004-04-10 devnull is not written.
37 cfa37a7b 2004-04-10 devnull If the file value cannot be written, \-1 is returned.
38 cfa37a7b 2004-04-10 devnull .SH SOURCE
39 cfa37a7b 2004-04-10 devnull .B /sys/src/libc/9sys
40 cfa37a7b 2004-04-10 devnull .SH SEE ALSO
41 cfa37a7b 2004-04-10 devnull .IR env (3)
42 cfa37a7b 2004-04-10 devnull .SH DIAGNOSTICS
43 cfa37a7b 2004-04-10 devnull Sets
44 cfa37a7b 2004-04-10 devnull .IR errstr .