---
name: "libssh2_channel_free"
section: "3"
platform: "linux"
package: "libssh2"
version: "1.11.1-7"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/libssh2_channel_free"
---

# libssh2\_channel\_free(3)

free all resources associated with a channel

## NAME

libssh2\_channel\_free - free all resources associated with a channel

## SYNOPSIS

```
#include <libssh2.h>
int
libssh2_channel_free(LIBSSH2_CHANNEL *channel);
```

## DESCRIPTION

*channel* - Channel stream to free.

Release all resources associated with a channel stream. If the channel has not yet been closed with **[libssh2\_channel\_close(3)](/libssh2_channel_close/3.md)** , it will be called automatically so that the remote end may know that it can safely free its own resources.

## RETURN VALUE

Return 0 on success or negative on failure. It returns LIBSSH2\_ERROR\_EAGAIN when it would otherwise block. While LIBSSH2\_ERROR\_EAGAIN is a negative number, it is not really a failure per se.

## SEE ALSO

**[libssh2\_channel\_close(3)](/libssh2_channel_close/3.md)**