view docs/ccguide/os9fork.refentry @ 2798:b70d93f8d7ce lwtools-port

Updated coco1/modules/makefile and coco3/modules/makefile to help resolve issues with i(x) and s(x) descriptors. Updated level1/coco1/modules/makefile & level2/coco3/modules/makefile so that correct values would be sent to assembler when building superdesc.asm for s(x).dd and i(x).dd descriptors.
author drencor-xeen
date Mon, 28 Jan 2013 16:13:05 -0600
parents 42b2c775f05f
children
line wrap: on
line source

<refentry id="os9fork">
<refnamediv>
<refname>Os9fork</refname>
<refpurpose>create a process</refpurpose>
</refnamediv>

<refsynopsisdiv>
<funcsynopsis>
<funcprototype>
  <funcdef><function>os9fork</function></funcdef>
  <paramdef>char *<parameter>modname</parameter></paramdef>
  <paramdef>int <parameter>paramsize</parameter></paramdef>
  <paramdef>char *<parameter>paramptr</parameter></paramdef>
  <paramdef>int <parameter>type</parameter></paramdef>
  <paramdef>int <parameter>lang</parameter></paramdef>
  <paramdef>int <parameter>datasize</parameter></paramdef>
</funcprototype>
</funcsynopsis>

</refsynopsisdiv>

<refsect1><title>Assembler Equivalent</title>
<para>
os9 F$FORK
</para>
</refsect1>

<refsect1><title>Description</title>
<para>
The action of F$FORK is desribed fully in the OS-9 System
Programmer's Manual. Os9fork will create a process that will
run concurrently with the calling process. When the forked
process terminates, it will return to the calling process.
</para>
<para>
"Modname" should point to the name of the desired module.
"Paramsize" is the length of the parameter string which should
normally be terminated with a '\n', and "paramptr" points to
the parameter string. "Type" is the module type as found in
the header(normally 1: program), and "lang" should match the
language nibble in the module header (C programs have 1 for
6809 machine code here). "Datasize" may be zero, or it may
contain the number of 256 byte pages to give to the new process
as initial allocation of memory.
</para>
</refsect1>
<refsect1><title>Diagnostics</title>
<para>
-1 will be returned on error, or the ID number of the child
process will be returned on success.
</para>
</refsect1>

</refentry>