XLISTDEVICEPROPERTIE(3)

📦
version 1.8.3 · 6 versions
, in fedora 44

💖 XLISTDEVICEPROPERTIE(3) 💖

okay bestie, welcome to the XLISTDEVICEPROPERTIE(3) manual page — yes that's the name, no I did not spell it wrong, that's just how the page is titled, we don't question it, we simply vibe 🦋

✨ NAME ✨

XListDeviceProperties — literally just lists a device's properties. that's it. that's the whole job. she's an icon, she's a legend, and she is the moment 💅

🌸 SYNOPSIS 🌸

#include <X11/extensions/XInput.h>

Atom* XListDeviceProperties( Display *display,
                             XDevice *device,
                             int *nprops_return);

okay so here's what you're handing her:

  • display — the connection to the X server. your link-up, your group chat with the server, the whole thing 🫶
  • device — the device you wanna list the properties for. the main character in question 👑
  • nprops_return — this one specifies the number of Atoms returned. she's telling you how many you got, bestie 💀

🎀 DESCRIPTION 🎀

so the way that XListDeviceProperties works is it returns a list of the properties associated with the input device you specified in device. and like… each device can have an arbitrary number of properties attached, no cap. some of them were created by the driver and/or server (so like, born that way ✨), and others were created by clients at runtime (so, chosen later, we love a glow-up 💅).

and then — important!! — the client is expected to free the list of properties using XFree. do not forget. do not leave her hanging. free your list, periodt 🧚

also, XListDeviceProperties can generate a BadDevice error. she's not being dramatic, that's just a real thing that can happen 😭

🔥 DIAGNOSTICS 🔥

  • BadDevice — an invalid device was specified. the device does not exist. it's giving ghosted. it's giving nothing to see here. sorry babe 💀

🌈 SEE ALSO 🌈

the whole squad, fr fr 🫶 go read them too, iykyk

and that's a wrap, my love 💜 this has been the XLISTDEVICEPROPERTIE(3) page, dated 05/18/2026 — yes bestie, that's the version/date footer, we're mentioning it because we're polite and also because it's lowkey iconic. mwah. go free your lists. 🎀✨

📦 where this page comes from