aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorBastien Roucariès <rouca@debian.org>2021-01-28 12:00:51 +0100
committerMichael Kerrisk <mtk.manpages@gmail.com>2021-01-28 12:11:06 +0100
commit2768c481079fa520c240b2a734218356325fe548 (patch)
tree83d05693d8918517d63b6fd2ab766e00868ea55a
parent7939275a0adc0d18a393e9503a3f47d27b38e74c (diff)
downloadman-pages-2768c481079fa520c240b2a734218356325fe548.tar.gz
environ.7: Document convention of string in environ
Document the name=value system and that nul byte is forbidden. Signed-off-by: Bastien Roucariès <rouca@debian.org> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
-rw-r--r--man7/environ.78
1 files changed, 7 insertions, 1 deletions
diff --git a/man7/environ.7 b/man7/environ.7
index 47761a9507..f683b60283 100644
--- a/man7/environ.7
+++ b/man7/environ.7
@@ -52,9 +52,15 @@ it inherits a
.I copy
of its parent's environment.
.PP
-By convention the strings in
+By convention, the strings in
.I environ
have the form "\fIname\fP\fB=\fP\fIvalue\fP".
+Names of environment variables are case-sensitive and must not contain
+the character "\fB=\fP". The values of environment variables can be anything
+that can be represented as a string. A value and a name must not contain an
+embedded null byte (\(aq\e0\(aq),
+since this is assumed to terminate the string.
+.PP
Common examples are:
.TP
.B USER