Gearman::Util(3pm)

💖 NAME 💖

Gearman::Util — it's giving utility functions for the gearman distributed job system ✨ like, the lil helper besties that make the whole distributed job thing work. This is the Gearman::Util page from the User Contributed Perl Documentation, section 3pm, and she's here to hand you the tools. 🎀

---

🛠️ METHODS 🛠️

okay so here's the whole roster, no gatekeeping, every single one of them, in order, periodt. 💅

🌸 cmd_name($num)

return cmd — you hand her a number, she hands you back the cmd. simple as that, bestie. 🦋

🌸 pack_req_command($key, $arg)

return request string — feeds in a $key and an $arg, and out comes the request string. iconic little packer. ✨

🌸 pack_res_command($cmd, $arg)

return response string — takes a $cmd and an $arg and gives you back the response string. she's matching the request vibe, just on the other side. 💜

🌸 read_res_packet($sock, $err_ref, $timeout)

return undef on closed socket or malformed packet — she reads a response packet off $sock, with $err_ref for the errors and $timeout for the patience level. and heads up 👑: if the socket is closed or the packet is malformed, you get undef back. no packet, no vibes, just undef. 😭

🌸 read_text_status($sock, $err_ref)

reads text status off $sock, with $err_ref along for the error ride. that's the whole bit. 🫶

🌸 send_req($sock, $reqref)

sends a request on $sock, using $reqref as the request ref. yes queen, ship it. 🔥

🌸 wait_for_readability($fileno, $timeout)

given a file descriptor number and a timeout,

wait for that descriptor to become readable 🌈

and she'll tell you how it went:

return 0 or 1 on if it did or not

so 0 or 1 — did it become readable, or did it not. that's the tea. ☕💀

---

and that's the page, bestie 🫶 — this one came from perl v5.26.2, dated 2018-08-30, and it's Gearman::Util(3pm) under User Contributed Perl Documentation. now go forth and distribute those jobs, main character. 👑💖✨