| .TH GETENV 3 | |
| .SH NAME | |
| getenv, putenv \- access environment variables | |
| .SH SYNOPSIS | |
| .B #include <u.h> | |
| .br | |
| .B #include <libc.h> | |
| .PP | |
| .nf | |
| .B | |
| char* getenv(char *name) | |
| .br | |
| .B | |
| int putenv(char *name, char *val) | |
| .fi | |
| .SH DESCRIPTION | |
| .I Getenv | |
| reads the contents of | |
| .BI /env/ name | |
| (see | |
| .IR env (3)) | |
| into memory allocated with | |
| .IR malloc (3), | |
| 0-terminates it, | |
| and returns a pointer to that area. | |
| If no file exists, 0 | |
| is returned. | |
| .PP | |
| .I Putenv | |
| creates the file | |
| .BI /env/ name | |
| and writes the string | |
| .I val | |
| to it. The terminating | |
| .B 0 | |
| is not written. | |
| If the file value cannot be written, \-1 is returned. | |
| .SH SOURCE | |
| .B /usr/local/plan9/src/libc/9sys | |
| .SH SEE ALSO | |
| .IR env (3) | |
| .SH DIAGNOSTICS | |
| Sets | |
| .IR errstr . |