truncate()

Обрезать файл до заданной длины

Прототип:

#include <unistd.h>
int truncate( const char *path,
off_t length );

Аргументы:

path
Путь к файлу, размер которого необходимо изменить.
length
Новая длина файла.

Библиотека:

libc

Описание:

Функция truncate() изменяет размер обычного файла path до length байт.

Влияние truncate() на другие типы файлов не определено. Если файл ранее был больше длины length, дополнительные данные будут потеряны. Если ранее он был короче длины length, байты между старой и новой длинами считываются как нули. У процесса должно быть разрешение на запись файла.

Если запрос приведет к тому, что размер файла превысит предельный размер файла для процесса, запрос завершится неудачно, и реализация сгенерирует сигнал SIGXFSZ для процесса.

Эта функция не изменяет смещение в файле для любых открытых файловых дескрипторов, связанных с файлом. При успешном завершении, если размер файла изменен, truncate() помечает для обновления поля st_ctime и st_mtime файла, а если файл является обычным файлом, биты S_ISSUED и S_SGID режима файла могут быть сброшены.

Возвращаемое значение:

0
Успешное завершение.
-1
Возникла ошибка. Код ошибки записан в errno.

Коды ошибок:

EACCES
Компонент префикса пути отклоняет разрешение на поиск или недостаточно прав для записи в этот файл.
EFAULT
Аргумент path указывает на область памяти, находящуюся вне адресного пространства процесса.
EFBIG
Аргумент length больше, чем максимальный размер файла.
EINTR
Во время обработки был получен сигнал.
EINVAL
Аргумент length некорректен, либо аргумент path не указывает на обычный файл.
EIO
Ошибка ввода-вывода при чтении или записи в файловую систему.
EISDIR
Указанный файл является директорией.
ELOOP
Слишком много символических ссылок при разрешении пути path.
EMFILE
Достигнут предел количества файловых дескрипторов, доступных процессу.
EMULTIHOP
Компоненты пути path требуют перехода к нескольким удалённым машинам, а тип файловой системы не позволяет это сделать.
ENAMETOOLONG
Длина переданного имени пути превышает PATH_MAX байт, или длина компоненты пути превышает NAME_MAX байт.
ENFILE
Не удалось выделить дополнительное место для таблицы системных файлов.
ENOENT
Компонент пути path не указывает на существующий файл или путь или является пустой строкой.
ENOLINK
Аргумент path указывает на удалённую машину, а соединение с этой машиной более неактивно.
ENOTDIR
Компонент пути path не является директорией.
EROFS
Указанный файл находится в файловой системе, доступной только для чтения.

Классификация:

POSIX 1003.1 XSI

Точка остановки потока
Да
Обработчик прерываний
Нет
Обработчик сигналов
Да
В потоке
Да

Тематические ссылки:

chmod(), fcntl(), ftruncate(), open()




Предыдущий раздел: Описание API системной библиотеки