DATASERV (kdataman) functions
LIBRARY ROUTINE
kdms_set_segment - assign information to a segment directly
LIBRARY CALL
int
kdms_set_segment(
kobject object,
char *segment,
int dimension,
int *size,
int *order,
int datatype,
kaddr data)
INPUT
- object - The object to set a segment on.
- segment - The name of the segment to set.
- dimension - The dimensionality of the segment to assign.
- size - The size of the segment to assign.
- order - The order of the segment to assign.
- datatype - The datatype of the segment to assign.
- data - The actual segment data, or NULL. If this
argument is provided, the data must be
stored in memory according to the physical
characteristics provided above. The data
will not be copied, but instead it will
be assigned directly, so don't free it.
OUTPUT
none
RETURN VALUE
TRUE if successful, FALSE otherwise
DESCRIPTION
This function is used to directly assign information
to a data segment. This should only be done inside
of file format glue routines, in their input routine.
The characteristics are assigned directly to the new
segment. The segment will be created if it does not
yet exist.
The data argument is optional, as the data retrieval
can either be defered until it is needed, or, if the
large data set function locate_segment() is defined
for that format, the large data set management will
be handle all reading.
Be careful when using this routine, as its misuse can
easily corrupt a data object.
ADDITIONAL INFORMATION
none
EXAMPLES
none
SIDE EFFECTS
none
RESTRICTIONS
none
MODIFICATION
none
FILES
$DATASERV/objects/library/kdataman/src/segment.c
SEE ALSO
kdataman(3)
COPYRIGHT
Copyright (C) 1993 - 1997, Khoral Research, Inc. ("KRI") All rights reserved.