---
name: "SDL_SetGPUBufferName"
section: "3"
platform: "linux"
package: "libsdl3-doc"
version: "3.2.10+ds-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/SDL_SetGPUBufferName"
---

# SDL\_SetGPUBufferName(3)

Sets an arbitrary string constant to label a buffer.

## NAME

SDL\_SetGPUBufferName - Sets an arbitrary string constant to label a buffer.

## HEADER FILE

Defined in SDL3/SDL\_gpu.h

## SYNOPSIS

```
#include "SDL3/SDL.h"
```

**void SDL\_SetGPUBufferName(**     **SDL\_GPUDevice \*device,**     **SDL\_GPUBuffer \*buffer,**     **const char \*text);**

## DESCRIPTION

You should use

**SDL\_PROP\_GPU\_BUFFER\_CREATE\_NAME\_STRING**

with  **SDL\_CreateGPUBuffer**\
  instead of this function to avoid thread safety issues.

## FUNCTION PARAMETERS

- *device*

  a GPU Context.

- *buffer*

  a buffer to attach the name to.

- *text*

  a UTF-8 string constant to mark as the name of the buffer.

## THREAD SAFETY

This function is not thread safe, you must make sure the buffer is not simultaneously used by any other thread.

## AVAILABILITY

This function is available since SDL 3.2.0.

## SEE ALSO

**•**(3), [**SDL\_CreateGPUBuffer**(3)](/SDL_CreateGPUBuffer/3.md)
