DATASERV (kappserv) functions


LIBRARY ROUTINE

kpds_create_mask - create a mask segment within a data object.

LIBRARY CALL

int kpds_create_mask(
   kobject object)

INPUT

OUTPUT

none

RETURN VALUE

TRUE if the mask segment was successfully created, FALSE otherwise

DESCRIPTION

This function is used to create a mask segment within a specified data object. The size of the mask segment will be initialized to match any the sizes shared with any other polymorphic segments.

Note that the pad value for this segment is initalized to 1. This is done so that padded data is marked as valid according to the mask segment.

It is considered an error to create a mask segment if the object already contains one.

ADDITIONAL INFORMATION

none

EXAMPLES

none

SIDE EFFECTS

none

RESTRICTIONS

none

MODIFICATION

none

FILES

$DATASERV/objects/library/kappserv/src/pds_mask.c

SEE ALSO

kappserv(3)

COPYRIGHT

Copyright (C) 1993 - 1997, Khoral Research, Inc. ("KRI") All rights reserved.