gnu::aligned(3attr) — Linux manual page

NAME \| SYNOPSIS \| DESCRIPTION \| VERSIONS \| STANDARDS \| HISTORY \| CAVEATS \| COLOPHON

gnu::aligned(3attr)                                   gnu::aligned(3attr)

NAME top

       gnu::aligned - set alignment of an object

SYNOPSIS top

       [[gnu::aligned(alignment)]]
       [[gnu::aligned]]

DESCRIPTION top

       This attribute can be applied to a type or a variable, and sets
       its alignment in bytes.

       If the alignment is not specified, the maximum alignment is used.
       This is equivalent to

           [[gnu::aligned(alignof(max_align_t))]]

VERSIONS top

       __attribute__((aligned(alignment)))

       __declspec(align(alignment))

       C11 provides the _Alignas() type specifier, which has similar
       semantics.

STANDARDS top

       GNU.

HISTORY top

       gcc, g++, clang 11, clang++ 2.8.0.

CAVEATS top

       This attribute can increase the natural alignment of a type, but
       it can't decrease it.

       The linker may limit the maximum alignment that can be applied.

COLOPHON top

       This page is part of the man-pages (Linux kernel and C library
       user-space interface documentation) project.  Information about
       the project can be found at 
       ⟨https://www.kernel.org/doc/man-pages/⟩.  If you have a bug report
       for this manual page, see
       ⟨https://git.kernel.org/pub/scm/docs/man-pages/man-pages.git/tree/CONTRIBUTING⟩.
       This page was obtained from the tarball man-pages-6.15.tar.gz
       fetched from
       ⟨https://mirrors.edge.kernel.org/pub/linux/docs/man-pages/⟩ on
       2025-08-11.  If you discover any rendering problems in this HTML
       version of the page, or you believe there is a better or more up-
       to-date source for the page, or you have corrections or
       improvements to the information in this COLOPHON (which is not
       part of the original manual page), send a mail to
       man-pages@man7.org

Linux man-pages 6.15            2025-06-28            gnu::aligned(3attr)