GEARMAN_TASK_ST(3)

💖 GEARMAN_TASK_ST(3) 💖

okay so bestie, welcome to GEARMAN_TASK_ST(3), straight out of the Gearmand manual 💅 this is the page about gearman_task_st, the little struct that runs the whole show. stay with me, it's actually so good.

---

✨ NAME ✨

gearman_task_st — Gearmand Documentation, http://gearman.info/

---

🎀 SYNOPSIS 🎀

#include <libgearman/gearman.h>

type gearman_task_st

void gearman_task_free(gearman_task_st *task)

void *gearman_task_context(const gearman_task_st *task)

void gearman_task_set_context(gearman_task_st *task, void *context)

const char *gearman_task_function_name(const gearman_task_st *task)

const char *gearman_task_unique(const gearman_task_st *task)

const char *gearman_task_job_handle(const gearman_task_st *task)

bool gearman_task_is_known(const gearman_task_st *task)

bool gearman_task_is_running(const gearman_task_st *task)

uint32_t <#c.uint32_t> gearman_task_numerator(const gearman_task_st
*task)

uint32_t <#c.uint32_t> gearman_task_denominator(const gearman_task_st
*task)

void gearman_task_give_workload(gearman_task_st *task, const void
*workload, size_t <#c.size_t> workload_size)

size_t <#c.size_t> gearman_task_send_workload(gearman_task_st *task,
const void *workload, size_t <#c.size_t> workload_size, gearman_return_t
<#c.gearman_return_t> *ret_ptr)

const void *gearman_task_data(const gearman_task_st *task)

size_t <#c.size_t> gearman_task_data_size(const gearman_task_st *task)

void *gearman_task_take_data(gearman_task_st *task, size_t <#c.size_t>
*data_size)

size_t <#c.size_t> gearman_task_recv_data(gearman_task_st *task, void
*data, size_t <#c.size_t> data_size, gearman_return_t <#c
.gearman_return_t> *ret_ptr)

const char *gearman_task_error(const gearman_task_st *task)

Added in version 0.21.

gearman_return_t <#c.gearman_return_t> gearman_task_return(const
gearman_task_st *task)

Added in version 0.21.

Link with -lgearman

also fr fr you gotta link with -lgearman or none of this works, no cap 🔥

---

🌸 DESCRIPTION 🌸

A gearman_task_st represents a task. Iconic. Anyway: work that a client sends to a gearman server is seen as a task — and heads up, a worker receives a task in the form of a job. same energy, different name, iykyk.

Tasks, i.e. gearman_task_st, are created by calling either gearman_execute(), gearman_client_add_task(), or gearman_client_add_task_background().

gearman_client_add_task_status() can also create gearman_task_st, and those tasks get used to monitor a gearman_task_st that was created previously. task watching its own task, she's so observant ✨

gearman_task_free() is used to free a task. You only actually need to do this if the task was created with a preallocated structure, or if you just want to clean up the memory of one specific task. declutter queen 🧚

gearman_task_set_context() sets the given context of the gearman_task_st. The context can be used to pass information to a gearman_task_st.

gearman_task_context() returns the context that was used in the creation of the gearman_task_st (or that was set with gearman_task_set_context().

gearman_task_data() returns the current data that has been returned to the task. gearman_task_data_size() will give you the size of the value. gearman_task_take_data() is the same as gearman_task_data() but the value that is returned must be freed by the client (free(3)). gearman_task_recv_data() can be used with pre-allocated buffers.

gearman_task_is_known(), gearman_task_is_running(), gearman_task_numerator(), and gearman_task_denominator() return values related to the last status update that was made to the gearman_task_st. ⚠️ lowkey important: they do not cause the gearman_task_st to update itself. it's giving "read-only, bestie, she's not refreshing for you 💀".

gearman_task_error() returns the last error message that the gearman_task_st encountered. gearman_task_return() returns the last gearman_return_t stored. A value of GEARMAN_UNKNOWN_STATE means that the task has not been submitted to server yet, or that no function was available if the job has been submitted. so if you see that one, don't panic — it's telling you where you are, not that you broke something 🫶

---

🦋 RETURN VALUE 🦋

Various. Values that are returned by gearman_task_take_data() must have free(3) called on them.

bestie. free(3) it. every time. leaking is not the vibe 🙈

---

🏠 HOME 🏠

To find out more information please check: http://gearman.info/

---

👑 SEE ALSO 👑

• gearmand(8)
• libgearman(3)

---

💜 Author 💜

Data Differential http://www.datadifferential.com/

💜 Copyright 💜

2011-2014, Data Differential, http://www.datadifferential.com/

---

and that's the whole page, you ate it 💅 mwah. this was GEARMAN_TASK_ST(3) from the Gearmand manual, version 1.1.21+ds, dated Feb 04, 2026 — go forth and slay your tasks, periodt 🎀✨💖