DATASERV (kapputils) functions
LIBRARY ROUTINE
kapu_mask_ops - perform AND, OR, or XOR on data object masks
LIBRARY CALL
int kapu_mask_ops(
kobject dest_obj,
int operation,
int num_src_objs,
kvalist)
INPUT
- operation - defines operation to perform
- num_src_objs - number of source objects provided in kvalist
- kvalist - list of source objects (kobject)
OUTPUT
- dest_obj - destination object where resulting mask is stored
RETURN VALUE
TRUE (1) on success, FALSE (0) otherwise
DESCRIPTION
This function combines the masks of the source
objects according to the operation flag supplied.
Valid operations are:
KAPU_MASK_AND
KAPU_MASK_OR
KAPU_MASK_XOR
If no source object has a mask, then kapu_mask_ops
returns without modifying dest_obj.
If only one source object has a mask, then its mask
is copied to the destination object.
If more than one source object has a mask, then the
specified operation is performed on the source mask
data, and stored in dest_obj. dest_obj mask data,
if it exists, is not included in the operation.
Invalid objects (KOBJECT_INVALID) may be passed in.
ADDITIONAL INFORMATION
none
EXAMPLES
none
SIDE EFFECTS
Data may be written to mask of dest_object (mask may
be created if it does not already exist).
RESTRICTIONS
none
MODIFICATION
none
FILES
$DATASERV/objects/library/kapputils/src/utilities.c
SEE ALSO
kapputils(3)
COPYRIGHT
Copyright (C) 1993 - 1997, Khoral Research, Inc. ("KRI") All rights reserved.