Topic       : TOS - das Betriebssystem
Author      : 
Version     : tos.hyp (5. März 2013)
Subject     : Programmieren/Atari
Nodes       : 3001
Index Size  : 93602
HCP-Version : 5
Compiled on : Atari
@charset    : atarist
@lang       : 
@default    : Titel
@help       : 
@options    : +g -i -s +x +zz -t4
@width      : 70
View Ref-File5.11.28  Psetpriority                                              TOS

 Name:         »Psetpriority« - sets the current priority value for a 
               process.

 Gemdosnummer: 345 (0x0159)

 Deklaration:  int32_t Psetpriority ( int16_t which, int16_t who, 
               int16_t pri );

 Beschreibung: This function sets the priority pri (not an increment 
               but an absolute value) for the processes specified by 
               which and who. The interpretation of parameter who 
               depends on which:

               PRIO_PROCESS (0) sets the priority of process with 
               process id which. A who of 0 implies the process id of 
               the calling process.

               PRIO_PGRP (1) sets the priority of the process group 
               with process group id who. A who of 0 implies the 
               process group id of the calling process.

               PRIO_USER (2) sets the priority of the process of the 
               user with user id who. A who of 0 implies the user id 
               of the calling process.

               The pri argument is silently changed to the maximum 
               (resp. minimum) possible value if it is not in the 
               range between PRIO_MIN (-20) and PRIO_MAX (+20).

               This call makes calls Pnice and Prenice obsolete.

 Ergebnis:     The function returns E_OK on success or a negative 
               error code otherwise. The following error conditions 
               are defined:

               EINVAL, invalid argument for who, which or pri.

               EACCES, the calling process is not an owner of one or 
               more of the selected processes. The other selected 
               processes are still affected. EPERM, the calling 
               process does not have privileges to change the priority 
               of one or more of the selected processes. This can only 
               happen if an attempt was made to change the priority of 
               a process to a positive value.

               ESRCH, the combination of which and who does not match 
               any existing process.

               The error condition reported is the last error 
               condition encountered (in other words if both EACCES 
               and EPERM occur the return value is arbitrary).

 Verfügbar:    ab MiNT 1.15.0

 Gruppe:       Prozessfunktionen

 Querverweis:  Binding   Pgetpriority