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
- source_object - object to delete the segment from
- segment_list - name of segment to delete
OUTPUT
- destination_object - object without the segment(s)
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.