DATASERV (kappserv) functions


LIBRARY ROUTINE

kpds_open_output_object - open an output object for writing

LIBRARY CALL

kobject kpds_open_output_object(
   char *name)

INPUT

OUTPUT

none

RETURN VALUE

a kobject on success, KOBJECT_INVALID on failure.

DESCRIPTION

This function is a simplified interface to the kpds_open_object function. It differs from kpds_open_object in that it assumes that the object is write-only and its transport has permanence. If a permanent file is not desired (i.e. the object is going to be used as temporary storage, and will not be used by any other process) then the kpds_create_object function call should be used instead.

The argument to this function is the transport or file name. This argument indicates the name of the transport that is associated with the object. The transport name can be any legal khoros transport description. While this will usually be a regular UNIX file name, it is also possible to specify such things as shared memory pointers, memory map pointers, sockets, streams, and even transports on other machines. For more information on the syntax of a Khoros transport name, refer to the online man page for the Khoros function kopen. For more information about opening objects, see kpds_open_object.

The default index order will be set to KWIDTH, KHEIGHT, KDEPTH, KTIME and KELEMENTS for the value and mask data, to KMAP_WIDTH, KMAP_HEIGHT, KMAP_ELEMENTS, KMAP_SPATIAL and KMAP_TIME for the map data and KWIDTH, KHEIGHT, KDEPTH and KDIMENSION for the location data.

This function is equivalent to:

kpds_open_object(name, KOBJ_WRITE)

ADDITIONAL INFORMATION

none

EXAMPLES

none

SIDE EFFECTS

none

RESTRICTIONS

none

MODIFICATION

none

FILES

$DATASERV/include/kappserv/kpolymorphic.h

SEE ALSO

kappserv(3)

COPYRIGHT

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