__ATTRIBUTE__(3clc)

💖 __ATTRIBUTE__ — the OpenCL manual page, bestie edition 💖

okay so you found the __ATTRIBUTE__(3clc) page from the OpenCL Manual and I'm gonna walk you through it like we're texting at 2am, because honestly? this one is giving grammar girlie energy and I am obsessed. let's go 🫶

---

✨ NAME ✨

__attribute__

__attribute__ ((attribute-list))

and now the grammar, bestie — copy it exactly, no cap:

attribute-list: attribute<sub>opt</sub>
attribute-list, attribute<sub>opt</sub>

attribute: attribute-token
attribute-argument-clause<sub>opt</sub>

attribute-token: identifier

attribute-argument-clause: (
attribute-argument-list )

attribute-argument-list:
attribute-argument
attribute-argument-list,
attribute-argument

attribute-argument:
assignment-expression

like… the way it just recurses? iconic behavior fr fr 💅

---

🌸 DESCRIPTION 🌸

okay so this section is the vibe check on how you're allowed to use __attribute__, and what the attribute specifiers actually latch onto. the lore, basically.

an attribute specifier looks like this:

__attribute__ ((attribute-list))

and here's the tea ☕ — this syntax is taken directly from GCC. but unlike GCC (which only lets attributes be applied to functions, types, and variables, kinda restrictive ngl), OpenCL attributes can be associated with:

• attributes-types(3clc)
• functionQualifiers(3clc)
• attributes-variables(3clc)
• attributes-blocksAndControlFlow(3clc)
• attributes-blocksAndControlFlow(3clc)

(yes bestie, attributes-blocksAndControlFlow(3clc) is listed twice — I'm not gonna pretend that's not there, we report the facts in this house 🍓)

and in general? the rules for how an attribute binds in a given context are non-trivial 😭 like, genuinely not a casual read. so the reader is pointed to GCC's documentation and to Maurer and Wong's paper (see the "References" section in the OpenCL specification[1] for the details).

---

📜 SPECIFICATION 📜

OpenCL Specification[2]

---

👀 SEE ALSO 👀

attributes-types(3clc), attributes-variables(3clc), attributes-blocksAndControlFlow(3clc), functionQualifiers(3clc)

---

👑 AUTHORS 👑

The Khronos Group

---

🎀 COPYRIGHT 🎀

Copyright © 2007-2011 The Khronos Group Inc.

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and/or associated documentation files (the "Materials"), to deal in the Materials without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Materials, and to permit persons to whom the Materials are furnished to do so, subject to the condition that this copyright notice and permission notice shall be included in all copies or substantial portions of the Materials.

---

🦋 NOTES 🦋

1. OpenCL specification page 355, section 11 - References (to Wong paper)
2. OpenCL Specification page 236, section 6.11. - Attribute Qualifiers

---

lowkey a whole lot of grammar for one little keyword, but that's the assignment and she ate 💅

and that's the whole page, bestie!! this was The Khronos Group's work, dated 01/14/2021, living in the OpenCL Manual as __ATTRIBUTE__(3clc). slay, periodt, go write some attributes 💖✨