1 .\"
2 .\" Mach Operating System
3 .\" Copyright (c) 1991,1990 Carnegie Mellon University
4 .\" All Rights Reserved.
5 .\"
6 .\" Permission to use, copy, modify and distribute this software and its
7 .\" documentation is hereby granted, provided that both the copyright
8 .\" notice and this permission notice appear in all copies of the
9 .\" software, derivative works or modified versions, and any portions
10 .\" thereof, and that both notices appear in supporting documentation.
11 .\"
12 .\" CARNEGIE MELLON ALLOWS FREE USE OF THIS SOFTWARE IN ITS "AS IS"
13 .\" CONDITION. CARNEGIE MELLON DISCLAIMS ANY LIABILITY OF ANY KIND FOR
14 .\" ANY DAMAGES WHATSOEVER RESULTING FROM THE USE OF THIS SOFTWARE.
15 .\"
16 .\" Carnegie Mellon requests users of this software to return to
17 .\"
18 .\" Software Distribution Coordinator or Software.Distribution@CS.CMU.EDU
19 .\" School of Computer Science
20 .\" Carnegie Mellon University
21 .\" Pittsburgh PA 15213-3890
22 .\"
23 .\" any improvements or extensions that they make and grant Carnegie Mellon
24 .\" the rights to redistribute these changes.
25 .\"
26 .\"
27 .\" HISTORY
28 .\" $Log: memory_object_server.man,v $
29 .\" Revision 2.4 91/05/14 17:10:25 mrt
30 .\" Correcting copyright
31 .\"
32 .\" Revision 2.3 91/02/14 14:13:26 mrt
33 .\" Changed to new Mach copyright
34 .\" [91/02/12 18:14:11 mrt]
35 .\"
36 .\" Revision 2.2 90/08/07 18:41:32 rpd
37 .\" Created.
38 .\"
39 .TH memory_object_server 2 12/19/89
40 .CM 4
41 .SH NAME
42 .nf
43 memory_object_server \- main program of memory manager
44 .SH SYNOPSIS
45 .nf
46 .ft B
47 #include <mach.h>
48
49 .nf
50 .ft B
51 boolean_t memory_object_server(in_msg, out_msg)
52 msg_header_t *in_msg;
53 msg_header_t *out_msg;
54
55
56 .fi
57 .ft P
58 .SH DESCRIPTION
59 A
60 .B memory manager
61 is a server task that responds to specific
62 messages from the kernel in order to handle memory management functions for
63 the kernel.
64
65 In order to isolate the memory manager from the specifics of message
66 formatting, the remote procedure call generator produces a
67 procedure,
68 .B memory_object_server
69 , to handle a received message.
70 This function does all necessary argument handling, and actually
71 calls one of the following functions:
72 .B memory_object_init
73 ,
74 .B memory_object_data_write, memory_object_data_request,
75 .B memory_object_data_unlock, memory_object_lock_completed,
76 .B memory_object_copy, memory_object_terminate
77 . A
78 .B default memory manager
79 may get two additional requests from the kernel:
80 .B memory_object_create
81 and
82 .B memory_object_data_initialize
83 .
84
85 The return value from the
86 .B memory_object_server
87 function indicates that
88 the message was appropriate to the memory management interface
89 (returning
90 .B TRUE
91 ), or that it could not handle this message
92 (returning
93 .B FALSE
94 ).
95
96 .SH ARGUMENTS
97 .TP 15
98 .B
99 .B in_msg
100 The message that has been received from the kernel.
101 .TP 15
102 .B
103 .B out_msg
104 A reply message. Not used for this server
105
106 .SH DIAGNOSTICS
107 .TP 25
108 .B TRUE
109 From
110 .B memory_object_server
111 , indicates that the message
112 in question was applicable to this interface, and that the appropriate
113 routine was called to interpret the message.
114 .TP 25
115 .B FALSE
116 From
117 .B memory_object_server
118 , indicates that the message
119 did not apply to this interface, and that no other action was taken.
120
121 .SH SEE ALSO
122 .B memory_object_init,memory_object_data_request,memory_object_data_unlock,
123 .B memory_object_data_write,memory_object_copy,memory_object_terminate,
124 .B memory_object_lock_completed, memory_object_data_initialize,
125 .B memory_object_create
126
Cache object: 79b78756b54a464a3af826d648e3fe7c
|