From e6ca4d95a01d09f8918a825895708be6a9a5b53d Mon Sep 17 00:00:00 2001 From: asmodai Date: Sun, 2 Apr 2000 12:00:52 +0000 Subject: Add and install BUS_SETUP_INTR.9. This effectively replaces BUS_CREATE_INTR.9 and BUS_CONNECT_INTR.9. Reviewed by: n_hibma --- share/man/man9/BUS_SETUP_INTR.9 | 71 +++++++++++++++++++++++++++++++++++++++++ share/man/man9/Makefile | 2 +- 2 files changed, 72 insertions(+), 1 deletion(-) create mode 100644 share/man/man9/BUS_SETUP_INTR.9 (limited to 'share') diff --git a/share/man/man9/BUS_SETUP_INTR.9 b/share/man/man9/BUS_SETUP_INTR.9 new file mode 100644 index 0000000..2b035f4 --- /dev/null +++ b/share/man/man9/BUS_SETUP_INTR.9 @@ -0,0 +1,71 @@ +.\" Copyright (c) 2000 Jeroen Ruigrok van der Werven +.\" All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" $FreeBSD$ +.\" +.Dd April 2, 2000 +.Os +.Dt BUS_SETUP_INTR 9 +.Os FreeBSD +.Sh NAME +.Nm BUS_SETUP_INTR +.Nd create and attach to an interrupt handler +.Sh SYNOPSIS +.Fd #include +.Fd #include +.Ft int +.Fn BUS_SETUP_INTR "device_t dev" "device_t child" "struct resource *irq" "int flags" "driver_intr_t *intr" "void *arg" "void **cookiep" +.Sh DESCRIPTION +.Pp +The method +.Nm +will create and attach an interrupt handler to an interrupt +previously allocated by the resource manager's +.Xr BUS_ALLOC_RESOURCE 9 +method. +The handler +.Fa intr +will be called with the value +.Fa arg +as its only argument. +.Pp +The interrupt handler will be detached by +.Fn BUS_TEARDOWN_INTR . +The cookie needs to be passed to +.Fn BUS_TEARDOWN_INTR +in order to tear down the correct interrupt handler. +.Sh RETURN VALUES +Zero is returned on success, +otherwise an appropriate error is returned. +.Sh SEE ALSO +.Xr BUS_TEARDOWN_INTR 9 , +.Xr device 9 , +.Xr driver 9 +.Sh AUTHORS +This man page was written by +.An Jeroen Ruigrok van der Werven +.Aq asmodai@FreeBSD.org +based on the manpages for BUS_CREATE_INTR and BUS_CONNECT_INTR written by +.An Doug Rabson +.Aq dfr@FreeBSD.org . diff --git a/share/man/man9/Makefile b/share/man/man9/Makefile index e34af66..fc29b95 100644 --- a/share/man/man9/Makefile +++ b/share/man/man9/Makefile @@ -30,7 +30,7 @@ MAN9+= device.9 device_add_child.9 device_delete_child.9 device_enable.9 \ devclass_get_device.9 devclass_get_devices.9 devclass_get_maxunit.9 \ devclass_get_name.9 devclass_get_softc.9 \ DEVICE_ATTACH.9 DEVICE_DETACH.9 DEVICE_PROBE.9 DEVICE_SHUTDOWN.9 \ - BUS_PRINT_CHILD.9 \ + BUS_PRINT_CHILD.9 BUS_SETUP_INTR.9 \ BUS_READ_IVAR.9 \ bus_generic_attach.9 bus_generic_detach.9 bus_generic_map_intr.9 \ bus_generic_print_child.9 bus_generic_read_ivar.9 \ -- cgit v1.1