code.delx.au - refind/blob - filesystems/fsw_base.h

   1 /* $Id: fsw_base.h 29125 2010-05-06 09:43:05Z vboxsync $ */
   2 /** @file
   3  * fsw_base.h - Base definitions switch.
   4  */
   5
   6 /*
   7  * Copyright (C) 2010 Oracle Corporation
   8  *
   9  * This file is part of VirtualBox Open Source Edition (OSE), as
  10  * available from http://www.virtualbox.org. This file is free software;
  11  * you can redistribute it and/or modify it under the terms of the GNU
  12  * General Public License (GPL) as published by the Free Software
  13  * Foundation, in version 2 as it comes in the "COPYING" file of the
  14  * VirtualBox OSE distribution. VirtualBox OSE is distributed in the
  15  * hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
  16  */
  17
  18 /*-
  19  * This code is based on:
  20  *
  21  * Copyright (c) 2006 Christoph Pfisterer
  22  *
  23  * Redistribution and use in source and binary forms, with or without
  24  * modification, are permitted provided that the following conditions are
  25  * met:
  26  *
  27  *  * Redistributions of source code must retain the above copyright
  28  *    notice, this list of conditions and the following disclaimer.
  29  *
  30  *  * Redistributions in binary form must reproduce the above copyright
  31  *    notice, this list of conditions and the following disclaimer in the
  32  *    documentation and/or other materials provided with the
  33  *    distribution.
  34  *
  35  *  * Neither the name of Christoph Pfisterer nor the names of the
  36  *    contributors may be used to endorse or promote products derived
  37  *    from this software without specific prior written permission.
  38  *
  39  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
  40  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
  41  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
  42  * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
  43  * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  44  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
  45  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  46  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  47  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  48  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
  49  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  50  */
  51
  52 #ifndef _FSW_BASE_H_
  53 #define _FSW_BASE_H_
  54 //#define HOST_EFI 1
  55 #define VBOX
  56
  57 #ifdef VBOX
  58 #include "VBoxFswParam.h"
  59 #endif
  60
  61 //#include <Protocol/MsgLog.h>
  62
  63 #ifndef FSW_DEBUG_LEVEL
  64 /**
  65  * Global debugging level. Can be set locally for the scope of a single
  66  * file by defining the macro before fsw_base.h is included.
  67  */
  68 #define FSW_DEBUG_LEVEL 0
  69 #endif
  70
  71
  72 #ifdef HOST_EFI
  73 #include "fsw_efi_base.h"
  74 #endif
  75
  76 #ifdef HOST_POSIX
  77 #include "fsw_posix_base.h"
  78 #endif
  79
  80 // message printing
  81
  82 #if FSW_DEBUG_LEVEL >= 1
  83 #define FSW_MSG_ASSERT(params) FSW_MSGFUNC params
  84 #else
  85 #define FSW_MSG_ASSERT(params)
  86 #endif
  87
  88 #if FSW_DEBUG_LEVEL >= 2
  89 #define FSW_MSG_DEBUG(params) FSW_MSGFUNC params
  90 #else
  91 #define FSW_MSG_DEBUG(params)
  92 #endif
  93
  94 #if FSW_DEBUG_LEVEL >= 3
  95 #define FSW_MSG_DEBUGV(params) FSW_MSGFUNC params
  96 #else
  97 #define FSW_MSG_DEBUGV(params)
  98 #endif
  99
 100
 101 // Documentation for system-dependent defines
 102
 103 /**
 104  * \typedef fsw_s8
 105  * Signed 8-bit integer.
 106  */
 107
 108 /**
 109  * \typedef fsw_u8
 110  * Unsigned 8-bit integer.
 111  */
 112
 113 /**
 114  * \typedef fsw_s16
 115  * Signed 16-bit integer.
 116  */
 117
 118 /**
 119  * \typedef fsw_u16
 120  * Unsigned 16-bit integer.
 121  */
 122
 123 /**
 124  * \typedef fsw_s32
 125  * Signed 32-bit integer.
 126  */
 127
 128 /**
 129  * \typedef fsw_u32
 130  * Unsigned 32-bit integer.
 131  */
 132
 133 /**
 134  * \typedef fsw_s64
 135  * Signed 64-bit integer.
 136  */
 137
 138 /**
 139  * \typedef fsw_u64
 140  * Unsigned 64-bit integer.
 141  */
 142
 143
 144 /**
 145  * \def fsw_alloc(size,ptrptr)
 146  * Allocate memory on the heap. This function or macro allocates \a size
 147  * bytes of memory using host-specific methods. The address of the
 148  * allocated memory block is stored into the pointer variable pointed
 149  * to by \a ptrptr. A status code is returned; FSW_SUCCESS if the block
 150  * was allocated or FSW_OUT_OF_MEMORY if there is not enough memory
 151  * to allocated the requested block.
 152  */
 153
 154 /**
 155  * \def fsw_free(ptr)
 156  * Release allocated memory. This function or macro returns an allocated
 157  * memory block to the heap for reuse. Does not return a status.
 158  */
 159
 160 /**
 161  * \def fsw_memcpy(dest,src,size)
 162  * Copies a block of memory from \a src to \a dest. The two memory blocks
 163  * must not overlap, or the result of the operation will be undefined.
 164  * Does not return a status.
 165  */
 166
 167 /**
 168  * \def fsw_memeq(dest,src,size)
 169  * Compares two blocks of memory for equality. Returns boolean true if the
 170  * memory blocks are equal, boolean false if they are different.
 171  */
 172
 173 /**
 174  * \def fsw_memzero(dest,size)
 175  * Initializes a block of memory with zeros. Does not return a status.
 176  */
 177
 178
 179 #endif