Python | os.statvfs 函数

Lasted 2020-12-09 12:09:43

os.statvfs 函数在所给的路径上执行 statvfs() 系统调用。返回值是一个对象，其属性描述了所给路径上的文件系统，并且与 statvfs 结构体的成员相对应，即：f_bsize, f_frsize, f_blocks, f_bfree, f_bavail, f_files, f_ffree, f_favail, f_flag, f_namemax, f_fsid。

为 f_flag 属性位定义了两个模块级常量：如果存在 ST_RDONLY 位，则文件系统以只读挂载；如果存在 ST_NOSUID 位，则文件系统禁用或不支持 setuid/setgid 位。

函数定义

os.statvfs(path)

# 函数定义

if sys.platform != 'win32':
    def statvfs(path: _FdOrPathType) -> statvfs_result: ...  # Unix only

# 返回值 os.statvfs_result 定义
if sys.platform != 'win32':
    class statvfs_result:  # Unix only
        f_bsize: int  # It represents the file system block size
        f_frsize: int # It represents the fragment size
        f_blocks: int # It represents the size of fs in f_frsize units
        f_bfree: int # It represents the number of free blocks 
        f_bavail: int # It represents the number of free blocks for unprivileged users
        f_files: int # It represents the number of inodes
        f_ffree: int # t represents the number of free inodes
        f_favail: int # It represents the number of free inodes for unprivileged users
        f_fsid: int # It represents the file system ID
        f_flag: int # It represents the mount flags
        f_namemax: int # It represents the maximum filename length

兼容性：Unix 系统。

参数

返回值

statvfs_result - 返回值参见函数定义。

示例1: - 使用 os.statvfs() 函数返回 statvfs() 系统调用对象，比如文件名最大值。

# coding=utf-8

# Python3 代码
# 讲解怎样使用 os.statvfs() 函数执行 statvfs() 系统调用

# 引入 os 库
import os

# 文件路径
path = "foo.txt"

# 执行 statvfs() 系统调用
statvfs = os.statvfs(path)

# 打印文件状态图
print(statvfs)

# 打印最大文件名
print("Name Max::", statvfs.f_namemax)

os.statvfs_result(f_bsize=4096, f_frsize=4096, f_blocks=10255672, f_bfree=1571516, f_bavail=1043132, f_files=2621440, f_ffree=1660839, f_favail=1660839, f_flag=4096, f_namemax=255)
Name Max:: 255

为基于 GNU/glibc 的系统还定义了额外的模块级常量。它们是 ST_NODEV （禁止访问设备专用文件），ST_NOEXEC （禁止执行程序），ST_SYNCHRONOUS （写入后立即同步），ST_MANDLOCK （允许文件系统上的强制锁定），ST_WRITE （写入文件/目录/符号链接），ST_APPEND （仅追加文件），ST_IMMUTABLE （不可变文件），ST_NOATIME （不更新访问时间），ST_NODIRATIME （不更新目录访问时间），ST_RELATIME （相对于 mtime/ctime 更新访问时间）。