1f65a228fSRobert Mustacchi.\"
2f65a228fSRobert Mustacchi.\"
3f65a228fSRobert Mustacchi.\" The contents of this file are subject to the terms of the
4f65a228fSRobert Mustacchi.\" Common Development and Distribution License (the "License").
5f65a228fSRobert Mustacchi.\" You may not use this file except in compliance with the License.
6f65a228fSRobert Mustacchi.\"
7f65a228fSRobert Mustacchi.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
8f65a228fSRobert Mustacchi.\" or http://www.opensolaris.org/os/licensing.
9f65a228fSRobert Mustacchi.\" See the License for the specific language governing permissions
10f65a228fSRobert Mustacchi.\" and limitations under the License.
11f65a228fSRobert Mustacchi.\"
12f65a228fSRobert Mustacchi.\" When distributing Covered Code, include this CDDL HEADER in each
13f65a228fSRobert Mustacchi.\" file and include the License file at usr/src/OPENSOLARIS.LICENSE.
14f65a228fSRobert Mustacchi.\" If applicable, add the following below this CDDL HEADER, with the
15f65a228fSRobert Mustacchi.\" fields enclosed by brackets "[]" replaced with your own identifying
16f65a228fSRobert Mustacchi.\" information: Portions Copyright [yyyy] [name of copyright owner]
17f65a228fSRobert Mustacchi.\"
18f65a228fSRobert Mustacchi.\" Copyright 1989 AT&T
19f65a228fSRobert Mustacchi.\" Copyright (c) 2005, Sun Microsystems, Inc.  All Rights Reserved
20f65a228fSRobert Mustacchi.\" Copyright 2020 Robert Mustacchi
21f65a228fSRobert Mustacchi.\"
22f65a228fSRobert Mustacchi.Dd "March 25, 2020"
23f65a228fSRobert Mustacchi.Dt FERROR 3C
24f65a228fSRobert Mustacchi.Os
25f65a228fSRobert Mustacchi.Sh NAME
26f65a228fSRobert Mustacchi.Nm ferror ,
27f65a228fSRobert Mustacchi.Nm feof ,
28f65a228fSRobert Mustacchi.Nm clearerr ,
29f65a228fSRobert Mustacchi.Nm fileno
30f65a228fSRobert Mustacchi.Nd stream status inquiries
31f65a228fSRobert Mustacchi.Sh SYNOPSIS
32f65a228fSRobert Mustacchi.In stdio.h
33f65a228fSRobert Mustacchi.Ft int
34f65a228fSRobert Mustacchi.Fo ferror
35f65a228fSRobert Mustacchi.Fa "FILE *stream"
36f65a228fSRobert Mustacchi.Fc
37f65a228fSRobert Mustacchi.Ft int
38f65a228fSRobert Mustacchi.Fo feof
39f65a228fSRobert Mustacchi.Fa "FILE *stream"
40f65a228fSRobert Mustacchi.Fc
41f65a228fSRobert Mustacchi.Ft void
42f65a228fSRobert Mustacchi.Fo clearerr
43f65a228fSRobert Mustacchi.Fa "FILE *stream"
44f65a228fSRobert Mustacchi.Fc
45f65a228fSRobert Mustacchi.Ft int
46f65a228fSRobert Mustacchi.Fo fileno
47f65a228fSRobert Mustacchi.Fa "FILE *stream"
48f65a228fSRobert Mustacchi.Fc
49f65a228fSRobert Mustacchi.Sh DESCRIPTION
50f65a228fSRobert MustacchiThe
51f65a228fSRobert Mustacchi.Fn ferror
52f65a228fSRobert Mustacchifunction returns a non-zero value when an error has
53f65a228fSRobert Mustacchipreviously occurred reading from or writing to the named
54f65a228fSRobert Mustacchi.Fa stream
55f65a228fSRobert Mustacchi.Po
56f65a228fSRobert Mustacchisee
57f65a228fSRobert Mustacchi.Xr Intro 3
58f65a228fSRobert Mustacchi.Pc .
59f65a228fSRobert MustacchiIt returns
60f65a228fSRobert Mustacchi.Sy 0
61f65a228fSRobert Mustacchiotherwise.
62f65a228fSRobert Mustacchi.Pp
63f65a228fSRobert MustacchiThe
64f65a228fSRobert Mustacchi.Fn feof
65f65a228fSRobert Mustacchifunction returns a non-zero value when
66f65a228fSRobert Mustacchi.Sy EOF
67f65a228fSRobert Mustacchihas previously been detected reading the named input
68f65a228fSRobert Mustacchi.Fa stream .
69f65a228fSRobert MustacchiIt returns
70f65a228fSRobert Mustacchi.Sy 0
71f65a228fSRobert Mustacchiotherwise.
72f65a228fSRobert Mustacchi.Pp
73f65a228fSRobert MustacchiThe
74f65a228fSRobert Mustacchi.Fn clearerr
75f65a228fSRobert Mustacchifunction resets the error indicator and
76f65a228fSRobert Mustacchi.Sy EOF
77f65a228fSRobert Mustacchiindicator to 0 on the named
78f65a228fSRobert Mustacchi.Fa stream .
79f65a228fSRobert Mustacchi.Pp
80f65a228fSRobert MustacchiThe
81f65a228fSRobert Mustacchi.Fn fileno
82f65a228fSRobert Mustacchifunction returns the integer file descriptor associated with
83f65a228fSRobert Mustacchithe named
84f65a228fSRobert Mustacchi.Fa stream ;
85f65a228fSRobert Mustacchisee
86f65a228fSRobert Mustacchi.Xr open 2 .
87f65a228fSRobert MustacchiStreams that are not associated with a file descriptor such as those
88f65a228fSRobert Mustacchithat were created through the
89f65a228fSRobert Mustacchi.Xr fmemopen 3C
90f65a228fSRobert Mustacchior
91f65a228fSRobert Mustacchi.Xr open_memstream 3C
92f65a228fSRobert Mustacchifunctions will return
93f65a228fSRobert Mustacchi.Sy -1 .
94f65a228fSRobert Mustacchi.Sh INTERFACE STABILITY
95f65a228fSRobert Mustacchi.Sy Standard
96f65a228fSRobert Mustacchi.Sh MT-LEVEL
97f65a228fSRobert Mustacchi.Sy MT-Safe
98f65a228fSRobert Mustacchi.Sh SEE ALSO
99f65a228fSRobert Mustacchi.Xr Intro 2 ,
100f65a228fSRobert Mustacchi.Xr open 2 ,
101f65a228fSRobert Mustacchi.Xr fmemopen 3C ,
102f65a228fSRobert Mustacchi.Xr fopen 3C ,
103f65a228fSRobert Mustacchi.Xr open_memstream 3C ,
104f65a228fSRobert Mustacchi.Xr stdio 3C
105