---
name: "libssh2_sftp_lstat"
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_lstat"
---

# libssh2\_sftp\_lstat(3)

convenience macro for libssh2\_sftp\_stat\_ex(3) calls

## NAME

libssh2\_sftp\_lstat - convenience macro for *[libssh2\_sftp\_stat\_ex(3)](/libssh2_sftp_stat_ex/3.md)* calls

## SYNOPSIS

```
#include <libssh2.h>
#include <libssh2_sftp.h>
int
libssh2_sftp_lstat(LIBSSH2_SFTP *sftp, const char *path,
                   LIBSSH2_SFTP_ATTRIBUTES *attrs);
```

## DESCRIPTION

This is a macro defined in a public libssh2 header file that is using the underlying function *[libssh2\_sftp\_stat\_ex(3)](/libssh2_sftp_stat_ex/3.md)*.

## RETURN VALUE

See *[libssh2\_sftp\_stat\_ex(3)](/libssh2_sftp_stat_ex/3.md)*

## ERRORS

See *[libssh2\_sftp\_stat\_ex(3)](/libssh2_sftp_stat_ex/3.md)*

## SEE ALSO

**[libssh2\_sftp\_stat\_ex(3)](/libssh2_sftp_stat_ex/3.md)**