magics.h revision 96d5bb6dc5895c648c1f60b3d4faef7b93404756
65c72795ab90d3daefa759b716fbb5c6352c7a56vboxsync * IPRT - Internal header defining The Magic Numbers.
65c72795ab90d3daefa759b716fbb5c6352c7a56vboxsync * Copyright (C) 2007-2008 Oracle Corporation
65c72795ab90d3daefa759b716fbb5c6352c7a56vboxsync * This file is part of VirtualBox Open Source Edition (OSE), as
65c72795ab90d3daefa759b716fbb5c6352c7a56vboxsync * available from http://www.virtualbox.org. This file is free software;
65c72795ab90d3daefa759b716fbb5c6352c7a56vboxsync * you can redistribute it and/or modify it under the terms of the GNU
65c72795ab90d3daefa759b716fbb5c6352c7a56vboxsync * General Public License (GPL) as published by the Free Software
65c72795ab90d3daefa759b716fbb5c6352c7a56vboxsync * Foundation, in version 2 as it comes in the "COPYING" file of the
65c72795ab90d3daefa759b716fbb5c6352c7a56vboxsync * VirtualBox OSE distribution. VirtualBox OSE is distributed in the
65c72795ab90d3daefa759b716fbb5c6352c7a56vboxsync * hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
65c72795ab90d3daefa759b716fbb5c6352c7a56vboxsync * The contents of this file may alternatively be used under the terms
65c72795ab90d3daefa759b716fbb5c6352c7a56vboxsync * of the Common Development and Distribution License Version 1.0
65c72795ab90d3daefa759b716fbb5c6352c7a56vboxsync * (CDDL) only, as it comes in the "COPYING.CDDL" file of the
65c72795ab90d3daefa759b716fbb5c6352c7a56vboxsync * VirtualBox OSE distribution, in which case the provisions of the
65c72795ab90d3daefa759b716fbb5c6352c7a56vboxsync * CDDL are applicable instead of those of the GPL.
2d97f8baccdd684bc0a8a15eb86bbe9ff2b85374vboxsync * You may elect to license modified versions of this file under the
65c72795ab90d3daefa759b716fbb5c6352c7a56vboxsync * terms and conditions of either the GPL or the CDDL or both.
032703cba22135d6032705fc2d67dd1294a6491avboxsync/** @name Magic Numbers.
032703cba22135d6032705fc2d67dd1294a6491avboxsync/** Magic number for RTDBGMODINT::u32Magic. (Charles Lloyd) */
315f68b04971772d94ba6c4408eaa19559a77cedvboxsync/** Magic number for RTDBGMODINT::u32Magic. (Keith Jarrett) */
032703cba22135d6032705fc2d67dd1294a6491avboxsync/** Magic number for RTDBGMODVTIMG::u32Magic. (Jack DeJohnette) */
315f68b04971772d94ba6c4408eaa19559a77cedvboxsync/** Magic number for RTDBGMODVTIMG::u32Magic. (Cecil McBee) */
032703cba22135d6032705fc2d67dd1294a6491avboxsync/** The value of RTDIR::u32Magic. (Michael Ende) */
032703cba22135d6032705fc2d67dd1294a6491avboxsync/** The value of RTDIR::u32Magic after RTDirClose(). */
032703cba22135d6032705fc2d67dd1294a6491avboxsync/** The value of RTDVMINTERNAL::u32Magic. (Dan Brown) */
032703cba22135d6032705fc2d67dd1294a6491avboxsync/** The value of RTDVMINTERNAL::u32Magic after close. */
032703cba22135d6032705fc2d67dd1294a6491avboxsync/** The value of RTDVMVOLUMEINTERNAL::u32Magic. (Daniel Defoe) */
032703cba22135d6032705fc2d67dd1294a6491avboxsync/** The value of RTDVMVOLUMEINTERNAL::u32Magic after close. */
032703cba22135d6032705fc2d67dd1294a6491avboxsync/** The value of RTFILEAIOCTXINT::u32Magic. (Howard Phillips Lovecraft) */
032703cba22135d6032705fc2d67dd1294a6491avboxsync/** The value of RTFILEAIOCTXINT::u32Magic after RTFileAioCtxDestroy(). */
032703cba22135d6032705fc2d67dd1294a6491avboxsync#define RTFILEAIOCTX_MAGIC_DEAD UINT32_C(0x19370315)
315f68b04971772d94ba6c4408eaa19559a77cedvboxsync/** The value of RTFILEAIOREQINT::u32Magic. (Stephen Edwin King) */
032703cba22135d6032705fc2d67dd1294a6491avboxsync/** The value of RTENVINTERNAL::u32Magic. (Rumiko Takahashi) */
032703cba22135d6032705fc2d67dd1294a6491avboxsync/** Magic number for RTHANDLETABLEINT::u32Magic. (Hitomi Kanehara) */
032703cba22135d6032705fc2d67dd1294a6491avboxsync/** Magic number for RTHEAPOFFSETINTERNAL::u32Magic. (Neal Town Stephenson) */
032703cba22135d6032705fc2d67dd1294a6491avboxsync/** Magic number for RTHEAPSIMPLEINTERNAL::uMagic. (Kyoichi Katayama) */
032703cba22135d6032705fc2d67dd1294a6491avboxsync/** The magic value for RTLDRMODINTERNAL::u32Magic. (Alan Moore) */
032703cba22135d6032705fc2d67dd1294a6491avboxsync/** The magic value for RTLOCALIPCSERVER::u32Magic. (Naoki Yamamoto) */
032703cba22135d6032705fc2d67dd1294a6491avboxsync/** The magic value for RTLOCALIPCSERVER::u32Magic. (Katsuhiro Otomo) */
032703cba22135d6032705fc2d67dd1294a6491avboxsync#define RTLOCALIPCSESSION_MAGIC UINT32_C(0x19530414)
032703cba22135d6032705fc2d67dd1294a6491avboxsync/** The magic value for RTLOCKVALCLASSINT::u32Magic. (Thomas Mann) */
032703cba22135d6032705fc2d67dd1294a6491avboxsync/** The magic value for RTLOCKVALCLASSINT::u32Magic after destruction. */
032703cba22135d6032705fc2d67dd1294a6491avboxsync#define RTLOCKVALCLASS_MAGIC_DEAD UINT32_C(0x19550812)
032703cba22135d6032705fc2d67dd1294a6491avboxsync/** The magic value for RTLOCKVALRECEXCL::u32Magic. (Vladimir Vladimirovich Nabokov) */
032703cba22135d6032705fc2d67dd1294a6491avboxsync/** The dead magic value for RTLOCKVALRECEXCL::u32Magic. */
032703cba22135d6032705fc2d67dd1294a6491avboxsync#define RTLOCKVALRECEXCL_MAGIC_DEAD UINT32_C(0x19770702)
032703cba22135d6032705fc2d67dd1294a6491avboxsync/** The magic value for RTLOCKVALRECSHRD::u32Magic. (Agnar Mykle) */
65c72795ab90d3daefa759b716fbb5c6352c7a56vboxsync/** The magic value for RTLOCKVALRECSHRD::u32Magic after deletion. */
65c72795ab90d3daefa759b716fbb5c6352c7a56vboxsync#define RTLOCKVALRECSHRD_MAGIC_DEAD UINT32_C(0x19940115)
65c72795ab90d3daefa759b716fbb5c6352c7a56vboxsync/** The magic value for RTLOCKVALRECSHRDOWN::u32Magic. (Jens Ingvald Bjoerneboe) */
65c72795ab90d3daefa759b716fbb5c6352c7a56vboxsync#define RTLOCKVALRECSHRDOWN_MAGIC UINT32_C(0x19201009)
65c72795ab90d3daefa759b716fbb5c6352c7a56vboxsync/** The magic value for RTLOCKVALRECSHRDOWN::u32Magic after deletion. */
315f68b04971772d94ba6c4408eaa19559a77cedvboxsync#define RTLOCKVALRECSHRDOWN_MAGIC_DEAD UINT32_C(0x19760509)
315f68b04971772d94ba6c4408eaa19559a77cedvboxsync/** The magic value for RTLOCKVALRECNEST::u32Magic. (Anne Desclos) */
315f68b04971772d94ba6c4408eaa19559a77cedvboxsync/** The magic value for RTLOCKVALRECNEST::u32Magic after deletion. */
65c72795ab90d3daefa759b716fbb5c6352c7a56vboxsync#define RTLOCKVALRECNEST_MAGIC_DEAD UINT32_C(0x19980427)
65c72795ab90d3daefa759b716fbb5c6352c7a56vboxsync/** Magic number for RTMEMCACHEINT::u32Magic. (Joseph Weizenbaum) */
315f68b04971772d94ba6c4408eaa19559a77cedvboxsync/** Dead magic number for RTMEMCACHEINT::u32Magic. */
315f68b04971772d94ba6c4408eaa19559a77cedvboxsync/** The magic value for RTMEMPOOL::u32Magic. (Jane Austin) */
65c72795ab90d3daefa759b716fbb5c6352c7a56vboxsync/** The magic value for RTMEMPOOL::u32Magic after RTMemPoolDestroy. */
315f68b04971772d94ba6c4408eaa19559a77cedvboxsync/** The magic value for heap blocks. (Edgar Allan Poe) */
315f68b04971772d94ba6c4408eaa19559a77cedvboxsync/** The value of RTPIPEINTERNAL::u32Magic. (Frank Schaetzing) */
65c72795ab90d3daefa759b716fbb5c6352c7a56vboxsync/** The value of RTPOLLSETINTERNAL::u32Magic. (Ai Yazawa) */
315f68b04971772d94ba6c4408eaa19559a77cedvboxsync/** RTR0MEMOBJ::u32Magic. (Masakazu Katsura) */
65c72795ab90d3daefa759b716fbb5c6352c7a56vboxsync/** RTRANDINT::u32Magic. (Alan Moore) */
65c72795ab90d3daefa759b716fbb5c6352c7a56vboxsync/** Magic for the event semaphore structure. (Neil Gaiman) */
65c72795ab90d3daefa759b716fbb5c6352c7a56vboxsync/** Magic for the multiple release event semaphore structure. (Isaac Asimov) */
65c72795ab90d3daefa759b716fbb5c6352c7a56vboxsync/** Dead magic value for multiple release event semaphore structures. */
65c72795ab90d3daefa759b716fbb5c6352c7a56vboxsync#define RTSEMEVENTMULTI_MAGIC_DEAD UINT32_C(0x19920406)
65c72795ab90d3daefa759b716fbb5c6352c7a56vboxsync/** Magic value for RTSEMFASTMUTEXINTERNAL::u32Magic. (John Ronald Reuel Tolkien) */
65c72795ab90d3daefa759b716fbb5c6352c7a56vboxsync/** Dead magic value for RTSEMFASTMUTEXINTERNAL::u32Magic. */
65c72795ab90d3daefa759b716fbb5c6352c7a56vboxsync#define RTSEMFASTMUTEX_MAGIC_DEAD UINT32_C(0x19730902)
65c72795ab90d3daefa759b716fbb5c6352c7a56vboxsync/** Magic for the mutex semaphore structure. (Douglas Adams) */
65c72795ab90d3daefa759b716fbb5c6352c7a56vboxsync/** Dead magic for the mutex semaphore structure. */
65c72795ab90d3daefa759b716fbb5c6352c7a56vboxsync/** Magic for the spinning mutex semaphore structure. (Natsume Soseki) */
65c72795ab90d3daefa759b716fbb5c6352c7a56vboxsync/** Dead magic value for RTSEMSPINMUTEXINTERNAL::u32Magic. */
65c72795ab90d3daefa759b716fbb5c6352c7a56vboxsync#define RTSEMSPINMUTEX_MAGIC_DEAD UINT32_C(0x19161209)
65c72795ab90d3daefa759b716fbb5c6352c7a56vboxsync/** RTSEMRWINTERNAL::u32Magic value. (Kosuke Fujishima) */
65c72795ab90d3daefa759b716fbb5c6352c7a56vboxsync/** RTSEMXROADSINTERNAL::u32Magic value. (Kenneth Elton "Ken" Kesey) */
65c72795ab90d3daefa759b716fbb5c6352c7a56vboxsync/** RTSEMXROADSINTERNAL::u32Magic value after RTSemXRoadsDestroy. */
65c72795ab90d3daefa759b716fbb5c6352c7a56vboxsync/** The magic value for RTSOCKETINT::u32Magic. (Stanislaw Lem) */
65c72795ab90d3daefa759b716fbb5c6352c7a56vboxsync/** The magic value for RTSOCKETINT::u32Magic after destruction. */
65c72795ab90d3daefa759b716fbb5c6352c7a56vboxsync/** Magic value for RTSPINLOCKINTERNAL::u32Magic. (Terry Pratchett) */
65c72795ab90d3daefa759b716fbb5c6352c7a56vboxsync/** Magic value for RTSTRCACHE::u32Magic. (Sir Arthur Charles Clarke) */
65c72795ab90d3daefa759b716fbb5c6352c7a56vboxsync/** Magic value for RTSTRCACHE::u32Magic after RTStrCacheDestroy. */
65c72795ab90d3daefa759b716fbb5c6352c7a56vboxsync/** The value of RTSTREAM::u32Magic for a valid stream. */
65c72795ab90d3daefa759b716fbb5c6352c7a56vboxsync/** Magic value for RTTCPSERVER::u32Magic. (Jan Garbarek) */
65c72795ab90d3daefa759b716fbb5c6352c7a56vboxsync/** RTTESTINT::u32Magic value. (Daniel Kehlmann) */
65c72795ab90d3daefa759b716fbb5c6352c7a56vboxsync/** RTTHREADINT::u32Magic value. (Gilbert Keith Chesterton) */
65c72795ab90d3daefa759b716fbb5c6352c7a56vboxsync/** RTTHREADINT::u32Magic value for a dead thread. */
65c72795ab90d3daefa759b716fbb5c6352c7a56vboxsync/** Magic number for timer handles. (Jared Mason Diamond) */
65c72795ab90d3daefa759b716fbb5c6352c7a56vboxsync/** Magic number for timer low resolution handles. (Saki Hiwatari) */
65c72795ab90d3daefa759b716fbb5c6352c7a56vboxsync/** The value of RTS3::u32Magic. (Edgar Wallace) */
65c72795ab90d3daefa759b716fbb5c6352c7a56vboxsync/** The value of RTS3::u32Magic after RTS3Destroy(). */
65c72795ab90d3daefa759b716fbb5c6352c7a56vboxsync/** The value of RTTAR::u32Magic. (Donald Ervin Knuth) */
65c72795ab90d3daefa759b716fbb5c6352c7a56vboxsync/** The value of RTTAR::u32Magic after RTTarClose(). */
032703cba22135d6032705fc2d67dd1294a6491avboxsync/** The value of RTTARFILE::u32Magic. (Abraham Stoker) */
315f68b04971772d94ba6c4408eaa19559a77cedvboxsync/** The value of RTTARFILE::u32Magic after RTTarFileClose(). */
65c72795ab90d3daefa759b716fbb5c6352c7a56vboxsync/** The value of RTVFSOBJINTERNAL::u32Magic. (Yasunari Kawabata) */
65c72795ab90d3daefa759b716fbb5c6352c7a56vboxsync/** The value of RTVFSOBJINTERNAL::u32Magic arter close. */
032703cba22135d6032705fc2d67dd1294a6491avboxsync/** The value of RTVFSINTERNAL::u32Magic. (Sir Kingsley William Amis) */
315f68b04971772d94ba6c4408eaa19559a77cedvboxsync/** The value of RTVFSINTERNAL::u32Magic after close. */
65c72795ab90d3daefa759b716fbb5c6352c7a56vboxsync/** The value of RTVFSFSSTREAMINTERNAL::u32Magic. (William McGuire "Bill" Bryson) */
65c72795ab90d3daefa759b716fbb5c6352c7a56vboxsync/** The value of RTVFSFSSTREAMINTERNAL::u32Magic after close */
65c72795ab90d3daefa759b716fbb5c6352c7a56vboxsync#define RTVFSFSSTREAM_MAGIC_DEAD (~RTVFSFSSTREAM_MAGIC)
65c72795ab90d3daefa759b716fbb5c6352c7a56vboxsync/** The value of RTVFSDIRINTERNAL::u32Magic. (Franklin Patrick Herbert, Jr.) */
032703cba22135d6032705fc2d67dd1294a6491avboxsync/** The value of RTVFSDIRINTERNAL::u32Magic after close. */
65c72795ab90d3daefa759b716fbb5c6352c7a56vboxsync/** The value of RTVFSFILEINTERNAL::u32Magic. (Charles John Huffam Dickens) */
65c72795ab90d3daefa759b716fbb5c6352c7a56vboxsync/** The value of RTVFSFILEINTERNAL::u32Magic after close. */
65c72795ab90d3daefa759b716fbb5c6352c7a56vboxsync/** The value of RTVFSIOSTREAMINTERNAL::u32Magic. (Ernest Miller Hemingway) */
65c72795ab90d3daefa759b716fbb5c6352c7a56vboxsync/** The value of RTVFSIOSTREAMINTERNAL::u32Magic after close. */
65c72795ab90d3daefa759b716fbb5c6352c7a56vboxsync#define RTVFSIOSTREAM_MAGIC_DEAD UINT32_C(0x19610702)
65c72795ab90d3daefa759b716fbb5c6352c7a56vboxsync/** The value of RTVFSSYMLINKINTERNAL::u32Magic. (Francis Scott Key Fitzgerald) */
65c72795ab90d3daefa759b716fbb5c6352c7a56vboxsync/** The value of RTVFSSYMLINKINTERNAL::u32Magic after close. */
032703cba22135d6032705fc2d67dd1294a6491avboxsync#define RTVFSSYMLINK_MAGIC_DEAD UINT32_C(0x19401221)