---
name: lstat
status: documented
runtime: pp
source: src/runtime/pp/filesystem.rs
---
```{index} single: lstat; Perl built-in (pp runtime)
```

# lstat

## Synopsis

```perl
my @s = lstat($symlink);
my ($dev, $ino, $mode, $nlink, $uid, $gid, $rdev, $size,
    $atime, $mtime, $ctime, $blksize, $blocks) = lstat($path);
lstat _;               # reuse last stat buffer
```

## Description

Returns file metadata without following symbolic links.

Identical to `stat` except that if the target is a symbolic link,
`lstat` returns information about the link itself rather than the
file it points to. Uses `std::fs::symlink_metadata`. Returns the
same 13-element list as `stat`, or an empty list on failure.

## See also

stat, readlink, symlink