PMCONVERTTIME(3)

💖 PMCONVERTTIME(3) — the one where we turn a tm into actual seconds 💖

okay bestie, gather round, because this is a page from the Library Functions Manual and it's literally about converting tm structures into seconds. it's giving internal-PCP-developer energy, iykyk 🫶

✨ NAME ✨

__pmtimevalConvert, __pmtimespecConvert — convert tm structure into seconds 💅

🌸 C SYNOPSIS 🌸

#include "pmapi.h"
#include "libpcp.h"

int __pmtimevalConvert(struct tm *tmin, struct timeval *origin,
                       struct timeval *rslt);
int __pmtimespecConvert(struct tm *tmin, struct timespec *origin,
                        struct timespec *rslt);

cc ... -lpcp

like, that's the whole vibe right there. two functions, one #include pair, and you link with -lpcp. iconic. 🎀

💀 CAVEAT 💀

no cap, this one comes with a warning label, and you need to read it.

this documentation is for internal Performance Co-Pilot (PCP) developer use. periodt.

these interfaces are not part of the PCP APIs that are guaranteed to remain fixed across releases. and they may not work, or may provide different semantics at some point in the future. 😭

so like… don't build your whole personality around them. they could change on you. fr fr.

🦋 DESCRIPTION 🦋

okay so here's what's actually happening, bestie.

__pmtimevalConvert and __pmtimespecConvert accept a tm structure that has been filled in by __pmParseCtime(3) — plus a reference time point called origin — and then they fill in the given rslt structure with the time the user actually meant when they were specifying a partial ctime, or a positive or negative time interval. ✨

typically, the argument origin is the start time for a set of PCP archives… unless the user specified a negative interval offset, in which case it is the end time of the archive. lowkey important distinction, don't sleep on it 👑

__pmtimevalConvert and __pmtimespecConvert return 0 if successful. they return -1 and write an error message to stderr if an error is detected. so like, check that return value, bestie, it's not just decor 💅

use pmNewZone(3), pmNewContextZone(3) or pmUseZone(3) to establish a new current timezone that will effect __pmtimevalConvert. 🕰️

🌈 SEE ALSO 🌈

• PMAPI(3)
• __pmParseCtime(3)
• __pmtimevalParse(3)
• pmNewContextZone(3)
• pmNewZone(3)
• pmParseInterval(3)
• pmParseTimeWindow(3)
• pmUseZone(3)

go read those too, they're all part of the same friend group 🫶

and that's the whole page, bestie!! this was brought to you by Performance Co-Pilot (that's the PCP in the corner, mwah) — internal dev docs, no guarantees, stay hydrated, and remember: if your timezone is wrong, your conversion is wrong, and that's not a vibe. 💖✨🎀🦋🌸💅