PMNEWZONE(3)

PMNEWZONE(3) 💖

okay bestie, welcome to the Library Functions Manual for PCP (that's Performance Co-Pilot, iykyk) — this one's all about the reporting timezone and honestly? it's giving "tiny function, huge vibes." ✨

---

🌸 NAME 🌸

pmNewZone</p> — establish a reporting timezone 🕰️

---

🎀 C SYNOPSIS 🎀

#include <pcp/pmapi.h>

int pmNewZone(const char *tz);

cc ... -lpcp

like yes, that's the whole thing, she's short and she knows it 💅

---

🦋 DESCRIPTION 🦋

so here's the tea: there's a thing called the current reporting timezone, and it's lowkey the main character of this whole page. it's the timezone that pmCtime(3) and pmLocaltime(3) use when they're doing their little time conversions. so if you change it, those two change their whole attitude. periodt. ⏰

the argument tz is where you pass in your timezone string — and it's in the exact same format as the one described for the TZ environment variable. so go peep environ(7) if you need the deets, bestie, no cap. 📖

and what does pmNewZone actually do? two things, both iconic:

1. it sets the current reporting timezone to whatever tz says, and
2. it returns a value — and that value is not just decoration, honey. you can pass it into a later call to pmUseZone(3) to restore this exact reporting timezone. it's like a save point. main character energy fr fr. 🎮✨

---

💀 DIAGNOSTICS 💀

if the return value comes back less than zero, that's a 🚨 fatal error 🚨 from a system call. and the most likely culprit? our old friend malloc(3). so if you see a negative number, don't panic, just... check your memory allocation situation. 🙈

lowkey a warning: negative return = something went very wrong at the system-call level. treat it accordingly, bestie. 😭

---

🫶 SEE ALSO 🫶

the whole squad, in alphabetical order because we're organized queens 👑

• PMAPI(3)
• pmCtime(3)
• pmGetConfig(3)
• pmLocaltime(3)
• pmNewContextZone(3)
• pmUseZone(3)
• pmWhichZone(3)
• pcp.conf(5)
• pcp.env(5)
• environ(7)

---

and that's the whole page, babe!! 🌈 this little icon of a manpage comes to you from Performance Co-Pilot (that's the PCP crew 💖) and it lives in section PMNEWZONE(3) of the manual. go forth and timezone responsibly, bestie — you got this. 👑💜