Current File : //usr/share/man/man3/sigsegv_register.3

'\" te
.\"

.\"
.\" Copyright (c) 2009, 2011, Oracle and/or its affiliates. All rights reserved.
.\"
.\"
.TH sigsegv_register 3 "13 Jan 2009" "SunOS 5.11"
.SH NAME
sigsegv_init, sigsegv_register, sigsegv_unregister, sigsegv_dispatch \- LOCAL SIGSEGV HANDLERS
.SH SYNOPSIS
#include <\fBsigsegv.h\fR>
.sp
void \fBsigsegv_init\fR (\fIsigsegv_dispatcher* dispatcher\fR);
.sp
void* \fBsigsegv_register\fR (\fIsigsegv_dispatcher* dispatcher\fR,
.RS +24
\fIvoid* address\fR, \fIunsigned long len\fR,
\fIsigsegv_area_handler_t handler\fR,
\fIvoid* handler_arg\fR);
.RE
.sp
void \fBsigsegv_unregister\fR (\fIsigsegv_dispatcher* dispatcher\fR,
.RS +25
\fIvoid* ticket\fR);
.RE
.sp
int \fBsigsegv_dispatch\fR (\fIsigsegv_dispatcher* dispatcher\fR,
.RS +22
\fIvoid* fault_address\fR);
.RE
.sp
.SH DESCRIPTION
.sp
.LP
The set of functions permit to define different \fBSIGSEGV\fR policies on different address ranges.
.sp
.LP
\fBSigsegv_init\fR initializes a sigsegv_dispatcher structure.
.sp
.LP
\fBSigsegv_register\fR adds a local SIGSEGV handler to a sigsegv_dispatcher structure. It will cover the interval [address..address+len-1]. Returns a "ticket" that can be used to remove the handler later.
.sp
.LP
\fBSigsegv_unregister\fR removes a local SIGSEGV handler.
.sp
.LP
\fBSigsegv_dispatch\fR call the local SIGSEGV handler responsible for the given fault address. Return the handler's return value. 0 means that no handler has been found, or that a handler was found but declined responsibility.
.sp

.SH OPERANDS
.sp
.LP
typedef struct \fBsigsegv_dispatcher\fR {
.RS +5
void* tree;
.RE
}sigsegv_dispatcher;
.sp
.LP
\fISigsegv_dispatcher\fR represents a table of memory areas (address range intervals), with an local SIGSEGV handler for each.
.sp
.LP
The \fIaddress\fR represents the address of the memory area, and the \fIlen\fR represents the length of the memory area.
.sp
.LP
typedef int (*\fBsigsegv_area_handler_t\fR) (\fIvoid* fault_address,\fR
.RS +39
\fIvoid* user_arg\fR);
.RE
.sp
\fIsigsegv_area_handler_t\fR is the type of a local SIGSEGV handler. The fault address is passed as argument. The second argument is fixed arbitrary user data. The return value should be nonzero if the handler has done its job and no other handler should be called, or 0 if the handler declines responsibility for the given address.
.sp
.LP
The \fIhandler_arg\fR is the second argument of the \fBsigsegv_area_handler_t\fR.
.sp
.SH EXIT STATUS
.sp
.LP
Sigsegv_dispatcher returns the handler's return value. 0 means that no handler has been found, or that a handler was found but declined responsibility.
.sp


.\" Oracle has added the ARC stability level to this manual page
.SH ATTRIBUTES
See
.BR attributes (5)
for descriptions of the following attributes:
.sp
.TS
box;
cbp-1 | cbp-1
l | l .
ATTRIBUTE TYPE	ATTRIBUTE VALUE 
=
Availability	library/libsigsegv
=
Stability	Uncommitted
.TE 
.PP
.SH SEE ALSO
.sp
.LP
\fBattributes\fR(5), \fBsigsegv\fR(3), \fBstandards\fR(5)


.SH NOTES

.\" Oracle has added source availability information to this manual page
This software was built from source available at https://java.net/projects/solaris-userland.  The original community source was downloaded from  http://ftp.gnu.org/gnu/libsigsegv/libsigsegv-2.6.tar.gz

Further information about this software can be found on the open source community website at http://www.gnu.org/software/libsigsegv/.