[Previous] [Contents] [Index] [Next]

Caution: This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

aps

Manage adaptive scheduler partitions


Note: This utility is shipped only with the Adaptive Partitioning Technology Development Kit.

Syntax:

aps show [-d delay] [-f shorthand] [-l] [-v...]
         [partition_name ...]

aps create -b budget [-B critical_budget] partition_name

aps modify [-b budget] [-B critical_budget] partition_name

aps modify [-y bankruptcy_policy ...] [-S scheduling_policy...]
           [-s security_policy ...] [-w windowsize_ms]

Options:

-B milliseconds
Specify the critical CPU budget, in milliseconds. The default is 0.
-b budget
Specify the CPU budget as a percentage.
-d delay
The delay period, in tenths of a second, when using the -l option. The default is 50.
-f shorthand
Display the information specified by shorthand:

The default is usage.

-l
("el") Loop mode; display the information at the interval specified by the -d option.
-S scheduling_policy ...
Specify the policies for the adaptive partitioning scheduler. Each scheduling_policy must be one of:

The default is normal. For more information about the policies, see "Scheduling policies" in the entry for SchedCtl() in the Neutrino Library Reference.

-s security_policy ...
Specify the security policies to add to the system. Each security_policy must be one of:

The default is none. For more information about the policies, see the description of SCHED_APS_ADD_SECURITY in the entry for SchedCtl() in the Neutrino Library Reference.


Note: Once you've added a security policy, you can't remove it, except by rebooting the system.

-v...
Be verbose; display more information with the show command:
-w windowsize_ms
Set the size of the averaging window, in milliseconds, for the system. You can set the window size to any value from 8 ms to 400 ms.
Note: If you change the tick size of the system at runtime, do so before defining the adaptive partitioning scheduler's window size. That's because Neutrino converts the window size from milliseconds to clock ticks for internal use.

For more information, see "Choosing the window size" in the System Considerations chapter of the Adaptive Partitioning TDK User's Guide.
-y bankruptcy_policy ...
Set the bankruptcy policy for the system to the specified items. Each bankruptcy_policy must be one of:

The default is basic. For more information about the policies, see "Handling bankruptcy" in the entry for SchedCtl() in the Neutrino Library Reference.

Description:

Use the aps command to create, modify, and query adaptive partitions from the command line, as well as to set the averaging window, and the security and bankruptcy policies for the entire system.


Note: You can't include slashes (/) in a partition name.

To launch an application into a partition, use the -Xaps option to the on command.

Examples:

Create a partition called Drivers with a budget of 20% and a critical budget of 5 milliseconds:

aps create -b 20 -B 5 Drivers

Change the Drivers partition's budget to 25% and its critical budget to 7 milliseconds:

aps modify -b 25 -B 7 Drivers

Specify a bankruptcy policy of recommended and a security policy of root_makes_partitions for the entire system:

aps modify -y recommended -s root_makes_partitions

Display the amount of the budget and critical budget that the partitions are using, every 2 seconds:

aps show -l -d 20 -f usage

Since usage is the default shorthand for the -f option, the above command is the same as:

aps show -l -d 20

See also:

on, pidin

SchedCtl() in the Neutrino Library Reference

Adaptive Partitioning TDK User's Guide


[Previous] [Contents] [Index] [Next]