DATASERV (kdataman) functions
LIBRARY ROUTINE
kdms_input - open an input object for reading
LIBRARY CALL
kobject kdms_input(
char *name)
INPUT
- name - a string that contains the path name
of a file or transport that will be
associated with the object.
OUTPUT
none
RETURN VALUE
a kobject on success, KOBJECT_INVALID on failure.
DESCRIPTION
This function is a simplified
interface to the kdms_open function. It
differs in that it assumes that the object
is read-only and its transport has permenance.
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 kdms_create 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 an object, see kdms_open.
This function is equivalent to:
kdms_open(name, KOBJ_READ)
ADDITIONAL INFORMATION
none
EXAMPLES
none
SIDE EFFECTS
none
RESTRICTIONS
none
MODIFICATION
none
FILES
$DATASERV/include/kdataman/kdataman.h
SEE ALSO
kdataman(3)
COPYRIGHT
Copyright (C) 1993 - 1997, Khoral Research, Inc. ("KRI") All rights reserved.