1*dcda59c6Sthorpej$NetBSD: device_calls,v 1.1 2021/09/15 17:26:06 thorpej Exp $ 2*dcda59c6Sthorpej 3*dcda59c6Sthorpej/*- 4*dcda59c6Sthorpej * Copyright (c) 2021 The NetBSD Foundation, Inc. 5*dcda59c6Sthorpej * All rights reserved. 6*dcda59c6Sthorpej * 7*dcda59c6Sthorpej * This code is derived from software contributed to The NetBSD Foundation 8*dcda59c6Sthorpej * by Jason R. Thorpe. 9*dcda59c6Sthorpej * 10*dcda59c6Sthorpej * Redistribution and use in source and binary forms, with or without 11*dcda59c6Sthorpej * modification, are permitted provided that the following conditions 12*dcda59c6Sthorpej * are met: 13*dcda59c6Sthorpej * 1. Redistributions of source code must retain the above copyright 14*dcda59c6Sthorpej * notice, this list of conditions and the following disclaimer. 15*dcda59c6Sthorpej * 2. Redistributions in binary form must reproduce the above copyright 16*dcda59c6Sthorpej * notice, this list of conditions and the following disclaimer in the 17*dcda59c6Sthorpej * documentation and/or other materials provided with the distribution. 18*dcda59c6Sthorpej * 19*dcda59c6Sthorpej * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS 20*dcda59c6Sthorpej * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED 21*dcda59c6Sthorpej * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 22*dcda59c6Sthorpej * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS 23*dcda59c6Sthorpej * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 24*dcda59c6Sthorpej * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 25*dcda59c6Sthorpej * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 26*dcda59c6Sthorpej * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 27*dcda59c6Sthorpej * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 28*dcda59c6Sthorpej * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 29*dcda59c6Sthorpej * POSSIBILITY OF SUCH DAMAGE. 30*dcda59c6Sthorpej */ 31*dcda59c6Sthorpej 32*dcda59c6Sthorpej/* 33*dcda59c6Sthorpej * Device calls used by the device autoconfiguration subsystem 34*dcda59c6Sthorpej */ 35*dcda59c6Sthorpej 36*dcda59c6Sthorpejsubsystem device; 37*dcda59c6Sthorpej 38*dcda59c6Sthorpej/* 39*dcda59c6Sthorpej * device-enumerate-children 40*dcda59c6Sthorpej * 41*dcda59c6Sthorpej * Enumerates the direct children of a device, invoking the callback for 42*dcda59c6Sthorpej * each one. The callback is passed the devhandle_t corresponding to the 43*dcda59c6Sthorpej * child device, as well as a user-supplied argument. If the callback 44*dcda59c6Sthorpej * returns true, then enumeration continues. If the callback returns false, 45*dcda59c6Sthorpej * enumeration is stopped. 46*dcda59c6Sthorpej */ 47*dcda59c6Sthorpejdevice-enumerate-children { 48*dcda59c6Sthorpej bool (*callback)(device_t, devhandle_t, void *); 49*dcda59c6Sthorpej void * callback_arg; 50*dcda59c6Sthorpej}; 51