CAPS_SYS_PUT(2) BSD System Calls Manual CAPS_SYS_PUT(2)NAMEcaps_sys_put — send an opaque message to a CAPS IPC port
LIBRARY
Standard C Library (libc, -lc)
SYNOPSIS
#include <sys/caps.h>
off_t
caps_sys_put(int portid, const void *msg, int msgsize);
DESCRIPTION
Send an opaque message msg of the specified size msgsiz to the port iden‐
tified by portid. The memory associated with the message must be left
intact until the message is returned. The kernel does not make a copy of
the message and its size may not exceed 128KB.
This function is only used on the client side.
RETURN VALUES
On success, this function returns a 64 bit message identifier. If an
error occurs, -1 is returned and errno is set.
ERRORS
This function will fail if:
[EINVAL] An invalid argument was specified.
[ENOTCONN] The process originally creating the port forked and the child
process attempts to access the port. The child process is
expected to create its own port. This error is also returned
if the remote end closed its connection and is no longer
available.
[ENOBUFS] The maximum number of in-transmit messages has been reached.
No more messages can be sent until some of them are replied
to.
SEE ALSOcaps_sys_client(2), caps_sys_get(2), caps_sys_service(2)HISTORY
The caps_sys_put() function call first appeared in DragonFly 1.0.
AUTHORS
CAPS IPC was written by Matthew Dillon. This man page was written by
Sascha Wildner.
BSD February 28, 2006 BSD