|
466
|
1 <refentry id="os9fork">
|
|
|
2 <refnamediv>
|
|
468
|
3 <refname>Os9fork</refname>
|
|
|
4 <refpurpose>create a process</refpurpose>
|
|
466
|
5 </refnamediv>
|
|
|
6
|
|
|
7 <refsynopsisdiv>
|
|
|
8 <funcsynopsis>
|
|
|
9 <funcprototype>
|
|
|
10 <funcdef><function>os9fork</function></funcdef>
|
|
552
|
11 <paramdef>char *<parameter>modname</parameter></paramdef>
|
|
|
12 <paramdef>int <parameter>paramsize</parameter></paramdef>
|
|
|
13 <paramdef>char *<parameter>paramptr</parameter></paramdef>
|
|
|
14 <paramdef>int <parameter>type</parameter></paramdef>
|
|
|
15 <paramdef>int <parameter>lang</parameter></paramdef>
|
|
|
16 <paramdef>int <parameter>datasize</parameter></paramdef>
|
|
466
|
17 </funcprototype>
|
|
|
18 </funcsynopsis>
|
|
|
19
|
|
|
20 </refsynopsisdiv>
|
|
|
21
|
|
542
|
22 <refsect1><title>Assembler Equivalent</title>
|
|
|
23 <para>
|
|
|
24 os9 F$FORK
|
|
|
25 </para>
|
|
|
26 </refsect1>
|
|
|
27
|
|
466
|
28 <refsect1><title>Description</title>
|
|
|
29 <para>
|
|
602
|
30 The action of F$FORK is desribed fully in the OS-9 System
|
|
|
31 Programmer's Manual. Os9fork will create a process that will
|
|
|
32 run concurrently with the calling process. When the forked
|
|
|
33 process terminates, it will return to the calling process.
|
|
|
34 </para>
|
|
|
35 <para>
|
|
|
36 "Modname" should point to the name of the desired module.
|
|
|
37 "Paramsize" is the length of the parameter string which should
|
|
|
38 normally be terminated with a '\n', and "paramptr" points to
|
|
|
39 the parameter string. "Type" is the module type as found in
|
|
|
40 the header(normally 1: program), and "lang" should match the
|
|
|
41 language nibble in the module header (C programs have 1 for
|
|
|
42 6809 machine code here). "Datasize" may be zero, or it may
|
|
|
43 contain the number of 256 byte pages to give to the new process
|
|
|
44 as initial allocation of memory.
|
|
466
|
45 </para>
|
|
|
46 </refsect1>
|
|
552
|
47 <refsect1><title>Diagnostics</title>
|
|
|
48 <para>
|
|
|
49 -1 will be returned on error, or the ID number of the child
|
|
|
50 process will be returned on success.
|
|
|
51 </para>
|
|
|
52 </refsect1>
|
|
|
53
|
|
466
|
54 </refentry>
|
