---
name: "nng_listener_close"
section: "3"
platform: "linux"
package: "libnng-dev"
version: "1.10.1-2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://carta.tech/man/nng_listener_close"
---

# nng\_listener\_close(3)

close listener

## NAME

nng\_listener\_close - close listener

## SYNOPSIS

```
#include <nng/nng.h>
int nng_listener_close(nng_listener l);
```

## DESCRIPTION

The `nng_listener_close()` function closes the listener *l*. This also closes any pipes that have been created by the listener.

Once this function returns, the listener *l* and any of its resources are deallocated. Therefore it is an error to attempt to access *l* after this function has returned. (Attempts to do so will result in `NNG_ECLOSED` errors.)

Listeners are implicitly closed when the socket they are associated with is closed.

## RETURN VALUES

This function returns 0 on success, and non-zero otherwise.

## ERRORS

`NNG_ECLOSED`

Parameter *l* does not refer to an open listener.

## SEE ALSO

[nng\_close(3)](/man/nng_close/3.md), [nng\_listen(3)](/man/nng_listen/3.md), [nng\_listener\_create(3)](/man/nng_listener_create/3.md) [nng\_strerror(3)](/man/nng_strerror/3.md), [nng\_listener(5)](/man/nng_listener/5.md), [nng(7)](/man/nng/7.md)