blob: a817b6ef79870839cf49ae3463cd958ff54ea1d3 [file] [log] [blame]
.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
fetches the environment value associated with
.I name
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
sets the environment value associated with
.I name
to
.IR val .
.SH SOURCE
.B \*9/src/lib9/getenv.c
.SH DIAGNOSTICS
Sets
.IR errstr .
.SH BUGS
To avoid name conflicts with the underlying system,
.I getenv
and
.I putenv
are preprocessor macros defined as
.I p9getenv
and
.IR p9putenv ;
see
.IR intro (3).