[V5,2/2] Update documentation to clarify a GCC extension
Checks
Commit Message
Ping…
Please let me know if you have any further comments on the patch.
thanks.
Qing
Begin forwarded message:
From: Qing Zhao <qing.zhao@oracle.com<mailto:qing.zhao@oracle.com>>
Subject: [V5][PATCH 2/2] Update documentation to clarify a GCC extension
Date: March 16, 2023 at 5:47:15 PM EDT
To: joseph@codesourcery.com<mailto:joseph@codesourcery.com>, jakub@redhat.com<mailto:jakub@redhat.com>, sandra@codesourcery.com<mailto:sandra@codesourcery.com>
Cc: rguenther@suse.de<mailto:rguenther@suse.de>, siddhesh@gotplt.org<mailto:siddhesh@gotplt.org>, keescook@chromium.org<mailto:keescook@chromium.org>, gcc-patches@gcc.gnu.org<mailto:gcc-patches@gcc.gnu.org>, Qing Zhao <qing.zhao@oracle.com<mailto:qing.zhao@oracle.com>>
on a structure with a C99 flexible array member being nested in
another structure. (PR77650)
"GCC extension accepts a structure containing an ISO C99 "flexible array
member", or a union containing such a structure (possibly recursively)
to be a member of a structure.
There are two situations:
* A structure or a union with a C99 flexible array member is the last
field of another structure, for example:
struct flex { int length; char data[]; };
union union_flex { int others; struct flex f; };
struct out_flex_struct { int m; struct flex flex_data; };
struct out_flex_union { int n; union union_flex flex_data; };
In the above, both 'out_flex_struct.flex_data.data[]' and
'out_flex_union.flex_data.f.data[]' are considered as flexible
arrays too.
* A structure or a union with a C99 flexible array member is the
middle field of another structure, for example:
struct flex { int length; char data[]; };
struct mid_flex { int m; struct flex flex_data; int n; };
In the above, 'mid_flex.flex_data.data[]' has undefined behavior.
Compilers do not handle such case consistently, Any code relying on
such case should be modified to ensure that flexible array members
only end up at the ends of structures.
Please use warning option '-Wgnu-variable-sized-type-not-at-end' to
identify all such cases in the source code and modify them. This
extension will be deprecated from gcc in the next release.
"
gcc/c-family/ChangeLog:
* c.opt: New option -Wgnu-variable-sized-type-not-at-end.
gcc/c/ChangeLog:
* c-decl.cc<http://c-decl.cc> (finish_struct): Issue warnings for new option.
gcc/ChangeLog:
* doc/extend.texi: Document GCC extension on a structure containing
a flexible array member to be a member of another structure.
gcc/testsuite/ChangeLog:
* gcc.dg/variable-sized-type-flex-array.c: New test.
---
gcc/c-family/c.opt | 5 +++
gcc/c/c-decl.cc<http://c-decl.cc> | 8 ++++
gcc/doc/extend.texi | 45 ++++++++++++++++++-
.../gcc.dg/variable-sized-type-flex-array.c | 31 +++++++++++++
4 files changed, 88 insertions(+), 1 deletion(-)
create mode 100644 gcc/testsuite/gcc.dg/variable-sized-type-flex-array.c
--
2.31.1
Comments
On Thu, 23 Mar 2023, Qing Zhao via Gcc-patches wrote:
> +Wgnu-variable-sized-type-not-at-end
> +C C++ Var(warn_variable_sized_type_not_at_end) Warning
> +Warn about structures or unions with C99 flexible array members are not
> +at the end of a structure.
I think there's at least one word missing here, e.g. "that" before "are".
> +Please use warning option @option{-Wgnu-variable-sized-type-not-at-end} to
> +identify all such cases in the source code and modify them. This extension
> +will be deprecated from gcc in the next release.
We don't generally say "in the next release" in the manual (or "deprecated
from gcc"). Maybe it *is* deprecated, maybe it will be *removed*, or will
*start to warn by default*, in some specified version number (giving a
version number seems better than "next release"), but "will be deprecated"
is odd.
> On Mar 23, 2023, at 4:14 PM, Joseph Myers <joseph@codesourcery.com> wrote:
>
> On Thu, 23 Mar 2023, Qing Zhao via Gcc-patches wrote:
>
>> +Wgnu-variable-sized-type-not-at-end
>> +C C++ Var(warn_variable_sized_type_not_at_end) Warning
>> +Warn about structures or unions with C99 flexible array members are not
>> +at the end of a structure.
>
> I think there's at least one word missing here, e.g. "that" before "are".
Will fix it.
>
>> +Please use warning option @option{-Wgnu-variable-sized-type-not-at-end} to
>> +identify all such cases in the source code and modify them. This extension
>> +will be deprecated from gcc in the next release.
>
> We don't generally say "in the next release" in the manual (or "deprecated
> from gcc"). Maybe it *is* deprecated, maybe it will be *removed*, or will
> *start to warn by default*, in some specified version number (giving a
> version number seems better than "next release"), but "will be deprecated"
> is odd.
How about the following:
+Please use warning option @option{-Wgnu-variable-sized-type-not-at-end} to
+identify all such cases in the source code and modify them. This warning will be
+ on by default starting from GCC14.
Thanks.
Qing
>
> --
> Joseph S. Myers
> joseph@codesourcery.com
On Mon, 2023-03-27 at 13:38 +0000, Qing Zhao via Gcc-patches wrote:
>
>
> > On Mar 23, 2023, at 4:14 PM, Joseph Myers <joseph@codesourcery.com> wrote:
> >
> > On Thu, 23 Mar 2023, Qing Zhao via Gcc-patches wrote:
> >
> > > +Wgnu-variable-sized-type-not-at-end
> > > +C C++ Var(warn_variable_sized_type_not_at_end) Warning
> > > +Warn about structures or unions with C99 flexible array members are not
> > > +at the end of a structure.
> >
> > I think there's at least one word missing here, e.g. "that" before "are".
>
> Will fix it.
> >
> > > +Please use warning option @option{-Wgnu-variable-sized-type-not-at-end} to
> > > +identify all such cases in the source code and modify them. This extension
> > > +will be deprecated from gcc in the next release.
> >
> > We don't generally say "in the next release" in the manual (or "deprecated
> > from gcc"). Maybe it *is* deprecated, maybe it will be *removed*, or will
> > *start to warn by default*, in some specified version number (giving a
> > version number seems better than "next release"), but "will be deprecated"
> > is odd.
> How about the following:
>
> +Please use warning option @option{-Wgnu-variable-sized-type-not-at-end} to
> +identify all such cases in the source code and modify them. This warning will be
> + on by default starting from GCC14.
I'm wondering why it *was" not on by default...
> On Mar 27, 2023, at 10:34 AM, Xi Ruoyao <xry111@xry111.site> wrote:
>
> On Mon, 2023-03-27 at 13:38 +0000, Qing Zhao via Gcc-patches wrote:
>>
>>
>>> On Mar 23, 2023, at 4:14 PM, Joseph Myers <joseph@codesourcery.com> wrote:
>>>
>>> On Thu, 23 Mar 2023, Qing Zhao via Gcc-patches wrote:
>>>
>>>> +Wgnu-variable-sized-type-not-at-end
>>>> +C C++ Var(warn_variable_sized_type_not_at_end) Warning
>>>> +Warn about structures or unions with C99 flexible array members are not
>>>> +at the end of a structure.
>>>
>>> I think there's at least one word missing here, e.g. "that" before "are".
>>
>> Will fix it.
>>>
>>>> +Please use warning option @option{-Wgnu-variable-sized-type-not-at-end} to
>>>> +identify all such cases in the source code and modify them. This extension
>>>> +will be deprecated from gcc in the next release.
>>>
>>> We don't generally say "in the next release" in the manual (or "deprecated
>>> from gcc"). Maybe it *is* deprecated, maybe it will be *removed*, or will
>>> *start to warn by default*, in some specified version number (giving a
>>> version number seems better than "next release"), but "will be deprecated"
>>> is odd.
>> How about the following:
>>
>> +Please use warning option @option{-Wgnu-variable-sized-type-not-at-end} to
>> +identify all such cases in the source code and modify them. This warning will be
>> + on by default starting from GCC14.
>
> I'm wondering why it *was" not on by default...
This is a new warning that will be added to gcc13, since it’s in a very late stage before gcc13 release,
So I am not feeling comfortable to turn it on by default now.
I think it might be safer to turn it on by default in the beginning of gcc14.
Qing
>
>
> --
> Xi Ruoyao <xry111@xry111.site>
> School of Aerospace Science and Technology, Xidian University
On Mon, Mar 27, 2023 at 01:38:34PM +0000, Qing Zhao wrote:
>
>
> > On Mar 23, 2023, at 4:14 PM, Joseph Myers <joseph@codesourcery.com> wrote:
> >
> > On Thu, 23 Mar 2023, Qing Zhao via Gcc-patches wrote:
> >
> >> +Wgnu-variable-sized-type-not-at-end
> >> +C C++ Var(warn_variable_sized_type_not_at_end) Warning
> >> +Warn about structures or unions with C99 flexible array members are not
> >> +at the end of a structure.
> >
> > I think there's at least one word missing here, e.g. "that" before "are".
>
> Will fix it.
> >
> >> +Please use warning option @option{-Wgnu-variable-sized-type-not-at-end} to
> >> +identify all such cases in the source code and modify them. This extension
> >> +will be deprecated from gcc in the next release.
> >
> > We don't generally say "in the next release" in the manual (or "deprecated
> > from gcc"). Maybe it *is* deprecated, maybe it will be *removed*, or will
> > *start to warn by default*, in some specified version number (giving a
> > version number seems better than "next release"), but "will be deprecated"
> > is odd.
> How about the following:
>
> +Please use warning option @option{-Wgnu-variable-sized-type-not-at-end} to
This is certainly misnamed. GNU variable sized type not at the end of a
struct is something like
void bar (void *);
void foo (int n) {
struct S { int a; int b[n]; int c; } s;
s.a = 1;
__builtin_memset (s.b, 0, sizeof (s.b));
s.c = 3;
bar (&s);
}
Certainly not flexible array members in the middle of structure.
> +identify all such cases in the source code and modify them. This warning will be
> + on by default starting from GCC14.
Jakub
> On Mar 27, 2023, at 11:43 AM, Jakub Jelinek <jakub@redhat.com> wrote:
>
> On Mon, Mar 27, 2023 at 01:38:34PM +0000, Qing Zhao wrote:
>>
>>
>>> On Mar 23, 2023, at 4:14 PM, Joseph Myers <joseph@codesourcery.com> wrote:
>>>
>>> On Thu, 23 Mar 2023, Qing Zhao via Gcc-patches wrote:
>>>
>>>> +Wgnu-variable-sized-type-not-at-end
>>>> +C C++ Var(warn_variable_sized_type_not_at_end) Warning
>>>> +Warn about structures or unions with C99 flexible array members are not
>>>> +at the end of a structure.
>>>
>>> I think there's at least one word missing here, e.g. "that" before "are".
>>
>> Will fix it.
>>>
>>>> +Please use warning option @option{-Wgnu-variable-sized-type-not-at-end} to
>>>> +identify all such cases in the source code and modify them. This extension
>>>> +will be deprecated from gcc in the next release.
>>>
>>> We don't generally say "in the next release" in the manual (or "deprecated
>>> from gcc"). Maybe it *is* deprecated, maybe it will be *removed*, or will
>>> *start to warn by default*, in some specified version number (giving a
>>> version number seems better than "next release"), but "will be deprecated"
>>> is odd.
>> How about the following:
>>
>> +Please use warning option @option{-Wgnu-variable-sized-type-not-at-end} to
> This is certainly misnamed.
The name “-Wgnu-variable-sized-type-not-at-end” was just used the warning name from CLANG. -:)
Shall we use the same name as CLANG? Or we invent a new name?
> GNU variable sized type not at the end of a
> struct is something like
> void bar (void *);
> void foo (int n) {
> struct S { int a; int b[n]; int c; } s;
> s.a = 1;
> __builtin_memset (s.b, 0, sizeof (s.b));
> s.c = 3;
> bar (&s);
> }
> Certainly not flexible array members in the middle of structure.
Right now, with -Wpedantic, we have the following warning for the above small case:
t2.c:3:24: warning: a member of a structure or union cannot have a variably modified type [-Wpedantic]
3 | struct S { int a; int b[n]; int c; } s;
| ^
Do we have a definition for “GNU variable sized type” now?
Shall we include "flexible array members” and" the structure/union with a flexible array members at the end" into “GNU variable sized type”?
thanks.
Qing
>
>> +identify all such cases in the source code and modify them. This warning will be
>> + on by default starting from GCC14.
>
> Jakub
On Mon, Mar 27, 2023 at 03:57:58PM +0000, Qing Zhao wrote:
> >> +Please use warning option @option{-Wgnu-variable-sized-type-not-at-end} to
> > This is certainly misnamed.
>
> The name “-Wgnu-variable-sized-type-not-at-end” was just used the warning name from CLANG. -:)
>
> Shall we use the same name as CLANG? Or we invent a new name?
The latter IMHO. Having a warning with completely nonsensical name will
just confuse users.
> > GNU variable sized type not at the end of a
> > struct is something like
> > void bar (void *);
> > void foo (int n) {
> > struct S { int a; int b[n]; int c; } s;
> > s.a = 1;
> > __builtin_memset (s.b, 0, sizeof (s.b));
> > s.c = 3;
> > bar (&s);
> > }
> > Certainly not flexible array members in the middle of structure.
>
> Right now, with -Wpedantic, we have the following warning for the above small case:
>
> t2.c:3:24: warning: a member of a structure or union cannot have a variably modified type [-Wpedantic]
> 3 | struct S { int a; int b[n]; int c; } s;
> | ^
Sure, it is a GNU C extension (not allowed in C++ BTW).
It is documented in https://gcc.gnu.org/onlinedocs/gcc/Variable-Length.html
though just very briefly:
As an extension, GCC accepts variable-length arrays as a member of a structure or a union. For example:
void
foo (int n)
{
struct S { int x[n]; };
}
> Do we have a definition for “GNU variable sized type” now?
Naturally, variable sized type should have non-constant sizeof, because
otherwise it is constant sized type. That is not
the case for flexible array members, there is nothing variable sized on
them, especially if they are in the middle of a structure.
Jakub
> On Mar 27, 2023, at 12:06 PM, Jakub Jelinek <jakub@redhat.com> wrote:
>
> On Mon, Mar 27, 2023 at 03:57:58PM +0000, Qing Zhao wrote:
>>>> +Please use warning option @option{-Wgnu-variable-sized-type-not-at-end} to
>>> This is certainly misnamed.
>>
>> The name “-Wgnu-variable-sized-type-not-at-end” was just used the warning name from CLANG. -:)
>>
>> Shall we use the same name as CLANG? Or we invent a new name?
>
> The latter IMHO. Having a warning with completely nonsensical name will
> just confuse users.
Okay. -:)
How about "-Wstruct-with-fam-not-at-end”? Or do you have any suggestion on the name?
>
>>> GNU variable sized type not at the end of a
>>> struct is something like
>>> void bar (void *);
>>> void foo (int n) {
>>> struct S { int a; int b[n]; int c; } s;
>>> s.a = 1;
>>> __builtin_memset (s.b, 0, sizeof (s.b));
>>> s.c = 3;
>>> bar (&s);
>>> }
>>> Certainly not flexible array members in the middle of structure.
>>
>> Right now, with -Wpedantic, we have the following warning for the above small case:
>>
>> t2.c:3:24: warning: a member of a structure or union cannot have a variably modified type [-Wpedantic]
>> 3 | struct S { int a; int b[n]; int c; } s;
>> | ^
>
> Sure, it is a GNU C extension (not allowed in C++ BTW).
> It is documented in https://gcc.gnu.org/onlinedocs/gcc/Variable-Length.html
> though just very briefly:
> As an extension, GCC accepts variable-length arrays as a member of a structure or a union. For example:
> void
> foo (int n)
> {
> struct S { int x[n]; };
> }
Okay, I see.
>
>> Do we have a definition for “GNU variable sized type” now?
>
> Naturally, variable sized type should have non-constant sizeof, because
> otherwise it is constant sized type.
Oh, for flexible array members, we cannot take sizeof it, So they are considered as incomplete type, right?
thanks.
Qing
> That is not
> the case for flexible array members, there is nothing variable sized on
> them, especially if they are in the middle of a structure.
>
> Jakub
>
On Mon, Mar 27, 2023 at 04:22:25PM +0000, Qing Zhao via Gcc-patches wrote:
> > The latter IMHO. Having a warning with completely nonsensical name will
> > just confuse users.
>
> Okay. -:)
> How about "-Wstruct-with-fam-not-at-end”? Or do you have any suggestion on the name?
Nobody will know what fam is.
-Wflex-array-member-not-at-end ?
Jakub
> On Mar 27, 2023, at 12:31 PM, Jakub Jelinek <jakub@redhat.com> wrote:
>
> On Mon, Mar 27, 2023 at 04:22:25PM +0000, Qing Zhao via Gcc-patches wrote:
>>> The latter IMHO. Having a warning with completely nonsensical name will
>>> just confuse users.
>>
>> Okay. -:)
>> How about "-Wstruct-with-fam-not-at-end”? Or do you have any suggestion on the name?
>
> Nobody will know what fam is.
Yes, I agree -:)
> -Wflex-array-member-not-at-end ?
However, Will this name include “a structure with flexible array member is not at end”?
Qing
>
> Jakub
>
> On Mar 27, 2023, at 12:48 PM, Qing Zhao via Gcc-patches <gcc-patches@gcc.gnu.org> wrote:
>
>
>
>> On Mar 27, 2023, at 12:31 PM, Jakub Jelinek <jakub@redhat.com> wrote:
>>
>> On Mon, Mar 27, 2023 at 04:22:25PM +0000, Qing Zhao via Gcc-patches wrote:
>>>> The latter IMHO. Having a warning with completely nonsensical name will
>>>> just confuse users.
>>>
>>> Okay. -:)
>>> How about "-Wstruct-with-fam-not-at-end”? Or do you have any suggestion on the name?
>>
>> Nobody will know what fam is.
>
> Yes, I agree -:)
>
>> -Wflex-array-member-not-at-end ?
>
> However, Will this name include “a structure with flexible array member is not at end”?
Looks like no better name than “-Wflex-array-member-not-at-end” as I can think of..
I will use this one.
Let me know if you have any further comments on the documentation part.
thanks.
Qing
> Qing
>
>>
>> Jakub
>>
>
@@ -737,6 +737,11 @@ Wformat-truncation=
C ObjC C++ LTO ObjC++ Joined RejectNegative UInteger Var(warn_format_trunc) Warning LangEnabledBy(C ObjC C++ LTO ObjC++,Wformat=, warn_format >= 1, 0) IntegerRange(0, 2)
Warn about calls to snprintf and similar functions that truncate output.
+Wgnu-variable-sized-type-not-at-end
+C C++ Var(warn_variable_sized_type_not_at_end) Warning
+Warn about structures or unions with C99 flexible array members are not
+at the end of a structure.
+
Wif-not-aligned
C ObjC C++ ObjC++ Var(warn_if_not_aligned) Init(1) Warning
Warn when the field in a struct is not aligned.
@@ -9269,6 +9269,14 @@ finish_struct (location_t loc, tree t, tree fieldlist, tree attributes,
TYPE_INCLUDE_FLEXARRAY (t)
= is_last_field && TYPE_INCLUDE_FLEXARRAY (TREE_TYPE (x));
+ if (warn_variable_sized_type_not_at_end
+ && !is_last_field
+ && RECORD_OR_UNION_TYPE_P (TREE_TYPE (x))
+ && TYPE_INCLUDE_FLEXARRAY (TREE_TYPE (x)))
+ warning_at (DECL_SOURCE_LOCATION (x),
+ OPT_Wgnu_variable_sized_type_not_at_end,
+ "variable sized type not at the end of a struct");
+
if (DECL_NAME (x)
|| RECORD_OR_UNION_TYPE_P (TREE_TYPE (x)))
saw_named_field = true;
@@ -1748,7 +1748,50 @@ Flexible array members may only appear as the last member of a
A structure containing a flexible array member, or a union containing
such a structure (possibly recursively), may not be a member of a
structure or an element of an array. (However, these uses are
-permitted by GCC as extensions.)
+permitted by GCC as extensions, see details below.)
+@end itemize
+
+GCC extension accepts a structure containing an ISO C99 @dfn{flexible array
+member}, or a union containing such a structure (possibly recursively)
+to be a member of a structure.
+
+There are two situations:
+
+@itemize @bullet
+@item
+A structure or a union with a C99 flexible array member is the last field
+of another structure, for example:
+
+@smallexample
+struct flex @{ int length; char data[]; @};
+union union_flex @{ int others; struct flex f; @};
+
+struct out_flex_struct @{ int m; struct flex flex_data; @};
+struct out_flex_union @{ int n; union union_flex flex_data; @};
+@end smallexample
+
+In the above, both @code{out_flex_struct.flex_data.data[]} and
+@code{out_flex_union.flex_data.f.data[]} are considered as flexible arrays too.
+
+
+@item
+A structure or a union with a C99 flexible array member is the middle field
+of another structure, for example:
+
+@smallexample
+struct flex @{ int length; char data[]; @};
+
+struct mid_flex @{ int m; struct flex flex_data; int n; @};
+@end smallexample
+
+In the above, @code{mid_flex.flex_data.data[]} has undefined behavior.
+Compilers do not handle such case consistently, Any code relying on
+such case should be modified to ensure that flexible array members
+only end up at the ends of structures.
+
+Please use warning option @option{-Wgnu-variable-sized-type-not-at-end} to
+identify all such cases in the source code and modify them. This extension
+will be deprecated from gcc in the next release.
@end itemize
Non-empty initialization of zero-length
new file mode 100644
@@ -0,0 +1,31 @@
+/* Test for -Wgnu-variable-sized-type-not-at-end on structure/union with
+ C99 flexible array members being embedded into another structure. */
+/* { dg-do compile } */
+/* { dg-options "-Wgnu-variable-sized-type-not-at-end" } */
+
+struct flex { int n; int data[]; };
+struct out_flex_end { int m; struct flex flex_data; }; /* { dg-bogus "variable sized type not at the end of a struct" } */
+struct out_flex_mid { struct flex flex_data; int m; }; /* { dg-warning "variable sized type not at the end of a struct" } */
+/* since the warning has been issued for out_flex_mid, no need to
+ issue warning again when it is included in another structure/union. */
+struct outer_flex_mid { struct out_flex_mid out_flex_data; int p; }; /* { dg-bogus "variable sized type not at the end of a struct" } */
+union flex_union_mid { int a; struct outer_flex_mid b; }; /* { dg-bogus "variable sized type not at the end of a struct" } */
+
+
+struct flex0 { int n; int data[0]; };
+struct out_flex_end0 { int m; struct flex0 flex_data; }; /* { dg-bogus "variable sized type not at the end of a struct" } */
+struct out_flex_mid0 { struct flex0 flex_data; int m; }; /* { dg-bogus "variable sized type not at the end of a struct" } */
+struct outer_flex_mid0 { struct out_flex_mid0 out_flex_data; int p; }; /* { dg-bogus "variable sized type not at the end of a struct" } */
+union flex_union_mid0 { int a; struct outer_flex_mid0 b; }; /* { dg-bogus "variable sized type not at the end of a struct" } */
+
+struct flex1 { int n; int data[1]; };
+struct out_flex_end1 { int m; struct flex1 flex_data; }; /* { dg-bogus "variable sized type not at the end of a struct" } */
+struct out_flex_mid1 { struct flex1 flex_data; int m; }; /* { dg-bogus "variable sized type not at the end of a struct" } */
+struct outer_flex_mid1 { struct out_flex_mid1 out_flex_data; int p; }; /* { dg-bogus "variable sized type not at the end of a struct" } */
+union flex_union_mid1 { int a; struct outer_flex_mid1 b; }; /* { dg-bogus "variable sized type not at the end of a struct" } */
+
+struct flexn { int n; int data[8]; };
+struct out_flex_endn { int m; struct flexn flex_data; }; /* { dg-bogus "variable sized type not at the end of a struct" } */
+struct out_flex_midn { struct flexn flex_data; int m; }; /* { dg-bogus"variable sized type not at the end of a struct" } */
+struct outer_flex_midn { struct out_flex_midn out_flex_data; int p; }; /* { dg-bogus"variable sized type not at the end of a struct" } */
+union flex_union_midn { int a; struct outer_flex_midn b; }; /* { dg-bogus "variable sized type not at the end of a struct" } */