all Python 3Linux · macOSosfunction

os.statvfs

os — file system

Return filesystem statistics for a path (block size, free space). Availability: Unix.

Syntax

os.statvfs(...)

Free space for an ordinary user is f_bavail * f_frsize, not f_bfree: some blocks are reserved for root. shutil.disk_usage is the portable and simpler way to get disk space and works on Windows too. Use statvfs when details matter: inode counts, mount flags, maximum name length.

Examples

import os
st = os.statvfs('/')   # → ? только Unix: статистика файловой системы, содержащей путь '/'
print(st.f_bsize)   # → ? только Unix: предпочтительный размер блока ФС, например 4096
print(round(st.f_bavail * st.f_frsize / 1024**3, 1))   # → ? только Unix: свободно гигабайт обычному пользователю, например 37.4
print(st.f_bfree >= st.f_bavail)   # → True — часть свободных блоков зарезервирована под root
print(os.statvfs('/нет-такого-пути'))   # → ? только Unix: FileNotFoundError

See also

Common errors

Open in the full glossarydocs.python.orgReport an inaccuracy