CreateProc

Create a new Process

CreateProc() creates a new AmigaDOS Process of name 'name'. AmigaDOS Processes are a superset of exec Tasks.

A seglist, as returned by LoadSeg(), is passed as 'seglist'. This represents a section of code which is to be run as a new Process. The code is entered at the first hunk in the segment list, which should contain suitable initialization code or a jump to such. A Process control structure is allocated from memory and initialized.

The argument 'name' specifies the new Process name. 'pri' specifies the required priority of the new Process which must be a number in the range -128..127. The size of the root stack upon activation is passed as 'stackSize'.

The seglist passed to CreateProc() is not freed when it exits; it is up to the parent Process to free it, or for the code to unload itself.

Under V36 and later, you should use CreateNewProc() instead.

name

pointer to a null-terminated string

pri

signed long (range -128 to +127)

seglist

BCPL pointer to a seglist

stackSize

integer (must be a multiple of 4 bytes)

msgport

pointer to new Process MsgPort or NULL for failure; call IoErr() to find out why the Process creation failed.

It is not safe to call this function from a Task!

The documentation for CreateProc() always suggested that the pointer returned was a Process. This was never the case. The result has always been either NULL or a pointer to the Process.pr_MsgPort which is part of the Process structure.

If you wish to fake a seglist (that will never have UnLoadSeg() called on it), use this assembly language data/code fragment:

This approach may have merit on Kickstart 1.2/1.3 (V33/V34) but should not be used on Kickstart 2.0 (V36) and beyond.

CreateNewProc(), LoadSeg(), UnLoadSeg(), <exec/ports.h>, <dos/dosextens.h>