Home | History | Annotate | Download | only in include
      1 /******************************************************************************
      2  *
      3  *  Copyright 2014 Google, Inc.
      4  *
      5  *  Licensed under the Apache License, Version 2.0 (the "License");
      6  *  you may not use this file except in compliance with the License.
      7  *  You may obtain a copy of the License at:
      8  *
      9  *  http://www.apache.org/licenses/LICENSE-2.0
     10  *
     11  *  Unless required by applicable law or agreed to in writing, software
     12  *  distributed under the License is distributed on an "AS IS" BASIS,
     13  *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
     14  *  See the License for the specific language governing permissions and
     15  *  limitations under the License.
     16  *
     17  ******************************************************************************/
     18 
     19 #pragma once
     20 
     21 #include <stddef.h>
     22 #include <stdint.h>
     23 #include <stdlib.h>
     24 
     25 typedef void* (*alloc_fn)(size_t size);
     26 typedef void (*free_fn)(void* ptr);
     27 
     28 typedef struct {
     29   alloc_fn alloc;
     30   free_fn free;
     31 } allocator_t;
     32 
     33 // allocator_t abstractions for the osi_*alloc and osi_free functions
     34 extern const allocator_t allocator_malloc;
     35 extern const allocator_t allocator_calloc;
     36 
     37 char* osi_strdup(const char* str);
     38 char* osi_strndup(const char* str, size_t len);
     39 
     40 void* osi_malloc(size_t size);
     41 void* osi_calloc(size_t size);
     42 void osi_free(void* ptr);
     43 
     44 // Free a buffer that was previously allocated with function |osi_malloc|
     45 // or |osi_calloc| and reset the pointer to that buffer to NULL.
     46 // |p_ptr| is a pointer to the buffer pointer to be reset.
     47 // |p_ptr| cannot be NULL.
     48 void osi_free_and_reset(void** p_ptr);
     49 
     50 // Dump allocation-related statistics and debug info to the |fd| file
     51 // descriptor.
     52 // The information is in user-readable text format. The |fd| must be valid.
     53 void osi_allocator_debug_dump(int fd);
     54