libssh2_poll(3)

libssh2_poll3

Poll for activity on a socket, channel or listener

Usage

#include <libssh2.h>
int
libssh2_poll(LIBSSH2_POLLFD *fds, unsigned int nfds, long timeout);

Overview

This function is deprecated. Do note use. We encourage users to instead use the poll(3) or select(3) functions to check for socket activity or when specific sockets are ready to get received from or send to.

Poll for activity on a socket, channel, listener, or any combination of these three types. The calling semantics for this function generally match poll(2) however the structure of fds is somewhat more complex in order to accommodate the disparate datatypes, POLLFD constants have been namespaced to avoid platform discrepancies, and revents has additional values defined.

Return value

Number of fds with interesting events.

Releases

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

  1. 5.0
  2. 6.0
  3. 7–8
  4. 9–12
  5. 13–Arch

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