418b9db49fbc652ef9c3f030fdc0f1a322403d95vboxsync/* $Id$ */
418b9db49fbc652ef9c3f030fdc0f1a322403d95vboxsync/** @file
418b9db49fbc652ef9c3f030fdc0f1a322403d95vboxsync * IPRT - Memory Management.
418b9db49fbc652ef9c3f030fdc0f1a322403d95vboxsync */
418b9db49fbc652ef9c3f030fdc0f1a322403d95vboxsync
418b9db49fbc652ef9c3f030fdc0f1a322403d95vboxsync/*
418b9db49fbc652ef9c3f030fdc0f1a322403d95vboxsync * Copyright (C) 2010 Oracle Corporation
418b9db49fbc652ef9c3f030fdc0f1a322403d95vboxsync *
418b9db49fbc652ef9c3f030fdc0f1a322403d95vboxsync * This file is part of VirtualBox Open Source Edition (OSE), as
418b9db49fbc652ef9c3f030fdc0f1a322403d95vboxsync * available from http://www.virtualbox.org. This file is free software;
418b9db49fbc652ef9c3f030fdc0f1a322403d95vboxsync * you can redistribute it and/or modify it under the terms of the GNU
418b9db49fbc652ef9c3f030fdc0f1a322403d95vboxsync * General Public License (GPL) as published by the Free Software
418b9db49fbc652ef9c3f030fdc0f1a322403d95vboxsync * Foundation, in version 2 as it comes in the "COPYING" file of the
418b9db49fbc652ef9c3f030fdc0f1a322403d95vboxsync * VirtualBox OSE distribution. VirtualBox OSE is distributed in the
418b9db49fbc652ef9c3f030fdc0f1a322403d95vboxsync * hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
418b9db49fbc652ef9c3f030fdc0f1a322403d95vboxsync *
418b9db49fbc652ef9c3f030fdc0f1a322403d95vboxsync * The contents of this file may alternatively be used under the terms
418b9db49fbc652ef9c3f030fdc0f1a322403d95vboxsync * of the Common Development and Distribution License Version 1.0
418b9db49fbc652ef9c3f030fdc0f1a322403d95vboxsync * (CDDL) only, as it comes in the "COPYING.CDDL" file of the
418b9db49fbc652ef9c3f030fdc0f1a322403d95vboxsync * VirtualBox OSE distribution, in which case the provisions of the
418b9db49fbc652ef9c3f030fdc0f1a322403d95vboxsync * CDDL are applicable instead of those of the GPL.
418b9db49fbc652ef9c3f030fdc0f1a322403d95vboxsync *
418b9db49fbc652ef9c3f030fdc0f1a322403d95vboxsync * You may elect to license modified versions of this file under the
418b9db49fbc652ef9c3f030fdc0f1a322403d95vboxsync * terms and conditions of either the GPL or the CDDL or both.
418b9db49fbc652ef9c3f030fdc0f1a322403d95vboxsync */
418b9db49fbc652ef9c3f030fdc0f1a322403d95vboxsync
418b9db49fbc652ef9c3f030fdc0f1a322403d95vboxsync#ifndef ___internal_mem_h
418b9db49fbc652ef9c3f030fdc0f1a322403d95vboxsync#define ___internal_mem_h
418b9db49fbc652ef9c3f030fdc0f1a322403d95vboxsync
418b9db49fbc652ef9c3f030fdc0f1a322403d95vboxsync#include <iprt/cdefs.h>
418b9db49fbc652ef9c3f030fdc0f1a322403d95vboxsync
418b9db49fbc652ef9c3f030fdc0f1a322403d95vboxsyncRT_C_DECLS_BEGIN
418b9db49fbc652ef9c3f030fdc0f1a322403d95vboxsync
418b9db49fbc652ef9c3f030fdc0f1a322403d95vboxsync/**
418b9db49fbc652ef9c3f030fdc0f1a322403d95vboxsync * Special allocation method that does not have any IPRT dependencies.
418b9db49fbc652ef9c3f030fdc0f1a322403d95vboxsync *
418b9db49fbc652ef9c3f030fdc0f1a322403d95vboxsync * This is suitable for allocating memory for IPRT heaps, pools, caches, memory
418b9db49fbc652ef9c3f030fdc0f1a322403d95vboxsync * trackers, semaphores and similar that end up in bootstrap depencency hell
418b9db49fbc652ef9c3f030fdc0f1a322403d95vboxsync * otherwise.
418b9db49fbc652ef9c3f030fdc0f1a322403d95vboxsync *
418b9db49fbc652ef9c3f030fdc0f1a322403d95vboxsync * @returns Pointer to the allocated memory, NULL on failure. Must be freed by
418b9db49fbc652ef9c3f030fdc0f1a322403d95vboxsync * calling rtMemBaseFree().
418b9db49fbc652ef9c3f030fdc0f1a322403d95vboxsync * @param cb The number of bytes to allocate.
418b9db49fbc652ef9c3f030fdc0f1a322403d95vboxsync */
418b9db49fbc652ef9c3f030fdc0f1a322403d95vboxsyncDECLHIDDEN(void *) rtMemBaseAlloc(size_t cb);
418b9db49fbc652ef9c3f030fdc0f1a322403d95vboxsync
418b9db49fbc652ef9c3f030fdc0f1a322403d95vboxsync/**
418b9db49fbc652ef9c3f030fdc0f1a322403d95vboxsync * Frees memory allocated by rtInitAlloc().
418b9db49fbc652ef9c3f030fdc0f1a322403d95vboxsync *
418b9db49fbc652ef9c3f030fdc0f1a322403d95vboxsync * @param pv What rtInitAlloc() returned.
418b9db49fbc652ef9c3f030fdc0f1a322403d95vboxsync */
418b9db49fbc652ef9c3f030fdc0f1a322403d95vboxsyncDECLHIDDEN(void) rtMemBaseFree(void *pv);
418b9db49fbc652ef9c3f030fdc0f1a322403d95vboxsync
418b9db49fbc652ef9c3f030fdc0f1a322403d95vboxsync
418b9db49fbc652ef9c3f030fdc0f1a322403d95vboxsyncRT_C_DECLS_END
418b9db49fbc652ef9c3f030fdc0f1a322403d95vboxsync
418b9db49fbc652ef9c3f030fdc0f1a322403d95vboxsync#endif
418b9db49fbc652ef9c3f030fdc0f1a322403d95vboxsync