OSDN Git Service

LDP: Update original to LDP v3.79
[linuxjm/LDP_man-pages.git] / original / man3 / fseek.3
index 334f202..60cef45 100644 (file)
@@ -5,6 +5,7 @@
 .\" Chris Torek and the American National Standards Committee X3,
 .\" on Information Processing Systems.
 .\"
+.\" %%%LICENSE_START(BSD_4_CLAUSE_UCB)
 .\" Redistribution and use in source and binary forms, with or without
 .\" modification, are permitted provided that the following conditions
 .\" are met:
 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
+.\" %%%LICENSE_END
 .\"
 .\"     @(#)fseek.3    6.11 (Berkeley) 6/29/91
 .\"
 .\" Converted for Linux, Mon Nov 29 15:22:01 1993, faith@cs.unc.edu
 .\"
-.TH FSEEK 3  1993-11-29 "GNU" "Linux Programmer's Manual"
+.TH FSEEK 3  2014-05-28 "GNU" "Linux Programmer's Manual"
 .SH NAME
 fgetpos, fseek, fsetpos, ftell, rewind \- reposition a stream
 .SH SYNOPSIS
@@ -51,7 +53,7 @@ fgetpos, fseek, fsetpos, ftell, rewind \- reposition a stream
 
 .BI "int fgetpos(FILE *" stream ", fpos_t *" pos );
 .br
-.BI "int fsetpos(FILE *" stream ", fpos_t *" pos );
+.BI "int fsetpos(FILE *" stream ", const fpos_t *" pos );
 .SH DESCRIPTION
 The
 .BR fseek ()
@@ -105,16 +107,18 @@ functions are alternate interfaces equivalent to
 .BR ftell ()
 and
 .BR fseek ()
-(with whence set to
+(with
+.I whence
+set to
 .BR SEEK_SET ),
 setting and storing the current value of the file offset into or from the
 object referenced by
 .IR pos .
-On some non-UNIX systems an
+On some non-UNIX systems, an
 .I fpos_t
 object may be a complex object and these routines may be the only way to
 portably reposition a text stream.
-.SH "RETURN VALUE"
+.SH RETURN VALUE
 The
 .BR rewind ()
 function returns no value.
@@ -146,6 +150,7 @@ was not
 .BR SEEK_END ,
 or
 .BR SEEK_CUR .
+Or: the resulting file offset would be negative.
 .PP
 The functions
 .BR fgetpos (),
@@ -161,8 +166,17 @@ for any of the errors specified for the routines
 .BR lseek (2),
 and
 .BR malloc (3).
-.SH "CONFORMING TO"
+.SH CONFORMING TO
 C89, C99.
-.SH "SEE ALSO"
+.SH SEE ALSO
 .BR lseek (2),
 .BR fseeko (3)
+.SH COLOPHON
+This page is part of release 3.79 of the Linux
+.I man-pages
+project.
+A description of the project,
+information about reporting bugs,
+and the latest version of this page,
+can be found at
+\%http://www.kernel.org/doc/man\-pages/.