From: Bastien Roucariès <ro...@debian.org> Document the name=value system and that nul byte is forbidden
Signed-off-by: Bastien Roucariès <ro...@debian.org> --- man7/environ.7 | 12 +++++++++--- 1 file changed, 9 insertions(+), 3 deletions(-) diff --git a/man7/environ.7 b/man7/environ.7 index f9e49a572..f2786fa09 100644 --- a/man7/environ.7 +++ b/man7/environ.7 @@ -90,6 +90,15 @@ current language, etc., and a user can define additional variables for other pur The set of all environment variables that have values is collectively known as the process environment or simply the environment. .PP +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 This array of strings is made available to the process by the .BR exec (3) call that started the process. @@ -99,9 +108,6 @@ it inherits a .I copy of its parent's environment. .PP -By convention the strings in -.I environ -have the form "\fIname\fP\fB=\fP\fIvalue\fP". Common examples are: .TP .B USER -- 2.29.2