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: mach_reply_port.man,v $
29 .\" Revision 2.4 91/05/14 17:08:07 mrt
30 .\" Correcting copyright
31 .\"
32 .\" Revision 2.3 91/02/14 14:12:18 mrt
33 .\" Changed to new Mach copyright
34 .\" [91/02/12 18:12:30 mrt]
35 .\"
36 .\" Revision 2.2 90/08/07 18:38:44 rpd
37 .\" Created.
38 .\"
39 .TH mach_reply_port 2 9/19/86
40 .CM 4
41 .SH NAME
42 .nf
43 mach_reply_port \- create a reply port
44 .SH SYNOPSIS
45 .nf
46 .ft B
47 #include <mach/mach_traps.h>
48
49 mach_port_t mach_reply_port();
50 .fi
51 .ft P
52 .SH DESCRIPTION
53 The \fBmach_reply_port\fR system call creates
54 a reply port in the calling task.
55
56 \fBmach_reply_port\fR creates a port, giving the calling
57 task the receive right for the port. The call returns
58 the name of the new receive right.
59
60 This is very much like creating a receive right
61 with the \fBmach_port_allocate(2)\fR call,
62 with two differences. First, \fBmach_reply_port\fR
63 is a system call and not an RPC (which requires a reply port).
64 Second, the port created by \fBmach_reply_port\fR may be
65 optimized for use as a reply port.
66 .SH DIAGNOSTICS
67 .TP 25
68 MACH_PORT_NULL
69 A resource shortage prevented the creation of the receive right.
70 .SH SEE ALSO
71 mach_port_allocate(2).
Cache object: dc6206434ad7a0d8e97d51774660e4ff
|