env.3
author "Tomas Zeman <tomas.zeman@sun.com>"
Fri, 19 Oct 2007 14:06:22 +0200
changeset 0 068428edee47
permissions -rw-r--r--
Imported qmail-1.03

.TH env 3
.SH NAME
env \- manage the environment
.SH SYNTAX
.B #include <env.h>

char **\fBenviron\fP;

char *\fBenv_get\fP(\fIname\fR);
.br
char *\fBenv_pick\fP();

char *\fIname\fR;
.SH DESCRIPTION
The environment,
.BR environ ,
is a 0-terminated array of 0-terminated strings,
called environment variables.
Each environment variable is of the form
.IR name\fB=\fIvalue .

.B env_get
returns the value of the first variable whose name is
.IR name ,
or 0 if there is no such variable.

.B env_pick
returns any variable in the environment,
or 0 if the environment is empty.
.SH "SEE ALSO"
environ(7)