diff options
Diffstat (limited to 'man2/llseek.2')
-rw-r--r-- | man2/llseek.2 | 79 |
1 files changed, 79 insertions, 0 deletions
diff --git a/man2/llseek.2 b/man2/llseek.2 new file mode 100644 index 000000000..d1e8ae5a2 --- /dev/null +++ b/man2/llseek.2 @@ -0,0 +1,79 @@ +.\" Copyright (C) 1995 Andries Brouwer (aeb@cwi.nl) +.\" +.\" Permission is granted to make and distribute verbatim copies of this +.\" manual provided the copyright notice and this permission notice are +.\" preserved on all copies. +.\" +.\" Permission is granted to copy and distribute modified versions of this +.\" manual under the conditions for verbatim copying, provided that the +.\" entire resulting derived work is distributed under the terms of a +.\" permission notice identical to this one. +.\" +.\" Since the Linux kernel and libraries are constantly changing, this +.\" manual page may be incorrect or out-of-date. The author(s) assume no +.\" responsibility for errors or omissions, or for damages resulting from +.\" the use of the information contained herein. The author(s) may not +.\" have taken the same level of care in the production of this manual, +.\" which is licensed free of charge, as they might when working +.\" professionally. +.\" +.\" Formatted or processed versions of this manual, if unaccompanied by +.\" the source, must acknowledge the copyright and authors of this work. +.\" +.\" Written 10 June 1995 by Andries Brouwer <aeb@cwi.nl> +.\" Modified Thu Oct 31 15:16:23 1996 by Eric S. Raymond <esr@thyrsus.com> +.\" +.TH LLSEEK 2 1995-06-10 "Linux 1.2.9" "Linux Programmer's Manual" +.SH NAME +_llseek \- reposition read/write file offset +.SH SYNOPSIS +.B #include <unistd.h> +.sp +.B #include <linux/unistd.h> +.sp +.B _syscall5(int, _llseek, uint, fd, ulong, hi, ulong, lo, loff_t *, res, uint, wh); +.sp +.BI "int _llseek(unsigned int " fd ", unsigned long " offset_high , +.BI "unsigned long " offset_low ", loff_t *" result ", unsigned int " whence ); +.SH DESCRIPTION +The +.B _llseek +function repositions the offset of the file descriptor +.I fd +to +.I (offset_high<<32) | offset_low +bytes relative to the beginning of the file, the current position in the file, +or the end of the file, depending on whether +.I whence +is +.BR SEEK_SET , +.BR SEEK_CUR , +or +.BR SEEK_END , +respectively. +It returns the resulting file position in the argument +.IR result . + +.SH "RETURN VALUE" +Upon successful completion, +.B _llseek +returns 0. Otherwise, a value of \-1 is returned and +.I errno +is set to indicate the error. +.SH ERRORS +.TP +.B EBADF +.I fd +is not an open file descriptor. +.TP +.B EFAULT +Problem with copying results to user space. +.TP +.B EINVAL +.I whence +is invalid. +.SH "CONFORMING TO" +This function is Linux-specific, and should not be used in programs +intended to be portable. +.SH "SEE ALSO" +.BR lseek (2) |