Skip to contentSkip to conversation

alloca.3: correct information on getting non-inlined version with gcc+glibc

PATCH In review Adrian Bunk 2 participants 2 messages May 12, 2013 – May 19, 2013 1 message not in the archive Man-pages: manual pages for Linux -- Sections 2, 3, 4, 5, and 7

lore
Share & tools
lore
#0 lore raw

PATCH 1/1 alloca.3: correct information on getting non-inlined version with gcc+glibc

- remove the incorrect information that -fno-builtin would help
- add -std=c11 to the list of strict options
- emphasize more that both the gcc option and not including alloca.h are needed
- add the #ifdef from the glibc alloca.h to make the situation clearer

---
 man3/alloca.3 |   16 +++++++++-------
 1 file changed, 9 insertions(+), 7 deletions(-)
man3/alloca.3 +9 -7
index 73b88f5..0d593ed 100644
@@ -40,7 +40,7 @@
 .\"     Various rewrites and additions (notes on longjmp() and SIGSEGV).
 .\"     Weaken warning against use of alloca() (as per Debian bug 461100).
 .\"
-.TH ALLOCA 3 2008-01-24 "GNU" "Linux Programmer's Manual"
+.TH ALLOCA 3 2013-05-12 "GNU" "Linux Programmer's Manual"
 .SH NAME
 alloca \- allocate memory that is automatically freed
 .SH SYNOPSIS
@@ -110,20 +110,22 @@ This is not done when either the
 .IR "\-std=c89" ,
 .IR "\-std=c99" ,
 or the
-.IR "\-fno\-builtin"
+.IR "\-std=c11"
 option is given
-(and the header
+.BR and
+the header
 .I <alloca.h>
-is not included).
-But beware!
-By default the glibc version of
+is not included.
+Otherwise (without an \-ansi or \-std=c* option) the glibc version of
 .I <stdlib.h>
 includes
 .I <alloca.h>
-and that contains the line:
+and that contains the lines:
 .nf
 
+    #ifdef  __GNUC__
     #define alloca(size)   __builtin_alloca (size)
+    #endif
 
 .fi
 with messy consequences if one has a private version of this function.
Signature · 6 lines
1.7.10.4

--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to [email protected]
More majordomo info at  http://vger.kernel.org/majordomo-info.html

A message that is not in the archive (sent off-list or not yet received): 1368357967-8813-1-git-send-email-bunk-DgEjT+Ai2ygdnm+yROfE0A@public.gmane.org

#2 lore raw
Quoted 7 lines · Adrian Bunk

- remove the incorrect information that -fno-builtin would help
- add -std=c11 to the list of strict options
- emphasize more that both the gcc option and not including alloca.h are needed
- add the #ifdef from the glibc alloca.h to make the situation clearer

Thanks, Adrian. Applied.

Cheers,

Michael

Quoted 37 lines
---
 man3/alloca.3 |   16 +++++++++-------
 1 file changed, 9 insertions(+), 7 deletions(-)
man3/alloca.3 +6 -6
index 73b88f5..0d593ed 100644
@@ -40,7 +40,7 @@
 .\"     Various rewrites and additions (notes on longjmp() and SIGSEGV).
 .\"     Weaken warning against use of alloca() (as per Debian bug 461100).
 .\"
-.TH ALLOCA 3 2008-01-24 "GNU" "Linux Programmer's Manual"
+.TH ALLOCA 3 2013-05-12 "GNU" "Linux Programmer's Manual"
 .SH NAME
 alloca \- allocate memory that is automatically freed
 .SH SYNOPSIS
@@ -110,20 +110,22 @@ This is not done when either the
 .IR "\-std=c89" ,
 .IR "\-std=c99" ,
 or the
-.IR "\-fno\-builtin"
+.IR "\-std=c11"
 option is given
-(and the header
+.BR and
+the header
 .I <alloca.h>
-is not included).
-But beware!
-By default the glibc version of
+is not included.
+Otherwise (without an \-ansi or \-std=c* option) the glibc version of
 .I <stdlib.h>
 includes
 .I <alloca.h>

man3/alloca.3 This is not done when either the · line 131

Quoted 10 lines
man3/alloca.3 +3 -1
-and that contains the line:
+and that contains the lines:
 .nf
 
+    #ifdef  __GNUC__
     #define alloca(size)   __builtin_alloca (size)
+    #endif
 
 .fi
 with messy consequences if one has a private version of this function.

--
To unsubscribe from this list: send the line "unsubscribe linux-man" in the body of a message to [email protected] More majordomo info at http://vger.kernel.org/majordomo-info.html