]> git.saurik.com Git - apple/xnu.git/blame - bsd/dev/random/YarrowCoreLib/src/smf.h
xnu-344.tar.gz
[apple/xnu.git] / bsd / dev / random / YarrowCoreLib / src / smf.h
CommitLineData
0b4e3aa0
A
1/*
2 * Copyright (c) 1999, 2000-2001 Apple Computer, Inc. All rights reserved.
3 *
4 * @APPLE_LICENSE_HEADER_START@
5 *
6 * The contents of this file constitute Original Code as defined in and
7 * are subject to the Apple Public Source License Version 1.1 (the
8 * "License"). You may not use this file except in compliance with the
9 * License. Please obtain a copy of the License at
10 * http://www.apple.com/publicsource and read it before using this file.
11 *
12 * This Original Code and all software distributed under the License are
13 * distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY KIND, EITHER
14 * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
15 * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
16 * FITNESS FOR A PARTICULAR PURPOSE OR NON-INFRINGEMENT. Please see the
17 * License for the specific language governing rights and limitations
18 * under the License.
19 *
20 * @APPLE_LICENSE_HEADER_END@
21 */
22
23/*
24 File: smf.h
25
26 Contains: Secure malloc/free API.
27
28 Written by: Doug Mitchell
29
30 Copyright: (c) 2000 by Apple Computer, Inc., all rights reserved.
31
32 Change History (most recent first):
33
34 02/10/00 dpm Created, based on Counterpane's Yarrow code.
35
36*/
37
38#ifndef _YARROW_SMF_H_
39#define _YARROW_SMF_H_
40
41#if defined(__cplusplus)
42extern "C" {
43#endif
44
45/* smf.h */
46
47 /*
48 Header file for secure malloc and free routines used by the Counterpane
49 PRNG. Use this code to set up a memory-mapped file out of the system
50 paging file, allocate and free memory from it, and then return
51 the memory to the system registry after having securely overwritten it.
52 Details of the secure overwrite can be found in Gutmann 1996 (Usenix).
53 Trying to explain it here will cause my head to begin to hurt.
54 Ari Benbasat (pigsfly@unixg.ubc.ca)
55 */
56
57
58
59#if defined(macintosh) || defined(__APPLE__)
60#include "macOnly.h"
61#define MMPTR void *
62
63#ifndef SMFAPI
64#define SMFAPI
65#endif
66
67#else /* original Yarrow */
68
69/* Declare HOOKSAPI as __declspec(dllexport) before
70 including this file in the actual DLL */
71#ifndef SMFAPI
72#define SMFAPI __declspec(dllimport)
73#endif
74#define MMPTR BYTE
75
76#endif /* macintosh */
77
78
79#define MM_NULL 0
80
81/* Function forward declarations */
82SMFAPI void mmInit();
83SMFAPI MMPTR mmMalloc(DWORD request);
84SMFAPI void mmFree(MMPTR ptrnum);
85SMFAPI LPVOID mmGetPtr(MMPTR ptrnum);
86SMFAPI void mmReturnPtr(MMPTR ptrnum);
87#if 0
88SMFAPI void mmFreePtr(LPVOID ptr);
89#endif
90
91#if defined(__cplusplus)
92}
93#endif
94
95#endif /* _YARROW_SMF_H_*/