1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
|
/* RPCs which a friendly Hurd process will understand on its message port.
Copyright (C) 1991, 1992, 1993, 1994, 1995 Free Software Foundation, Inc.
This file is part of the GNU Hurd.
The GNU Hurd is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2, or (at your option)
any later version.
The GNU Hurd is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with the GNU Hurd; see the file COPYING. If not, write to
the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA. */
subsystem msg 23000;
#include <hurd/hurd_types.defs>
#ifdef MSG_IMPORTS
MSG_IMPORTS
#endif
/* WARNING: The file hurd/proc/stubs.c knows the RPC message ID's
and formats for some of the RPC's in this file. */
/* Post a signal to the process. The refport indicates some
permission attribute that the caller provides in the hope that the
receiver will honor the signal. Conventional values include:
Port Signals honored
task port all
session ID (see proc_getsidport) CONT
ctty port (see term_getctty) INT, QUIT, TSTP, HUP
async IO ID (see io_async) URG, IO
*/
routine msg_sig_post (
process: mach_port_t;
sreplyport reply_port: sreply_port_t;
signal: int;
refport: mach_port_t);
/* The parent or the process group of a process has been changed, or
the orphaned status has changed. The task port is sent so that the
recipient can know it's OK to honor the call. */
routine msg_proc_newids (
process: mach_port_t;
task: task_t;
ppid: pid_t;
pgrp: pid_t;
orphaned: int);
/* Do a reauth after or-ing in new id's. */
routine msg_add_auth (
process: mach_port_t;
auth: auth_t);
/* Do a reauth after removing auth information. The task port is
provided as an attempt at security. */
routine msg_del_auth (
process: mach_port_t;
task: task_t;
uids: intarray_t;
gids: intarray_t);
/* These eight calls fetch and store the ports and other information
that were passed to the process at exec time (see hurd_types.h).
The REFPORT can be the task port or the auth port. */
routine msg_get_init_port (
process: mach_port_t;
refport: mach_port_t;
which: int;
out port: mach_port_send_t);
routine msg_set_init_port (
process: mach_port_t;
refport: mach_port_t;
which: int;
port: mach_port_send_t);
routine msg_get_init_ports (
process: mach_port_t;
refport: mach_port_t;
out ports: portarray_t, dealloc);
routine msg_set_init_ports (
process: mach_port_t;
refport: mach_port_t;
ports: portarray_t);
routine msg_get_init_int (
process: mach_port_t;
refport: mach_port_t;
which: int;
out value: int);
routine msg_set_init_int (
process: mach_port_t;
refport: mach_port_t;
which: int;
value: int);
routine msg_get_init_ints (
process: mach_port_t;
refport: mach_port_t;
out values: intarray_t, dealloc);
routine msg_set_init_ints (
process: mach_port_t;
refport: mach_port_t;
values: intarray_t);
/* These two calls fetch and store the file descriptor table. */
routine msg_get_dtable (
process: mach_port_t;
refport: mach_port_t;
out dtable: portarray_t, dealloc);
routine msg_set_dtable (
process: mach_port_t;
refport: mach_port_t;
dtable: portarray_t);
/* These two calls fetch and store a single file descriptor. */
routine msg_get_fd (
process: mach_port_t;
refport: mach_port_t;
fd: int;
out port: mach_port_send_t);
routine msg_set_fd (
process: mach_port_t;
refport: mach_port_t;
fd: int;
port: mach_port_send_t);
/* These two calls fetch and store the whole environment,
in "a=b\0c=d\0" form. */
routine msg_get_environment (
process: mach_port_t;
out value: data_t, dealloc);
routine msg_set_environment (
process: mach_port_t;
refport: mach_port_t;
value: data_t);
/* These two calls fetch and store a single environment variable. */
routine msg_get_env_variable (
process: mach_port_t;
variable: string_t;
out value: data_t, dealloc);
routine msg_set_env_variable (
process: mach_port_t;
refport: mach_port_t;
variable: string_t;
value: string_t;
replace: boolean_t);
skip; /* Obsolete io_select_done. */
/* This is sent by the startup server when the system is going down. */
routine msg_startup_dosync (
process: mach_port_t);
/* Like msg_sig_post, but the receiver should ignore his trace bit
and deliver the signal normally even if traced, first resuming if
he was suspended. */
routine msg_sig_post_untraced (
process: mach_port_t;
sreplyport reply_port: sreply_port_t;
signal: int;
refport: mach_port_t);
/* Get the exec flags of the process. */
routine msg_get_exec_flags (
process: mach_port_t;
refport: mach_port_t;
out flags: int);
/* Set the exec flags value, or set or clear some flag bits.
Setting or clearing certain flag bits may cause associated actions.
For example, setting the EXEC_TRACED bit causes the program to
stop immediately as if it had received a `msg_sig_post_untraced'
with signal SIGTRAP. */
routine msg_set_all_exec_flags (
process: mach_port_t;
refport: mach_port_t;
flags: int);
routine msg_set_some_exec_flags (
process: mach_port_t;
refport: mach_port_t;
flags: int);
routine msg_clear_some_exec_flags (
process: mach_port_t;
refport: mach_port_t;
flags: int);
/* Return a string describing why THREAD is waiting. (THREAD should
be interpreted as an index into the threads as ordered by the
kernel in task_threads.) If the thread is not waiting, or the reason
is unknown, return an empty string. */
routine msg_report_wait (
process: mach_port_t;
thread: int;
out wait_reason: string_t);
|