Topic       : The ATARI Compendium
Author      : Scott Sanders / JAY Software
Version     : 1.25 (20/6/2003)
Subject     : Documentation
Nodes       : 1117
Index Size  : 32614
HCP-Version : 6
Compiled on : Atari
@charset    : UTF-8
@lang       : en
@default    : 
@help       : %About
@options    : +g -i -t4 +y +z
@width      : 100
View Ref-FilePsignal()
Pkill()                                                              GEMDOS

Syntax

WORD Pkill( pid, sig )
WORD pid, sig;

Function      Pkill() sends a signal to one or more processes.

Opcode        273 (0x111)

Availability  This function is available under all MiNT versions
              integrated with MultiTOS.

Parameters    Pkill() sends signal sig to certain processes based on the
              value of pid. If pid is positive, the signal is sent the the
              process with process identifier pid. If pid is 0, the signal
              is sent to all processes who belong to the same process
              group as the caller as well as the caller itself. If pid is
              negative, the signal is sent to all processes with process
              group number -pid.

Binding       move.w   sig,-(sp)
              move.w   pid,-(sp)
              move.w   #$111,-(sp)
              trap     #1
              addq.l   #6,sp

Return Value  Pkill() returns 0 if successful or a negative GEMDOS error
              code otherwise.

Comments      If the caller is also a recipient of a signal and that
              signal causes program termination this call will never
              return.

See Also      Psignal()