all Python 3Linux · macOSosfunction

os.pathconf

os — configuration

Return a system configuration limit for a path. Availability: Unix.

Syntax

os.pathconf(...)

Limits depend on the filesystem, not just the OS: one disk may allow 255-byte names, another fewer. Valid parameter names are listed in os.pathconf_names; an unknown name raises ValueError. The limit is in bytes, not characters — Cyrillic in UTF-8 takes two bytes per letter.

Examples

import os
print(os.pathconf('/tmp', 'PC_NAME_MAX'))  # → ? только Unix: предел длины имени файла в /tmp, обычно 255
print(os.pathconf('/tmp', os.pathconf_names['PC_PATH_MAX']))  # → ? только Unix: предел длины всего пути, например 4096 (имя ограничения можно заменить его кодом)
name = 'отчёт_за_2026_год.txt'
print(len(name.encode()) <= os.pathconf('/tmp', 'PC_NAME_MAX'))  # → ? только Unix: True — проверяем длину имени в байтах до создания файла
print(os.pathconf('/нет-такого-каталога', 'PC_NAME_MAX'))  # → FileNotFoundError

See also

Open in the full glossarydocs.python.orgReport an inaccuracy