source: mainline/uspace/lib/c/include/stdio.h@ b538ca5c

lfn serial ticket/834-toolchain-update topic/msim-upgrade topic/simplify-dev-export
Last change on this file since b538ca5c was 79ae36dd, checked in by Martin Decky <martin@…>, 14 years ago

new async framework with integrated exchange tracking

  • strict isolation between low-level IPC and high-level async framework with integrated exchange tracking
    • each IPC connection is represented by an async_sess_t structure
    • each IPC exchange is represented by an async_exch_t structure
    • exchange management is either based on atomic messages (EXCHANGE_ATOMIC), locking (EXCHANGE_SERIALIZE) or connection cloning (EXCHANGE_CLONE)
  • async_obsolete: temporary compatibility layer to keep old async clients working (several pieces of code are currently broken, but only non-essential functionality)
  • IPC_M_PHONE_HANGUP is now method no. 0 (for elegant boolean evaluation)
  • IPC_M_DEBUG_ALL has been renamed to IPC_M_DEBUG
  • IPC_M_PING has been removed (VFS protocol now has VFS_IN_PING)
  • console routines in libc have been rewritten for better abstraction
  • additional use for libc-private header files (FILE structure opaque to the client)
  • various cstyle changes (typos, indentation, missing externs in header files, improved comments, etc.)
  • Property mode set to 100644
File size: 4.1 KB
Line 
1/*
2 * Copyright (c) 2005 Martin Decky
3 * All rights reserved.
4 *
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that the following conditions
7 * are met:
8 *
9 * - Redistributions of source code must retain the above copyright
10 * notice, this list of conditions and the following disclaimer.
11 * - Redistributions in binary form must reproduce the above copyright
12 * notice, this list of conditions and the following disclaimer in the
13 * documentation and/or other materials provided with the distribution.
14 * - The name of the author may not be used to endorse or promote products
15 * derived from this software without specific prior written permission.
16 *
17 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
18 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
19 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
20 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
21 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
22 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
23 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
24 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
25 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
26 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
27 */
28
29/** @addtogroup libc
30 * @{
31 */
32/** @file
33 */
34
35#ifndef LIBC_STDIO_H_
36#define LIBC_STDIO_H_
37
38#include <sys/types.h>
39#include <stdarg.h>
40#include <str.h>
41#include <adt/list.h>
42
43#ifndef NVERIFY_PRINTF
44
45#define PRINTF_ATTRIBUTE(start, end) \
46 __attribute__((format(gnu_printf, start, end)))
47
48#else /* NVERIFY_PRINTF */
49
50#define PRINTF_ATTRIBUTE(start, end)
51
52#endif /* NVERIFY_PRINTF */
53
54#define EOF (-1)
55
56/** Default size for stream I/O buffers */
57#define BUFSIZ 4096
58
59#define DEBUG(fmt, ...) \
60 { \
61 char _buf[256]; \
62 int _n = snprintf(_buf, sizeof(_buf), fmt, ##__VA_ARGS__); \
63 if (_n > 0) \
64 (void) __SYSCALL3(SYS_KLOG, 1, (sysarg_t) _buf, str_size(_buf)); \
65 }
66
67#ifndef SEEK_SET
68 #define SEEK_SET 0
69#endif
70
71#ifndef SEEK_CUR
72 #define SEEK_CUR 1
73#endif
74
75#ifndef SEEK_END
76 #define SEEK_END 2
77#endif
78
79enum _buffer_type {
80 /** No buffering */
81 _IONBF,
82 /** Line buffering */
83 _IOLBF,
84 /** Full buffering */
85 _IOFBF
86};
87
88enum _buffer_state {
89 /** Buffer is empty */
90 _bs_empty,
91
92 /** Buffer contains data to be written */
93 _bs_write,
94
95 /** Buffer contains prefetched data for reading */
96 _bs_read
97};
98
99/** Forward declaration */
100struct _IO_FILE;
101typedef struct _IO_FILE FILE;
102
103extern FILE *stdin;
104extern FILE *stdout;
105extern FILE *stderr;
106
107/* Character and string input functions */
108extern int fgetc(FILE *);
109extern char *fgets(char *, int, FILE *);
110
111extern int getchar(void);
112extern char *gets(char *, size_t);
113
114/* Character and string output functions */
115extern int fputc(wchar_t, FILE *);
116extern int fputs(const char *, FILE *);
117
118extern int putchar(wchar_t);
119extern int puts(const char *);
120
121/* Formatted string output functions */
122extern int fprintf(FILE *, const char*, ...)
123 PRINTF_ATTRIBUTE(2, 3);
124extern int vfprintf(FILE *, const char *, va_list);
125
126extern int printf(const char *, ...)
127 PRINTF_ATTRIBUTE(1, 2);
128extern int vprintf(const char *, va_list);
129
130extern int snprintf(char *, size_t , const char *, ...)
131 PRINTF_ATTRIBUTE(3, 4);
132extern int asprintf(char **, const char *, ...)
133 PRINTF_ATTRIBUTE(2, 3);
134extern int vsnprintf(char *, size_t, const char *, va_list);
135
136/* File stream functions */
137extern FILE *fopen(const char *, const char *);
138extern FILE *fdopen(int, const char *);
139extern int fclose(FILE *);
140
141extern size_t fread(void *, size_t, size_t, FILE *);
142extern size_t fwrite(const void *, size_t, size_t, FILE *);
143
144extern int fseek(FILE *, off64_t, int);
145extern void rewind(FILE *);
146extern off64_t ftell(FILE *);
147extern int feof(FILE *);
148extern int fileno(FILE *);
149
150extern int fflush(FILE *);
151extern int ferror(FILE *);
152extern void clearerr(FILE *);
153
154extern void setvbuf(FILE *, void *, int, size_t);
155
156/* Misc file functions */
157extern int rename(const char *, const char *);
158
159#endif
160
161/** @}
162 */
Note: See TracBrowser for help on using the repository browser.