cma_attr_create

Creates an attributes object.

Syntax

cma_attr_create( new_attr, attr);

Argument Data Type Access

new_attr opaque cma_t_attr write attr opaque cma_t_attr read

C Binding

#include 


void
cma_attr_create (
         cma_t_attr   *new_attr,
         cma_t_attr   *attr);

Arguments

new_attr: Variable that receives the new attributes object.
attr: Handle of an attributes object used to specify attributes of the new attributes object. If you specify cma_c_null for the attr argument, default attributes are used.

Description

This routine creates an attributes object that can be used to specify the attributes of DECthreads objects when they are created.

The individual attributes (internal fields) of the attributes object are set to default values. (The default values of each attribute are discussed in the descriptions of the following routines.) Use the following routines to change the individual attributes:

   cma_attr_set_guardsize
   cma_attr_set_inherit_sched
   cma_attr_set_mutex_kind
   cma_attr_set_priority
   cma_attr_set_sched
   cma_attr_set_stacksize

When an attributes object is used to create an object (for example, a thread or mutex), the values of the individual attributes determine the characteristics of the new object. Attributes objects act like additional arguments to object creation. Changing individual attributes does not affect any objects that were previously created using the attributes object.

When you set the scheduling policy or priority, or both, in an attributes object, you must disable scheduling inheritance before the scheduling attributes are used.

Exceptions

cma_e_existence
cma_e_use_error