summaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorJoel Sherrill <joel.sherrill@OARcorp.com>1998-09-25 13:24:00 +0000
committerJoel Sherrill <joel.sherrill@OARcorp.com>1998-09-25 13:24:00 +0000
commit1ee9a1a715e3242dac4673eb82e2faa767306a1d (patch)
tree0c0dce434662390280da4f531d717ef8a7ef429a /doc
parentAdded ENOSYS stubs for a number of process routines. (diff)
downloadrtems-1ee9a1a715e3242dac4673eb82e2faa767306a1d.tar.bz2
Added information on every service in this chapter. Most of them are
ENOSYS stubs at this time.
Diffstat (limited to 'doc')
-rw-r--r--doc/new_chapters/process.t174
1 files changed, 123 insertions, 51 deletions
diff --git a/doc/new_chapters/process.t b/doc/new_chapters/process.t
index f1c28b9e72..b58e16f017 100644
--- a/doc/new_chapters/process.t
+++ b/doc/new_chapters/process.t
@@ -16,17 +16,17 @@ process creation and execution manager is ...
The directives provided by the process creation and execution manager are:
@itemize @bullet
-@item @code{fork} -
-@item @code{execl} -
-@item @code{execv} -
-@item @code{execle} -
-@item @code{execve} -
-@item @code{execlp} -
-@item @code{execvp} -
-@item @code{pthread_atfork} -
-@item @code{wait} -
-@item @code{waitpid} -
-@item @code{_exit} -
+@item @code{fork} - Create a Process
+@item @code{execl} - Execute a File
+@item @code{execv} - Execute a File
+@item @code{execle} - Execute a File
+@item @code{execve} - Execute a File
+@item @code{execlp} - Execute a File
+@item @code{execvp} - Execute a File
+@item @code{pthread_atfork} - Register Fork Handlers
+@item @code{wait} - Wait for Process Termination
+@item @code{waitpid} - Wait for Process Termination
+@item @code{_exit} - Terminate a Process
@end itemize
@section Background
@@ -41,14 +41,15 @@ and describes the calling sequence, related constants, usage,
and status codes.
@page
-@subsection fork -
+@subsection fork - Create a Process
@subheading CALLING SEQUENCE:
@ifset is-C
@example
-int fork(
-);
+#include <sys/types.h>
+
+int fork( void );
@end example
@end ifset
@@ -58,23 +59,30 @@ int fork(
@subheading STATUS CODES:
@table @b
-@item E
-The
+@item ENOSYS
+This routine is not supported by RTEMS.
@end table
@subheading DESCRIPTION:
+This routine is not supported by RTEMS.
+
@subheading NOTES:
+NONE
+
@page
-@subsection execl -
+@subsection execl - Execute a File
@subheading CALLING SEQUENCE:
@ifset is-C
@example
int execl(
+ const char *path,
+ const char *arg,
+ ...
);
@end example
@end ifset
@@ -85,23 +93,30 @@ int execl(
@subheading STATUS CODES:
@table @b
-@item E
-The
+@item ENOSYS
+This routine is not supported by RTEMS.
@end table
@subheading DESCRIPTION:
+This routine is not supported by RTEMS.
+
@subheading NOTES:
+NONE
+
@page
-@subsection execv -
+@subsection execv - Execute a File
@subheading CALLING SEQUENCE:
@ifset is-C
@example
int execv(
+ const char *path,
+ char const *argv[],
+ ...
);
@end example
@end ifset
@@ -112,23 +127,30 @@ int execv(
@subheading STATUS CODES:
@table @b
-@item E
-The
+@item ENOSYS
+This routine is not supported by RTEMS.
@end table
@subheading DESCRIPTION:
+This routine is not supported by RTEMS.
+
@subheading NOTES:
+NONE
+
@page
-@subsection execle -
+@subsection execle - Execute a File
@subheading CALLING SEQUENCE:
@ifset is-C
@example
int execle(
+ const char *path,
+ const char *arg,
+ ...
);
@end example
@end ifset
@@ -139,23 +161,30 @@ int execle(
@subheading STATUS CODES:
@table @b
-@item E
-The
+@item ENOSYS
+This routine is not supported by RTEMS.
@end table
@subheading DESCRIPTION:
+This routine is not supported by RTEMS.
+
@subheading NOTES:
+NONE
+
@page
-@subsection execve -
+@subsection execve - Execute a File
@subheading CALLING SEQUENCE:
@ifset is-C
@example
int execve(
+ const char *path,
+ char *const argv[],
+ char *const envp[]
);
@end example
@end ifset
@@ -166,23 +195,30 @@ int execve(
@subheading STATUS CODES:
@table @b
-@item E
-The
+@item ENOSYS
+This routine is not supported by RTEMS.
@end table
@subheading DESCRIPTION:
+This routine is not supported by RTEMS.
+
@subheading NOTES:
+NONE
+
@page
-@subsection execlp -
+@subsection execlp - Execute a File
@subheading CALLING SEQUENCE:
@ifset is-C
@example
int execlp(
+ const char *file,
+ const char *arg,
+ ...
);
@end example
@end ifset
@@ -193,23 +229,30 @@ int execlp(
@subheading STATUS CODES:
@table @b
-@item E
-The
+@item ENOSYS
+This routine is not supported by RTEMS.
@end table
@subheading DESCRIPTION:
+This routine is not supported by RTEMS.
+
@subheading NOTES:
+NONE
+
@page
-@subsection execvp -
+@subsection execvp - Execute a File
@subheading CALLING SEQUENCE:
@ifset is-C
@example
int execvp(
+ const char *file,
+ char *const argv[]
+ ...
);
@end example
@end ifset
@@ -220,23 +263,32 @@ int execvp(
@subheading STATUS CODES:
@table @b
-@item E
-The
+@item ENOSYS
+This routine is not supported by RTEMS.
@end table
@subheading DESCRIPTION:
+This routine is not supported by RTEMS.
+
@subheading NOTES:
+NONE
+
@page
-@subsection pthread_atfork -
+@subsection pthread_atfork - Register Fork Handlers
@subheading CALLING SEQUENCE:
@ifset is-C
@example
+#include <sys/types.h>
+
int pthread_atfork(
+ void (*prepare)(void),
+ void (*parent)(void),
+ void (*child)(void)
);
@end example
@end ifset
@@ -247,23 +299,31 @@ int pthread_atfork(
@subheading STATUS CODES:
@table @b
-@item E
-The
+@item ENOSYS
+This routine is not supported by RTEMS.
@end table
@subheading DESCRIPTION:
+This routine is not supported by RTEMS.
+
@subheading NOTES:
+NONE
+
@page
-@subsection wait -
+@subsection wait - Wait for Process Termination
@subheading CALLING SEQUENCE:
@ifset is-C
@example
+#include <sys/types.h>
+#include <sys/wait.h>
+
int wait(
+ int *stat_loc
);
@end example
@end ifset
@@ -274,23 +334,30 @@ int wait(
@subheading STATUS CODES:
@table @b
-@item E
-The
+@item ENOSYS
+This routine is not supported by RTEMS.
@end table
@subheading DESCRIPTION:
+This routine is not supported by RTEMS.
+
@subheading NOTES:
+NONE
+
@page
-@subsection waitpid -
+@subsection waitpid - Wait for Process Termination
@subheading CALLING SEQUENCE:
@ifset is-C
@example
-int waitpid(
+int wait(
+ pid_t pid,
+ int *stat_loc,
+ int options
);
@end example
@end ifset
@@ -301,23 +368,28 @@ int waitpid(
@subheading STATUS CODES:
@table @b
-@item E
-The
+@item ENOSYS
+This routine is not supported by RTEMS.
@end table
@subheading DESCRIPTION:
+This routine is not supported by RTEMS.
+
@subheading NOTES:
+NONE
+
@page
-@subsection _exit -
+@subsection _exit - Terminate a Process
@subheading CALLING SEQUENCE:
@ifset is-C
@example
-int _exit(
+void _exit(
+ int status
);
@end example
@end ifset
@@ -327,13 +399,13 @@ int _exit(
@subheading STATUS CODES:
-@table @b
-@item E
-The
-
-@end table
+NONE
@subheading DESCRIPTION:
+The @code{_exit()} function terminates the calling process.
+
@subheading NOTES:
+In RTEMS, a process is equivalent to the entire application on a single
+processor. Invoking this service terminates the application.