# setpriority.cif

# 

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

# This component and the accompanying materials are made available

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

# which accompanies this distribution, and is available

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

# 

# Initial Contributors:

# Accenture - Initial contribution

#

==name setpriority

==short-description

Set the priority of a thread or process.

==long-description

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

    Idle:       101

    MuchLess:   102

    Less:       103

    Normal:     104

    More:       105

    MuchMore:   106

    RealTime:   107

For processes, the only settable priorities are:

    Low:        150

    Background: 250

    Foreground: 350

    High:       450

==argument int priority

The priority to set.

==option string m match

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*>

==option uint p pid multiple

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

==option uint t tid multiple

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

==copyright

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