---
name: "libssh2_sftp_last_error"
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_sftp_last_error"
---

# libssh2\_sftp\_last\_error(3)

return the last SFTP-specific error code

## NAME

libssh2\_sftp\_last\_error - return the last SFTP-specific error code

## SYNOPSIS

```
#include <libssh2.h>
#include <libssh2_sftp.h>
unsigned long
libssh2_sftp_last_error(LIBSSH2_SFTP *sftp);
```

## DESCRIPTION

*sftp* - SFTP instance as returned by **[libssh2\_sftp\_init(3)](/libssh2_sftp_init/3.md)**

Returns the last error code produced by the SFTP layer. Note that this only returns a sensible error code if libssh2 returned LIBSSH2\_ERROR\_SFTP\_PROTOCOL in a previous call. Using **[libssh2\_sftp\_last\_error(3)](/libssh2_sftp_last_error/3.md)** without a preceding SFTP protocol error, it will return an unspecified value.

## RETURN VALUE

Current error code state of the SFTP instance.

## SEE ALSO

**[libssh2\_sftp\_init(3)](/libssh2_sftp_init/3.md)**