---
name: "gearman_client_add_task_status"
section: "3"
platform: "linux"
package: "gearmand"
version: "2.2.0-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/gearman_client_add_task_status"
---

# gearman\_client\_add\_task\_status(3)

Gearmand Documentation, https://gearman.org/gearmand/

## NAME

gearman\_client\_add\_task\_status - Gearmand Documentation, https://gearman.org/gearmand/

## SYNOPSIS

\#include \<libgearman/gearman.h\>

- ***gearman\_task\_st* \*gearman\_client\_add\_task\_status(*gearman\_client\_st* \*client, *gearman\_task\_st* \*task, void \*context, const char \*job\_handle, *gearman\_return\_t* \*ret\_ptr)**

  Link with -lgearman

## DESCRIPTION

*gearman\_client\_add\_task\_status()* creates a *gearman\_task\_st* that can be used to monitor a previously created task.

**WARNING:**

You may wish to avoid using *gearman\_client\_add\_task()* with a stack based allocated *gearman\_task\_st*. The most common issues related to ABI safety involve stack allocated structures. If you use a stack based *gearman\_task\_st* you must free it with *gearman\_task\_free()*.

## RETURN VALUE

The *gearman\_task\_st* is created and a pointer to it is returned. On error NULL is returned and ret\_ptr is set with a *gearman\_return\_t*.

## HOME

To find out more information please check: *https://gearman.org/gearmand/*

**SEE ALSO:**

**[gearmand(8)](/gearmand/8.md)** **[libgearman(3)](/libgearman/3.md)** **[gearman\_task\_st(3)](/gearman_task_st/3.md)**

## AUTHOR

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

## COPYRIGHT

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