2. EL 7
  3. man-pages-ru
  4. lseek(2)

Scroll to navigation

LSEEK(2) Руководство программиста Linux LSEEK(2)

ИМЯ

lseek - изменяет файловое смещение, используемое при чтении/записи

ОБЗОР

#include <sys/types.h>
#include <unistd.h>

off_t lseek(int fd, off_t offset, int whence);

ОПИСАНИЕ

Функция lseek() устанавливает смещение в файловом дескрипторе fd в значение аргумента offset в соответствии с директивой whence, которая может принимать одно из следующих значений:

Установить смещение равным offset (в байтах).
Установить смещение равным текущему положению плюс offset (в байтах).
Установить смещение равным размеру файла плюс offset (в байтах).

Функция lseek() позволяет задавать смещение, которое будет находиться за существующим концом файла (но это не изменяет размер файла). Если позднее по этому смещению будут записаны данные, то последующее чтение в промежутке («дырке») от конца файла до этого смещения, будет возвращать нулевые байты ('\0'), пока в этот промежуток действительно не будут записаны данные.

Перемещения по данным файла и промежутки

Начиная с версии 3.1, в Linux поддерживаются следующие дополнительные значения whence:

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

В обоих, показанных выше, случаях, lseek() завершится с ошибкой, если offset указывает за конец файла.

Эти операции позволяют приложениям отображать промежутки в разреженно выделенном файле. Это может быть полезно для таких приложений, как инструменты резервного копирования файлов, которые могут выиграть в месте при создании резервных копий и сохранить промежутки, если у них есть механизм их обнаружения.

Для поддержки этих операций промежуток представляется последовательностью нулей, которые (обычно) физически не занимают места на носителе. Однако файловая система может не сообщать о промежутках, поэтому эти операции — не гарантируемый механизм отображения пространства носителя в файл (более того, последовательность нулей, которая на самом деле была записана на носитель, может не посчитаться промежутком). В простейшей реализации, файловая система может поддержать эти операции так: при SEEK_HOLE всегда возвращать смещение конца файла, а при SEEK_DATA всегда возвращать значение offset (т.е., даже если расположение, указанное offset, является промежутком, это можно считать данными, состоящими из последовательности нулей).

ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ

При успешном выполнении lseek() возвращает получившееся в результате смещение в байтах от начала файла. При ошибке возвращается значение (off_t) -1 и в errno записывается код ошибки.

ОШИБКИ

fd не является открытым файловым дескриптором.
Неправильное значение whence. Получается, что возвращаемое файловое смещение стало бы отрицательным или указывало бы за конец поверхности носителя.
Результирующие файловое смещение не может быть представлено типом off_t.
Значение fd связано с каналом, сокетом или FIFO.
Значение whence равно SEEK_DATA или SEEK_HOLE, и текущее файловое смещение указывает за конец файла.

СООТВЕТСТВИЕ СТАНДАРТАМ

SVr4, 4.3BSD, POSIX.1-2001.

Значения SEEK_DATA и SEEK_HOLE являются нестандартными расширениями, которые также есть в Solaris, FreeBSD и DragonFly BSD; их предложили включить в следующую редакцию POSIX (выпуск 8).

ЗАМЕЧАНИЯ

Некоторые устройства не могут выполнять смещения и в POSIX не указано какие устройства должны поддерживать lseek().

В Linux при использовании lseek() на терминальных устройствах tty возвращается ESPIPE.

Если вы будете конвертировать старый код, используйте вместо значений whence следующие макросы:

старое значение новое значение
0 SEEK_SET
1 SEEK_CUR
2 SEEK_END
L_SET SEEK_SET
L_INCR SEEK_CUR
L_XTND SEEK_END

Заметим, что файловые дескрипторы, созданные через dup(2) или fork(2), используют общий указатель на текущее положение в файле, так что позиционирование в таких файлах может приводить к состязательности процессов.

СМОТРИТЕ ТАКЖЕ

dup(2), fork(2), open(2), fseek(3), lseek64(3), posix_fallocate(3)

2011-09-25 Linux