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

# qb\_loop\_job\_del(3)

Delete a job from the mainloop.

## NAME

qb\_loop\_job\_del - Delete a job from the mainloop.

## SYNOPSIS

```
#include <qb/qbloop.h>

int32_t qb_loop_job_del(
    struct qb_loop          *l,            /* pointer to the loop instance */
    enum qb_loop_priority    p,            /* the priority */
    void                    *data,         /* user data passed into the dispatch function */
    qb_loop_job_dispatch_fn  dispatch_fn   /* callback function */
);
```

## PARAMS

**l**           *pointer to the loop instance*

**p**           *the priority*

**data**        *user data passed into the dispatch function*

**dispatch\_fn** *callback function*

## DESCRIPTION

This will try to delete the job if it hasn't run yet.

## STRUCTURES

```
enum qb_loop_priority {
      QB_LOOP_LOW;
      QB_LOOP_MED;
      QB_LOOP_HIGH;
};
```

## RETURN VALUE

*status (0 == ok, -errno == failure)*

## NOTE

*this will remove the first job that matches the parameters (priority, data, dispatch\_fn).*

## SEE ALSO

[*qb\_loop\_run*(3)](/qb_loop_run/3.md), [*qb\_loop\_create*(3)](/qb_loop_create/3.md), [*qb\_loop\_stop*(3)](/qb_loop_stop/3.md), [*qb\_loop\_poll\_low\_fds\_event\_set*(3)](/qb_loop_poll_low_fds_event_set/3.md), [*qb\_loop\_signal\_del*(3)](/qb_loop_signal_del/3.md), [*qb\_loop\_signal\_add*(3)](/qb_loop_signal_add/3.md), [*qb\_loop\_job\_add*(3)](/qb_loop_job_add/3.md), [*qb\_loop\_poll\_del*(3)](/qb_loop_poll_del/3.md), [*qb\_loop\_destroy*(3)](/qb_loop_destroy/3.md), [*qb\_loop\_timer\_expire\_time\_remaining*(3)](/qb_loop_timer_expire_time_remaining/3.md), [*qb\_loop\_poll\_mod*(3)](/qb_loop_poll_mod/3.md), [*qb\_loop\_signal\_mod*(3)](/qb_loop_signal_mod/3.md), [*qb\_loop\_timer\_del*(3)](/qb_loop_timer_del/3.md), [*qb\_loop\_timer\_add*(3)](/qb_loop_timer_add/3.md), [*qb\_loop\_timer\_is\_running*(3)](/qb_loop_timer_is_running/3.md), [*qb\_loop\_timer\_expire\_time\_get*(3)](/qb_loop_timer_expire_time_get/3.md), [*qb\_loop\_poll\_add*(3)](/qb_loop_poll_add/3.md)

## COPYRIGHT

Copyright (C) 2010-2020 Red Hat, Inc.