Hallo, dies ist ein Test.
PWD: /www/data-lst1/unixsoft/unixsoft/kaempfer/.public_html
Running in File Mode
Relative path: ./../../../../../../usr/man/man9f/ddi_intr_get_pending.9f
Real path: /usr/share/man/man9f/ddi_intr_get_pending.9f
Zurück
'\" te .\" Copyright (c) 2005, 2012, Oracle and/or its affiliates. All rights reserved. .TH ddi_intr_get_pending 9F "11 Jun 2012" "Oracle Solaris 11.4" "Kernel Functions" .SH NAME ddi_intr_get_pending \- get pending bit for a given interrupt .SH SYNOPSIS .LP .nf #include <sys/types.h> #include <sys/conf.h> #include <sys/ddi.h> #include <sys/sunddi.h> \fBint\fR \fBddi_intr_get_pending\fR(\fBddi_intr_handle_t\fR \fIh\fR, \fBint *\fR\fIpendingp\fR); .fi .SH INTERFACE LEVEL .sp .LP Solaris DDI specific (Solaris DDI). .SH PARAMETERS .sp .ne 2 .mk .na \fB\fIh\fR\fR .ad .RS 12n .rt DDI interrupt handle .RE .sp .ne 2 .mk .na \fB\fIpendingp\fR\fR .ad .RS 12n .rt Pointer to the pending capability returned for this handle .RE .SH DESCRIPTION .sp .LP The \fBddi_intr_get_pending()\fR function returns non-zero as the integer pointed to by the \fIpendingp\fR argument if a corresponding interrupt is pending. The corresponding interrupt handle \fIh\fR must already be enabled. The call succeeds if the device or host bridge supports the ability to read the interrupt pending bits of its interrupts. The driver should use \fBddi_intr_get_cap()\fR function to see if the \fBDDI_INTR_FLAG_PENDING\fR flag is returned to indicate that interrupts support interrupt pending bits. .sp .LP If the \fBDDI_INTR_FLAG_PENDING\fR capability is not supported, \fBddi_intr_get_pending()\fR returns \fBDDI_ENOTSUP\fR and zero in \fIpendingp\fR. .SH RETURN VALUES .sp .LP The \fBddi_intr_get_pending()\fR function returns: .sp .ne 2 .mk .na \fB\fBDDI_SUCCESS\fR\fR .ad .RS 15n .rt On success. .RE .sp .ne 2 .mk .na \fB\fBDDI_EINVAL\fR\fR .ad .RS 15n .rt On encountering invalid input parameters. .RE .sp .ne 2 .mk .na \fB\fBDDI_FAILURE\fR\fR .ad .RS 15n .rt On any implementation specific failure. .RE .sp .ne 2 .mk .na \fB\fBDDI_ENOTSUP\fR\fR .ad .RS 15n .rt On device not supporting operation. .RE .SH CONTEXT .sp .LP The \fBddi_intr_get_pending()\fR function can be called from either user or kernel non-interrupt context. .SH ATTRIBUTES .sp .LP See \fBattributes\fR(7) for descriptions of the following attributes: .sp .TS tab( ) box; cw(2.75i) |cw(2.75i) lw(2.75i) |lw(2.75i) . ATTRIBUTE TYPE ATTRIBUTE VALUE _ Interface Stability Committed .TE .sp .SH SEE ALSO .sp .LP \fBattributes\fR(7), \fBddi_intr_block_disable\fR(9F), \fBddi_intr_block_enable\fR(9F), \fBddi_intr_clr_mask\fR(9F), \fBddi_intr_disable\fR(9F), \fBddi_intr_enable\fR(9F), \fBddi_intr_set_mask\fR(9F) .sp .LP \fIWriting Device Drivers in Oracle Solaris 11.4\fR .SH NOTES .sp .LP Any consumer of this interface should verify that the return value is not equal to \fBDDI_SUCCESS\fR. Incomplete checking for failure codes could result in inconsistent behavior among platforms.