Differences between current version and revision by previous author of llseek(2).
Other diffs: Previous Major Revision, Previous Revision, or view the Annotated Edit History
Newer page: | version 3 | Last edited on Monday, June 6, 2005 12:43:06 pm | by PerryLorier | |
Older page: | version 1 | Last edited on Tuesday, June 4, 2002 12:23:42 am | by perry | Revert |
@@ -1,77 +1,28 @@
-LLSEEK
-!!!LLSEEK
-NAME
-SYNOPSIS
-DESCRIPTION
-RETURN VALUE
-ERRORS
-CONFORMING TO
-BUGS
-SEE ALSO
-----
!!NAME
-
-
_llseek - reposition read/write file offset
!!SYNOPSIS
+ #include <unistd.h>
+ #include <linux/unistd.h>
+ ___syscall5(int, _llseek, uint, fd, ulong, hi, ulong, lo, loff_t *, res, uint, wh);__
-__#include
__
+
__int _llseek(unsigned int__ ''fd''__, unsigned long__ ''offset_high''__, unsigned long__ ''offset_low''__, loff_t *__''result''__, unsigned int__ ''whence''__);
__
-
-__#include __
-
-
-___syscall5(int, _llseek, uint, fd, ulong, hi, ulong, lo,
-loff_t *, res, uint, wh);__
-
-
-__int _llseek(unsigned int__ ''fd''__, unsigned
-long__ ''offset_high''__, unsigned long__
-''offset_low''__, loff_t *__''result''__, unsigned
-int__ ''whence''__);__
!!DESCRIPTION
+The ___llseek__ function repositions the offset of the file descriptor ''fd'' to ''(offset_high '' bytes relative to the beginning of the file, the current position in the file, or the end of the file, depending on whether ''whence'' is __SEEK_SET__, __SEEK_CUR__, or __SEEK_END__, respectively. It returns the resulting file position in the argument ''result''.
-
-The ___llseek__ function repositions the offset of the
-file descriptor ''fd'' to ''(offset_high
-'' bytes relative to the beginning of the file,
-the current position in the file, or the end of the file,
-depending on whether ''whence'' is __SEEK_SET__,
-__SEEK_CUR__, or __SEEK_END__, respectively. It
-returns the resulting file position in the argument
-''result''.
!!RETURN VALUE
+Upon successful completion, ___llseek__ returns 0. Otherwise, a value of -1 is returned and ''errno'' is set to indicate the error.
-
-Upon successful completion, ___llseek__ returns 0.
-Otherwise, a value of -1 is returned and ''errno'' is set
-to indicate the error.
!!ERRORS
+;[EBADF]: ''fd'' is not an open file descriptor.
+;[EINVAL]: ''whence'' is invalid.
-
-__EBADF__
-
-
-''fd'' is not an open file descriptor.
-
-
-__EINVAL__
-
-
-''whence'' is invalid.
!!CONFORMING TO
+This function is Linux-specific, and should not be used in programs intended to be portable.
-
-This function is Linux-specific, and should not be used in
-programs intended to be portable.
!!BUGS
+Linux prior to 2.4 does not support files with a size of 2GB or more. Some librarys may not support large files unless compiled on a 2.4 kernel.
-
-The ext2 filesystem does not support files with a size of
-2GB or more.
!!SEE ALSO
-
-
lseek(2)
-----