15f1ab04193ad0130ca8204aadaceae083aca9881Feng Qian// Copyright (c) 2005, 2007, Google Inc. 28e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project// All rights reserved. 38e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project// 48e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project// Redistribution and use in source and binary forms, with or without 58e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project// modification, are permitted provided that the following conditions are 68e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project// met: 78e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project// 88e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project// * Redistributions of source code must retain the above copyright 98e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project// notice, this list of conditions and the following disclaimer. 108e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project// * Redistributions in binary form must reproduce the above 118e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project// copyright notice, this list of conditions and the following disclaimer 128e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project// in the documentation and/or other materials provided with the 138e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project// distribution. 148e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project// * Neither the name of Google Inc. nor the names of its 158e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project// contributors may be used to endorse or promote products derived from 168e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project// this software without specific prior written permission. 178e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project// 188e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 198e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 208e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR 218e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT 228e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, 238e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT 248e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 258e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 268e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 278e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE 288e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 298e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 308e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project// --- 318e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project// Author: Sanjay Ghemawat 328e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project// 338e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project// Routine that uses sbrk/mmap to allocate memory from the system. 348e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project// Useful for implementing malloc. 358e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 368e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project#ifndef TCMALLOC_SYSTEM_ALLOC_H__ 378e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project#define TCMALLOC_SYSTEM_ALLOC_H__ 388e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 398e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project// REQUIRES: "alignment" is a power of two or "0" to indicate default alignment 408e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project// 418e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project// Allocate and return "N" bytes of zeroed memory. 428e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project// 438e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project// If actual_bytes is NULL then the returned memory is exactly the 448e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project// requested size. If actual bytes is non-NULL then the allocator 458e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project// may optionally return more bytes than asked for (i.e. return an 468e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project// entire "huge" page if a huge page allocator is in use). 478e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project// 488e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project// The returned pointer is a multiple of "alignment" if non-zero. 498e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project// 508e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project// Returns NULL when out of memory. 518e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectextern void* TCMalloc_SystemAlloc(size_t bytes, size_t *actual_bytes, 528e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project size_t alignment = 0); 538e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 548e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project// This call is a hint to the operating system that the pages 558e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project// contained in the specified range of memory will not be used for a 568e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project// while, and can be released for use by other processes or the OS. 578e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project// Pages which are released in this way may be destroyed (zeroed) by 588e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project// the OS. The benefit of this function is that it frees memory for 598e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project// use by the system, the cost is that the pages are faulted back into 608e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project// the address space next time they are touched, which can impact 618e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project// performance. (Only pages fully covered by the memory region will 628e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project// be released, partial pages will not.) 638e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectextern void TCMalloc_SystemRelease(void* start, size_t length); 648e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 658e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectextern void TCMalloc_SystemCommit(void* start, size_t length); 668f72e70a9fd78eec56623b3a62e68f16b7b27e28Feng Qian 670bf48ef3be53ddaa52bbead65dfd75bf90e7a2b5Ben Murdoch#if !HAVE(MADV_FREE_REUSE) && !HAVE(MADV_DONTNEED) && !HAVE(MMAP) && !HAVE(VIRTUALALLOC) 688f72e70a9fd78eec56623b3a62e68f16b7b27e28Feng Qianinline void TCMalloc_SystemRelease(void*, size_t) { } 698f72e70a9fd78eec56623b3a62e68f16b7b27e28Feng Qian#endif 708f72e70a9fd78eec56623b3a62e68f16b7b27e28Feng Qian 718f72e70a9fd78eec56623b3a62e68f16b7b27e28Feng Qian#if !HAVE(VIRTUALALLOC) && !HAVE(MADV_FREE_REUSE) 728e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectinline void TCMalloc_SystemCommit(void*, size_t) { } 738e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project#endif 748e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 758e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project#endif /* TCMALLOC_SYSTEM_ALLOC_H__ */ 76