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_tasks.man,v $
29 .\" Revision 2.5 93/03/18 15:14:35 mrt
30 .\" corrected types
31 .\" [93/03/11 12:54:31 lli]
32 .\"
33 .\" Revision 2.4 91/05/14 17:12:05 mrt
34 .\" Correcting copyright
35 .\"
36 .\" Revision 2.3 91/02/14 14:14:15 mrt
37 .\" Changed to new Mach copyright
38 .\" [91/02/12 18:15:09 mrt]
39 .\"
40 .\" Revision 2.2 90/08/07 18:43:03 rpd
41 .\" Created.
42 .\"
43 .TH processor_set_tasks 2 8/13/89
44 .CM 4
45 .SH NAME
46 .nf
47 processor_set_tasks /- gets task ports for tasks 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_tasks(processor_set, task_list, task_count)
56 mach_port_t processor_set;
57 task_array_t *task_list; /* out, ptr to array */
58 mach_msg_type_number_t *task_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 task_list
71 The set of tasks currently assigned to
72 .B processor_set
73 ;
74 no particular ordering is guaranteed.
75 .TP 15
76 .B
77 task_count
78 The number of tasks in the
79 .B task_list.
80
81 .SH DESCRIPTION
82 .B processor_set_tasks
83 gets send rights to the kernel port for each task
84 currently assigned to
85 .B processor_set.
86
87 .B task_list
88 is an array that is
89 created as a result of this call. The caller may wish to
90 .B vm_deallocate
91 this array when the data is no longer needed.
92
93 .SH DIAGNOSTICS
94 .TP 25
95 KERN_SUCCESS
96 The call succeeded.
97 .TP 25
98 KERN_INVALID_ARGUMENT
99 .B processor_set
100 is not a processor_set.
101
102 .SH BUGS
103 Availability limited.
104
105 .SH SEE ALSO
106 .B task_assign, thread_assign, processor_set_threads
107
108
109
Cache object: 85c0ff541aa41bd9318e701d95ed160c
|