GLGETPROGRAM(3G)

📦

version 1.1 · 7 versions

1.1 · centos-stream 9 (latest)
arch rolling
1.1 · fedora 43
1.0~svn33624 · ubuntu jammy, ubuntu noble
1.1 · fedora 44
1.0~svn33624 · ubuntu resolute, ubuntu stonking
1.0~svn33624 · debian trixie, ubuntu questing

💅 GLGETPROGRAM (3G) 🎀

okay bestie, so this is a page from the 3G manual — and before you ask, the manual itself is literally labeled [FIXME: manual], so no cap, we're all just vibing in a work-in-progress.

✨ NAME ✨

glGetProgramiv — returns a parameter from a program object. that's it. that's the whole job. 📋

🌸 C SPECIFICATION 🌸

void glGetProgramiv(GLuint program, GLenum pname, GLint *params);

🦋 PARAMETERS 🦋

program — specifies the program object to be queried. which one are we snooping on 👀
pname — specifies the object parameter. the accepted symbolic names are: GL_DELETE_STATUS, GL_LINK_STATUS, GL_VALIDATE_STATUS, GL_INFO_LOG_LENGTH, GL_ATTACHED_SHADERS, GL_ACTIVE_ATOMIC_COUNTER_BUFFERS, GL_ACTIVE_ATTRIBUTES, GL_ACTIVE_ATTRIBUTE_MAX_LENGTH, GL_ACTIVE_UNIFORMS, GL_ACTIVE_UNIFORM_BLOCKS, GL_ACTIVE_UNIFORM_BLOCK_MAX_NAME_LENGTH, GL_ACTIVE_UNIFORM_MAX_LENGTH, GL_COMPUTE_WORK_GROUP_SIZE GL_PROGRAM_BINARY_LENGTH, GL_TRANSFORM_FEEDBACK_BUFFER_MODE, GL_TRANSFORM_FEEDBACK_VARYINGS, GL_TRANSFORM_FEEDBACK_VARYING_MAX_LENGTH, GL_GEOMETRY_VERTICES_OUT, GL_GEOMETRY_INPUT_TYPE, and GL_GEOMETRY_OUTPUT_TYPE.
params — returns the requested object parameter. this is where the tea gets spilled 💅

💖 DESCRIPTION 💖

glGetProgram returns in params the value of a parameter for a specific program object. here's the full rundown of what each parameter gives you, no gatekeeping:

`GL_DELETE_STATUS`

params returns GL_TRUE if program is currently flagged for deletion, and GL_FALSE otherwise. it's giving "living on borrowed time" 😭

`GL_LINK_STATUS`

params returns GL_TRUE if the last link operation on program was successful, and GL_FALSE otherwise.

`GL_VALIDATE_STATUS`

params returns GL_TRUE or if the last validation operation on program was successful, and GL_FALSE otherwise. (yes, the original literally says "GL_TRUE or" — we don't fix, we report 🫶)

`GL_INFO_LOG_LENGTH`

params returns the number of characters in the information log for program, including the null termination character (i.e. the size of the character buffer required to store the information log). if program has no information log, a value of 0 is returned.

`GL_ATTACHED_SHADERS`

params returns the number of shader objects attached to program. how many besties are in the group chat 🫂

`GL_ACTIVE_ATOMIC_COUNTER_BUFFERS`

params returns the number of active attribute atomic counter buffers used by program.

`GL_ACTIVE_ATTRIBUTES`

params returns the number of active attribute variables for program.

`GL_ACTIVE_ATTRIBUTE_MAX_LENGTH`

params returns the length of the longest active attribute name for program, including the null termination character (i.e. the size of the character buffer required to store the longest attribute name). if no active attributes exist, 0 is returned.

`GL_ACTIVE_UNIFORMS`

params returns the number of active uniform variables for program.

`GL_ACTIVE_UNIFORM_MAX_LENGTH`

params returns the length of the longest active uniform variable name for program, including the null termination character (i.e. the size of the character buffer required to store the longest uniform variable name). if no active uniform variables exist, 0 is returned.

`GL_PROGRAM_BINARY_LENGTH`

params returns the length of the program binary, in bytes, that will be returned by a call to glGetProgramBinary(). when a progam's GL_LINK_STATUS is GL_FALSE, its program binary length is zero. (also "progam" is spelled like that in the source — preserving the lore ✨)

`GL_COMPUTE_WORK_GROUP_SIZE`

params returns an array of three integers containing the local work group size of the compute program as specified by its input layout qualifier(s). program must be the name of a program object that has been previously linked successfully and contains a binary for the compute shader stage. no shortcuts, bestie 🔥

`GL_TRANSFORM_FEEDBACK_BUFFER_MODE`

params returns a symbolic constant indicating the buffer mode used when transform feedback is active. this may be GL_SEPARATE_ATTRIBS or GL_INTERLEAVED_ATTRIBS.

`GL_TRANSFORM_FEEDBACK_VARYINGS`

params returns the number of varying variables to capture in transform feedback mode for the program.

`GL_TRANSFORM_FEEDBACK_VARYING_MAX_LENGTH`

params returns the length of the longest variable name to be used for transform feedback, including the null-terminator.

`GL_GEOMETRY_VERTICES_OUT`

params returns the maximum number of vertices that the geometry shader in program will output.

`GL_GEOMETRY_INPUT_TYPE`

params returns a symbolic constant indicating the primitive type accepted as input to the geometry shader contained in program.

`GL_GEOMETRY_OUTPUT_TYPE`

params returns a symbolic constant indicating the primitive type that will be output by the geometry shader contained in program.

⭐ NOTES ⭐ (read these fr fr)

GL_ACTIVE_UNIFORM_BLOCKS and GL_ACTIVE_UNIFORM_BLOCK_MAX_NAME_LENGTH are available only if the GL version is 3.1 or greater.
GL_GEOMETRY_VERTICES_OUT, GL_GEOMETRY_INPUT_TYPE and GL_GEOMETRY_OUTPUT_TYPE are accepted only if the GL version is 3.2 or greater.
GL_COMPUTE_WORK_GROUP_SIZE is accepted only if the GL version is 4.3 or greater.
if an error is generated, no change is made to the contents of params. your data stays untouched, we love a safe queen 👑

💀 ERRORS 💀

GL_INVALID_VALUE is generated if program is not a value generated by OpenGL.
GL_INVALID_OPERATION is generated if program does not refer to a program object.
GL_INVALID_OPERATION is generated if pname is GL_GEOMETRY_VERTICES_OUT, GL_GEOMETRY_INPUT_TYPE, or GL_GEOMETRY_OUTPUT_TYPE, and program does not contain a geometry shader.
GL_INVALID_ENUM is generated if pname is not an accepted value.
GL_INVALID_OPERATION is generated if pname is GL_COMPUTE_WORK_GROUP_SIZE and program does not contain a binary for the compute shader stage.

🔍 ASSOCIATED GETS 🔍

glGetActiveAttrib() with argument program
glGetActiveUniform() with argument program
glGetAttachedShaders() with argument program
glGetProgramInfoLog() with argument program
glIsProgram()

🌈 VERSION SUPPORT 🌈

the original ships a whole grid here, and the grid is basically all vibes and checkmarks. the columns are Function / Feature Name and then the OpenGL versions: 2.0, 2.1, 3.0, 3.1, 3.2, 3.3, 4.0, 4.1, 4.2, 4.3, 4.4, 4.5.

and the one and only row, glGetProgramiv, is ✔ in every single one of them. 2.0 ✔ 2.1 ✔ 3.0 ✔ 3.1 ✔ 3.2 ✔ 3.3 ✔ 4.0 ✔ 4.1 ✔ 4.2 ✔ 4.3 ✔ 4.4 ✔ 4.5 ✔. consistent icon behavior, we stan a reliable function 👑

🫶 SEE ALSO 🫶

glAttachShader(), glCreateProgram(), glDeleteProgram(), glGetShader(), glLinkProgram(), glValidateProgram()

📜 COPYRIGHT 📜

Copyright © 2003-2005 3Dlabs Inc. Ltd. Copyright © 2010-2014 Khronos Group. This material may be distributed subject to the terms and conditions set forth in the Open Publication License, v 1.0, 8 June 1999. http://opencontent.org/openpub/.

📜 COPYRIGHT (yes, again) 📜

and that's the whole page bestie 💖 source is [FIXME: source], dated 08/09/2021, and it answers to the name GLGETPROGRAM(3G). go query something iconic 🎀✨

📦 where this page comes from

centos-stream 9: gl-manpages 1.1-24.20190306.el9 · MIT and Open Publication
💖 girlified by deepseek-ai/DeepSeek-V4.1-Flash-1017 on 2026-11-04: a language model's rewrite of the original, under its terms