libssh2_channel_flush_ex(3)

libssh2_channel_flush_ex3

Flush a channel

Usage

#include <libssh2.h>
int
libssh2_channel_flush_ex(LIBSSH2_CHANNEL *channel, int streamid);
int
libssh2_channel_flush(LIBSSH2_CHANNEL *channel);
int
libssh2_channel_flush_stderr(LIBSSH2_CHANNEL *channel);

Overview

channel - Active channel stream to flush.

streamid - Specific substream number to flush. Groups of substreams may be flushed by passing on of the following Constants.
LIBSSH2_CHANNEL_FLUSH_EXTENDED_DATA: Flush all extended data substreams
LIBSSH2_CHANNEL_FLUSH_ALL: Flush all substreams

Flush the read buffer for a given channel instance. Individual substreams may be flushed by number or using one of the provided macros.

Return value

Return the number of bytes flushed 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.

Releases

10 releases since Debian 5.0 (Lenny); the text changed 2 times.

  1. 5.0–6.0
  2. 7–12
  3. 13–Arch

From libssh2 1.11.1-7 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.