95c6cd753f
Historically we've made a few mistakes where they haven't matched the right number. And most non-Googlers are much more familiar with the numbers, so it seems to make sense to rely more on them. Especially in header files, which we actually expect real people to have to read from time to time. Test: treehugger Change-Id: I0d4a97454ee108de1d32f21df285315c5488d886
321 lines
12 KiB
C
321 lines
12 KiB
C
/* $OpenBSD: stdio.h,v 1.35 2006/01/13 18:10:09 miod Exp $ */
|
|
/* $NetBSD: stdio.h,v 1.18 1996/04/25 18:29:21 jtc Exp $ */
|
|
|
|
/*-
|
|
* Copyright (c) 1990 The Regents of the University of California.
|
|
* All rights reserved.
|
|
*
|
|
* This code is derived from software contributed to Berkeley by
|
|
* Chris Torek.
|
|
*
|
|
* Redistribution and use in source and binary forms, with or without
|
|
* modification, are permitted provided that the following conditions
|
|
* are met:
|
|
* 1. Redistributions of source code must retain the above copyright
|
|
* notice, this list of conditions and the following disclaimer.
|
|
* 2. Redistributions in binary form must reproduce the above copyright
|
|
* notice, this list of conditions and the following disclaimer in the
|
|
* documentation and/or other materials provided with the distribution.
|
|
* 3. Neither the name of the University nor the names of its contributors
|
|
* may be used to endorse or promote products derived from this software
|
|
* without specific prior written permission.
|
|
*
|
|
* THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
|
|
* ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
|
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
|
* ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
|
|
* FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
|
* DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
|
|
* OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
|
* HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
|
* 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.
|
|
*
|
|
* @(#)stdio.h 5.17 (Berkeley) 6/3/91
|
|
*/
|
|
|
|
#ifndef _STDIO_H_
|
|
#define _STDIO_H_
|
|
|
|
#include <sys/cdefs.h>
|
|
#include <sys/types.h>
|
|
|
|
#include <stdarg.h>
|
|
#include <stddef.h>
|
|
|
|
#include <bits/seek_constants.h>
|
|
|
|
#if __ANDROID_API__ < 24
|
|
#include <bits/struct_file.h>
|
|
#endif
|
|
|
|
__BEGIN_DECLS
|
|
|
|
typedef off_t fpos_t;
|
|
typedef off64_t fpos64_t;
|
|
|
|
struct __sFILE;
|
|
typedef struct __sFILE FILE;
|
|
|
|
#if __ANDROID_API__ >= 23
|
|
extern FILE* stdin __INTRODUCED_IN(23);
|
|
extern FILE* stdout __INTRODUCED_IN(23);
|
|
extern FILE* stderr __INTRODUCED_IN(23);
|
|
|
|
/* C99 and earlier plus current C++ standards say these must be macros. */
|
|
#define stdin stdin
|
|
#define stdout stdout
|
|
#define stderr stderr
|
|
#else
|
|
/* Before M the actual symbols for stdin and friends had different names. */
|
|
extern FILE __sF[] __REMOVED_IN(23);
|
|
|
|
#define stdin (&__sF[0])
|
|
#define stdout (&__sF[1])
|
|
#define stderr (&__sF[2])
|
|
#endif
|
|
|
|
/*
|
|
* The following three definitions are for ANSI C, which took them
|
|
* from System V, which brilliantly took internal interface macros and
|
|
* made them official arguments to setvbuf(), without renaming them.
|
|
* Hence, these ugly _IOxxx names are *supposed* to appear in user code.
|
|
*
|
|
* Although numbered as their counterparts above, the implementation
|
|
* does not rely on this.
|
|
*/
|
|
#define _IOFBF 0 /* setvbuf should set fully buffered */
|
|
#define _IOLBF 1 /* setvbuf should set line buffered */
|
|
#define _IONBF 2 /* setvbuf should set unbuffered */
|
|
|
|
#define BUFSIZ 1024 /* size of buffer used by setbuf */
|
|
#define EOF (-1)
|
|
|
|
/*
|
|
* FOPEN_MAX is a minimum maximum, and is the number of streams that
|
|
* stdio can provide without attempting to allocate further resources
|
|
* (which could fail). Do not use this for anything.
|
|
*/
|
|
#define FOPEN_MAX 20
|
|
#define FILENAME_MAX 4096
|
|
|
|
#define L_tmpnam 4096
|
|
#define TMP_MAX 308915776
|
|
|
|
void clearerr(FILE* __fp);
|
|
int fclose(FILE* __fp);
|
|
int feof(FILE* __fp);
|
|
int ferror(FILE* __fp);
|
|
int fflush(FILE* __fp);
|
|
int fgetc(FILE* __fp);
|
|
char* fgets(char* __buf, int __size, FILE* __fp);
|
|
int fprintf(FILE* __fp , const char* __fmt, ...) __printflike(2, 3);
|
|
int fputc(int __ch, FILE* __fp);
|
|
int fputs(const char* __s, FILE* __fp);
|
|
size_t fread(void* __buf, size_t __size, size_t __count, FILE* __fp);
|
|
int fscanf(FILE* __fp, const char* __fmt, ...) __scanflike(2, 3);
|
|
size_t fwrite(const void* __buf, size_t __size, size_t __count, FILE* __fp);
|
|
int getc(FILE* __fp);
|
|
int getchar(void);
|
|
ssize_t getdelim(char** __line_ptr, size_t* __line_length_ptr, int __delimiter, FILE* __fp) __INTRODUCED_IN(18);
|
|
ssize_t getline(char** __line_ptr, size_t* __line_length_ptr, FILE* __fp) __INTRODUCED_IN(18);
|
|
|
|
void perror(const char* __msg);
|
|
int printf(const char* __fmt, ...) __printflike(1, 2);
|
|
int putc(int __ch, FILE* __fp);
|
|
int putchar(int __ch);
|
|
int puts(const char* __s);
|
|
int remove(const char* __path);
|
|
void rewind(FILE* __fp);
|
|
int scanf(const char* __fmt, ...) __scanflike(1, 2);
|
|
void setbuf(FILE* __fp, char* __buf);
|
|
int setvbuf(FILE* __fp, char* __buf, int __mode, size_t __size);
|
|
int sscanf(const char* __s, const char* __fmt, ...) __scanflike(2, 3);
|
|
int ungetc(int __ch, FILE* __fp);
|
|
int vfprintf(FILE* __fp, const char* __fmt, va_list __args) __printflike(2, 0);
|
|
int vprintf(const char* __fp, va_list __args) __printflike(1, 0);
|
|
|
|
#if __ANDROID_API__ >= 21
|
|
int dprintf(int __fd, const char* __fmt, ...) __printflike(2, 3) __INTRODUCED_IN(21);
|
|
int vdprintf(int __fd, const char* __fmt, va_list __args) __printflike(2, 0) __INTRODUCED_IN(21);
|
|
#else
|
|
/*
|
|
* Old versions of Android called these fdprintf and vfdprintf out of fears that the glibc names
|
|
* would collide with user debug printfs.
|
|
*
|
|
* Allow users to just use dprintf and vfdprintf on any version by renaming those calls to their
|
|
* legacy equivalents if needed.
|
|
*/
|
|
int dprintf(int __fd, const char* __fmt, ...) __RENAME(fdprintf) __printflike(2, 3);
|
|
int vdprintf(int __fd, const char* __fmt, va_list __args) __RENAME(vfdprintf) __printflike(2, 0);
|
|
#endif
|
|
|
|
#if (defined(__STDC_VERSION__) && __STDC_VERSION__ < 201112L) || \
|
|
(defined(__cplusplus) && __cplusplus <= 201103L)
|
|
char* gets(char* __buf) __attribute__((deprecated("gets is unsafe, use fgets instead")));
|
|
#endif
|
|
int sprintf(char* __s, const char* __fmt, ...)
|
|
__printflike(2, 3) __warnattr_strict("sprintf is often misused; please use snprintf");
|
|
int vsprintf(char* __s, const char* __fmt, va_list __args)
|
|
__printflike(2, 0) __warnattr_strict("vsprintf is often misused; please use vsnprintf");
|
|
char* tmpnam(char* __s)
|
|
__warnattr("tempnam is unsafe, use mkstemp or tmpfile instead");
|
|
#define P_tmpdir "/tmp/" /* deprecated */
|
|
char* tempnam(const char* __dir, const char* __prefix)
|
|
__warnattr("tempnam is unsafe, use mkstemp or tmpfile instead");
|
|
|
|
/**
|
|
* [rename(2)](http://man7.org/linux/man-pages/man2/rename.2.html) changes
|
|
* the name or location of a file.
|
|
*
|
|
* Returns 0 on success, and returns -1 and sets `errno` on failure.
|
|
*/
|
|
int rename(const char* __old_path, const char* __new_path);
|
|
|
|
/**
|
|
* [renameat(2)](http://man7.org/linux/man-pages/man2/renameat.2.html) changes
|
|
* the name or location of a file, interpreting relative paths using an fd.
|
|
*
|
|
* Returns 0 on success, and returns -1 and sets `errno` on failure.
|
|
*/
|
|
int renameat(int __old_dir_fd, const char* __old_path, int __new_dir_fd, const char* __new_path);
|
|
|
|
#if defined(__USE_GNU)
|
|
|
|
/**
|
|
* Flag for [renameat2(2)](http://man7.org/linux/man-pages/man2/renameat2.2.html)
|
|
* to fail if the new path already exists.
|
|
*/
|
|
#define RENAME_NOREPLACE (1<<0)
|
|
|
|
/**
|
|
* Flag for [renameat2(2)](http://man7.org/linux/man-pages/man2/renameat2.2.html)
|
|
* to atomically exchange the two paths.
|
|
*/
|
|
#define RENAME_EXCHANGE (1<<1)
|
|
|
|
/**
|
|
* Flag for [renameat2(2)](http://man7.org/linux/man-pages/man2/renameat2.2.html)
|
|
* to create a union/overlay filesystem object.
|
|
*/
|
|
#define RENAME_WHITEOUT (1<<2)
|
|
|
|
/**
|
|
* [renameat2(2)](http://man7.org/linux/man-pages/man2/renameat2.2.html) changes
|
|
* the name or location of a file, interpreting relative paths using an fd,
|
|
* with optional `RENAME_` flags.
|
|
*
|
|
* Returns 0 on success, and returns -1 and sets `errno` on failure.
|
|
*/
|
|
int renameat2(int __old_dir_fd, const char* __old_path, int __new_dir_fd, const char* __new_path, unsigned __flags) __INTRODUCED_IN(30);
|
|
|
|
#endif
|
|
|
|
int fseek(FILE* __fp, long __offset, int __whence);
|
|
long ftell(FILE* __fp);
|
|
|
|
/* See https://android.googlesource.com/platform/bionic/+/master/docs/32-bit-abi.md */
|
|
#if defined(__USE_FILE_OFFSET64)
|
|
int fgetpos(FILE* __fp, fpos_t* __pos) __RENAME(fgetpos64) __INTRODUCED_IN(24);
|
|
int fsetpos(FILE* __fp, const fpos_t* __pos) __RENAME(fsetpos64) __INTRODUCED_IN(24);
|
|
int fseeko(FILE* __fp, off_t __offset, int __whence) __RENAME(fseeko64) __INTRODUCED_IN(24);
|
|
off_t ftello(FILE* __fp) __RENAME(ftello64) __INTRODUCED_IN(24);
|
|
# if defined(__USE_BSD)
|
|
FILE* funopen(const void* __cookie,
|
|
int (*__read_fn)(void*, char*, int),
|
|
int (*__write_fn)(void*, const char*, int),
|
|
fpos_t (*__seek_fn)(void*, fpos_t, int),
|
|
int (*__close_fn)(void*)) __RENAME(funopen64) __INTRODUCED_IN(24);
|
|
# endif
|
|
#else
|
|
int fgetpos(FILE* __fp, fpos_t* __pos);
|
|
int fsetpos(FILE* __fp, const fpos_t* __pos);
|
|
int fseeko(FILE* __fp, off_t __offset, int __whence);
|
|
off_t ftello(FILE* __fp);
|
|
# if defined(__USE_BSD)
|
|
FILE* funopen(const void* __cookie,
|
|
int (*__read_fn)(void*, char*, int),
|
|
int (*__write_fn)(void*, const char*, int),
|
|
fpos_t (*__seek_fn)(void*, fpos_t, int),
|
|
int (*__close_fn)(void*));
|
|
# endif
|
|
#endif
|
|
int fgetpos64(FILE* __fp, fpos64_t* __pos) __INTRODUCED_IN(24);
|
|
int fsetpos64(FILE* __fp, const fpos64_t* __pos) __INTRODUCED_IN(24);
|
|
int fseeko64(FILE* __fp, off64_t __offset, int __whence) __INTRODUCED_IN(24);
|
|
off64_t ftello64(FILE* __fp) __INTRODUCED_IN(24);
|
|
#if defined(__USE_BSD)
|
|
FILE* funopen64(const void* __cookie,
|
|
int (*__read_fn)(void*, char*, int),
|
|
int (*__write_fn)(void*, const char*, int),
|
|
fpos64_t (*__seek_fn)(void*, fpos64_t, int),
|
|
int (*__close_fn)(void*)) __INTRODUCED_IN(24);
|
|
#endif
|
|
|
|
FILE* fopen(const char* __path, const char* __mode);
|
|
FILE* fopen64(const char* __path, const char* __mode) __INTRODUCED_IN(24);
|
|
FILE* freopen(const char* __path, const char* __mode, FILE* __fp);
|
|
FILE* freopen64(const char* __path, const char* __mode, FILE* __fp) __INTRODUCED_IN(24);
|
|
FILE* tmpfile(void);
|
|
FILE* tmpfile64(void) __INTRODUCED_IN(24);
|
|
|
|
int snprintf(char* __buf, size_t __size, const char* __fmt, ...) __printflike(3, 4);
|
|
int vfscanf(FILE* __fp, const char* __fmt, va_list __args) __scanflike(2, 0);
|
|
int vscanf(const char* __fmt , va_list __args) __scanflike(1, 0);
|
|
int vsnprintf(char* __buf, size_t __size, const char* __fmt, va_list __args) __printflike(3, 0);
|
|
int vsscanf(const char* __s, const char* __fmt, va_list __args) __scanflike(2, 0);
|
|
|
|
#define L_ctermid 1024 /* size for ctermid() */
|
|
char* ctermid(char* __buf) __INTRODUCED_IN(26);
|
|
|
|
FILE* fdopen(int __fd, const char* __mode);
|
|
int fileno(FILE* __fp);
|
|
int pclose(FILE* __fp);
|
|
FILE* popen(const char* __command, const char* __mode);
|
|
void flockfile(FILE* __fp);
|
|
int ftrylockfile(FILE* __fp);
|
|
void funlockfile(FILE* __fp);
|
|
int getc_unlocked(FILE* __fp);
|
|
int getchar_unlocked(void);
|
|
int putc_unlocked(int __ch, FILE* __fp);
|
|
int putchar_unlocked(int __ch);
|
|
|
|
FILE* fmemopen(void* __buf, size_t __size, const char* __mode) __INTRODUCED_IN(23);
|
|
FILE* open_memstream(char** __ptr, size_t* __size_ptr) __INTRODUCED_IN(23);
|
|
|
|
#if defined(__USE_BSD) || defined(__BIONIC__) /* Historically bionic exposed these. */
|
|
int asprintf(char** __s_ptr, const char* __fmt, ...) __printflike(2, 3);
|
|
char* fgetln(FILE* __fp, size_t* __length_ptr);
|
|
int fpurge(FILE* __fp);
|
|
void setbuffer(FILE* __fp, char* __buf, int __size);
|
|
int setlinebuf(FILE* __fp);
|
|
int vasprintf(char** __s_ptr, const char* __fmt, va_list __args) __printflike(2, 0);
|
|
void clearerr_unlocked(FILE* __fp) __INTRODUCED_IN(23);
|
|
int feof_unlocked(FILE* __fp) __INTRODUCED_IN(23);
|
|
int ferror_unlocked(FILE* __fp) __INTRODUCED_IN(23);
|
|
int fileno_unlocked(FILE* __fp) __INTRODUCED_IN(24);
|
|
#define fropen(cookie, fn) funopen(cookie, fn, 0, 0, 0)
|
|
#define fwopen(cookie, fn) funopen(cookie, 0, fn, 0, 0)
|
|
#endif
|
|
|
|
#if defined(__USE_BSD)
|
|
int fflush_unlocked(FILE* __fp) __INTRODUCED_IN(28);
|
|
int fgetc_unlocked(FILE* __fp) __INTRODUCED_IN(28);
|
|
int fputc_unlocked(int __ch, FILE* __fp) __INTRODUCED_IN(28);
|
|
size_t fread_unlocked(void* __buf, size_t __size, size_t __count, FILE* __fp) __INTRODUCED_IN(28);
|
|
size_t fwrite_unlocked(const void* __buf, size_t __size, size_t __count, FILE* __fp) __INTRODUCED_IN(28);
|
|
#endif
|
|
|
|
#if defined(__USE_GNU)
|
|
int fputs_unlocked(const char* __s, FILE* __fp) __INTRODUCED_IN(28);
|
|
char* fgets_unlocked(char* __buf, int __size, FILE* __fp) __INTRODUCED_IN(28);
|
|
#endif
|
|
|
|
#if defined(__BIONIC_INCLUDE_FORTIFY_HEADERS)
|
|
#include <bits/fortify/stdio.h>
|
|
#endif
|
|
|
|
__END_DECLS
|
|
|
|
#endif
|