CAPS_SYS_GETGEN(2) BSD System Calls Manual CAPS_SYS_GETGEN(2)NAMEcaps_sys_getgen — get the generation number for a CAPS IPC link
LIBRARY
Standard C Library (libc, -lc)
SYNOPSIS
#include <sys/caps.h>
caps_gen_t
caps_sys_getgen(int portid);
DESCRIPTION
The caps_sys_getgen() function returns the 64 bit generation number for a
CAPS link specified by the portid identifier. This number is typically
used to allow a client to detect when a service has been restarted.
RETURN VALUES
On success, the 64 bit generation number is returned. If an error
occurs, -1 is returned and errno is set.
ERRORS
This function will fail if:
[EINVAL] The portid could not be found.
[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.
SEE ALSOcaps_sys_setgen(2)HISTORY
The caps_sys_getgen() 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