You are viewing the version of this documentation from Perl blead. This is the main development branch of Perl. (git commit 2912ef9981a8215226f4f7e5e9cd82d83173b3c1)
lstat FILEHANDLE
lstat EXPR
lstat DIRHANDLE
lstat

Does the same thing as the stat function (including setting the special _ filehandle) but stats a symbolic link instead of the file the symbolic link points to. If symbolic links are unimplemented on your system, a normal stat is done. For much more detailed information, please see the documentation for stat.

If EXPR is omitted, stats $_.

Portability issues: "lstat" in perlport.