Python 3 - os.lstat() Method


The method lstat() is very similar to fstat() and returns a stat_result object containing the information about a file, but do not follow symbolic links. This is an alias for fstat() on platforms that do not support symbolic links, such as Windows.

Here is the structure returned by lstat method −

  • st_dev − ID of device containing file

  • st_ino − inode number

  • st_mode − protection

  • st_nlink − number of hard links

  • st_uid − user ID of owner

  • st_gid − group ID of owner

  • st_rdev − device ID (if special file)

  • st_size − total size, in bytes

  • st_blksize − blocksize for filesystem I/O

  • st_blocks − number of blocks allocated

  • st_atime − time of last access

  • st_mtime − time of last modification

  • st_ctime − time of last status change


Following is the syntax for lstat() method −



path − This is the file for which information would be returned.

Return Value

This method returns the information about a file.


The following example shows the usage of lstat() method.

import os, sys

# Open a file
path = "d:\\python3\\foo.txt"
fd = path, os.O_RDWR|os.O_CREAT )

# Close opened file
os.close( fd )

# Now get  the touple
info = os.lstat(path)

print ("File Info :", info)

# Now get uid of the file
print ("UID of the file :%d" % info.st_uid)

# Now get gid of the file
print ("GID of the file :%d" % info.st_gid)


When we run the above program, it produces the following result −

File Info : os.stat_result(st_mode=33206, st_ino=281474976797706, st_dev=1017554828, st_nlink=2, st_uid=0, st_gid=0, st_size=13, st_atime=1455597777, st_mtime=1438077266, st_ctime=1455560006)
UID of the file :0
GID of the file :0