Topic       : TOS - The Operating System
Author      : 
Version     : tos.hyp (December 19, 2008)
Subject     : Programmieren/Atari
Nodes       : 3010
Index Size  : 93790
HCP-Version : 5
Compiled on : Atari
@charset    : atarist
@lang       : 
@default    : Title
@help       : 
@options    : +g -i -s +x +zz -t4
@width      : 70
View Ref-File5.12.15  Pkill                                                     TOS

 Name:         »Pkill« - Send a signal to one or more processes.

 Opcode:       273

 Syntax:       int16_t Pkill ( int16_t pid, int16_t sig );

 Description:  The function Pkill sends the signal sig to one or more 
               processes. The following apply for the parameter pid:

                pid  Meaning

                > 0  The signal will be sent to the process with the 
                     specified pid
                = 0  The signal will be sent to all processes of the 
                     corresponding process group (this includes the 
                     caller itself too!)
                < 0  The signal will be sent to all processes with the 
                     group number -pid

               The signal SIGNULL is not handled by Pkill in the usual 
               way. It can be used to test the existence of a process. 
               For this one sends it a SIGNULL, and checks whether 
               Pkill returns with the value 0.

               MagiC only supports PIDs > 0.

 Return value: The function can return the following results:

                E_OK  :  No error has arisen
                EFILNF:  If pid > 0 and the specified process no 
                         longer exists, or if pid < 0 and the 
                         specified process group has no members any 
                         more
                EACCDN:  If pid > 0, and the sending process has no 
                         EUID of 0 and in addition if the UID of the 
                         receiving process differs from the sending 
                         one
                ERANGE:  sig is an invalid signal

               Note: If the current process receives the signal iself 
               and is terminated, the function does not return!

 Availability: As of the first in MultiTOS integrated MiNT version 
               1.04 and MagiC as of Version 4.50.

 Group:        Process functions

 See also:     Binding   Psetpgrp   Psignal   Signals