DATAMANIP (ksegops) functions


LIBRARY ROUTINE

lkrmseg - delete specified segments from an object creating new object

LIBRARY CALL

int 
lkrmseg(
   kobject source_object,
   char   *segment_list,
   kobject destination_object)

INPUT

OUTPUT

RETURN VALUE

TRUE (1) if one deleted, FALSE (0) if none deleted

DESCRIPTION

This routine will copy the source_object to the destination_object then delete the segment(s) specified by segment_list from the destination_object. Each segment's attributes and data will be delete. If segment_list is NULL it will delete all the segments in the object, but leave all object level attributes. The segment_list is a string that contains each segment name separated by space(s).

lkrmseg(source_object, "segment1 segment2", destination_object);

If the segment does not exist an error message is printed, but will not return until an attempt to delete all the segments has been done.

ADDITIONAL INFORMATION

none

EXAMPLES

none

SIDE EFFECTS

none

RESTRICTIONS

none

MODIFICATION

none

FILES

$DATAMANIP/objects/library/ksegops/src/lkrmseg.c

SEE ALSO

ksegops(3)

COPYRIGHT

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