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: host_processor_sets.man,v $
29 .\" Revision 2.5 93/03/18 15:14:05 mrt
30 .\" corrected types
31 .\" [93/03/12 16:51:51 lli]
32 .\"
33 .\" Revision 2.4 91/05/14 17:05:06 mrt
34 .\" Correcting copyright
35 .\"
36 .\" Revision 2.3 91/02/14 14:10:30 mrt
37 .\" Changed to new Mach copyright
38 .\" [91/02/12 18:10:37 mrt]
39 .\"
40 .\" Revision 2.2 90/08/07 18:35:07 rpd
41 .\" Created.
42 .\"
43 .TH host_processor_sets 2 8/13/89
44 .CM 4
45 .SH NAME
46 .nf
47 host_processor_sets \- gets processor_set ports name ports for a host
48 .SH SYNOPSIS
49 .nf
50 .ft B
51 #include <mach.h>
52
53 .nf
54 .ft B
55 kern_return_t
56 host_processor_sets(host, processor_set_list, processor_set_count)
57 mach_port_t host;
58 processor_set_array_t *processor_set_list; /* out, ptr to array */
59 mach_msg_type_number_t *processor_set_count; /* out */
60
61
62
63 .fi
64 .ft P
65 .SH ARGUMENTS
66 .TP 15
67 .B
68 host
69 The host to be affected.
70 .TP 15
71 .B
72 processor_set_list
73 The set of processor_sets currently existing on
74 .B host
75 ; no particular ordering is guaranteed.
76 .TP 15
77 .B
78 processor_set_count
79 The number of processor_sets in the
80 .B processor_set_list.
81
82 .SH DESCRIPTION
83 .B host_processor_sets
84 gets send rights to the name port for each processor_set
85 currently assigned to
86 .B host.
87
88 .B host_processor_set_priv
89 can be used to obtain the object ports from these if desired.
90 .B processor_set_list
91 is an array that is
92 created as a result of this call. The caller may wish to
93 .B vm_deallocate
94 this array when the data is no longer needed.
95
96 .SH DIAGNOSTICS
97 .TP 25
98 KERN_SUCCESS
99 The call succeeded.
100 .TP 25
101 KERN_INVALID_ARGUMENT
102 .B host
103 is not a host.
104
105 .SH BUGS
106 Availability limited.
107
108 .SH SEE ALSO
109 .B host_processor_set_priv, processor_set_create, processor_set_tasks,
110 .B processor_set_threads
111
Cache object: 4a75e84cf5cf1edd5410115525a53487
|