class_create(3) — Subroutines

NAME

class_create − create a new scheduling class

SYNOPSIS

#include <apar_types.h>
#include <sys/class.h> class_create(
        class_apar_handle_t handle,
        char ∗class_name,
        struct resource_limits ∗limits );

LIBRARY

Scheduling Class Library (libclass.a)

This library is not available as a shared library.

PARAMETERS

handle
The partition descriptor returned by class_open().

class_name
The name of the class to change.

limits
The input is the new resource limits, the output is the resources available.

DESCRIPTION

Create a new class. The created class will be empty. Use class_add() to populate the class. If the requested percentage causes the total percentage of all classes to exceed 100%, the call will fail and avail will contain the remaining percentage available.

Specify CLASS_RESOURCE_SCHED_DISABLED for the target limit of any resource that is not needed.

Note that the calling process must have root access privileges.

RETURN VALUES

[CLASS_SUCCESS]
The operation completed successfully.

[CLASS_INVAL_PARTITION]
An invalid partition handle was specified.

[CLASS_NAME_INVALID]
The class_name is not an ASCII string.

[CLASS_NAME_IN_USE]
The class_name already exists.

[CLASS_NO_SPACE]
No space was available in class_name.

[CLASS_INVAL_PERCENT]
The requested percentage was not in the range 0 - 100 or was not CLASS_RESOURCE_SCHED_DISABLED or CLASS_RESOURCE_SCHED_DISABLED.

[CLASS_TOO_HIGH_PERCENT]
The requested percentage was not available. The struct resource_percent <xxx-available> (where xxx is an integer in the range 0-100 representing percentage) will contain the maximum available percentage.

Museum

Related Articles