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_data_error.man,v $
29 .\" Revision 2.5 93/05/10 19:33:27 rvb
30 .\" updated
31 .\" [93/04/21 16:08:11 lli]
32 .\"
33 .\" Revision 2.4 91/05/14 17:08:46 mrt
34 .\" Correcting copyright
35 .\"
36 .\" Revision 2.3 91/02/14 14:12:40 mrt
37 .\" Changed to new Mach copyright
38 .\" [91/02/12 18:12:57 mrt]
39 .\"
40 .\" Revision 2.2 90/08/07 18:39:36 rpd
41 .\" Created.
42 .\"
43 .TH memory_object_data_error 2 12/18/89
44 .CM 4
45 .SH NAME
46 .nf
47 memory_object_data_error \- indicates data retrieval failure
48 .SH SYNOPSIS
49 .nf
50 .ft B
51 #include <mach.h>
52
53 .nf
54 .ft B
55 kern_return_t memory_object_data_error(memory_control,
56 offset, size, reason);
57 mach_port_t
58 memory_control;
59 vm_offset_t offset;
60 vm_size_t size;
61 kern_return_t reason;
62
63
64 .fi
65 .ft P
66 .SH DESCRIPTION
67
68 .B memory_object_data_error
69 indicates that the memory manager cannot return
70 the data requested for the given region, specifying a reason for the error.
71 This is typically used when a hardware error is encountered.
72
73 .SH ARGUMENTS
74 .TP 15
75 .B
76 memory_control
77 The port, provided by the kernel
78 in a
79 .B memory_object_init
80 call, to which cache management requests may be issued.
81 .TP 15
82 .B
83 offset
84 An offset within a memory object, in bytes. This must be
85 page aligned.
86 .TP 15
87 .B
88 size
89 The amount of cached data (starting at
90 .B offset
91 ) to be handled.
92 This must be an integral multiple of the memory object page size.
93 .TP 15
94 .B
95 reason
96 Could be a Unix error code for a hardware error.
97
98 .SH DIAGNOSTICS
99 .TP 25
100 KERN_SUCCESS
101 This routine does not receive a reply message (and consequently
102 has no return value), so only message transmission errors apply.
103
104 .SH SEE ALSO
105 .B memory_object_data_request, memory_object_data_provided
106
107 .SH BUGS
108
109 The error code is currently ignored.
110
Cache object: cd7546fc12f1335162a064439a2f9a2f
|