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

OUTPUT

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.