CAPS_SYS_REPLY(2) BSD System Calls Manual CAPS_SYS_REPLY(2)NAMEcaps_sys_reply — reply to a CAPS IPC message
LIBRARY
Standard C Library (libc, -lc)
SYNOPSIS
#include <sys/caps.h>
int
caps_sys_reply(int portid, const void *msg, int msgsize, off_t msgid);
DESCRIPTION
Reply to the received CAPS message identified by msgid on the port speci‐
fied by portid. The reply may supply opaque data in msg. The memory
associated with the message must be left intact until an acknowledgement
is returned at a later time. The kernel does not make a copy of the mes‐
sage and its size may not exceed 128KB.
This function is only used on the server side. The server may reply to a
message without retrieving its data.
RETURN VALUES
The caps_sys_reply() function returns the value 0 if successful; other‐
wise the value -1 is returned and the global variable errno is set to
indicate the error.
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. Note that a child process may not reply to a mes‐
sage received by its parent.
SEE ALSOcaps_sys_client(2), caps_sys_get(2), caps_sys_put(2), caps_sys_service(2)HISTORY
The caps_sys_reply() 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