Changeset View
Changeset View
Standalone View
Standalone View
share/man/man3/siginfo.3
| Show All 21 Lines | |||||
| .\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR | .\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR | ||||
| .\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, | .\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, | ||||
| .\" WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE | .\" WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE | ||||
| .\" OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, | .\" OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, | ||||
| .\" EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. | .\" EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. | ||||
| .\" | .\" | ||||
| .\" $FreeBSD$ | .\" $FreeBSD$ | ||||
| .\" | .\" | ||||
| .Dd July 28, 2020 | .Dd February 16, 2021 | ||||
| .Dt SIGINFO 3 | .Dt SIGINFO 3 | ||||
| .Os | .Os | ||||
| .Sh NAME | .Sh NAME | ||||
| .Nm siginfo | .Nm siginfo | ||||
| .Nd "signal generation information" | .Nd "signal generation information" | ||||
| .Sh SYNOPSIS | .Sh SYNOPSIS | ||||
| .In signal.h | .In signal.h | ||||
| .Sh DESCRIPTION | .Sh DESCRIPTION | ||||
| ▲ Show 20 Lines • Show All 174 Lines • ▼ Show 20 Lines | |||||
| is generally set to the address of the faulting instruction. | is generally set to the address of the faulting instruction. | ||||
| However, synchronous signals raised by a faulting memory access such as | However, synchronous signals raised by a faulting memory access such as | ||||
| .Dv SIGSEGV | .Dv SIGSEGV | ||||
| and | and | ||||
| .Dv SIGBUS | .Dv SIGBUS | ||||
| may report the address of the faulting memory access (if available) in | may report the address of the faulting memory access (if available) in | ||||
| .Va si_addr | .Va si_addr | ||||
| instead. | instead. | ||||
| Additionally, on some platforms, SIGTRAP raised by a hardware watchpoint | |||||
| exception will report the data address that triggered the watchpoint in | |||||
| .Va si_addr . | |||||
| Notably, this is the case on arm64, but not on amd64 or i386. | |||||
jhb: I'm not sure I would keep the arm64 sentence as we don't document the MD behaviors for other… | |||||
| .Pp | .Pp | ||||
| Sychronous signals set | Sychronous signals set | ||||
| .Va si_trapno | .Va si_trapno | ||||
| to a machine-dependent trap number. | to a machine-dependent trap number. | ||||
| .Pp | .Pp | ||||
| In addition, the following signal-specific information is available: | In addition, the following signal-specific information is available: | ||||
| .Bl -column ".Dv SIGPOLL" ".Dv CLD_CONTINUED" | .Bl -column ".Dv SIGPOLL" ".Dv CLD_CONTINUED" | ||||
| .It Sy Signal Ta Sy Member Ta Sy Value | .It Sy Signal Ta Sy Member Ta Sy Value | ||||
| ▲ Show 20 Lines • Show All 115 Lines • Show Last 20 Lines | |||||
I'm not sure I would keep the arm64 sentence as we don't document the MD behaviors for other signals here but instead just use "may" to indicate it can vary.