xref: /openbmc/qemu/include/sysemu/os-posix.h (revision f49986ae)
1 /*
2  * posix specific declarations
3  *
4  * Copyright (c) 2003-2008 Fabrice Bellard
5  * Copyright (c) 2010 Jes Sorensen <Jes.Sorensen@redhat.com>
6  *
7  * Permission is hereby granted, free of charge, to any person obtaining a copy
8  * of this software and associated documentation files (the "Software"), to deal
9  * in the Software without restriction, including without limitation the rights
10  * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
11  * copies of the Software, and to permit persons to whom the Software is
12  * furnished to do so, subject to the following conditions:
13  *
14  * The above copyright notice and this permission notice shall be included in
15  * all copies or substantial portions of the Software.
16  *
17  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
18  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
19  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
20  * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
21  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
22  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
23  * THE SOFTWARE.
24  */
25 
26 #ifndef QEMU_OS_POSIX_H
27 #define QEMU_OS_POSIX_H
28 
29 #include <sys/mman.h>
30 #include <sys/socket.h>
31 #include <netinet/in.h>
32 #include <netinet/tcp.h>
33 #include <arpa/inet.h>
34 #include <netdb.h>
35 #include <sys/un.h>
36 
37 #ifdef CONFIG_SYSMACROS
38 #include <sys/sysmacros.h>
39 #endif
40 
41 #ifdef __cplusplus
42 extern "C" {
43 #endif
44 
45 void os_set_line_buffering(void);
46 void os_setup_early_signal_handling(void);
47 void os_set_proc_name(const char *s);
48 void os_setup_signal_handling(void);
49 int os_set_daemonize(bool d);
50 bool is_daemonized(void);
51 void os_daemonize(void);
52 bool os_set_runas(const char *user_id);
53 void os_set_chroot(const char *path);
54 void os_setup_post(void);
55 int os_mlock(void);
56 
57 /**
58  * qemu_alloc_stack:
59  * @sz: pointer to a size_t holding the requested usable stack size
60  *
61  * Allocate memory that can be used as a stack, for instance for
62  * coroutines. If the memory cannot be allocated, this function
63  * will abort (like g_malloc()). This function also inserts an
64  * additional guard page to catch a potential stack overflow.
65  * Note that the memory required for the guard page and alignment
66  * and minimal stack size restrictions will increase the value of sz.
67  *
68  * The allocated stack must be freed with qemu_free_stack().
69  *
70  * Returns: pointer to (the lowest address of) the stack memory.
71  */
72 void *qemu_alloc_stack(size_t *sz);
73 
74 /**
75  * qemu_free_stack:
76  * @stack: stack to free
77  * @sz: size of stack in bytes
78  *
79  * Free a stack allocated via qemu_alloc_stack(). Note that sz must
80  * be exactly the adjusted stack size returned by qemu_alloc_stack.
81  */
82 void qemu_free_stack(void *stack, size_t sz);
83 
84 /* POSIX and Mingw32 differ in the name of the stdio lock functions.  */
85 
86 static inline void qemu_flockfile(FILE *f)
87 {
88     flockfile(f);
89 }
90 
91 static inline void qemu_funlockfile(FILE *f)
92 {
93     funlockfile(f);
94 }
95 
96 #ifdef __cplusplus
97 }
98 #endif
99 
100 #endif
101