1 # setpriority.cif

     2 # 

     3 # Copyright (c) 2010 Accenture. All rights reserved.

     4 # This component and the accompanying materials are made available

     5 # under the terms of the "Eclipse Public License v1.0"

     6 # which accompanies this distribution, and is available

     7 # at the URL "http://www.eclipse.org/legal/epl-v10.html".

     8 # 

     9 # Initial Contributors:

    10 # Accenture - Initial contribution

    11 #

    12 

    13 ==name setpriority

    14 

    15 ==short-description

    16 

    17 Set the priority of a thread or process.

    18 

    19 ==long-description

    20 

    21 For threads, the priority must be either an absolute kernel priority between 0 and 64, or a relative thread priority as follows:

    22 

    23     Idle:       101

    24     MuchLess:   102

    25     Less:       103

    26     Normal:     104

    27     More:       105

    28     MuchMore:   106

    29     RealTime:   107

    30 

    31 For processes, the only settable priorities are:

    32 

    33     Low:        150

    34     Background: 250

    35     Foreground: 350

    36     High:       450

    37 

    38 ==argument int priority

    39 

    40 The priority to set.

    41 

    42 ==option string m match

    43 

    44 Wait for threads matching the passed in name to be created, and change their priority when they do. Pass in a name or wildcarded partial name. For example to set all threads created in tail.exe to priority 19, do: C<setpriority 19 -m tail.exe*>

    45 

    46 ==option uint p pid multiple

    47 

    48 The ID of the process whose priority you want to change.

    49 

    50 ==option uint t tid multiple

    51 

    52 The ID of the thread whose priority you want to change.

    53 

    54 ==copyright

    55 

    56 Copyright (c) 2008-2010 Accenture. All rights reserved.

    57