CAPS_SYS_CLIENT(2) BSD System Calls Manual CAPS_SYS_CLIENT(2)NAME
caps_sys_client — create a CAPS IPC client
LIBRARY
Standard C Library (libc, -lc)
SYNOPSIS
#include <sys/caps.h>
int
caps_sys_client(const char *name, uid_t uid, gid_t gid, int upcid,
int flags);
DESCRIPTION
Create an IPC client connected to the service specified by the name argu‐
ment. Either uid or gid can be -1 (thereby indicating a wildcard), but
not both. Programs connecting to a generic service typically first try
getuid() and -1, then try -1 and getgid(), then try 0 and 0. The upcid
argument can either be an upcall or a kqueue identifier.
RETURN VALUES
On success, this function returns a port identifier. On failure, -1 is
returned and errno is set to indicate the error.
ERRORS
This function will fail if:
[EOPNOTSUPP] The CAPS system has not been enabled with
kern.caps_enabled.
[EINVAL] An invalid argument was specified.
SEE ALSOcaps_sys_service(2)HISTORY
The caps_sys_client() function call first appeared in DragonFly 1.0.
AUTHORS
CAPS IPC was written by Matthew Dillon. This man page was written by
Sascha Wildner.
BUGS
Support for the upcid argument is currently not implemented.
BSD February 28, 2006 BSD