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