libssh2_scp_recv(3)

libssh2_scp_recv3

Request a remote file via scp

Usage

#include <libssh2.h>
LIBSSH2_CHANNEL *
libssh2_scp_recv(LIBSSH2_SESSION *session, const char *path, struct stat *sb);

Overview

This function is DEPRECATED in 1.7.0. Use the libssh2_scp_recv2(3) function instead!

session - Session instance as returned by libssh2_session_init_ex(3)

path - Full path and filename of file to transfer. That is the remote file name.

sb - Populated with remote file's size, mode, mtime, and atime

Request a file from the remote host via SCP.

Return value

Pointer to a newly allocated LIBSSH2_CHANNEL instance, or NULL on errors.

Errors

LIBSSH2_ERROR_ALLOC - An internal memory allocation call failed.

LIBSSH2_ERROR_SCP_PROTOCOL -

LIBSSH2_ERROR_EAGAIN - Marked for non-blocking I/O but the call would block.

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.