shithub: riscv

ref: 0123946b8df36a0215861b66f4fdba42e3c2dc49
dir: /sys/man/2/getenv/

View raw version
.TH GETENV 2
.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 (2),
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 /sys/src/libc/9sys
.SH SEE ALSO
.IR env (3)
.SH DIAGNOSTICS
Sets
.IR errstr .