source: rtems/doc/posix_users/process.t @ 0660b4f8

4.104.114.84.95
Last change on this file since 0660b4f8 was 0660b4f8, checked in by Joel Sherrill <joel.sherrill@…>, on 11/16/99 at 19:50:56

Changed copyright date to 1999.

  • Property mode set to 100644
File size: 6.1 KB
Line 
1@c
2@c COPYRIGHT (c) 1988-1999.
3@c On-Line Applications Research Corporation (OAR).
4@c All rights reserved.
5@c
6@c $Id$
7@c
8
9@chapter Process Creation and Execution Manager
10
11@section Introduction
12
13The process creation and execution manager is ...
14
15The directives provided by the process creation and execution manager are:
16
17@itemize @bullet
18@item @code{fork} - Create a Process
19@item @code{execl} - Execute a File
20@item @code{execv} - Execute a File
21@item @code{execle} - Execute a File
22@item @code{execve} - Execute a File
23@item @code{execlp} - Execute a File
24@item @code{execvp} - Execute a File
25@item @code{pthread_atfork} - Register Fork Handlers
26@item @code{wait} - Wait for Process Termination
27@item @code{waitpid} - Wait for Process Termination
28@item @code{_exit} - Terminate a Process
29@end itemize
30
31@section Background
32
33There is currently no text in this section.
34
35@section Operations
36
37There is currently no text in this section.
38
39@section Directives
40
41This section details the process creation and execution manager's directives.
42A subsection is dedicated to each of this manager's directives
43and describes the calling sequence, related constants, usage,
44and status codes.
45
46@c
47@c
48@c
49@page
50@subsection fork - Create a Process
51
52@findex fork
53@cindex  create a process
54
55@subheading CALLING SEQUENCE:
56
57@ifset is-C
58@example
59#include <sys/types.h>
60
61int fork( void );
62@end example
63@end ifset
64
65@ifset is-Ada
66@end ifset
67
68@subheading STATUS CODES:
69
70@table @b
71@item ENOSYS
72This routine is not supported by RTEMS.
73
74@end table
75
76@subheading DESCRIPTION:
77
78This routine is not supported by RTEMS.
79
80@subheading NOTES:
81
82NONE
83
84@c
85@c
86@c
87@page
88@subsection execl - Execute a File
89
90@findex execl
91@cindex  execute a file
92
93@subheading CALLING SEQUENCE:
94
95@ifset is-C
96@example
97int execl(
98const char *path,
99const char *arg,
100...
101);
102@end example
103@end ifset
104
105@ifset is-Ada
106@end ifset
107
108@subheading STATUS CODES:
109
110@table @b
111@item ENOSYS
112This routine is not supported by RTEMS.
113
114@end table
115
116@subheading DESCRIPTION:
117
118This routine is not supported by RTEMS.
119
120@subheading NOTES:
121
122NONE
123
124@c
125@c
126@c
127@page
128@subsection execv - Execute a File
129
130@findex execv
131@cindex  execute a file
132
133@subheading CALLING SEQUENCE:
134
135@ifset is-C
136@example
137int execv(
138const char *path,
139char const *argv[],
140...
141);
142@end example
143@end ifset
144
145@ifset is-Ada
146@end ifset
147
148@subheading STATUS CODES:
149
150@table @b
151@item ENOSYS
152This routine is not supported by RTEMS.
153
154@end table
155
156@subheading DESCRIPTION:
157
158This routine is not supported by RTEMS.
159
160@subheading NOTES:
161
162NONE
163
164@c
165@c
166@c
167@page
168@subsection execle - Execute a File
169
170@findex execle
171@cindex  execute a file
172
173@subheading CALLING SEQUENCE:
174
175@ifset is-C
176@example
177int execle(
178const char *path,
179const char *arg,
180...
181);
182@end example
183@end ifset
184
185@ifset is-Ada
186@end ifset
187
188@subheading STATUS CODES:
189
190@table @b
191@item ENOSYS
192This routine is not supported by RTEMS.
193
194@end table
195
196@subheading DESCRIPTION:
197
198This routine is not supported by RTEMS.
199
200@subheading NOTES:
201
202NONE
203
204@c
205@c
206@c
207@page
208@subsection execve - Execute a File
209
210@findex execve
211@cindex  execute a file
212
213@subheading CALLING SEQUENCE:
214
215@ifset is-C
216@example
217int execve(
218const char *path,
219char *const argv[],
220char *const envp[]
221);
222@end example
223@end ifset
224
225@ifset is-Ada
226@end ifset
227
228@subheading STATUS CODES:
229
230@table @b
231@item ENOSYS
232This routine is not supported by RTEMS.
233
234@end table
235
236@subheading DESCRIPTION:
237
238This routine is not supported by RTEMS.
239
240@subheading NOTES:
241
242NONE
243
244@c
245@c
246@c
247@page
248@subsection execlp - Execute a File
249
250@findex execlp
251@cindex  execute a file
252
253@subheading CALLING SEQUENCE:
254
255@ifset is-C
256@example
257int execlp(
258const char *file,
259const char *arg,
260...
261);
262@end example
263@end ifset
264
265@ifset is-Ada
266@end ifset
267
268@subheading STATUS CODES:
269
270@table @b
271@item ENOSYS
272This routine is not supported by RTEMS.
273
274@end table
275
276@subheading DESCRIPTION:
277
278This routine is not supported by RTEMS.
279
280@subheading NOTES:
281
282NONE
283
284@c
285@c
286@c
287@page
288@subsection execvp - Execute a File
289
290@findex execvp
291@cindex  execute a file
292
293@subheading CALLING SEQUENCE:
294
295@ifset is-C
296@example
297int execvp(
298const char *file,
299char *const argv[]
300...
301);
302@end example
303@end ifset
304
305@ifset is-Ada
306@end ifset
307
308@subheading STATUS CODES:
309
310@table @b
311@item ENOSYS
312This routine is not supported by RTEMS.
313
314@end table
315
316@subheading DESCRIPTION:
317
318This routine is not supported by RTEMS.
319
320@subheading NOTES:
321
322NONE
323
324@c
325@c
326@c
327@page
328@subsection pthread_atfork - Register Fork Handlers
329
330@findex pthread_atfork
331@cindex  register fork handlers
332
333@subheading CALLING SEQUENCE:
334
335@ifset is-C
336@example
337#include <sys/types.h>
338
339int pthread_atfork(
340void (*prepare)(void),
341void (*parent)(void),
342void (*child)(void)
343);
344@end example
345@end ifset
346
347@ifset is-Ada
348@end ifset
349
350@subheading STATUS CODES:
351
352@table @b
353@item ENOSYS
354This routine is not supported by RTEMS.
355
356@end table
357
358@subheading DESCRIPTION:
359
360This routine is not supported by RTEMS.
361
362@subheading NOTES:
363
364NONE
365
366@c
367@c
368@c
369@page
370@subsection wait - Wait for Process Termination
371
372@findex wait
373@cindex  wait for process termination
374
375@subheading CALLING SEQUENCE:
376
377@ifset is-C
378@example
379#include <sys/types.h>
380#include <sys/wait.h>
381
382int wait(
383int *stat_loc
384);
385@end example
386@end ifset
387
388@ifset is-Ada
389@end ifset
390
391@subheading STATUS CODES:
392
393@table @b
394@item ENOSYS
395This routine is not supported by RTEMS.
396
397@end table
398
399@subheading DESCRIPTION:
400
401This routine is not supported by RTEMS.
402
403@subheading NOTES:
404
405NONE
406
407@c
408@c
409@c
410@page
411@subsection waitpid - Wait for Process Termination
412
413@findex waitpid
414@cindex  wait for process termination
415
416@subheading CALLING SEQUENCE:
417
418@ifset is-C
419@example
420int wait(
421pid_t pid,
422int *stat_loc,
423int options
424);
425@end example
426@end ifset
427
428@ifset is-Ada
429@end ifset
430
431@subheading STATUS CODES:
432
433@table @b
434@item ENOSYS
435This routine is not supported by RTEMS.
436
437@end table
438
439@subheading DESCRIPTION:
440
441This routine is not supported by RTEMS.
442
443@subheading NOTES:
444
445NONE
446
447@c
448@c
449@c
450@page
451@subsection _exit - Terminate a Process
452
453@findex _exit
454@cindex  terminate a process
455
456@subheading CALLING SEQUENCE:
457
458@ifset is-C
459@example
460void _exit(
461int status
462);
463@end example
464@end ifset
465
466@ifset is-Ada
467@end ifset
468
469@subheading STATUS CODES:
470
471NONE
472
473@subheading DESCRIPTION:
474
475The @code{_exit()} function terminates the calling process.
476
477@subheading NOTES:
478
479In RTEMS, a process is equivalent to the entire application on a single
480processor. Invoking this service terminates the application.
Note: See TracBrowser for help on using the repository browser.