Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
lseek(2)		      System Calls Manual		      lseek(2)

NAME
       lseek - move read/write file pointer; seek

SYNOPSIS
DESCRIPTION
       sets the	file pointer associated	with the file descriptor as follows:

	      o	 If whence is the pointer is set to offset bytes.

	      o	 If  whence is the pointer is set to its current location plus
		 offset.

	      o	 If whence is the pointer is set to the	size of	the file  plus
		 offset.

       These symbolic constants	are defined in

RETURN VALUE
       When  completes	successfully,  it returns an integer, which is the re-
       sulting file offset as measured in bytes	 from  the  beginning  of  the
       file.  Otherwise, a value of is returned	and is set to indicate the er-
       ror.

       For all files that are not character or block special files, the	 inte-
       ger  returned  on successful completion is non-negative.	 For character
       or block	special	files that correspond to disk sections larger  than  2
       gigabytes,  a non-negative integer is returned for successful seeks be-
       yond 2 gigabytes.  This value is	the resulting file offset as  measured
       in  bytes  from	the  beginning	of the file, when taken	as an unsigned
       value.  always indicates	an error  return,  even	 when  encountered  on
       greater	than  2	gigabyte disk sections.	 The call succeeds for NFS di-
       rectories even if the resulting file offset becomes negative.

ERRORS
       fails and the file offset remains unchanged if one or more of the  fol-
       lowing is true:

       [EBADF]	      fildes is	not an open file descriptor.

       [ESPIPE]	      fildes is	associated with	a pipe,	socket,	or FIFO.

       [EINVAL]	      whence is	not one	of the supported values.

       [EINVAL]	      The resulting file offset	would be negative.

       [EINVAL]	      The  resulting file offset would be a value which	cannot
		      be represented correctly in an object of type

WARNINGS
       Some devices are	incapable of seeking.  The value of  the  file	offset
       associated with such a device is	undefined.

       Using with a whence of on device	special	files is not supported and the
       results are not defined.

SEE ALSO
       creat(2), dup(2), fcntl(2), lseek64(2), open(2),	unistd(5).

STANDARDS CONFORMANCE
								      lseek(2)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | ERRORS | WARNINGS | SEE ALSO | STANDARDS CONFORMANCE

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=lseek&sektion=2&manpath=HP-UX+11.22>

home | help