DATASERV (koldgeom) functions


LIBRARY ROUTINE

kgeom_open_input_object - open an object associated with an input data transport.

LIBRARY CALL

kobject kgeom_open_input_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 kgeom_open_object() function. It differs in that it assumes that the object is read-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 kgeom_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 additional information, please see kgeom_open_object().

This simple example illustrates how an input data object would be opened.

kobject obj;

obj = kgeom_open_input_object("existing.viff");

This function is equivalent to: kgeom_open_object(name, KOBJ_READ)

ADDITIONAL INFORMATION

none

EXAMPLES

none

SIDE EFFECTS

none

RESTRICTIONS

none

MODIFICATION

none

FILES

$DATASERV/objects/library/koldgeom/src/geometry.c

SEE ALSO

koldgeom(3)

COPYRIGHT

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