magics.h revision b7a07b07543924f45c1fffd2f90de582038b8ba6
ea7d33962ceb90ea90e67e427d60b5788f34268avboxsync * IPRT - Internal header defining The Magic Numbers.
c58f1213e628a545081c70e26c6b67a841cff880vboxsync * Copyright (C) 2007-2012 Oracle Corporation
65b0f0cd3c38007138720b7eaa43c963a9ee1244vboxsync * This file is part of VirtualBox Open Source Edition (OSE), as
65b0f0cd3c38007138720b7eaa43c963a9ee1244vboxsync * available from http://www.virtualbox.org. This file is free software;
65b0f0cd3c38007138720b7eaa43c963a9ee1244vboxsync * you can redistribute it and/or modify it under the terms of the GNU
a16eb14ad7a4b5ef91ddc22d3e8e92d930f736fcvboxsync * General Public License (GPL) as published by the Free Software
a16eb14ad7a4b5ef91ddc22d3e8e92d930f736fcvboxsync * Foundation, in version 2 as it comes in the "COPYING" file of the
a16eb14ad7a4b5ef91ddc22d3e8e92d930f736fcvboxsync * VirtualBox OSE distribution. VirtualBox OSE is distributed in the
a16eb14ad7a4b5ef91ddc22d3e8e92d930f736fcvboxsync * hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
a16eb14ad7a4b5ef91ddc22d3e8e92d930f736fcvboxsync * The contents of this file may alternatively be used under the terms
a16eb14ad7a4b5ef91ddc22d3e8e92d930f736fcvboxsync * of the Common Development and Distribution License Version 1.0
a16eb14ad7a4b5ef91ddc22d3e8e92d930f736fcvboxsync * (CDDL) only, as it comes in the "COPYING.CDDL" file of the
a16eb14ad7a4b5ef91ddc22d3e8e92d930f736fcvboxsync * VirtualBox OSE distribution, in which case the provisions of the
a16eb14ad7a4b5ef91ddc22d3e8e92d930f736fcvboxsync * CDDL are applicable instead of those of the GPL.
a16eb14ad7a4b5ef91ddc22d3e8e92d930f736fcvboxsync * You may elect to license modified versions of this file under the
a16eb14ad7a4b5ef91ddc22d3e8e92d930f736fcvboxsync * terms and conditions of either the GPL or the CDDL or both.
cf57145d4697dceca3f0542b370c20f7a2c5c6e8vboxsync/** @name Magic Numbers.
527eff46676ca64c098dc7d1bf0857408c3a6f82vboxsync/** Magic number for RTAIOMGRINT::u32Magic. (Emil Erich Kaestner) */
527eff46676ca64c098dc7d1bf0857408c3a6f82vboxsync/** Magic number for RTAIOMGRINTFILE::u32Magic. (Ephraim Kishon) */
3a4a6501d0ccd629d9951b644d380c7bb2d46086vboxsync/** Magic number for RTDBGMODINT::u32Magic. (Charles Lloyd) */
b7a07b07543924f45c1fffd2f90de582038b8ba6vboxsync/** Magic number for RTDBGCFGINT::u32Magic. (McCoy Tyner) */
3a4a6501d0ccd629d9951b644d380c7bb2d46086vboxsync/** Magic number for RTDBGMODINT::u32Magic. (Keith Jarrett) */
3a4a6501d0ccd629d9951b644d380c7bb2d46086vboxsync/** Magic number for RTDBGMODVTIMG::u32Magic. (Jack DeJohnette) */
3a4a6501d0ccd629d9951b644d380c7bb2d46086vboxsync/** Magic number for RTDBGMODVTIMG::u32Magic. (Cecil McBee) */
560a1042a968cf73161ac78555eddc8d16e8bebdvboxsync/** Magic value for RTDBGKRNLINFOINT::u32Magic. (John Carmack) */
881b5ff6bc55e1fb0f4ef42f9782ccec79c0a138vboxsync/** The value of RTDIR::u32Magic. (Michael Ende) */
881b5ff6bc55e1fb0f4ef42f9782ccec79c0a138vboxsync/** The value of RTDIR::u32Magic after RTDirClose(). */
e52b0dfe3d9ead70e24f2ce4ed3faa6c79c00618vboxsync/** The value of RTDVMINTERNAL::u32Magic. (Dan Brown) */
e52b0dfe3d9ead70e24f2ce4ed3faa6c79c00618vboxsync/** The value of RTDVMINTERNAL::u32Magic after close. */
e52b0dfe3d9ead70e24f2ce4ed3faa6c79c00618vboxsync/** The value of RTDVMVOLUMEINTERNAL::u32Magic. (Daniel Defoe) */
e52b0dfe3d9ead70e24f2ce4ed3faa6c79c00618vboxsync/** The value of RTDVMVOLUMEINTERNAL::u32Magic after close. */
c320aee99660824809e157bbad368db3542a9e90vboxsync/** The value of RTFILEAIOCTXINT::u32Magic. (Howard Phillips Lovecraft) */
c320aee99660824809e157bbad368db3542a9e90vboxsync/** The value of RTFILEAIOCTXINT::u32Magic after RTFileAioCtxDestroy(). */
c0cb47bd8aa02fca08ff72a37ba5c65894241cbfvboxsync#define RTFILEAIOCTX_MAGIC_DEAD UINT32_C(0x19370315)
c320aee99660824809e157bbad368db3542a9e90vboxsync/** The value of RTFILEAIOREQINT::u32Magic. (Stephen Edwin King) */
3a4a6501d0ccd629d9951b644d380c7bb2d46086vboxsync/** The value of RTENVINTERNAL::u32Magic. (Rumiko Takahashi) */
ab455939477d81b7bb500586f88029d3a3c0b34cvboxsync/** The value of RTERRVARS::ai32Vars[0]. (Ryuichi Sakamoto) */
ea7d33962ceb90ea90e67e427d60b5788f34268avboxsync/** Magic number for RTHANDLETABLEINT::u32Magic. (Hitomi Kanehara) */
f9f72da3edbd8434dc722c26ee038e2808d691favboxsync/** Magic number for RTHEAPOFFSETINTERNAL::u32Magic. (Neal Town Stephenson) */
f9f72da3edbd8434dc722c26ee038e2808d691favboxsync/** Magic number for RTHEAPSIMPLEINTERNAL::uMagic. (Kyoichi Katayama) */
55870b5b46ea9754616dcc3663a110ce71927a0evboxsync/** The magic value for RTHTTPINTERNAL::u32Magic. (Karl May) */
55870b5b46ea9754616dcc3663a110ce71927a0evboxsync/** The value of RTHTTPINTERNAL::u32Magic after close. */
881b5ff6bc55e1fb0f4ef42f9782ccec79c0a138vboxsync/** The magic value for RTLDRMODINTERNAL::u32Magic. (Alan Moore) */
1c2c968fd241148110002d75b2c0fdeddc211e14vboxsync/** The magic value for RTLOCALIPCSERVER::u32Magic. (Naoki Yamamoto) */
1c2c968fd241148110002d75b2c0fdeddc211e14vboxsync/** The magic value for RTLOCALIPCSERVER::u32Magic. (Katsuhiro Otomo) */
c0cb47bd8aa02fca08ff72a37ba5c65894241cbfvboxsync#define RTLOCALIPCSESSION_MAGIC UINT32_C(0x19530414)
f2af1be3e27a2fefe95332260d360f4b26cffbcfvboxsync/** The magic value for RTLOCKVALCLASSINT::u32Magic. (Thomas Mann) */
f2af1be3e27a2fefe95332260d360f4b26cffbcfvboxsync/** The magic value for RTLOCKVALCLASSINT::u32Magic after destruction. */
f2af1be3e27a2fefe95332260d360f4b26cffbcfvboxsync#define RTLOCKVALCLASS_MAGIC_DEAD UINT32_C(0x19550812)
75d8fea43f2d7474d00172dcf906f7ab598a8c8fvboxsync/** The magic value for RTLOCKVALRECEXCL::u32Magic. (Vladimir Vladimirovich Nabokov) */
75d8fea43f2d7474d00172dcf906f7ab598a8c8fvboxsync/** The dead magic value for RTLOCKVALRECEXCL::u32Magic. */
c0cb47bd8aa02fca08ff72a37ba5c65894241cbfvboxsync#define RTLOCKVALRECEXCL_MAGIC_DEAD UINT32_C(0x19770702)
eaae6c3ce81916ccc4e74af4b55972ba956cf5c8vboxsync/** The magic value for RTLOCKVALRECSHRD::u32Magic. (Agnar Mykle) */
eaae6c3ce81916ccc4e74af4b55972ba956cf5c8vboxsync/** The magic value for RTLOCKVALRECSHRD::u32Magic after deletion. */
c0cb47bd8aa02fca08ff72a37ba5c65894241cbfvboxsync#define RTLOCKVALRECSHRD_MAGIC_DEAD UINT32_C(0x19940115)
eaae6c3ce81916ccc4e74af4b55972ba956cf5c8vboxsync/** The magic value for RTLOCKVALRECSHRDOWN::u32Magic. (Jens Ingvald Bjoerneboe) */
c0cb47bd8aa02fca08ff72a37ba5c65894241cbfvboxsync#define RTLOCKVALRECSHRDOWN_MAGIC UINT32_C(0x19201009)
eaae6c3ce81916ccc4e74af4b55972ba956cf5c8vboxsync/** The magic value for RTLOCKVALRECSHRDOWN::u32Magic after deletion. */
c0cb47bd8aa02fca08ff72a37ba5c65894241cbfvboxsync#define RTLOCKVALRECSHRDOWN_MAGIC_DEAD UINT32_C(0x19760509)
f1c8438d14b7420eb2b916ef5981ac09faa4f6c4vboxsync/** The magic value for RTLOCKVALRECNEST::u32Magic. (Anne Desclos) */
f1c8438d14b7420eb2b916ef5981ac09faa4f6c4vboxsync/** The magic value for RTLOCKVALRECNEST::u32Magic after deletion. */
f1c8438d14b7420eb2b916ef5981ac09faa4f6c4vboxsync#define RTLOCKVALRECNEST_MAGIC_DEAD UINT32_C(0x19980427)
b6dc9545438e63d05fff621e85ddb7dc39cf14e7vboxsync/** Magic number for RTMEMCACHEINT::u32Magic. (Joseph Weizenbaum) */
b6dc9545438e63d05fff621e85ddb7dc39cf14e7vboxsync/** Dead magic number for RTMEMCACHEINT::u32Magic. */
20593760b116c90f3e439552763eef632a3bbb17vboxsync/** The magic value for RTMEMPOOL::u32Magic. (Jane Austin) */
20593760b116c90f3e439552763eef632a3bbb17vboxsync/** The magic value for RTMEMPOOL::u32Magic after RTMemPoolDestroy. */
46f5824f3e233b92bad1626932d5ce9522886f54vboxsync/** The magic value for heap blocks. (Edgar Allan Poe) */
46f5824f3e233b92bad1626932d5ce9522886f54vboxsync/** The value of RTPIPEINTERNAL::u32Magic. (Frank Schaetzing) */
46f5824f3e233b92bad1626932d5ce9522886f54vboxsync/** The value of RTPOLLSETINTERNAL::u32Magic. (Ai Yazawa) */
881b5ff6bc55e1fb0f4ef42f9782ccec79c0a138vboxsync/** RTR0MEMOBJ::u32Magic. (Masakazu Katsura) */
6fea4abcc6ee0f2797ac01ef79c374d506aedc02vboxsync/** RTRANDINT::u32Magic. (Alan Moore) */
17ef1920962b3df57bf6d2704ced1586396d96f0vboxsync/** The value of RTREQ::u32Magic. */
17ef1920962b3df57bf6d2704ced1586396d96f0vboxsync#define RTREQ_MAGIC UINT32_C(0xfeed0001) /**< @todo find a value */
17ef1920962b3df57bf6d2704ced1586396d96f0vboxsync/** The value of RTREQ::u32Magic of a freed request. */
17ef1920962b3df57bf6d2704ced1586396d96f0vboxsync/** The value of RTREQPOOLINT::u32Magic. */
17ef1920962b3df57bf6d2704ced1586396d96f0vboxsync#define RTREQPOOL_MAGIC UINT32_C(0xfeed0002)/**< @todo find a value */
17ef1920962b3df57bf6d2704ced1586396d96f0vboxsync/** The value of RTREQPOOLINT::u32Magic after destruction. */
17ef1920962b3df57bf6d2704ced1586396d96f0vboxsync/** The value of RTREQQUEUEINT::u32Magic. */
17ef1920962b3df57bf6d2704ced1586396d96f0vboxsync#define RTREQQUEUE_MAGIC UINT32_C(0xfeed0003)/**< @todo find a value */
17ef1920962b3df57bf6d2704ced1586396d96f0vboxsync/** The value of RTREQQUEUEINT::u32Magic after destruction. */
20024c6bd4100e9925d1ff0516af5753814fc43dvboxsync/** The value of RTS3::u32Magic. (Edgar Wallace) */
20024c6bd4100e9925d1ff0516af5753814fc43dvboxsync/** The value of RTS3::u32Magic after RTS3Destroy(). */
881b5ff6bc55e1fb0f4ef42f9782ccec79c0a138vboxsync/** Magic for the event semaphore structure. (Neil Gaiman) */
881b5ff6bc55e1fb0f4ef42f9782ccec79c0a138vboxsync/** Magic for the multiple release event semaphore structure. (Isaac Asimov) */
63e576f3c901db19ac9a11f2353025b66a6798eevboxsync/** Dead magic value for multiple release event semaphore structures. */
63e576f3c901db19ac9a11f2353025b66a6798eevboxsync#define RTSEMEVENTMULTI_MAGIC_DEAD UINT32_C(0x19920406)
881b5ff6bc55e1fb0f4ef42f9782ccec79c0a138vboxsync/** Magic value for RTSEMFASTMUTEXINTERNAL::u32Magic. (John Ronald Reuel Tolkien) */
881b5ff6bc55e1fb0f4ef42f9782ccec79c0a138vboxsync/** Dead magic value for RTSEMFASTMUTEXINTERNAL::u32Magic. */
c0cb47bd8aa02fca08ff72a37ba5c65894241cbfvboxsync#define RTSEMFASTMUTEX_MAGIC_DEAD UINT32_C(0x19730902)
881b5ff6bc55e1fb0f4ef42f9782ccec79c0a138vboxsync/** Magic for the mutex semaphore structure. (Douglas Adams) */
881b5ff6bc55e1fb0f4ef42f9782ccec79c0a138vboxsync/** Dead magic for the mutex semaphore structure. */
0b4890533cbae4f30a0241d0780d4ff9daa304f4vboxsync/** Magic for the spinning mutex semaphore structure. (Natsume Soseki) */
0b4890533cbae4f30a0241d0780d4ff9daa304f4vboxsync/** Dead magic value for RTSEMSPINMUTEXINTERNAL::u32Magic. */
c0cb47bd8aa02fca08ff72a37ba5c65894241cbfvboxsync#define RTSEMSPINMUTEX_MAGIC_DEAD UINT32_C(0x19161209)
881b5ff6bc55e1fb0f4ef42f9782ccec79c0a138vboxsync/** RTSEMRWINTERNAL::u32Magic value. (Kosuke Fujishima) */
7e33622becf3d7cf9a2401ac0c53d315877f6e34vboxsync/** RTSEMXROADSINTERNAL::u32Magic value. (Kenneth Elton "Ken" Kesey) */
7e33622becf3d7cf9a2401ac0c53d315877f6e34vboxsync/** RTSEMXROADSINTERNAL::u32Magic value after RTSemXRoadsDestroy. */
a1e9b93d4f2b32d7a2aac1fb6ee958e1d147197cvboxsync/** The magic value for RTSOCKETINT::u32Magic. (Stanislaw Lem) */
a1e9b93d4f2b32d7a2aac1fb6ee958e1d147197cvboxsync/** The magic value for RTSOCKETINT::u32Magic after destruction. */
881b5ff6bc55e1fb0f4ef42f9782ccec79c0a138vboxsync/** Magic value for RTSPINLOCKINTERNAL::u32Magic. (Terry Pratchett) */
20593760b116c90f3e439552763eef632a3bbb17vboxsync/** Magic value for RTSTRCACHE::u32Magic. (Sir Arthur Charles Clarke) */
20593760b116c90f3e439552763eef632a3bbb17vboxsync/** Magic value for RTSTRCACHE::u32Magic after RTStrCacheDestroy. */
881b5ff6bc55e1fb0f4ef42f9782ccec79c0a138vboxsync/** The value of RTSTREAM::u32Magic for a valid stream. */
8c3ab623787ffed571ef7a1fa8c1a98e22d28021vboxsync/** Magic value for RTTCPSERVER::u32Magic. (Jan Garbarek) */
8c48cf39dfb84c1f26e0e7fbd1c407e25a34eef1vboxsync/** Magic value for RTTCPSERVER::u32Magic. (Harlan Ellison) */
20024c6bd4100e9925d1ff0516af5753814fc43dvboxsync/** The value of RTTAR::u32Magic. (Donald Ervin Knuth) */
20024c6bd4100e9925d1ff0516af5753814fc43dvboxsync/** The value of RTTAR::u32Magic after RTTarClose(). */
20024c6bd4100e9925d1ff0516af5753814fc43dvboxsync/** The value of RTTARFILE::u32Magic. (Abraham Stoker) */
20024c6bd4100e9925d1ff0516af5753814fc43dvboxsync/** The value of RTTARFILE::u32Magic after RTTarFileClose(). */
9cabb72c6d6feb65e839ce50765643b98bb9a301vboxsync/** RTTESTINT::u32Magic value. (Daniel Kehlmann) */
881b5ff6bc55e1fb0f4ef42f9782ccec79c0a138vboxsync/** RTTHREADINT::u32Magic value. (Gilbert Keith Chesterton) */
881b5ff6bc55e1fb0f4ef42f9782ccec79c0a138vboxsync/** RTTHREADINT::u32Magic value for a dead thread. */
65b0f0cd3c38007138720b7eaa43c963a9ee1244vboxsync/** Magic number for timer handles. (Jared Mason Diamond) */
d1ae44110ca869b6cb4a708dc6d676e10f4167bavboxsync/** Magic number for timer low resolution handles. (Saki Hiwatari) */
20024c6bd4100e9925d1ff0516af5753814fc43dvboxsync/** Magic value of RTTRACEBUFINT::u32Magic. (George Orwell) */
20024c6bd4100e9925d1ff0516af5753814fc43dvboxsync/** Magic value of RTTRACEBUFINT::u32Magic after the final release. */
ac6ede0b256f7583f8673aef5347770437c003davboxsync/** The value of RTVFSOBJINTERNAL::u32Magic. (Yasunari Kawabata) */
ac6ede0b256f7583f8673aef5347770437c003davboxsync/** The value of RTVFSOBJINTERNAL::u32Magic arter close. */
ac6ede0b256f7583f8673aef5347770437c003davboxsync/** The value of RTVFSINTERNAL::u32Magic. (Sir Kingsley William Amis) */
ac6ede0b256f7583f8673aef5347770437c003davboxsync/** The value of RTVFSINTERNAL::u32Magic after close. */
ac6ede0b256f7583f8673aef5347770437c003davboxsync/** The value of RTVFSFSSTREAMINTERNAL::u32Magic. (William McGuire "Bill" Bryson) */
ac6ede0b256f7583f8673aef5347770437c003davboxsync/** The value of RTVFSFSSTREAMINTERNAL::u32Magic after close */
ac6ede0b256f7583f8673aef5347770437c003davboxsync#define RTVFSFSSTREAM_MAGIC_DEAD (~RTVFSFSSTREAM_MAGIC)
ac6ede0b256f7583f8673aef5347770437c003davboxsync/** The value of RTVFSDIRINTERNAL::u32Magic. (Franklin Patrick Herbert, Jr.) */
ac6ede0b256f7583f8673aef5347770437c003davboxsync/** The value of RTVFSDIRINTERNAL::u32Magic after close. */
ac6ede0b256f7583f8673aef5347770437c003davboxsync/** The value of RTVFSFILEINTERNAL::u32Magic. (Charles John Huffam Dickens) */
ac6ede0b256f7583f8673aef5347770437c003davboxsync/** The value of RTVFSFILEINTERNAL::u32Magic after close. */
ac6ede0b256f7583f8673aef5347770437c003davboxsync/** The value of RTVFSIOSTREAMINTERNAL::u32Magic. (Ernest Miller Hemingway) */
ac6ede0b256f7583f8673aef5347770437c003davboxsync/** The value of RTVFSIOSTREAMINTERNAL::u32Magic after close. */
ac6ede0b256f7583f8673aef5347770437c003davboxsync#define RTVFSIOSTREAM_MAGIC_DEAD UINT32_C(0x19610702)
ac6ede0b256f7583f8673aef5347770437c003davboxsync/** The value of RTVFSSYMLINKINTERNAL::u32Magic. (Francis Scott Key Fitzgerald) */
ac6ede0b256f7583f8673aef5347770437c003davboxsync/** The value of RTVFSSYMLINKINTERNAL::u32Magic after close. */
ac6ede0b256f7583f8673aef5347770437c003davboxsync#define RTVFSSYMLINK_MAGIC_DEAD UINT32_C(0x19401221)