[WIP] [Process] Add functions to get current process PID and name

include/SDL3/SDL_process.h

@@ -425,6 +425,37 @@ extern SDL_DECLSPEC bool SDLCALL SDL_WaitProcess(SDL_Process *process, bool bloc
  */
 extern SDL_DECLSPEC void SDLCALL SDL_DestroyProcess(SDL_Process *process);
 
+/**
+ * Get the current process ID.
+ *
+ * It eventually maps to the platform-specific function to get the current process ID (getpid() on Unix and GetCurrentProcessId() on Windows).
+ * There is no direct usage for it in SDL right now, but you may use this value for debugging or other purposes.
+ *
+ * \returns PID of the current process
+ *
+ * \threadsafety This function is not thread safe.
+ *
+ * \since This function is available since SDL 3.2.0.
+ *
+ * \sa SDL_GetCurrentProcessName
+ */
+extern SDL_DECLSPEC int SDLCALL SDL_GetCurrentProcessId(void);
+
+/**
+ * Get the current process name.
+ *
+ * Returned string is cached by SDL and should not be freed by the caller.
+ *
+ * \returns Name of the current process
+ *
+ * \threadsafety This function is not thread safe.
+ *
+ * \since This function is available since SDL 3.2.0.
+ *
+ * \sa SDL_GetCurrentProcessId
+ */
+extern SDL_DECLSPEC const char *SDLCALL SDL_GetCurrentProcessName(void);
+
 /* Ends C function definitions when using C++ */
 #ifdef __cplusplus
 }

src/SDL.c

@@ -60,6 +60,7 @@
 #ifdef SDL_PLATFORM_ANDROID
 #include "core/android/SDL_android.h"
 #endif
+#include "process/SDL_process_c.h"
 
 #define SDL_INIT_EVERYTHING ~0U
 
@@ -279,6 +280,7 @@ void SDL_InitMainThread(void)
     SDL_InitEnvironment();
     SDL_InitTicks();
     SDL_InitFilesystem();
+    SDL_InitProcessManagement();
 
     if (!done_info) {
         const char *value;
@@ -301,6 +303,7 @@ static void SDL_QuitMainThread(void)
     SDL_QuitTicks();
     SDL_QuitEnvironment();
     SDL_QuitTLSData();
+    SDL_QuitProcessManagement();
 }
 
 bool SDL_InitSubSystem(SDL_InitFlags flags)

src/dynapi/SDL_dynapi.sym

@@ -1248,6 +1248,8 @@ SDL3_0.0.0 {
     SDL_GetWindowProgressValue;
     SDL_SetRenderTextureAddressMode;
     SDL_GetRenderTextureAddressMode;
+    SDL_GetCurrentProcessId;
+    SDL_GetCurrentProcessName;
     # extra symbols go here (don't modify this line)
   local: *;
 };

src/dynapi/SDL_dynapi_overrides.h

@@ -1273,3 +1273,5 @@
 #define SDL_GetWindowProgressValue SDL_GetWindowProgressValue_REAL
 #define SDL_SetRenderTextureAddressMode SDL_SetRenderTextureAddressMode_REAL
 #define SDL_GetRenderTextureAddressMode SDL_GetRenderTextureAddressMode_REAL
+#define SDL_GetCurrentProcessId SDL_GetCurrentProcessId_REAL
+#define SDL_GetCurrentProcessName SDL_GetCurrentProcessName_REAL

src/dynapi/SDL_dynapi_procs.h

@@ -1281,3 +1281,5 @@ SDL_DYNAPI_PROC(SDL_ProgressState,SDL_GetWindowProgressState,(SDL_Window *a),(a)
 SDL_DYNAPI_PROC(float,SDL_GetWindowProgressValue,(SDL_Window *a),(a),return)
 SDL_DYNAPI_PROC(bool,SDL_SetRenderTextureAddressMode,(SDL_Renderer *a,SDL_TextureAddressMode b,SDL_TextureAddressMode c),(a,b,c),return)
 SDL_DYNAPI_PROC(bool,SDL_GetRenderTextureAddressMode,(SDL_Renderer *a,SDL_TextureAddressMode *b,SDL_TextureAddressMode *c),(a,b,c),return)
+SDL_DYNAPI_PROC(int,SDL_GetCurrentProcessId,(void),(),return)
+SDL_DYNAPI_PROC(const char*,SDL_GetCurrentProcessName,(void),(),return)

src/process/SDL_process.c

@@ -194,3 +194,32 @@ void SDL_DestroyProcess(SDL_Process *process)
     SDL_DestroyProperties(process->props);
     SDL_free(process);
 }
+
+int SDL_GetCurrentProcessId(void)
+{
+    return SDL_SYS_GetCurrentProcessId();
+}
+
+static char *CachedCurrentProcessName = NULL;
+
+const char *SDL_GetCurrentProcessName(void)
+{
+    if (!CachedCurrentProcessName) {
+        CachedCurrentProcessName = SDL_SYS_GetCurrentProcessName();
+    }
+
+    return CachedCurrentProcessName;
+}
+
+void SDL_InitProcessManagement(void)
+{
+}
+
+void SDL_QuitProcessManagement(void)
+{
+    if (CachedCurrentProcessName) {
+        SDL_free(CachedCurrentProcessName);
+    }
+
+    CachedCurrentProcessName = NULL;
+}

src/process/SDL_process_c.h

@@ -0,0 +1,28 @@
+/*
+  Simple DirectMedia Layer
+  Copyright (C) 1997-2025 Sam Lantinga <[email protected]>
+
+  This software is provided 'as-is', without any express or implied
+  warranty.  In no event will the authors be held liable for any damages
+  arising from the use of this software.
+
+  Permission is granted to anyone to use this software for any purpose,
+  including commercial applications, and to alter it and redistribute it
+  freely, subject to the following restrictions:
+
+  1. The origin of this software must not be misrepresented; you must not
+     claim that you wrote the original software. If you use this software
+     in a product, an acknowledgment in the product documentation would be
+     appreciated but is not required.
+  2. Altered source versions must be plainly marked as such, and must not be
+     misrepresented as being the original software.
+  3. This notice may not be removed or altered from any source distribution.
+*/
+
+#ifndef SDL_process_c_h_
+#define SDL_process_c_h_
+
+extern void SDL_InitProcessManagement(void);
+extern void SDL_QuitProcessManagement(void);
+
+#endif

src/process/SDL_sysprocess.h

@@ -35,3 +35,5 @@ bool SDL_SYS_CreateProcessWithProperties(SDL_Process *process, SDL_PropertiesID
 bool SDL_SYS_KillProcess(SDL_Process *process, bool force);
 bool SDL_SYS_WaitProcess(SDL_Process *process, bool block, int *exitcode);
 void SDL_SYS_DestroyProcess(SDL_Process *process);
+int SDL_SYS_GetCurrentProcessId(void);
+char *SDL_SYS_GetCurrentProcessName(void);

src/process/dummy/SDL_dummyprocess.c

@@ -45,4 +45,14 @@ void SDL_SYS_DestroyProcess(SDL_Process *process)
     return;
 }
 
+int SDL_GetCurrentProcessId(void)
+{
+    return -1;
+}
+
+char *SDL_SYS_GetCurrentProcessName(void)
+{
+    return NULL;
+}
+
 #endif // SDL_PROCESS_DUMMY

src/process/posix/SDL_posixprocess.c

@@ -511,4 +511,22 @@ void SDL_SYS_DestroyProcess(SDL_Process *process)
     SDL_free(process->internal);
 }
 
+int SDL_SYS_GetCurrentProcessId(void)
+{
+    return getpid();
+}
+
+char *SDL_SYS_GetCurrentProcessName(void)
+{
+#if defined(SDL_PLATFORM_MACOS) || defined(SDL_PLATFORM_FREEBSD)
+    char *processPath = SDL_strdup(getprogname());
+#elif defined(SDL_PLATFORM_LINUX)
+    char *processPath = SDL_strdup(program_invocation_name);
+#else
+    char *processPath = NULL;
+#endif
+
+    return processPath;
+}
+
 #endif // SDL_PROCESS_POSIX

src/process/windows/SDL_windowsprocess.c

@@ -564,4 +564,49 @@ void SDL_SYS_DestroyProcess(SDL_Process *process)
     SDL_free(data);
 }
 
+int SDL_SYS_GetCurrentProcessId(void)
+{
+    return GetCurrentProcessId();
+}
+
+char *SDL_SYS_GetCurrentProcessName(void)
+{
+    DWORD buflen = 128;
+    WCHAR *path = NULL;
+    char *result = NULL;
+    DWORD len = 0;
+
+    // Copy paste from SDL_GetBasePath() - should this be a shared function?
+    while (true) {
+        void *ptr = SDL_realloc(path, buflen * sizeof(WCHAR));
+        if (!ptr) {
+            SDL_free(path);
+            return NULL;
+        }
+
+        path = (WCHAR *)ptr;
+
+        len = GetModuleFileNameW(NULL, path, buflen);
+        // if it truncated, then len >= buflen - 1
+        // if there was enough room (or failure), len < buflen - 1
+        if (len < buflen - 1) {
+            break;
+        }
+
+        // buffer too small? Try again.
+        buflen *= 2;
+    }
+
+    if (len == 0) {
+        SDL_free(path);
+        WIN_SetError("Couldn't locate our .exe");
+        return NULL;
+    }
+
+    result = WIN_StringToUTF8W(path);
+    SDL_free(path);
+
+    return result;
+}
+
 #endif // SDL_PROCESS_WINDOWS