Function LSTAT

Syntax

lstat path buf => error

Arguments and values

path -- A string.

buf -- An instance of the class stat.

error -- A fixnum.

Description

This function returns information about the file whose name is path. This information is returned in the slots of buf. No permissions are required on the file itself, but execute (search) permission is required on all of the directories in path that lead to the file.

If path is a symbolic link, then information about the link itself is returned, and not about the file that it refers to.

Errors

+eaccess+ Search permission is denied for one of the directories in the path prefix of path.
+efault+ buf is not is not an instance of the class stat
+eloop+ Too many symbolic links encountered while traversing the path.
+enametoolong+ path is too long.
+enoent+ A component of path does not exists, or path is the empty string.
+enomem+ Out of memory (i.e., kernel memory).
+enotdir+ A component of the path prefix of path is not a directory.