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
26extern void* malloc(size_t byte_count) __mallocfunc __wur __attribute__((alloc_size(1)));
27extern void* calloc(size_t item_count, size_t item_size) __mallocfunc __wur __attribute__((alloc_size(1,2)));
28extern void* realloc(void* p, size_t byte_count) __wur __attribute__((alloc_size(2)));
29extern void free(void* p);
30
31extern void* memalign(size_t alignment, size_t byte_count) __mallocfunc __wur __attribute__((alloc_size(2)));
32extern size_t malloc_usable_size(const void* p);
33
34#ifndef STRUCT_MALLINFO_DECLARED
35#define STRUCT_MALLINFO_DECLARED 1
36struct mallinfo {
37  size_t arena;    /* Total number of non-mmapped bytes currently allocated from OS. */
38  size_t ordblks;  /* Number of free chunks. */
39  size_t smblks;   /* (Unused.) */
40  size_t hblks;    /* (Unused.) */
41  size_t hblkhd;   /* Total number of bytes in mmapped regions. */
42  size_t usmblks;  /* Maximum total allocated space; greater than total if trimming has occurred. */
43  size_t fsmblks;  /* (Unused.) */
44  size_t uordblks; /* Total allocated space (normal or mmapped.) */
45  size_t fordblks; /* Total free space. */
46  size_t keepcost; /* Upper bound on number of bytes releasable by malloc_trim. */
47};
48#endif  /* STRUCT_MALLINFO_DECLARED */
49
50extern struct mallinfo mallinfo(void);
51
52/*
53 * XML structure for malloc_info(3) is in the following format:
54 *
55 * <malloc version="jemalloc-1">
56 *   <heap nr="INT">
57 *     <allocated-large>INT</allocated-large>
58 *     <allocated-huge>INT</allocated-huge>
59 *     <allocated-bins>INT</allocated-bins>
60 *     <bins-total>INT</bins-total>
61 *     <bin nr="INT">
62 *       <allocated>INT</allocated>
63 *       <nmalloc>INT</nmalloc>
64 *       <ndalloc>INT</ndalloc>
65 *     </bin>
66 *     <!-- more bins -->
67 *   </heap>
68 *   <!-- more heaps -->
69 * </malloc>
70 */
71extern int malloc_info(int, FILE *);
72
73__END_DECLS
74
75#endif  /* LIBC_INCLUDE_MALLOC_H_ */
76