DATASERV (kdataman) functions
LIBRARY ROUTINE
kdms_output - open an input object for writing
LIBRARY CALL
kobject kdms_output(
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 write-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, see kdms_open.
This function is equivalent to:
kdms_open(name, KOBJ_WRITE)
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.