fuse.4: ffix

[thirdparty/man-pages.git] / man3 / envz_add.3

diff --git a/man3/envz_add.3 b/man3/envz_add.3
index de388af6b616bb9537247f25349ae3c29ff3e47b..94ded873739b339f7aefc66799ff3c722ae9081c 100644 (file)
--- a/man3/envz_add.3
+++ b/man3/envz_add.3
@@ -7,35 +7,35 @@
 .\" based on the description in glibc source and infopages
 .\"
 .\" Corrections and additions, aeb
-.TH ENVZ_ADD 3 2007-05-18 "" "Linux Programmer's Manual"
+.TH ENVZ_ADD 3 2017-09-15 "" "Linux Programmer's Manual"
 .SH NAME
 envz_add, envz_entry, envz_get, envz_merge,
 envz_remove, envz_strip \- environment string support
 .SH SYNOPSIS
 .nf
 .B "#include <envz.h>"
-
+.PP
 .BI "error_t envz_add(char **" envz ", size_t *" envz_len ,
 .BI "                 const char *" name ", const char *" value );
-
+.PP
 .BI "char *envz_entry(const char *" envz ", size_t " envz_len \
 ", const char *" name );
-
+.PP
 .BI "char *envz_get(const char *" envz ", size_t " envz_len \
 ", const char *" name );
-
+.PP
 .BI "error_t envz_merge(char **" envz ", size_t *" envz_len ,
 .BI "                   const char *" envz2 ", size_t " envz2_len \
 ", int " override );
-
+.PP
 .BI "void envz_remove(char **" envz ", size_t *" envz_len \
 ", const char *" name );
-
+.PP
 .BI "void envz_strip(char **" envz ", size_t *" envz_len );
 .fi
 .SH DESCRIPTION
 These functions are glibc-specific.
-.LP
+.PP
 An argz vector is a pointer to a character buffer together with a length,
 see
 .BR argz_add (3).
@@ -45,9 +45,9 @@ Everything after the first \(aq=\(aq is considered
 to be the value.
 If there is no \(aq=\(aq, the value is taken to be NULL.
 (While the value in case of a trailing \(aq=\(aq is the empty string "".)
-.LP
+.PP
 These functions are for handling envz vectors.
-.LP
+.PP
 .BR envz_add ()
 adds the string
 .RI \&" name = value \&"
@@ -66,14 +66,14 @@ and
 If an entry with the same
 .I name
 existed, it is removed.
-.LP
+.PP
 .BR envz_entry ()
 looks for
 .I name
 in the envz vector
 .RI ( envz ,\  envz_len )
 and returns the entry if found, or NULL if not.
-.LP
+.PP
 .BR envz_get ()
 looks for
 .I name
@@ -84,7 +84,7 @@ and returns the value if found, or NULL if not.
 an entry for
 .I name
 without \(aq=\(aq sign.)
-.LP
+.PP
 .BR envz_merge ()
 adds each entry in
 .I envz2
@@ -99,14 +99,14 @@ is true, then values in
 will supersede those with the same name in
 .IR *envz ,
 otherwise not.
-.LP
+.PP
 .BR envz_remove ()
 removes the entry for
 .I name
 from
 .RI ( *envz ,\  *envz_len )
 if there was one.
-.LP
+.PP
 .BR envz_strip ()
 removes all entries with value NULL.
 .SH RETURN VALUE
@@ -115,11 +115,31 @@ All envz functions that do memory allocation have a return type of
 and return 0 for success, and
 .B ENOMEM
 if an allocation error occurs.
+.SH ATTRIBUTES
+For an explanation of the terms used in this section, see
+.BR attributes (7).
+.TS
+allbox;
+lbw27 lb lb
+l l l.
+Interface      Attribute       Value
+T{
+.BR envz_add (),
+.BR envz_entry (),
+.br
+.BR envz_get (),
+.BR envz_merge (),
+.br
+.BR envz_remove (),
+.BR envz_strip ()
+T}     Thread safety   MT-Safe
+.TE
+.sp 1
 .SH CONFORMING TO
 These functions are a GNU extension.
 Handle with care.
 .SH EXAMPLE
-.nf
+.EX
 #include <stdio.h>
 #include <stdlib.h>
 #include <envz.h>
@@ -139,6 +159,6 @@ main(int argc, char *argv[], char *envp[])
     printf("%s\en", str);
     exit(EXIT_SUCCESS);
 }
-.fi
+.EE
 .SH SEE ALSO
 .BR argz_add (3)