DPMSGetTimeouts(3)

πŸ’– DPMSGetTimeouts β€” the girlies' guide to peeking at your screen's nap schedule πŸ’–

okay so bestie, this one lives in section 3 of the X FUNCTIONS manual, and it's lowkey the chillest little function ever. It's called DPMSGetTimeouts, and it's literally just "hey X server, what are your DPMS nap timings bestie? spill." No cap.


✨ NAME ✨

DPMSGetTimeouts β€” retrieves the timeout values used by the X server for DPMS timings 🫢


🌸 SYNOPSIS 🌸

cc [ flag ... ] file ... -lXext [ library ... ]
#include <X11/extensions/dpms.h>

Bool DPMSGetTimeouts
       (
             Display *display,
             CARD16 *standby,
             CARD16 *suspend,
             CARD16 *off
       );

πŸŽ€ ARGUMENTS πŸŽ€

  • display β€” Specifies the connection to the X server. it's giving "hi hello which server are we talking to" energy πŸ’…
  • standby β€” Specifies the current standby timeout in seconds. the lil first nap ⭐
  • suspend β€” Specifies the current suspend timeout in seconds. the deeper nap 😴
  • off β€” Specifies the current off timeout in seconds. the final sleep, main character energy πŸ‘‘

πŸ¦‹ DESCRIPTION πŸ¦‹

The DPMSGetTimeouts function retrieves the timeout values used by the X server for DPMS timings. that's it, that's the whole vibe. it's a getter, it's not doing anything extra, it's just handing you the numbers ✨

The value standby is the amount of time of inactivity in seconds before standby mode is invoked. A value of zero indicates that this mode has been disabled. so if it's 0, bestie that mode is not coming, it's cancelled 🚫

The value suspend is the amount of time of inactivity in seconds before the second level of power savings is invoked. A value of zero indicates that this mode has been disabled. second level, deeper nap, still cancelled if it's 0 πŸ’€

The value off is the amount of time of inactivity in seconds before the third and final level of power savings is invoked. A value of zero indicates that this mode has been disabled. third and final, the last boss, and yes, 0 still means disabled fr fr 🫠


🌈 RETURN VALUES 🌈

  • TRUE β€” The DPMSGetTimeouts function returns TRUE when values are returned. slay, you got the numbers πŸŽ‰
  • FALSE β€” The DPMSGetTimeouts function returns FALSE when no values returned. no numbers for you, rip 😭

πŸ‘‘ SEE ALSO πŸ‘‘


ngl the whole friend group is here: DPMSCapable(3) to check if DPMS is even a thing, DPMSInfo(3) for the status tea, and DPMSSetTimeouts(3) if you wanna be the one setting the naps instead of just reading them πŸ’…

okay that's the whole page bestie, no crumbs left. this one comes to you from X Version 11, libXext 1.3.6 β€” periodt πŸ’– go forth and check those timeouts, you ate πŸ“

πŸ“¦ where this page comes from