1 /*
2  * Copyright (C) 2012 The Android Open Source Project
3  *
4  * Licensed under the Apache License, Version 2.0 (the "License");
5  * you may not use this file except in compliance with the License.
6  * You may obtain a copy of the License at
7  *
8  *      http://www.apache.org/licenses/LICENSE-2.0
9  *
10  * Unless required by applicable law or agreed to in writing, software
11  * distributed under the License is distributed on an "AS IS" BASIS,
12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13  * See the License for the specific language governing permissions and
14  * limitations under the License.
15  */
16 
17 #ifndef LIBC_INCLUDE_MALLOC_H_
18 #define LIBC_INCLUDE_MALLOC_H_
19 
20 #include <sys/cdefs.h>
21 #include <stddef.h>
22 #include <stdio.h>
23 
24 __BEGIN_DECLS
25 
26 #if defined(__clang__)
27 /* clang should support alloc_size in the nearish future. */
28 #if __has_attribute(alloc_size)
29 #error "We should enable alloc_size for clang."
30 #else
31 #define __BIONIC_ALLOC_SIZE(...)
32 #endif
33 #else
34 #define __BIONIC_ALLOC_SIZE(...) __attribute__((__alloc_size__(__VA_ARGS__)))
35 #endif
36 
37 void* malloc(size_t byte_count) __mallocfunc __BIONIC_ALLOC_SIZE(1) __wur;
38 void* calloc(size_t item_count, size_t item_size) __mallocfunc __BIONIC_ALLOC_SIZE(1,2) __wur;
39 void* realloc(void* p, size_t byte_count) __BIONIC_ALLOC_SIZE(2) __wur;
40 void free(void* p);
41 
42 void* memalign(size_t alignment, size_t byte_count) __mallocfunc __BIONIC_ALLOC_SIZE(2) __wur;
43 size_t malloc_usable_size(const void* p) __INTRODUCED_IN(17);
44 
45 #ifndef STRUCT_MALLINFO_DECLARED
46 #define STRUCT_MALLINFO_DECLARED 1
47 struct mallinfo {
48   size_t arena;    /* Total number of non-mmapped bytes currently allocated from OS. */
49   size_t ordblks;  /* Number of free chunks. */
50   size_t smblks;   /* (Unused.) */
51   size_t hblks;    /* (Unused.) */
52   size_t hblkhd;   /* Total number of bytes in mmapped regions. */
53   size_t usmblks;  /* Maximum total allocated space; greater than total if trimming has occurred. */
54   size_t fsmblks;  /* (Unused.) */
55   size_t uordblks; /* Total allocated space (normal or mmapped.) */
56   size_t fordblks; /* Total free space. */
57   size_t keepcost; /* Upper bound on number of bytes releasable by malloc_trim. */
58 };
59 #endif  /* STRUCT_MALLINFO_DECLARED */
60 
61 struct mallinfo mallinfo(void);
62 
63 /*
64  * XML structure for malloc_info(3) is in the following format:
65  *
66  * <malloc version="jemalloc-1">
67  *   <heap nr="INT">
68  *     <allocated-large>INT</allocated-large>
69  *     <allocated-huge>INT</allocated-huge>
70  *     <allocated-bins>INT</allocated-bins>
71  *     <bins-total>INT</bins-total>
72  *     <bin nr="INT">
73  *       <allocated>INT</allocated>
74  *       <nmalloc>INT</nmalloc>
75  *       <ndalloc>INT</ndalloc>
76  *     </bin>
77  *     <!-- more bins -->
78  *   </heap>
79  *   <!-- more heaps -->
80  * </malloc>
81  */
82 int malloc_info(int, FILE*) __INTRODUCED_IN(23);
83 
84 /* mallopt options */
85 #define M_DECAY_TIME -100
86 
87 int mallopt(int, int) __INTRODUCED_IN(26);
88 
89 __END_DECLS
90 
91 #endif  /* LIBC_INCLUDE_MALLOC_H_ */
92