kfile_copydata - copy the contents of a transport id to another transport id
LIBRARY CALL
ssize_t kfile_copydata(
int id1,
int id2,
size_t num)
INPUT
id1 - the input khoros transport descriptor
id2 - the output khoros transport descriptor
num - if not 0 the number of bytes to be copied.
OUTPUT
none
RETURN VALUE
the number of bytes copied or -1 upon failure
DESCRIPTION
This routine copies the contents of a input transport
descriptor to an output transport descriptor. These
descriptors are specified by the Khoros transport
mechanism. An optional "num_copy" can be used to
specify the actual number of bytes to be copied. If
"num_copy" is 0 then all the data from input is written
to the output.
ADDITIONAL INFORMATION
none
EXAMPLES
none
SIDE EFFECTS
the data written to the output descriptor will not be flushed
until a kfflush() or kclose() is performed.
RESTRICTIONS
none
MODIFICATION
none
FILES
$BOOTSTRAP/objects/library/kutils/src/kfile.c
SEE ALSO
kutils(3)
COPYRIGHT
Copyright (C) 1993 - 1997, Khoral Research, Inc. ("KRI") All rights reserved.