xref: /onnv-gate/usr/src/uts/common/os/devcfg.c (revision 8249)
10Sstevel@tonic-gate /*
20Sstevel@tonic-gate  * CDDL HEADER START
30Sstevel@tonic-gate  *
40Sstevel@tonic-gate  * The contents of this file are subject to the terms of the
51961Scth  * Common Development and Distribution License (the "License").
61961Scth  * You may not use this file except in compliance with the License.
70Sstevel@tonic-gate  *
80Sstevel@tonic-gate  * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
90Sstevel@tonic-gate  * or http://www.opensolaris.org/os/licensing.
100Sstevel@tonic-gate  * See the License for the specific language governing permissions
110Sstevel@tonic-gate  * and limitations under the License.
120Sstevel@tonic-gate  *
130Sstevel@tonic-gate  * When distributing Covered Code, include this CDDL HEADER in each
140Sstevel@tonic-gate  * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
150Sstevel@tonic-gate  * If applicable, add the following below this CDDL HEADER, with the
160Sstevel@tonic-gate  * fields enclosed by brackets "[]" replaced with your own identifying
170Sstevel@tonic-gate  * information: Portions Copyright [yyyy] [name of copyright owner]
180Sstevel@tonic-gate  *
190Sstevel@tonic-gate  * CDDL HEADER END
200Sstevel@tonic-gate  */
210Sstevel@tonic-gate /*
225895Syz147064  * Copyright 2008 Sun Microsystems, Inc.  All rights reserved.
230Sstevel@tonic-gate  * Use is subject to license terms.
240Sstevel@tonic-gate  */
250Sstevel@tonic-gate 
260Sstevel@tonic-gate #include <sys/note.h>
270Sstevel@tonic-gate #include <sys/t_lock.h>
280Sstevel@tonic-gate #include <sys/cmn_err.h>
290Sstevel@tonic-gate #include <sys/instance.h>
300Sstevel@tonic-gate #include <sys/conf.h>
310Sstevel@tonic-gate #include <sys/stat.h>
320Sstevel@tonic-gate #include <sys/ddi.h>
330Sstevel@tonic-gate #include <sys/hwconf.h>
340Sstevel@tonic-gate #include <sys/sunddi.h>
350Sstevel@tonic-gate #include <sys/sunndi.h>
360Sstevel@tonic-gate #include <sys/ddi_impldefs.h>
370Sstevel@tonic-gate #include <sys/ndi_impldefs.h>
380Sstevel@tonic-gate #include <sys/modctl.h>
394845Svikram #include <sys/contract/device_impl.h>
400Sstevel@tonic-gate #include <sys/dacf.h>
410Sstevel@tonic-gate #include <sys/promif.h>
427656SSherry.Moore@Sun.COM #include <sys/pci.h>
430Sstevel@tonic-gate #include <sys/cpuvar.h>
440Sstevel@tonic-gate #include <sys/pathname.h>
450Sstevel@tonic-gate #include <sys/taskq.h>
460Sstevel@tonic-gate #include <sys/sysevent.h>
470Sstevel@tonic-gate #include <sys/sunmdi.h>
480Sstevel@tonic-gate #include <sys/stream.h>
490Sstevel@tonic-gate #include <sys/strsubr.h>
500Sstevel@tonic-gate #include <sys/fs/snode.h>
510Sstevel@tonic-gate #include <sys/fs/dv_node.h>
522621Sllai1 #include <sys/reboot.h>
534845Svikram #include <sys/sysmacros.h>
547656SSherry.Moore@Sun.COM #include <sys/systm.h>
554845Svikram #include <sys/sunldi.h>
564845Svikram #include <sys/sunldi_impl.h>
570Sstevel@tonic-gate 
58*8249SVikram.Hegde@Sun.COM #if defined(__i386) || defined(__amd64)
59*8249SVikram.Hegde@Sun.COM #if !defined(__xpv)
60*8249SVikram.Hegde@Sun.COM #include <sys/iommulib.h>
61*8249SVikram.Hegde@Sun.COM #endif
62*8249SVikram.Hegde@Sun.COM #endif
63*8249SVikram.Hegde@Sun.COM 
640Sstevel@tonic-gate #ifdef DEBUG
650Sstevel@tonic-gate int ddidebug = DDI_AUDIT;
660Sstevel@tonic-gate #else
670Sstevel@tonic-gate int ddidebug = 0;
680Sstevel@tonic-gate #endif
690Sstevel@tonic-gate 
700Sstevel@tonic-gate #define	MT_CONFIG_OP	0
710Sstevel@tonic-gate #define	MT_UNCONFIG_OP	1
720Sstevel@tonic-gate 
730Sstevel@tonic-gate /* Multi-threaded configuration */
740Sstevel@tonic-gate struct mt_config_handle {
750Sstevel@tonic-gate 	kmutex_t mtc_lock;
760Sstevel@tonic-gate 	kcondvar_t mtc_cv;
770Sstevel@tonic-gate 	int mtc_thr_count;
780Sstevel@tonic-gate 	dev_info_t *mtc_pdip;	/* parent dip for mt_config_children */
790Sstevel@tonic-gate 	dev_info_t **mtc_fdip;	/* "a" dip where unconfigure failed */
800Sstevel@tonic-gate 	major_t mtc_parmajor;	/* parent major for mt_config_driver */
810Sstevel@tonic-gate 	major_t mtc_major;
820Sstevel@tonic-gate 	int mtc_flags;
830Sstevel@tonic-gate 	int mtc_op;		/* config or unconfig */
840Sstevel@tonic-gate 	int mtc_error;		/* operation error */
850Sstevel@tonic-gate 	struct brevq_node **mtc_brevqp;	/* outstanding branch events queue */
860Sstevel@tonic-gate #ifdef DEBUG
870Sstevel@tonic-gate 	int total_time;
880Sstevel@tonic-gate 	timestruc_t start_time;
890Sstevel@tonic-gate #endif /* DEBUG */
900Sstevel@tonic-gate };
910Sstevel@tonic-gate 
920Sstevel@tonic-gate struct devi_nodeid {
93789Sahrens 	pnode_t nodeid;
940Sstevel@tonic-gate 	dev_info_t *dip;
950Sstevel@tonic-gate 	struct devi_nodeid *next;
960Sstevel@tonic-gate };
970Sstevel@tonic-gate 
980Sstevel@tonic-gate struct devi_nodeid_list {
990Sstevel@tonic-gate 	kmutex_t dno_lock;		/* Protects other fields */
1000Sstevel@tonic-gate 	struct devi_nodeid *dno_head;	/* list of devi nodeid elements */
1010Sstevel@tonic-gate 	struct devi_nodeid *dno_free;	/* Free list */
1020Sstevel@tonic-gate 	uint_t dno_list_length;		/* number of dips in list */
1030Sstevel@tonic-gate };
1040Sstevel@tonic-gate 
1050Sstevel@tonic-gate /* used to keep track of branch remove events to be generated */
1060Sstevel@tonic-gate struct brevq_node {
1071317Scth 	char *brn_deviname;
1081317Scth 	struct brevq_node *brn_sibling;
1091317Scth 	struct brevq_node *brn_child;
1100Sstevel@tonic-gate };
1110Sstevel@tonic-gate 
1120Sstevel@tonic-gate static struct devi_nodeid_list devi_nodeid_list;
1130Sstevel@tonic-gate static struct devi_nodeid_list *devimap = &devi_nodeid_list;
1140Sstevel@tonic-gate 
1150Sstevel@tonic-gate /*
1160Sstevel@tonic-gate  * Well known nodes which are attached first at boot time.
1170Sstevel@tonic-gate  */
1180Sstevel@tonic-gate dev_info_t *top_devinfo;		/* root of device tree */
1190Sstevel@tonic-gate dev_info_t *options_dip;
1200Sstevel@tonic-gate dev_info_t *pseudo_dip;
1210Sstevel@tonic-gate dev_info_t *clone_dip;
1220Sstevel@tonic-gate dev_info_t *scsi_vhci_dip;		/* MPXIO dip */
1230Sstevel@tonic-gate major_t clone_major;
1240Sstevel@tonic-gate 
1252621Sllai1 /*
1262621Sllai1  * A non-global zone's /dev is derived from the device tree.
1272621Sllai1  * This generation number serves to indicate when a zone's
1282621Sllai1  * /dev may need to be updated.
1292621Sllai1  */
1302621Sllai1 volatile ulong_t devtree_gen;		/* generation number */
1312621Sllai1 
1320Sstevel@tonic-gate /* block all future dev_info state changes */
1337656SSherry.Moore@Sun.COM hrtime_t volatile devinfo_freeze = 0;
1340Sstevel@tonic-gate 
1350Sstevel@tonic-gate /* number of dev_info attaches/detaches currently in progress */
1360Sstevel@tonic-gate static ulong_t devinfo_attach_detach = 0;
1370Sstevel@tonic-gate 
1387576SJerry.Gilliam@Sun.COM extern int	sys_shutdown;
1390Sstevel@tonic-gate extern kmutex_t global_vhci_lock;
1400Sstevel@tonic-gate 
1412621Sllai1 /* bitset of DS_SYSAVAIL & DS_RECONFIG - no races, no lock */
1422621Sllai1 static int devname_state = 0;
1432621Sllai1 
1440Sstevel@tonic-gate /*
1450Sstevel@tonic-gate  * The devinfo snapshot cache and related variables.
1460Sstevel@tonic-gate  * The only field in the di_cache structure that needs initialization
1470Sstevel@tonic-gate  * is the mutex (cache_lock). However, since this is an adaptive mutex
1480Sstevel@tonic-gate  * (MUTEX_DEFAULT) - it is automatically initialized by being allocated
1490Sstevel@tonic-gate  * in zeroed memory (static storage class). Therefore no explicit
1500Sstevel@tonic-gate  * initialization of the di_cache structure is needed.
1510Sstevel@tonic-gate  */
1520Sstevel@tonic-gate struct di_cache	di_cache = {1};
1530Sstevel@tonic-gate int		di_cache_debug = 0;
1540Sstevel@tonic-gate 
1550Sstevel@tonic-gate /* For ddvis, which needs pseudo children under PCI */
1560Sstevel@tonic-gate int pci_allow_pseudo_children = 0;
1570Sstevel@tonic-gate 
1584145Scth /* Allow path-oriented alias driver binding on driver.conf enumerated nodes */
1594145Scth int driver_conf_allow_path_alias = 1;
1604145Scth 
1610Sstevel@tonic-gate /*
1620Sstevel@tonic-gate  * The following switch is for service people, in case a
1630Sstevel@tonic-gate  * 3rd party driver depends on identify(9e) being called.
1640Sstevel@tonic-gate  */
1650Sstevel@tonic-gate int identify_9e = 0;
1660Sstevel@tonic-gate 
1670Sstevel@tonic-gate int mtc_off;					/* turn off mt config */
1680Sstevel@tonic-gate 
1697656SSherry.Moore@Sun.COM int quiesce_debug = 0;
1707656SSherry.Moore@Sun.COM 
1710Sstevel@tonic-gate static kmem_cache_t *ddi_node_cache;		/* devinfo node cache */
1720Sstevel@tonic-gate static devinfo_log_header_t *devinfo_audit_log;	/* devinfo log */
1730Sstevel@tonic-gate static int devinfo_log_size;			/* size in pages */
1740Sstevel@tonic-gate 
1750Sstevel@tonic-gate static int lookup_compatible(dev_info_t *, uint_t);
1760Sstevel@tonic-gate static char *encode_composite_string(char **, uint_t, size_t *, uint_t);
1770Sstevel@tonic-gate static void link_to_driver_list(dev_info_t *);
1780Sstevel@tonic-gate static void unlink_from_driver_list(dev_info_t *);
1790Sstevel@tonic-gate static void add_to_dn_list(struct devnames *, dev_info_t *);
1800Sstevel@tonic-gate static void remove_from_dn_list(struct devnames *, dev_info_t *);
1810Sstevel@tonic-gate static dev_info_t *find_child_by_callback(dev_info_t *, char *, char *,
1820Sstevel@tonic-gate     int (*)(dev_info_t *, char *, int));
1830Sstevel@tonic-gate static dev_info_t *find_duplicate_child();
1840Sstevel@tonic-gate static void add_global_props(dev_info_t *);
1850Sstevel@tonic-gate static void remove_global_props(dev_info_t *);
1860Sstevel@tonic-gate static int uninit_node(dev_info_t *);
1870Sstevel@tonic-gate static void da_log_init(void);
1880Sstevel@tonic-gate static void da_log_enter(dev_info_t *);
1890Sstevel@tonic-gate static int walk_devs(dev_info_t *, int (*f)(dev_info_t *, void *), void *, int);
1900Sstevel@tonic-gate static int reset_nexus_flags(dev_info_t *, void *);
1910Sstevel@tonic-gate static void ddi_optimize_dtree(dev_info_t *);
1920Sstevel@tonic-gate static int is_leaf_node(dev_info_t *);
1930Sstevel@tonic-gate static struct mt_config_handle *mt_config_init(dev_info_t *, dev_info_t **,
1940Sstevel@tonic-gate     int, major_t, int, struct brevq_node **);
1950Sstevel@tonic-gate static void mt_config_children(struct mt_config_handle *);
1960Sstevel@tonic-gate static void mt_config_driver(struct mt_config_handle *);
1970Sstevel@tonic-gate static int mt_config_fini(struct mt_config_handle *);
1980Sstevel@tonic-gate static int devi_unconfig_common(dev_info_t *, dev_info_t **, int, major_t,
1990Sstevel@tonic-gate     struct brevq_node **);
2000Sstevel@tonic-gate static int
2010Sstevel@tonic-gate ndi_devi_config_obp_args(dev_info_t *parent, char *devnm,
2020Sstevel@tonic-gate     dev_info_t **childp, int flags);
2031093Shiremath static void i_link_vhci_node(dev_info_t *);
2042155Scth static void ndi_devi_exit_and_wait(dev_info_t *dip,
2052155Scth     int circular, clock_t end_time);
2064145Scth static int ndi_devi_unbind_driver(dev_info_t *dip);
2070Sstevel@tonic-gate 
2084845Svikram static void i_ddi_check_retire(dev_info_t *dip);
2094845Svikram 
2107656SSherry.Moore@Sun.COM static void quiesce_one_device(dev_info_t *, void *);
2114845Svikram 
2120Sstevel@tonic-gate /*
2130Sstevel@tonic-gate  * dev_info cache and node management
2140Sstevel@tonic-gate  */
2150Sstevel@tonic-gate 
2160Sstevel@tonic-gate /* initialize dev_info node cache */
2170Sstevel@tonic-gate void
2180Sstevel@tonic-gate i_ddi_node_cache_init()
2190Sstevel@tonic-gate {
2200Sstevel@tonic-gate 	ASSERT(ddi_node_cache == NULL);
2210Sstevel@tonic-gate 	ddi_node_cache = kmem_cache_create("dev_info_node_cache",
2220Sstevel@tonic-gate 	    sizeof (struct dev_info), 0, NULL, NULL, NULL, NULL, NULL, 0);
2230Sstevel@tonic-gate 
2240Sstevel@tonic-gate 	if (ddidebug & DDI_AUDIT)
2250Sstevel@tonic-gate 		da_log_init();
2260Sstevel@tonic-gate }
2270Sstevel@tonic-gate 
2280Sstevel@tonic-gate /*
2290Sstevel@tonic-gate  * Allocating a dev_info node, callable from interrupt context with KM_NOSLEEP
2300Sstevel@tonic-gate  * The allocated node has a reference count of 0.
2310Sstevel@tonic-gate  */
2320Sstevel@tonic-gate dev_info_t *
233789Sahrens i_ddi_alloc_node(dev_info_t *pdip, char *node_name, pnode_t nodeid,
2340Sstevel@tonic-gate     int instance, ddi_prop_t *sys_prop, int flag)
2350Sstevel@tonic-gate {
2360Sstevel@tonic-gate 	struct dev_info *devi;
2370Sstevel@tonic-gate 	struct devi_nodeid *elem;
2380Sstevel@tonic-gate 	static char failed[] = "i_ddi_alloc_node: out of memory";
2390Sstevel@tonic-gate 
2400Sstevel@tonic-gate 	ASSERT(node_name != NULL);
2410Sstevel@tonic-gate 
2420Sstevel@tonic-gate 	if ((devi = kmem_cache_alloc(ddi_node_cache, flag)) == NULL) {
2430Sstevel@tonic-gate 		cmn_err(CE_NOTE, failed);
2440Sstevel@tonic-gate 		return (NULL);
2450Sstevel@tonic-gate 	}
2460Sstevel@tonic-gate 
2470Sstevel@tonic-gate 	bzero(devi, sizeof (struct dev_info));
2480Sstevel@tonic-gate 
2490Sstevel@tonic-gate 	if (devinfo_audit_log) {
2500Sstevel@tonic-gate 		devi->devi_audit = kmem_zalloc(sizeof (devinfo_audit_t), flag);
2510Sstevel@tonic-gate 		if (devi->devi_audit == NULL)
2520Sstevel@tonic-gate 			goto fail;
2530Sstevel@tonic-gate 	}
2540Sstevel@tonic-gate 
2550Sstevel@tonic-gate 	if ((devi->devi_node_name = i_ddi_strdup(node_name, flag)) == NULL)
2560Sstevel@tonic-gate 		goto fail;
2574145Scth 
2580Sstevel@tonic-gate 	/* default binding name is node name */
2590Sstevel@tonic-gate 	devi->devi_binding_name = devi->devi_node_name;
2607009Scth 	devi->devi_major = DDI_MAJOR_T_NONE;	/* unbound by default */
2610Sstevel@tonic-gate 
2620Sstevel@tonic-gate 	/*
2630Sstevel@tonic-gate 	 * Make a copy of system property
2640Sstevel@tonic-gate 	 */
2650Sstevel@tonic-gate 	if (sys_prop &&
2660Sstevel@tonic-gate 	    (devi->devi_sys_prop_ptr = i_ddi_prop_list_dup(sys_prop, flag))
2670Sstevel@tonic-gate 	    == NULL)
2680Sstevel@tonic-gate 		goto fail;
2690Sstevel@tonic-gate 
2700Sstevel@tonic-gate 	/*
2710Sstevel@tonic-gate 	 * Assign devi_nodeid, devi_node_class, devi_node_attributes
2720Sstevel@tonic-gate 	 * according to the following algorithm:
2730Sstevel@tonic-gate 	 *
2740Sstevel@tonic-gate 	 * nodeid arg			node class		node attributes
2750Sstevel@tonic-gate 	 *
2760Sstevel@tonic-gate 	 * DEVI_PSEUDO_NODEID		DDI_NC_PSEUDO		A
2770Sstevel@tonic-gate 	 * DEVI_SID_NODEID		DDI_NC_PSEUDO		A,P
2780Sstevel@tonic-gate 	 * other			DDI_NC_PROM		P
2790Sstevel@tonic-gate 	 *
2800Sstevel@tonic-gate 	 * Where A = DDI_AUTO_ASSIGNED_NODEID (auto-assign a nodeid)
2810Sstevel@tonic-gate 	 * and	 P = DDI_PERSISTENT
2820Sstevel@tonic-gate 	 *
2830Sstevel@tonic-gate 	 * auto-assigned nodeids are also auto-freed.
2840Sstevel@tonic-gate 	 */
2850Sstevel@tonic-gate 	switch (nodeid) {
2860Sstevel@tonic-gate 	case DEVI_SID_NODEID:
2870Sstevel@tonic-gate 		devi->devi_node_attributes = DDI_PERSISTENT;
2880Sstevel@tonic-gate 		if ((elem = kmem_zalloc(sizeof (*elem), flag)) == NULL)
2890Sstevel@tonic-gate 			goto fail;
2900Sstevel@tonic-gate 		/*FALLTHROUGH*/
2910Sstevel@tonic-gate 	case DEVI_PSEUDO_NODEID:
2920Sstevel@tonic-gate 		devi->devi_node_attributes |= DDI_AUTO_ASSIGNED_NODEID;
2930Sstevel@tonic-gate 		devi->devi_node_class = DDI_NC_PSEUDO;
2940Sstevel@tonic-gate 		if (impl_ddi_alloc_nodeid(&devi->devi_nodeid)) {
2950Sstevel@tonic-gate 			panic("i_ddi_alloc_node: out of nodeids");
2960Sstevel@tonic-gate 			/*NOTREACHED*/
2970Sstevel@tonic-gate 		}
2980Sstevel@tonic-gate 		break;
2990Sstevel@tonic-gate 	default:
3000Sstevel@tonic-gate 		if ((elem = kmem_zalloc(sizeof (*elem), flag)) == NULL)
3010Sstevel@tonic-gate 			goto fail;
3020Sstevel@tonic-gate 		/*
3030Sstevel@tonic-gate 		 * the nodetype is 'prom', try to 'take' the nodeid now.
3040Sstevel@tonic-gate 		 * This requires memory allocation, so check for failure.
3050Sstevel@tonic-gate 		 */
3060Sstevel@tonic-gate 		if (impl_ddi_take_nodeid(nodeid, flag) != 0) {
3070Sstevel@tonic-gate 			kmem_free(elem, sizeof (*elem));
3080Sstevel@tonic-gate 			goto fail;
3090Sstevel@tonic-gate 		}
3100Sstevel@tonic-gate 
3110Sstevel@tonic-gate 		devi->devi_nodeid = nodeid;
3120Sstevel@tonic-gate 		devi->devi_node_class = DDI_NC_PROM;
3130Sstevel@tonic-gate 		devi->devi_node_attributes = DDI_PERSISTENT;
3140Sstevel@tonic-gate 
3150Sstevel@tonic-gate 	}
3160Sstevel@tonic-gate 
3170Sstevel@tonic-gate 	if (ndi_dev_is_persistent_node((dev_info_t *)devi)) {
3180Sstevel@tonic-gate 		mutex_enter(&devimap->dno_lock);
3190Sstevel@tonic-gate 		elem->next = devimap->dno_free;
3200Sstevel@tonic-gate 		devimap->dno_free = elem;
3210Sstevel@tonic-gate 		mutex_exit(&devimap->dno_lock);
3220Sstevel@tonic-gate 	}
3230Sstevel@tonic-gate 
3240Sstevel@tonic-gate 	/*
3250Sstevel@tonic-gate 	 * Instance is normally initialized to -1. In a few special
3260Sstevel@tonic-gate 	 * cases, the caller may specify an instance (e.g. CPU nodes).
3270Sstevel@tonic-gate 	 */
3280Sstevel@tonic-gate 	devi->devi_instance = instance;
3290Sstevel@tonic-gate 
3300Sstevel@tonic-gate 	/*
3310Sstevel@tonic-gate 	 * set parent and bus_ctl parent
3320Sstevel@tonic-gate 	 */
3330Sstevel@tonic-gate 	devi->devi_parent = DEVI(pdip);
3340Sstevel@tonic-gate 	devi->devi_bus_ctl = DEVI(pdip);
3350Sstevel@tonic-gate 
3360Sstevel@tonic-gate 	NDI_CONFIG_DEBUG((CE_CONT,
3370Sstevel@tonic-gate 	    "i_ddi_alloc_node: name=%s id=%d\n", node_name, devi->devi_nodeid));
3380Sstevel@tonic-gate 
3390Sstevel@tonic-gate 	cv_init(&(devi->devi_cv), NULL, CV_DEFAULT, NULL);
3400Sstevel@tonic-gate 	mutex_init(&(devi->devi_lock), NULL, MUTEX_DEFAULT, NULL);
3410Sstevel@tonic-gate 	mutex_init(&(devi->devi_pm_lock), NULL, MUTEX_DEFAULT, NULL);
3420Sstevel@tonic-gate 	mutex_init(&(devi->devi_pm_busy_lock), NULL, MUTEX_DEFAULT, NULL);
3430Sstevel@tonic-gate 
3444845Svikram 	RIO_TRACE((CE_NOTE, "i_ddi_alloc_node: Initing contract fields: "
3454845Svikram 	    "dip=%p, name=%s", (void *)devi, node_name));
3464845Svikram 
3474845Svikram 	mutex_init(&(devi->devi_ct_lock), NULL, MUTEX_DEFAULT, NULL);
3484845Svikram 	cv_init(&(devi->devi_ct_cv), NULL, CV_DEFAULT, NULL);
3494845Svikram 	devi->devi_ct_count = -1;	/* counter not in use if -1 */
3504845Svikram 	list_create(&(devi->devi_ct), sizeof (cont_device_t),
3514845Svikram 	    offsetof(cont_device_t, cond_next));
3524845Svikram 
3530Sstevel@tonic-gate 	i_ddi_set_node_state((dev_info_t *)devi, DS_PROTO);
3540Sstevel@tonic-gate 	da_log_enter((dev_info_t *)devi);
3550Sstevel@tonic-gate 	return ((dev_info_t *)devi);
3560Sstevel@tonic-gate 
3570Sstevel@tonic-gate fail:
3580Sstevel@tonic-gate 	if (devi->devi_sys_prop_ptr)
3590Sstevel@tonic-gate 		i_ddi_prop_list_delete(devi->devi_sys_prop_ptr);
3600Sstevel@tonic-gate 	if (devi->devi_node_name)
3610Sstevel@tonic-gate 		kmem_free(devi->devi_node_name, strlen(node_name) + 1);
3620Sstevel@tonic-gate 	if (devi->devi_audit)
3630Sstevel@tonic-gate 		kmem_free(devi->devi_audit, sizeof (devinfo_audit_t));
3640Sstevel@tonic-gate 	kmem_cache_free(ddi_node_cache, devi);
3650Sstevel@tonic-gate 	cmn_err(CE_NOTE, failed);
3660Sstevel@tonic-gate 	return (NULL);
3670Sstevel@tonic-gate }
3680Sstevel@tonic-gate 
3690Sstevel@tonic-gate /*
3700Sstevel@tonic-gate  * free a dev_info structure.
3710Sstevel@tonic-gate  * NB. Not callable from interrupt since impl_ddi_free_nodeid may block.
3720Sstevel@tonic-gate  */
3730Sstevel@tonic-gate void
3740Sstevel@tonic-gate i_ddi_free_node(dev_info_t *dip)
3750Sstevel@tonic-gate {
3760Sstevel@tonic-gate 	struct dev_info *devi = DEVI(dip);
3770Sstevel@tonic-gate 	struct devi_nodeid *elem;
3780Sstevel@tonic-gate 
3790Sstevel@tonic-gate 	ASSERT(devi->devi_ref == 0);
3800Sstevel@tonic-gate 	ASSERT(devi->devi_addr == NULL);
3810Sstevel@tonic-gate 	ASSERT(devi->devi_node_state == DS_PROTO);
3820Sstevel@tonic-gate 	ASSERT(devi->devi_child == NULL);
3830Sstevel@tonic-gate 
384439Scth 	/* free devi_addr_buf allocated by ddi_set_name_addr() */
385439Scth 	if (devi->devi_addr_buf)
386439Scth 		kmem_free(devi->devi_addr_buf, 2 * MAXNAMELEN);
3870Sstevel@tonic-gate 
3880Sstevel@tonic-gate 	if (i_ndi_dev_is_auto_assigned_node(dip))
3890Sstevel@tonic-gate 		impl_ddi_free_nodeid(DEVI(dip)->devi_nodeid);
3900Sstevel@tonic-gate 
3910Sstevel@tonic-gate 	if (ndi_dev_is_persistent_node(dip)) {
3920Sstevel@tonic-gate 		mutex_enter(&devimap->dno_lock);
3930Sstevel@tonic-gate 		ASSERT(devimap->dno_free);
3940Sstevel@tonic-gate 		elem = devimap->dno_free;
3950Sstevel@tonic-gate 		devimap->dno_free = elem->next;
3960Sstevel@tonic-gate 		mutex_exit(&devimap->dno_lock);
3970Sstevel@tonic-gate 		kmem_free(elem, sizeof (*elem));
3980Sstevel@tonic-gate 	}
3990Sstevel@tonic-gate 
4000Sstevel@tonic-gate 	if (DEVI(dip)->devi_compat_names)
4010Sstevel@tonic-gate 		kmem_free(DEVI(dip)->devi_compat_names,
4020Sstevel@tonic-gate 		    DEVI(dip)->devi_compat_length);
4034145Scth 	if (DEVI(dip)->devi_rebinding_name)
4044145Scth 		kmem_free(DEVI(dip)->devi_rebinding_name,
4054145Scth 		    strlen(DEVI(dip)->devi_rebinding_name) + 1);
4060Sstevel@tonic-gate 
4070Sstevel@tonic-gate 	ddi_prop_remove_all(dip);	/* remove driver properties */
4080Sstevel@tonic-gate 	if (devi->devi_sys_prop_ptr)
4090Sstevel@tonic-gate 		i_ddi_prop_list_delete(devi->devi_sys_prop_ptr);
4100Sstevel@tonic-gate 	if (devi->devi_hw_prop_ptr)
4110Sstevel@tonic-gate 		i_ddi_prop_list_delete(devi->devi_hw_prop_ptr);
4120Sstevel@tonic-gate 
4136640Scth 	if (DEVI(dip)->devi_devid_str)
4146640Scth 		ddi_devid_str_free(DEVI(dip)->devi_devid_str);
4156640Scth 
4160Sstevel@tonic-gate 	i_ddi_set_node_state(dip, DS_INVAL);
4170Sstevel@tonic-gate 	da_log_enter(dip);
4180Sstevel@tonic-gate 	if (devi->devi_audit) {
4190Sstevel@tonic-gate 		kmem_free(devi->devi_audit, sizeof (devinfo_audit_t));
4200Sstevel@tonic-gate 	}
4210Sstevel@tonic-gate 	if (devi->devi_device_class)
4220Sstevel@tonic-gate 		kmem_free(devi->devi_device_class,
4230Sstevel@tonic-gate 		    strlen(devi->devi_device_class) + 1);
4240Sstevel@tonic-gate 	cv_destroy(&(devi->devi_cv));
4250Sstevel@tonic-gate 	mutex_destroy(&(devi->devi_lock));
4260Sstevel@tonic-gate 	mutex_destroy(&(devi->devi_pm_lock));
4270Sstevel@tonic-gate 	mutex_destroy(&(devi->devi_pm_busy_lock));
4280Sstevel@tonic-gate 
4294845Svikram 	RIO_TRACE((CE_NOTE, "i_ddi_free_node: destroying contract fields: "
4304845Svikram 	    "dip=%p", (void *)dip));
4314845Svikram 	contract_device_remove_dip(dip);
4324845Svikram 	ASSERT(devi->devi_ct_count == -1);
4334845Svikram 	ASSERT(list_is_empty(&(devi->devi_ct)));
4344845Svikram 	cv_destroy(&(devi->devi_ct_cv));
4354845Svikram 	list_destroy(&(devi->devi_ct));
4364845Svikram 	/* free this last since contract_device_remove_dip() uses it */
4374845Svikram 	mutex_destroy(&(devi->devi_ct_lock));
4384845Svikram 	RIO_TRACE((CE_NOTE, "i_ddi_free_node: destroyed all contract fields: "
4394845Svikram 	    "dip=%p, name=%s", (void *)dip, devi->devi_node_name));
4404845Svikram 
4414845Svikram 	kmem_free(devi->devi_node_name, strlen(devi->devi_node_name) + 1);
4424845Svikram 
4430Sstevel@tonic-gate 	kmem_cache_free(ddi_node_cache, devi);
4440Sstevel@tonic-gate }
4450Sstevel@tonic-gate 
4460Sstevel@tonic-gate 
4470Sstevel@tonic-gate /*
4480Sstevel@tonic-gate  * Node state transitions
4490Sstevel@tonic-gate  */
4500Sstevel@tonic-gate 
4510Sstevel@tonic-gate /*
4520Sstevel@tonic-gate  * Change the node name
4530Sstevel@tonic-gate  */
4540Sstevel@tonic-gate int
4550Sstevel@tonic-gate ndi_devi_set_nodename(dev_info_t *dip, char *name, int flags)
4560Sstevel@tonic-gate {
4570Sstevel@tonic-gate 	_NOTE(ARGUNUSED(flags))
4580Sstevel@tonic-gate 	char *nname, *oname;
4590Sstevel@tonic-gate 
4600Sstevel@tonic-gate 	ASSERT(dip && name);
4610Sstevel@tonic-gate 
4620Sstevel@tonic-gate 	oname = DEVI(dip)->devi_node_name;
4630Sstevel@tonic-gate 	if (strcmp(oname, name) == 0)
4640Sstevel@tonic-gate 		return (DDI_SUCCESS);
4650Sstevel@tonic-gate 
4660Sstevel@tonic-gate 	/*
4670Sstevel@tonic-gate 	 * pcicfg_fix_ethernet requires a name change after node
4680Sstevel@tonic-gate 	 * is linked into the tree. When pcicfg is fixed, we
4690Sstevel@tonic-gate 	 * should only allow name change in DS_PROTO state.
4700Sstevel@tonic-gate 	 */
4710Sstevel@tonic-gate 	if (i_ddi_node_state(dip) >= DS_BOUND) {
4720Sstevel@tonic-gate 		/*
4730Sstevel@tonic-gate 		 * Don't allow name change once node is bound
4740Sstevel@tonic-gate 		 */
4750Sstevel@tonic-gate 		cmn_err(CE_NOTE,
4760Sstevel@tonic-gate 		    "ndi_devi_set_nodename: node already bound dip = %p,"
4770Sstevel@tonic-gate 		    " %s -> %s", (void *)dip, ddi_node_name(dip), name);
4780Sstevel@tonic-gate 		return (NDI_FAILURE);
4790Sstevel@tonic-gate 	}
4800Sstevel@tonic-gate 
4810Sstevel@tonic-gate 	nname = i_ddi_strdup(name, KM_SLEEP);
4820Sstevel@tonic-gate 	DEVI(dip)->devi_node_name = nname;
4830Sstevel@tonic-gate 	i_ddi_set_binding_name(dip, nname);
4840Sstevel@tonic-gate 	kmem_free(oname, strlen(oname) + 1);
4850Sstevel@tonic-gate 
4860Sstevel@tonic-gate 	da_log_enter(dip);
4870Sstevel@tonic-gate 	return (NDI_SUCCESS);
4880Sstevel@tonic-gate }
4890Sstevel@tonic-gate 
4900Sstevel@tonic-gate void
4910Sstevel@tonic-gate i_ddi_add_devimap(dev_info_t *dip)
4920Sstevel@tonic-gate {
4930Sstevel@tonic-gate 	struct devi_nodeid *elem;
4940Sstevel@tonic-gate 
4950Sstevel@tonic-gate 	ASSERT(dip);
4960Sstevel@tonic-gate 
4970Sstevel@tonic-gate 	if (!ndi_dev_is_persistent_node(dip))
4980Sstevel@tonic-gate 		return;
4990Sstevel@tonic-gate 
5000Sstevel@tonic-gate 	ASSERT(ddi_get_parent(dip) == NULL || (DEVI_VHCI_NODE(dip)) ||
5010Sstevel@tonic-gate 	    DEVI_BUSY_OWNED(ddi_get_parent(dip)));
5020Sstevel@tonic-gate 
5030Sstevel@tonic-gate 	mutex_enter(&devimap->dno_lock);
5040Sstevel@tonic-gate 
5050Sstevel@tonic-gate 	ASSERT(devimap->dno_free);
5060Sstevel@tonic-gate 
5070Sstevel@tonic-gate 	elem = devimap->dno_free;
5080Sstevel@tonic-gate 	devimap->dno_free = elem->next;
5090Sstevel@tonic-gate 
5100Sstevel@tonic-gate 	elem->nodeid = ddi_get_nodeid(dip);
5110Sstevel@tonic-gate 	elem->dip = dip;
5120Sstevel@tonic-gate 	elem->next = devimap->dno_head;
5130Sstevel@tonic-gate 	devimap->dno_head = elem;
5140Sstevel@tonic-gate 
5150Sstevel@tonic-gate 	devimap->dno_list_length++;
5160Sstevel@tonic-gate 
5170Sstevel@tonic-gate 	mutex_exit(&devimap->dno_lock);
5180Sstevel@tonic-gate }
5190Sstevel@tonic-gate 
5200Sstevel@tonic-gate static int
5210Sstevel@tonic-gate i_ddi_remove_devimap(dev_info_t *dip)
5220Sstevel@tonic-gate {
5230Sstevel@tonic-gate 	struct devi_nodeid *prev, *elem;
5240Sstevel@tonic-gate 	static const char *fcn = "i_ddi_remove_devimap";
5250Sstevel@tonic-gate 
5260Sstevel@tonic-gate 	ASSERT(dip);
5270Sstevel@tonic-gate 
5280Sstevel@tonic-gate 	if (!ndi_dev_is_persistent_node(dip))
5290Sstevel@tonic-gate 		return (DDI_SUCCESS);
5300Sstevel@tonic-gate 
5310Sstevel@tonic-gate 	mutex_enter(&devimap->dno_lock);
5320Sstevel@tonic-gate 
5330Sstevel@tonic-gate 	/*
5340Sstevel@tonic-gate 	 * The following check is done with dno_lock held
5350Sstevel@tonic-gate 	 * to prevent race between dip removal and
5360Sstevel@tonic-gate 	 * e_ddi_prom_node_to_dip()
5370Sstevel@tonic-gate 	 */
5380Sstevel@tonic-gate 	if (e_ddi_devi_holdcnt(dip)) {
5390Sstevel@tonic-gate 		mutex_exit(&devimap->dno_lock);
5400Sstevel@tonic-gate 		return (DDI_FAILURE);
5410Sstevel@tonic-gate 	}
5420Sstevel@tonic-gate 
5430Sstevel@tonic-gate 	ASSERT(devimap->dno_head);
5440Sstevel@tonic-gate 	ASSERT(devimap->dno_list_length > 0);
5450Sstevel@tonic-gate 
5460Sstevel@tonic-gate 	prev = NULL;
5470Sstevel@tonic-gate 	for (elem = devimap->dno_head; elem; elem = elem->next) {
5480Sstevel@tonic-gate 		if (elem->dip == dip) {
5490Sstevel@tonic-gate 			ASSERT(elem->nodeid == ddi_get_nodeid(dip));
5500Sstevel@tonic-gate 			break;
5510Sstevel@tonic-gate 		}
5520Sstevel@tonic-gate 		prev = elem;
5530Sstevel@tonic-gate 	}
5540Sstevel@tonic-gate 
5550Sstevel@tonic-gate 	if (elem && prev)
5560Sstevel@tonic-gate 		prev->next = elem->next;
5570Sstevel@tonic-gate 	else if (elem)
5580Sstevel@tonic-gate 		devimap->dno_head = elem->next;
5590Sstevel@tonic-gate 	else
5600Sstevel@tonic-gate 		panic("%s: devinfo node(%p) not found",
5610Sstevel@tonic-gate 		    fcn, (void *)dip);
5620Sstevel@tonic-gate 
5630Sstevel@tonic-gate 	devimap->dno_list_length--;
5640Sstevel@tonic-gate 
5650Sstevel@tonic-gate 	elem->nodeid = 0;
5660Sstevel@tonic-gate 	elem->dip = NULL;
5670Sstevel@tonic-gate 
5680Sstevel@tonic-gate 	elem->next = devimap->dno_free;
5690Sstevel@tonic-gate 	devimap->dno_free = elem;
5700Sstevel@tonic-gate 
5710Sstevel@tonic-gate 	mutex_exit(&devimap->dno_lock);
5720Sstevel@tonic-gate 
5730Sstevel@tonic-gate 	return (DDI_SUCCESS);
5740Sstevel@tonic-gate }
5750Sstevel@tonic-gate 
5760Sstevel@tonic-gate /*
5770Sstevel@tonic-gate  * Link this node into the devinfo tree and add to orphan list
5780Sstevel@tonic-gate  * Not callable from interrupt context
5790Sstevel@tonic-gate  */
5800Sstevel@tonic-gate static void
5810Sstevel@tonic-gate link_node(dev_info_t *dip)
5820Sstevel@tonic-gate {
5830Sstevel@tonic-gate 	struct dev_info *devi = DEVI(dip);
5840Sstevel@tonic-gate 	struct dev_info *parent = devi->devi_parent;
5850Sstevel@tonic-gate 	dev_info_t **dipp;
5860Sstevel@tonic-gate 
5870Sstevel@tonic-gate 	ASSERT(parent);	/* never called for root node */
5880Sstevel@tonic-gate 
5890Sstevel@tonic-gate 	NDI_CONFIG_DEBUG((CE_CONT, "link_node: parent = %s child = %s\n",
5900Sstevel@tonic-gate 	    parent->devi_node_name, devi->devi_node_name));
5910Sstevel@tonic-gate 
5920Sstevel@tonic-gate 	/*
5930Sstevel@tonic-gate 	 * Hold the global_vhci_lock before linking any direct
5940Sstevel@tonic-gate 	 * children of rootnex driver. This special lock protects
5950Sstevel@tonic-gate 	 * linking and unlinking for rootnext direct children.
5960Sstevel@tonic-gate 	 */
5970Sstevel@tonic-gate 	if ((dev_info_t *)parent == ddi_root_node())
5980Sstevel@tonic-gate 		mutex_enter(&global_vhci_lock);
5990Sstevel@tonic-gate 
6000Sstevel@tonic-gate 	/*
6010Sstevel@tonic-gate 	 * attach the node to end of the list unless the node is already there
6020Sstevel@tonic-gate 	 */
6030Sstevel@tonic-gate 	dipp = (dev_info_t **)(&DEVI(parent)->devi_child);
6040Sstevel@tonic-gate 	while (*dipp && (*dipp != dip)) {
6050Sstevel@tonic-gate 		dipp = (dev_info_t **)(&DEVI(*dipp)->devi_sibling);
6060Sstevel@tonic-gate 	}
6070Sstevel@tonic-gate 	ASSERT(*dipp == NULL);	/* node is not linked */
6080Sstevel@tonic-gate 
6090Sstevel@tonic-gate 	/*
6100Sstevel@tonic-gate 	 * Now that we are in the tree, update the devi-nodeid map.
6110Sstevel@tonic-gate 	 */
6120Sstevel@tonic-gate 	i_ddi_add_devimap(dip);
6130Sstevel@tonic-gate 
6140Sstevel@tonic-gate 	/*
6150Sstevel@tonic-gate 	 * This is a temporary workaround for Bug 4618861.
6160Sstevel@tonic-gate 	 * We keep the scsi_vhci nexus node on the left side of the devinfo
6170Sstevel@tonic-gate 	 * tree (under the root nexus driver), so that virtual nodes under
6180Sstevel@tonic-gate 	 * scsi_vhci will be SUSPENDed first and RESUMEd last.  This ensures
6190Sstevel@tonic-gate 	 * that the pHCI nodes are active during times when their clients
6200Sstevel@tonic-gate 	 * may be depending on them.  This workaround embodies the knowledge
6210Sstevel@tonic-gate 	 * that system PM and CPR both traverse the tree left-to-right during
6220Sstevel@tonic-gate 	 * SUSPEND and right-to-left during RESUME.
6231093Shiremath 	 * Extending the workaround to IB Nexus/VHCI
6241093Shiremath 	 * driver also.
6250Sstevel@tonic-gate 	 */
6264145Scth 	if (strcmp(devi->devi_binding_name, "scsi_vhci") == 0) {
6270Sstevel@tonic-gate 		/* Add scsi_vhci to beginning of list */
6280Sstevel@tonic-gate 		ASSERT((dev_info_t *)parent == top_devinfo);
6290Sstevel@tonic-gate 		/* scsi_vhci under rootnex */
6300Sstevel@tonic-gate 		devi->devi_sibling = parent->devi_child;
6310Sstevel@tonic-gate 		parent->devi_child = devi;
6324145Scth 	} else if (strcmp(devi->devi_binding_name, "ib") == 0) {
6331093Shiremath 		i_link_vhci_node(dip);
6340Sstevel@tonic-gate 	} else {
6350Sstevel@tonic-gate 		/* Add to end of list */
6360Sstevel@tonic-gate 		*dipp = dip;
6370Sstevel@tonic-gate 		DEVI(dip)->devi_sibling = NULL;
6380Sstevel@tonic-gate 	}
6390Sstevel@tonic-gate 
6400Sstevel@tonic-gate 	/*
6410Sstevel@tonic-gate 	 * Release the global_vhci_lock before linking any direct
6420Sstevel@tonic-gate 	 * children of rootnex driver.
6430Sstevel@tonic-gate 	 */
6440Sstevel@tonic-gate 	if ((dev_info_t *)parent == ddi_root_node())
6450Sstevel@tonic-gate 		mutex_exit(&global_vhci_lock);
6460Sstevel@tonic-gate 
6470Sstevel@tonic-gate 	/* persistent nodes go on orphan list */
6480Sstevel@tonic-gate 	if (ndi_dev_is_persistent_node(dip))
6490Sstevel@tonic-gate 		add_to_dn_list(&orphanlist, dip);
6500Sstevel@tonic-gate }
6510Sstevel@tonic-gate 
6520Sstevel@tonic-gate /*
6530Sstevel@tonic-gate  * Unlink this node from the devinfo tree
6540Sstevel@tonic-gate  */
6550Sstevel@tonic-gate static int
6560Sstevel@tonic-gate unlink_node(dev_info_t *dip)
6570Sstevel@tonic-gate {
6580Sstevel@tonic-gate 	struct dev_info *devi = DEVI(dip);
6590Sstevel@tonic-gate 	struct dev_info *parent = devi->devi_parent;
6600Sstevel@tonic-gate 	dev_info_t **dipp;
6610Sstevel@tonic-gate 
6620Sstevel@tonic-gate 	ASSERT(parent != NULL);
6630Sstevel@tonic-gate 	ASSERT(devi->devi_node_state == DS_LINKED);
6640Sstevel@tonic-gate 
6650Sstevel@tonic-gate 	NDI_CONFIG_DEBUG((CE_CONT, "unlink_node: name = %s\n",
6660Sstevel@tonic-gate 	    ddi_node_name(dip)));
6670Sstevel@tonic-gate 
6680Sstevel@tonic-gate 	/* check references */
6690Sstevel@tonic-gate 	if (devi->devi_ref || i_ddi_remove_devimap(dip) != DDI_SUCCESS)
6700Sstevel@tonic-gate 		return (DDI_FAILURE);
6710Sstevel@tonic-gate 
6720Sstevel@tonic-gate 	/*
6730Sstevel@tonic-gate 	 * Hold the global_vhci_lock before linking any direct
6740Sstevel@tonic-gate 	 * children of rootnex driver.
6750Sstevel@tonic-gate 	 */
6760Sstevel@tonic-gate 	if ((dev_info_t *)parent == ddi_root_node())
6770Sstevel@tonic-gate 		mutex_enter(&global_vhci_lock);
6780Sstevel@tonic-gate 
6790Sstevel@tonic-gate 	dipp = (dev_info_t **)(&DEVI(parent)->devi_child);
6800Sstevel@tonic-gate 	while (*dipp && (*dipp != dip)) {
6810Sstevel@tonic-gate 		dipp = (dev_info_t **)(&DEVI(*dipp)->devi_sibling);
6820Sstevel@tonic-gate 	}
6830Sstevel@tonic-gate 	if (*dipp) {
6840Sstevel@tonic-gate 		*dipp = (dev_info_t *)(devi->devi_sibling);
6850Sstevel@tonic-gate 		devi->devi_sibling = NULL;
6860Sstevel@tonic-gate 	} else {
6870Sstevel@tonic-gate 		NDI_CONFIG_DEBUG((CE_NOTE, "unlink_node: %s not linked",
6880Sstevel@tonic-gate 		    devi->devi_node_name));
6890Sstevel@tonic-gate 	}
6900Sstevel@tonic-gate 
6910Sstevel@tonic-gate 	/*
6920Sstevel@tonic-gate 	 * Release the global_vhci_lock before linking any direct
6930Sstevel@tonic-gate 	 * children of rootnex driver.
6940Sstevel@tonic-gate 	 */
6950Sstevel@tonic-gate 	if ((dev_info_t *)parent == ddi_root_node())
6960Sstevel@tonic-gate 		mutex_exit(&global_vhci_lock);
6970Sstevel@tonic-gate 
6980Sstevel@tonic-gate 	/* Remove node from orphan list */
6990Sstevel@tonic-gate 	if (ndi_dev_is_persistent_node(dip)) {
7000Sstevel@tonic-gate 		remove_from_dn_list(&orphanlist, dip);
7010Sstevel@tonic-gate 	}
7020Sstevel@tonic-gate 
7030Sstevel@tonic-gate 	return (DDI_SUCCESS);
7040Sstevel@tonic-gate }
7050Sstevel@tonic-gate 
7060Sstevel@tonic-gate /*
7070Sstevel@tonic-gate  * Bind this devinfo node to a driver. If compat is NON-NULL, try that first.
7080Sstevel@tonic-gate  * Else, use the node-name.
7090Sstevel@tonic-gate  *
7100Sstevel@tonic-gate  * NOTE: IEEE1275 specifies that nodename should be tried before compatible.
7110Sstevel@tonic-gate  *	Solaris implementation binds nodename after compatible.
7120Sstevel@tonic-gate  *
7130Sstevel@tonic-gate  * If we find a binding,
7140Sstevel@tonic-gate  * - set the binding name to the the string,
7150Sstevel@tonic-gate  * - set major number to driver major
7160Sstevel@tonic-gate  *
7170Sstevel@tonic-gate  * If we don't find a binding,
7180Sstevel@tonic-gate  * - return failure
7190Sstevel@tonic-gate  */
7200Sstevel@tonic-gate static int
7210Sstevel@tonic-gate bind_node(dev_info_t *dip)
7220Sstevel@tonic-gate {
7230Sstevel@tonic-gate 	char *p = NULL;
7247009Scth 	major_t major = DDI_MAJOR_T_NONE;
7250Sstevel@tonic-gate 	struct dev_info *devi = DEVI(dip);
7260Sstevel@tonic-gate 	dev_info_t *parent = ddi_get_parent(dip);
7270Sstevel@tonic-gate 
7280Sstevel@tonic-gate 	ASSERT(devi->devi_node_state == DS_LINKED);
7290Sstevel@tonic-gate 
7300Sstevel@tonic-gate 	NDI_CONFIG_DEBUG((CE_CONT, "bind_node: 0x%p(name = %s)\n",
7310Sstevel@tonic-gate 	    (void *)dip, ddi_node_name(dip)));
7320Sstevel@tonic-gate 
7330Sstevel@tonic-gate 	mutex_enter(&DEVI(dip)->devi_lock);
7340Sstevel@tonic-gate 	if (DEVI(dip)->devi_flags & DEVI_NO_BIND) {
7350Sstevel@tonic-gate 		mutex_exit(&DEVI(dip)->devi_lock);
7360Sstevel@tonic-gate 		return (DDI_FAILURE);
7370Sstevel@tonic-gate 	}
7380Sstevel@tonic-gate 	mutex_exit(&DEVI(dip)->devi_lock);
7390Sstevel@tonic-gate 
7400Sstevel@tonic-gate 	/* find the driver with most specific binding using compatible */
7410Sstevel@tonic-gate 	major = ddi_compatible_driver_major(dip, &p);
7427009Scth 	if (major == DDI_MAJOR_T_NONE)
7430Sstevel@tonic-gate 		return (DDI_FAILURE);
7440Sstevel@tonic-gate 
7450Sstevel@tonic-gate 	devi->devi_major = major;
7460Sstevel@tonic-gate 	if (p != NULL) {
7470Sstevel@tonic-gate 		i_ddi_set_binding_name(dip, p);
7480Sstevel@tonic-gate 		NDI_CONFIG_DEBUG((CE_CONT, "bind_node: %s bound to %s\n",
7490Sstevel@tonic-gate 		    devi->devi_node_name, p));
7500Sstevel@tonic-gate 	}
7510Sstevel@tonic-gate 
7520Sstevel@tonic-gate 	/* Link node to per-driver list */
7530Sstevel@tonic-gate 	link_to_driver_list(dip);
7540Sstevel@tonic-gate 
7550Sstevel@tonic-gate 	/*
7560Sstevel@tonic-gate 	 * reset parent flag so that nexus will merge .conf props
7570Sstevel@tonic-gate 	 */
7580Sstevel@tonic-gate 	if (ndi_dev_is_persistent_node(dip)) {
7590Sstevel@tonic-gate 		mutex_enter(&DEVI(parent)->devi_lock);
7600Sstevel@tonic-gate 		DEVI(parent)->devi_flags &=
7610Sstevel@tonic-gate 		    ~(DEVI_ATTACHED_CHILDREN|DEVI_MADE_CHILDREN);
7620Sstevel@tonic-gate 		mutex_exit(&DEVI(parent)->devi_lock);
7630Sstevel@tonic-gate 	}
7640Sstevel@tonic-gate 	return (DDI_SUCCESS);
7650Sstevel@tonic-gate }
7660Sstevel@tonic-gate 
7670Sstevel@tonic-gate /*
7680Sstevel@tonic-gate  * Unbind this devinfo node
7690Sstevel@tonic-gate  * Called before the node is destroyed or driver is removed from system
7700Sstevel@tonic-gate  */
7710Sstevel@tonic-gate static int
7720Sstevel@tonic-gate unbind_node(dev_info_t *dip)
7730Sstevel@tonic-gate {
7740Sstevel@tonic-gate 	ASSERT(DEVI(dip)->devi_node_state == DS_BOUND);
7757009Scth 	ASSERT(DEVI(dip)->devi_major != DDI_MAJOR_T_NONE);
7760Sstevel@tonic-gate 
7770Sstevel@tonic-gate 	/* check references */
7780Sstevel@tonic-gate 	if (DEVI(dip)->devi_ref)
7790Sstevel@tonic-gate 		return (DDI_FAILURE);
7800Sstevel@tonic-gate 
7810Sstevel@tonic-gate 	NDI_CONFIG_DEBUG((CE_CONT, "unbind_node: 0x%p(name = %s)\n",
7820Sstevel@tonic-gate 	    (void *)dip, ddi_node_name(dip)));
7830Sstevel@tonic-gate 
7840Sstevel@tonic-gate 	unlink_from_driver_list(dip);
7854145Scth 
7867009Scth 	DEVI(dip)->devi_major = DDI_MAJOR_T_NONE;
7874145Scth 	DEVI(dip)->devi_binding_name = DEVI(dip)->devi_node_name;
7880Sstevel@tonic-gate 	return (DDI_SUCCESS);
7890Sstevel@tonic-gate }
7900Sstevel@tonic-gate 
7910Sstevel@tonic-gate /*
7920Sstevel@tonic-gate  * Initialize a node: calls the parent nexus' bus_ctl ops to do the operation.
7930Sstevel@tonic-gate  * Must hold parent and per-driver list while calling this function.
7940Sstevel@tonic-gate  * A successful init_node() returns with an active ndi_hold_devi() hold on
7950Sstevel@tonic-gate  * the parent.
7960Sstevel@tonic-gate  */
7970Sstevel@tonic-gate static int
7980Sstevel@tonic-gate init_node(dev_info_t *dip)
7990Sstevel@tonic-gate {
8000Sstevel@tonic-gate 	int error;
8010Sstevel@tonic-gate 	dev_info_t *pdip = ddi_get_parent(dip);
8020Sstevel@tonic-gate 	int (*f)(dev_info_t *, dev_info_t *, ddi_ctl_enum_t, void *, void *);
8030Sstevel@tonic-gate 	char *path;
8044145Scth 	major_t	major;
8050Sstevel@tonic-gate 
8060Sstevel@tonic-gate 	ASSERT(i_ddi_node_state(dip) == DS_BOUND);
8070Sstevel@tonic-gate 
8080Sstevel@tonic-gate 	/* should be DS_READY except for pcmcia ... */
8090Sstevel@tonic-gate 	ASSERT(i_ddi_node_state(pdip) >= DS_PROBED);
8100Sstevel@tonic-gate 
8110Sstevel@tonic-gate 	path = kmem_alloc(MAXPATHLEN, KM_SLEEP);
8120Sstevel@tonic-gate 	(void) ddi_pathname(dip, path);
8130Sstevel@tonic-gate 	NDI_CONFIG_DEBUG((CE_CONT, "init_node: entry: path %s 0x%p\n",
8140Sstevel@tonic-gate 	    path, (void *)dip));
8150Sstevel@tonic-gate 
8160Sstevel@tonic-gate 	/*
8170Sstevel@tonic-gate 	 * The parent must have a bus_ctl operation.
8180Sstevel@tonic-gate 	 */
8190Sstevel@tonic-gate 	if ((DEVI(pdip)->devi_ops->devo_bus_ops == NULL) ||
8200Sstevel@tonic-gate 	    (f = DEVI(pdip)->devi_ops->devo_bus_ops->bus_ctl) == NULL) {
8210Sstevel@tonic-gate 		error = DDI_FAILURE;
8220Sstevel@tonic-gate 		goto out;
8230Sstevel@tonic-gate 	}
8240Sstevel@tonic-gate 
8250Sstevel@tonic-gate 	add_global_props(dip);
8260Sstevel@tonic-gate 
8270Sstevel@tonic-gate 	/*
8280Sstevel@tonic-gate 	 * Invoke the parent's bus_ctl operation with the DDI_CTLOPS_INITCHILD
8290Sstevel@tonic-gate 	 * command to transform the child to canonical form 1. If there
8300Sstevel@tonic-gate 	 * is an error, ddi_remove_child should be called, to clean up.
8310Sstevel@tonic-gate 	 */
8320Sstevel@tonic-gate 	error = (*f)(pdip, pdip, DDI_CTLOPS_INITCHILD, dip, NULL);
8330Sstevel@tonic-gate 	if (error != DDI_SUCCESS) {
8340Sstevel@tonic-gate 		NDI_CONFIG_DEBUG((CE_CONT, "init_node: %s 0x%p failed\n",
8350Sstevel@tonic-gate 		    path, (void *)dip));
8360Sstevel@tonic-gate 		remove_global_props(dip);
8370Sstevel@tonic-gate 		/* in case nexus driver didn't clear this field */
8380Sstevel@tonic-gate 		ddi_set_name_addr(dip, NULL);
8390Sstevel@tonic-gate 		error = DDI_FAILURE;
8400Sstevel@tonic-gate 		goto out;
8410Sstevel@tonic-gate 	}
8420Sstevel@tonic-gate 
8434950Scth 	ndi_hold_devi(pdip);			/* initial hold of parent */
8440Sstevel@tonic-gate 
8454145Scth 	/* recompute path after initchild for @addr information */
8464145Scth 	(void) ddi_pathname(dip, path);
8474145Scth 
8484145Scth 	/* Check for duplicate nodes */
8490Sstevel@tonic-gate 	if (find_duplicate_child(pdip, dip) != NULL) {
8500Sstevel@tonic-gate 		/*
8510Sstevel@tonic-gate 		 * uninit_node() the duplicate - a successful uninit_node()
8524950Scth 		 * will release inital hold of parent using ndi_rele_devi().
8530Sstevel@tonic-gate 		 */
8540Sstevel@tonic-gate 		if ((error = uninit_node(dip)) != DDI_SUCCESS) {
8554950Scth 			ndi_rele_devi(pdip);	/* release initial hold */
8560Sstevel@tonic-gate 			cmn_err(CE_WARN, "init_node: uninit of duplicate "
8570Sstevel@tonic-gate 			    "node %s failed", path);
8580Sstevel@tonic-gate 		}
8590Sstevel@tonic-gate 		NDI_CONFIG_DEBUG((CE_CONT, "init_node: duplicate uninit "
8600Sstevel@tonic-gate 		    "%s 0x%p%s\n", path, (void *)dip,
8610Sstevel@tonic-gate 		    (error == DDI_SUCCESS) ? "" : " failed"));
8620Sstevel@tonic-gate 		error = DDI_FAILURE;
8630Sstevel@tonic-gate 		goto out;
8640Sstevel@tonic-gate 	}
8650Sstevel@tonic-gate 
8660Sstevel@tonic-gate 	/*
8674145Scth 	 * Check to see if we have a path-oriented driver alias that overrides
8684145Scth 	 * the current driver binding. If so, we need to rebind. This check
8694145Scth 	 * needs to be delayed until after a successful DDI_CTLOPS_INITCHILD,
8704145Scth 	 * so the unit-address is established on the last component of the path.
8714145Scth 	 *
8724145Scth 	 * NOTE: Allowing a path-oriented alias to change the driver binding
8734145Scth 	 * of a driver.conf node results in non-intuitive property behavior.
8744145Scth 	 * We provide a tunable (driver_conf_allow_path_alias) to control
8754145Scth 	 * this behavior. See uninit_node() for more details.
8764145Scth 	 *
8774145Scth 	 * NOTE: If you are adding a path-oriented alias for the boot device,
8784145Scth 	 * and there is mismatch between OBP and the kernel in regard to
8794145Scth 	 * generic name use, like "disk" .vs. "ssd", then you will need
8804145Scth 	 * to add a path-oriented alias for both paths.
8814145Scth 	 */
8824145Scth 	major = ddi_name_to_major(path);
8837009Scth 	if ((major != DDI_MAJOR_T_NONE) &&
8844145Scth 	    !(devnamesp[major].dn_flags & DN_DRIVER_REMOVED) &&
8854145Scth 	    (major != DEVI(dip)->devi_major) &&
8864145Scth 	    (ndi_dev_is_persistent_node(dip) || driver_conf_allow_path_alias)) {
8874145Scth 
8884145Scth 		/* Mark node for rebind processing. */
8894145Scth 		mutex_enter(&DEVI(dip)->devi_lock);
8904145Scth 		DEVI(dip)->devi_flags |= DEVI_REBIND;
8914145Scth 		mutex_exit(&DEVI(dip)->devi_lock);
8924145Scth 
8934145Scth 		/*
8944950Scth 		 * Add an extra hold on the parent to prevent it from ever
8954950Scth 		 * having a zero devi_ref during the child rebind process.
8964950Scth 		 * This is necessary to ensure that the parent will never
8974950Scth 		 * detach(9E) during the rebind.
8984950Scth 		 */
8994950Scth 		ndi_hold_devi(pdip);		/* extra hold of parent */
9004950Scth 
9014950Scth 		/*
9024145Scth 		 * uninit_node() current binding - a successful uninit_node()
9034950Scth 		 * will release extra hold of parent using ndi_rele_devi().
9044145Scth 		 */
9054145Scth 		if ((error = uninit_node(dip)) != DDI_SUCCESS) {
9064950Scth 			ndi_rele_devi(pdip);	/* release extra hold */
9074950Scth 			ndi_rele_devi(pdip);	/* release initial hold */
9084145Scth 			cmn_err(CE_WARN, "init_node: uninit for rebind "
9094145Scth 			    "of node %s failed", path);
9104145Scth 			goto out;
9114145Scth 		}
9124145Scth 
9134145Scth 		/* Unbind: demote the node back to DS_LINKED.  */
9144145Scth 		if ((error = ndi_devi_unbind_driver(dip)) != DDI_SUCCESS) {
9154950Scth 			ndi_rele_devi(pdip);	/* relrease initial hold */
9164145Scth 			cmn_err(CE_WARN, "init_node: unbind for rebind "
9174145Scth 			    "of node %s failed", path);
9184145Scth 			goto out;
9194145Scth 		}
9204145Scth 
9214145Scth 		/* establish rebinding name */
9224145Scth 		if (DEVI(dip)->devi_rebinding_name == NULL)
9234145Scth 			DEVI(dip)->devi_rebinding_name =
9244145Scth 			    i_ddi_strdup(path, KM_SLEEP);
9254145Scth 
9264145Scth 		/*
9274145Scth 		 * Now that we are demoted and marked for rebind, repromote.
9284145Scth 		 * We need to do this in steps, instead of just calling
9294145Scth 		 * ddi_initchild, so that we can redo the merge operation
9304145Scth 		 * after we are rebound to the path-bound driver.
9314145Scth 		 *
9324145Scth 		 * Start by rebinding node to the path-bound driver.
9334145Scth 		 */
9344145Scth 		if ((error = ndi_devi_bind_driver(dip, 0)) != DDI_SUCCESS) {
9354950Scth 			ndi_rele_devi(pdip);	/* relrease initial hold */
9364145Scth 			cmn_err(CE_WARN, "init_node: rebind "
9374145Scth 			    "of node %s failed", path);
9384145Scth 			goto out;
9394145Scth 		}
9404145Scth 
9414145Scth 		/*
9424145Scth 		 * If the node is not a driver.conf node then merge
9434145Scth 		 * driver.conf properties from new path-bound driver.conf.
9444145Scth 		 */
9454145Scth 		if (ndi_dev_is_persistent_node(dip))
9464145Scth 			(void) i_ndi_make_spec_children(pdip, 0);
9474145Scth 
9484145Scth 		/*
9494145Scth 		 * Now that we have taken care of merge, repromote back
9504145Scth 		 * to DS_INITIALIZED.
9514145Scth 		 */
9524145Scth 		error = ddi_initchild(pdip, dip);
9534145Scth 		NDI_CONFIG_DEBUG((CE_CONT, "init_node: rebind "
9544145Scth 		    "%s 0x%p\n", path, (void *)dip));
9554950Scth 
9564950Scth 		/*
9574950Scth 		 * Release our initial hold. If ddi_initchild() was
9587224Scth 		 * successful then it will return with the active hold.
9594950Scth 		 */
9604950Scth 		ndi_rele_devi(pdip);
9614145Scth 		goto out;
9624145Scth 	}
9634145Scth 
9644145Scth 	/*
9650Sstevel@tonic-gate 	 * Apply multi-parent/deep-nexus optimization to the new node
9660Sstevel@tonic-gate 	 */
9670Sstevel@tonic-gate 	DEVI(dip)->devi_instance = e_ddi_assign_instance(dip);
9680Sstevel@tonic-gate 	ddi_optimize_dtree(dip);
9694950Scth 	error = DDI_SUCCESS;		/* return with active hold */
9700Sstevel@tonic-gate 
9714145Scth out:	if (error != DDI_SUCCESS) {
9724145Scth 		/* On failure ensure that DEVI_REBIND is cleared */
9734145Scth 		mutex_enter(&DEVI(dip)->devi_lock);
9744145Scth 		DEVI(dip)->devi_flags &= ~DEVI_REBIND;
9754145Scth 		mutex_exit(&DEVI(dip)->devi_lock);
9764145Scth 	}
9774145Scth 	kmem_free(path, MAXPATHLEN);
9780Sstevel@tonic-gate 	return (error);
9790Sstevel@tonic-gate }
9800Sstevel@tonic-gate 
9810Sstevel@tonic-gate /*
9820Sstevel@tonic-gate  * Uninitialize node
9830Sstevel@tonic-gate  * The per-driver list must be held busy during the call.
9840Sstevel@tonic-gate  * A successful uninit_node() releases the init_node() hold on
9850Sstevel@tonic-gate  * the parent by calling ndi_rele_devi().
9860Sstevel@tonic-gate  */
9870Sstevel@tonic-gate static int
9880Sstevel@tonic-gate uninit_node(dev_info_t *dip)
9890Sstevel@tonic-gate {
9900Sstevel@tonic-gate 	int node_state_entry;
9910Sstevel@tonic-gate 	dev_info_t *pdip;
9920Sstevel@tonic-gate 	struct dev_ops *ops;
9930Sstevel@tonic-gate 	int (*f)();
9940Sstevel@tonic-gate 	int error;
9950Sstevel@tonic-gate 	char *addr;
9960Sstevel@tonic-gate 
9970Sstevel@tonic-gate 	/*
9980Sstevel@tonic-gate 	 * Don't check for references here or else a ref-counted
9990Sstevel@tonic-gate 	 * dip cannot be downgraded by the framework.
10000Sstevel@tonic-gate 	 */
10010Sstevel@tonic-gate 	node_state_entry = i_ddi_node_state(dip);
10020Sstevel@tonic-gate 	ASSERT((node_state_entry == DS_BOUND) ||
10034950Scth 	    (node_state_entry == DS_INITIALIZED));
10040Sstevel@tonic-gate 	pdip = ddi_get_parent(dip);
10050Sstevel@tonic-gate 	ASSERT(pdip);
10060Sstevel@tonic-gate 
10070Sstevel@tonic-gate 	NDI_CONFIG_DEBUG((CE_CONT, "uninit_node: 0x%p(%s%d)\n",
10080Sstevel@tonic-gate 	    (void *)dip, ddi_driver_name(dip), ddi_get_instance(dip)));
10090Sstevel@tonic-gate 
10100Sstevel@tonic-gate 	if (((ops = ddi_get_driver(pdip)) == NULL) ||
10110Sstevel@tonic-gate 	    (ops->devo_bus_ops == NULL) ||
10120Sstevel@tonic-gate 	    ((f = ops->devo_bus_ops->bus_ctl) == NULL)) {
10130Sstevel@tonic-gate 		return (DDI_FAILURE);
10140Sstevel@tonic-gate 	}
10150Sstevel@tonic-gate 
10160Sstevel@tonic-gate 	/*
10170Sstevel@tonic-gate 	 * save the @addr prior to DDI_CTLOPS_UNINITCHILD for use in
10180Sstevel@tonic-gate 	 * freeing the instance if it succeeds.
10190Sstevel@tonic-gate 	 */
10200Sstevel@tonic-gate 	if (node_state_entry == DS_INITIALIZED) {
10210Sstevel@tonic-gate 		addr = ddi_get_name_addr(dip);
10220Sstevel@tonic-gate 		if (addr)
10230Sstevel@tonic-gate 			addr = i_ddi_strdup(addr, KM_SLEEP);
10240Sstevel@tonic-gate 	} else {
10250Sstevel@tonic-gate 		addr = NULL;
10260Sstevel@tonic-gate 	}
10270Sstevel@tonic-gate 
10280Sstevel@tonic-gate 	error = (*f)(pdip, pdip, DDI_CTLOPS_UNINITCHILD, dip, (void *)NULL);
10290Sstevel@tonic-gate 	if (error == DDI_SUCCESS) {
10300Sstevel@tonic-gate 		/* if uninitchild forgot to set devi_addr to NULL do it now */
10310Sstevel@tonic-gate 		ddi_set_name_addr(dip, NULL);
10320Sstevel@tonic-gate 
10330Sstevel@tonic-gate 		/*
10340Sstevel@tonic-gate 		 * Free instance number. This is a no-op if instance has
10350Sstevel@tonic-gate 		 * been kept by probe_node().  Avoid free when we are called
10360Sstevel@tonic-gate 		 * from init_node (DS_BOUND) because the instance has not yet
10370Sstevel@tonic-gate 		 * been assigned.
10380Sstevel@tonic-gate 		 */
10390Sstevel@tonic-gate 		if (node_state_entry == DS_INITIALIZED) {
10400Sstevel@tonic-gate 			e_ddi_free_instance(dip, addr);
10410Sstevel@tonic-gate 			DEVI(dip)->devi_instance = -1;
10420Sstevel@tonic-gate 		}
10430Sstevel@tonic-gate 
10440Sstevel@tonic-gate 		/* release the init_node hold */
10450Sstevel@tonic-gate 		ndi_rele_devi(pdip);
10460Sstevel@tonic-gate 
10470Sstevel@tonic-gate 		remove_global_props(dip);
10484145Scth 
10494145Scth 		/*
10504145Scth 		 * NOTE: The decision on whether to allow a path-oriented
10514145Scth 		 * rebind of a driver.conf enumerated node is made by
10524145Scth 		 * init_node() based on driver_conf_allow_path_alias. The
10534145Scth 		 * rebind code below prevents deletion of system properties
10544145Scth 		 * on driver.conf nodes.
10554145Scth 		 *
10564145Scth 		 * When driver_conf_allow_path_alias is set, property behavior
10574145Scth 		 * on rebound driver.conf file is non-intuitive. For a
10584145Scth 		 * driver.conf node, the unit-address properties come from
10594145Scth 		 * the driver.conf file as system properties. Removing system
10604145Scth 		 * properties from a driver.conf node makes the node
10614145Scth 		 * useless (we get node without unit-address properties) - so
10624145Scth 		 * we leave system properties in place. The result is a node
10634145Scth 		 * where system properties come from the node being rebound,
10644145Scth 		 * and global properties come from the driver.conf file
10654145Scth 		 * of the driver we are rebinding to.  If we could determine
10664145Scth 		 * that the path-oriented alias driver.conf file defined a
10674145Scth 		 * node at the same unit address, it would be best to use
10684145Scth 		 * that node and avoid the non-intuitive property behavior.
10694145Scth 		 * Unfortunately, the current "merge" code does not support
10704145Scth 		 * this, so we live with the non-intuitive property behavior.
10714145Scth 		 */
10724145Scth 		if (!((ndi_dev_is_persistent_node(dip) == 0) &&
10734145Scth 		    (DEVI(dip)->devi_flags & DEVI_REBIND)))
10744145Scth 			e_ddi_prop_remove_all(dip);
10750Sstevel@tonic-gate 	} else {
10760Sstevel@tonic-gate 		NDI_CONFIG_DEBUG((CE_CONT, "uninit_node failed: 0x%p(%s%d)\n",
10770Sstevel@tonic-gate 		    (void *)dip, ddi_driver_name(dip), ddi_get_instance(dip)));
10780Sstevel@tonic-gate 	}
10790Sstevel@tonic-gate 
10800Sstevel@tonic-gate 	if (addr)
10810Sstevel@tonic-gate 		kmem_free(addr, strlen(addr) + 1);
10820Sstevel@tonic-gate 	return (error);
10830Sstevel@tonic-gate }
10840Sstevel@tonic-gate 
10850Sstevel@tonic-gate /*
10860Sstevel@tonic-gate  * Invoke driver's probe entry point to probe for existence of hardware.
10870Sstevel@tonic-gate  * Keep instance permanent for successful probe and leaf nodes.
10880Sstevel@tonic-gate  *
10890Sstevel@tonic-gate  * Per-driver list must be held busy while calling this function.
10900Sstevel@tonic-gate  */
10910Sstevel@tonic-gate static int
10920Sstevel@tonic-gate probe_node(dev_info_t *dip)
10930Sstevel@tonic-gate {
10940Sstevel@tonic-gate 	int rv;
10950Sstevel@tonic-gate 
10960Sstevel@tonic-gate 	ASSERT(i_ddi_node_state(dip) == DS_INITIALIZED);
10970Sstevel@tonic-gate 
10980Sstevel@tonic-gate 	NDI_CONFIG_DEBUG((CE_CONT, "probe_node: 0x%p(%s%d)\n",
10990Sstevel@tonic-gate 	    (void *)dip, ddi_driver_name(dip), ddi_get_instance(dip)));
11000Sstevel@tonic-gate 
11010Sstevel@tonic-gate 	/* temporarily hold the driver while we probe */
11020Sstevel@tonic-gate 	DEVI(dip)->devi_ops = ndi_hold_driver(dip);
11030Sstevel@tonic-gate 	if (DEVI(dip)->devi_ops == NULL) {
11040Sstevel@tonic-gate 		NDI_CONFIG_DEBUG((CE_CONT,
11050Sstevel@tonic-gate 		    "probe_node: 0x%p(%s%d) cannot load driver\n",
11060Sstevel@tonic-gate 		    (void *)dip, ddi_driver_name(dip), ddi_get_instance(dip)));
11070Sstevel@tonic-gate 		return (DDI_FAILURE);
11080Sstevel@tonic-gate 	}
11090Sstevel@tonic-gate 
11100Sstevel@tonic-gate 	if (identify_9e != 0)
11110Sstevel@tonic-gate 		(void) devi_identify(dip);
11120Sstevel@tonic-gate 
11130Sstevel@tonic-gate 	rv = devi_probe(dip);
11140Sstevel@tonic-gate 
11150Sstevel@tonic-gate 	/* release the driver now that probe is complete */
11160Sstevel@tonic-gate 	ndi_rele_driver(dip);
11170Sstevel@tonic-gate 	DEVI(dip)->devi_ops = NULL;
11180Sstevel@tonic-gate 
11190Sstevel@tonic-gate 	switch (rv) {
11200Sstevel@tonic-gate 	case DDI_PROBE_SUCCESS:			/* found */
11210Sstevel@tonic-gate 	case DDI_PROBE_DONTCARE:		/* ddi_dev_is_sid */
11220Sstevel@tonic-gate 		e_ddi_keep_instance(dip);	/* persist instance */
11230Sstevel@tonic-gate 		rv = DDI_SUCCESS;
11240Sstevel@tonic-gate 		break;
11250Sstevel@tonic-gate 
11260Sstevel@tonic-gate 	case DDI_PROBE_PARTIAL:			/* maybe later */
11270Sstevel@tonic-gate 	case DDI_PROBE_FAILURE:			/* not found */
11280Sstevel@tonic-gate 		NDI_CONFIG_DEBUG((CE_CONT,
11290Sstevel@tonic-gate 		    "probe_node: 0x%p(%s%d) no hardware found%s\n",
11300Sstevel@tonic-gate 		    (void *)dip, ddi_driver_name(dip), ddi_get_instance(dip),
11310Sstevel@tonic-gate 		    (rv == DDI_PROBE_PARTIAL) ? " yet" : ""));
11320Sstevel@tonic-gate 		rv = DDI_FAILURE;
11330Sstevel@tonic-gate 		break;
11340Sstevel@tonic-gate 
11350Sstevel@tonic-gate 	default:
11360Sstevel@tonic-gate #ifdef	DEBUG
11370Sstevel@tonic-gate 		cmn_err(CE_WARN, "probe_node: %s%d: illegal probe(9E) value",
11380Sstevel@tonic-gate 		    ddi_driver_name(dip), ddi_get_instance(dip));
11390Sstevel@tonic-gate #endif	/* DEBUG */
11400Sstevel@tonic-gate 		rv = DDI_FAILURE;
11410Sstevel@tonic-gate 		break;
11420Sstevel@tonic-gate 	}
11430Sstevel@tonic-gate 	return (rv);
11440Sstevel@tonic-gate }
11450Sstevel@tonic-gate 
11460Sstevel@tonic-gate /*
11470Sstevel@tonic-gate  * Unprobe a node. Simply reset the node state.
11480Sstevel@tonic-gate  * Per-driver list must be held busy while calling this function.
11490Sstevel@tonic-gate  */
11500Sstevel@tonic-gate static int
11510Sstevel@tonic-gate unprobe_node(dev_info_t *dip)
11520Sstevel@tonic-gate {
11530Sstevel@tonic-gate 	ASSERT(i_ddi_node_state(dip) == DS_PROBED);
11540Sstevel@tonic-gate 
11550Sstevel@tonic-gate 	/*
11560Sstevel@tonic-gate 	 * Don't check for references here or else a ref-counted
11570Sstevel@tonic-gate 	 * dip cannot be downgraded by the framework.
11580Sstevel@tonic-gate 	 */
11590Sstevel@tonic-gate 
11600Sstevel@tonic-gate 	NDI_CONFIG_DEBUG((CE_CONT, "unprobe_node: 0x%p(name = %s)\n",
11610Sstevel@tonic-gate 	    (void *)dip, ddi_node_name(dip)));
11620Sstevel@tonic-gate 	return (DDI_SUCCESS);
11630Sstevel@tonic-gate }
11640Sstevel@tonic-gate 
11650Sstevel@tonic-gate /*
11660Sstevel@tonic-gate  * Attach devinfo node.
11670Sstevel@tonic-gate  * Per-driver list must be held busy.
11680Sstevel@tonic-gate  */
11690Sstevel@tonic-gate static int
11700Sstevel@tonic-gate attach_node(dev_info_t *dip)
11710Sstevel@tonic-gate {
11720Sstevel@tonic-gate 	int rv;
11730Sstevel@tonic-gate 
11742155Scth 	ASSERT(DEVI_BUSY_OWNED(ddi_get_parent(dip)));
11750Sstevel@tonic-gate 	ASSERT(i_ddi_node_state(dip) == DS_PROBED);
11760Sstevel@tonic-gate 
11770Sstevel@tonic-gate 	NDI_CONFIG_DEBUG((CE_CONT, "attach_node: 0x%p(%s%d)\n",
11780Sstevel@tonic-gate 	    (void *)dip, ddi_driver_name(dip), ddi_get_instance(dip)));
11790Sstevel@tonic-gate 
11800Sstevel@tonic-gate 	/*
11810Sstevel@tonic-gate 	 * Tell mpxio framework that a node is about to online.
11820Sstevel@tonic-gate 	 */
11830Sstevel@tonic-gate 	if ((rv = mdi_devi_online(dip, 0)) != NDI_SUCCESS) {
11840Sstevel@tonic-gate 		return (DDI_FAILURE);
11850Sstevel@tonic-gate 	}
11860Sstevel@tonic-gate 
11870Sstevel@tonic-gate 	/* no recursive attachment */
11880Sstevel@tonic-gate 	ASSERT(DEVI(dip)->devi_ops == NULL);
11890Sstevel@tonic-gate 
11900Sstevel@tonic-gate 	/*
11910Sstevel@tonic-gate 	 * Hold driver the node is bound to.
11920Sstevel@tonic-gate 	 */
11930Sstevel@tonic-gate 	DEVI(dip)->devi_ops = ndi_hold_driver(dip);
11940Sstevel@tonic-gate 	if (DEVI(dip)->devi_ops == NULL) {
11950Sstevel@tonic-gate 		/*
11960Sstevel@tonic-gate 		 * We were able to load driver for probing, so we should
11970Sstevel@tonic-gate 		 * not get here unless something really bad happened.
11980Sstevel@tonic-gate 		 */
11990Sstevel@tonic-gate 		cmn_err(CE_WARN, "attach_node: no driver for major %d",
12000Sstevel@tonic-gate 		    DEVI(dip)->devi_major);
12010Sstevel@tonic-gate 		return (DDI_FAILURE);
12020Sstevel@tonic-gate 	}
12030Sstevel@tonic-gate 
12040Sstevel@tonic-gate 	if (NEXUS_DRV(DEVI(dip)->devi_ops))
12050Sstevel@tonic-gate 		DEVI(dip)->devi_taskq = ddi_taskq_create(dip,
12060Sstevel@tonic-gate 		    "nexus_enum_tq", 1,
12070Sstevel@tonic-gate 		    TASKQ_DEFAULTPRI, 0);
12080Sstevel@tonic-gate 
1209495Scth 	mutex_enter(&(DEVI(dip)->devi_lock));
12102009Sdm120769 	DEVI_SET_ATTACHING(dip);
12110Sstevel@tonic-gate 	DEVI_SET_NEED_RESET(dip);
1212495Scth 	mutex_exit(&(DEVI(dip)->devi_lock));
1213495Scth 
12140Sstevel@tonic-gate 	rv = devi_attach(dip, DDI_ATTACH);
1215495Scth 
12162009Sdm120769 	mutex_enter(&(DEVI(dip)->devi_lock));
12172009Sdm120769 	DEVI_CLR_ATTACHING(dip);
12182009Sdm120769 
12191961Scth 	if (rv != DDI_SUCCESS) {
12202155Scth 		DEVI_CLR_NEED_RESET(dip);
12212155Scth 
1222438Scth 		/* ensure that devids are unregistered */
12230Sstevel@tonic-gate 		if (DEVI(dip)->devi_flags & DEVI_REGISTERED_DEVID) {
1224438Scth 			DEVI(dip)->devi_flags &= ~DEVI_REGISTERED_DEVID;
1225438Scth 			mutex_exit(&DEVI(dip)->devi_lock);
12266640Scth 			ddi_devid_unregister(dip);
1227438Scth 		} else
1228438Scth 			mutex_exit(&DEVI(dip)->devi_lock);
1229438Scth 
12300Sstevel@tonic-gate 		/*
12310Sstevel@tonic-gate 		 * Cleanup dacf reservations
12320Sstevel@tonic-gate 		 */
12330Sstevel@tonic-gate 		mutex_enter(&dacf_lock);
12340Sstevel@tonic-gate 		dacf_clr_rsrvs(dip, DACF_OPID_POSTATTACH);
12350Sstevel@tonic-gate 		dacf_clr_rsrvs(dip, DACF_OPID_PREDETACH);
12360Sstevel@tonic-gate 		mutex_exit(&dacf_lock);
12370Sstevel@tonic-gate 		if (DEVI(dip)->devi_taskq)
12380Sstevel@tonic-gate 			ddi_taskq_destroy(DEVI(dip)->devi_taskq);
12390Sstevel@tonic-gate 		ddi_remove_minor_node(dip, NULL);
12400Sstevel@tonic-gate 
12410Sstevel@tonic-gate 		/* release the driver if attach failed */
12420Sstevel@tonic-gate 		ndi_rele_driver(dip);
12430Sstevel@tonic-gate 		DEVI(dip)->devi_ops = NULL;
12440Sstevel@tonic-gate 		NDI_CONFIG_DEBUG((CE_CONT, "attach_node: 0x%p(%s%d) failed\n",
12450Sstevel@tonic-gate 		    (void *)dip, ddi_driver_name(dip), ddi_get_instance(dip)));
12460Sstevel@tonic-gate 		return (DDI_FAILURE);
12472009Sdm120769 	} else
12482009Sdm120769 		mutex_exit(&DEVI(dip)->devi_lock);
12490Sstevel@tonic-gate 
12500Sstevel@tonic-gate 	/* successful attach, return with driver held */
1251495Scth 
12520Sstevel@tonic-gate 	return (DDI_SUCCESS);
12530Sstevel@tonic-gate }
12540Sstevel@tonic-gate 
12550Sstevel@tonic-gate /*
12560Sstevel@tonic-gate  * Detach devinfo node.
12570Sstevel@tonic-gate  * Per-driver list must be held busy.
12580Sstevel@tonic-gate  */
12590Sstevel@tonic-gate static int
12600Sstevel@tonic-gate detach_node(dev_info_t *dip, uint_t flag)
12610Sstevel@tonic-gate {
126253Scth 	struct devnames	*dnp;
126353Scth 	int		rv;
126453Scth 
12652155Scth 	ASSERT(DEVI_BUSY_OWNED(ddi_get_parent(dip)));
12660Sstevel@tonic-gate 	ASSERT(i_ddi_node_state(dip) == DS_ATTACHED);
12670Sstevel@tonic-gate 
12680Sstevel@tonic-gate 	/* check references */
12690Sstevel@tonic-gate 	if (DEVI(dip)->devi_ref)
12700Sstevel@tonic-gate 		return (DDI_FAILURE);
12710Sstevel@tonic-gate 
12720Sstevel@tonic-gate 	NDI_CONFIG_DEBUG((CE_CONT, "detach_node: 0x%p(%s%d)\n",
12730Sstevel@tonic-gate 	    (void *)dip, ddi_driver_name(dip), ddi_get_instance(dip)));
12740Sstevel@tonic-gate 
12752155Scth 	/*
12762155Scth 	 * NOTE: If we are processing a pHCI node then the calling code
12772155Scth 	 * must detect this and ndi_devi_enter() in (vHCI, parent(pHCI))
12782155Scth 	 * order unless pHCI and vHCI are siblings.  Code paths leading
12792155Scth 	 * here that must ensure this ordering include:
12802155Scth 	 * unconfig_immediate_children(), devi_unconfig_one(),
12812155Scth 	 * ndi_devi_unconfig_one(), ndi_devi_offline().
12822155Scth 	 */
12832155Scth 	ASSERT(!MDI_PHCI(dip) ||
12842155Scth 	    (ddi_get_parent(mdi_devi_get_vdip(dip)) == ddi_get_parent(dip)) ||
12852155Scth 	    DEVI_BUSY_OWNED(mdi_devi_get_vdip(dip)));
12862155Scth 
12870Sstevel@tonic-gate 	/* Offline the device node with the mpxio framework. */
12880Sstevel@tonic-gate 	if (mdi_devi_offline(dip, flag) != NDI_SUCCESS) {
12890Sstevel@tonic-gate 		return (DDI_FAILURE);
12900Sstevel@tonic-gate 	}
12910Sstevel@tonic-gate 
12920Sstevel@tonic-gate 	/* drain the taskq */
12930Sstevel@tonic-gate 	if (DEVI(dip)->devi_taskq)
12940Sstevel@tonic-gate 		ddi_taskq_wait(DEVI(dip)->devi_taskq);
12950Sstevel@tonic-gate 
12960Sstevel@tonic-gate 	rv = devi_detach(dip, DDI_DETACH);
12970Sstevel@tonic-gate 
12980Sstevel@tonic-gate 	if (rv != DDI_SUCCESS) {
12990Sstevel@tonic-gate 		NDI_CONFIG_DEBUG((CE_CONT,
13000Sstevel@tonic-gate 		    "detach_node: 0x%p(%s%d) failed\n",
13010Sstevel@tonic-gate 		    (void *)dip, ddi_driver_name(dip), ddi_get_instance(dip)));
13020Sstevel@tonic-gate 		return (DDI_FAILURE);
13030Sstevel@tonic-gate 	}
13040Sstevel@tonic-gate 
13052155Scth 	mutex_enter(&(DEVI(dip)->devi_lock));
13062155Scth 	DEVI_CLR_NEED_RESET(dip);
13072155Scth 	mutex_exit(&(DEVI(dip)->devi_lock));
13082155Scth 
1309*8249SVikram.Hegde@Sun.COM #if defined(__i386) || defined(__amd64)
1310*8249SVikram.Hegde@Sun.COM #if !defined(__xpv)
1311*8249SVikram.Hegde@Sun.COM 	/*
1312*8249SVikram.Hegde@Sun.COM 	 * Close any iommulib mediated linkage to an IOMMU
1313*8249SVikram.Hegde@Sun.COM 	 */
1314*8249SVikram.Hegde@Sun.COM 	iommulib_nex_close(dip);
1315*8249SVikram.Hegde@Sun.COM #endif
1316*8249SVikram.Hegde@Sun.COM #endif
1317*8249SVikram.Hegde@Sun.COM 
13180Sstevel@tonic-gate 	/* destroy the taskq */
13190Sstevel@tonic-gate 	if (DEVI(dip)->devi_taskq) {
13200Sstevel@tonic-gate 		ddi_taskq_destroy(DEVI(dip)->devi_taskq);
13210Sstevel@tonic-gate 		DEVI(dip)->devi_taskq = NULL;
13220Sstevel@tonic-gate 	}
13230Sstevel@tonic-gate 
13240Sstevel@tonic-gate 	/* Cleanup dacf reservations */
13250Sstevel@tonic-gate 	mutex_enter(&dacf_lock);
13260Sstevel@tonic-gate 	dacf_clr_rsrvs(dip, DACF_OPID_POSTATTACH);
13270Sstevel@tonic-gate 	dacf_clr_rsrvs(dip, DACF_OPID_PREDETACH);
13280Sstevel@tonic-gate 	mutex_exit(&dacf_lock);
13290Sstevel@tonic-gate 
13300Sstevel@tonic-gate 	/* Remove properties and minor nodes in case driver forgots */
13310Sstevel@tonic-gate 	ddi_remove_minor_node(dip, NULL);
13320Sstevel@tonic-gate 	ddi_prop_remove_all(dip);
13330Sstevel@tonic-gate 
13340Sstevel@tonic-gate 	/* a detached node can't have attached or .conf children */
13350Sstevel@tonic-gate 	mutex_enter(&DEVI(dip)->devi_lock);
13360Sstevel@tonic-gate 	DEVI(dip)->devi_flags &= ~(DEVI_MADE_CHILDREN|DEVI_ATTACHED_CHILDREN);
1337438Scth 
1338438Scth 	/* ensure that devids registered during attach are unregistered */
13390Sstevel@tonic-gate 	if (DEVI(dip)->devi_flags & DEVI_REGISTERED_DEVID) {
13400Sstevel@tonic-gate 		DEVI(dip)->devi_flags &= ~DEVI_REGISTERED_DEVID;
1341438Scth 		mutex_exit(&DEVI(dip)->devi_lock);
13426640Scth 		ddi_devid_unregister(dip);
1343438Scth 	} else
1344438Scth 		mutex_exit(&DEVI(dip)->devi_lock);
13450Sstevel@tonic-gate 
134653Scth 	/*
134753Scth 	 * If the instance has successfully detached in detach_driver() context,
134853Scth 	 * clear DN_DRIVER_HELD for correct ddi_hold_installed_driver()
134953Scth 	 * behavior. Consumers like qassociate() depend on this (via clnopen()).
135053Scth 	 */
135153Scth 	if (flag & NDI_DETACH_DRIVER) {
135253Scth 		dnp = &(devnamesp[DEVI(dip)->devi_major]);
135353Scth 		LOCK_DEV_OPS(&dnp->dn_lock);
135453Scth 		dnp->dn_flags &= ~DN_DRIVER_HELD;
135553Scth 		UNLOCK_DEV_OPS(&dnp->dn_lock);
135653Scth 	}
135753Scth 
13580Sstevel@tonic-gate 	/* successful detach, release the driver */
13590Sstevel@tonic-gate 	ndi_rele_driver(dip);
13600Sstevel@tonic-gate 	DEVI(dip)->devi_ops = NULL;
13610Sstevel@tonic-gate 	return (DDI_SUCCESS);
13620Sstevel@tonic-gate }
13630Sstevel@tonic-gate 
13640Sstevel@tonic-gate /*
13650Sstevel@tonic-gate  * Run dacf post_attach routines
13660Sstevel@tonic-gate  */
13670Sstevel@tonic-gate static int
13680Sstevel@tonic-gate postattach_node(dev_info_t *dip)
13690Sstevel@tonic-gate {
13700Sstevel@tonic-gate 	int rval;
13710Sstevel@tonic-gate 
13720Sstevel@tonic-gate 	/*
13730Sstevel@tonic-gate 	 * For hotplug busses like USB, it's possible that devices
13740Sstevel@tonic-gate 	 * are removed but dip is still around. We don't want to
13750Sstevel@tonic-gate 	 * run dacf routines as part of detach failure recovery.
13760Sstevel@tonic-gate 	 *
13770Sstevel@tonic-gate 	 * Pretend success until we figure out how to prevent
13780Sstevel@tonic-gate 	 * access to such devinfo nodes.
13790Sstevel@tonic-gate 	 */
13800Sstevel@tonic-gate 	if (DEVI_IS_DEVICE_REMOVED(dip))
13810Sstevel@tonic-gate 		return (DDI_SUCCESS);
13820Sstevel@tonic-gate 
13830Sstevel@tonic-gate 	/*
13840Sstevel@tonic-gate 	 * if dacf_postattach failed, report it to the framework
13850Sstevel@tonic-gate 	 * so that it can be retried later at the open time.
13860Sstevel@tonic-gate 	 */
13870Sstevel@tonic-gate 	mutex_enter(&dacf_lock);
13880Sstevel@tonic-gate 	rval = dacfc_postattach(dip);
13890Sstevel@tonic-gate 	mutex_exit(&dacf_lock);
13900Sstevel@tonic-gate 
13910Sstevel@tonic-gate 	/*
13920Sstevel@tonic-gate 	 * Plumbing during postattach may fail because of the
13930Sstevel@tonic-gate 	 * underlying device is not ready. This will fail ndi_devi_config()
13940Sstevel@tonic-gate 	 * in dv_filldir() and a warning message is issued. The message
13950Sstevel@tonic-gate 	 * from here will explain what happened
13960Sstevel@tonic-gate 	 */
13970Sstevel@tonic-gate 	if (rval != DACF_SUCCESS) {
13980Sstevel@tonic-gate 		cmn_err(CE_WARN, "Postattach failed for %s%d\n",
13990Sstevel@tonic-gate 		    ddi_driver_name(dip), ddi_get_instance(dip));
14000Sstevel@tonic-gate 		return (DDI_FAILURE);
14010Sstevel@tonic-gate 	}
14020Sstevel@tonic-gate 
14030Sstevel@tonic-gate 	return (DDI_SUCCESS);
14040Sstevel@tonic-gate }
14050Sstevel@tonic-gate 
14060Sstevel@tonic-gate /*
14070Sstevel@tonic-gate  * Run dacf pre-detach routines
14080Sstevel@tonic-gate  */
14090Sstevel@tonic-gate static int
14100Sstevel@tonic-gate predetach_node(dev_info_t *dip, uint_t flag)
14110Sstevel@tonic-gate {
14120Sstevel@tonic-gate 	int ret;
14130Sstevel@tonic-gate 
14140Sstevel@tonic-gate 	/*
14150Sstevel@tonic-gate 	 * Don't auto-detach if DDI_FORCEATTACH or DDI_NO_AUTODETACH
14160Sstevel@tonic-gate 	 * properties are set.
14170Sstevel@tonic-gate 	 */
14180Sstevel@tonic-gate 	if (flag & NDI_AUTODETACH) {
14190Sstevel@tonic-gate 		struct devnames *dnp;
14200Sstevel@tonic-gate 		int pflag = DDI_PROP_NOTPROM | DDI_PROP_DONTPASS;
14210Sstevel@tonic-gate 
14220Sstevel@tonic-gate 		if ((ddi_prop_get_int(DDI_DEV_T_ANY, dip,
14234950Scth 		    pflag, DDI_FORCEATTACH, 0) == 1) ||
14240Sstevel@tonic-gate 		    (ddi_prop_get_int(DDI_DEV_T_ANY, dip,
14254950Scth 		    pflag, DDI_NO_AUTODETACH, 0) == 1))
14260Sstevel@tonic-gate 			return (DDI_FAILURE);
14270Sstevel@tonic-gate 
14280Sstevel@tonic-gate 		/* check for driver global version of DDI_NO_AUTODETACH */
14290Sstevel@tonic-gate 		dnp = &devnamesp[DEVI(dip)->devi_major];
14300Sstevel@tonic-gate 		LOCK_DEV_OPS(&dnp->dn_lock);
14310Sstevel@tonic-gate 		if (dnp->dn_flags & DN_NO_AUTODETACH) {
14320Sstevel@tonic-gate 			UNLOCK_DEV_OPS(&dnp->dn_lock);
14330Sstevel@tonic-gate 			return (DDI_FAILURE);
14340Sstevel@tonic-gate 		}
14350Sstevel@tonic-gate 		UNLOCK_DEV_OPS(&dnp->dn_lock);
14360Sstevel@tonic-gate 	}
14370Sstevel@tonic-gate 
14380Sstevel@tonic-gate 	mutex_enter(&dacf_lock);
14390Sstevel@tonic-gate 	ret = dacfc_predetach(dip);
14400Sstevel@tonic-gate 	mutex_exit(&dacf_lock);
14410Sstevel@tonic-gate 
14420Sstevel@tonic-gate 	return (ret);
14430Sstevel@tonic-gate }
14440Sstevel@tonic-gate 
14450Sstevel@tonic-gate /*
14460Sstevel@tonic-gate  * Wrapper for making multiple state transitions
14470Sstevel@tonic-gate  */
14480Sstevel@tonic-gate 
14490Sstevel@tonic-gate /*
14500Sstevel@tonic-gate  * i_ndi_config_node: upgrade dev_info node into a specified state.
14510Sstevel@tonic-gate  * It is a bit tricky because the locking protocol changes before and
14520Sstevel@tonic-gate  * after a node is bound to a driver. All locks are held external to
14530Sstevel@tonic-gate  * this function.
14540Sstevel@tonic-gate  */
14550Sstevel@tonic-gate int
14560Sstevel@tonic-gate i_ndi_config_node(dev_info_t *dip, ddi_node_state_t state, uint_t flag)
14570Sstevel@tonic-gate {
14580Sstevel@tonic-gate 	_NOTE(ARGUNUSED(flag))
14590Sstevel@tonic-gate 	int rv = DDI_SUCCESS;
14600Sstevel@tonic-gate 
14610Sstevel@tonic-gate 	ASSERT(DEVI_BUSY_OWNED(ddi_get_parent(dip)));
14620Sstevel@tonic-gate 
14630Sstevel@tonic-gate 	while ((i_ddi_node_state(dip) < state) && (rv == DDI_SUCCESS)) {
14640Sstevel@tonic-gate 
14650Sstevel@tonic-gate 		/* don't allow any more changes to the device tree */
14660Sstevel@tonic-gate 		if (devinfo_freeze) {
14670Sstevel@tonic-gate 			rv = DDI_FAILURE;
14680Sstevel@tonic-gate 			break;
14690Sstevel@tonic-gate 		}
14700Sstevel@tonic-gate 
14710Sstevel@tonic-gate 		switch (i_ddi_node_state(dip)) {
14720Sstevel@tonic-gate 		case DS_PROTO:
14730Sstevel@tonic-gate 			/*
14740Sstevel@tonic-gate 			 * only caller can reference this node, no external
14750Sstevel@tonic-gate 			 * locking needed.
14760Sstevel@tonic-gate 			 */
14770Sstevel@tonic-gate 			link_node(dip);
14780Sstevel@tonic-gate 			i_ddi_set_node_state(dip, DS_LINKED);
14790Sstevel@tonic-gate 			break;
14800Sstevel@tonic-gate 		case DS_LINKED:
14810Sstevel@tonic-gate 			/*
14820Sstevel@tonic-gate 			 * Three code path may attempt to bind a node:
14830Sstevel@tonic-gate 			 * - boot code
14840Sstevel@tonic-gate 			 * - add_drv
14850Sstevel@tonic-gate 			 * - hotplug thread
14860Sstevel@tonic-gate 			 * Boot code is single threaded, add_drv synchronize
14870Sstevel@tonic-gate 			 * on a userland lock, and hotplug synchronize on
14880Sstevel@tonic-gate 			 * hotplug_lk. There could be a race between add_drv
14890Sstevel@tonic-gate 			 * and hotplug thread. We'll live with this until the
14900Sstevel@tonic-gate 			 * conversion to top-down loading.
14910Sstevel@tonic-gate 			 */
14920Sstevel@tonic-gate 			if ((rv = bind_node(dip)) == DDI_SUCCESS)
14930Sstevel@tonic-gate 				i_ddi_set_node_state(dip, DS_BOUND);
14944145Scth 
14950Sstevel@tonic-gate 			break;
14960Sstevel@tonic-gate 		case DS_BOUND:
14970Sstevel@tonic-gate 			/*
14980Sstevel@tonic-gate 			 * The following transitions synchronizes on the
14990Sstevel@tonic-gate 			 * per-driver busy changing flag, since we already
15000Sstevel@tonic-gate 			 * have a driver.
15010Sstevel@tonic-gate 			 */
15020Sstevel@tonic-gate 			if ((rv = init_node(dip)) == DDI_SUCCESS)
15030Sstevel@tonic-gate 				i_ddi_set_node_state(dip, DS_INITIALIZED);
15040Sstevel@tonic-gate 			break;
15050Sstevel@tonic-gate 		case DS_INITIALIZED:
15060Sstevel@tonic-gate 			if ((rv = probe_node(dip)) == DDI_SUCCESS)
15070Sstevel@tonic-gate 				i_ddi_set_node_state(dip, DS_PROBED);
15080Sstevel@tonic-gate 			break;
15090Sstevel@tonic-gate 		case DS_PROBED:
15104845Svikram 			i_ddi_check_retire(dip);
15110Sstevel@tonic-gate 			atomic_add_long(&devinfo_attach_detach, 1);
15120Sstevel@tonic-gate 			if ((rv = attach_node(dip)) == DDI_SUCCESS)
15130Sstevel@tonic-gate 				i_ddi_set_node_state(dip, DS_ATTACHED);
15140Sstevel@tonic-gate 			atomic_add_long(&devinfo_attach_detach, -1);
15150Sstevel@tonic-gate 			break;
15160Sstevel@tonic-gate 		case DS_ATTACHED:
15170Sstevel@tonic-gate 			if ((rv = postattach_node(dip)) == DDI_SUCCESS)
15180Sstevel@tonic-gate 				i_ddi_set_node_state(dip, DS_READY);
15190Sstevel@tonic-gate 			break;
15200Sstevel@tonic-gate 		case DS_READY:
15210Sstevel@tonic-gate 			break;
15220Sstevel@tonic-gate 		default:
15230Sstevel@tonic-gate 			/* should never reach here */
15240Sstevel@tonic-gate 			ASSERT("unknown devinfo state");
15250Sstevel@tonic-gate 		}
15260Sstevel@tonic-gate 	}
15270Sstevel@tonic-gate 
15280Sstevel@tonic-gate 	if (ddidebug & DDI_AUDIT)
15290Sstevel@tonic-gate 		da_log_enter(dip);
15300Sstevel@tonic-gate 	return (rv);
15310Sstevel@tonic-gate }
15320Sstevel@tonic-gate 
15330Sstevel@tonic-gate /*
15340Sstevel@tonic-gate  * i_ndi_unconfig_node: downgrade dev_info node into a specified state.
15350Sstevel@tonic-gate  */
15360Sstevel@tonic-gate int
15370Sstevel@tonic-gate i_ndi_unconfig_node(dev_info_t *dip, ddi_node_state_t state, uint_t flag)
15380Sstevel@tonic-gate {
15394950Scth 	int	rv = DDI_SUCCESS;
15400Sstevel@tonic-gate 
15410Sstevel@tonic-gate 	ASSERT(DEVI_BUSY_OWNED(ddi_get_parent(dip)));
15420Sstevel@tonic-gate 
15430Sstevel@tonic-gate 	while ((i_ddi_node_state(dip) > state) && (rv == DDI_SUCCESS)) {
15440Sstevel@tonic-gate 
15450Sstevel@tonic-gate 		/* don't allow any more changes to the device tree */
15460Sstevel@tonic-gate 		if (devinfo_freeze) {
15470Sstevel@tonic-gate 			rv = DDI_FAILURE;
15480Sstevel@tonic-gate 			break;
15490Sstevel@tonic-gate 		}
15500Sstevel@tonic-gate 
15510Sstevel@tonic-gate 		switch (i_ddi_node_state(dip)) {
15520Sstevel@tonic-gate 		case DS_PROTO:
15530Sstevel@tonic-gate 			break;
15540Sstevel@tonic-gate 		case DS_LINKED:
15550Sstevel@tonic-gate 			/*
15560Sstevel@tonic-gate 			 * Persistent nodes are only removed by hotplug code
15570Sstevel@tonic-gate 			 * .conf nodes synchronizes on per-driver list.
15580Sstevel@tonic-gate 			 */
15590Sstevel@tonic-gate 			if ((rv = unlink_node(dip)) == DDI_SUCCESS)
15600Sstevel@tonic-gate 				i_ddi_set_node_state(dip, DS_PROTO);
15610Sstevel@tonic-gate 			break;
15620Sstevel@tonic-gate 		case DS_BOUND:
15630Sstevel@tonic-gate 			/*
15640Sstevel@tonic-gate 			 * The following transitions synchronizes on the
15650Sstevel@tonic-gate 			 * per-driver busy changing flag, since we already
15660Sstevel@tonic-gate 			 * have a driver.
15670Sstevel@tonic-gate 			 */
15680Sstevel@tonic-gate 			if ((rv = unbind_node(dip)) == DDI_SUCCESS)
15690Sstevel@tonic-gate 				i_ddi_set_node_state(dip, DS_LINKED);
15700Sstevel@tonic-gate 			break;
15710Sstevel@tonic-gate 		case DS_INITIALIZED:
15720Sstevel@tonic-gate 			if ((rv = uninit_node(dip)) == DDI_SUCCESS)
15730Sstevel@tonic-gate 				i_ddi_set_node_state(dip, DS_BOUND);
15740Sstevel@tonic-gate 			break;
15750Sstevel@tonic-gate 		case DS_PROBED:
15760Sstevel@tonic-gate 			if ((rv = unprobe_node(dip)) == DDI_SUCCESS)
15770Sstevel@tonic-gate 				i_ddi_set_node_state(dip, DS_INITIALIZED);
15780Sstevel@tonic-gate 			break;
15790Sstevel@tonic-gate 		case DS_ATTACHED:
15800Sstevel@tonic-gate 			atomic_add_long(&devinfo_attach_detach, 1);
1581495Scth 
1582495Scth 			mutex_enter(&(DEVI(dip)->devi_lock));
15830Sstevel@tonic-gate 			DEVI_SET_DETACHING(dip);
1584495Scth 			mutex_exit(&(DEVI(dip)->devi_lock));
1585495Scth 
15860Sstevel@tonic-gate 			membar_enter();	/* ensure visibility for hold_devi */
15870Sstevel@tonic-gate 
15880Sstevel@tonic-gate 			if ((rv = detach_node(dip, flag)) == DDI_SUCCESS)
15890Sstevel@tonic-gate 				i_ddi_set_node_state(dip, DS_PROBED);
1590495Scth 
1591495Scth 			mutex_enter(&(DEVI(dip)->devi_lock));
15920Sstevel@tonic-gate 			DEVI_CLR_DETACHING(dip);
1593495Scth 			mutex_exit(&(DEVI(dip)->devi_lock));
1594495Scth 
15950Sstevel@tonic-gate 			atomic_add_long(&devinfo_attach_detach, -1);
15960Sstevel@tonic-gate 			break;
15970Sstevel@tonic-gate 		case DS_READY:
15980Sstevel@tonic-gate 			if ((rv = predetach_node(dip, flag)) == DDI_SUCCESS)
15990Sstevel@tonic-gate 				i_ddi_set_node_state(dip, DS_ATTACHED);
16000Sstevel@tonic-gate 			break;
16010Sstevel@tonic-gate 		default:
16020Sstevel@tonic-gate 			ASSERT("unknown devinfo state");
16030Sstevel@tonic-gate 		}
16040Sstevel@tonic-gate 	}
16050Sstevel@tonic-gate 	da_log_enter(dip);
16060Sstevel@tonic-gate 	return (rv);
16070Sstevel@tonic-gate }
16080Sstevel@tonic-gate 
16090Sstevel@tonic-gate /*
16100Sstevel@tonic-gate  * ddi_initchild: transform node to DS_INITIALIZED state
16110Sstevel@tonic-gate  */
16120Sstevel@tonic-gate int
16130Sstevel@tonic-gate ddi_initchild(dev_info_t *parent, dev_info_t *proto)
16140Sstevel@tonic-gate {
16150Sstevel@tonic-gate 	int ret, circ;
16160Sstevel@tonic-gate 
16170Sstevel@tonic-gate 	ndi_devi_enter(parent, &circ);
16180Sstevel@tonic-gate 	ret = i_ndi_config_node(proto, DS_INITIALIZED, 0);
16190Sstevel@tonic-gate 	ndi_devi_exit(parent, circ);
16200Sstevel@tonic-gate 
16210Sstevel@tonic-gate 	return (ret);
16220Sstevel@tonic-gate }
16230Sstevel@tonic-gate 
16240Sstevel@tonic-gate /*
16250Sstevel@tonic-gate  * ddi_uninitchild: transform node down to DS_BOUND state
16260Sstevel@tonic-gate  */
16270Sstevel@tonic-gate int
16280Sstevel@tonic-gate ddi_uninitchild(dev_info_t *dip)
16290Sstevel@tonic-gate {
16300Sstevel@tonic-gate 	int ret, circ;
16310Sstevel@tonic-gate 	dev_info_t *parent = ddi_get_parent(dip);
16320Sstevel@tonic-gate 	ASSERT(parent);
16330Sstevel@tonic-gate 
16340Sstevel@tonic-gate 	ndi_devi_enter(parent, &circ);
16350Sstevel@tonic-gate 	ret = i_ndi_unconfig_node(dip, DS_BOUND, 0);
16360Sstevel@tonic-gate 	ndi_devi_exit(parent, circ);
16370Sstevel@tonic-gate 
16380Sstevel@tonic-gate 	return (ret);
16390Sstevel@tonic-gate }
16400Sstevel@tonic-gate 
16410Sstevel@tonic-gate /*
16421333Scth  * i_ddi_attachchild: transform node to DS_READY/i_ddi_devi_attached() state
16430Sstevel@tonic-gate  */
16440Sstevel@tonic-gate static int
16450Sstevel@tonic-gate i_ddi_attachchild(dev_info_t *dip)
16460Sstevel@tonic-gate {
16472155Scth 	dev_info_t	*parent = ddi_get_parent(dip);
16482155Scth 	int		ret;
16492155Scth 
16502155Scth 	ASSERT(parent && DEVI_BUSY_OWNED(parent));
16510Sstevel@tonic-gate 
16520Sstevel@tonic-gate 	if ((i_ddi_node_state(dip) < DS_BOUND) || DEVI_IS_DEVICE_OFFLINE(dip))
16530Sstevel@tonic-gate 		return (DDI_FAILURE);
16540Sstevel@tonic-gate 
16550Sstevel@tonic-gate 	ret = i_ndi_config_node(dip, DS_READY, 0);
16560Sstevel@tonic-gate 	if (ret == NDI_SUCCESS) {
16570Sstevel@tonic-gate 		ret = DDI_SUCCESS;
16580Sstevel@tonic-gate 	} else {
16590Sstevel@tonic-gate 		/*
16600Sstevel@tonic-gate 		 * Take it down to DS_INITIALIZED so pm_pre_probe is run
16610Sstevel@tonic-gate 		 * on the next attach
16620Sstevel@tonic-gate 		 */
16630Sstevel@tonic-gate 		(void) i_ndi_unconfig_node(dip, DS_INITIALIZED, 0);
16640Sstevel@tonic-gate 		ret = DDI_FAILURE;
16650Sstevel@tonic-gate 	}
16660Sstevel@tonic-gate 
16670Sstevel@tonic-gate 	return (ret);
16680Sstevel@tonic-gate }
16690Sstevel@tonic-gate 
16700Sstevel@tonic-gate /*
16710Sstevel@tonic-gate  * i_ddi_detachchild: transform node down to DS_PROBED state
16720Sstevel@tonic-gate  *	If it fails, put it back to DS_READY state.
16730Sstevel@tonic-gate  * NOTE: A node that fails detach may be at DS_ATTACHED instead
16741333Scth  * of DS_READY for a small amount of time - this is the source of
16751333Scth  * transient DS_READY->DS_ATTACHED->DS_READY state changes.
16760Sstevel@tonic-gate  */
16770Sstevel@tonic-gate static int
16780Sstevel@tonic-gate i_ddi_detachchild(dev_info_t *dip, uint_t flags)
16790Sstevel@tonic-gate {
16802155Scth 	dev_info_t	*parent = ddi_get_parent(dip);
16812155Scth 	int		ret;
16822155Scth 
16832155Scth 	ASSERT(parent && DEVI_BUSY_OWNED(parent));
16842155Scth 
16850Sstevel@tonic-gate 	ret = i_ndi_unconfig_node(dip, DS_PROBED, flags);
16860Sstevel@tonic-gate 	if (ret != DDI_SUCCESS)
16870Sstevel@tonic-gate 		(void) i_ndi_config_node(dip, DS_READY, 0);
16880Sstevel@tonic-gate 	else
16890Sstevel@tonic-gate 		/* allow pm_pre_probe to reestablish pm state */
16900Sstevel@tonic-gate 		(void) i_ndi_unconfig_node(dip, DS_INITIALIZED, 0);
16910Sstevel@tonic-gate 	return (ret);
16920Sstevel@tonic-gate }
16930Sstevel@tonic-gate 
16940Sstevel@tonic-gate /*
16950Sstevel@tonic-gate  * Add a child and bind to driver
16960Sstevel@tonic-gate  */
16970Sstevel@tonic-gate dev_info_t *
16980Sstevel@tonic-gate ddi_add_child(dev_info_t *pdip, char *name, uint_t nodeid, uint_t unit)
16990Sstevel@tonic-gate {
17000Sstevel@tonic-gate 	int circ;
17010Sstevel@tonic-gate 	dev_info_t *dip;
17020Sstevel@tonic-gate 
17030Sstevel@tonic-gate 	/* allocate a new node */
17040Sstevel@tonic-gate 	dip = i_ddi_alloc_node(pdip, name, nodeid, (int)unit, NULL, KM_SLEEP);
17050Sstevel@tonic-gate 
17060Sstevel@tonic-gate 	ndi_devi_enter(pdip, &circ);
17070Sstevel@tonic-gate 	(void) i_ndi_config_node(dip, DS_BOUND, 0);
17080Sstevel@tonic-gate 	ndi_devi_exit(pdip, circ);
17090Sstevel@tonic-gate 	return (dip);
17100Sstevel@tonic-gate }
17110Sstevel@tonic-gate 
17120Sstevel@tonic-gate /*
17130Sstevel@tonic-gate  * ddi_remove_child: remove the dip. The parent must be attached and held
17140Sstevel@tonic-gate  */
17150Sstevel@tonic-gate int
17160Sstevel@tonic-gate ddi_remove_child(dev_info_t *dip, int dummy)
17170Sstevel@tonic-gate {
17180Sstevel@tonic-gate 	_NOTE(ARGUNUSED(dummy))
17190Sstevel@tonic-gate 	int circ, ret;
17200Sstevel@tonic-gate 	dev_info_t *parent = ddi_get_parent(dip);
17210Sstevel@tonic-gate 	ASSERT(parent);
17220Sstevel@tonic-gate 
17230Sstevel@tonic-gate 	ndi_devi_enter(parent, &circ);
17240Sstevel@tonic-gate 
17250Sstevel@tonic-gate 	/*
17260Sstevel@tonic-gate 	 * If we still have children, for example SID nodes marked
17270Sstevel@tonic-gate 	 * as persistent but not attached, attempt to remove them.
17280Sstevel@tonic-gate 	 */
17290Sstevel@tonic-gate 	if (DEVI(dip)->devi_child) {
17300Sstevel@tonic-gate 		ret = ndi_devi_unconfig(dip, NDI_DEVI_REMOVE);
17310Sstevel@tonic-gate 		if (ret != NDI_SUCCESS) {
17320Sstevel@tonic-gate 			ndi_devi_exit(parent, circ);
17330Sstevel@tonic-gate 			return (DDI_FAILURE);
17340Sstevel@tonic-gate 		}
17350Sstevel@tonic-gate 		ASSERT(DEVI(dip)->devi_child == NULL);
17360Sstevel@tonic-gate 	}
17370Sstevel@tonic-gate 
17380Sstevel@tonic-gate 	ret = i_ndi_unconfig_node(dip, DS_PROTO, 0);
17390Sstevel@tonic-gate 	ndi_devi_exit(parent, circ);
17400Sstevel@tonic-gate 
17410Sstevel@tonic-gate 	if (ret != DDI_SUCCESS)
17420Sstevel@tonic-gate 		return (ret);
17430Sstevel@tonic-gate 
17440Sstevel@tonic-gate 	ASSERT(i_ddi_node_state(dip) == DS_PROTO);
17450Sstevel@tonic-gate 	i_ddi_free_node(dip);
17460Sstevel@tonic-gate 	return (DDI_SUCCESS);
17470Sstevel@tonic-gate }
17480Sstevel@tonic-gate 
17490Sstevel@tonic-gate /*
17500Sstevel@tonic-gate  * NDI wrappers for ref counting, node allocation, and transitions
17510Sstevel@tonic-gate  */
17520Sstevel@tonic-gate 
17530Sstevel@tonic-gate /*
17540Sstevel@tonic-gate  * Hold/release the devinfo node itself.
17550Sstevel@tonic-gate  * Caller is assumed to prevent the devi from detaching during this call
17560Sstevel@tonic-gate  */
17570Sstevel@tonic-gate void
17580Sstevel@tonic-gate ndi_hold_devi(dev_info_t *dip)
17590Sstevel@tonic-gate {
17600Sstevel@tonic-gate 	mutex_enter(&DEVI(dip)->devi_lock);
17610Sstevel@tonic-gate 	ASSERT(DEVI(dip)->devi_ref >= 0);
17620Sstevel@tonic-gate 	DEVI(dip)->devi_ref++;
17630Sstevel@tonic-gate 	membar_enter();			/* make sure stores are flushed */
17640Sstevel@tonic-gate 	mutex_exit(&DEVI(dip)->devi_lock);
17650Sstevel@tonic-gate }
17660Sstevel@tonic-gate 
17670Sstevel@tonic-gate void
17680Sstevel@tonic-gate ndi_rele_devi(dev_info_t *dip)
17690Sstevel@tonic-gate {
17700Sstevel@tonic-gate 	ASSERT(DEVI(dip)->devi_ref > 0);
17710Sstevel@tonic-gate 
17720Sstevel@tonic-gate 	mutex_enter(&DEVI(dip)->devi_lock);
17730Sstevel@tonic-gate 	DEVI(dip)->devi_ref--;
17740Sstevel@tonic-gate 	membar_enter();			/* make sure stores are flushed */
17750Sstevel@tonic-gate 	mutex_exit(&DEVI(dip)->devi_lock);
17760Sstevel@tonic-gate }
17770Sstevel@tonic-gate 
17780Sstevel@tonic-gate int
17790Sstevel@tonic-gate e_ddi_devi_holdcnt(dev_info_t *dip)
17800Sstevel@tonic-gate {
17810Sstevel@tonic-gate 	return (DEVI(dip)->devi_ref);
17820Sstevel@tonic-gate }
17830Sstevel@tonic-gate 
17840Sstevel@tonic-gate /*
17850Sstevel@tonic-gate  * Hold/release the driver the devinfo node is bound to.
17860Sstevel@tonic-gate  */
17870Sstevel@tonic-gate struct dev_ops *
17880Sstevel@tonic-gate ndi_hold_driver(dev_info_t *dip)
17890Sstevel@tonic-gate {
17900Sstevel@tonic-gate 	if (i_ddi_node_state(dip) < DS_BOUND)
17910Sstevel@tonic-gate 		return (NULL);
17920Sstevel@tonic-gate 
17930Sstevel@tonic-gate 	ASSERT(DEVI(dip)->devi_major != -1);
17940Sstevel@tonic-gate 	return (mod_hold_dev_by_major(DEVI(dip)->devi_major));
17950Sstevel@tonic-gate }
17960Sstevel@tonic-gate 
17970Sstevel@tonic-gate void
17980Sstevel@tonic-gate ndi_rele_driver(dev_info_t *dip)
17990Sstevel@tonic-gate {
18000Sstevel@tonic-gate 	ASSERT(i_ddi_node_state(dip) >= DS_BOUND);
18010Sstevel@tonic-gate 	mod_rele_dev_by_major(DEVI(dip)->devi_major);
18020Sstevel@tonic-gate }
18030Sstevel@tonic-gate 
18040Sstevel@tonic-gate /*
18057224Scth  * Single thread entry into devinfo node for modifying its children (devinfo,
18067224Scth  * pathinfo, and minor). To verify in ASSERTS use DEVI_BUSY_OWNED macro.
18070Sstevel@tonic-gate  */
18080Sstevel@tonic-gate void
18090Sstevel@tonic-gate ndi_devi_enter(dev_info_t *dip, int *circular)
18100Sstevel@tonic-gate {
18110Sstevel@tonic-gate 	struct dev_info *devi = DEVI(dip);
18120Sstevel@tonic-gate 	ASSERT(dip != NULL);
18130Sstevel@tonic-gate 
18142155Scth 	/* for vHCI, enforce (vHCI, pHCI) ndi_deve_enter() order */
18152155Scth 	ASSERT(!MDI_VHCI(dip) || (mdi_devi_pdip_entered(dip) == 0) ||
18162155Scth 	    DEVI_BUSY_OWNED(dip));
18172155Scth 
18180Sstevel@tonic-gate 	mutex_enter(&devi->devi_lock);
18190Sstevel@tonic-gate 	if (devi->devi_busy_thread == curthread) {
18200Sstevel@tonic-gate 		devi->devi_circular++;
18210Sstevel@tonic-gate 	} else {
18220Sstevel@tonic-gate 		while (DEVI_BUSY_CHANGING(devi) && !panicstr)
18230Sstevel@tonic-gate 			cv_wait(&(devi->devi_cv), &(devi->devi_lock));
18240Sstevel@tonic-gate 		if (panicstr) {
18250Sstevel@tonic-gate 			mutex_exit(&devi->devi_lock);
18260Sstevel@tonic-gate 			return;
18270Sstevel@tonic-gate 		}
18280Sstevel@tonic-gate 		devi->devi_flags |= DEVI_BUSY;
18290Sstevel@tonic-gate 		devi->devi_busy_thread = curthread;
18300Sstevel@tonic-gate 	}
18310Sstevel@tonic-gate 	*circular = devi->devi_circular;
18320Sstevel@tonic-gate 	mutex_exit(&devi->devi_lock);
18330Sstevel@tonic-gate }
18340Sstevel@tonic-gate 
18350Sstevel@tonic-gate /*
18360Sstevel@tonic-gate  * Release ndi_devi_enter or successful ndi_devi_tryenter.
18370Sstevel@tonic-gate  */
18380Sstevel@tonic-gate void
18390Sstevel@tonic-gate ndi_devi_exit(dev_info_t *dip, int circular)
18400Sstevel@tonic-gate {
18412155Scth 	struct dev_info	*devi = DEVI(dip);
18422155Scth 	struct dev_info	*vdevi;
18430Sstevel@tonic-gate 	ASSERT(dip != NULL);
18440Sstevel@tonic-gate 
18450Sstevel@tonic-gate 	if (panicstr)
18460Sstevel@tonic-gate 		return;
18470Sstevel@tonic-gate 
18480Sstevel@tonic-gate 	mutex_enter(&(devi->devi_lock));
18490Sstevel@tonic-gate 	if (circular != 0) {
18500Sstevel@tonic-gate 		devi->devi_circular--;
18510Sstevel@tonic-gate 	} else {
18520Sstevel@tonic-gate 		devi->devi_flags &= ~DEVI_BUSY;
18530Sstevel@tonic-gate 		ASSERT(devi->devi_busy_thread == curthread);
18540Sstevel@tonic-gate 		devi->devi_busy_thread = NULL;
18550Sstevel@tonic-gate 		cv_broadcast(&(devi->devi_cv));
18560Sstevel@tonic-gate 	}
18570Sstevel@tonic-gate 	mutex_exit(&(devi->devi_lock));
18582155Scth 
18592155Scth 	/*
18602155Scth 	 * For pHCI exit we issue a broadcast to vHCI for ndi_devi_config_one()
18612155Scth 	 * doing cv_wait on vHCI.
18622155Scth 	 */
18632155Scth 	if (MDI_PHCI(dip)) {
18642155Scth 		vdevi = DEVI(mdi_devi_get_vdip(dip));
18652155Scth 		if (vdevi) {
18662155Scth 			mutex_enter(&(vdevi->devi_lock));
18672155Scth 			if (vdevi->devi_flags & DEVI_PHCI_SIGNALS_VHCI) {
18682155Scth 				vdevi->devi_flags &= ~DEVI_PHCI_SIGNALS_VHCI;
18692155Scth 				cv_broadcast(&(vdevi->devi_cv));
18702155Scth 			}
18712155Scth 			mutex_exit(&(vdevi->devi_lock));
18722155Scth 		}
18732155Scth 	}
18742155Scth }
18752155Scth 
18762155Scth /*
18772155Scth  * Release ndi_devi_enter and wait for possibility of new children, avoiding
18782155Scth  * possibility of missing broadcast before getting to cv_timedwait().
18792155Scth  */
18802155Scth static void
18812155Scth ndi_devi_exit_and_wait(dev_info_t *dip, int circular, clock_t end_time)
18822155Scth {
18832155Scth 	struct dev_info	*devi = DEVI(dip);
18842155Scth 	ASSERT(dip != NULL);
18852155Scth 
18862155Scth 	if (panicstr)
18872155Scth 		return;
18882155Scth 
18892155Scth 	/*
18902155Scth 	 * We are called to wait for of a new child, and new child can
18912155Scth 	 * only be added if circular is zero.
18922155Scth 	 */
18932155Scth 	ASSERT(circular == 0);
18942155Scth 
18952155Scth 	/* like ndi_devi_exit with circular of zero */
18962155Scth 	mutex_enter(&(devi->devi_lock));
18972155Scth 	devi->devi_flags &= ~DEVI_BUSY;
18982155Scth 	ASSERT(devi->devi_busy_thread == curthread);
18992155Scth 	devi->devi_busy_thread = NULL;
19002155Scth 	cv_broadcast(&(devi->devi_cv));
19012155Scth 
19022155Scth 	/* now wait for new children while still holding devi_lock */
19032155Scth 	(void) cv_timedwait(&devi->devi_cv, &(devi->devi_lock), end_time);
19042155Scth 	mutex_exit(&(devi->devi_lock));
19050Sstevel@tonic-gate }
19060Sstevel@tonic-gate 
19070Sstevel@tonic-gate /*
19080Sstevel@tonic-gate  * Attempt to single thread entry into devinfo node for modifying its children.
19090Sstevel@tonic-gate  */
19100Sstevel@tonic-gate int
19110Sstevel@tonic-gate ndi_devi_tryenter(dev_info_t *dip, int *circular)
19120Sstevel@tonic-gate {
19130Sstevel@tonic-gate 	int rval = 1;		   /* assume we enter */
19140Sstevel@tonic-gate 	struct dev_info *devi = DEVI(dip);
19150Sstevel@tonic-gate 	ASSERT(dip != NULL);
19160Sstevel@tonic-gate 
19170Sstevel@tonic-gate 	mutex_enter(&devi->devi_lock);
19180Sstevel@tonic-gate 	if (devi->devi_busy_thread == (void *)curthread) {
19190Sstevel@tonic-gate 		devi->devi_circular++;
19200Sstevel@tonic-gate 	} else {
19210Sstevel@tonic-gate 		if (!DEVI_BUSY_CHANGING(devi)) {
19220Sstevel@tonic-gate 			devi->devi_flags |= DEVI_BUSY;
19230Sstevel@tonic-gate 			devi->devi_busy_thread = (void *)curthread;
19240Sstevel@tonic-gate 		} else {
19250Sstevel@tonic-gate 			rval = 0;	/* devi is busy */
19260Sstevel@tonic-gate 		}
19270Sstevel@tonic-gate 	}
19280Sstevel@tonic-gate 	*circular = devi->devi_circular;
19290Sstevel@tonic-gate 	mutex_exit(&devi->devi_lock);
19300Sstevel@tonic-gate 	return (rval);
19310Sstevel@tonic-gate }
19320Sstevel@tonic-gate 
19330Sstevel@tonic-gate /*
19340Sstevel@tonic-gate  * Allocate and initialize a new dev_info structure.
19350Sstevel@tonic-gate  *
19360Sstevel@tonic-gate  * This routine may be called at interrupt time by a nexus in
19370Sstevel@tonic-gate  * response to a hotplug event, therefore memory allocations are
19380Sstevel@tonic-gate  * not allowed to sleep.
19390Sstevel@tonic-gate  */
19400Sstevel@tonic-gate int
1941789Sahrens ndi_devi_alloc(dev_info_t *parent, char *node_name, pnode_t nodeid,
19420Sstevel@tonic-gate     dev_info_t **ret_dip)
19430Sstevel@tonic-gate {
19440Sstevel@tonic-gate 	ASSERT(node_name != NULL);
19450Sstevel@tonic-gate 	ASSERT(ret_dip != NULL);
19460Sstevel@tonic-gate 
19470Sstevel@tonic-gate 	*ret_dip = i_ddi_alloc_node(parent, node_name, nodeid, -1, NULL,
19480Sstevel@tonic-gate 	    KM_NOSLEEP);
19490Sstevel@tonic-gate 	if (*ret_dip == NULL) {
19500Sstevel@tonic-gate 		return (NDI_NOMEM);
19510Sstevel@tonic-gate 	}
19520Sstevel@tonic-gate 
19530Sstevel@tonic-gate 	return (NDI_SUCCESS);
19540Sstevel@tonic-gate }
19550Sstevel@tonic-gate 
19560Sstevel@tonic-gate /*
19570Sstevel@tonic-gate  * Allocate and initialize a new dev_info structure
19580Sstevel@tonic-gate  * This routine may sleep and should not be called at interrupt time
19590Sstevel@tonic-gate  */
19600Sstevel@tonic-gate void
1961789Sahrens ndi_devi_alloc_sleep(dev_info_t *parent, char *node_name, pnode_t nodeid,
19620Sstevel@tonic-gate     dev_info_t **ret_dip)
19630Sstevel@tonic-gate {
19640Sstevel@tonic-gate 	ASSERT(node_name != NULL);
19650Sstevel@tonic-gate 	ASSERT(ret_dip != NULL);
19660Sstevel@tonic-gate 
19670Sstevel@tonic-gate 	*ret_dip = i_ddi_alloc_node(parent, node_name, nodeid, -1, NULL,
19680Sstevel@tonic-gate 	    KM_SLEEP);
19690Sstevel@tonic-gate 	ASSERT(*ret_dip);
19700Sstevel@tonic-gate }
19710Sstevel@tonic-gate 
19720Sstevel@tonic-gate /*
19730Sstevel@tonic-gate  * Remove an initialized (but not yet attached) dev_info
19740Sstevel@tonic-gate  * node from it's parent.
19750Sstevel@tonic-gate  */
19760Sstevel@tonic-gate int
19770Sstevel@tonic-gate ndi_devi_free(dev_info_t *dip)
19780Sstevel@tonic-gate {
19790Sstevel@tonic-gate 	ASSERT(dip != NULL);
19800Sstevel@tonic-gate 
19810Sstevel@tonic-gate 	if (i_ddi_node_state(dip) >= DS_INITIALIZED)
19820Sstevel@tonic-gate 		return (DDI_FAILURE);
19830Sstevel@tonic-gate 
19840Sstevel@tonic-gate 	NDI_CONFIG_DEBUG((CE_CONT, "ndi_devi_free: %s%d (%p)\n",
19850Sstevel@tonic-gate 	    ddi_driver_name(dip), ddi_get_instance(dip), (void *)dip));
19860Sstevel@tonic-gate 
19870Sstevel@tonic-gate 	(void) ddi_remove_child(dip, 0);
19880Sstevel@tonic-gate 
19890Sstevel@tonic-gate 	return (NDI_SUCCESS);
19900Sstevel@tonic-gate }
19910Sstevel@tonic-gate 
19920Sstevel@tonic-gate /*
19930Sstevel@tonic-gate  * ndi_devi_bind_driver() binds a driver to a given device. If it fails
19940Sstevel@tonic-gate  * to bind the driver, it returns an appropriate error back. Some drivers
19950Sstevel@tonic-gate  * may want to know if the actually failed to bind.
19960Sstevel@tonic-gate  */
19970Sstevel@tonic-gate int
19980Sstevel@tonic-gate ndi_devi_bind_driver(dev_info_t *dip, uint_t flags)
19990Sstevel@tonic-gate {
20000Sstevel@tonic-gate 	int ret = NDI_FAILURE;
20010Sstevel@tonic-gate 	int circ;
20020Sstevel@tonic-gate 	dev_info_t *pdip = ddi_get_parent(dip);
20030Sstevel@tonic-gate 	ASSERT(pdip);
20040Sstevel@tonic-gate 
20050Sstevel@tonic-gate 	NDI_CONFIG_DEBUG((CE_CONT,
20060Sstevel@tonic-gate 	    "ndi_devi_bind_driver: %s%d (%p) flags: %x\n",
20070Sstevel@tonic-gate 	    ddi_driver_name(dip), ddi_get_instance(dip), (void *)dip, flags));
20080Sstevel@tonic-gate 
20090Sstevel@tonic-gate 	ndi_devi_enter(pdip, &circ);
20100Sstevel@tonic-gate 	if (i_ndi_config_node(dip, DS_BOUND, flags) == DDI_SUCCESS)
20110Sstevel@tonic-gate 		ret = NDI_SUCCESS;
20120Sstevel@tonic-gate 	ndi_devi_exit(pdip, circ);
20130Sstevel@tonic-gate 
20140Sstevel@tonic-gate 	return (ret);
20150Sstevel@tonic-gate }
20160Sstevel@tonic-gate 
20170Sstevel@tonic-gate /*
20180Sstevel@tonic-gate  * ndi_devi_unbind_driver: unbind the dip
20190Sstevel@tonic-gate  */
20200Sstevel@tonic-gate static int
20210Sstevel@tonic-gate ndi_devi_unbind_driver(dev_info_t *dip)
20220Sstevel@tonic-gate {
20230Sstevel@tonic-gate 	ASSERT(DEVI_BUSY_OWNED(ddi_get_parent(dip)));
20240Sstevel@tonic-gate 
20250Sstevel@tonic-gate 	return (i_ndi_unconfig_node(dip, DS_LINKED, 0));
20260Sstevel@tonic-gate }
20270Sstevel@tonic-gate 
20280Sstevel@tonic-gate /*
20290Sstevel@tonic-gate  * Misc. help routines called by framework only
20300Sstevel@tonic-gate  */
20310Sstevel@tonic-gate 
20320Sstevel@tonic-gate /*
20330Sstevel@tonic-gate  * Get the state of node
20340Sstevel@tonic-gate  */
20350Sstevel@tonic-gate ddi_node_state_t
20360Sstevel@tonic-gate i_ddi_node_state(dev_info_t *dip)
20370Sstevel@tonic-gate {
20380Sstevel@tonic-gate 	return (DEVI(dip)->devi_node_state);
20390Sstevel@tonic-gate }
20400Sstevel@tonic-gate 
20410Sstevel@tonic-gate /*
20420Sstevel@tonic-gate  * Set the state of node
20430Sstevel@tonic-gate  */
20440Sstevel@tonic-gate void
20450Sstevel@tonic-gate i_ddi_set_node_state(dev_info_t *dip, ddi_node_state_t state)
20460Sstevel@tonic-gate {
20470Sstevel@tonic-gate 	DEVI(dip)->devi_node_state = state;
20480Sstevel@tonic-gate 	membar_enter();			/* make sure stores are flushed */
20490Sstevel@tonic-gate }
20500Sstevel@tonic-gate 
20510Sstevel@tonic-gate /*
20521333Scth  * Determine if node is attached. The implementation accommodates transient
20531333Scth  * DS_READY->DS_ATTACHED->DS_READY state changes.  Outside this file, this
20541333Scth  * function should be instead of i_ddi_node_state() DS_ATTACHED/DS_READY
20551333Scth  * state checks.
20561333Scth  */
20571333Scth int
20581333Scth i_ddi_devi_attached(dev_info_t *dip)
20591333Scth {
20601333Scth 	return (DEVI(dip)->devi_node_state >= DS_ATTACHED);
20611333Scth }
20621333Scth 
20631333Scth /*
20640Sstevel@tonic-gate  * Common function for finding a node in a sibling list given name and addr.
20650Sstevel@tonic-gate  *
20660Sstevel@tonic-gate  * By default, name is matched with devi_node_name. The following
20670Sstevel@tonic-gate  * alternative match strategies are supported:
20680Sstevel@tonic-gate  *
20694145Scth  *	FIND_NODE_BY_NODENAME: Match on node name - typical use.
20704145Scth  *	FIND_NODE_BY_DRIVER: A match on driver name bound to node is conducted.
20710Sstevel@tonic-gate  *		This support is used for support of OBP generic names and
20724145Scth  *		for the conversion from driver names to generic names. When
20730Sstevel@tonic-gate  *		more consistency in the generic name environment is achieved
20740Sstevel@tonic-gate  *		(and not needed for upgrade) this support can be removed.
20754145Scth  *	FIND_NODE_BY_ADDR: Match on just the addr.
20764145Scth  *		This support is only used/needed during boot to match
20774145Scth  *		a node bound via a path-based driver alias.
20780Sstevel@tonic-gate  *
20790Sstevel@tonic-gate  * If a child is not named (dev_addr == NULL), there are three
20800Sstevel@tonic-gate  * possible actions:
20810Sstevel@tonic-gate  *
20820Sstevel@tonic-gate  *	(1) skip it
20830Sstevel@tonic-gate  *	(2) FIND_ADDR_BY_INIT: bring child to DS_INITIALIZED state
20840Sstevel@tonic-gate  *	(3) FIND_ADDR_BY_CALLBACK: use a caller-supplied callback function
20850Sstevel@tonic-gate  */
20864145Scth #define	FIND_NODE_BY_NODENAME	0x01
20874145Scth #define	FIND_NODE_BY_DRIVER	0x02
20884145Scth #define	FIND_NODE_BY_ADDR	0x04
20890Sstevel@tonic-gate #define	FIND_ADDR_BY_INIT	0x10
20900Sstevel@tonic-gate #define	FIND_ADDR_BY_CALLBACK	0x20
20910Sstevel@tonic-gate 
20920Sstevel@tonic-gate static dev_info_t *
20930Sstevel@tonic-gate find_sibling(dev_info_t *head, char *cname, char *caddr, uint_t flag,
20940Sstevel@tonic-gate     int (*callback)(dev_info_t *, char *, int))
20950Sstevel@tonic-gate {
20960Sstevel@tonic-gate 	dev_info_t	*dip;
20970Sstevel@tonic-gate 	char		*addr, *buf;
20980Sstevel@tonic-gate 	major_t		major;
20994145Scth 	uint_t		by;
21004145Scth 
21014145Scth 	/* only one way to find a node */
21024145Scth 	by = flag &
21034145Scth 	    (FIND_NODE_BY_DRIVER | FIND_NODE_BY_NODENAME | FIND_NODE_BY_ADDR);
21044145Scth 	ASSERT(by && BIT_ONLYONESET(by));
21050Sstevel@tonic-gate 
21060Sstevel@tonic-gate 	/* only one way to name a node */
21070Sstevel@tonic-gate 	ASSERT(((flag & FIND_ADDR_BY_INIT) == 0) ||
21080Sstevel@tonic-gate 	    ((flag & FIND_ADDR_BY_CALLBACK) == 0));
21090Sstevel@tonic-gate 
21104145Scth 	if (by == FIND_NODE_BY_DRIVER) {
21110Sstevel@tonic-gate 		major = ddi_name_to_major(cname);
21127009Scth 		if (major == DDI_MAJOR_T_NONE)
21130Sstevel@tonic-gate 			return (NULL);
21140Sstevel@tonic-gate 	}
21150Sstevel@tonic-gate 
21160Sstevel@tonic-gate 	/* preallocate buffer of naming node by callback */
21170Sstevel@tonic-gate 	if (flag & FIND_ADDR_BY_CALLBACK)
21180Sstevel@tonic-gate 		buf = kmem_alloc(MAXNAMELEN, KM_SLEEP);
21190Sstevel@tonic-gate 
21200Sstevel@tonic-gate 	/*
21210Sstevel@tonic-gate 	 * Walk the child list to find a match
21220Sstevel@tonic-gate 	 */
21230Sstevel@tonic-gate 
21240Sstevel@tonic-gate 	for (dip = head; dip; dip = ddi_get_next_sibling(dip)) {
21254145Scth 		if (by == FIND_NODE_BY_NODENAME) {
21264145Scth 			/* match node name */
21274145Scth 			if (strcmp(cname, DEVI(dip)->devi_node_name) != 0)
21284145Scth 				continue;
21294145Scth 		} else if (by == FIND_NODE_BY_DRIVER) {
21300Sstevel@tonic-gate 			/* match driver major */
21310Sstevel@tonic-gate 			if (DEVI(dip)->devi_major != major)
21320Sstevel@tonic-gate 				continue;
21330Sstevel@tonic-gate 		}
21340Sstevel@tonic-gate 
21350Sstevel@tonic-gate 		if ((addr = DEVI(dip)->devi_addr) == NULL) {
21360Sstevel@tonic-gate 			/* name the child based on the flag */
21370Sstevel@tonic-gate 			if (flag & FIND_ADDR_BY_INIT) {
21380Sstevel@tonic-gate 				if (ddi_initchild(ddi_get_parent(dip), dip)
21390Sstevel@tonic-gate 				    != DDI_SUCCESS)
21400Sstevel@tonic-gate 					continue;
21410Sstevel@tonic-gate 				addr = DEVI(dip)->devi_addr;
21420Sstevel@tonic-gate 			} else if (flag & FIND_ADDR_BY_CALLBACK) {
21430Sstevel@tonic-gate 				if ((callback == NULL) || (callback(
21440Sstevel@tonic-gate 				    dip, buf, MAXNAMELEN) != DDI_SUCCESS))
21450Sstevel@tonic-gate 					continue;
21460Sstevel@tonic-gate 				addr = buf;
21470Sstevel@tonic-gate 			} else {
21480Sstevel@tonic-gate 				continue;	/* skip */
21490Sstevel@tonic-gate 			}
21500Sstevel@tonic-gate 		}
21510Sstevel@tonic-gate 
21520Sstevel@tonic-gate 		/* match addr */
21530Sstevel@tonic-gate 		ASSERT(addr != NULL);
21540Sstevel@tonic-gate 		if (strcmp(caddr, addr) == 0)
21550Sstevel@tonic-gate 			break;	/* node found */
21560Sstevel@tonic-gate 
21570Sstevel@tonic-gate 	}
21580Sstevel@tonic-gate 	if (flag & FIND_ADDR_BY_CALLBACK)
21590Sstevel@tonic-gate 		kmem_free(buf, MAXNAMELEN);
21600Sstevel@tonic-gate 	return (dip);
21610Sstevel@tonic-gate }
21620Sstevel@tonic-gate 
21630Sstevel@tonic-gate /*
21640Sstevel@tonic-gate  * Find child of pdip with name: cname@caddr
21650Sstevel@tonic-gate  * Called by init_node() to look for duplicate nodes
21660Sstevel@tonic-gate  */
21670Sstevel@tonic-gate static dev_info_t *
21680Sstevel@tonic-gate find_duplicate_child(dev_info_t *pdip, dev_info_t *dip)
21690Sstevel@tonic-gate {
21700Sstevel@tonic-gate 	dev_info_t *dup;
21710Sstevel@tonic-gate 	char *cname = DEVI(dip)->devi_node_name;
21720Sstevel@tonic-gate 	char *caddr = DEVI(dip)->devi_addr;
21730Sstevel@tonic-gate 
21740Sstevel@tonic-gate 	/* search nodes before dip */
21754145Scth 	dup = find_sibling(ddi_get_child(pdip), cname, caddr,
21764145Scth 	    FIND_NODE_BY_NODENAME, NULL);
21770Sstevel@tonic-gate 	if (dup != dip)
21780Sstevel@tonic-gate 		return (dup);
21790Sstevel@tonic-gate 
21800Sstevel@tonic-gate 	/*
21810Sstevel@tonic-gate 	 * search nodes after dip; normally this is not needed,
21820Sstevel@tonic-gate 	 */
21830Sstevel@tonic-gate 	return (find_sibling(ddi_get_next_sibling(dip), cname, caddr,
21844145Scth 	    FIND_NODE_BY_NODENAME, NULL));
21850Sstevel@tonic-gate }
21860Sstevel@tonic-gate 
21870Sstevel@tonic-gate /*
21880Sstevel@tonic-gate  * Find a child of a given name and address, using a callback to name
21890Sstevel@tonic-gate  * unnamed children. cname is the binding name.
21900Sstevel@tonic-gate  */
21910Sstevel@tonic-gate static dev_info_t *
21920Sstevel@tonic-gate find_child_by_callback(dev_info_t *pdip, char *cname, char *caddr,
21930Sstevel@tonic-gate     int (*name_node)(dev_info_t *, char *, int))
21940Sstevel@tonic-gate {
21950Sstevel@tonic-gate 	return (find_sibling(ddi_get_child(pdip), cname, caddr,
21964145Scth 	    FIND_NODE_BY_DRIVER|FIND_ADDR_BY_CALLBACK, name_node));
21970Sstevel@tonic-gate }
21980Sstevel@tonic-gate 
21990Sstevel@tonic-gate /*
22000Sstevel@tonic-gate  * Find a child of a given name and address, invoking initchild to name
22010Sstevel@tonic-gate  * unnamed children. cname is the node name.
22020Sstevel@tonic-gate  */
22030Sstevel@tonic-gate static dev_info_t *
22040Sstevel@tonic-gate find_child_by_name(dev_info_t *pdip, char *cname, char *caddr)
22050Sstevel@tonic-gate {
22060Sstevel@tonic-gate 	dev_info_t	*dip;
22070Sstevel@tonic-gate 
22084145Scth 	/* attempt search without changing state of preceding siblings */
22094145Scth 	dip = find_sibling(ddi_get_child(pdip), cname, caddr,
22104145Scth 	    FIND_NODE_BY_NODENAME, NULL);
22110Sstevel@tonic-gate 	if (dip)
22120Sstevel@tonic-gate 		return (dip);
22130Sstevel@tonic-gate 
22140Sstevel@tonic-gate 	return (find_sibling(ddi_get_child(pdip), cname, caddr,
22154145Scth 	    FIND_NODE_BY_NODENAME|FIND_ADDR_BY_INIT, NULL));
22160Sstevel@tonic-gate }
22170Sstevel@tonic-gate 
22180Sstevel@tonic-gate /*
22190Sstevel@tonic-gate  * Find a child of a given name and address, invoking initchild to name
22200Sstevel@tonic-gate  * unnamed children. cname is the node name.
22210Sstevel@tonic-gate  */
22220Sstevel@tonic-gate static dev_info_t *
22230Sstevel@tonic-gate find_child_by_driver(dev_info_t *pdip, char *cname, char *caddr)
22240Sstevel@tonic-gate {
22250Sstevel@tonic-gate 	dev_info_t	*dip;
22260Sstevel@tonic-gate 
22274145Scth 	/* attempt search without changing state of preceding siblings */
22280Sstevel@tonic-gate 	dip = find_sibling(ddi_get_child(pdip), cname, caddr,
22294145Scth 	    FIND_NODE_BY_DRIVER, NULL);
22300Sstevel@tonic-gate 	if (dip)
22310Sstevel@tonic-gate 		return (dip);
22320Sstevel@tonic-gate 
22330Sstevel@tonic-gate 	return (find_sibling(ddi_get_child(pdip), cname, caddr,
22344145Scth 	    FIND_NODE_BY_DRIVER|FIND_ADDR_BY_INIT, NULL));
22354145Scth }
22364145Scth 
22374145Scth /*
22384145Scth  * Find a child of a given address, invoking initchild to name
22394145Scth  * unnamed children. cname is the node name.
22404145Scth  *
22414145Scth  * NOTE: This function is only used during boot. One would hope that
22424145Scth  * unique sibling unit-addresses on hardware branches of the tree would
22434145Scth  * be a requirement to avoid two drivers trying to control the same
22444145Scth  * piece of hardware. Unfortunately there are some cases where this
22454145Scth  * situation exists (/ssm@0,0/pci@1c,700000 /ssm@0,0/sghsc@1c,700000).
22464145Scth  * Until unit-address uniqueness of siblings is guaranteed, use of this
22474145Scth  * interface for purposes other than boot should be avoided.
22484145Scth  */
22494145Scth static dev_info_t *
22504145Scth find_child_by_addr(dev_info_t *pdip, char *caddr)
22514145Scth {
22524145Scth 	dev_info_t	*dip;
22534145Scth 
22544540Scth 	/* return NULL if called without a unit-address */
22554540Scth 	if ((caddr == NULL) || (*caddr == '\0'))
22564540Scth 		return (NULL);
22574540Scth 
22584145Scth 	/* attempt search without changing state of preceding siblings */
22594145Scth 	dip = find_sibling(ddi_get_child(pdip), NULL, caddr,
22604145Scth 	    FIND_NODE_BY_ADDR, NULL);
22614145Scth 	if (dip)
22624145Scth 		return (dip);
22634145Scth 
22644145Scth 	return (find_sibling(ddi_get_child(pdip), NULL, caddr,
22654145Scth 	    FIND_NODE_BY_ADDR|FIND_ADDR_BY_INIT, NULL));
22660Sstevel@tonic-gate }
22670Sstevel@tonic-gate 
22680Sstevel@tonic-gate /*
22690Sstevel@tonic-gate  * Deleting a property list. Take care, since some property structures
22700Sstevel@tonic-gate  * may not be fully built.
22710Sstevel@tonic-gate  */
22720Sstevel@tonic-gate void
22730Sstevel@tonic-gate i_ddi_prop_list_delete(ddi_prop_t *prop)
22740Sstevel@tonic-gate {
22750Sstevel@tonic-gate 	while (prop) {
22760Sstevel@tonic-gate 		ddi_prop_t *next = prop->prop_next;
22770Sstevel@tonic-gate 		if (prop->prop_name)
22780Sstevel@tonic-gate 			kmem_free(prop->prop_name, strlen(prop->prop_name) + 1);
22790Sstevel@tonic-gate 		if ((prop->prop_len != 0) && prop->prop_val)
22800Sstevel@tonic-gate 			kmem_free(prop->prop_val, prop->prop_len);
22810Sstevel@tonic-gate 		kmem_free(prop, sizeof (struct ddi_prop));
22820Sstevel@tonic-gate 		prop = next;
22830Sstevel@tonic-gate 	}
22840Sstevel@tonic-gate }
22850Sstevel@tonic-gate 
22860Sstevel@tonic-gate /*
22870Sstevel@tonic-gate  * Duplicate property list
22880Sstevel@tonic-gate  */
22890Sstevel@tonic-gate ddi_prop_t *
22900Sstevel@tonic-gate i_ddi_prop_list_dup(ddi_prop_t *prop, uint_t flag)
22910Sstevel@tonic-gate {
22920Sstevel@tonic-gate 	ddi_prop_t *result, *prev, *copy;
22930Sstevel@tonic-gate 
22940Sstevel@tonic-gate 	if (prop == NULL)
22950Sstevel@tonic-gate 		return (NULL);
22960Sstevel@tonic-gate 
22970Sstevel@tonic-gate 	result = prev = NULL;
22980Sstevel@tonic-gate 	for (; prop != NULL; prop = prop->prop_next) {
22990Sstevel@tonic-gate 		ASSERT(prop->prop_name != NULL);
23000Sstevel@tonic-gate 		copy = kmem_zalloc(sizeof (struct ddi_prop), flag);
23010Sstevel@tonic-gate 		if (copy == NULL)
23020Sstevel@tonic-gate 			goto fail;
23030Sstevel@tonic-gate 
23040Sstevel@tonic-gate 		copy->prop_dev = prop->prop_dev;
23050Sstevel@tonic-gate 		copy->prop_flags = prop->prop_flags;
23060Sstevel@tonic-gate 		copy->prop_name = i_ddi_strdup(prop->prop_name, flag);
23070Sstevel@tonic-gate 		if (copy->prop_name == NULL)
23080Sstevel@tonic-gate 			goto fail;
23090Sstevel@tonic-gate 
23100Sstevel@tonic-gate 		if ((copy->prop_len = prop->prop_len) != 0) {
23110Sstevel@tonic-gate 			copy->prop_val = kmem_zalloc(prop->prop_len, flag);
23120Sstevel@tonic-gate 			if (copy->prop_val == NULL)
23130Sstevel@tonic-gate 				goto fail;
23140Sstevel@tonic-gate 
23150Sstevel@tonic-gate 			bcopy(prop->prop_val, copy->prop_val, prop->prop_len);
23160Sstevel@tonic-gate 		}
23170Sstevel@tonic-gate 
23180Sstevel@tonic-gate 		if (prev == NULL)
23190Sstevel@tonic-gate 			result = prev = copy;
23200Sstevel@tonic-gate 		else
23210Sstevel@tonic-gate 			prev->prop_next = copy;
23220Sstevel@tonic-gate 		prev = copy;
23230Sstevel@tonic-gate 	}
23240Sstevel@tonic-gate 	return (result);
23250Sstevel@tonic-gate 
23260Sstevel@tonic-gate fail:
23270Sstevel@tonic-gate 	i_ddi_prop_list_delete(result);
23280Sstevel@tonic-gate 	return (NULL);
23290Sstevel@tonic-gate }
23300Sstevel@tonic-gate 
23310Sstevel@tonic-gate /*
23320Sstevel@tonic-gate  * Create a reference property list, currently used only for
23330Sstevel@tonic-gate  * driver global properties. Created with ref count of 1.
23340Sstevel@tonic-gate  */
23350Sstevel@tonic-gate ddi_prop_list_t *
23360Sstevel@tonic-gate i_ddi_prop_list_create(ddi_prop_t *props)
23370Sstevel@tonic-gate {
23380Sstevel@tonic-gate 	ddi_prop_list_t *list = kmem_alloc(sizeof (*list), KM_SLEEP);
23390Sstevel@tonic-gate 	list->prop_list = props;
23400Sstevel@tonic-gate 	list->prop_ref = 1;
23410Sstevel@tonic-gate 	return (list);
23420Sstevel@tonic-gate }
23430Sstevel@tonic-gate 
23440Sstevel@tonic-gate /*
23450Sstevel@tonic-gate  * Increment/decrement reference count. The reference is
23460Sstevel@tonic-gate  * protected by dn_lock. The only interfaces modifying
23470Sstevel@tonic-gate  * dn_global_prop_ptr is in impl_make[free]_parlist().
23480Sstevel@tonic-gate  */
23490Sstevel@tonic-gate void
23500Sstevel@tonic-gate i_ddi_prop_list_hold(ddi_prop_list_t *prop_list, struct devnames *dnp)
23510Sstevel@tonic-gate {
23520Sstevel@tonic-gate 	ASSERT(prop_list->prop_ref >= 0);
23530Sstevel@tonic-gate 	ASSERT(mutex_owned(&dnp->dn_lock));
23540Sstevel@tonic-gate 	prop_list->prop_ref++;
23550Sstevel@tonic-gate }
23560Sstevel@tonic-gate 
23570Sstevel@tonic-gate void
23580Sstevel@tonic-gate i_ddi_prop_list_rele(ddi_prop_list_t *prop_list, struct devnames *dnp)
23590Sstevel@tonic-gate {
23600Sstevel@tonic-gate 	ASSERT(prop_list->prop_ref > 0);
23610Sstevel@tonic-gate 	ASSERT(mutex_owned(&dnp->dn_lock));
23620Sstevel@tonic-gate 	prop_list->prop_ref--;
23630Sstevel@tonic-gate 
23640Sstevel@tonic-gate 	if (prop_list->prop_ref == 0) {
23650Sstevel@tonic-gate 		i_ddi_prop_list_delete(prop_list->prop_list);
23660Sstevel@tonic-gate 		kmem_free(prop_list, sizeof (*prop_list));
23670Sstevel@tonic-gate 	}
23680Sstevel@tonic-gate }
23690Sstevel@tonic-gate 
23700Sstevel@tonic-gate /*
23710Sstevel@tonic-gate  * Free table of classes by drivers
23720Sstevel@tonic-gate  */
23730Sstevel@tonic-gate void
23740Sstevel@tonic-gate i_ddi_free_exported_classes(char **classes, int n)
23750Sstevel@tonic-gate {
23760Sstevel@tonic-gate 	if ((n == 0) || (classes == NULL))
23770Sstevel@tonic-gate 		return;
23780Sstevel@tonic-gate 
23790Sstevel@tonic-gate 	kmem_free(classes, n * sizeof (char *));
23800Sstevel@tonic-gate }
23810Sstevel@tonic-gate 
23820Sstevel@tonic-gate /*
23830Sstevel@tonic-gate  * Get all classes exported by dip
23840Sstevel@tonic-gate  */
23850Sstevel@tonic-gate int
23860Sstevel@tonic-gate i_ddi_get_exported_classes(dev_info_t *dip, char ***classes)
23870Sstevel@tonic-gate {
23880Sstevel@tonic-gate 	extern void lock_hw_class_list();
23890Sstevel@tonic-gate 	extern void unlock_hw_class_list();
23900Sstevel@tonic-gate 	extern int get_class(const char *, char **);
23910Sstevel@tonic-gate 
23920Sstevel@tonic-gate 	static char *rootclass = "root";
23930Sstevel@tonic-gate 	int n = 0, nclass = 0;
23940Sstevel@tonic-gate 	char **buf;
23950Sstevel@tonic-gate 
23960Sstevel@tonic-gate 	ASSERT(i_ddi_node_state(dip) >= DS_BOUND);
23970Sstevel@tonic-gate 
23980Sstevel@tonic-gate 	if (dip == ddi_root_node())	/* rootnode exports class "root" */
23990Sstevel@tonic-gate 		nclass = 1;
24000Sstevel@tonic-gate 	lock_hw_class_list();
24010Sstevel@tonic-gate 	nclass += get_class(ddi_driver_name(dip), NULL);
24020Sstevel@tonic-gate 	if (nclass == 0) {
24030Sstevel@tonic-gate 		unlock_hw_class_list();
24040Sstevel@tonic-gate 		return (0);		/* no class exported */
24050Sstevel@tonic-gate 	}
24060Sstevel@tonic-gate 
24070Sstevel@tonic-gate 	*classes = buf = kmem_alloc(nclass * sizeof (char *), KM_SLEEP);
24080Sstevel@tonic-gate 	if (dip == ddi_root_node()) {
24090Sstevel@tonic-gate 		*buf++ = rootclass;
24100Sstevel@tonic-gate 		n = 1;
24110Sstevel@tonic-gate 	}
24120Sstevel@tonic-gate 	n += get_class(ddi_driver_name(dip), buf);
24130Sstevel@tonic-gate 	unlock_hw_class_list();
24140Sstevel@tonic-gate 
24150Sstevel@tonic-gate 	ASSERT(n == nclass);    /* make sure buf wasn't overrun */
24160Sstevel@tonic-gate 	return (nclass);
24170Sstevel@tonic-gate }
24180Sstevel@tonic-gate 
24190Sstevel@tonic-gate /*
24200Sstevel@tonic-gate  * Helper functions, returns NULL if no memory.
24210Sstevel@tonic-gate  */
24220Sstevel@tonic-gate char *
24230Sstevel@tonic-gate i_ddi_strdup(char *str, uint_t flag)
24240Sstevel@tonic-gate {
24250Sstevel@tonic-gate 	char *copy;
24260Sstevel@tonic-gate 
24270Sstevel@tonic-gate 	if (str == NULL)
24280Sstevel@tonic-gate 		return (NULL);
24290Sstevel@tonic-gate 
24300Sstevel@tonic-gate 	copy = kmem_alloc(strlen(str) + 1, flag);
24310Sstevel@tonic-gate 	if (copy == NULL)
24320Sstevel@tonic-gate 		return (NULL);
24330Sstevel@tonic-gate 
24340Sstevel@tonic-gate 	(void) strcpy(copy, str);
24350Sstevel@tonic-gate 	return (copy);
24360Sstevel@tonic-gate }
24370Sstevel@tonic-gate 
24380Sstevel@tonic-gate /*
24390Sstevel@tonic-gate  * Load driver.conf file for major. Load all if major == -1.
24400Sstevel@tonic-gate  *
24410Sstevel@tonic-gate  * This is called
24420Sstevel@tonic-gate  * - early in boot after devnames array is initialized
24430Sstevel@tonic-gate  * - from vfs code when certain file systems are mounted
24440Sstevel@tonic-gate  * - from add_drv when a new driver is added
24450Sstevel@tonic-gate  */
24460Sstevel@tonic-gate int
24470Sstevel@tonic-gate i_ddi_load_drvconf(major_t major)
24480Sstevel@tonic-gate {
24490Sstevel@tonic-gate 	extern int modrootloaded;
24500Sstevel@tonic-gate 
24510Sstevel@tonic-gate 	major_t low, high, m;
24520Sstevel@tonic-gate 
24537009Scth 	if (major == DDI_MAJOR_T_NONE) {
24540Sstevel@tonic-gate 		low = 0;
24550Sstevel@tonic-gate 		high = devcnt - 1;
24560Sstevel@tonic-gate 	} else {
24570Sstevel@tonic-gate 		if (major >= devcnt)
24580Sstevel@tonic-gate 			return (EINVAL);
24590Sstevel@tonic-gate 		low = high = major;
24600Sstevel@tonic-gate 	}
24610Sstevel@tonic-gate 
24620Sstevel@tonic-gate 	for (m = low; m <= high; m++) {
24630Sstevel@tonic-gate 		struct devnames *dnp = &devnamesp[m];
24640Sstevel@tonic-gate 		LOCK_DEV_OPS(&dnp->dn_lock);
24650Sstevel@tonic-gate 		dnp->dn_flags &= ~DN_DRIVER_HELD;
24660Sstevel@tonic-gate 		(void) impl_make_parlist(m);
24670Sstevel@tonic-gate 		UNLOCK_DEV_OPS(&dnp->dn_lock);
24680Sstevel@tonic-gate 	}
24690Sstevel@tonic-gate 
24700Sstevel@tonic-gate 	if (modrootloaded) {
24710Sstevel@tonic-gate 		ddi_walk_devs(ddi_root_node(), reset_nexus_flags,
24720Sstevel@tonic-gate 		    (void *)(uintptr_t)major);
24730Sstevel@tonic-gate 	}
24740Sstevel@tonic-gate 
24750Sstevel@tonic-gate 	/* build dn_list from old entries in path_to_inst */
24760Sstevel@tonic-gate 	e_ddi_unorphan_instance_nos();
24770Sstevel@tonic-gate 	return (0);
24780Sstevel@tonic-gate }
24790Sstevel@tonic-gate 
24800Sstevel@tonic-gate /*
24810Sstevel@tonic-gate  * Unload a specific driver.conf.
24820Sstevel@tonic-gate  * Don't support unload all because it doesn't make any sense
24830Sstevel@tonic-gate  */
24840Sstevel@tonic-gate int
24850Sstevel@tonic-gate i_ddi_unload_drvconf(major_t major)
24860Sstevel@tonic-gate {
24870Sstevel@tonic-gate 	int error;
24880Sstevel@tonic-gate 	struct devnames *dnp;
24890Sstevel@tonic-gate 
24900Sstevel@tonic-gate 	if (major >= devcnt)
24910Sstevel@tonic-gate 		return (EINVAL);
24920Sstevel@tonic-gate 
24930Sstevel@tonic-gate 	/*
24940Sstevel@tonic-gate 	 * Take the per-driver lock while unloading driver.conf
24950Sstevel@tonic-gate 	 */
24960Sstevel@tonic-gate 	dnp = &devnamesp[major];
24970Sstevel@tonic-gate 	LOCK_DEV_OPS(&dnp->dn_lock);
24980Sstevel@tonic-gate 	error = impl_free_parlist(major);
24990Sstevel@tonic-gate 	UNLOCK_DEV_OPS(&dnp->dn_lock);
25000Sstevel@tonic-gate 	return (error);
25010Sstevel@tonic-gate }
25020Sstevel@tonic-gate 
25030Sstevel@tonic-gate /*
25040Sstevel@tonic-gate  * Merge a .conf node. This is called by nexus drivers to augment
25050Sstevel@tonic-gate  * hw node with properties specified in driver.conf file. This function
25060Sstevel@tonic-gate  * takes a callback routine to name nexus children.
25070Sstevel@tonic-gate  * The parent node must be held busy.
25080Sstevel@tonic-gate  *
25090Sstevel@tonic-gate  * It returns DDI_SUCCESS if the node is merged and DDI_FAILURE otherwise.
25100Sstevel@tonic-gate  */
25110Sstevel@tonic-gate int
25120Sstevel@tonic-gate ndi_merge_node(dev_info_t *dip, int (*name_node)(dev_info_t *, char *, int))
25130Sstevel@tonic-gate {
25140Sstevel@tonic-gate 	dev_info_t *hwdip;
25150Sstevel@tonic-gate 
25160Sstevel@tonic-gate 	ASSERT(ndi_dev_is_persistent_node(dip) == 0);
25170Sstevel@tonic-gate 	ASSERT(ddi_get_name_addr(dip) != NULL);
25180Sstevel@tonic-gate 
25190Sstevel@tonic-gate 	hwdip = find_child_by_callback(ddi_get_parent(dip),
25200Sstevel@tonic-gate 	    ddi_binding_name(dip), ddi_get_name_addr(dip), name_node);
25210Sstevel@tonic-gate 
25220Sstevel@tonic-gate 	/*
25230Sstevel@tonic-gate 	 * Look for the hardware node that is the target of the merge;
25240Sstevel@tonic-gate 	 * return failure if not found.
25250Sstevel@tonic-gate 	 */
25260Sstevel@tonic-gate 	if ((hwdip == NULL) || (hwdip == dip)) {
25270Sstevel@tonic-gate 		char *buf = kmem_alloc(MAXNAMELEN, KM_SLEEP);
25280Sstevel@tonic-gate 		NDI_CONFIG_DEBUG((CE_WARN, "No HW node to merge conf node %s",
25290Sstevel@tonic-gate 		    ddi_deviname(dip, buf)));
25300Sstevel@tonic-gate 		kmem_free(buf, MAXNAMELEN);
25310Sstevel@tonic-gate 		return (DDI_FAILURE);
25320Sstevel@tonic-gate 	}
25330Sstevel@tonic-gate 
25340Sstevel@tonic-gate 	/*
25350Sstevel@tonic-gate 	 * Make sure the hardware node is uninitialized and has no property.
25360Sstevel@tonic-gate 	 * This may not be the case if new .conf files are load after some
25370Sstevel@tonic-gate 	 * hardware nodes have already been initialized and attached.
25380Sstevel@tonic-gate 	 *
25390Sstevel@tonic-gate 	 * N.B. We return success here because the node was *intended*
25400Sstevel@tonic-gate 	 * 	to be a merge node because there is a hw node with the name.
25410Sstevel@tonic-gate 	 */
25420Sstevel@tonic-gate 	mutex_enter(&DEVI(hwdip)->devi_lock);
25430Sstevel@tonic-gate 	if (ndi_dev_is_persistent_node(hwdip) == 0) {
25440Sstevel@tonic-gate 		char *buf;
25450Sstevel@tonic-gate 		mutex_exit(&DEVI(hwdip)->devi_lock);
25460Sstevel@tonic-gate 
25470Sstevel@tonic-gate 		buf = kmem_alloc(MAXNAMELEN, KM_SLEEP);
25480Sstevel@tonic-gate 		NDI_CONFIG_DEBUG((CE_NOTE, "Duplicate .conf node %s",
25490Sstevel@tonic-gate 		    ddi_deviname(dip, buf)));
25500Sstevel@tonic-gate 		kmem_free(buf, MAXNAMELEN);
25510Sstevel@tonic-gate 		return (DDI_SUCCESS);
25520Sstevel@tonic-gate 	}
25530Sstevel@tonic-gate 
25540Sstevel@tonic-gate 	/*
25550Sstevel@tonic-gate 	 * If it is possible that the hardware has already been touched
25560Sstevel@tonic-gate 	 * then don't merge.
25570Sstevel@tonic-gate 	 */
25580Sstevel@tonic-gate 	if (i_ddi_node_state(hwdip) >= DS_INITIALIZED ||
25590Sstevel@tonic-gate 	    (DEVI(hwdip)->devi_sys_prop_ptr != NULL) ||
25600Sstevel@tonic-gate 	    (DEVI(hwdip)->devi_drv_prop_ptr != NULL)) {
25610Sstevel@tonic-gate 		char *buf;
25620Sstevel@tonic-gate 		mutex_exit(&DEVI(hwdip)->devi_lock);
25630Sstevel@tonic-gate 
25640Sstevel@tonic-gate 		buf = kmem_alloc(MAXNAMELEN, KM_SLEEP);
25650Sstevel@tonic-gate 		NDI_CONFIG_DEBUG((CE_NOTE,
25660Sstevel@tonic-gate 		    "!Cannot merge .conf node %s with hw node %p "
25670Sstevel@tonic-gate 		    "-- not in proper state",
25680Sstevel@tonic-gate 		    ddi_deviname(dip, buf), (void *)hwdip));
25690Sstevel@tonic-gate 		kmem_free(buf, MAXNAMELEN);
25700Sstevel@tonic-gate 		return (DDI_SUCCESS);
25710Sstevel@tonic-gate 	}
25720Sstevel@tonic-gate 
25730Sstevel@tonic-gate 	mutex_enter(&DEVI(dip)->devi_lock);
25740Sstevel@tonic-gate 	DEVI(hwdip)->devi_sys_prop_ptr = DEVI(dip)->devi_sys_prop_ptr;
25750Sstevel@tonic-gate 	DEVI(hwdip)->devi_drv_prop_ptr = DEVI(dip)->devi_drv_prop_ptr;
25760Sstevel@tonic-gate 	DEVI(dip)->devi_sys_prop_ptr = NULL;
25770Sstevel@tonic-gate 	DEVI(dip)->devi_drv_prop_ptr = NULL;
25780Sstevel@tonic-gate 	mutex_exit(&DEVI(dip)->devi_lock);
25790Sstevel@tonic-gate 	mutex_exit(&DEVI(hwdip)->devi_lock);
25800Sstevel@tonic-gate 
25810Sstevel@tonic-gate 	return (DDI_SUCCESS);
25820Sstevel@tonic-gate }
25830Sstevel@tonic-gate 
25840Sstevel@tonic-gate /*
25850Sstevel@tonic-gate  * Merge a "wildcard" .conf node. This is called by nexus drivers to
25860Sstevel@tonic-gate  * augment a set of hw node with properties specified in driver.conf file.
25870Sstevel@tonic-gate  * The parent node must be held busy.
25880Sstevel@tonic-gate  *
25890Sstevel@tonic-gate  * There is no failure mode, since the nexus may or may not have child
25900Sstevel@tonic-gate  * node bound the driver specified by the wildcard node.
25910Sstevel@tonic-gate  */
25920Sstevel@tonic-gate void
25930Sstevel@tonic-gate ndi_merge_wildcard_node(dev_info_t *dip)
25940Sstevel@tonic-gate {
25950Sstevel@tonic-gate 	dev_info_t *hwdip;
25960Sstevel@tonic-gate 	dev_info_t *pdip = ddi_get_parent(dip);
25970Sstevel@tonic-gate 	major_t major = ddi_driver_major(dip);
25980Sstevel@tonic-gate 
25990Sstevel@tonic-gate 	/* never attempt to merge a hw node */
26000Sstevel@tonic-gate 	ASSERT(ndi_dev_is_persistent_node(dip) == 0);
26010Sstevel@tonic-gate 	/* must be bound to a driver major number */
26027009Scth 	ASSERT(major != DDI_MAJOR_T_NONE);
26030Sstevel@tonic-gate 
26040Sstevel@tonic-gate 	/*
26050Sstevel@tonic-gate 	 * Walk the child list to find all nodes bound to major
26060Sstevel@tonic-gate 	 * and copy properties.
26070Sstevel@tonic-gate 	 */
26080Sstevel@tonic-gate 	mutex_enter(&DEVI(dip)->devi_lock);
26097224Scth 	ASSERT(DEVI_BUSY_OWNED(pdip));
26100Sstevel@tonic-gate 	for (hwdip = ddi_get_child(pdip); hwdip;
26110Sstevel@tonic-gate 	    hwdip = ddi_get_next_sibling(hwdip)) {
26120Sstevel@tonic-gate 		/*
26130Sstevel@tonic-gate 		 * Skip nodes not bound to same driver
26140Sstevel@tonic-gate 		 */
26150Sstevel@tonic-gate 		if (ddi_driver_major(hwdip) != major)
26160Sstevel@tonic-gate 			continue;
26170Sstevel@tonic-gate 
26180Sstevel@tonic-gate 		/*
26190Sstevel@tonic-gate 		 * Skip .conf nodes
26200Sstevel@tonic-gate 		 */
26210Sstevel@tonic-gate 		if (ndi_dev_is_persistent_node(hwdip) == 0)
26220Sstevel@tonic-gate 			continue;
26230Sstevel@tonic-gate 
26240Sstevel@tonic-gate 		/*
26250Sstevel@tonic-gate 		 * Make sure the node is uninitialized and has no property.
26260Sstevel@tonic-gate 		 */
26270Sstevel@tonic-gate 		mutex_enter(&DEVI(hwdip)->devi_lock);
26280Sstevel@tonic-gate 		if (i_ddi_node_state(hwdip) >= DS_INITIALIZED ||
26290Sstevel@tonic-gate 		    (DEVI(hwdip)->devi_sys_prop_ptr != NULL) ||
26300Sstevel@tonic-gate 		    (DEVI(hwdip)->devi_drv_prop_ptr != NULL)) {
26310Sstevel@tonic-gate 			mutex_exit(&DEVI(hwdip)->devi_lock);
26320Sstevel@tonic-gate 			NDI_CONFIG_DEBUG((CE_NOTE, "HW node %p state not "
26330Sstevel@tonic-gate 			    "suitable for merging wildcard conf node %s",
26340Sstevel@tonic-gate 			    (void *)hwdip, ddi_node_name(dip)));
26350Sstevel@tonic-gate 			continue;
26360Sstevel@tonic-gate 		}
26370Sstevel@tonic-gate 
26380Sstevel@tonic-gate 		DEVI(hwdip)->devi_sys_prop_ptr =
26390Sstevel@tonic-gate 		    i_ddi_prop_list_dup(DEVI(dip)->devi_sys_prop_ptr, KM_SLEEP);
26400Sstevel@tonic-gate 		DEVI(hwdip)->devi_drv_prop_ptr =
26410Sstevel@tonic-gate 		    i_ddi_prop_list_dup(DEVI(dip)->devi_drv_prop_ptr, KM_SLEEP);
26420Sstevel@tonic-gate 		mutex_exit(&DEVI(hwdip)->devi_lock);
26430Sstevel@tonic-gate 	}
26440Sstevel@tonic-gate 	mutex_exit(&DEVI(dip)->devi_lock);
26450Sstevel@tonic-gate }
26460Sstevel@tonic-gate 
26470Sstevel@tonic-gate /*
26480Sstevel@tonic-gate  * Return the major number based on the compatible property. This interface
26490Sstevel@tonic-gate  * may be used in situations where we are trying to detect if a better driver
26500Sstevel@tonic-gate  * now exists for a device, so it must use the 'compatible' property.  If
26510Sstevel@tonic-gate  * a non-NULL formp is specified and the binding was based on compatible then
26520Sstevel@tonic-gate  * return the pointer to the form used in *formp.
26530Sstevel@tonic-gate  */
26540Sstevel@tonic-gate major_t
26550Sstevel@tonic-gate ddi_compatible_driver_major(dev_info_t *dip, char **formp)
26560Sstevel@tonic-gate {
26570Sstevel@tonic-gate 	struct dev_info *devi = DEVI(dip);
26580Sstevel@tonic-gate 	void		*compat;
26590Sstevel@tonic-gate 	size_t		len;
26600Sstevel@tonic-gate 	char		*p = NULL;
26617009Scth 	major_t		major = DDI_MAJOR_T_NONE;
26620Sstevel@tonic-gate 
26630Sstevel@tonic-gate 	if (formp)
26640Sstevel@tonic-gate 		*formp = NULL;
26650Sstevel@tonic-gate 
26664145Scth 	/*
26674145Scth 	 * Highest precedence binding is a path-oriented alias. Since this
26684145Scth 	 * requires a 'path', this type of binding occurs via more obtuse
26694145Scth 	 * 'rebind'. The need for a path-oriented alias 'rebind' is detected
26704145Scth 	 * after a successful DDI_CTLOPS_INITCHILD to another driver: this is
26714145Scth 	 * is the first point at which the unit-address (or instance) of the
26724145Scth 	 * last component of the path is available (even though the path is
26734145Scth 	 * bound to the wrong driver at this point).
26744145Scth 	 */
26754145Scth 	if (devi->devi_flags & DEVI_REBIND) {
26764145Scth 		p = devi->devi_rebinding_name;
26774145Scth 		major = ddi_name_to_major(p);
26787009Scth 		if ((major != DDI_MAJOR_T_NONE) &&
26794145Scth 		    !(devnamesp[major].dn_flags & DN_DRIVER_REMOVED)) {
26804145Scth 			if (formp)
26814145Scth 				*formp = p;
26824145Scth 			return (major);
26834145Scth 		}
26844145Scth 
26854145Scth 		/*
26864145Scth 		 * If for some reason devi_rebinding_name no longer resolves
26874145Scth 		 * to a proper driver then clear DEVI_REBIND.
26884145Scth 		 */
26894145Scth 		mutex_enter(&devi->devi_lock);
26904145Scth 		devi->devi_flags &= ~DEVI_REBIND;
26914145Scth 		mutex_exit(&devi->devi_lock);
26924145Scth 	}
26934145Scth 
26940Sstevel@tonic-gate 	/* look up compatible property */
26950Sstevel@tonic-gate 	(void) lookup_compatible(dip, KM_SLEEP);
26960Sstevel@tonic-gate 	compat = (void *)(devi->devi_compat_names);
26970Sstevel@tonic-gate 	len = devi->devi_compat_length;
26980Sstevel@tonic-gate 
26990Sstevel@tonic-gate 	/* find the highest precedence compatible form with a driver binding */
27000Sstevel@tonic-gate 	while ((p = prom_decode_composite_string(compat, len, p)) != NULL) {
27010Sstevel@tonic-gate 		major = ddi_name_to_major(p);
27027009Scth 		if ((major != DDI_MAJOR_T_NONE) &&
27030Sstevel@tonic-gate 		    !(devnamesp[major].dn_flags & DN_DRIVER_REMOVED)) {
27040Sstevel@tonic-gate 			if (formp)
27050Sstevel@tonic-gate 				*formp = p;
27060Sstevel@tonic-gate 			return (major);
27070Sstevel@tonic-gate 		}
27080Sstevel@tonic-gate 	}
27090Sstevel@tonic-gate 
27100Sstevel@tonic-gate 	/*
27110Sstevel@tonic-gate 	 * none of the compatible forms have a driver binding, see if
27120Sstevel@tonic-gate 	 * the node name has a driver binding.
27130Sstevel@tonic-gate 	 */
27140Sstevel@tonic-gate 	major = ddi_name_to_major(ddi_node_name(dip));
27157009Scth 	if ((major != DDI_MAJOR_T_NONE) &&
27160Sstevel@tonic-gate 	    !(devnamesp[major].dn_flags & DN_DRIVER_REMOVED))
27170Sstevel@tonic-gate 		return (major);
27180Sstevel@tonic-gate 
27190Sstevel@tonic-gate 	/* no driver */
27207009Scth 	return (DDI_MAJOR_T_NONE);
27210Sstevel@tonic-gate }
27220Sstevel@tonic-gate 
27230Sstevel@tonic-gate /*
27240Sstevel@tonic-gate  * Static help functions
27250Sstevel@tonic-gate  */
27260Sstevel@tonic-gate 
27270Sstevel@tonic-gate /*
27280Sstevel@tonic-gate  * lookup the "compatible" property and cache it's contents in the
27290Sstevel@tonic-gate  * device node.
27300Sstevel@tonic-gate  */
27310Sstevel@tonic-gate static int
27320Sstevel@tonic-gate lookup_compatible(dev_info_t *dip, uint_t flag)
27330Sstevel@tonic-gate {
27340Sstevel@tonic-gate 	int rv;
27350Sstevel@tonic-gate 	int prop_flags;
27360Sstevel@tonic-gate 	uint_t ncompatstrs;
27370Sstevel@tonic-gate 	char **compatstrpp;
27380Sstevel@tonic-gate 	char *di_compat_strp;
27390Sstevel@tonic-gate 	size_t di_compat_strlen;
27400Sstevel@tonic-gate 
27410Sstevel@tonic-gate 	if (DEVI(dip)->devi_compat_names) {
27420Sstevel@tonic-gate 		return (DDI_SUCCESS);
27430Sstevel@tonic-gate 	}
27440Sstevel@tonic-gate 
27450Sstevel@tonic-gate 	prop_flags = DDI_PROP_TYPE_STRING | DDI_PROP_DONTPASS;
27460Sstevel@tonic-gate 
27470Sstevel@tonic-gate 	if (flag & KM_NOSLEEP) {
27480Sstevel@tonic-gate 		prop_flags |= DDI_PROP_DONTSLEEP;
27490Sstevel@tonic-gate 	}
27500Sstevel@tonic-gate 
27510Sstevel@tonic-gate 	if (ndi_dev_is_prom_node(dip) == 0) {
27520Sstevel@tonic-gate 		prop_flags |= DDI_PROP_NOTPROM;
27530Sstevel@tonic-gate 	}
27540Sstevel@tonic-gate 
27550Sstevel@tonic-gate 	rv = ddi_prop_lookup_common(DDI_DEV_T_ANY, dip, prop_flags,
27560Sstevel@tonic-gate 	    "compatible", &compatstrpp, &ncompatstrs,
27570Sstevel@tonic-gate 	    ddi_prop_fm_decode_strings);
27580Sstevel@tonic-gate 
27590Sstevel@tonic-gate 	if (rv == DDI_PROP_NOT_FOUND) {
27600Sstevel@tonic-gate 		return (DDI_SUCCESS);
27610Sstevel@tonic-gate 	}
27620Sstevel@tonic-gate 
27630Sstevel@tonic-gate 	if (rv != DDI_PROP_SUCCESS) {
27640Sstevel@tonic-gate 		return (DDI_FAILURE);
27650Sstevel@tonic-gate 	}
27660Sstevel@tonic-gate 
27670Sstevel@tonic-gate 	/*
27680Sstevel@tonic-gate 	 * encode the compatible property data in the dev_info node
27690Sstevel@tonic-gate 	 */
27700Sstevel@tonic-gate 	rv = DDI_SUCCESS;
27710Sstevel@tonic-gate 	if (ncompatstrs != 0) {
27720Sstevel@tonic-gate 		di_compat_strp = encode_composite_string(compatstrpp,
27730Sstevel@tonic-gate 		    ncompatstrs, &di_compat_strlen, flag);
27740Sstevel@tonic-gate 		if (di_compat_strp != NULL) {
27750Sstevel@tonic-gate 			DEVI(dip)->devi_compat_names = di_compat_strp;
27760Sstevel@tonic-gate 			DEVI(dip)->devi_compat_length = di_compat_strlen;
27770Sstevel@tonic-gate 		} else {
27780Sstevel@tonic-gate 			rv = DDI_FAILURE;
27790Sstevel@tonic-gate 		}
27800Sstevel@tonic-gate 	}
27810Sstevel@tonic-gate 	ddi_prop_free(compatstrpp);
27820Sstevel@tonic-gate 	return (rv);
27830Sstevel@tonic-gate }
27840Sstevel@tonic-gate 
27850Sstevel@tonic-gate /*
27860Sstevel@tonic-gate  * Create a composite string from a list of strings.
27870Sstevel@tonic-gate  *
27880Sstevel@tonic-gate  * A composite string consists of a single buffer containing one
27890Sstevel@tonic-gate  * or more NULL terminated strings.
27900Sstevel@tonic-gate  */
27910Sstevel@tonic-gate static char *
27920Sstevel@tonic-gate encode_composite_string(char **strings, uint_t nstrings, size_t *retsz,
27930Sstevel@tonic-gate     uint_t flag)
27940Sstevel@tonic-gate {
27950Sstevel@tonic-gate 	uint_t index;
27960Sstevel@tonic-gate 	char  **strpp;
27970Sstevel@tonic-gate 	uint_t slen;
27980Sstevel@tonic-gate 	size_t cbuf_sz = 0;
27990Sstevel@tonic-gate 	char *cbuf_p;
28000Sstevel@tonic-gate 	char *cbuf_ip;
28010Sstevel@tonic-gate 
28020Sstevel@tonic-gate 	if (strings == NULL || nstrings == 0 || retsz == NULL) {
28030Sstevel@tonic-gate 		return (NULL);
28040Sstevel@tonic-gate 	}
28050Sstevel@tonic-gate 
28060Sstevel@tonic-gate 	for (index = 0, strpp = strings; index < nstrings; index++)
28070Sstevel@tonic-gate 		cbuf_sz += strlen(*(strpp++)) + 1;
28080Sstevel@tonic-gate 
28090Sstevel@tonic-gate 	if ((cbuf_p = kmem_alloc(cbuf_sz, flag)) == NULL) {
28100Sstevel@tonic-gate 		cmn_err(CE_NOTE,
28110Sstevel@tonic-gate 		    "?failed to allocate device node compatstr");
28120Sstevel@tonic-gate 		return (NULL);
28130Sstevel@tonic-gate 	}
28140Sstevel@tonic-gate 
28150Sstevel@tonic-gate 	cbuf_ip = cbuf_p;
28160Sstevel@tonic-gate 	for (index = 0, strpp = strings; index < nstrings; index++) {
28170Sstevel@tonic-gate 		slen = strlen(*strpp);
28180Sstevel@tonic-gate 		bcopy(*(strpp++), cbuf_ip, slen);
28190Sstevel@tonic-gate 		cbuf_ip += slen;
28200Sstevel@tonic-gate 		*(cbuf_ip++) = '\0';
28210Sstevel@tonic-gate 	}
28220Sstevel@tonic-gate 
28230Sstevel@tonic-gate 	*retsz = cbuf_sz;
28240Sstevel@tonic-gate 	return (cbuf_p);
28250Sstevel@tonic-gate }
28260Sstevel@tonic-gate 
28270Sstevel@tonic-gate static void
28280Sstevel@tonic-gate link_to_driver_list(dev_info_t *dip)
28290Sstevel@tonic-gate {
28300Sstevel@tonic-gate 	major_t major = DEVI(dip)->devi_major;
28310Sstevel@tonic-gate 	struct devnames *dnp;
28320Sstevel@tonic-gate 
28337009Scth 	ASSERT(major != DDI_MAJOR_T_NONE);
28340Sstevel@tonic-gate 
28350Sstevel@tonic-gate 	/*
28360Sstevel@tonic-gate 	 * Remove from orphan list
28370Sstevel@tonic-gate 	 */
28380Sstevel@tonic-gate 	if (ndi_dev_is_persistent_node(dip)) {
28390Sstevel@tonic-gate 		dnp = &orphanlist;
28400Sstevel@tonic-gate 		remove_from_dn_list(dnp, dip);
28410Sstevel@tonic-gate 	}
28420Sstevel@tonic-gate 
28430Sstevel@tonic-gate 	/*
28440Sstevel@tonic-gate 	 * Add to per driver list
28450Sstevel@tonic-gate 	 */
28460Sstevel@tonic-gate 	dnp = &devnamesp[major];
28470Sstevel@tonic-gate 	add_to_dn_list(dnp, dip);
28480Sstevel@tonic-gate }
28490Sstevel@tonic-gate 
28500Sstevel@tonic-gate static void
28510Sstevel@tonic-gate unlink_from_driver_list(dev_info_t *dip)
28520Sstevel@tonic-gate {
28530Sstevel@tonic-gate 	major_t major = DEVI(dip)->devi_major;
28540Sstevel@tonic-gate 	struct devnames *dnp;
28550Sstevel@tonic-gate 
28567009Scth 	ASSERT(major != DDI_MAJOR_T_NONE);
28570Sstevel@tonic-gate 
28580Sstevel@tonic-gate 	/*
28590Sstevel@tonic-gate 	 * Remove from per-driver list
28600Sstevel@tonic-gate 	 */
28610Sstevel@tonic-gate 	dnp = &devnamesp[major];
28620Sstevel@tonic-gate 	remove_from_dn_list(dnp, dip);
28630Sstevel@tonic-gate 
28640Sstevel@tonic-gate 	/*
28650Sstevel@tonic-gate 	 * Add to orphan list
28660Sstevel@tonic-gate 	 */
28670Sstevel@tonic-gate 	if (ndi_dev_is_persistent_node(dip)) {
28680Sstevel@tonic-gate 		dnp = &orphanlist;
28690Sstevel@tonic-gate 		add_to_dn_list(dnp, dip);
28700Sstevel@tonic-gate 	}
28710Sstevel@tonic-gate }
28720Sstevel@tonic-gate 
28730Sstevel@tonic-gate /*
28740Sstevel@tonic-gate  * scan the per-driver list looking for dev_info "dip"
28750Sstevel@tonic-gate  */
28760Sstevel@tonic-gate static dev_info_t *
28770Sstevel@tonic-gate in_dn_list(struct devnames *dnp, dev_info_t *dip)
28780Sstevel@tonic-gate {
28790Sstevel@tonic-gate 	struct dev_info *idevi;
28800Sstevel@tonic-gate 
28810Sstevel@tonic-gate 	if ((idevi = DEVI(dnp->dn_head)) == NULL)
28820Sstevel@tonic-gate 		return (NULL);
28830Sstevel@tonic-gate 
28840Sstevel@tonic-gate 	while (idevi) {
28850Sstevel@tonic-gate 		if (idevi == DEVI(dip))
28860Sstevel@tonic-gate 			return (dip);
28870Sstevel@tonic-gate 		idevi = idevi->devi_next;
28880Sstevel@tonic-gate 	}
28890Sstevel@tonic-gate 	return (NULL);
28900Sstevel@tonic-gate }
28910Sstevel@tonic-gate 
28920Sstevel@tonic-gate /*
28930Sstevel@tonic-gate  * insert devinfo node 'dip' into the per-driver instance list
28940Sstevel@tonic-gate  * headed by 'dnp'
28950Sstevel@tonic-gate  *
28960Sstevel@tonic-gate  * Nodes on the per-driver list are ordered: HW - SID - PSEUDO.  The order is
28970Sstevel@tonic-gate  * required for merging of .conf file data to work properly.
28980Sstevel@tonic-gate  */
28990Sstevel@tonic-gate static void
29000Sstevel@tonic-gate add_to_ordered_dn_list(struct devnames *dnp, dev_info_t *dip)
29010Sstevel@tonic-gate {
29020Sstevel@tonic-gate 	dev_info_t **dipp;
29030Sstevel@tonic-gate 
29040Sstevel@tonic-gate 	ASSERT(mutex_owned(&(dnp->dn_lock)));
29050Sstevel@tonic-gate 
29060Sstevel@tonic-gate 	dipp = &dnp->dn_head;
29070Sstevel@tonic-gate 	if (ndi_dev_is_prom_node(dip)) {
29080Sstevel@tonic-gate 		/*
29090Sstevel@tonic-gate 		 * Find the first non-prom node or end of list
29100Sstevel@tonic-gate 		 */
29110Sstevel@tonic-gate 		while (*dipp && (ndi_dev_is_prom_node(*dipp) != 0)) {
29120Sstevel@tonic-gate 			dipp = (dev_info_t **)&DEVI(*dipp)->devi_next;
29130Sstevel@tonic-gate 		}
29140Sstevel@tonic-gate 	} else if (ndi_dev_is_persistent_node(dip)) {
29150Sstevel@tonic-gate 		/*
29160Sstevel@tonic-gate 		 * Find the first non-persistent node
29170Sstevel@tonic-gate 		 */
29180Sstevel@tonic-gate 		while (*dipp && (ndi_dev_is_persistent_node(*dipp) != 0)) {
29190Sstevel@tonic-gate 			dipp = (dev_info_t **)&DEVI(*dipp)->devi_next;
29200Sstevel@tonic-gate 		}
29210Sstevel@tonic-gate 	} else {
29220Sstevel@tonic-gate 		/*
29230Sstevel@tonic-gate 		 * Find the end of the list
29240Sstevel@tonic-gate 		 */
29250Sstevel@tonic-gate 		while (*dipp) {
29260Sstevel@tonic-gate 			dipp = (dev_info_t **)&DEVI(*dipp)->devi_next;
29270Sstevel@tonic-gate 		}
29280Sstevel@tonic-gate 	}
29290Sstevel@tonic-gate 
29300Sstevel@tonic-gate 	DEVI(dip)->devi_next = DEVI(*dipp);
29310Sstevel@tonic-gate 	*dipp = dip;
29320Sstevel@tonic-gate }
29330Sstevel@tonic-gate 
29340Sstevel@tonic-gate /*
29350Sstevel@tonic-gate  * add a list of device nodes to the device node list in the
29360Sstevel@tonic-gate  * devnames structure
29370Sstevel@tonic-gate  */
29380Sstevel@tonic-gate static void
29390Sstevel@tonic-gate add_to_dn_list(struct devnames *dnp, dev_info_t *dip)
29400Sstevel@tonic-gate {
29410Sstevel@tonic-gate 	/*
29420Sstevel@tonic-gate 	 * Look to see if node already exists
29430Sstevel@tonic-gate 	 */
29440Sstevel@tonic-gate 	LOCK_DEV_OPS(&(dnp->dn_lock));
29450Sstevel@tonic-gate 	if (in_dn_list(dnp, dip)) {
29460Sstevel@tonic-gate 		cmn_err(CE_NOTE, "add_to_dn_list: node %s already in list",
29470Sstevel@tonic-gate 		    DEVI(dip)->devi_node_name);
29480Sstevel@tonic-gate 	} else {
29490Sstevel@tonic-gate 		add_to_ordered_dn_list(dnp, dip);
29500Sstevel@tonic-gate 	}
29510Sstevel@tonic-gate 	UNLOCK_DEV_OPS(&(dnp->dn_lock));
29520Sstevel@tonic-gate }
29530Sstevel@tonic-gate 
29540Sstevel@tonic-gate static void
29550Sstevel@tonic-gate remove_from_dn_list(struct devnames *dnp, dev_info_t *dip)
29560Sstevel@tonic-gate {
29570Sstevel@tonic-gate 	dev_info_t **plist;
29580Sstevel@tonic-gate 
29590Sstevel@tonic-gate 	LOCK_DEV_OPS(&(dnp->dn_lock));
29600Sstevel@tonic-gate 
29610Sstevel@tonic-gate 	plist = (dev_info_t **)&dnp->dn_head;
29620Sstevel@tonic-gate 	while (*plist && (*plist != dip)) {
29630Sstevel@tonic-gate 		plist = (dev_info_t **)&DEVI(*plist)->devi_next;
29640Sstevel@tonic-gate 	}
29650Sstevel@tonic-gate 
29660Sstevel@tonic-gate 	if (*plist != NULL) {
29670Sstevel@tonic-gate 		ASSERT(*plist == dip);
29680Sstevel@tonic-gate 		*plist = (dev_info_t *)(DEVI(dip)->devi_next);
29690Sstevel@tonic-gate 		DEVI(dip)->devi_next = NULL;
29700Sstevel@tonic-gate 	} else {
29710Sstevel@tonic-gate 		NDI_CONFIG_DEBUG((CE_NOTE,
29720Sstevel@tonic-gate 		    "remove_from_dn_list: node %s not found in list",
29730Sstevel@tonic-gate 		    DEVI(dip)->devi_node_name));
29740Sstevel@tonic-gate 	}
29750Sstevel@tonic-gate 
29760Sstevel@tonic-gate 	UNLOCK_DEV_OPS(&(dnp->dn_lock));
29770Sstevel@tonic-gate }
29780Sstevel@tonic-gate 
29790Sstevel@tonic-gate /*
29800Sstevel@tonic-gate  * Add and remove reference driver global property list
29810Sstevel@tonic-gate  */
29820Sstevel@tonic-gate static void
29830Sstevel@tonic-gate add_global_props(dev_info_t *dip)
29840Sstevel@tonic-gate {
29850Sstevel@tonic-gate 	struct devnames *dnp;
29860Sstevel@tonic-gate 	ddi_prop_list_t *plist;
29870Sstevel@tonic-gate 
29880Sstevel@tonic-gate 	ASSERT(DEVI(dip)->devi_global_prop_list == NULL);
29897009Scth 	ASSERT(DEVI(dip)->devi_major != DDI_MAJOR_T_NONE);
29900Sstevel@tonic-gate 
29910Sstevel@tonic-gate 	dnp = &devnamesp[DEVI(dip)->devi_major];
29920Sstevel@tonic-gate 	LOCK_DEV_OPS(&dnp->dn_lock);
29930Sstevel@tonic-gate 	plist = dnp->dn_global_prop_ptr;
29940Sstevel@tonic-gate 	if (plist == NULL) {
29950Sstevel@tonic-gate 		UNLOCK_DEV_OPS(&dnp->dn_lock);
29960Sstevel@tonic-gate 		return;
29970Sstevel@tonic-gate 	}
29980Sstevel@tonic-gate 	i_ddi_prop_list_hold(plist, dnp);
29990Sstevel@tonic-gate 	UNLOCK_DEV_OPS(&dnp->dn_lock);
30000Sstevel@tonic-gate 
30010Sstevel@tonic-gate 	mutex_enter(&DEVI(dip)->devi_lock);
30020Sstevel@tonic-gate 	DEVI(dip)->devi_global_prop_list = plist;
30030Sstevel@tonic-gate 	mutex_exit(&DEVI(dip)->devi_lock);
30040Sstevel@tonic-gate }
30050Sstevel@tonic-gate 
30060Sstevel@tonic-gate static void
30070Sstevel@tonic-gate remove_global_props(dev_info_t *dip)
30080Sstevel@tonic-gate {
30090Sstevel@tonic-gate 	ddi_prop_list_t *proplist;
30100Sstevel@tonic-gate 
30110Sstevel@tonic-gate 	mutex_enter(&DEVI(dip)->devi_lock);
30120Sstevel@tonic-gate 	proplist = DEVI(dip)->devi_global_prop_list;
30130Sstevel@tonic-gate 	DEVI(dip)->devi_global_prop_list = NULL;
30140Sstevel@tonic-gate 	mutex_exit(&DEVI(dip)->devi_lock);
30150Sstevel@tonic-gate 
30160Sstevel@tonic-gate 	if (proplist) {
30170Sstevel@tonic-gate 		major_t major;
30180Sstevel@tonic-gate 		struct devnames *dnp;
30190Sstevel@tonic-gate 
30200Sstevel@tonic-gate 		major = ddi_driver_major(dip);
30217009Scth 		ASSERT(major != DDI_MAJOR_T_NONE);
30220Sstevel@tonic-gate 		dnp = &devnamesp[major];
30230Sstevel@tonic-gate 		LOCK_DEV_OPS(&dnp->dn_lock);
30240Sstevel@tonic-gate 		i_ddi_prop_list_rele(proplist, dnp);
30250Sstevel@tonic-gate 		UNLOCK_DEV_OPS(&dnp->dn_lock);
30260Sstevel@tonic-gate 	}
30270Sstevel@tonic-gate }
30280Sstevel@tonic-gate 
30290Sstevel@tonic-gate #ifdef DEBUG
30300Sstevel@tonic-gate /*
30310Sstevel@tonic-gate  * Set this variable to '0' to disable the optimization,
30320Sstevel@tonic-gate  * and to 2 to print debug message.
30330Sstevel@tonic-gate  */
30340Sstevel@tonic-gate static int optimize_dtree = 1;
30350Sstevel@tonic-gate 
30360Sstevel@tonic-gate static void
30370Sstevel@tonic-gate debug_dtree(dev_info_t *devi, struct dev_info *adevi, char *service)
30380Sstevel@tonic-gate {
30390Sstevel@tonic-gate 	char *adeviname, *buf;
30400Sstevel@tonic-gate 
30410Sstevel@tonic-gate 	/*
30420Sstevel@tonic-gate 	 * Don't print unless optimize dtree is set to 2+
30430Sstevel@tonic-gate 	 */
30440Sstevel@tonic-gate 	if (optimize_dtree <= 1)
30450Sstevel@tonic-gate 		return;
30460Sstevel@tonic-gate 
30470Sstevel@tonic-gate 	buf = kmem_alloc(MAXNAMELEN, KM_SLEEP);
30480Sstevel@tonic-gate 	adeviname = ddi_deviname((dev_info_t *)adevi, buf);
30490Sstevel@tonic-gate 	if (*adeviname == '\0')
30500Sstevel@tonic-gate 		adeviname = "root";
30510Sstevel@tonic-gate 
30520Sstevel@tonic-gate 	cmn_err(CE_CONT, "%s %s -> %s\n",
30530Sstevel@tonic-gate 	    ddi_deviname(devi, buf), service, adeviname);
30540Sstevel@tonic-gate 
30550Sstevel@tonic-gate 	kmem_free(buf, MAXNAMELEN);
30560Sstevel@tonic-gate }
30570Sstevel@tonic-gate #else /* DEBUG */
30580Sstevel@tonic-gate #define	debug_dtree(a1, a2, a3)	 /* nothing */
30590Sstevel@tonic-gate #endif  /* DEBUG */
30600Sstevel@tonic-gate 
30610Sstevel@tonic-gate static void
30620Sstevel@tonic-gate ddi_optimize_dtree(dev_info_t *devi)
30630Sstevel@tonic-gate {
30640Sstevel@tonic-gate 	struct dev_info *pdevi;
30650Sstevel@tonic-gate 	struct bus_ops *b;
30660Sstevel@tonic-gate 
30670Sstevel@tonic-gate 	pdevi = DEVI(devi)->devi_parent;
30680Sstevel@tonic-gate 	ASSERT(pdevi);
30690Sstevel@tonic-gate 
30700Sstevel@tonic-gate 	/*
30710Sstevel@tonic-gate 	 * Set the unoptimized values
30720Sstevel@tonic-gate 	 */
30730Sstevel@tonic-gate 	DEVI(devi)->devi_bus_map_fault = pdevi;
30740Sstevel@tonic-gate 	DEVI(devi)->devi_bus_dma_map = pdevi;
30750Sstevel@tonic-gate 	DEVI(devi)->devi_bus_dma_allochdl = pdevi;
30760Sstevel@tonic-gate 	DEVI(devi)->devi_bus_dma_freehdl = pdevi;
30770Sstevel@tonic-gate 	DEVI(devi)->devi_bus_dma_bindhdl = pdevi;
30780Sstevel@tonic-gate 	DEVI(devi)->devi_bus_dma_bindfunc =
30794950Scth 	    pdevi->devi_ops->devo_bus_ops->bus_dma_bindhdl;
30800Sstevel@tonic-gate 	DEVI(devi)->devi_bus_dma_unbindhdl = pdevi;
30810Sstevel@tonic-gate 	DEVI(devi)->devi_bus_dma_unbindfunc =
30820Sstevel@tonic-gate 	    pdevi->devi_ops->devo_bus_ops->bus_dma_unbindhdl;
30830Sstevel@tonic-gate 	DEVI(devi)->devi_bus_dma_flush = pdevi;
30840Sstevel@tonic-gate 	DEVI(devi)->devi_bus_dma_win = pdevi;
30850Sstevel@tonic-gate 	DEVI(devi)->devi_bus_dma_ctl = pdevi;
30860Sstevel@tonic-gate 	DEVI(devi)->devi_bus_ctl = pdevi;
30870Sstevel@tonic-gate 
30880Sstevel@tonic-gate #ifdef DEBUG
30890Sstevel@tonic-gate 	if (optimize_dtree == 0)
30900Sstevel@tonic-gate 		return;
30910Sstevel@tonic-gate #endif /* DEBUG */
30920Sstevel@tonic-gate 
30930Sstevel@tonic-gate 	b = pdevi->devi_ops->devo_bus_ops;
30940Sstevel@tonic-gate 
30950Sstevel@tonic-gate 	if (i_ddi_map_fault == b->bus_map_fault) {
30960Sstevel@tonic-gate 		DEVI(devi)->devi_bus_map_fault = pdevi->devi_bus_map_fault;
30970Sstevel@tonic-gate 		debug_dtree(devi, DEVI(devi)->devi_bus_map_fault,
30980Sstevel@tonic-gate 		    "bus_map_fault");
30990Sstevel@tonic-gate 	}
31000Sstevel@tonic-gate 
31010Sstevel@tonic-gate 	if (ddi_dma_map == b->bus_dma_map) {
31020Sstevel@tonic-gate 		DEVI(devi)->devi_bus_dma_map = pdevi->devi_bus_dma_map;
31030Sstevel@tonic-gate 		debug_dtree(devi, DEVI(devi)->devi_bus_dma_map, "bus_dma_map");
31040Sstevel@tonic-gate 	}
31050Sstevel@tonic-gate 
31060Sstevel@tonic-gate 	if (ddi_dma_allochdl == b->bus_dma_allochdl) {
31070Sstevel@tonic-gate 		DEVI(devi)->devi_bus_dma_allochdl =
31080Sstevel@tonic-gate 		    pdevi->devi_bus_dma_allochdl;
31090Sstevel@tonic-gate 		debug_dtree(devi, DEVI(devi)->devi_bus_dma_allochdl,
31100Sstevel@tonic-gate 		    "bus_dma_allochdl");
31110Sstevel@tonic-gate 	}
31120Sstevel@tonic-gate 
31130Sstevel@tonic-gate 	if (ddi_dma_freehdl == b->bus_dma_freehdl) {
31140Sstevel@tonic-gate 		DEVI(devi)->devi_bus_dma_freehdl = pdevi->devi_bus_dma_freehdl;
31150Sstevel@tonic-gate 		debug_dtree(devi, DEVI(devi)->devi_bus_dma_freehdl,
31160Sstevel@tonic-gate 		    "bus_dma_freehdl");
31170Sstevel@tonic-gate 	}
31180Sstevel@tonic-gate 
31190Sstevel@tonic-gate 	if (ddi_dma_bindhdl == b->bus_dma_bindhdl) {
31200Sstevel@tonic-gate 		DEVI(devi)->devi_bus_dma_bindhdl = pdevi->devi_bus_dma_bindhdl;
31210Sstevel@tonic-gate 		DEVI(devi)->devi_bus_dma_bindfunc =
31220Sstevel@tonic-gate 		    pdevi->devi_bus_dma_bindhdl->devi_ops->
31230Sstevel@tonic-gate 		    devo_bus_ops->bus_dma_bindhdl;
31240Sstevel@tonic-gate 		debug_dtree(devi, DEVI(devi)->devi_bus_dma_bindhdl,
31250Sstevel@tonic-gate 		    "bus_dma_bindhdl");
31260Sstevel@tonic-gate 	}
31270Sstevel@tonic-gate 
31280Sstevel@tonic-gate 	if (ddi_dma_unbindhdl == b->bus_dma_unbindhdl) {
31290Sstevel@tonic-gate 		DEVI(devi)->devi_bus_dma_unbindhdl =
31300Sstevel@tonic-gate 		    pdevi->devi_bus_dma_unbindhdl;
31310Sstevel@tonic-gate 		DEVI(devi)->devi_bus_dma_unbindfunc =
31320Sstevel@tonic-gate 		    pdevi->devi_bus_dma_unbindhdl->devi_ops->
31330Sstevel@tonic-gate 		    devo_bus_ops->bus_dma_unbindhdl;
31340Sstevel@tonic-gate 		debug_dtree(devi, DEVI(devi)->devi_bus_dma_unbindhdl,
31350Sstevel@tonic-gate 		    "bus_dma_unbindhdl");
31360Sstevel@tonic-gate 	}
31370Sstevel@tonic-gate 
31380Sstevel@tonic-gate 	if (ddi_dma_flush == b->bus_dma_flush) {
31390Sstevel@tonic-gate 		DEVI(devi)->devi_bus_dma_flush = pdevi->devi_bus_dma_flush;
31400Sstevel@tonic-gate 		debug_dtree(devi, DEVI(devi)->devi_bus_dma_flush,
31410Sstevel@tonic-gate 		    "bus_dma_flush");
31420Sstevel@tonic-gate 	}
31430Sstevel@tonic-gate 
31440Sstevel@tonic-gate 	if (ddi_dma_win == b->bus_dma_win) {
31450Sstevel@tonic-gate 		DEVI(devi)->devi_bus_dma_win = pdevi->devi_bus_dma_win;
31460Sstevel@tonic-gate 		debug_dtree(devi, DEVI(devi)->devi_bus_dma_win,
31470Sstevel@tonic-gate 		    "bus_dma_win");
31480Sstevel@tonic-gate 	}
31490Sstevel@tonic-gate 
31500Sstevel@tonic-gate 	if (ddi_dma_mctl == b->bus_dma_ctl) {
31510Sstevel@tonic-gate 		DEVI(devi)->devi_bus_dma_ctl = pdevi->devi_bus_dma_ctl;
31520Sstevel@tonic-gate 		debug_dtree(devi, DEVI(devi)->devi_bus_dma_ctl, "bus_dma_ctl");
31530Sstevel@tonic-gate 	}
31540Sstevel@tonic-gate 
31550Sstevel@tonic-gate 	if (ddi_ctlops == b->bus_ctl) {
31560Sstevel@tonic-gate 		DEVI(devi)->devi_bus_ctl = pdevi->devi_bus_ctl;
31570Sstevel@tonic-gate 		debug_dtree(devi, DEVI(devi)->devi_bus_ctl, "bus_ctl");
31580Sstevel@tonic-gate 	}
31590Sstevel@tonic-gate }
31600Sstevel@tonic-gate 
31610Sstevel@tonic-gate #define	MIN_DEVINFO_LOG_SIZE	max_ncpus
31620Sstevel@tonic-gate #define	MAX_DEVINFO_LOG_SIZE	max_ncpus * 10
31630Sstevel@tonic-gate 
31640Sstevel@tonic-gate static void
31650Sstevel@tonic-gate da_log_init()
31660Sstevel@tonic-gate {
31670Sstevel@tonic-gate 	devinfo_log_header_t *dh;
31680Sstevel@tonic-gate 	int logsize = devinfo_log_size;
31690Sstevel@tonic-gate 
31700Sstevel@tonic-gate 	if (logsize == 0)
31710Sstevel@tonic-gate 		logsize = MIN_DEVINFO_LOG_SIZE;
31720Sstevel@tonic-gate 	else if (logsize > MAX_DEVINFO_LOG_SIZE)
31730Sstevel@tonic-gate 		logsize = MAX_DEVINFO_LOG_SIZE;
31740Sstevel@tonic-gate 
31750Sstevel@tonic-gate 	dh = kmem_alloc(logsize * PAGESIZE, KM_SLEEP);
31760Sstevel@tonic-gate 	mutex_init(&dh->dh_lock, NULL, MUTEX_DEFAULT, NULL);
31770Sstevel@tonic-gate 	dh->dh_max = ((logsize * PAGESIZE) - sizeof (*dh)) /
31780Sstevel@tonic-gate 	    sizeof (devinfo_audit_t) + 1;
31790Sstevel@tonic-gate 	dh->dh_curr = -1;
31800Sstevel@tonic-gate 	dh->dh_hits = 0;
31810Sstevel@tonic-gate 
31820Sstevel@tonic-gate 	devinfo_audit_log = dh;
31830Sstevel@tonic-gate }
31840Sstevel@tonic-gate 
31850Sstevel@tonic-gate /*
31860Sstevel@tonic-gate  * Log the stack trace in per-devinfo audit structure and also enter
31870Sstevel@tonic-gate  * it into a system wide log for recording the time history.
31880Sstevel@tonic-gate  */
31890Sstevel@tonic-gate static void
31900Sstevel@tonic-gate da_log_enter(dev_info_t *dip)
31910Sstevel@tonic-gate {
31920Sstevel@tonic-gate 	devinfo_audit_t *da_log, *da = DEVI(dip)->devi_audit;
31930Sstevel@tonic-gate 	devinfo_log_header_t *dh = devinfo_audit_log;
31940Sstevel@tonic-gate 
31950Sstevel@tonic-gate 	if (devinfo_audit_log == NULL)
31960Sstevel@tonic-gate 		return;
31970Sstevel@tonic-gate 
31980Sstevel@tonic-gate 	ASSERT(da != NULL);
31990Sstevel@tonic-gate 
32000Sstevel@tonic-gate 	da->da_devinfo = dip;
32010Sstevel@tonic-gate 	da->da_timestamp = gethrtime();
32020Sstevel@tonic-gate 	da->da_thread = curthread;
32030Sstevel@tonic-gate 	da->da_node_state = DEVI(dip)->devi_node_state;
32040Sstevel@tonic-gate 	da->da_device_state = DEVI(dip)->devi_state;
32050Sstevel@tonic-gate 	da->da_depth = getpcstack(da->da_stack, DDI_STACK_DEPTH);
32060Sstevel@tonic-gate 
32070Sstevel@tonic-gate 	/*
32080Sstevel@tonic-gate 	 * Copy into common log and note the location for tracing history
32090Sstevel@tonic-gate 	 */
32100Sstevel@tonic-gate 	mutex_enter(&dh->dh_lock);
32110Sstevel@tonic-gate 	dh->dh_hits++;
32120Sstevel@tonic-gate 	dh->dh_curr++;
32130Sstevel@tonic-gate 	if (dh->dh_curr >= dh->dh_max)
32140Sstevel@tonic-gate 		dh->dh_curr -= dh->dh_max;
32150Sstevel@tonic-gate 	da_log = &dh->dh_entry[dh->dh_curr];
32160Sstevel@tonic-gate 	mutex_exit(&dh->dh_lock);
32170Sstevel@tonic-gate 
32180Sstevel@tonic-gate 	bcopy(da, da_log, sizeof (devinfo_audit_t));
32190Sstevel@tonic-gate 	da->da_lastlog = da_log;
32200Sstevel@tonic-gate }
32210Sstevel@tonic-gate 
32220Sstevel@tonic-gate static void
32230Sstevel@tonic-gate attach_drivers()
32240Sstevel@tonic-gate {
32250Sstevel@tonic-gate 	int i;
32260Sstevel@tonic-gate 	for (i = 0; i < devcnt; i++) {
32270Sstevel@tonic-gate 		struct devnames *dnp = &devnamesp[i];
32280Sstevel@tonic-gate 		if ((dnp->dn_flags & DN_FORCE_ATTACH) &&
32290Sstevel@tonic-gate 		    (ddi_hold_installed_driver((major_t)i) != NULL))
32300Sstevel@tonic-gate 			ddi_rele_driver((major_t)i);
32310Sstevel@tonic-gate 	}
32320Sstevel@tonic-gate }
32330Sstevel@tonic-gate 
32340Sstevel@tonic-gate /*
32350Sstevel@tonic-gate  * Launch a thread to force attach drivers. This avoids penalty on boot time.
32360Sstevel@tonic-gate  */
32370Sstevel@tonic-gate void
32380Sstevel@tonic-gate i_ddi_forceattach_drivers()
32390Sstevel@tonic-gate {
32400Sstevel@tonic-gate 	/*
32410Sstevel@tonic-gate 	 * On i386, the USB drivers need to load and take over from the
32420Sstevel@tonic-gate 	 * SMM BIOS drivers ASAP after consconfig(), so make sure they
32430Sstevel@tonic-gate 	 * get loaded right here rather than letting the thread do it.
32440Sstevel@tonic-gate 	 *
32450Sstevel@tonic-gate 	 * The order here is important.  EHCI must be loaded first, as
32460Sstevel@tonic-gate 	 * we have observed many systems on which hangs occur if the
32470Sstevel@tonic-gate 	 * {U,O}HCI companion controllers take over control from the BIOS
32480Sstevel@tonic-gate 	 * before EHCI does.  These hangs are also caused by BIOSes leaving
32490Sstevel@tonic-gate 	 * interrupt-on-port-change enabled in the ehci controller, so that
32500Sstevel@tonic-gate 	 * when uhci/ohci reset themselves, it induces a port change on
32510Sstevel@tonic-gate 	 * the ehci companion controller.  Since there's no interrupt handler
32520Sstevel@tonic-gate 	 * installed at the time, the moment that interrupt is unmasked, an
32530Sstevel@tonic-gate 	 * interrupt storm will occur.  All this is averted when ehci is
32540Sstevel@tonic-gate 	 * loaded first.  And now you know..... the REST of the story.
32550Sstevel@tonic-gate 	 *
32560Sstevel@tonic-gate 	 * Regardless of platform, ehci needs to initialize first to avoid
32570Sstevel@tonic-gate 	 * unnecessary connects and disconnects on the companion controller
32580Sstevel@tonic-gate 	 * when ehci sets up the routing.
32590Sstevel@tonic-gate 	 */
32600Sstevel@tonic-gate 	(void) ddi_hold_installed_driver(ddi_name_to_major("ehci"));
32610Sstevel@tonic-gate 	(void) ddi_hold_installed_driver(ddi_name_to_major("uhci"));
32620Sstevel@tonic-gate 	(void) ddi_hold_installed_driver(ddi_name_to_major("ohci"));
32630Sstevel@tonic-gate 
32641093Shiremath 	/*
32651093Shiremath 	 * Attach IB VHCI driver before the force-attach thread attaches the
32661093Shiremath 	 * IB HCA driver. IB HCA driver will fail if IB Nexus has not yet
32671093Shiremath 	 * been attached.
32681093Shiremath 	 */
32691093Shiremath 	(void) ddi_hold_installed_driver(ddi_name_to_major("ib"));
32701093Shiremath 
32710Sstevel@tonic-gate 	(void) thread_create(NULL, 0, (void (*)())attach_drivers, NULL, 0, &p0,
32720Sstevel@tonic-gate 	    TS_RUN, minclsyspri);
32730Sstevel@tonic-gate }
32740Sstevel@tonic-gate 
32750Sstevel@tonic-gate /*
32760Sstevel@tonic-gate  * This is a private DDI interface for optimizing boot performance.
32770Sstevel@tonic-gate  * I/O subsystem initialization is considered complete when devfsadm
32780Sstevel@tonic-gate  * is executed.
32790Sstevel@tonic-gate  *
32802621Sllai1  * NOTE: The start of syseventd happens to be a convenient indicator
32812621Sllai1  *	of the completion of I/O initialization during boot.
32820Sstevel@tonic-gate  *	The implementation should be replaced by something more robust.
32830Sstevel@tonic-gate  */
32840Sstevel@tonic-gate int
32850Sstevel@tonic-gate i_ddi_io_initialized()
32860Sstevel@tonic-gate {
32870Sstevel@tonic-gate 	extern int sysevent_daemon_init;
32880Sstevel@tonic-gate 	return (sysevent_daemon_init);
32890Sstevel@tonic-gate }
32900Sstevel@tonic-gate 
32912621Sllai1 /*
32922621Sllai1  * May be used to determine system boot state
32932621Sllai1  * "Available" means the system is for the most part up
32942621Sllai1  * and initialized, with all system services either up or
32952621Sllai1  * capable of being started.  This state is set by devfsadm
32962621Sllai1  * during the boot process.  The /dev filesystem infers
32972621Sllai1  * from this when implicit reconfig can be performed,
32982621Sllai1  * ie, devfsadm can be invoked.  Please avoid making
32992621Sllai1  * further use of this unless it's really necessary.
33002621Sllai1  */
33012621Sllai1 int
33022621Sllai1 i_ddi_sysavail()
33032621Sllai1 {
33042621Sllai1 	return (devname_state & DS_SYSAVAIL);
33052621Sllai1 }
33062621Sllai1 
33072621Sllai1 /*
33082621Sllai1  * May be used to determine if boot is a reconfigure boot.
33092621Sllai1  */
33102621Sllai1 int
33112621Sllai1 i_ddi_reconfig()
33122621Sllai1 {
33132621Sllai1 	return (devname_state & DS_RECONFIG);
33142621Sllai1 }
33152621Sllai1 
33162621Sllai1 /*
33172621Sllai1  * Note system services are up, inform /dev.
33182621Sllai1  */
33192621Sllai1 void
33202621Sllai1 i_ddi_set_sysavail()
33212621Sllai1 {
33222621Sllai1 	if ((devname_state & DS_SYSAVAIL) == 0) {
33232621Sllai1 		devname_state |= DS_SYSAVAIL;
33242621Sllai1 		sdev_devstate_change();
33252621Sllai1 	}
33262621Sllai1 }
33272621Sllai1 
33282621Sllai1 /*
33292621Sllai1  * Note reconfiguration boot, inform /dev.
33302621Sllai1  */
33312621Sllai1 void
33322621Sllai1 i_ddi_set_reconfig()
33332621Sllai1 {
33342621Sllai1 	if ((devname_state & DS_RECONFIG) == 0) {
33352621Sllai1 		devname_state |= DS_RECONFIG;
33362621Sllai1 		sdev_devstate_change();
33372621Sllai1 	}
33382621Sllai1 }
33392621Sllai1 
33400Sstevel@tonic-gate 
33410Sstevel@tonic-gate /*
33420Sstevel@tonic-gate  * device tree walking
33430Sstevel@tonic-gate  */
33440Sstevel@tonic-gate 
33450Sstevel@tonic-gate struct walk_elem {
33460Sstevel@tonic-gate 	struct walk_elem *next;
33470Sstevel@tonic-gate 	dev_info_t *dip;
33480Sstevel@tonic-gate };
33490Sstevel@tonic-gate 
33500Sstevel@tonic-gate static void
33510Sstevel@tonic-gate free_list(struct walk_elem *list)
33520Sstevel@tonic-gate {
33530Sstevel@tonic-gate 	while (list) {
33540Sstevel@tonic-gate 		struct walk_elem *next = list->next;
33550Sstevel@tonic-gate 		kmem_free(list, sizeof (*list));
33560Sstevel@tonic-gate 		list = next;
33570Sstevel@tonic-gate 	}
33580Sstevel@tonic-gate }
33590Sstevel@tonic-gate 
33600Sstevel@tonic-gate static void
33610Sstevel@tonic-gate append_node(struct walk_elem **list, dev_info_t *dip)
33620Sstevel@tonic-gate {
33630Sstevel@tonic-gate 	struct walk_elem *tail;
33640Sstevel@tonic-gate 	struct walk_elem *elem = kmem_alloc(sizeof (*elem), KM_SLEEP);
33650Sstevel@tonic-gate 
33660Sstevel@tonic-gate 	elem->next = NULL;
33670Sstevel@tonic-gate 	elem->dip = dip;
33680Sstevel@tonic-gate 
33690Sstevel@tonic-gate 	if (*list == NULL) {
33700Sstevel@tonic-gate 		*list = elem;
33710Sstevel@tonic-gate 		return;
33720Sstevel@tonic-gate 	}
33730Sstevel@tonic-gate 
33740Sstevel@tonic-gate 	tail = *list;
33750Sstevel@tonic-gate 	while (tail->next)
33760Sstevel@tonic-gate 		tail = tail->next;
33770Sstevel@tonic-gate 
33780Sstevel@tonic-gate 	tail->next = elem;
33790Sstevel@tonic-gate }
33800Sstevel@tonic-gate 
33810Sstevel@tonic-gate /*
33820Sstevel@tonic-gate  * The implementation of ddi_walk_devs().
33830Sstevel@tonic-gate  */
33840Sstevel@tonic-gate static int
33850Sstevel@tonic-gate walk_devs(dev_info_t *dip, int (*f)(dev_info_t *, void *), void *arg,
33860Sstevel@tonic-gate     int do_locking)
33870Sstevel@tonic-gate {
33880Sstevel@tonic-gate 	struct walk_elem *head = NULL;
33890Sstevel@tonic-gate 
33900Sstevel@tonic-gate 	/*
33910Sstevel@tonic-gate 	 * Do it in two passes. First pass invoke callback on each
33920Sstevel@tonic-gate 	 * dip on the sibling list. Second pass invoke callback on
33930Sstevel@tonic-gate 	 * children of each dip.
33940Sstevel@tonic-gate 	 */
33950Sstevel@tonic-gate 	while (dip) {
33960Sstevel@tonic-gate 		switch ((*f)(dip, arg)) {
33970Sstevel@tonic-gate 		case DDI_WALK_TERMINATE:
33980Sstevel@tonic-gate 			free_list(head);
33990Sstevel@tonic-gate 			return (DDI_WALK_TERMINATE);
34000Sstevel@tonic-gate 
34010Sstevel@tonic-gate 		case DDI_WALK_PRUNESIB:
34020Sstevel@tonic-gate 			/* ignore sibling by setting dip to NULL */
34030Sstevel@tonic-gate 			append_node(&head, dip);
34040Sstevel@tonic-gate 			dip = NULL;
34050Sstevel@tonic-gate 			break;
34060Sstevel@tonic-gate 
34070Sstevel@tonic-gate 		case DDI_WALK_PRUNECHILD:
34080Sstevel@tonic-gate 			/* don't worry about children */
34090Sstevel@tonic-gate 			dip = ddi_get_next_sibling(dip);
34100Sstevel@tonic-gate 			break;
34110Sstevel@tonic-gate 
34120Sstevel@tonic-gate 		case DDI_WALK_CONTINUE:
34130Sstevel@tonic-gate 		default:
34140Sstevel@tonic-gate 			append_node(&head, dip);
34150Sstevel@tonic-gate 			dip = ddi_get_next_sibling(dip);
34160Sstevel@tonic-gate 			break;
34170Sstevel@tonic-gate 		}
34180Sstevel@tonic-gate 
34190Sstevel@tonic-gate 	}
34200Sstevel@tonic-gate 
34210Sstevel@tonic-gate 	/* second pass */
34220Sstevel@tonic-gate 	while (head) {
34230Sstevel@tonic-gate 		int circ;
34240Sstevel@tonic-gate 		struct walk_elem *next = head->next;
34250Sstevel@tonic-gate 
34260Sstevel@tonic-gate 		if (do_locking)
34270Sstevel@tonic-gate 			ndi_devi_enter(head->dip, &circ);
34280Sstevel@tonic-gate 		if (walk_devs(ddi_get_child(head->dip), f, arg, do_locking) ==
34290Sstevel@tonic-gate 		    DDI_WALK_TERMINATE) {
34300Sstevel@tonic-gate 			if (do_locking)
34310Sstevel@tonic-gate 				ndi_devi_exit(head->dip, circ);
34320Sstevel@tonic-gate 			free_list(head);
34330Sstevel@tonic-gate 			return (DDI_WALK_TERMINATE);
34340Sstevel@tonic-gate 		}
34350Sstevel@tonic-gate 		if (do_locking)
34360Sstevel@tonic-gate 			ndi_devi_exit(head->dip, circ);
34370Sstevel@tonic-gate 		kmem_free(head, sizeof (*head));
34380Sstevel@tonic-gate 		head = next;
34390Sstevel@tonic-gate 	}
34400Sstevel@tonic-gate 
34410Sstevel@tonic-gate 	return (DDI_WALK_CONTINUE);
34420Sstevel@tonic-gate }
34430Sstevel@tonic-gate 
34440Sstevel@tonic-gate /*
34450Sstevel@tonic-gate  * This general-purpose routine traverses the tree of dev_info nodes,
34460Sstevel@tonic-gate  * starting from the given node, and calls the given function for each
34470Sstevel@tonic-gate  * node that it finds with the current node and the pointer arg (which
34480Sstevel@tonic-gate  * can point to a structure of information that the function
34490Sstevel@tonic-gate  * needs) as arguments.
34500Sstevel@tonic-gate  *
34510Sstevel@tonic-gate  * It does the walk a layer at a time, not depth-first. The given function
34520Sstevel@tonic-gate  * must return one of the following values:
34530Sstevel@tonic-gate  *	DDI_WALK_CONTINUE
34540Sstevel@tonic-gate  *	DDI_WALK_PRUNESIB
34550Sstevel@tonic-gate  *	DDI_WALK_PRUNECHILD
34560Sstevel@tonic-gate  *	DDI_WALK_TERMINATE
34570Sstevel@tonic-gate  *
34580Sstevel@tonic-gate  * N.B. Since we walk the sibling list, the caller must ensure that
34590Sstevel@tonic-gate  *	the parent of dip is held against changes, unless the parent
34600Sstevel@tonic-gate  *	is rootnode.  ndi_devi_enter() on the parent is sufficient.
34610Sstevel@tonic-gate  *
34620Sstevel@tonic-gate  *	To avoid deadlock situations, caller must not attempt to
34630Sstevel@tonic-gate  *	configure/unconfigure/remove device node in (*f)(), nor should
34642155Scth  *	it attempt to recurse on other nodes in the system. Any
34652155Scth  *	ndi_devi_enter() done by (*f)() must occur 'at-or-below' the
34662155Scth  *	node entered prior to ddi_walk_devs(). Furthermore, if (*f)()
34672155Scth  *	does any multi-threading (in framework *or* in driver) then the
34682155Scth  *	ndi_devi_enter() calls done by dependent threads must be
34692155Scth  *	'strictly-below'.
34700Sstevel@tonic-gate  *
34710Sstevel@tonic-gate  *	This is not callable from device autoconfiguration routines.
34720Sstevel@tonic-gate  *	They include, but not limited to, _init(9e), _fini(9e), probe(9e),
34730Sstevel@tonic-gate  *	attach(9e), and detach(9e).
34740Sstevel@tonic-gate  */
34750Sstevel@tonic-gate 
34760Sstevel@tonic-gate void
34770Sstevel@tonic-gate ddi_walk_devs(dev_info_t *dip, int (*f)(dev_info_t *, void *), void *arg)
34780Sstevel@tonic-gate {
34790Sstevel@tonic-gate 
34800Sstevel@tonic-gate 	ASSERT(dip == NULL || ddi_get_parent(dip) == NULL ||
34814950Scth 	    DEVI_BUSY_OWNED(ddi_get_parent(dip)));
34820Sstevel@tonic-gate 
34830Sstevel@tonic-gate 	(void) walk_devs(dip, f, arg, 1);
34840Sstevel@tonic-gate }
34850Sstevel@tonic-gate 
34860Sstevel@tonic-gate /*
34870Sstevel@tonic-gate  * This is a general-purpose routine traverses the per-driver list
34880Sstevel@tonic-gate  * and calls the given function for each node. must return one of
34890Sstevel@tonic-gate  * the following values:
34900Sstevel@tonic-gate  *	DDI_WALK_CONTINUE
34910Sstevel@tonic-gate  *	DDI_WALK_TERMINATE
34920Sstevel@tonic-gate  *
34930Sstevel@tonic-gate  * N.B. The same restrictions from ddi_walk_devs() apply.
34940Sstevel@tonic-gate  */
34950Sstevel@tonic-gate 
34960Sstevel@tonic-gate void
34970Sstevel@tonic-gate e_ddi_walk_driver(char *drv, int (*f)(dev_info_t *, void *), void *arg)
34980Sstevel@tonic-gate {
34990Sstevel@tonic-gate 	major_t major;
35000Sstevel@tonic-gate 	struct devnames *dnp;
35010Sstevel@tonic-gate 	dev_info_t *dip;
35020Sstevel@tonic-gate 
35030Sstevel@tonic-gate 	major = ddi_name_to_major(drv);
35047009Scth 	if (major == DDI_MAJOR_T_NONE)
35050Sstevel@tonic-gate 		return;
35060Sstevel@tonic-gate 
35070Sstevel@tonic-gate 	dnp = &devnamesp[major];
35080Sstevel@tonic-gate 	LOCK_DEV_OPS(&dnp->dn_lock);
35090Sstevel@tonic-gate 	dip = dnp->dn_head;
35100Sstevel@tonic-gate 	while (dip) {
35110Sstevel@tonic-gate 		ndi_hold_devi(dip);
35120Sstevel@tonic-gate 		UNLOCK_DEV_OPS(&dnp->dn_lock);
35130Sstevel@tonic-gate 		if ((*f)(dip, arg) == DDI_WALK_TERMINATE) {
35140Sstevel@tonic-gate 			ndi_rele_devi(dip);
35150Sstevel@tonic-gate 			return;
35160Sstevel@tonic-gate 		}
35170Sstevel@tonic-gate 		LOCK_DEV_OPS(&dnp->dn_lock);
35180Sstevel@tonic-gate 		ndi_rele_devi(dip);
35190Sstevel@tonic-gate 		dip = ddi_get_next(dip);
35200Sstevel@tonic-gate 	}
35210Sstevel@tonic-gate 	UNLOCK_DEV_OPS(&dnp->dn_lock);
35220Sstevel@tonic-gate }
35230Sstevel@tonic-gate 
35240Sstevel@tonic-gate /*
35250Sstevel@tonic-gate  * argument to i_find_devi, a devinfo node search callback function.
35260Sstevel@tonic-gate  */
35270Sstevel@tonic-gate struct match_info {
35280Sstevel@tonic-gate 	dev_info_t	*dip;		/* result */
35290Sstevel@tonic-gate 	char		*nodename;	/* if non-null, nodename must match */
35300Sstevel@tonic-gate 	int		instance;	/* if != -1, instance must match */
35311333Scth 	int		attached;	/* if != 0, i_ddi_devi_attached() */
35320Sstevel@tonic-gate };
35330Sstevel@tonic-gate 
35340Sstevel@tonic-gate static int
35350Sstevel@tonic-gate i_find_devi(dev_info_t *dip, void *arg)
35360Sstevel@tonic-gate {
35370Sstevel@tonic-gate 	struct match_info *info = (struct match_info *)arg;
35380Sstevel@tonic-gate 
35390Sstevel@tonic-gate 	if (((info->nodename == NULL) ||
35404950Scth 	    (strcmp(ddi_node_name(dip), info->nodename) == 0)) &&
35410Sstevel@tonic-gate 	    ((info->instance == -1) ||
35424950Scth 	    (ddi_get_instance(dip) == info->instance)) &&
35431333Scth 	    ((info->attached == 0) || i_ddi_devi_attached(dip))) {
35440Sstevel@tonic-gate 		info->dip = dip;
35450Sstevel@tonic-gate 		ndi_hold_devi(dip);
35460Sstevel@tonic-gate 		return (DDI_WALK_TERMINATE);
35470Sstevel@tonic-gate 	}
35480Sstevel@tonic-gate 
35490Sstevel@tonic-gate 	return (DDI_WALK_CONTINUE);
35500Sstevel@tonic-gate }
35510Sstevel@tonic-gate 
35520Sstevel@tonic-gate /*
35530Sstevel@tonic-gate  * Find dip with a known node name and instance and return with it held
35540Sstevel@tonic-gate  */
35550Sstevel@tonic-gate dev_info_t *
35560Sstevel@tonic-gate ddi_find_devinfo(char *nodename, int instance, int attached)
35570Sstevel@tonic-gate {
35580Sstevel@tonic-gate 	struct match_info	info;
35590Sstevel@tonic-gate 
35600Sstevel@tonic-gate 	info.nodename = nodename;
35610Sstevel@tonic-gate 	info.instance = instance;
35620Sstevel@tonic-gate 	info.attached = attached;
35630Sstevel@tonic-gate 	info.dip = NULL;
35640Sstevel@tonic-gate 
35650Sstevel@tonic-gate 	ddi_walk_devs(ddi_root_node(), i_find_devi, &info);
35660Sstevel@tonic-gate 	return (info.dip);
35670Sstevel@tonic-gate }
35680Sstevel@tonic-gate 
35690Sstevel@tonic-gate /*
35700Sstevel@tonic-gate  * Parse for name, addr, and minor names. Some args may be NULL.
35710Sstevel@tonic-gate  */
35720Sstevel@tonic-gate void
35730Sstevel@tonic-gate i_ddi_parse_name(char *name, char **nodename, char **addrname, char **minorname)
35740Sstevel@tonic-gate {
35750Sstevel@tonic-gate 	char *cp;
35760Sstevel@tonic-gate 	static char nulladdrname[] = "";
35770Sstevel@tonic-gate 
35780Sstevel@tonic-gate 	/* default values */
35790Sstevel@tonic-gate 	if (nodename)
35800Sstevel@tonic-gate 		*nodename = name;
35810Sstevel@tonic-gate 	if (addrname)
35820Sstevel@tonic-gate 		*addrname = nulladdrname;
35830Sstevel@tonic-gate 	if (minorname)
35840Sstevel@tonic-gate 		*minorname = NULL;
35850Sstevel@tonic-gate 
35860Sstevel@tonic-gate 	cp = name;
35870Sstevel@tonic-gate 	while (*cp != '\0') {
35880Sstevel@tonic-gate 		if (addrname && *cp == '@') {
35890Sstevel@tonic-gate 			*addrname = cp + 1;
35900Sstevel@tonic-gate 			*cp = '\0';
35910Sstevel@tonic-gate 		} else if (minorname && *cp == ':') {
35920Sstevel@tonic-gate 			*minorname = cp + 1;
35930Sstevel@tonic-gate 			*cp = '\0';
35940Sstevel@tonic-gate 		}
35950Sstevel@tonic-gate 		++cp;
35960Sstevel@tonic-gate 	}
35970Sstevel@tonic-gate }
35980Sstevel@tonic-gate 
35990Sstevel@tonic-gate static char *
36000Sstevel@tonic-gate child_path_to_driver(dev_info_t *parent, char *child_name, char *unit_address)
36010Sstevel@tonic-gate {
36020Sstevel@tonic-gate 	char *p, *drvname = NULL;
36030Sstevel@tonic-gate 	major_t maj;
36040Sstevel@tonic-gate 
36050Sstevel@tonic-gate 	/*
36060Sstevel@tonic-gate 	 * Construct the pathname and ask the implementation
36070Sstevel@tonic-gate 	 * if it can do a driver = f(pathname) for us, if not
36080Sstevel@tonic-gate 	 * we'll just default to using the node-name that
36090Sstevel@tonic-gate 	 * was given to us.  We want to do this first to
36100Sstevel@tonic-gate 	 * allow the platform to use 'generic' names for
36110Sstevel@tonic-gate 	 * legacy device drivers.
36120Sstevel@tonic-gate 	 */
36130Sstevel@tonic-gate 	p = kmem_zalloc(MAXPATHLEN, KM_SLEEP);
36140Sstevel@tonic-gate 	(void) ddi_pathname(parent, p);
36150Sstevel@tonic-gate 	(void) strcat(p, "/");
36160Sstevel@tonic-gate 	(void) strcat(p, child_name);
36170Sstevel@tonic-gate 	if (unit_address && *unit_address) {
36180Sstevel@tonic-gate 		(void) strcat(p, "@");
36190Sstevel@tonic-gate 		(void) strcat(p, unit_address);
36200Sstevel@tonic-gate 	}
36210Sstevel@tonic-gate 
36220Sstevel@tonic-gate 	/*
36230Sstevel@tonic-gate 	 * Get the binding. If there is none, return the child_name
36240Sstevel@tonic-gate 	 * and let the caller deal with it.
36250Sstevel@tonic-gate 	 */
36260Sstevel@tonic-gate 	maj = path_to_major(p);
36270Sstevel@tonic-gate 
36280Sstevel@tonic-gate 	kmem_free(p, MAXPATHLEN);
36290Sstevel@tonic-gate 
36307009Scth 	if (maj != DDI_MAJOR_T_NONE)
36310Sstevel@tonic-gate 		drvname = ddi_major_to_name(maj);
36320Sstevel@tonic-gate 	if (drvname == NULL)
36330Sstevel@tonic-gate 		drvname = child_name;
36340Sstevel@tonic-gate 
36350Sstevel@tonic-gate 	return (drvname);
36360Sstevel@tonic-gate }
36370Sstevel@tonic-gate 
36380Sstevel@tonic-gate 
36397613SVikram.Hegde@Sun.COM #define	PCI_EX_CLASS	"pciexclass"
36407613SVikram.Hegde@Sun.COM #define	PCI_EX		"pciex"
36417613SVikram.Hegde@Sun.COM #define	PCI_CLASS	"pciclass"
36427613SVikram.Hegde@Sun.COM #define	PCI		"pci"
36437613SVikram.Hegde@Sun.COM 
36447613SVikram.Hegde@Sun.COM int
36457613SVikram.Hegde@Sun.COM ddi_is_pci_dip(dev_info_t *dip)
36467613SVikram.Hegde@Sun.COM {
36477613SVikram.Hegde@Sun.COM 	char	*prop = NULL;
36487613SVikram.Hegde@Sun.COM 
36497613SVikram.Hegde@Sun.COM 	if (ddi_prop_lookup_string(DDI_DEV_T_ANY, dip, DDI_PROP_DONTPASS,
36507613SVikram.Hegde@Sun.COM 	    "compatible", &prop) == DDI_PROP_SUCCESS) {
36517613SVikram.Hegde@Sun.COM 		ASSERT(prop);
36527613SVikram.Hegde@Sun.COM 		if (strncmp(prop, PCI_EX_CLASS, sizeof (PCI_EX_CLASS) - 1)
36537613SVikram.Hegde@Sun.COM 		    == 0 ||
36547613SVikram.Hegde@Sun.COM 		    strncmp(prop, PCI_EX, sizeof (PCI_EX)- 1)
36557613SVikram.Hegde@Sun.COM 		    == 0 ||
36567613SVikram.Hegde@Sun.COM 		    strncmp(prop, PCI_CLASS, sizeof (PCI_CLASS) - 1)
36577613SVikram.Hegde@Sun.COM 		    == 0 ||
36587613SVikram.Hegde@Sun.COM 		    strncmp(prop, PCI, sizeof (PCI) - 1)
36597613SVikram.Hegde@Sun.COM 		    == 0) {
36607613SVikram.Hegde@Sun.COM 			ddi_prop_free(prop);
36617613SVikram.Hegde@Sun.COM 			return (1);
36627613SVikram.Hegde@Sun.COM 		}
36637613SVikram.Hegde@Sun.COM 	}
36647613SVikram.Hegde@Sun.COM 
36657613SVikram.Hegde@Sun.COM 	if (prop != NULL) {
36667613SVikram.Hegde@Sun.COM 		ddi_prop_free(prop);
36677613SVikram.Hegde@Sun.COM 	}
36687613SVikram.Hegde@Sun.COM 
36697613SVikram.Hegde@Sun.COM 	return (0);
36707613SVikram.Hegde@Sun.COM }
36717613SVikram.Hegde@Sun.COM 
36720Sstevel@tonic-gate /*
36730Sstevel@tonic-gate  * Given the pathname of a device, fill in the dev_info_t value and/or the
36740Sstevel@tonic-gate  * dev_t value and/or the spectype, depending on which parameters are non-NULL.
36750Sstevel@tonic-gate  * If there is an error, this function returns -1.
36760Sstevel@tonic-gate  *
36770Sstevel@tonic-gate  * NOTE: If this function returns the dev_info_t structure, then it
36780Sstevel@tonic-gate  * does so with a hold on the devi. Caller should ensure that they get
36790Sstevel@tonic-gate  * decremented via ddi_release_devi() or ndi_rele_devi();
36800Sstevel@tonic-gate  *
36810Sstevel@tonic-gate  * This function can be invoked in the boot case for a pathname without
36820Sstevel@tonic-gate  * device argument (:xxxx), traditionally treated as a minor name.
36830Sstevel@tonic-gate  * In this case, we do the following
36840Sstevel@tonic-gate  * (1) search the minor node of type DDM_DEFAULT.
36850Sstevel@tonic-gate  * (2) if no DDM_DEFAULT minor exists, then the first non-alias minor is chosen.
36860Sstevel@tonic-gate  * (3) if neither exists, a dev_t is faked with minor number = instance.
36870Sstevel@tonic-gate  * As of S9 FCS, no instance of #1 exists. #2 is used by several platforms
36880Sstevel@tonic-gate  * to default the boot partition to :a possibly by other OBP definitions.
36890Sstevel@tonic-gate  * #3 is used for booting off network interfaces, most SPARC network
36900Sstevel@tonic-gate  * drivers support Style-2 only, so only DDM_ALIAS minor exists.
36910Sstevel@tonic-gate  *
36920Sstevel@tonic-gate  * It is possible for OBP to present device args at the end of the path as
36930Sstevel@tonic-gate  * well as in the middle. For example, with IB the following strings are
36940Sstevel@tonic-gate  * valid boot paths.
36950Sstevel@tonic-gate  *	a /pci@8,700000/ib@1,2:port=1,pkey=ff,dhcp,...
36960Sstevel@tonic-gate  *	b /pci@8,700000/ib@1,1:port=1/ioc@xxxxxx,yyyyyyy:dhcp
36970Sstevel@tonic-gate  * Case (a), we first look for minor node "port=1,pkey...".
36980Sstevel@tonic-gate  * Failing that, we will pass "port=1,pkey..." to the bus_config
36990Sstevel@tonic-gate  * entry point of ib (HCA) driver.
37000Sstevel@tonic-gate  * Case (b), configure ib@1,1 as usual. Then invoke ib's bus_config
37010Sstevel@tonic-gate  * with argument "ioc@xxxxxxx,yyyyyyy:port=1". After configuring
37020Sstevel@tonic-gate  * the ioc, look for minor node dhcp. If not found, pass ":dhcp"
37030Sstevel@tonic-gate  * to ioc's bus_config entry point.
37040Sstevel@tonic-gate  */
37057613SVikram.Hegde@Sun.COM static int
37067613SVikram.Hegde@Sun.COM parse_pathname(char *pathname,
37077613SVikram.Hegde@Sun.COM 	dev_info_t **dipp, dev_t *devtp, int *spectypep, dev_info_t **pci_dipp)
37080Sstevel@tonic-gate {
37097224Scth 	int			error;
37107224Scth 	dev_info_t		*parent, *child;
37117224Scth 	struct pathname		pn;
37127224Scth 	char			*component, *config_name;
37137224Scth 	char			*minorname = NULL;
37147224Scth 	char			*prev_minor = NULL;
37157224Scth 	dev_t			devt = NODEV;
37167224Scth 	int			spectype;
37177224Scth 	struct ddi_minor_data	*dmn;
37187224Scth 	int			circ;
37190Sstevel@tonic-gate 
37207613SVikram.Hegde@Sun.COM 	if (pci_dipp)
37217613SVikram.Hegde@Sun.COM 		*pci_dipp = NULL;
37227613SVikram.Hegde@Sun.COM 
37230Sstevel@tonic-gate 	if (*pathname != '/')
37240Sstevel@tonic-gate 		return (EINVAL);
37250Sstevel@tonic-gate 	parent = ddi_root_node();	/* Begin at the top of the tree */
37260Sstevel@tonic-gate 
37270Sstevel@tonic-gate 	if (error = pn_get(pathname, UIO_SYSSPACE, &pn))
37280Sstevel@tonic-gate 		return (error);
37290Sstevel@tonic-gate 	pn_skipslash(&pn);
37300Sstevel@tonic-gate 
37311333Scth 	ASSERT(i_ddi_devi_attached(parent));
37320Sstevel@tonic-gate 	ndi_hold_devi(parent);
37330Sstevel@tonic-gate 
37340Sstevel@tonic-gate 	component = kmem_alloc(MAXNAMELEN, KM_SLEEP);
37350Sstevel@tonic-gate 	config_name = kmem_alloc(MAXNAMELEN, KM_SLEEP);
37360Sstevel@tonic-gate 
37370Sstevel@tonic-gate 	while (pn_pathleft(&pn)) {
37380Sstevel@tonic-gate 		/* remember prev minor (:xxx) in the middle of path */
37390Sstevel@tonic-gate 		if (minorname)
37400Sstevel@tonic-gate 			prev_minor = i_ddi_strdup(minorname, KM_SLEEP);
37410Sstevel@tonic-gate 
37420Sstevel@tonic-gate 		/* Get component and chop off minorname */
37430Sstevel@tonic-gate 		(void) pn_getcomponent(&pn, component);
37440Sstevel@tonic-gate 		i_ddi_parse_name(component, NULL, NULL, &minorname);
37450Sstevel@tonic-gate 
37460Sstevel@tonic-gate 		if (prev_minor == NULL) {
37470Sstevel@tonic-gate 			(void) snprintf(config_name, MAXNAMELEN, "%s",
37480Sstevel@tonic-gate 			    component);
37490Sstevel@tonic-gate 		} else {
37500Sstevel@tonic-gate 			(void) snprintf(config_name, MAXNAMELEN, "%s:%s",
37510Sstevel@tonic-gate 			    component, prev_minor);
37520Sstevel@tonic-gate 			kmem_free(prev_minor, strlen(prev_minor) + 1);
37530Sstevel@tonic-gate 			prev_minor = NULL;
37540Sstevel@tonic-gate 		}
37550Sstevel@tonic-gate 
37560Sstevel@tonic-gate 		/*
37570Sstevel@tonic-gate 		 * Find and configure the child
37580Sstevel@tonic-gate 		 */
37590Sstevel@tonic-gate 		if (ndi_devi_config_one(parent, config_name, &child,
37600Sstevel@tonic-gate 		    NDI_PROMNAME | NDI_NO_EVENT) != NDI_SUCCESS) {
37610Sstevel@tonic-gate 			ndi_rele_devi(parent);
37620Sstevel@tonic-gate 			pn_free(&pn);
37630Sstevel@tonic-gate 			kmem_free(component, MAXNAMELEN);
37640Sstevel@tonic-gate 			kmem_free(config_name, MAXNAMELEN);
37657613SVikram.Hegde@Sun.COM 			if (pci_dipp && *pci_dipp) {
37667613SVikram.Hegde@Sun.COM 				ndi_rele_devi(*pci_dipp);
37677613SVikram.Hegde@Sun.COM 				*pci_dipp = NULL;
37687613SVikram.Hegde@Sun.COM 			}
37690Sstevel@tonic-gate 			return (-1);
37700Sstevel@tonic-gate 		}
37710Sstevel@tonic-gate 
37721333Scth 		ASSERT(i_ddi_devi_attached(child));
37730Sstevel@tonic-gate 		ndi_rele_devi(parent);
37740Sstevel@tonic-gate 		parent = child;
37750Sstevel@tonic-gate 		pn_skipslash(&pn);
37767613SVikram.Hegde@Sun.COM 		if (pci_dipp) {
37777613SVikram.Hegde@Sun.COM 			if (ddi_is_pci_dip(child)) {
37787613SVikram.Hegde@Sun.COM 				ndi_hold_devi(child);
37797613SVikram.Hegde@Sun.COM 				if (*pci_dipp != NULL) {
37807613SVikram.Hegde@Sun.COM 					ndi_rele_devi(*pci_dipp);
37817613SVikram.Hegde@Sun.COM 				}
37827613SVikram.Hegde@Sun.COM 				*pci_dipp = child;
37837613SVikram.Hegde@Sun.COM 			}
37847613SVikram.Hegde@Sun.COM 		}
37850Sstevel@tonic-gate 	}
37860Sstevel@tonic-gate 
37870Sstevel@tonic-gate 	/*
37880Sstevel@tonic-gate 	 * First look for a minor node matching minorname.
37890Sstevel@tonic-gate 	 * Failing that, try to pass minorname to bus_config().
37900Sstevel@tonic-gate 	 */
37910Sstevel@tonic-gate 	if (minorname && i_ddi_minorname_to_devtspectype(parent,
37920Sstevel@tonic-gate 	    minorname, &devt, &spectype) == DDI_FAILURE) {
37930Sstevel@tonic-gate 		(void) snprintf(config_name, MAXNAMELEN, "%s", minorname);
37940Sstevel@tonic-gate 		if (ndi_devi_config_obp_args(parent,
37950Sstevel@tonic-gate 		    config_name, &child, 0) != NDI_SUCCESS) {
37960Sstevel@tonic-gate 			ndi_rele_devi(parent);
37970Sstevel@tonic-gate 			pn_free(&pn);
37980Sstevel@tonic-gate 			kmem_free(component, MAXNAMELEN);
37990Sstevel@tonic-gate 			kmem_free(config_name, MAXNAMELEN);
38000Sstevel@tonic-gate 			NDI_CONFIG_DEBUG((CE_NOTE,
38010Sstevel@tonic-gate 			    "%s: minor node not found\n", pathname));
38027613SVikram.Hegde@Sun.COM 			if (pci_dipp && *pci_dipp) {
38037613SVikram.Hegde@Sun.COM 				ndi_rele_devi(*pci_dipp);
38047613SVikram.Hegde@Sun.COM 				*pci_dipp = NULL;
38057613SVikram.Hegde@Sun.COM 			}
38060Sstevel@tonic-gate 			return (-1);
38070Sstevel@tonic-gate 		}
38080Sstevel@tonic-gate 		minorname = NULL;	/* look for default minor */
38091333Scth 		ASSERT(i_ddi_devi_attached(child));
38100Sstevel@tonic-gate 		ndi_rele_devi(parent);
38110Sstevel@tonic-gate 		parent = child;
38120Sstevel@tonic-gate 	}
38130Sstevel@tonic-gate 
38140Sstevel@tonic-gate 	if (devtp || spectypep) {
38150Sstevel@tonic-gate 		if (minorname == NULL) {
38167224Scth 			/*
38177224Scth 			 * Search for a default entry with an active
38187224Scth 			 * ndi_devi_enter to protect the devi_minor list.
38197224Scth 			 */
38207224Scth 			ndi_devi_enter(parent, &circ);
38210Sstevel@tonic-gate 			for (dmn = DEVI(parent)->devi_minor; dmn;
38220Sstevel@tonic-gate 			    dmn = dmn->next) {
38230Sstevel@tonic-gate 				if (dmn->type == DDM_DEFAULT) {
38240Sstevel@tonic-gate 					devt = dmn->ddm_dev;
38250Sstevel@tonic-gate 					spectype = dmn->ddm_spec_type;
38260Sstevel@tonic-gate 					break;
38270Sstevel@tonic-gate 				}
38280Sstevel@tonic-gate 			}
38290Sstevel@tonic-gate 
38300Sstevel@tonic-gate 			if (devt == NODEV) {
38310Sstevel@tonic-gate 				/*
38320Sstevel@tonic-gate 				 * No default minor node, try the first one;
38330Sstevel@tonic-gate 				 * else, assume 1-1 instance-minor mapping
38340Sstevel@tonic-gate 				 */
38350Sstevel@tonic-gate 				dmn = DEVI(parent)->devi_minor;
38360Sstevel@tonic-gate 				if (dmn && ((dmn->type == DDM_MINOR) ||
38370Sstevel@tonic-gate 				    (dmn->type == DDM_INTERNAL_PATH))) {
38380Sstevel@tonic-gate 					devt = dmn->ddm_dev;
38390Sstevel@tonic-gate 					spectype = dmn->ddm_spec_type;
38400Sstevel@tonic-gate 				} else {
38410Sstevel@tonic-gate 					devt = makedevice(
38420Sstevel@tonic-gate 					    DEVI(parent)->devi_major,
38430Sstevel@tonic-gate 					    ddi_get_instance(parent));
38440Sstevel@tonic-gate 					spectype = S_IFCHR;
38450Sstevel@tonic-gate 				}
38460Sstevel@tonic-gate 			}
38477224Scth 			ndi_devi_exit(parent, circ);
38480Sstevel@tonic-gate 		}
38490Sstevel@tonic-gate 		if (devtp)
38500Sstevel@tonic-gate 			*devtp = devt;
38510Sstevel@tonic-gate 		if (spectypep)
38520Sstevel@tonic-gate 			*spectypep = spectype;
38530Sstevel@tonic-gate 	}
38540Sstevel@tonic-gate 
38550Sstevel@tonic-gate 	pn_free(&pn);
38560Sstevel@tonic-gate 	kmem_free(component, MAXNAMELEN);
38570Sstevel@tonic-gate 	kmem_free(config_name, MAXNAMELEN);
38580Sstevel@tonic-gate 
38590Sstevel@tonic-gate 	/*
38600Sstevel@tonic-gate 	 * If there is no error, return the appropriate parameters
38610Sstevel@tonic-gate 	 */
38620Sstevel@tonic-gate 	if (dipp != NULL)
38630Sstevel@tonic-gate 		*dipp = parent;
38647613SVikram.Hegde@Sun.COM 	else if (pci_dipp == NULL) {
38650Sstevel@tonic-gate 		/*
38660Sstevel@tonic-gate 		 * We should really keep the ref count to keep the node from
38670Sstevel@tonic-gate 		 * detaching but ddi_pathname_to_dev_t() specifies a NULL dipp,
38680Sstevel@tonic-gate 		 * so we have no way of passing back the held dip.  Not holding
38690Sstevel@tonic-gate 		 * the dip allows detaches to occur - which can cause problems
38700Sstevel@tonic-gate 		 * for subsystems which call ddi_pathname_to_dev_t (console).
38710Sstevel@tonic-gate 		 *
38720Sstevel@tonic-gate 		 * Instead of holding the dip, we place a ddi-no-autodetach
38730Sstevel@tonic-gate 		 * property on the node to prevent auto detaching.
38740Sstevel@tonic-gate 		 *
38750Sstevel@tonic-gate 		 * The right fix is to remove ddi_pathname_to_dev_t and replace
38760Sstevel@tonic-gate 		 * it, and all references, with a call that specifies a dipp.
38770Sstevel@tonic-gate 		 * In addition, the callers of this new interfaces would then
38780Sstevel@tonic-gate 		 * need to call ndi_rele_devi when the reference is complete.
38797613SVikram.Hegde@Sun.COM 		 *
38807613SVikram.Hegde@Sun.COM 		 * NOTE: If pci_dipp is non-NULL we are only interested
38817613SVikram.Hegde@Sun.COM 		 * in the PCI parent which is returned held. No need to hold
38827613SVikram.Hegde@Sun.COM 		 * the leaf dip.
38830Sstevel@tonic-gate 		 */
38840Sstevel@tonic-gate 		(void) ddi_prop_update_int(DDI_DEV_T_NONE, parent,
38850Sstevel@tonic-gate 		    DDI_NO_AUTODETACH, 1);
38860Sstevel@tonic-gate 		ndi_rele_devi(parent);
38870Sstevel@tonic-gate 	}
38880Sstevel@tonic-gate 
38890Sstevel@tonic-gate 	return (0);
38900Sstevel@tonic-gate }
38910Sstevel@tonic-gate 
38927613SVikram.Hegde@Sun.COM int
38937613SVikram.Hegde@Sun.COM resolve_pathname(char *pathname,
38947613SVikram.Hegde@Sun.COM 	dev_info_t **dipp, dev_t *devtp, int *spectypep)
38957613SVikram.Hegde@Sun.COM {
38967613SVikram.Hegde@Sun.COM 	return (parse_pathname(pathname, dipp, devtp, spectypep, NULL));
38977613SVikram.Hegde@Sun.COM }
38987613SVikram.Hegde@Sun.COM 
38997613SVikram.Hegde@Sun.COM int
39007613SVikram.Hegde@Sun.COM ddi_find_pci_parent(char *pathname, dev_info_t **pci_dipp)
39017613SVikram.Hegde@Sun.COM {
39027613SVikram.Hegde@Sun.COM 	return (parse_pathname(pathname, NULL, NULL, NULL, pci_dipp));
39037613SVikram.Hegde@Sun.COM }
39047613SVikram.Hegde@Sun.COM 
39050Sstevel@tonic-gate /*
39060Sstevel@tonic-gate  * Given the pathname of a device, return the dev_t of the corresponding
39070Sstevel@tonic-gate  * device.  Returns NODEV on failure.
39080Sstevel@tonic-gate  *
39090Sstevel@tonic-gate  * Note that this call sets the DDI_NO_AUTODETACH property on the devinfo node.
39100Sstevel@tonic-gate  */
39110Sstevel@tonic-gate dev_t
39120Sstevel@tonic-gate ddi_pathname_to_dev_t(char *pathname)
39130Sstevel@tonic-gate {
39140Sstevel@tonic-gate 	dev_t devt;
39150Sstevel@tonic-gate 	int error;
39160Sstevel@tonic-gate 
39170Sstevel@tonic-gate 	error = resolve_pathname(pathname, NULL, &devt, NULL);
39180Sstevel@tonic-gate 
39190Sstevel@tonic-gate 	return (error ? NODEV : devt);
39200Sstevel@tonic-gate }
39210Sstevel@tonic-gate 
39220Sstevel@tonic-gate /*
39230Sstevel@tonic-gate  * Translate a prom pathname to kernel devfs pathname.
39240Sstevel@tonic-gate  * Caller is assumed to allocate devfspath memory of
39250Sstevel@tonic-gate  * size at least MAXPATHLEN
39260Sstevel@tonic-gate  *
39270Sstevel@tonic-gate  * The prom pathname may not include minor name, but
39280Sstevel@tonic-gate  * devfs pathname has a minor name portion.
39290Sstevel@tonic-gate  */
39300Sstevel@tonic-gate int
39310Sstevel@tonic-gate i_ddi_prompath_to_devfspath(char *prompath, char *devfspath)
39320Sstevel@tonic-gate {
39330Sstevel@tonic-gate 	dev_t		devt = (dev_t)NODEV;
39340Sstevel@tonic-gate 	dev_info_t	*dip = NULL;
39350Sstevel@tonic-gate 	char		*minor_name = NULL;
39360Sstevel@tonic-gate 	int		spectype;
39370Sstevel@tonic-gate 	int		error;
39387224Scth 	int		circ;
39390Sstevel@tonic-gate 
39400Sstevel@tonic-gate 	error = resolve_pathname(prompath, &dip, &devt, &spectype);
39410Sstevel@tonic-gate 	if (error)
39420Sstevel@tonic-gate 		return (DDI_FAILURE);
39430Sstevel@tonic-gate 	ASSERT(dip && devt != NODEV);
39440Sstevel@tonic-gate 
39450Sstevel@tonic-gate 	/*
39460Sstevel@tonic-gate 	 * Get in-kernel devfs pathname
39470Sstevel@tonic-gate 	 */
39480Sstevel@tonic-gate 	(void) ddi_pathname(dip, devfspath);
39490Sstevel@tonic-gate 
39507224Scth 	ndi_devi_enter(dip, &circ);
39510Sstevel@tonic-gate 	minor_name = i_ddi_devtspectype_to_minorname(dip, devt, spectype);
39520Sstevel@tonic-gate 	if (minor_name) {
39530Sstevel@tonic-gate 		(void) strcat(devfspath, ":");
39540Sstevel@tonic-gate 		(void) strcat(devfspath, minor_name);
39550Sstevel@tonic-gate 	} else {
39560Sstevel@tonic-gate 		/*
39570Sstevel@tonic-gate 		 * If minor_name is NULL, we have an alias minor node.
39580Sstevel@tonic-gate 		 * So manufacture a path to the corresponding clone minor.
39590Sstevel@tonic-gate 		 */
39600Sstevel@tonic-gate 		(void) snprintf(devfspath, MAXPATHLEN, "%s:%s",
39610Sstevel@tonic-gate 		    CLONE_PATH, ddi_driver_name(dip));
39620Sstevel@tonic-gate 	}
39637224Scth 	ndi_devi_exit(dip, circ);
39640Sstevel@tonic-gate 
39650Sstevel@tonic-gate 	/* release hold from resolve_pathname() */
39660Sstevel@tonic-gate 	ndi_rele_devi(dip);
39670Sstevel@tonic-gate 	return (0);
39680Sstevel@tonic-gate }
39690Sstevel@tonic-gate 
39700Sstevel@tonic-gate /*
39717656SSherry.Moore@Sun.COM  * This function is intended to identify drivers that must quiesce for fast
39727656SSherry.Moore@Sun.COM  * reboot to succeed.  It does not claim to have more knowledge about the device
39737656SSherry.Moore@Sun.COM  * than its driver.  If a driver has implemented quiesce(), it will be invoked;
39747656SSherry.Moore@Sun.COM  * if a so identified driver does not manage any device that needs to be
39757656SSherry.Moore@Sun.COM  * quiesced, it must explicitly set its devo_quiesce dev_op to
39767656SSherry.Moore@Sun.COM  * ddi_quiesce_not_needed.
39777656SSherry.Moore@Sun.COM  */
39787656SSherry.Moore@Sun.COM static int skip_pseudo = 1;	/* Skip pseudo devices */
39797656SSherry.Moore@Sun.COM static int skip_non_hw = 1;	/* Skip devices with no hardware property */
39807656SSherry.Moore@Sun.COM static int
39817656SSherry.Moore@Sun.COM should_implement_quiesce(dev_info_t *dip)
39827656SSherry.Moore@Sun.COM {
39837656SSherry.Moore@Sun.COM 	struct dev_info *devi = DEVI(dip);
39847656SSherry.Moore@Sun.COM 	dev_info_t *pdip;
39857656SSherry.Moore@Sun.COM 
39867656SSherry.Moore@Sun.COM 	/*
39877656SSherry.Moore@Sun.COM 	 * If dip is pseudo and skip_pseudo is set, driver doesn't have to
39887656SSherry.Moore@Sun.COM 	 * implement quiesce().
39897656SSherry.Moore@Sun.COM 	 */
39907656SSherry.Moore@Sun.COM 	if (skip_pseudo &&
39917656SSherry.Moore@Sun.COM 	    strncmp(ddi_binding_name(dip), "pseudo", sizeof ("pseudo")) == 0)
39927656SSherry.Moore@Sun.COM 		return (0);
39937656SSherry.Moore@Sun.COM 
39947656SSherry.Moore@Sun.COM 	/*
39957656SSherry.Moore@Sun.COM 	 * If parent dip is pseudo and skip_pseudo is set, driver doesn't have
39967656SSherry.Moore@Sun.COM 	 * to implement quiesce().
39977656SSherry.Moore@Sun.COM 	 */
39987656SSherry.Moore@Sun.COM 	if (skip_pseudo && (pdip = ddi_get_parent(dip)) != NULL &&
39997656SSherry.Moore@Sun.COM 	    strncmp(ddi_binding_name(pdip), "pseudo", sizeof ("pseudo")) == 0)
40007656SSherry.Moore@Sun.COM 		return (0);
40017656SSherry.Moore@Sun.COM 
40027656SSherry.Moore@Sun.COM 	/*
40037656SSherry.Moore@Sun.COM 	 * If not attached, driver doesn't have to implement quiesce().
40047656SSherry.Moore@Sun.COM 	 */
40057656SSherry.Moore@Sun.COM 	if (!i_ddi_devi_attached(dip))
40067656SSherry.Moore@Sun.COM 		return (0);
40077656SSherry.Moore@Sun.COM 
40087656SSherry.Moore@Sun.COM 	/*
40097656SSherry.Moore@Sun.COM 	 * If dip has no hardware property and skip_non_hw is set,
40107656SSherry.Moore@Sun.COM 	 * driver doesn't have to implement quiesce().
40117656SSherry.Moore@Sun.COM 	 */
40127656SSherry.Moore@Sun.COM 	if (skip_non_hw && devi->devi_hw_prop_ptr == NULL)
40137656SSherry.Moore@Sun.COM 		return (0);
40147656SSherry.Moore@Sun.COM 
40157656SSherry.Moore@Sun.COM 	return (1);
40167656SSherry.Moore@Sun.COM }
40177656SSherry.Moore@Sun.COM 
40187656SSherry.Moore@Sun.COM static int
40197656SSherry.Moore@Sun.COM driver_has_quiesce(struct dev_ops *ops)
40207656SSherry.Moore@Sun.COM {
40217656SSherry.Moore@Sun.COM 	if ((ops->devo_rev >= 4) && (ops->devo_quiesce != nodev) &&
40227656SSherry.Moore@Sun.COM 	    (ops->devo_quiesce != NULL) && (ops->devo_quiesce != nulldev) &&
40237656SSherry.Moore@Sun.COM 	    (ops->devo_quiesce != ddi_quiesce_not_supported))
40247656SSherry.Moore@Sun.COM 		return (1);
40257656SSherry.Moore@Sun.COM 	else
40267656SSherry.Moore@Sun.COM 		return (0);
40277656SSherry.Moore@Sun.COM }
40287656SSherry.Moore@Sun.COM 
40297656SSherry.Moore@Sun.COM /*
40307656SSherry.Moore@Sun.COM  * Check to see if a driver has implemented the quiesce() DDI function.
40317656SSherry.Moore@Sun.COM  */
40327656SSherry.Moore@Sun.COM int
40337656SSherry.Moore@Sun.COM check_driver_quiesce(dev_info_t *dip, void *arg)
40347656SSherry.Moore@Sun.COM {
40357656SSherry.Moore@Sun.COM 	struct dev_ops *ops;
40367656SSherry.Moore@Sun.COM 
40377656SSherry.Moore@Sun.COM 	if (!should_implement_quiesce(dip))
40387656SSherry.Moore@Sun.COM 		return (DDI_WALK_CONTINUE);
40397656SSherry.Moore@Sun.COM 
40407656SSherry.Moore@Sun.COM 	if ((ops = ddi_get_driver(dip)) == NULL)
40417656SSherry.Moore@Sun.COM 		return (DDI_WALK_CONTINUE);
40427656SSherry.Moore@Sun.COM 
40437656SSherry.Moore@Sun.COM 	if (driver_has_quiesce(ops)) {
40447656SSherry.Moore@Sun.COM 		if ((quiesce_debug & 0x2) == 0x2) {
40457656SSherry.Moore@Sun.COM 			if (ops->devo_quiesce == ddi_quiesce_not_needed)
40467656SSherry.Moore@Sun.COM 				cmn_err(CE_CONT, "%s does not need to be "
40477656SSherry.Moore@Sun.COM 				    "quiesced", ddi_driver_name(dip));
40487656SSherry.Moore@Sun.COM 			else
40497656SSherry.Moore@Sun.COM 				cmn_err(CE_CONT, "%s has quiesce routine",
40507656SSherry.Moore@Sun.COM 				    ddi_driver_name(dip));
40517656SSherry.Moore@Sun.COM 		}
40527656SSherry.Moore@Sun.COM 	} else {
40537656SSherry.Moore@Sun.COM 		if (arg != NULL)
40547656SSherry.Moore@Sun.COM 			*((int *)arg) = -1;
40557656SSherry.Moore@Sun.COM 		cmn_err(CE_WARN, "%s has no quiesce()", ddi_driver_name(dip));
40567656SSherry.Moore@Sun.COM 	}
40577656SSherry.Moore@Sun.COM 
40587656SSherry.Moore@Sun.COM 	return (DDI_WALK_CONTINUE);
40597656SSherry.Moore@Sun.COM }
40607656SSherry.Moore@Sun.COM 
40617656SSherry.Moore@Sun.COM /*
40627656SSherry.Moore@Sun.COM  * Quiesce device.
40637656SSherry.Moore@Sun.COM  */
40647656SSherry.Moore@Sun.COM static void
40657656SSherry.Moore@Sun.COM quiesce_one_device(dev_info_t *dip, void *arg)
40667656SSherry.Moore@Sun.COM {
40677656SSherry.Moore@Sun.COM 	struct dev_ops *ops;
40687656SSherry.Moore@Sun.COM 	int should_quiesce = 0;
40697656SSherry.Moore@Sun.COM 
40707656SSherry.Moore@Sun.COM 	/*
40717656SSherry.Moore@Sun.COM 	 * If the device is not attached it doesn't need to be quiesced.
40727656SSherry.Moore@Sun.COM 	 */
40737656SSherry.Moore@Sun.COM 	if (!i_ddi_devi_attached(dip))
40747656SSherry.Moore@Sun.COM 		return;
40757656SSherry.Moore@Sun.COM 
40767656SSherry.Moore@Sun.COM 	if ((ops = ddi_get_driver(dip)) == NULL)
40777656SSherry.Moore@Sun.COM 		return;
40787656SSherry.Moore@Sun.COM 
40797656SSherry.Moore@Sun.COM 	should_quiesce = should_implement_quiesce(dip);
40807656SSherry.Moore@Sun.COM 
40817656SSherry.Moore@Sun.COM 	/*
40827656SSherry.Moore@Sun.COM 	 * If there's an implementation of quiesce(), always call it even if
40837656SSherry.Moore@Sun.COM 	 * some of the drivers don't have quiesce() or quiesce() have failed
40847656SSherry.Moore@Sun.COM 	 * so we can do force fast reboot.  The implementation of quiesce()
40857656SSherry.Moore@Sun.COM 	 * should not negatively affect a regular reboot.
40867656SSherry.Moore@Sun.COM 	 */
40877656SSherry.Moore@Sun.COM 	if (driver_has_quiesce(ops)) {
40887656SSherry.Moore@Sun.COM 		int rc = DDI_SUCCESS;
40897656SSherry.Moore@Sun.COM 
40907656SSherry.Moore@Sun.COM 		if (ops->devo_quiesce == ddi_quiesce_not_needed)
40917656SSherry.Moore@Sun.COM 			return;
40927656SSherry.Moore@Sun.COM 
40937656SSherry.Moore@Sun.COM 		rc = devi_quiesce(dip);
40947656SSherry.Moore@Sun.COM 
40957656SSherry.Moore@Sun.COM 		/* quiesce() should never fail */
40967656SSherry.Moore@Sun.COM 		ASSERT(rc == DDI_SUCCESS);
40977656SSherry.Moore@Sun.COM 
40987656SSherry.Moore@Sun.COM 		if (rc != DDI_SUCCESS && should_quiesce) {
40997656SSherry.Moore@Sun.COM 
41007656SSherry.Moore@Sun.COM 			if (arg != NULL)
41017656SSherry.Moore@Sun.COM 				*((int *)arg) = -1;
41027656SSherry.Moore@Sun.COM 		}
41037656SSherry.Moore@Sun.COM 	} else if (should_quiesce && arg != NULL) {
41047656SSherry.Moore@Sun.COM 		*((int *)arg) = -1;
41057656SSherry.Moore@Sun.COM 	}
41067656SSherry.Moore@Sun.COM }
41077656SSherry.Moore@Sun.COM 
41087656SSherry.Moore@Sun.COM /*
41097656SSherry.Moore@Sun.COM  * Traverse the dev info tree in a breadth-first manner so that we quiesce
41107656SSherry.Moore@Sun.COM  * children first.  All subtrees under the parent of dip will be quiesced.
41117656SSherry.Moore@Sun.COM  */
41127656SSherry.Moore@Sun.COM void
41137656SSherry.Moore@Sun.COM quiesce_devices(dev_info_t *dip, void *arg)
41147656SSherry.Moore@Sun.COM {
41157656SSherry.Moore@Sun.COM 	/*
41167656SSherry.Moore@Sun.COM 	 * if we're reached here, the device tree better not be changing.
41177656SSherry.Moore@Sun.COM 	 * so either devinfo_freeze better be set or we better be panicing.
41187656SSherry.Moore@Sun.COM 	 */
41197656SSherry.Moore@Sun.COM 	ASSERT(devinfo_freeze || panicstr);
41207656SSherry.Moore@Sun.COM 
41217656SSherry.Moore@Sun.COM 	for (; dip != NULL; dip = ddi_get_next_sibling(dip)) {
41227656SSherry.Moore@Sun.COM 		quiesce_devices(ddi_get_child(dip), arg);
41237656SSherry.Moore@Sun.COM 
41247656SSherry.Moore@Sun.COM 		quiesce_one_device(dip, arg);
41257656SSherry.Moore@Sun.COM 	}
41267656SSherry.Moore@Sun.COM }
41277656SSherry.Moore@Sun.COM 
41287656SSherry.Moore@Sun.COM /*
41290Sstevel@tonic-gate  * Reset all the pure leaf drivers on the system at halt time
41300Sstevel@tonic-gate  */
41310Sstevel@tonic-gate static int
41320Sstevel@tonic-gate reset_leaf_device(dev_info_t *dip, void *arg)
41330Sstevel@tonic-gate {
41340Sstevel@tonic-gate 	_NOTE(ARGUNUSED(arg))
41350Sstevel@tonic-gate 	struct dev_ops *ops;
41360Sstevel@tonic-gate 
41370Sstevel@tonic-gate 	/* if the device doesn't need to be reset then there's nothing to do */
41380Sstevel@tonic-gate 	if (!DEVI_NEED_RESET(dip))
41390Sstevel@tonic-gate 		return (DDI_WALK_CONTINUE);
41400Sstevel@tonic-gate 
41410Sstevel@tonic-gate 	/*
41420Sstevel@tonic-gate 	 * if the device isn't a char/block device or doesn't have a
41430Sstevel@tonic-gate 	 * reset entry point then there's nothing to do.
41440Sstevel@tonic-gate 	 */
41450Sstevel@tonic-gate 	ops = ddi_get_driver(dip);
41460Sstevel@tonic-gate 	if ((ops == NULL) || (ops->devo_cb_ops == NULL) ||
41470Sstevel@tonic-gate 	    (ops->devo_reset == nodev) || (ops->devo_reset == nulldev) ||
41480Sstevel@tonic-gate 	    (ops->devo_reset == NULL))
41490Sstevel@tonic-gate 		return (DDI_WALK_CONTINUE);
41500Sstevel@tonic-gate 
41510Sstevel@tonic-gate 	if (DEVI_IS_ATTACHING(dip) || DEVI_IS_DETACHING(dip)) {
41520Sstevel@tonic-gate 		static char path[MAXPATHLEN];
41530Sstevel@tonic-gate 
41540Sstevel@tonic-gate 		/*
41550Sstevel@tonic-gate 		 * bad news, this device has blocked in it's attach or
41560Sstevel@tonic-gate 		 * detach routine, which means it not safe to call it's
41570Sstevel@tonic-gate 		 * devo_reset() entry point.
41580Sstevel@tonic-gate 		 */
41590Sstevel@tonic-gate 		cmn_err(CE_WARN, "unable to reset device: %s",
41600Sstevel@tonic-gate 		    ddi_pathname(dip, path));
41610Sstevel@tonic-gate 		return (DDI_WALK_CONTINUE);
41620Sstevel@tonic-gate 	}
41630Sstevel@tonic-gate 
41640Sstevel@tonic-gate 	NDI_CONFIG_DEBUG((CE_NOTE, "resetting %s%d\n",
41654950Scth 	    ddi_driver_name(dip), ddi_get_instance(dip)));
41660Sstevel@tonic-gate 
41670Sstevel@tonic-gate 	(void) devi_reset(dip, DDI_RESET_FORCE);
41680Sstevel@tonic-gate 	return (DDI_WALK_CONTINUE);
41690Sstevel@tonic-gate }
41700Sstevel@tonic-gate 
41710Sstevel@tonic-gate void
41720Sstevel@tonic-gate reset_leaves(void)
41730Sstevel@tonic-gate {
41740Sstevel@tonic-gate 	/*
41750Sstevel@tonic-gate 	 * if we're reached here, the device tree better not be changing.
41760Sstevel@tonic-gate 	 * so either devinfo_freeze better be set or we better be panicing.
41770Sstevel@tonic-gate 	 */
41780Sstevel@tonic-gate 	ASSERT(devinfo_freeze || panicstr);
41790Sstevel@tonic-gate 
41800Sstevel@tonic-gate 	(void) walk_devs(top_devinfo, reset_leaf_device, NULL, 0);
41810Sstevel@tonic-gate }
41820Sstevel@tonic-gate 
41837656SSherry.Moore@Sun.COM 
41847656SSherry.Moore@Sun.COM /*
41857656SSherry.Moore@Sun.COM  * devtree_freeze() must be called before quiesce_devices() and reset_leaves()
41867656SSherry.Moore@Sun.COM  * during a normal system shutdown.  It attempts to ensure that there are no
41877656SSherry.Moore@Sun.COM  * outstanding attach or detach operations in progress when quiesce_devices() or
41887656SSherry.Moore@Sun.COM  * reset_leaves()is invoked.  It must be called before the system becomes
41897656SSherry.Moore@Sun.COM  * single-threaded because device attach and detach are multi-threaded
41907656SSherry.Moore@Sun.COM  * operations.  (note that during system shutdown the system doesn't actually
41917656SSherry.Moore@Sun.COM  * become single-thread since other threads still exist, but the shutdown thread
41927656SSherry.Moore@Sun.COM  * will disable preemption for itself, raise it's pil, and stop all the other
41937656SSherry.Moore@Sun.COM  * cpus in the system there by effectively making the system single-threaded.)
41940Sstevel@tonic-gate  */
41950Sstevel@tonic-gate void
41960Sstevel@tonic-gate devtree_freeze(void)
41970Sstevel@tonic-gate {
41980Sstevel@tonic-gate 	int delayed = 0;
41990Sstevel@tonic-gate 
42000Sstevel@tonic-gate 	/* if we're panicing then the device tree isn't going to be changing */
42010Sstevel@tonic-gate 	if (panicstr)
42020Sstevel@tonic-gate 		return;
42030Sstevel@tonic-gate 
42040Sstevel@tonic-gate 	/* stop all dev_info state changes in the device tree */
42050Sstevel@tonic-gate 	devinfo_freeze = gethrtime();
42060Sstevel@tonic-gate 
42070Sstevel@tonic-gate 	/*
42080Sstevel@tonic-gate 	 * if we're not panicing and there are on-going attach or detach
42090Sstevel@tonic-gate 	 * operations, wait for up to 3 seconds for them to finish.  This
42100Sstevel@tonic-gate 	 * is a randomly chosen interval but this should be ok because:
42110Sstevel@tonic-gate 	 * - 3 seconds is very small relative to the deadman timer.
42120Sstevel@tonic-gate 	 * - normal attach and detach operations should be very quick.
42130Sstevel@tonic-gate 	 * - attach and detach operations are fairly rare.
42140Sstevel@tonic-gate 	 */
42150Sstevel@tonic-gate 	while (!panicstr && atomic_add_long_nv(&devinfo_attach_detach, 0) &&
42160Sstevel@tonic-gate 	    (delayed < 3)) {
42170Sstevel@tonic-gate 		delayed += 1;
42180Sstevel@tonic-gate 
42190Sstevel@tonic-gate 		/* do a sleeping wait for one second */
42200Sstevel@tonic-gate 		ASSERT(!servicing_interrupt());
42210Sstevel@tonic-gate 		delay(drv_usectohz(MICROSEC));
42220Sstevel@tonic-gate 	}
42230Sstevel@tonic-gate }
42240Sstevel@tonic-gate 
42250Sstevel@tonic-gate static int
42260Sstevel@tonic-gate bind_dip(dev_info_t *dip, void *arg)
42270Sstevel@tonic-gate {
42280Sstevel@tonic-gate 	_NOTE(ARGUNUSED(arg))
42294145Scth 	char	*path;
42304145Scth 	major_t	major, pmajor;
42314145Scth 
42324145Scth 	/*
42334145Scth 	 * If the node is currently bound to the wrong driver, try to unbind
42344145Scth 	 * so that we can rebind to the correct driver.
42354145Scth 	 */
42364145Scth 	if (i_ddi_node_state(dip) >= DS_BOUND) {
42374145Scth 		major = ddi_compatible_driver_major(dip, NULL);
42384145Scth 		if ((DEVI(dip)->devi_major == major) &&
42394145Scth 		    (i_ddi_node_state(dip) >= DS_INITIALIZED)) {
42404145Scth 			/*
42414145Scth 			 * Check for a path-oriented driver alias that
42424145Scth 			 * takes precedence over current driver binding.
42434145Scth 			 */
42444145Scth 			path = kmem_alloc(MAXPATHLEN, KM_SLEEP);
42454145Scth 			(void) ddi_pathname(dip, path);
42464145Scth 			pmajor = ddi_name_to_major(path);
42477009Scth 			if ((pmajor != DDI_MAJOR_T_NONE) &&
42484145Scth 			    !(devnamesp[pmajor].dn_flags & DN_DRIVER_REMOVED))
42494145Scth 				major = pmajor;
42504145Scth 			kmem_free(path, MAXPATHLEN);
42514145Scth 		}
42524145Scth 
42534145Scth 		/* attempt unbind if current driver is incorrect */
42547009Scth 		if ((major != DDI_MAJOR_T_NONE) &&
42554145Scth 		    !(devnamesp[major].dn_flags & DN_DRIVER_REMOVED) &&
42564145Scth 		    (major != DEVI(dip)->devi_major))
42574145Scth 			(void) ndi_devi_unbind_driver(dip);
42584145Scth 	}
42594145Scth 
42604145Scth 	/* If unbound, try to bind to a driver */
42610Sstevel@tonic-gate 	if (i_ddi_node_state(dip) < DS_BOUND)
42620Sstevel@tonic-gate 		(void) ndi_devi_bind_driver(dip, 0);
42630Sstevel@tonic-gate 
42640Sstevel@tonic-gate 	return (DDI_WALK_CONTINUE);
42650Sstevel@tonic-gate }
42660Sstevel@tonic-gate 
42670Sstevel@tonic-gate void
42680Sstevel@tonic-gate i_ddi_bind_devs(void)
42690Sstevel@tonic-gate {
42704145Scth 	/* flush devfs so that ndi_devi_unbind_driver will work when possible */
42714145Scth 	(void) devfs_clean(top_devinfo, NULL, 0);
42724145Scth 
42730Sstevel@tonic-gate 	ddi_walk_devs(top_devinfo, bind_dip, (void *)NULL);
42740Sstevel@tonic-gate }
42750Sstevel@tonic-gate 
42760Sstevel@tonic-gate static int
42770Sstevel@tonic-gate unbind_children(dev_info_t *dip, void *arg)
42780Sstevel@tonic-gate {
42790Sstevel@tonic-gate 	int circ;
42800Sstevel@tonic-gate 	dev_info_t *cdip;
42810Sstevel@tonic-gate 	major_t major = (major_t)(uintptr_t)arg;
42820Sstevel@tonic-gate 
42830Sstevel@tonic-gate 	ndi_devi_enter(dip, &circ);
42840Sstevel@tonic-gate 	cdip = ddi_get_child(dip);
42850Sstevel@tonic-gate 	/*
42860Sstevel@tonic-gate 	 * We are called either from rem_drv or update_drv.
42870Sstevel@tonic-gate 	 * In both cases, we unbind persistent nodes and destroy
42880Sstevel@tonic-gate 	 * .conf nodes. In the case of rem_drv, this will be the
42890Sstevel@tonic-gate 	 * final state. In the case of update_drv, i_ddi_bind_devs()
42900Sstevel@tonic-gate 	 * will be invoked later to reenumerate (new) driver.conf
42910Sstevel@tonic-gate 	 * rebind persistent nodes.
42920Sstevel@tonic-gate 	 */
42930Sstevel@tonic-gate 	while (cdip) {
42940Sstevel@tonic-gate 		dev_info_t *next = ddi_get_next_sibling(cdip);
42950Sstevel@tonic-gate 		if ((i_ddi_node_state(cdip) > DS_INITIALIZED) ||
42960Sstevel@tonic-gate 		    (ddi_driver_major(cdip) != major)) {
42970Sstevel@tonic-gate 			cdip = next;
42980Sstevel@tonic-gate 			continue;
42990Sstevel@tonic-gate 		}
43000Sstevel@tonic-gate 		(void) ndi_devi_unbind_driver(cdip);
43010Sstevel@tonic-gate 		if (ndi_dev_is_persistent_node(cdip) == 0)
43020Sstevel@tonic-gate 			(void) ddi_remove_child(cdip, 0);
43030Sstevel@tonic-gate 		cdip = next;
43040Sstevel@tonic-gate 	}
43050Sstevel@tonic-gate 	ndi_devi_exit(dip, circ);
43060Sstevel@tonic-gate 
43070Sstevel@tonic-gate 	return (DDI_WALK_CONTINUE);
43080Sstevel@tonic-gate }
43090Sstevel@tonic-gate 
43100Sstevel@tonic-gate void
43110Sstevel@tonic-gate i_ddi_unbind_devs(major_t major)
43120Sstevel@tonic-gate {
43130Sstevel@tonic-gate 	ddi_walk_devs(top_devinfo, unbind_children, (void *)(uintptr_t)major);
43140Sstevel@tonic-gate }
43150Sstevel@tonic-gate 
43160Sstevel@tonic-gate /*
43170Sstevel@tonic-gate  * I/O Hotplug control
43180Sstevel@tonic-gate  */
43190Sstevel@tonic-gate 
43200Sstevel@tonic-gate /*
43210Sstevel@tonic-gate  * create and attach a dev_info node from a .conf file spec
43220Sstevel@tonic-gate  */
43230Sstevel@tonic-gate static void
43240Sstevel@tonic-gate init_spec_child(dev_info_t *pdip, struct hwc_spec *specp, uint_t flags)
43250Sstevel@tonic-gate {
43260Sstevel@tonic-gate 	_NOTE(ARGUNUSED(flags))
43270Sstevel@tonic-gate 	dev_info_t *dip;
43280Sstevel@tonic-gate 	char *node_name;
43290Sstevel@tonic-gate 
43300Sstevel@tonic-gate 	if (((node_name = specp->hwc_devi_name) == NULL) ||
43317009Scth 	    (ddi_name_to_major(node_name) == DDI_MAJOR_T_NONE)) {
43320Sstevel@tonic-gate 		char *tmp = node_name;
43330Sstevel@tonic-gate 		if (tmp == NULL)
43340Sstevel@tonic-gate 			tmp = "<none>";
43350Sstevel@tonic-gate 		cmn_err(CE_CONT,
43360Sstevel@tonic-gate 		    "init_spec_child: parent=%s, bad spec (%s)\n",
43370Sstevel@tonic-gate 		    ddi_node_name(pdip), tmp);
43380Sstevel@tonic-gate 		return;
43390Sstevel@tonic-gate 	}
43400Sstevel@tonic-gate 
4341789Sahrens 	dip = i_ddi_alloc_node(pdip, node_name, (pnode_t)DEVI_PSEUDO_NODEID,
43420Sstevel@tonic-gate 	    -1, specp->hwc_devi_sys_prop_ptr, KM_SLEEP);
43430Sstevel@tonic-gate 
43440Sstevel@tonic-gate 	if (dip == NULL)
43450Sstevel@tonic-gate 		return;
43460Sstevel@tonic-gate 
43470Sstevel@tonic-gate 	if (ddi_initchild(pdip, dip) != DDI_SUCCESS)
43480Sstevel@tonic-gate 		(void) ddi_remove_child(dip, 0);
43490Sstevel@tonic-gate }
43500Sstevel@tonic-gate 
43510Sstevel@tonic-gate /*
43520Sstevel@tonic-gate  * Lookup hwc specs from hash tables and make children from the spec
43530Sstevel@tonic-gate  * Because some .conf children are "merge" nodes, we also initialize
43540Sstevel@tonic-gate  * .conf children to merge properties onto hardware nodes.
43550Sstevel@tonic-gate  *
43560Sstevel@tonic-gate  * The pdip must be held busy.
43570Sstevel@tonic-gate  */
43580Sstevel@tonic-gate int
43590Sstevel@tonic-gate i_ndi_make_spec_children(dev_info_t *pdip, uint_t flags)
43600Sstevel@tonic-gate {
43610Sstevel@tonic-gate 	extern struct hwc_spec *hwc_get_child_spec(dev_info_t *, major_t);
4362298Scth 	int			circ;
4363298Scth 	struct hwc_spec		*list, *spec;
4364298Scth 
4365298Scth 	ndi_devi_enter(pdip, &circ);
4366298Scth 	if (DEVI(pdip)->devi_flags & DEVI_MADE_CHILDREN) {
4367298Scth 		ndi_devi_exit(pdip, circ);
43680Sstevel@tonic-gate 		return (DDI_SUCCESS);
4369298Scth 	}
43700Sstevel@tonic-gate 
43717009Scth 	list = hwc_get_child_spec(pdip, DDI_MAJOR_T_NONE);
43720Sstevel@tonic-gate 	for (spec = list; spec != NULL; spec = spec->hwc_next) {
43730Sstevel@tonic-gate 		init_spec_child(pdip, spec, flags);
43740Sstevel@tonic-gate 	}
43750Sstevel@tonic-gate 	hwc_free_spec_list(list);
43760Sstevel@tonic-gate 
43770Sstevel@tonic-gate 	mutex_enter(&DEVI(pdip)->devi_lock);
43780Sstevel@tonic-gate 	DEVI(pdip)->devi_flags |= DEVI_MADE_CHILDREN;
43790Sstevel@tonic-gate 	mutex_exit(&DEVI(pdip)->devi_lock);
4380298Scth 	ndi_devi_exit(pdip, circ);
43810Sstevel@tonic-gate 	return (DDI_SUCCESS);
43820Sstevel@tonic-gate }
43830Sstevel@tonic-gate 
43840Sstevel@tonic-gate /*
43850Sstevel@tonic-gate  * Run initchild on all child nodes such that instance assignment
43860Sstevel@tonic-gate  * for multiport network cards are contiguous.
43870Sstevel@tonic-gate  *
43880Sstevel@tonic-gate  * The pdip must be held busy.
43890Sstevel@tonic-gate  */
43900Sstevel@tonic-gate static void
43910Sstevel@tonic-gate i_ndi_init_hw_children(dev_info_t *pdip, uint_t flags)
43920Sstevel@tonic-gate {
43930Sstevel@tonic-gate 	dev_info_t *dip;
43940Sstevel@tonic-gate 
43950Sstevel@tonic-gate 	ASSERT(DEVI(pdip)->devi_flags & DEVI_MADE_CHILDREN);
43960Sstevel@tonic-gate 
43970Sstevel@tonic-gate 	/* contiguous instance assignment */
43980Sstevel@tonic-gate 	e_ddi_enter_instance();
43990Sstevel@tonic-gate 	dip = ddi_get_child(pdip);
44000Sstevel@tonic-gate 	while (dip) {
44010Sstevel@tonic-gate 		if (ndi_dev_is_persistent_node(dip))
44020Sstevel@tonic-gate 			(void) i_ndi_config_node(dip, DS_INITIALIZED, flags);
44030Sstevel@tonic-gate 		dip = ddi_get_next_sibling(dip);
44040Sstevel@tonic-gate 	}
44050Sstevel@tonic-gate 	e_ddi_exit_instance();
44060Sstevel@tonic-gate }
44070Sstevel@tonic-gate 
44080Sstevel@tonic-gate /*
44090Sstevel@tonic-gate  * report device status
44100Sstevel@tonic-gate  */
44110Sstevel@tonic-gate static void
44120Sstevel@tonic-gate i_ndi_devi_report_status_change(dev_info_t *dip, char *path)
44130Sstevel@tonic-gate {
44140Sstevel@tonic-gate 	char *status;
44150Sstevel@tonic-gate 
44160Sstevel@tonic-gate 	if (!DEVI_NEED_REPORT(dip) ||
44170Sstevel@tonic-gate 	    (i_ddi_node_state(dip) < DS_INITIALIZED)) {
44180Sstevel@tonic-gate 		return;
44190Sstevel@tonic-gate 	}
44200Sstevel@tonic-gate 
44210Sstevel@tonic-gate 	if (DEVI_IS_DEVICE_OFFLINE(dip)) {
44220Sstevel@tonic-gate 		status = "offline";
44230Sstevel@tonic-gate 	} else if (DEVI_IS_DEVICE_DOWN(dip)) {
44240Sstevel@tonic-gate 		status = "down";
44250Sstevel@tonic-gate 	} else if (DEVI_IS_BUS_QUIESCED(dip)) {
44260Sstevel@tonic-gate 		status = "quiesced";
44270Sstevel@tonic-gate 	} else if (DEVI_IS_BUS_DOWN(dip)) {
44280Sstevel@tonic-gate 		status = "down";
44291333Scth 	} else if (i_ddi_devi_attached(dip)) {
44300Sstevel@tonic-gate 		status = "online";
44310Sstevel@tonic-gate 	} else {
44320Sstevel@tonic-gate 		status = "unknown";
44330Sstevel@tonic-gate 	}
44340Sstevel@tonic-gate 
44350Sstevel@tonic-gate 	if (path == NULL) {
44360Sstevel@tonic-gate 		path = kmem_alloc(MAXPATHLEN, KM_SLEEP);
44370Sstevel@tonic-gate 		cmn_err(CE_CONT, "?%s (%s%d) %s\n",
44384950Scth 		    ddi_pathname(dip, path), ddi_driver_name(dip),
44394950Scth 		    ddi_get_instance(dip), status);
44400Sstevel@tonic-gate 		kmem_free(path, MAXPATHLEN);
44410Sstevel@tonic-gate 	} else {
44420Sstevel@tonic-gate 		cmn_err(CE_CONT, "?%s (%s%d) %s\n",
44434950Scth 		    path, ddi_driver_name(dip),
44444950Scth 		    ddi_get_instance(dip), status);
44450Sstevel@tonic-gate 	}
44460Sstevel@tonic-gate 
4447495Scth 	mutex_enter(&(DEVI(dip)->devi_lock));
44480Sstevel@tonic-gate 	DEVI_REPORT_DONE(dip);
4449495Scth 	mutex_exit(&(DEVI(dip)->devi_lock));
44500Sstevel@tonic-gate }
44510Sstevel@tonic-gate 
44520Sstevel@tonic-gate /*
44530Sstevel@tonic-gate  * log a notification that a dev_info node has been configured.
44540Sstevel@tonic-gate  */
44550Sstevel@tonic-gate static int
44560Sstevel@tonic-gate i_log_devfs_add_devinfo(dev_info_t *dip, uint_t flags)
44570Sstevel@tonic-gate {
44580Sstevel@tonic-gate 	int se_err;
44590Sstevel@tonic-gate 	char *pathname;
44600Sstevel@tonic-gate 	sysevent_t *ev;
44610Sstevel@tonic-gate 	sysevent_id_t eid;
44620Sstevel@tonic-gate 	sysevent_value_t se_val;
44630Sstevel@tonic-gate 	sysevent_attr_list_t *ev_attr_list = NULL;
44640Sstevel@tonic-gate 	char *class_name;
44650Sstevel@tonic-gate 	int no_transport = 0;
44660Sstevel@tonic-gate 
44670Sstevel@tonic-gate 	ASSERT(dip);
44680Sstevel@tonic-gate 
44690Sstevel@tonic-gate 	/*
44700Sstevel@tonic-gate 	 * Invalidate the devinfo snapshot cache
44710Sstevel@tonic-gate 	 */
44720Sstevel@tonic-gate 	i_ddi_di_cache_invalidate(KM_SLEEP);
44730Sstevel@tonic-gate 
44740Sstevel@tonic-gate 	/* do not generate ESC_DEVFS_DEVI_ADD event during boot */
44750Sstevel@tonic-gate 	if (!i_ddi_io_initialized())
44760Sstevel@tonic-gate 		return (DDI_SUCCESS);
44770Sstevel@tonic-gate 
44780Sstevel@tonic-gate 	ev = sysevent_alloc(EC_DEVFS, ESC_DEVFS_DEVI_ADD, EP_DDI, SE_SLEEP);
44790Sstevel@tonic-gate 
44800Sstevel@tonic-gate 	pathname = kmem_alloc(MAXPATHLEN, KM_SLEEP);
44810Sstevel@tonic-gate 
44820Sstevel@tonic-gate 	(void) ddi_pathname(dip, pathname);
44830Sstevel@tonic-gate 	ASSERT(strlen(pathname));
44840Sstevel@tonic-gate 
44850Sstevel@tonic-gate 	se_val.value_type = SE_DATA_TYPE_STRING;
44860Sstevel@tonic-gate 	se_val.value.sv_string = pathname;
44870Sstevel@tonic-gate 	if (sysevent_add_attr(&ev_attr_list, DEVFS_PATHNAME,
44880Sstevel@tonic-gate 	    &se_val, SE_SLEEP) != 0) {
44890Sstevel@tonic-gate 		goto fail;
44900Sstevel@tonic-gate 	}
44910Sstevel@tonic-gate 
44920Sstevel@tonic-gate 	/* add the device class attribute */
44930Sstevel@tonic-gate 	if ((class_name = i_ddi_devi_class(dip)) != NULL) {
44940Sstevel@tonic-gate 		se_val.value_type = SE_DATA_TYPE_STRING;
44950Sstevel@tonic-gate 		se_val.value.sv_string = class_name;
44960Sstevel@tonic-gate 
44970Sstevel@tonic-gate 		if (sysevent_add_attr(&ev_attr_list,
44980Sstevel@tonic-gate 		    DEVFS_DEVI_CLASS, &se_val, SE_SLEEP) != 0) {
44990Sstevel@tonic-gate 			sysevent_free_attr(ev_attr_list);
45000Sstevel@tonic-gate 			goto fail;
45010Sstevel@tonic-gate 		}
45020Sstevel@tonic-gate 	}
45030Sstevel@tonic-gate 
45040Sstevel@tonic-gate 	/*
45050Sstevel@tonic-gate 	 * must log a branch event too unless NDI_BRANCH_EVENT_OP is set,
45060Sstevel@tonic-gate 	 * in which case the branch event will be logged by the caller
45070Sstevel@tonic-gate 	 * after the entire branch has been configured.
45080Sstevel@tonic-gate 	 */
45090Sstevel@tonic-gate 	if ((flags & NDI_BRANCH_EVENT_OP) == 0) {
45100Sstevel@tonic-gate 		/*
45110Sstevel@tonic-gate 		 * Instead of logging a separate branch event just add
45120Sstevel@tonic-gate 		 * DEVFS_BRANCH_EVENT attribute. It indicates devfsadmd to
45130Sstevel@tonic-gate 		 * generate a EC_DEV_BRANCH event.
45140Sstevel@tonic-gate 		 */
45150Sstevel@tonic-gate 		se_val.value_type = SE_DATA_TYPE_INT32;
45160Sstevel@tonic-gate 		se_val.value.sv_int32 = 1;
45170Sstevel@tonic-gate 		if (sysevent_add_attr(&ev_attr_list,
45180Sstevel@tonic-gate 		    DEVFS_BRANCH_EVENT, &se_val, SE_SLEEP) != 0) {
45190Sstevel@tonic-gate 			sysevent_free_attr(ev_attr_list);
45200Sstevel@tonic-gate 			goto fail;
45210Sstevel@tonic-gate 		}
45220Sstevel@tonic-gate 	}
45230Sstevel@tonic-gate 
45240Sstevel@tonic-gate 	if (sysevent_attach_attributes(ev, ev_attr_list) != 0) {
45250Sstevel@tonic-gate 		sysevent_free_attr(ev_attr_list);
45260Sstevel@tonic-gate 		goto fail;
45270Sstevel@tonic-gate 	}
45280Sstevel@tonic-gate 
45290Sstevel@tonic-gate 	if ((se_err = log_sysevent(ev, SE_SLEEP, &eid)) != 0) {
45300Sstevel@tonic-gate 		if (se_err == SE_NO_TRANSPORT)
45310Sstevel@tonic-gate 			no_transport = 1;
45320Sstevel@tonic-gate 		goto fail;
45330Sstevel@tonic-gate 	}
45340Sstevel@tonic-gate 
45350Sstevel@tonic-gate 	sysevent_free(ev);
45360Sstevel@tonic-gate 	kmem_free(pathname, MAXPATHLEN);
45370Sstevel@tonic-gate 
45380Sstevel@tonic-gate 	return (DDI_SUCCESS);
45390Sstevel@tonic-gate 
45400Sstevel@tonic-gate fail:
45410Sstevel@tonic-gate 	cmn_err(CE_WARN, "failed to log ESC_DEVFS_DEVI_ADD event for %s%s",
45420Sstevel@tonic-gate 	    pathname, (no_transport) ? " (syseventd not responding)" : "");
45430Sstevel@tonic-gate 
45440Sstevel@tonic-gate 	cmn_err(CE_WARN, "/dev may not be current for driver %s. "
45450Sstevel@tonic-gate 	    "Run devfsadm -i %s",
45460Sstevel@tonic-gate 	    ddi_driver_name(dip), ddi_driver_name(dip));
45470Sstevel@tonic-gate 
45480Sstevel@tonic-gate 	sysevent_free(ev);
45490Sstevel@tonic-gate 	kmem_free(pathname, MAXPATHLEN);
45500Sstevel@tonic-gate 	return (DDI_SUCCESS);
45510Sstevel@tonic-gate }
45520Sstevel@tonic-gate 
45530Sstevel@tonic-gate /*
45540Sstevel@tonic-gate  * log a notification that a dev_info node has been unconfigured.
45550Sstevel@tonic-gate  */
45560Sstevel@tonic-gate static int
45570Sstevel@tonic-gate i_log_devfs_remove_devinfo(char *pathname, char *class_name, char *driver_name,
45580Sstevel@tonic-gate     int instance, uint_t flags)
45590Sstevel@tonic-gate {
45600Sstevel@tonic-gate 	sysevent_t *ev;
45610Sstevel@tonic-gate 	sysevent_id_t eid;
45620Sstevel@tonic-gate 	sysevent_value_t se_val;
45630Sstevel@tonic-gate 	sysevent_attr_list_t *ev_attr_list = NULL;
45640Sstevel@tonic-gate 	int se_err;
45650Sstevel@tonic-gate 	int no_transport = 0;
45660Sstevel@tonic-gate 
45670Sstevel@tonic-gate 	i_ddi_di_cache_invalidate(KM_SLEEP);
45680Sstevel@tonic-gate 
45690Sstevel@tonic-gate 	if (!i_ddi_io_initialized())
45700Sstevel@tonic-gate 		return (DDI_SUCCESS);
45710Sstevel@tonic-gate 
45720Sstevel@tonic-gate 	ev = sysevent_alloc(EC_DEVFS, ESC_DEVFS_DEVI_REMOVE, EP_DDI, SE_SLEEP);
45730Sstevel@tonic-gate 
45740Sstevel@tonic-gate 	se_val.value_type = SE_DATA_TYPE_STRING;
45750Sstevel@tonic-gate 	se_val.value.sv_string = pathname;
45760Sstevel@tonic-gate 	if (sysevent_add_attr(&ev_attr_list, DEVFS_PATHNAME,
45770Sstevel@tonic-gate 	    &se_val, SE_SLEEP) != 0) {
45780Sstevel@tonic-gate 		goto fail;
45790Sstevel@tonic-gate 	}
45800Sstevel@tonic-gate 
45810Sstevel@tonic-gate 	if (class_name) {
45820Sstevel@tonic-gate 		/* add the device class, driver name and instance attributes */
45830Sstevel@tonic-gate 
45840Sstevel@tonic-gate 		se_val.value_type = SE_DATA_TYPE_STRING;
45850Sstevel@tonic-gate 		se_val.value.sv_string = class_name;
45860Sstevel@tonic-gate 		if (sysevent_add_attr(&ev_attr_list,
45870Sstevel@tonic-gate 		    DEVFS_DEVI_CLASS, &se_val, SE_SLEEP) != 0) {
45880Sstevel@tonic-gate 			sysevent_free_attr(ev_attr_list);
45890Sstevel@tonic-gate 			goto fail;
45900Sstevel@tonic-gate 		}
45910Sstevel@tonic-gate 
45920Sstevel@tonic-gate 		se_val.value_type = SE_DATA_TYPE_STRING;
45930Sstevel@tonic-gate 		se_val.value.sv_string = driver_name;
45940Sstevel@tonic-gate 		if (sysevent_add_attr(&ev_attr_list,
45950Sstevel@tonic-gate 		    DEVFS_DRIVER_NAME, &se_val, SE_SLEEP) != 0) {
45960Sstevel@tonic-gate 			sysevent_free_attr(ev_attr_list);
45970Sstevel@tonic-gate 			goto fail;
45980Sstevel@tonic-gate 		}
45990Sstevel@tonic-gate 
46000Sstevel@tonic-gate 		se_val.value_type = SE_DATA_TYPE_INT32;
46010Sstevel@tonic-gate 		se_val.value.sv_int32 = instance;
46020Sstevel@tonic-gate 		if (sysevent_add_attr(&ev_attr_list,
46030Sstevel@tonic-gate 		    DEVFS_INSTANCE, &se_val, SE_SLEEP) != 0) {
46040Sstevel@tonic-gate 			sysevent_free_attr(ev_attr_list);
46050Sstevel@tonic-gate 			goto fail;
46060Sstevel@tonic-gate 		}
46070Sstevel@tonic-gate 	}
46080Sstevel@tonic-gate 
46090Sstevel@tonic-gate 	/*
46100Sstevel@tonic-gate 	 * must log a branch event too unless NDI_BRANCH_EVENT_OP is set,
46110Sstevel@tonic-gate 	 * in which case the branch event will be logged by the caller
46120Sstevel@tonic-gate 	 * after the entire branch has been unconfigured.
46130Sstevel@tonic-gate 	 */
46140Sstevel@tonic-gate 	if ((flags & NDI_BRANCH_EVENT_OP) == 0) {
46150Sstevel@tonic-gate 		/*
46160Sstevel@tonic-gate 		 * Instead of logging a separate branch event just add
46170Sstevel@tonic-gate 		 * DEVFS_BRANCH_EVENT attribute. It indicates devfsadmd to
46180Sstevel@tonic-gate 		 * generate a EC_DEV_BRANCH event.
46190Sstevel@tonic-gate 		 */
46200Sstevel@tonic-gate 		se_val.value_type = SE_DATA_TYPE_INT32;
46210Sstevel@tonic-gate 		se_val.value.sv_int32 = 1;
46220Sstevel@tonic-gate 		if (sysevent_add_attr(&ev_attr_list,
46230Sstevel@tonic-gate 		    DEVFS_BRANCH_EVENT, &se_val, SE_SLEEP) != 0) {
46240Sstevel@tonic-gate 			sysevent_free_attr(ev_attr_list);
46250Sstevel@tonic-gate 			goto fail;
46260Sstevel@tonic-gate 		}
46270Sstevel@tonic-gate 	}
46280Sstevel@tonic-gate 
46290Sstevel@tonic-gate 	if (sysevent_attach_attributes(ev, ev_attr_list) != 0) {
46300Sstevel@tonic-gate 		sysevent_free_attr(ev_attr_list);
46310Sstevel@tonic-gate 		goto fail;
46320Sstevel@tonic-gate 	}
46330Sstevel@tonic-gate 
46340Sstevel@tonic-gate 	if ((se_err = log_sysevent(ev, SE_SLEEP, &eid)) != 0) {
46350Sstevel@tonic-gate 		if (se_err == SE_NO_TRANSPORT)
46360Sstevel@tonic-gate 			no_transport = 1;
46370Sstevel@tonic-gate 		goto fail;
46380Sstevel@tonic-gate 	}
46390Sstevel@tonic-gate 
46400Sstevel@tonic-gate 	sysevent_free(ev);
46410Sstevel@tonic-gate 	return (DDI_SUCCESS);
46420Sstevel@tonic-gate 
46430Sstevel@tonic-gate fail:
46440Sstevel@tonic-gate 	sysevent_free(ev);
46450Sstevel@tonic-gate 	cmn_err(CE_WARN, "failed to log ESC_DEVFS_DEVI_REMOVE event for %s%s",
46460Sstevel@tonic-gate 	    pathname, (no_transport) ? " (syseventd not responding)" : "");
46470Sstevel@tonic-gate 	return (DDI_SUCCESS);
46480Sstevel@tonic-gate }
46490Sstevel@tonic-gate 
46500Sstevel@tonic-gate /*
46510Sstevel@tonic-gate  * log an event that a dev_info branch has been configured or unconfigured.
46520Sstevel@tonic-gate  */
46530Sstevel@tonic-gate static int
46540Sstevel@tonic-gate i_log_devfs_branch(char *node_path, char *subclass)
46550Sstevel@tonic-gate {
46560Sstevel@tonic-gate 	int se_err;
46570Sstevel@tonic-gate 	sysevent_t *ev;
46580Sstevel@tonic-gate 	sysevent_id_t eid;
46590Sstevel@tonic-gate 	sysevent_value_t se_val;
46600Sstevel@tonic-gate 	sysevent_attr_list_t *ev_attr_list = NULL;
46610Sstevel@tonic-gate 	int no_transport = 0;
46620Sstevel@tonic-gate 
46630Sstevel@tonic-gate 	/* do not generate the event during boot */
46640Sstevel@tonic-gate 	if (!i_ddi_io_initialized())
46650Sstevel@tonic-gate 		return (DDI_SUCCESS);
46660Sstevel@tonic-gate 
46670Sstevel@tonic-gate 	ev = sysevent_alloc(EC_DEVFS, subclass, EP_DDI, SE_SLEEP);
46680Sstevel@tonic-gate 
46690Sstevel@tonic-gate 	se_val.value_type = SE_DATA_TYPE_STRING;
46700Sstevel@tonic-gate 	se_val.value.sv_string = node_path;
46710Sstevel@tonic-gate 
46720Sstevel@tonic-gate 	if (sysevent_add_attr(&ev_attr_list, DEVFS_PATHNAME,
46730Sstevel@tonic-gate 	    &se_val, SE_SLEEP) != 0) {
46740Sstevel@tonic-gate 		goto fail;
46750Sstevel@tonic-gate 	}
46760Sstevel@tonic-gate 
46770Sstevel@tonic-gate 	if (sysevent_attach_attributes(ev, ev_attr_list) != 0) {
46780Sstevel@tonic-gate 		sysevent_free_attr(ev_attr_list);
46790Sstevel@tonic-gate 		goto fail;
46800Sstevel@tonic-gate 	}
46810Sstevel@tonic-gate 
46820Sstevel@tonic-gate 	if ((se_err = log_sysevent(ev, SE_SLEEP, &eid)) != 0) {
46830Sstevel@tonic-gate 		if (se_err == SE_NO_TRANSPORT)
46840Sstevel@tonic-gate 			no_transport = 1;
46850Sstevel@tonic-gate 		goto fail;
46860Sstevel@tonic-gate 	}
46870Sstevel@tonic-gate 
46880Sstevel@tonic-gate 	sysevent_free(ev);
46890Sstevel@tonic-gate 	return (DDI_SUCCESS);
46900Sstevel@tonic-gate 
46910Sstevel@tonic-gate fail:
46920Sstevel@tonic-gate 	cmn_err(CE_WARN, "failed to log %s branch event for %s%s",
46930Sstevel@tonic-gate 	    subclass, node_path,
46940Sstevel@tonic-gate 	    (no_transport) ? " (syseventd not responding)" : "");
46950Sstevel@tonic-gate 
46960Sstevel@tonic-gate 	sysevent_free(ev);
46970Sstevel@tonic-gate 	return (DDI_FAILURE);
46980Sstevel@tonic-gate }
46990Sstevel@tonic-gate 
47000Sstevel@tonic-gate /*
47010Sstevel@tonic-gate  * log an event that a dev_info tree branch has been configured.
47020Sstevel@tonic-gate  */
47030Sstevel@tonic-gate static int
47040Sstevel@tonic-gate i_log_devfs_branch_add(dev_info_t *dip)
47050Sstevel@tonic-gate {
47060Sstevel@tonic-gate 	char *node_path;
47070Sstevel@tonic-gate 	int rv;
47080Sstevel@tonic-gate 
47090Sstevel@tonic-gate 	node_path = kmem_alloc(MAXPATHLEN, KM_SLEEP);
47100Sstevel@tonic-gate 	(void) ddi_pathname(dip, node_path);
47110Sstevel@tonic-gate 	rv = i_log_devfs_branch(node_path, ESC_DEVFS_BRANCH_ADD);
47120Sstevel@tonic-gate 	kmem_free(node_path, MAXPATHLEN);
47130Sstevel@tonic-gate 
47140Sstevel@tonic-gate 	return (rv);
47150Sstevel@tonic-gate }
47160Sstevel@tonic-gate 
47170Sstevel@tonic-gate /*
47180Sstevel@tonic-gate  * log an event that a dev_info tree branch has been unconfigured.
47190Sstevel@tonic-gate  */
47200Sstevel@tonic-gate static int
47210Sstevel@tonic-gate i_log_devfs_branch_remove(char *node_path)
47220Sstevel@tonic-gate {
47230Sstevel@tonic-gate 	return (i_log_devfs_branch(node_path, ESC_DEVFS_BRANCH_REMOVE));
47240Sstevel@tonic-gate }
47250Sstevel@tonic-gate 
47260Sstevel@tonic-gate /*
47270Sstevel@tonic-gate  * enqueue the dip's deviname on the branch event queue.
47280Sstevel@tonic-gate  */
47290Sstevel@tonic-gate static struct brevq_node *
47300Sstevel@tonic-gate brevq_enqueue(struct brevq_node **brevqp, dev_info_t *dip,
47310Sstevel@tonic-gate     struct brevq_node *child)
47320Sstevel@tonic-gate {
47330Sstevel@tonic-gate 	struct brevq_node *brn;
47340Sstevel@tonic-gate 	char *deviname;
47350Sstevel@tonic-gate 
47360Sstevel@tonic-gate 	deviname = kmem_alloc(MAXNAMELEN, KM_SLEEP);
47370Sstevel@tonic-gate 	(void) ddi_deviname(dip, deviname);
47380Sstevel@tonic-gate 
47390Sstevel@tonic-gate 	brn = kmem_zalloc(sizeof (*brn), KM_SLEEP);
47401317Scth 	brn->brn_deviname = i_ddi_strdup(deviname, KM_SLEEP);
47410Sstevel@tonic-gate 	kmem_free(deviname, MAXNAMELEN);
47421317Scth 	brn->brn_child = child;
47431317Scth 	brn->brn_sibling = *brevqp;
47440Sstevel@tonic-gate 	*brevqp = brn;
47450Sstevel@tonic-gate 
47460Sstevel@tonic-gate 	return (brn);
47470Sstevel@tonic-gate }
47480Sstevel@tonic-gate 
47490Sstevel@tonic-gate /*
47500Sstevel@tonic-gate  * free the memory allocated for the elements on the branch event queue.
47510Sstevel@tonic-gate  */
47520Sstevel@tonic-gate static void
47530Sstevel@tonic-gate free_brevq(struct brevq_node *brevq)
47540Sstevel@tonic-gate {
47550Sstevel@tonic-gate 	struct brevq_node *brn, *next_brn;
47560Sstevel@tonic-gate 
47570Sstevel@tonic-gate 	for (brn = brevq; brn != NULL; brn = next_brn) {
47581317Scth 		next_brn = brn->brn_sibling;
47591317Scth 		ASSERT(brn->brn_child == NULL);
47601317Scth 		kmem_free(brn->brn_deviname, strlen(brn->brn_deviname) + 1);
47610Sstevel@tonic-gate 		kmem_free(brn, sizeof (*brn));
47620Sstevel@tonic-gate 	}
47630Sstevel@tonic-gate }
47640Sstevel@tonic-gate 
47650Sstevel@tonic-gate /*
47660Sstevel@tonic-gate  * log the events queued up on the branch event queue and free the
47670Sstevel@tonic-gate  * associated memory.
47680Sstevel@tonic-gate  *
47690Sstevel@tonic-gate  * node_path must have been allocated with at least MAXPATHLEN bytes.
47700Sstevel@tonic-gate  */
47710Sstevel@tonic-gate static void
47720Sstevel@tonic-gate log_and_free_brevq(char *node_path, struct brevq_node *brevq)
47730Sstevel@tonic-gate {
47740Sstevel@tonic-gate 	struct brevq_node *brn;
47750Sstevel@tonic-gate 	char *p;
47760Sstevel@tonic-gate 
47770Sstevel@tonic-gate 	p = node_path + strlen(node_path);
47781317Scth 	for (brn = brevq; brn != NULL; brn = brn->brn_sibling) {
47791317Scth 		(void) strcpy(p, brn->brn_deviname);
47800Sstevel@tonic-gate 		(void) i_log_devfs_branch_remove(node_path);
47810Sstevel@tonic-gate 	}
47820Sstevel@tonic-gate 	*p = '\0';
47830Sstevel@tonic-gate 
47840Sstevel@tonic-gate 	free_brevq(brevq);
47850Sstevel@tonic-gate }
47860Sstevel@tonic-gate 
47870Sstevel@tonic-gate /*
47880Sstevel@tonic-gate  * log the events queued up on the branch event queue and free the
47890Sstevel@tonic-gate  * associated memory. Same as the previous function but operates on dip.
47900Sstevel@tonic-gate  */
47910Sstevel@tonic-gate static void
47920Sstevel@tonic-gate log_and_free_brevq_dip(dev_info_t *dip, struct brevq_node *brevq)
47930Sstevel@tonic-gate {
47940Sstevel@tonic-gate 	char *path;
47950Sstevel@tonic-gate 
47960Sstevel@tonic-gate 	path = kmem_alloc(MAXPATHLEN, KM_SLEEP);
47970Sstevel@tonic-gate 	(void) ddi_pathname(dip, path);
47980Sstevel@tonic-gate 	log_and_free_brevq(path, brevq);
47990Sstevel@tonic-gate 	kmem_free(path, MAXPATHLEN);
48000Sstevel@tonic-gate }
48010Sstevel@tonic-gate 
48020Sstevel@tonic-gate /*
48030Sstevel@tonic-gate  * log the outstanding branch remove events for the grand children of the dip
48040Sstevel@tonic-gate  * and free the associated memory.
48050Sstevel@tonic-gate  */
48060Sstevel@tonic-gate static void
48070Sstevel@tonic-gate log_and_free_br_events_on_grand_children(dev_info_t *dip,
48080Sstevel@tonic-gate     struct brevq_node *brevq)
48090Sstevel@tonic-gate {
48100Sstevel@tonic-gate 	struct brevq_node *brn;
48110Sstevel@tonic-gate 	char *path;
48120Sstevel@tonic-gate 	char *p;
48130Sstevel@tonic-gate 
48140Sstevel@tonic-gate 	path = kmem_alloc(MAXPATHLEN, KM_SLEEP);
48150Sstevel@tonic-gate 	(void) ddi_pathname(dip, path);
48160Sstevel@tonic-gate 	p = path + strlen(path);
48171317Scth 	for (brn = brevq; brn != NULL; brn = brn->brn_sibling) {
48181317Scth 		if (brn->brn_child) {
48191317Scth 			(void) strcpy(p, brn->brn_deviname);
48200Sstevel@tonic-gate 			/* now path contains the node path to the dip's child */
48211317Scth 			log_and_free_brevq(path, brn->brn_child);
48221317Scth 			brn->brn_child = NULL;
48230Sstevel@tonic-gate 		}
48240Sstevel@tonic-gate 	}
48250Sstevel@tonic-gate 	kmem_free(path, MAXPATHLEN);
48260Sstevel@tonic-gate }
48270Sstevel@tonic-gate 
48280Sstevel@tonic-gate /*
48290Sstevel@tonic-gate  * log and cleanup branch remove events for the grand children of the dip.
48300Sstevel@tonic-gate  */
48310Sstevel@tonic-gate static void
48320Sstevel@tonic-gate cleanup_br_events_on_grand_children(dev_info_t *dip, struct brevq_node **brevqp)
48330Sstevel@tonic-gate {
48340Sstevel@tonic-gate 	dev_info_t *child;
48350Sstevel@tonic-gate 	struct brevq_node *brevq, *brn, *prev_brn, *next_brn;
48360Sstevel@tonic-gate 	char *path;
48370Sstevel@tonic-gate 	int circ;
48380Sstevel@tonic-gate 
48390Sstevel@tonic-gate 	path = kmem_alloc(MAXPATHLEN, KM_SLEEP);
48400Sstevel@tonic-gate 	prev_brn = NULL;
48410Sstevel@tonic-gate 	brevq = *brevqp;
48420Sstevel@tonic-gate 
48430Sstevel@tonic-gate 	ndi_devi_enter(dip, &circ);
48440Sstevel@tonic-gate 	for (brn = brevq; brn != NULL; brn = next_brn) {
48451317Scth 		next_brn = brn->brn_sibling;
48460Sstevel@tonic-gate 		for (child = ddi_get_child(dip); child != NULL;
48470Sstevel@tonic-gate 		    child = ddi_get_next_sibling(child)) {
48480Sstevel@tonic-gate 			if (i_ddi_node_state(child) >= DS_INITIALIZED) {
48490Sstevel@tonic-gate 				(void) ddi_deviname(child, path);
48501317Scth 				if (strcmp(path, brn->brn_deviname) == 0)
48510Sstevel@tonic-gate 					break;
48520Sstevel@tonic-gate 			}
48530Sstevel@tonic-gate 		}
48540Sstevel@tonic-gate 
48550Sstevel@tonic-gate 		if (child != NULL && !(DEVI_EVREMOVE(child))) {
48560Sstevel@tonic-gate 			/*
48570Sstevel@tonic-gate 			 * Event state is not REMOVE. So branch remove event
48581317Scth 			 * is not going be generated on brn->brn_child.
48590Sstevel@tonic-gate 			 * If any branch remove events were queued up on
48601317Scth 			 * brn->brn_child log them and remove the brn
48610Sstevel@tonic-gate 			 * from the queue.
48620Sstevel@tonic-gate 			 */
48631317Scth 			if (brn->brn_child) {
48640Sstevel@tonic-gate 				(void) ddi_pathname(dip, path);
48651317Scth 				(void) strcat(path, brn->brn_deviname);
48661317Scth 				log_and_free_brevq(path, brn->brn_child);
48670Sstevel@tonic-gate 			}
48680Sstevel@tonic-gate 
48690Sstevel@tonic-gate 			if (prev_brn)
48701317Scth 				prev_brn->brn_sibling = next_brn;
48710Sstevel@tonic-gate 			else
48720Sstevel@tonic-gate 				*brevqp = next_brn;
48730Sstevel@tonic-gate 
48741317Scth 			kmem_free(brn->brn_deviname,
48751317Scth 			    strlen(brn->brn_deviname) + 1);
48760Sstevel@tonic-gate 			kmem_free(brn, sizeof (*brn));
48770Sstevel@tonic-gate 		} else {
48780Sstevel@tonic-gate 			/*
48790Sstevel@tonic-gate 			 * Free up the outstanding branch remove events
48801317Scth 			 * queued on brn->brn_child since brn->brn_child
48810Sstevel@tonic-gate 			 * itself is eligible for branch remove event.
48820Sstevel@tonic-gate 			 */
48831317Scth 			if (brn->brn_child) {
48841317Scth 				free_brevq(brn->brn_child);
48851317Scth 				brn->brn_child = NULL;
48860Sstevel@tonic-gate 			}
48870Sstevel@tonic-gate 			prev_brn = brn;
48880Sstevel@tonic-gate 		}
48890Sstevel@tonic-gate 	}
48900Sstevel@tonic-gate 
48910Sstevel@tonic-gate 	ndi_devi_exit(dip, circ);
48920Sstevel@tonic-gate 	kmem_free(path, MAXPATHLEN);
48930Sstevel@tonic-gate }
48940Sstevel@tonic-gate 
48950Sstevel@tonic-gate static int
48960Sstevel@tonic-gate need_remove_event(dev_info_t *dip, int flags)
48970Sstevel@tonic-gate {
48980Sstevel@tonic-gate 	if ((flags & (NDI_NO_EVENT | NDI_AUTODETACH)) == 0 &&
48990Sstevel@tonic-gate 	    (flags & (NDI_DEVI_OFFLINE | NDI_UNCONFIG | NDI_DEVI_REMOVE)) &&
49000Sstevel@tonic-gate 	    !(DEVI_EVREMOVE(dip)))
49010Sstevel@tonic-gate 		return (1);
49020Sstevel@tonic-gate 	else
49030Sstevel@tonic-gate 		return (0);
49040Sstevel@tonic-gate }
49050Sstevel@tonic-gate 
49060Sstevel@tonic-gate /*
49070Sstevel@tonic-gate  * Unconfigure children/descendants of the dip.
49080Sstevel@tonic-gate  *
49090Sstevel@tonic-gate  * If the operation involves a branch event NDI_BRANCH_EVENT_OP is set
49100Sstevel@tonic-gate  * through out the unconfiguration. On successful return *brevqp is set to
49110Sstevel@tonic-gate  * a queue of dip's child devinames for which branch remove events need
49120Sstevel@tonic-gate  * to be generated.
49130Sstevel@tonic-gate  */
49140Sstevel@tonic-gate static int
49150Sstevel@tonic-gate devi_unconfig_branch(dev_info_t *dip, dev_info_t **dipp, int flags,
49160Sstevel@tonic-gate     struct brevq_node **brevqp)
49170Sstevel@tonic-gate {
49180Sstevel@tonic-gate 	int rval;
49190Sstevel@tonic-gate 
49200Sstevel@tonic-gate 	*brevqp = NULL;
49210Sstevel@tonic-gate 
49220Sstevel@tonic-gate 	if ((!(flags & NDI_BRANCH_EVENT_OP)) && need_remove_event(dip, flags))
49230Sstevel@tonic-gate 		flags |= NDI_BRANCH_EVENT_OP;
49240Sstevel@tonic-gate 
49250Sstevel@tonic-gate 	if (flags & NDI_BRANCH_EVENT_OP) {
49267009Scth 		rval = devi_unconfig_common(dip, dipp, flags, DDI_MAJOR_T_NONE,
49270Sstevel@tonic-gate 		    brevqp);
49280Sstevel@tonic-gate 
49290Sstevel@tonic-gate 		if (rval != NDI_SUCCESS && (*brevqp)) {
49300Sstevel@tonic-gate 			log_and_free_brevq_dip(dip, *brevqp);
49310Sstevel@tonic-gate 			*brevqp = NULL;
49320Sstevel@tonic-gate 		}
49330Sstevel@tonic-gate 	} else
49347009Scth 		rval = devi_unconfig_common(dip, dipp, flags, DDI_MAJOR_T_NONE,
49350Sstevel@tonic-gate 		    NULL);
49360Sstevel@tonic-gate 
49370Sstevel@tonic-gate 	return (rval);
49380Sstevel@tonic-gate }
49390Sstevel@tonic-gate 
49400Sstevel@tonic-gate /*
49410Sstevel@tonic-gate  * If the dip is already bound to a driver transition to DS_INITIALIZED
49420Sstevel@tonic-gate  * in order to generate an event in the case where the node was left in
49430Sstevel@tonic-gate  * DS_BOUND state since boot (never got attached) and the node is now
49440Sstevel@tonic-gate  * being offlined.
49450Sstevel@tonic-gate  */
49460Sstevel@tonic-gate static void
49470Sstevel@tonic-gate init_bound_node_ev(dev_info_t *pdip, dev_info_t *dip, int flags)
49480Sstevel@tonic-gate {
49490Sstevel@tonic-gate 	if (need_remove_event(dip, flags) &&
49500Sstevel@tonic-gate 	    i_ddi_node_state(dip) == DS_BOUND &&
49511333Scth 	    i_ddi_devi_attached(pdip) && !DEVI_IS_DEVICE_OFFLINE(dip))
49520Sstevel@tonic-gate 		(void) ddi_initchild(pdip, dip);
49530Sstevel@tonic-gate }
49540Sstevel@tonic-gate 
49550Sstevel@tonic-gate /*
49560Sstevel@tonic-gate  * attach a node/branch with parent already held busy
49570Sstevel@tonic-gate  */
49580Sstevel@tonic-gate static int
49590Sstevel@tonic-gate devi_attach_node(dev_info_t *dip, uint_t flags)
49600Sstevel@tonic-gate {
49612155Scth 	dev_info_t *pdip = ddi_get_parent(dip);
49622155Scth 
49632155Scth 	ASSERT(pdip && DEVI_BUSY_OWNED(pdip));
49642155Scth 
4965495Scth 	mutex_enter(&(DEVI(dip)->devi_lock));
49660Sstevel@tonic-gate 	if (flags & NDI_DEVI_ONLINE) {
49671333Scth 		if (!i_ddi_devi_attached(dip))
4968495Scth 			DEVI_SET_REPORT(dip);
49690Sstevel@tonic-gate 		DEVI_SET_DEVICE_ONLINE(dip);
49700Sstevel@tonic-gate 	}
49710Sstevel@tonic-gate 	if (DEVI_IS_DEVICE_OFFLINE(dip)) {
4972495Scth 		mutex_exit(&(DEVI(dip)->devi_lock));
49730Sstevel@tonic-gate 		return (NDI_FAILURE);
49740Sstevel@tonic-gate 	}
4975495Scth 	mutex_exit(&(DEVI(dip)->devi_lock));
49760Sstevel@tonic-gate 
49770Sstevel@tonic-gate 	if (i_ddi_attachchild(dip) != DDI_SUCCESS) {
4978495Scth 		mutex_enter(&(DEVI(dip)->devi_lock));
49790Sstevel@tonic-gate 		DEVI_SET_EVUNINIT(dip);
4980495Scth 		mutex_exit(&(DEVI(dip)->devi_lock));
4981495Scth 
49820Sstevel@tonic-gate 		if (ndi_dev_is_persistent_node(dip))
49830Sstevel@tonic-gate 			(void) ddi_uninitchild(dip);
49840Sstevel@tonic-gate 		else {
49850Sstevel@tonic-gate 			/*
49860Sstevel@tonic-gate 			 * Delete .conf nodes and nodes that are not
49870Sstevel@tonic-gate 			 * well formed.
49880Sstevel@tonic-gate 			 */
49890Sstevel@tonic-gate 			(void) ddi_remove_child(dip, 0);
49900Sstevel@tonic-gate 		}
49910Sstevel@tonic-gate 		return (NDI_FAILURE);
49920Sstevel@tonic-gate 	}
49930Sstevel@tonic-gate 
49940Sstevel@tonic-gate 	i_ndi_devi_report_status_change(dip, NULL);
49950Sstevel@tonic-gate 
49960Sstevel@tonic-gate 	/*
49970Sstevel@tonic-gate 	 * log an event, but not during devfs lookups in which case
49980Sstevel@tonic-gate 	 * NDI_NO_EVENT is set.
49990Sstevel@tonic-gate 	 */
50000Sstevel@tonic-gate 	if ((flags & NDI_NO_EVENT) == 0 && !(DEVI_EVADD(dip))) {
50010Sstevel@tonic-gate 		(void) i_log_devfs_add_devinfo(dip, flags);
5002495Scth 
5003495Scth 		mutex_enter(&(DEVI(dip)->devi_lock));
50040Sstevel@tonic-gate 		DEVI_SET_EVADD(dip);
5005495Scth 		mutex_exit(&(DEVI(dip)->devi_lock));
5006495Scth 	} else if (!(flags & NDI_NO_EVENT_STATE_CHNG)) {
5007495Scth 		mutex_enter(&(DEVI(dip)->devi_lock));
50080Sstevel@tonic-gate 		DEVI_SET_EVADD(dip);
5009495Scth 		mutex_exit(&(DEVI(dip)->devi_lock));
5010495Scth 	}
50110Sstevel@tonic-gate 
50120Sstevel@tonic-gate 	return (NDI_SUCCESS);
50130Sstevel@tonic-gate }
50140Sstevel@tonic-gate 
50150Sstevel@tonic-gate /* internal function to config immediate children */
50160Sstevel@tonic-gate static int
50170Sstevel@tonic-gate config_immediate_children(dev_info_t *pdip, uint_t flags, major_t major)
50180Sstevel@tonic-gate {
50192155Scth 	dev_info_t	*child, *next;
50202155Scth 	int		circ;
50212155Scth 
50221333Scth 	ASSERT(i_ddi_devi_attached(pdip));
50230Sstevel@tonic-gate 
50240Sstevel@tonic-gate 	if (!NEXUS_DRV(ddi_get_driver(pdip)))
50250Sstevel@tonic-gate 		return (NDI_SUCCESS);
50260Sstevel@tonic-gate 
50270Sstevel@tonic-gate 	NDI_CONFIG_DEBUG((CE_CONT,
50280Sstevel@tonic-gate 	    "config_immediate_children: %s%d (%p), flags=%x\n",
50290Sstevel@tonic-gate 	    ddi_driver_name(pdip), ddi_get_instance(pdip),
50300Sstevel@tonic-gate 	    (void *)pdip, flags));
50310Sstevel@tonic-gate 
50320Sstevel@tonic-gate 	ndi_devi_enter(pdip, &circ);
50330Sstevel@tonic-gate 
50340Sstevel@tonic-gate 	if (flags & NDI_CONFIG_REPROBE) {
50350Sstevel@tonic-gate 		mutex_enter(&DEVI(pdip)->devi_lock);
50360Sstevel@tonic-gate 		DEVI(pdip)->devi_flags &= ~DEVI_MADE_CHILDREN;
50370Sstevel@tonic-gate 		mutex_exit(&DEVI(pdip)->devi_lock);
50380Sstevel@tonic-gate 	}
50390Sstevel@tonic-gate 	(void) i_ndi_make_spec_children(pdip, flags);
50400Sstevel@tonic-gate 	i_ndi_init_hw_children(pdip, flags);
50412155Scth 
50422155Scth 	child = ddi_get_child(pdip);
50432155Scth 	while (child) {
50442155Scth 		/* NOTE: devi_attach_node() may remove the dip */
50452155Scth 		next = ddi_get_next_sibling(child);
50462155Scth 
50472155Scth 		/*
50482155Scth 		 * Configure all nexus nodes or leaf nodes with
50492155Scth 		 * matching driver major
50502155Scth 		 */
50517009Scth 		if ((major == DDI_MAJOR_T_NONE) ||
50522155Scth 		    (major == ddi_driver_major(child)) ||
50532155Scth 		    ((flags & NDI_CONFIG) && (is_leaf_node(child) == 0)))
50542155Scth 			(void) devi_attach_node(child, flags);
50552155Scth 		child = next;
50562155Scth 	}
50570Sstevel@tonic-gate 
50580Sstevel@tonic-gate 	ndi_devi_exit(pdip, circ);
50590Sstevel@tonic-gate 
50600Sstevel@tonic-gate 	return (NDI_SUCCESS);
50610Sstevel@tonic-gate }
50620Sstevel@tonic-gate 
50630Sstevel@tonic-gate /* internal function to config grand children */
50640Sstevel@tonic-gate static int
50650Sstevel@tonic-gate config_grand_children(dev_info_t *pdip, uint_t flags, major_t major)
50660Sstevel@tonic-gate {
50670Sstevel@tonic-gate 	struct mt_config_handle *hdl;
50680Sstevel@tonic-gate 
50690Sstevel@tonic-gate 	/* multi-threaded configuration of child nexus */
50700Sstevel@tonic-gate 	hdl = mt_config_init(pdip, NULL, flags, major, MT_CONFIG_OP, NULL);
50710Sstevel@tonic-gate 	mt_config_children(hdl);
50720Sstevel@tonic-gate 
50730Sstevel@tonic-gate 	return (mt_config_fini(hdl));	/* wait for threads to exit */
50740Sstevel@tonic-gate }
50750Sstevel@tonic-gate 
50760Sstevel@tonic-gate /*
50770Sstevel@tonic-gate  * Common function for device tree configuration,
50780Sstevel@tonic-gate  * either BUS_CONFIG_ALL or BUS_CONFIG_DRIVER.
50790Sstevel@tonic-gate  * The NDI_CONFIG flag causes recursive configuration of
50800Sstevel@tonic-gate  * grandchildren, devfs usage should not recurse.
50810Sstevel@tonic-gate  */
50820Sstevel@tonic-gate static int
50830Sstevel@tonic-gate devi_config_common(dev_info_t *dip, int flags, major_t major)
50840Sstevel@tonic-gate {
50850Sstevel@tonic-gate 	int error;
50860Sstevel@tonic-gate 	int (*f)();
50870Sstevel@tonic-gate 
50881333Scth 	if (!i_ddi_devi_attached(dip))
50890Sstevel@tonic-gate 		return (NDI_FAILURE);
50900Sstevel@tonic-gate 
50910Sstevel@tonic-gate 	if (pm_pre_config(dip, NULL) != DDI_SUCCESS)
50920Sstevel@tonic-gate 		return (NDI_FAILURE);
50930Sstevel@tonic-gate 
50940Sstevel@tonic-gate 	if ((DEVI(dip)->devi_ops->devo_bus_ops == NULL) ||
50950Sstevel@tonic-gate 	    (DEVI(dip)->devi_ops->devo_bus_ops->busops_rev < BUSO_REV_5) ||
50960Sstevel@tonic-gate 	    (f = DEVI(dip)->devi_ops->devo_bus_ops->bus_config) == NULL) {
50970Sstevel@tonic-gate 		error = config_immediate_children(dip, flags, major);
50980Sstevel@tonic-gate 	} else {
50990Sstevel@tonic-gate 		/* call bus_config entry point */
51007009Scth 		ddi_bus_config_op_t bus_op = (major == DDI_MAJOR_T_NONE) ?
51010Sstevel@tonic-gate 		    BUS_CONFIG_ALL : BUS_CONFIG_DRIVER;
51020Sstevel@tonic-gate 		error = (*f)(dip,
51030Sstevel@tonic-gate 		    flags, bus_op, (void *)(uintptr_t)major, NULL, 0);
51040Sstevel@tonic-gate 	}
51050Sstevel@tonic-gate 
51060Sstevel@tonic-gate 	if (error) {
51070Sstevel@tonic-gate 		pm_post_config(dip, NULL);
51080Sstevel@tonic-gate 		return (error);
51090Sstevel@tonic-gate 	}
51100Sstevel@tonic-gate 
51110Sstevel@tonic-gate 	/*
51120Sstevel@tonic-gate 	 * Some callers, notably SCSI, need to mark the devfs cache
51130Sstevel@tonic-gate 	 * to be rebuilt together with the config operation.
51140Sstevel@tonic-gate 	 */
51150Sstevel@tonic-gate 	if (flags & NDI_DEVFS_CLEAN)
51160Sstevel@tonic-gate 		(void) devfs_clean(dip, NULL, 0);
51170Sstevel@tonic-gate 
51180Sstevel@tonic-gate 	if (flags & NDI_CONFIG)
51190Sstevel@tonic-gate 		(void) config_grand_children(dip, flags, major);
51200Sstevel@tonic-gate 
51210Sstevel@tonic-gate 	pm_post_config(dip, NULL);
51220Sstevel@tonic-gate 
51230Sstevel@tonic-gate 	return (NDI_SUCCESS);
51240Sstevel@tonic-gate }
51250Sstevel@tonic-gate 
51260Sstevel@tonic-gate /*
51270Sstevel@tonic-gate  * Framework entry point for BUS_CONFIG_ALL
51280Sstevel@tonic-gate  */
51290Sstevel@tonic-gate int
51300Sstevel@tonic-gate ndi_devi_config(dev_info_t *dip, int flags)
51310Sstevel@tonic-gate {
51320Sstevel@tonic-gate 	NDI_CONFIG_DEBUG((CE_CONT,
51330Sstevel@tonic-gate 	    "ndi_devi_config: par = %s%d (%p), flags = 0x%x\n",
51340Sstevel@tonic-gate 	    ddi_driver_name(dip), ddi_get_instance(dip), (void *)dip, flags));
51350Sstevel@tonic-gate 
51367009Scth 	return (devi_config_common(dip, flags, DDI_MAJOR_T_NONE));
51370Sstevel@tonic-gate }
51380Sstevel@tonic-gate 
51390Sstevel@tonic-gate /*
51400Sstevel@tonic-gate  * Framework entry point for BUS_CONFIG_DRIVER, bound to major
51410Sstevel@tonic-gate  */
51420Sstevel@tonic-gate int
51430Sstevel@tonic-gate ndi_devi_config_driver(dev_info_t *dip, int flags, major_t major)
51440Sstevel@tonic-gate {
51450Sstevel@tonic-gate 	/* don't abuse this function */
51467009Scth 	ASSERT(major != DDI_MAJOR_T_NONE);
51470Sstevel@tonic-gate 
51480Sstevel@tonic-gate 	NDI_CONFIG_DEBUG((CE_CONT,
51490Sstevel@tonic-gate 	    "ndi_devi_config_driver: par = %s%d (%p), flags = 0x%x\n",
51500Sstevel@tonic-gate 	    ddi_driver_name(dip), ddi_get_instance(dip), (void *)dip, flags));
51510Sstevel@tonic-gate 
51520Sstevel@tonic-gate 	return (devi_config_common(dip, flags, major));
51530Sstevel@tonic-gate }
51540Sstevel@tonic-gate 
51550Sstevel@tonic-gate /*
51562155Scth  * Called by nexus drivers to configure its children.
51570Sstevel@tonic-gate  */
51580Sstevel@tonic-gate static int
51592155Scth devi_config_one(dev_info_t *pdip, char *devnm, dev_info_t **cdipp,
51600Sstevel@tonic-gate     uint_t flags, clock_t timeout)
51610Sstevel@tonic-gate {
51622155Scth 	dev_info_t	*vdip = NULL;
51632155Scth 	char		*drivername = NULL;
51644145Scth 	int		find_by_addr = 0;
51652155Scth 	char		*name, *addr;
51662155Scth 	int		v_circ, p_circ;
51672155Scth 	clock_t		end_time;	/* 60 sec */
51682155Scth 	int		probed;
51692155Scth 	dev_info_t	*cdip;
51702155Scth 	mdi_pathinfo_t	*cpip;
51712155Scth 
51722155Scth 	*cdipp = NULL;
51730Sstevel@tonic-gate 
51740Sstevel@tonic-gate 	if (!NEXUS_DRV(ddi_get_driver(pdip)))
51750Sstevel@tonic-gate 		return (NDI_FAILURE);
51760Sstevel@tonic-gate 
51770Sstevel@tonic-gate 	/* split name into "name@addr" parts */
51780Sstevel@tonic-gate 	i_ddi_parse_name(devnm, &name, &addr, NULL);
51790Sstevel@tonic-gate 
51802155Scth 	/*
51812155Scth 	 * If the nexus is a pHCI and we are not processing a pHCI from
51822155Scth 	 * mdi bus_config code then we need to know the vHCI.
51832155Scth 	 */
51842155Scth 	if (MDI_PHCI(pdip))
51852155Scth 		vdip = mdi_devi_get_vdip(pdip);
51862155Scth 
51872155Scth 	/*
51882155Scth 	 * We may have a genericname on a system that creates drivername
51892155Scth 	 * nodes (from .conf files).  Find the drivername by nodeid. If we
51902155Scth 	 * can't find a node with devnm as the node name then we search by
51912155Scth 	 * drivername.  This allows an implementation to supply a genericly
51925742Scth 	 * named boot path (disk) and locate drivename nodes (sd).  The
51935742Scth 	 * NDI_PROMNAME flag does not apply to /devices/pseudo paths.
51942155Scth 	 */
51955742Scth 	if ((flags & NDI_PROMNAME) && (pdip != pseudo_dip)) {
51962009Sdm120769 		drivername = child_path_to_driver(pdip, name, addr);
51974145Scth 		find_by_addr = 1;
51984145Scth 	}
51992155Scth 
52002155Scth 	/*
52012155Scth 	 * Determine end_time: This routine should *not* be called with a
52022155Scth 	 * constant non-zero timeout argument, the caller should be adjusting
52032155Scth 	 * the timeout argument relative to when it *started* its asynchronous
52042155Scth 	 * enumeration.
52052155Scth 	 */
52062155Scth 	if (timeout > 0)
52072009Sdm120769 		end_time = ddi_get_lbolt() + timeout;
52082155Scth 
52092009Sdm120769 	for (;;) {
52101961Scth 		/*
52112155Scth 		 * For pHCI, enter (vHCI, pHCI) and search for pathinfo/client
52122155Scth 		 * child - break out of for(;;) loop if child found.
52132155Scth 		 * NOTE: Lock order for ndi_devi_enter is (vHCI, pHCI).
52142155Scth 		 */
52152155Scth 		if (vdip) {
52162155Scth 			/* use mdi_devi_enter ordering */
52172155Scth 			ndi_devi_enter(vdip, &v_circ);
52182155Scth 			ndi_devi_enter(pdip, &p_circ);
52192155Scth 			cpip = mdi_pi_find(pdip, NULL, addr);
52202155Scth 			cdip = mdi_pi_get_client(cpip);
52212155Scth 			if (cdip)
52222155Scth 				break;
52232155Scth 		} else
52242155Scth 			ndi_devi_enter(pdip, &p_circ);
52252155Scth 
52262155Scth 		/*
52272155Scth 		 * When not a  vHCI or not all pHCI devices are required to
52282155Scth 		 * enumerated under the vHCI (NDI_MDI_FALLBACK) search for
52292155Scth 		 * devinfo child.
52300Sstevel@tonic-gate 		 */
52312155Scth 		if ((vdip == NULL) || (flags & NDI_MDI_FALLBACK)) {
52322155Scth 			/* determine if .conf nodes already built */
52332155Scth 			probed = (DEVI(pdip)->devi_flags & DEVI_MADE_CHILDREN);
52342155Scth 
52352155Scth 			/*
52362155Scth 			 * Search for child by name, if not found then search
52372155Scth 			 * for a node bound to the drivername driver with the
52382155Scth 			 * specified "@addr". Break out of for(;;) loop if
52394145Scth 			 * child found.  To support path-oriented aliases
52404145Scth 			 * binding on boot-device, we do a search_by_addr too.
52412155Scth 			 */
52422155Scth again:			(void) i_ndi_make_spec_children(pdip, flags);
52432155Scth 			cdip = find_child_by_name(pdip, name, addr);
52442155Scth 			if ((cdip == NULL) && drivername)
52452155Scth 				cdip = find_child_by_driver(pdip,
52462155Scth 				    drivername, addr);
52474145Scth 			if ((cdip == NULL) && find_by_addr)
52484145Scth 				cdip = find_child_by_addr(pdip, addr);
52492155Scth 			if (cdip)
52502155Scth 				break;
52512155Scth 
52522155Scth 			/*
52532155Scth 			 * determine if we should reenumerate .conf nodes
52542155Scth 			 * and look for child again.
52552155Scth 			 */
52562155Scth 			if (probed &&
52572155Scth 			    i_ddi_io_initialized() &&
52582155Scth 			    (flags & NDI_CONFIG_REPROBE) &&
52592155Scth 			    ((timeout <= 0) || (ddi_get_lbolt() >= end_time))) {
52602155Scth 				probed = 0;
52612155Scth 				mutex_enter(&DEVI(pdip)->devi_lock);
52622155Scth 				DEVI(pdip)->devi_flags &= ~DEVI_MADE_CHILDREN;
52632155Scth 				mutex_exit(&DEVI(pdip)->devi_lock);
52642155Scth 				goto again;
52652155Scth 			}
52662155Scth 		}
52672155Scth 
52682155Scth 		/* break out of for(;;) if time expired */
52692155Scth 		if ((timeout <= 0) || (ddi_get_lbolt() >= end_time))
52700Sstevel@tonic-gate 			break;
52710Sstevel@tonic-gate 
52720Sstevel@tonic-gate 		/*
52732155Scth 		 * Child not found, exit and wait for asynchronous enumeration
52742155Scth 		 * to add child (or timeout). The addition of a new child (vhci
52752155Scth 		 * or phci) requires the asynchronous enumeration thread to
52762155Scth 		 * ndi_devi_enter/ndi_devi_exit. This exit will signal devi_cv
52772155Scth 		 * and cause us to return from ndi_devi_exit_and_wait, after
52782155Scth 		 * which we loop and search for the requested child again.
52790Sstevel@tonic-gate 		 */
52800Sstevel@tonic-gate 		NDI_DEBUG(flags, (CE_CONT,
52810Sstevel@tonic-gate 		    "%s%d: waiting for child %s@%s, timeout %ld",
52820Sstevel@tonic-gate 		    ddi_driver_name(pdip), ddi_get_instance(pdip),
52830Sstevel@tonic-gate 		    name, addr, timeout));
52842155Scth 		if (vdip) {
52852155Scth 			/*
52862155Scth 			 * Mark vHCI for pHCI ndi_devi_exit broadcast.
52872155Scth 			 */
52882155Scth 			mutex_enter(&DEVI(vdip)->devi_lock);
52892155Scth 			DEVI(vdip)->devi_flags |=
52902155Scth 			    DEVI_PHCI_SIGNALS_VHCI;
52912155Scth 			mutex_exit(&DEVI(vdip)->devi_lock);
52922155Scth 			ndi_devi_exit(pdip, p_circ);
52932155Scth 
52942155Scth 			/*
52952155Scth 			 * NB: There is a small race window from above
52962155Scth 			 * ndi_devi_exit() of pdip to cv_wait() in
52972155Scth 			 * ndi_devi_exit_and_wait() which can result in
52982155Scth 			 * not immediately finding a new pHCI child
52992155Scth 			 * of a pHCI that uses NDI_MDI_FAILBACK.
53002155Scth 			 */
53012155Scth 			ndi_devi_exit_and_wait(vdip, v_circ, end_time);
53022155Scth 		} else {
53032155Scth 			ndi_devi_exit_and_wait(pdip, p_circ, end_time);
53042155Scth 		}
53052155Scth 	}
53062155Scth 
53072155Scth 	/* done with paddr, fixup i_ddi_parse_name '@'->'\0' change */
53082155Scth 	if (addr && *addr != '\0')
53090Sstevel@tonic-gate 		*(addr - 1) = '@';
53100Sstevel@tonic-gate 
53112155Scth 	/* attach and hold the child, returning pointer to child */
53122155Scth 	if (cdip && (devi_attach_node(cdip, flags) == NDI_SUCCESS)) {
53132155Scth 		ndi_hold_devi(cdip);
53142155Scth 		*cdipp = cdip;
53152155Scth 	}
53162155Scth 
53172155Scth 	ndi_devi_exit(pdip, p_circ);
53182155Scth 	if (vdip)
53192155Scth 		ndi_devi_exit(vdip, v_circ);
53202155Scth 	return (*cdipp ? NDI_SUCCESS : NDI_FAILURE);
53210Sstevel@tonic-gate }
53220Sstevel@tonic-gate 
53230Sstevel@tonic-gate /*
53240Sstevel@tonic-gate  * Enumerate and attach a child specified by name 'devnm'.
53250Sstevel@tonic-gate  * Called by devfs lookup and DR to perform a BUS_CONFIG_ONE.
53260Sstevel@tonic-gate  * Note: devfs does not make use of NDI_CONFIG to configure
53270Sstevel@tonic-gate  * an entire branch.
53280Sstevel@tonic-gate  */
53290Sstevel@tonic-gate int
53300Sstevel@tonic-gate ndi_devi_config_one(dev_info_t *dip, char *devnm, dev_info_t **dipp, int flags)
53310Sstevel@tonic-gate {
53320Sstevel@tonic-gate 	int error;
53330Sstevel@tonic-gate 	int (*f)();
53340Sstevel@tonic-gate 	int branch_event = 0;
53350Sstevel@tonic-gate 
53360Sstevel@tonic-gate 	ASSERT(dipp);
53371333Scth 	ASSERT(i_ddi_devi_attached(dip));
53380Sstevel@tonic-gate 
53390Sstevel@tonic-gate 	NDI_CONFIG_DEBUG((CE_CONT,
53400Sstevel@tonic-gate 	    "ndi_devi_config_one: par = %s%d (%p), child = %s\n",
53410Sstevel@tonic-gate 	    ddi_driver_name(dip), ddi_get_instance(dip), (void *)dip, devnm));
53420Sstevel@tonic-gate 
53430Sstevel@tonic-gate 	if (pm_pre_config(dip, devnm) != DDI_SUCCESS)
53440Sstevel@tonic-gate 		return (NDI_FAILURE);
53450Sstevel@tonic-gate 
53460Sstevel@tonic-gate 	if ((flags & (NDI_NO_EVENT | NDI_BRANCH_EVENT_OP)) == 0 &&
53470Sstevel@tonic-gate 	    (flags & NDI_CONFIG)) {
53480Sstevel@tonic-gate 		flags |= NDI_BRANCH_EVENT_OP;
53490Sstevel@tonic-gate 		branch_event = 1;
53500Sstevel@tonic-gate 	}
53510Sstevel@tonic-gate 
53520Sstevel@tonic-gate 	if ((DEVI(dip)->devi_ops->devo_bus_ops == NULL) ||
53530Sstevel@tonic-gate 	    (DEVI(dip)->devi_ops->devo_bus_ops->busops_rev < BUSO_REV_5) ||
53540Sstevel@tonic-gate 	    (f = DEVI(dip)->devi_ops->devo_bus_ops->bus_config) == NULL) {
53550Sstevel@tonic-gate 		error = devi_config_one(dip, devnm, dipp, flags, 0);
53560Sstevel@tonic-gate 	} else {
53570Sstevel@tonic-gate 		/* call bus_config entry point */
53580Sstevel@tonic-gate 		error = (*f)(dip, flags, BUS_CONFIG_ONE, (void *)devnm, dipp);
53590Sstevel@tonic-gate 	}
53600Sstevel@tonic-gate 
53610Sstevel@tonic-gate 	if (error || (flags & NDI_CONFIG) == 0) {
53620Sstevel@tonic-gate 		pm_post_config(dip, devnm);
53630Sstevel@tonic-gate 		return (error);
53640Sstevel@tonic-gate 	}
53650Sstevel@tonic-gate 
53660Sstevel@tonic-gate 	/*
53674145Scth 	 * DR usage (i.e. call with NDI_CONFIG) recursively configures
53680Sstevel@tonic-gate 	 * grandchildren, performing a BUS_CONFIG_ALL from the node attached
53690Sstevel@tonic-gate 	 * by the BUS_CONFIG_ONE.
53700Sstevel@tonic-gate 	 */
53710Sstevel@tonic-gate 	ASSERT(*dipp);
53720Sstevel@tonic-gate 
53737009Scth 	error = devi_config_common(*dipp, flags, DDI_MAJOR_T_NONE);
53740Sstevel@tonic-gate 
53750Sstevel@tonic-gate 	pm_post_config(dip, devnm);
53760Sstevel@tonic-gate 
53770Sstevel@tonic-gate 	if (branch_event)
53780Sstevel@tonic-gate 		(void) i_log_devfs_branch_add(*dipp);
53790Sstevel@tonic-gate 
53800Sstevel@tonic-gate 	return (error);
53810Sstevel@tonic-gate }
53820Sstevel@tonic-gate 
53830Sstevel@tonic-gate 
53840Sstevel@tonic-gate /*
53850Sstevel@tonic-gate  * Enumerate and attach a child specified by name 'devnm'.
53860Sstevel@tonic-gate  * Called during configure the OBP options. This configures
53870Sstevel@tonic-gate  * only one node.
53880Sstevel@tonic-gate  */
53890Sstevel@tonic-gate static int
53900Sstevel@tonic-gate ndi_devi_config_obp_args(dev_info_t *parent, char *devnm,
53910Sstevel@tonic-gate     dev_info_t **childp, int flags)
53920Sstevel@tonic-gate {
53930Sstevel@tonic-gate 	int error;
53940Sstevel@tonic-gate 	int (*f)();
53950Sstevel@tonic-gate 
53960Sstevel@tonic-gate 	ASSERT(childp);
53971333Scth 	ASSERT(i_ddi_devi_attached(parent));
53980Sstevel@tonic-gate 
53990Sstevel@tonic-gate 	NDI_CONFIG_DEBUG((CE_CONT, "ndi_devi_config_obp_args: "
54000Sstevel@tonic-gate 	    "par = %s%d (%p), child = %s\n", ddi_driver_name(parent),
54010Sstevel@tonic-gate 	    ddi_get_instance(parent), (void *)parent, devnm));
54020Sstevel@tonic-gate 
54030Sstevel@tonic-gate 	if ((DEVI(parent)->devi_ops->devo_bus_ops == NULL) ||
54040Sstevel@tonic-gate 	    (DEVI(parent)->devi_ops->devo_bus_ops->busops_rev < BUSO_REV_5) ||
54050Sstevel@tonic-gate 	    (f = DEVI(parent)->devi_ops->devo_bus_ops->bus_config) == NULL) {
54060Sstevel@tonic-gate 		error = NDI_FAILURE;
54070Sstevel@tonic-gate 	} else {
54080Sstevel@tonic-gate 		/* call bus_config entry point */
54090Sstevel@tonic-gate 		error = (*f)(parent, flags,
54100Sstevel@tonic-gate 		    BUS_CONFIG_OBP_ARGS, (void *)devnm, childp);
54110Sstevel@tonic-gate 	}
54120Sstevel@tonic-gate 	return (error);
54130Sstevel@tonic-gate }
54140Sstevel@tonic-gate 
54154845Svikram /*
54164845Svikram  * Pay attention, the following is a bit tricky:
54174845Svikram  * There are three possible cases when constraints are applied
54184845Svikram  *
54194845Svikram  *	- A constraint is applied and the offline is disallowed.
54204845Svikram  *	  Simply return failure and block the offline
54214845Svikram  *
54224845Svikram  *	- A constraint is applied and the offline is allowed.
54234845Svikram  *	  Mark the dip as having passed the constraint and allow
54244845Svikram  *	  offline to proceed.
54254845Svikram  *
54264845Svikram  *	- A constraint is not applied. Allow the offline to proceed for now.
54274845Svikram  *
54284845Svikram  * In the latter two cases we allow the offline to proceed. If the
54294845Svikram  * offline succeeds (no users) everything is fine. It is ok for an unused
54304845Svikram  * device to be offlined even if no constraints were imposed on the offline.
54314845Svikram  * If the offline fails because there are users, we look at the constraint
54324845Svikram  * flag on the dip. If the constraint flag is set (implying that it passed
54334845Svikram  * a constraint) we allow the dip to be retired. If not, we don't allow
54344845Svikram  * the retire. This ensures that we don't allow unconstrained retire.
54354845Svikram  */
54364845Svikram int
54374845Svikram e_ddi_offline_notify(dev_info_t *dip)
54384845Svikram {
54394845Svikram 	int retval;
54404845Svikram 	int constraint;
54414845Svikram 	int failure;
54424845Svikram 
54434845Svikram 	RIO_VERBOSE((CE_NOTE, "e_ddi_offline_notify(): entered: dip=%p",
54444845Svikram 	    (void *) dip));
54454845Svikram 
54464845Svikram 	constraint = 0;
54474845Svikram 	failure = 0;
54484845Svikram 
54494845Svikram 	/*
54504845Svikram 	 * Start with userland constraints first - applied via device contracts
54514845Svikram 	 */
54524845Svikram 	retval = contract_device_offline(dip, DDI_DEV_T_ANY, 0);
54534845Svikram 	switch (retval) {
54544845Svikram 	case CT_NACK:
54554845Svikram 		RIO_DEBUG((CE_NOTE, "Received NACK for dip=%p", (void *)dip));
54564845Svikram 		failure = 1;
54574845Svikram 		goto out;
54584845Svikram 	case CT_ACK:
54594845Svikram 		constraint = 1;
54604845Svikram 		RIO_DEBUG((CE_NOTE, "Received ACK for dip=%p", (void *)dip));
54614845Svikram 		break;
54624845Svikram 	case CT_NONE:
54634845Svikram 		/* no contracts */
54644845Svikram 		RIO_DEBUG((CE_NOTE, "No contracts on dip=%p", (void *)dip));
54654845Svikram 		break;
54664845Svikram 	default:
54674845Svikram 		ASSERT(retval == CT_NONE);
54684845Svikram 	}
54694845Svikram 
54704845Svikram 	/*
54714845Svikram 	 * Next, use LDI to impose kernel constraints
54724845Svikram 	 */
54734845Svikram 	retval = ldi_invoke_notify(dip, DDI_DEV_T_ANY, 0, LDI_EV_OFFLINE, NULL);
54744845Svikram 	switch (retval) {
54754845Svikram 	case LDI_EV_FAILURE:
54764845Svikram 		contract_device_negend(dip, DDI_DEV_T_ANY, 0, CT_EV_FAILURE);
54774845Svikram 		RIO_DEBUG((CE_NOTE, "LDI callback failed on dip=%p",
54784845Svikram 		    (void *)dip));
54794845Svikram 		failure = 1;
54804845Svikram 		goto out;
54814845Svikram 	case LDI_EV_SUCCESS:
54824845Svikram 		constraint = 1;
54834845Svikram 		RIO_DEBUG((CE_NOTE, "LDI callback success on dip=%p",
54844845Svikram 		    (void *)dip));
54854845Svikram 		break;
54864845Svikram 	case LDI_EV_NONE:
54874845Svikram 		/* no matching LDI callbacks */
54884845Svikram 		RIO_DEBUG((CE_NOTE, "No LDI callbacks for dip=%p",
54894845Svikram 		    (void *)dip));
54904845Svikram 		break;
54914845Svikram 	default:
54924845Svikram 		ASSERT(retval == LDI_EV_NONE);
54934845Svikram 	}
54944845Svikram 
54954845Svikram out:
54964845Svikram 	mutex_enter(&(DEVI(dip)->devi_lock));
54974845Svikram 	if ((DEVI(dip)->devi_flags & DEVI_RETIRING) && failure) {
54984845Svikram 		RIO_VERBOSE((CE_NOTE, "e_ddi_offline_notify(): setting "
54994845Svikram 		    "BLOCKED flag. dip=%p", (void *)dip));
55004845Svikram 		DEVI(dip)->devi_flags |= DEVI_R_BLOCKED;
55014845Svikram 		if (DEVI(dip)->devi_flags & DEVI_R_CONSTRAINT) {
55024845Svikram 			RIO_VERBOSE((CE_NOTE, "e_ddi_offline_notify(): "
55034845Svikram 			    "blocked. clearing RCM CONSTRAINT flag. dip=%p",
55044845Svikram 			    (void *)dip));
55054845Svikram 			DEVI(dip)->devi_flags &= ~DEVI_R_CONSTRAINT;
55064845Svikram 		}
55074845Svikram 	} else if ((DEVI(dip)->devi_flags & DEVI_RETIRING) && constraint) {
55084845Svikram 		RIO_VERBOSE((CE_NOTE, "e_ddi_offline_notify(): setting "
55094845Svikram 		    "CONSTRAINT flag. dip=%p", (void *)dip));
55104845Svikram 		DEVI(dip)->devi_flags |= DEVI_R_CONSTRAINT;
55114845Svikram 	} else if ((DEVI(dip)->devi_flags & DEVI_RETIRING) &&
55124845Svikram 	    DEVI(dip)->devi_ref == 0) {
55134845Svikram 		/* also allow retire if device is not in use */
55144845Svikram 		RIO_VERBOSE((CE_NOTE, "e_ddi_offline_notify(): device not in "
55154845Svikram 		    "use. Setting CONSTRAINT flag. dip=%p", (void *)dip));
55164845Svikram 		DEVI(dip)->devi_flags |= DEVI_R_CONSTRAINT;
55174845Svikram 	} else {
55184845Svikram 		/*
55194845Svikram 		 * Note: We cannot ASSERT here that DEVI_R_CONSTRAINT is
55204845Svikram 		 * not set, since other sources (such as RCM) may have
55214845Svikram 		 * set the flag.
55224845Svikram 		 */
55234845Svikram 		RIO_VERBOSE((CE_NOTE, "e_ddi_offline_notify(): not setting "
55244845Svikram 		    "constraint flag. dip=%p", (void *)dip));
55254845Svikram 	}
55264845Svikram 	mutex_exit(&(DEVI(dip)->devi_lock));
55274845Svikram 
55284845Svikram 
55294845Svikram 	RIO_VERBOSE((CE_NOTE, "e_ddi_offline_notify(): exit: dip=%p",
55304845Svikram 	    (void *) dip));
55314845Svikram 
55324845Svikram 	return (failure ? DDI_FAILURE : DDI_SUCCESS);
55334845Svikram }
55344845Svikram 
55354845Svikram void
55364845Svikram e_ddi_offline_finalize(dev_info_t *dip, int result)
55374845Svikram {
55384845Svikram 	RIO_DEBUG((CE_NOTE, "e_ddi_offline_finalize(): entry: result=%s, "
55394845Svikram 	    "dip=%p", result == DDI_SUCCESS ? "SUCCESS" : "FAILURE",
55404845Svikram 	    (void *)dip));
55414845Svikram 
55424845Svikram 	contract_device_negend(dip, DDI_DEV_T_ANY, 0,  result == DDI_SUCCESS ?
55434845Svikram 	    CT_EV_SUCCESS : CT_EV_FAILURE);
55444845Svikram 
55454845Svikram 	ldi_invoke_finalize(dip, DDI_DEV_T_ANY, 0,
55464845Svikram 	    LDI_EV_OFFLINE, result == DDI_SUCCESS ?
55474845Svikram 	    LDI_EV_SUCCESS : LDI_EV_FAILURE, NULL);
55484845Svikram 
55494845Svikram 	RIO_VERBOSE((CE_NOTE, "e_ddi_offline_finalize(): exit: dip=%p",
55504845Svikram 	    (void *)dip));
55514845Svikram }
55524845Svikram 
55534845Svikram void
55544845Svikram e_ddi_degrade_finalize(dev_info_t *dip)
55554845Svikram {
55564845Svikram 	RIO_DEBUG((CE_NOTE, "e_ddi_degrade_finalize(): entry: "
55574845Svikram 	    "result always = DDI_SUCCESS, dip=%p", (void *)dip));
55584845Svikram 
55594845Svikram 	contract_device_degrade(dip, DDI_DEV_T_ANY, 0);
55604845Svikram 	contract_device_negend(dip, DDI_DEV_T_ANY, 0, CT_EV_SUCCESS);
55614845Svikram 
55624845Svikram 	ldi_invoke_finalize(dip, DDI_DEV_T_ANY, 0, LDI_EV_DEGRADE,
55634845Svikram 	    LDI_EV_SUCCESS, NULL);
55644845Svikram 
55654845Svikram 	RIO_VERBOSE((CE_NOTE, "e_ddi_degrade_finalize(): exit: dip=%p",
55664845Svikram 	    (void *)dip));
55674845Svikram }
55684845Svikram 
55694845Svikram void
55704845Svikram e_ddi_undegrade_finalize(dev_info_t *dip)
55714845Svikram {
55724845Svikram 	RIO_DEBUG((CE_NOTE, "e_ddi_undegrade_finalize(): entry: "
55734845Svikram 	    "result always = DDI_SUCCESS, dip=%p", (void *)dip));
55744845Svikram 
55754845Svikram 	contract_device_undegrade(dip, DDI_DEV_T_ANY, 0);
55764845Svikram 	contract_device_negend(dip, DDI_DEV_T_ANY, 0, CT_EV_SUCCESS);
55774845Svikram 
55784845Svikram 	RIO_VERBOSE((CE_NOTE, "e_ddi_undegrade_finalize(): exit: dip=%p",
55794845Svikram 	    (void *)dip));
55804845Svikram }
55810Sstevel@tonic-gate 
55820Sstevel@tonic-gate /*
55830Sstevel@tonic-gate  * detach a node with parent already held busy
55840Sstevel@tonic-gate  */
55850Sstevel@tonic-gate static int
55860Sstevel@tonic-gate devi_detach_node(dev_info_t *dip, uint_t flags)
55870Sstevel@tonic-gate {
55880Sstevel@tonic-gate 	dev_info_t *pdip = ddi_get_parent(dip);
55890Sstevel@tonic-gate 	int ret = NDI_SUCCESS;
55900Sstevel@tonic-gate 	ddi_eventcookie_t cookie;
55910Sstevel@tonic-gate 
55922155Scth 	ASSERT(pdip && DEVI_BUSY_OWNED(pdip));
55932155Scth 
55944845Svikram 	/*
55954845Svikram 	 * Invoke notify if offlining
55964845Svikram 	 */
55974845Svikram 	if (flags & NDI_DEVI_OFFLINE) {
55984845Svikram 		RIO_DEBUG((CE_NOTE, "devi_detach_node: offlining dip=%p",
55994845Svikram 		    (void *)dip));
56004845Svikram 		if (e_ddi_offline_notify(dip) != DDI_SUCCESS) {
56014845Svikram 			RIO_DEBUG((CE_NOTE, "devi_detach_node: offline NACKed"
56024845Svikram 			    "dip=%p", (void *)dip));
56034845Svikram 			return (NDI_FAILURE);
56044845Svikram 		}
56054845Svikram 	}
56064845Svikram 
56070Sstevel@tonic-gate 	if (flags & NDI_POST_EVENT) {
56082155Scth 		if (i_ddi_devi_attached(pdip)) {
56090Sstevel@tonic-gate 			if (ddi_get_eventcookie(dip, DDI_DEVI_REMOVE_EVENT,
56100Sstevel@tonic-gate 			    &cookie) == NDI_SUCCESS)
56110Sstevel@tonic-gate 				(void) ndi_post_event(dip, dip, cookie, NULL);
56120Sstevel@tonic-gate 		}
56130Sstevel@tonic-gate 	}
56140Sstevel@tonic-gate 
56154845Svikram 	if (i_ddi_detachchild(dip, flags) != DDI_SUCCESS) {
56164845Svikram 		if (flags & NDI_DEVI_OFFLINE) {
56174845Svikram 			RIO_DEBUG((CE_NOTE, "devi_detach_node: offline failed."
56184845Svikram 			    " Calling e_ddi_offline_finalize with result=%d. "
56194845Svikram 			    "dip=%p", DDI_FAILURE, (void *)dip));
56204845Svikram 			e_ddi_offline_finalize(dip, DDI_FAILURE);
56214845Svikram 		}
56220Sstevel@tonic-gate 		return (NDI_FAILURE);
56234845Svikram 	}
56244845Svikram 
56254845Svikram 	if (flags & NDI_DEVI_OFFLINE) {
56264845Svikram 		RIO_DEBUG((CE_NOTE, "devi_detach_node: offline succeeded."
56274845Svikram 		    " Calling e_ddi_offline_finalize with result=%d, "
56284845Svikram 		    "dip=%p", DDI_SUCCESS, (void *)dip));
56294845Svikram 		e_ddi_offline_finalize(dip, DDI_SUCCESS);
56304845Svikram 	}
56310Sstevel@tonic-gate 
56320Sstevel@tonic-gate 	if (flags & NDI_AUTODETACH)
56330Sstevel@tonic-gate 		return (NDI_SUCCESS);
56340Sstevel@tonic-gate 
56350Sstevel@tonic-gate 	/*
56360Sstevel@tonic-gate 	 * For DR, even bound nodes may need to have offline
56370Sstevel@tonic-gate 	 * flag set.
56380Sstevel@tonic-gate 	 */
56390Sstevel@tonic-gate 	if (flags & NDI_DEVI_OFFLINE) {
5640495Scth 		mutex_enter(&(DEVI(dip)->devi_lock));
56410Sstevel@tonic-gate 		DEVI_SET_DEVICE_OFFLINE(dip);
5642495Scth 		mutex_exit(&(DEVI(dip)->devi_lock));
56430Sstevel@tonic-gate 	}
56440Sstevel@tonic-gate 
56450Sstevel@tonic-gate 	if (i_ddi_node_state(dip) == DS_INITIALIZED) {
56460Sstevel@tonic-gate 		char *path = kmem_alloc(MAXPATHLEN, KM_SLEEP);
56470Sstevel@tonic-gate 		(void) ddi_pathname(dip, path);
56480Sstevel@tonic-gate 		if (flags & NDI_DEVI_OFFLINE)
56490Sstevel@tonic-gate 			i_ndi_devi_report_status_change(dip, path);
56500Sstevel@tonic-gate 
56510Sstevel@tonic-gate 		if (need_remove_event(dip, flags)) {
56520Sstevel@tonic-gate 			(void) i_log_devfs_remove_devinfo(path,
56530Sstevel@tonic-gate 			    i_ddi_devi_class(dip),
56540Sstevel@tonic-gate 			    (char *)ddi_driver_name(dip),
56550Sstevel@tonic-gate 			    ddi_get_instance(dip),
56560Sstevel@tonic-gate 			    flags);
5657495Scth 			mutex_enter(&(DEVI(dip)->devi_lock));
56580Sstevel@tonic-gate 			DEVI_SET_EVREMOVE(dip);
5659495Scth 			mutex_exit(&(DEVI(dip)->devi_lock));
56600Sstevel@tonic-gate 		}
56610Sstevel@tonic-gate 		kmem_free(path, MAXPATHLEN);
56620Sstevel@tonic-gate 	}
56630Sstevel@tonic-gate 
56640Sstevel@tonic-gate 	if (flags & (NDI_UNCONFIG | NDI_DEVI_REMOVE)) {
56650Sstevel@tonic-gate 		ret = ddi_uninitchild(dip);
56660Sstevel@tonic-gate 		if (ret == NDI_SUCCESS) {
56670Sstevel@tonic-gate 			/*
56680Sstevel@tonic-gate 			 * Remove uninitialized pseudo nodes because
56690Sstevel@tonic-gate 			 * system props are lost and the node cannot be
56700Sstevel@tonic-gate 			 * reattached.
56710Sstevel@tonic-gate 			 */
56720Sstevel@tonic-gate 			if (!ndi_dev_is_persistent_node(dip))
56730Sstevel@tonic-gate 				flags |= NDI_DEVI_REMOVE;
56740Sstevel@tonic-gate 
56750Sstevel@tonic-gate 			if (flags & NDI_DEVI_REMOVE)
56760Sstevel@tonic-gate 				ret = ddi_remove_child(dip, 0);
56770Sstevel@tonic-gate 		}
56780Sstevel@tonic-gate 	}
56790Sstevel@tonic-gate 
56800Sstevel@tonic-gate 	return (ret);
56810Sstevel@tonic-gate }
56820Sstevel@tonic-gate 
56830Sstevel@tonic-gate /*
56840Sstevel@tonic-gate  * unconfigure immediate children of bus nexus device
56850Sstevel@tonic-gate  */
56860Sstevel@tonic-gate static int
56870Sstevel@tonic-gate unconfig_immediate_children(
56880Sstevel@tonic-gate 	dev_info_t *dip,
56890Sstevel@tonic-gate 	dev_info_t **dipp,
56900Sstevel@tonic-gate 	int flags,
56910Sstevel@tonic-gate 	major_t major)
56920Sstevel@tonic-gate {
56932155Scth 	int rv = NDI_SUCCESS;
56942155Scth 	int circ, vcirc;
56950Sstevel@tonic-gate 	dev_info_t *child;
56962155Scth 	dev_info_t *vdip = NULL;
56972155Scth 	dev_info_t *next;
56980Sstevel@tonic-gate 
56990Sstevel@tonic-gate 	ASSERT(dipp == NULL || *dipp == NULL);
57000Sstevel@tonic-gate 
57012155Scth 	/*
57022155Scth 	 * Scan forward to see if we will be processing a pHCI child. If we
57032155Scth 	 * have a child that is a pHCI and vHCI and pHCI are not siblings then
57042155Scth 	 * enter vHCI before parent(pHCI) to prevent deadlock with mpxio
57052155Scth 	 * Client power management operations.
57062155Scth 	 */
57070Sstevel@tonic-gate 	ndi_devi_enter(dip, &circ);
57082155Scth 	for (child = ddi_get_child(dip); child;
57092155Scth 	    child = ddi_get_next_sibling(child)) {
57102155Scth 		/* skip same nodes we skip below */
57117009Scth 		if (((major != DDI_MAJOR_T_NONE) &&
57122155Scth 		    (major != ddi_driver_major(child))) ||
57132155Scth 		    ((flags & NDI_AUTODETACH) && !is_leaf_node(child)))
57142155Scth 			continue;
57152155Scth 
57162155Scth 		if (MDI_PHCI(child)) {
57172155Scth 			vdip = mdi_devi_get_vdip(child);
57182155Scth 			/*
57192155Scth 			 * If vHCI and vHCI is not a sibling of pHCI
57202155Scth 			 * then enter in (vHCI, parent(pHCI)) order.
57212155Scth 			 */
57222155Scth 			if (vdip && (ddi_get_parent(vdip) != dip)) {
57232155Scth 				ndi_devi_exit(dip, circ);
57242155Scth 
57252155Scth 				/* use mdi_devi_enter ordering */
57262155Scth 				ndi_devi_enter(vdip, &vcirc);
57272155Scth 				ndi_devi_enter(dip, &circ);
57282155Scth 				break;
57292155Scth 			} else
57302155Scth 				vdip = NULL;
57312155Scth 		}
57322155Scth 	}
57332155Scth 
57340Sstevel@tonic-gate 	child = ddi_get_child(dip);
57350Sstevel@tonic-gate 	while (child) {
57362155Scth 		next = ddi_get_next_sibling(child);
57372155Scth 
57387009Scth 		if ((major != DDI_MAJOR_T_NONE) &&
57390Sstevel@tonic-gate 		    (major != ddi_driver_major(child))) {
57400Sstevel@tonic-gate 			child = next;
57410Sstevel@tonic-gate 			continue;
57420Sstevel@tonic-gate 		}
57430Sstevel@tonic-gate 
57440Sstevel@tonic-gate 		/* skip nexus nodes during autodetach */
57450Sstevel@tonic-gate 		if ((flags & NDI_AUTODETACH) && !is_leaf_node(child)) {
57460Sstevel@tonic-gate 			child = next;
57470Sstevel@tonic-gate 			continue;
57480Sstevel@tonic-gate 		}
57490Sstevel@tonic-gate 
57500Sstevel@tonic-gate 		if (devi_detach_node(child, flags) != NDI_SUCCESS) {
57510Sstevel@tonic-gate 			if (dipp && *dipp == NULL) {
57520Sstevel@tonic-gate 				ndi_hold_devi(child);
57530Sstevel@tonic-gate 				*dipp = child;
57540Sstevel@tonic-gate 			}
57550Sstevel@tonic-gate 			rv = NDI_FAILURE;
57560Sstevel@tonic-gate 		}
57570Sstevel@tonic-gate 
57580Sstevel@tonic-gate 		/*
57590Sstevel@tonic-gate 		 * Continue upon failure--best effort algorithm
57600Sstevel@tonic-gate 		 */
57610Sstevel@tonic-gate 		child = next;
57620Sstevel@tonic-gate 	}
57632155Scth 
57640Sstevel@tonic-gate 	ndi_devi_exit(dip, circ);
57652155Scth 	if (vdip)
57662155Scth 		ndi_devi_exit(vdip, vcirc);
57672155Scth 
57680Sstevel@tonic-gate 	return (rv);
57690Sstevel@tonic-gate }
57700Sstevel@tonic-gate 
57710Sstevel@tonic-gate /*
57720Sstevel@tonic-gate  * unconfigure grand children of bus nexus device
57730Sstevel@tonic-gate  */
57740Sstevel@tonic-gate static int
57750Sstevel@tonic-gate unconfig_grand_children(
57760Sstevel@tonic-gate 	dev_info_t *dip,
57770Sstevel@tonic-gate 	dev_info_t **dipp,
57780Sstevel@tonic-gate 	int flags,
57790Sstevel@tonic-gate 	major_t major,
57800Sstevel@tonic-gate 	struct brevq_node **brevqp)
57810Sstevel@tonic-gate {
57820Sstevel@tonic-gate 	struct mt_config_handle *hdl;
57830Sstevel@tonic-gate 
57840Sstevel@tonic-gate 	if (brevqp)
57850Sstevel@tonic-gate 		*brevqp = NULL;
57860Sstevel@tonic-gate 
57870Sstevel@tonic-gate 	/* multi-threaded configuration of child nexus */
57880Sstevel@tonic-gate 	hdl = mt_config_init(dip, dipp, flags, major, MT_UNCONFIG_OP, brevqp);
57890Sstevel@tonic-gate 	mt_config_children(hdl);
57900Sstevel@tonic-gate 
57910Sstevel@tonic-gate 	return (mt_config_fini(hdl));	/* wait for threads to exit */
57920Sstevel@tonic-gate }
57930Sstevel@tonic-gate 
57940Sstevel@tonic-gate /*
57950Sstevel@tonic-gate  * Unconfigure children/descendants of the dip.
57960Sstevel@tonic-gate  *
57970Sstevel@tonic-gate  * If brevqp is not NULL, on return *brevqp is set to a queue of dip's
57980Sstevel@tonic-gate  * child devinames for which branch remove events need to be generated.
57990Sstevel@tonic-gate  */
58000Sstevel@tonic-gate static int
58010Sstevel@tonic-gate devi_unconfig_common(
58020Sstevel@tonic-gate 	dev_info_t *dip,
58030Sstevel@tonic-gate 	dev_info_t **dipp,
58040Sstevel@tonic-gate 	int flags,
58050Sstevel@tonic-gate 	major_t major,
58060Sstevel@tonic-gate 	struct brevq_node **brevqp)
58070Sstevel@tonic-gate {
58080Sstevel@tonic-gate 	int rv;
58090Sstevel@tonic-gate 	int pm_cookie;
58100Sstevel@tonic-gate 	int (*f)();
58110Sstevel@tonic-gate 	ddi_bus_config_op_t bus_op;
58120Sstevel@tonic-gate 
58130Sstevel@tonic-gate 	if (dipp)
58140Sstevel@tonic-gate 		*dipp = NULL;
58150Sstevel@tonic-gate 	if (brevqp)
58160Sstevel@tonic-gate 		*brevqp = NULL;
58170Sstevel@tonic-gate 
58180Sstevel@tonic-gate 	/*
58190Sstevel@tonic-gate 	 * Power up the dip if it is powered off.  If the flag bit
58200Sstevel@tonic-gate 	 * NDI_AUTODETACH is set and the dip is not at its full power,
58210Sstevel@tonic-gate 	 * skip the rest of the branch.
58220Sstevel@tonic-gate 	 */
58230Sstevel@tonic-gate 	if (pm_pre_unconfig(dip, flags, &pm_cookie, NULL) != DDI_SUCCESS)
58240Sstevel@tonic-gate 		return ((flags & NDI_AUTODETACH) ? NDI_SUCCESS :
58250Sstevel@tonic-gate 		    NDI_FAILURE);
58260Sstevel@tonic-gate 
58270Sstevel@tonic-gate 	/*
58280Sstevel@tonic-gate 	 * Some callers, notably SCSI, need to clear out the devfs
58290Sstevel@tonic-gate 	 * cache together with the unconfig to prevent stale entries.
58300Sstevel@tonic-gate 	 */
58310Sstevel@tonic-gate 	if (flags & NDI_DEVFS_CLEAN)
58320Sstevel@tonic-gate 		(void) devfs_clean(dip, NULL, 0);
58330Sstevel@tonic-gate 
58340Sstevel@tonic-gate 	rv = unconfig_grand_children(dip, dipp, flags, major, brevqp);
58350Sstevel@tonic-gate 
58360Sstevel@tonic-gate 	if ((rv != NDI_SUCCESS) && ((flags & NDI_AUTODETACH) == 0)) {
58370Sstevel@tonic-gate 		if (brevqp && *brevqp) {
58380Sstevel@tonic-gate 			log_and_free_br_events_on_grand_children(dip, *brevqp);
58390Sstevel@tonic-gate 			free_brevq(*brevqp);
58400Sstevel@tonic-gate 			*brevqp = NULL;
58410Sstevel@tonic-gate 		}
58420Sstevel@tonic-gate 		pm_post_unconfig(dip, pm_cookie, NULL);
58430Sstevel@tonic-gate 		return (rv);
58440Sstevel@tonic-gate 	}
58450Sstevel@tonic-gate 
58460Sstevel@tonic-gate 	if (dipp && *dipp) {
58470Sstevel@tonic-gate 		ndi_rele_devi(*dipp);
58480Sstevel@tonic-gate 		*dipp = NULL;
58490Sstevel@tonic-gate 	}
58500Sstevel@tonic-gate 
58510Sstevel@tonic-gate 	/*
58520Sstevel@tonic-gate 	 * It is possible to have a detached nexus with children
58530Sstevel@tonic-gate 	 * and grandchildren (for example: a branch consisting
58540Sstevel@tonic-gate 	 * entirely of bound nodes.) Since the nexus is detached
58550Sstevel@tonic-gate 	 * the bus_unconfig entry point cannot be used to remove
58560Sstevel@tonic-gate 	 * or unconfigure the descendants.
58570Sstevel@tonic-gate 	 */
58581333Scth 	if (!i_ddi_devi_attached(dip) ||
58590Sstevel@tonic-gate 	    (DEVI(dip)->devi_ops->devo_bus_ops == NULL) ||
58600Sstevel@tonic-gate 	    (DEVI(dip)->devi_ops->devo_bus_ops->busops_rev < BUSO_REV_5) ||
58610Sstevel@tonic-gate 	    (f = DEVI(dip)->devi_ops->devo_bus_ops->bus_unconfig) == NULL) {
58620Sstevel@tonic-gate 		rv = unconfig_immediate_children(dip, dipp, flags, major);
58630Sstevel@tonic-gate 	} else {
58640Sstevel@tonic-gate 		/*
58650Sstevel@tonic-gate 		 * call bus_unconfig entry point
58660Sstevel@tonic-gate 		 * It should reset nexus flags if unconfigure succeeds.
58670Sstevel@tonic-gate 		 */
58687009Scth 		bus_op = (major == DDI_MAJOR_T_NONE) ?
58690Sstevel@tonic-gate 		    BUS_UNCONFIG_ALL : BUS_UNCONFIG_DRIVER;
58700Sstevel@tonic-gate 		rv = (*f)(dip, flags, bus_op, (void *)(uintptr_t)major);
58710Sstevel@tonic-gate 	}
58720Sstevel@tonic-gate 
58730Sstevel@tonic-gate 	pm_post_unconfig(dip, pm_cookie, NULL);
58740Sstevel@tonic-gate 
58750Sstevel@tonic-gate 	if (brevqp && *brevqp)
58760Sstevel@tonic-gate 		cleanup_br_events_on_grand_children(dip, brevqp);
58770Sstevel@tonic-gate 
58780Sstevel@tonic-gate 	return (rv);
58790Sstevel@tonic-gate }
58800Sstevel@tonic-gate 
58810Sstevel@tonic-gate /*
58820Sstevel@tonic-gate  * called by devfs/framework to unconfigure children bound to major
58830Sstevel@tonic-gate  * If NDI_AUTODETACH is specified, this is invoked by either the
58840Sstevel@tonic-gate  * moduninstall daemon or the modunload -i 0 command.
58850Sstevel@tonic-gate  */
58860Sstevel@tonic-gate int
58870Sstevel@tonic-gate ndi_devi_unconfig_driver(dev_info_t *dip, int flags, major_t major)
58880Sstevel@tonic-gate {
58890Sstevel@tonic-gate 	NDI_CONFIG_DEBUG((CE_CONT,
58900Sstevel@tonic-gate 	    "ndi_devi_unconfig_driver: par = %s%d (%p), flags = 0x%x\n",
58910Sstevel@tonic-gate 	    ddi_driver_name(dip), ddi_get_instance(dip), (void *)dip, flags));
58920Sstevel@tonic-gate 
58930Sstevel@tonic-gate 	return (devi_unconfig_common(dip, NULL, flags, major, NULL));
58940Sstevel@tonic-gate }
58950Sstevel@tonic-gate 
58960Sstevel@tonic-gate int
58970Sstevel@tonic-gate ndi_devi_unconfig(dev_info_t *dip, int flags)
58980Sstevel@tonic-gate {
58990Sstevel@tonic-gate 	NDI_CONFIG_DEBUG((CE_CONT,
59000Sstevel@tonic-gate 	    "ndi_devi_unconfig: par = %s%d (%p), flags = 0x%x\n",
59010Sstevel@tonic-gate 	    ddi_driver_name(dip), ddi_get_instance(dip), (void *)dip, flags));
59020Sstevel@tonic-gate 
59037009Scth 	return (devi_unconfig_common(dip, NULL, flags, DDI_MAJOR_T_NONE, NULL));
59040Sstevel@tonic-gate }
59050Sstevel@tonic-gate 
59060Sstevel@tonic-gate int
59070Sstevel@tonic-gate e_ddi_devi_unconfig(dev_info_t *dip, dev_info_t **dipp, int flags)
59080Sstevel@tonic-gate {
59090Sstevel@tonic-gate 	NDI_CONFIG_DEBUG((CE_CONT,
59100Sstevel@tonic-gate 	    "e_ddi_devi_unconfig: par = %s%d (%p), flags = 0x%x\n",
59110Sstevel@tonic-gate 	    ddi_driver_name(dip), ddi_get_instance(dip), (void *)dip, flags));
59120Sstevel@tonic-gate 
59137009Scth 	return (devi_unconfig_common(dip, dipp, flags, DDI_MAJOR_T_NONE, NULL));
59140Sstevel@tonic-gate }
59150Sstevel@tonic-gate 
59160Sstevel@tonic-gate /*
59170Sstevel@tonic-gate  * Unconfigure child by name
59180Sstevel@tonic-gate  */
59190Sstevel@tonic-gate static int
59200Sstevel@tonic-gate devi_unconfig_one(dev_info_t *pdip, char *devnm, int flags)
59210Sstevel@tonic-gate {
59222155Scth 	int		rv, circ;
59232155Scth 	dev_info_t	*child;
59242155Scth 	dev_info_t	*vdip = NULL;
59252155Scth 	int		v_circ;
59260Sstevel@tonic-gate 
59270Sstevel@tonic-gate 	ndi_devi_enter(pdip, &circ);
59280Sstevel@tonic-gate 	child = ndi_devi_findchild(pdip, devnm);
59292155Scth 
59302155Scth 	/*
59312155Scth 	 * If child is pHCI and vHCI and pHCI are not siblings then enter vHCI
59322155Scth 	 * before parent(pHCI) to avoid deadlock with mpxio Client power
59332155Scth 	 * management operations.
59342155Scth 	 */
59352155Scth 	if (child && MDI_PHCI(child)) {
59362155Scth 		vdip = mdi_devi_get_vdip(child);
59372155Scth 		if (vdip && (ddi_get_parent(vdip) != pdip)) {
59382155Scth 			ndi_devi_exit(pdip, circ);
59392155Scth 
59402155Scth 			/* use mdi_devi_enter ordering */
59412155Scth 			ndi_devi_enter(vdip, &v_circ);
59422155Scth 			ndi_devi_enter(pdip, &circ);
59432155Scth 			child = ndi_devi_findchild(pdip, devnm);
59442155Scth 		} else
59452155Scth 			vdip = NULL;
59462155Scth 	}
59472155Scth 
59482155Scth 	if (child) {
59492155Scth 		rv = devi_detach_node(child, flags);
59502155Scth 	} else {
59510Sstevel@tonic-gate 		NDI_CONFIG_DEBUG((CE_CONT,
59520Sstevel@tonic-gate 		    "devi_unconfig_one: %s not found\n", devnm));
59532155Scth 		rv = NDI_SUCCESS;
59542155Scth 	}
59552155Scth 
59560Sstevel@tonic-gate 	ndi_devi_exit(pdip, circ);
59572155Scth 	if (vdip)
59587235Svikram 		ndi_devi_exit(vdip, v_circ);
59592155Scth 
59600Sstevel@tonic-gate 	return (rv);
59610Sstevel@tonic-gate }
59620Sstevel@tonic-gate 
59630Sstevel@tonic-gate int
59640Sstevel@tonic-gate ndi_devi_unconfig_one(
59650Sstevel@tonic-gate 	dev_info_t *pdip,
59660Sstevel@tonic-gate 	char *devnm,
59670Sstevel@tonic-gate 	dev_info_t **dipp,
59680Sstevel@tonic-gate 	int flags)
59690Sstevel@tonic-gate {
59702155Scth 	int		(*f)();
59712155Scth 	int		circ, rv;
59722155Scth 	int		pm_cookie;
59732155Scth 	dev_info_t	*child;
59742155Scth 	dev_info_t	*vdip = NULL;
59752155Scth 	int		v_circ;
59760Sstevel@tonic-gate 	struct brevq_node *brevq = NULL;
59770Sstevel@tonic-gate 
59781333Scth 	ASSERT(i_ddi_devi_attached(pdip));
59790Sstevel@tonic-gate 
59800Sstevel@tonic-gate 	NDI_CONFIG_DEBUG((CE_CONT,
59810Sstevel@tonic-gate 	    "ndi_devi_unconfig_one: par = %s%d (%p), child = %s\n",
59820Sstevel@tonic-gate 	    ddi_driver_name(pdip), ddi_get_instance(pdip),
59830Sstevel@tonic-gate 	    (void *)pdip, devnm));
59840Sstevel@tonic-gate 
59850Sstevel@tonic-gate 	if (pm_pre_unconfig(pdip, flags, &pm_cookie, devnm) != DDI_SUCCESS)
59860Sstevel@tonic-gate 		return (NDI_FAILURE);
59870Sstevel@tonic-gate 
59880Sstevel@tonic-gate 	if (dipp)
59890Sstevel@tonic-gate 		*dipp = NULL;
59900Sstevel@tonic-gate 
59910Sstevel@tonic-gate 	ndi_devi_enter(pdip, &circ);
59920Sstevel@tonic-gate 	child = ndi_devi_findchild(pdip, devnm);
59932155Scth 
59942155Scth 	/*
59952155Scth 	 * If child is pHCI and vHCI and pHCI are not siblings then enter vHCI
59962155Scth 	 * before parent(pHCI) to avoid deadlock with mpxio Client power
59972155Scth 	 * management operations.
59982155Scth 	 */
59992155Scth 	if (child && MDI_PHCI(child)) {
60002155Scth 		vdip = mdi_devi_get_vdip(child);
60012155Scth 		if (vdip && (ddi_get_parent(vdip) != pdip)) {
60022155Scth 			ndi_devi_exit(pdip, circ);
60032155Scth 
60042155Scth 			/* use mdi_devi_enter ordering */
60052155Scth 			ndi_devi_enter(vdip, &v_circ);
60062155Scth 			ndi_devi_enter(pdip, &circ);
60072155Scth 			child = ndi_devi_findchild(pdip, devnm);
60082155Scth 		} else
60092155Scth 			vdip = NULL;
60102155Scth 	}
60112155Scth 
60120Sstevel@tonic-gate 	if (child == NULL) {
60130Sstevel@tonic-gate 		NDI_CONFIG_DEBUG((CE_CONT, "ndi_devi_unconfig_one: %s"
60140Sstevel@tonic-gate 		    " not found\n", devnm));
60152155Scth 		rv = NDI_SUCCESS;
60162155Scth 		goto out;
60170Sstevel@tonic-gate 	}
60180Sstevel@tonic-gate 
60190Sstevel@tonic-gate 	/*
60200Sstevel@tonic-gate 	 * Unconfigure children/descendants of named child
60210Sstevel@tonic-gate 	 */
60220Sstevel@tonic-gate 	rv = devi_unconfig_branch(child, dipp, flags | NDI_UNCONFIG, &brevq);
60230Sstevel@tonic-gate 	if (rv != NDI_SUCCESS)
60240Sstevel@tonic-gate 		goto out;
60250Sstevel@tonic-gate 
60260Sstevel@tonic-gate 	init_bound_node_ev(pdip, child, flags);
60270Sstevel@tonic-gate 
60280Sstevel@tonic-gate 	if ((DEVI(pdip)->devi_ops->devo_bus_ops == NULL) ||
60290Sstevel@tonic-gate 	    (DEVI(pdip)->devi_ops->devo_bus_ops->busops_rev < BUSO_REV_5) ||
60300Sstevel@tonic-gate 	    (f = DEVI(pdip)->devi_ops->devo_bus_ops->bus_unconfig) == NULL) {
60310Sstevel@tonic-gate 		rv = devi_detach_node(child, flags);
60320Sstevel@tonic-gate 	} else {
60330Sstevel@tonic-gate 		/* call bus_config entry point */
60340Sstevel@tonic-gate 		rv = (*f)(pdip, flags, BUS_UNCONFIG_ONE, (void *)devnm);
60350Sstevel@tonic-gate 	}
60360Sstevel@tonic-gate 
60370Sstevel@tonic-gate 	if (brevq) {
60380Sstevel@tonic-gate 		if (rv != NDI_SUCCESS)
60390Sstevel@tonic-gate 			log_and_free_brevq_dip(child, brevq);
60400Sstevel@tonic-gate 		else
60410Sstevel@tonic-gate 			free_brevq(brevq);
60420Sstevel@tonic-gate 	}
60430Sstevel@tonic-gate 
60440Sstevel@tonic-gate 	if (dipp && rv != NDI_SUCCESS) {
60450Sstevel@tonic-gate 		ndi_hold_devi(child);
60460Sstevel@tonic-gate 		ASSERT(*dipp == NULL);
60470Sstevel@tonic-gate 		*dipp = child;
60480Sstevel@tonic-gate 	}
60490Sstevel@tonic-gate 
60500Sstevel@tonic-gate out:
60510Sstevel@tonic-gate 	ndi_devi_exit(pdip, circ);
60522155Scth 	if (vdip)
60537235Svikram 		ndi_devi_exit(vdip, v_circ);
60542155Scth 
60550Sstevel@tonic-gate 	pm_post_unconfig(pdip, pm_cookie, devnm);
60560Sstevel@tonic-gate 
60570Sstevel@tonic-gate 	return (rv);
60580Sstevel@tonic-gate }
60590Sstevel@tonic-gate 
60600Sstevel@tonic-gate struct async_arg {
60610Sstevel@tonic-gate 	dev_info_t *dip;
60620Sstevel@tonic-gate 	uint_t flags;
60630Sstevel@tonic-gate };
60640Sstevel@tonic-gate 
60650Sstevel@tonic-gate /*
60660Sstevel@tonic-gate  * Common async handler for:
60670Sstevel@tonic-gate  *	ndi_devi_bind_driver_async
60680Sstevel@tonic-gate  *	ndi_devi_online_async
60690Sstevel@tonic-gate  */
60700Sstevel@tonic-gate static int
60710Sstevel@tonic-gate i_ndi_devi_async_common(dev_info_t *dip, uint_t flags, void (*func)())
60720Sstevel@tonic-gate {
60730Sstevel@tonic-gate 	int tqflag;
60740Sstevel@tonic-gate 	int kmflag;
60750Sstevel@tonic-gate 	struct async_arg *arg;
60760Sstevel@tonic-gate 	dev_info_t *pdip = ddi_get_parent(dip);
60770Sstevel@tonic-gate 
60780Sstevel@tonic-gate 	ASSERT(pdip);
60790Sstevel@tonic-gate 	ASSERT(DEVI(pdip)->devi_taskq);
60800Sstevel@tonic-gate 	ASSERT(ndi_dev_is_persistent_node(dip));
60810Sstevel@tonic-gate 
60820Sstevel@tonic-gate 	if (flags & NDI_NOSLEEP) {
60830Sstevel@tonic-gate 		kmflag = KM_NOSLEEP;
60840Sstevel@tonic-gate 		tqflag = TQ_NOSLEEP;
60850Sstevel@tonic-gate 	} else {
60860Sstevel@tonic-gate 		kmflag = KM_SLEEP;
60870Sstevel@tonic-gate 		tqflag = TQ_SLEEP;
60880Sstevel@tonic-gate 	}
60890Sstevel@tonic-gate 
60900Sstevel@tonic-gate 	arg = kmem_alloc(sizeof (*arg), kmflag);
60910Sstevel@tonic-gate 	if (arg == NULL)
60920Sstevel@tonic-gate 		goto fail;
60930Sstevel@tonic-gate 
60940Sstevel@tonic-gate 	arg->flags = flags;
60950Sstevel@tonic-gate 	arg->dip = dip;
60960Sstevel@tonic-gate 	if (ddi_taskq_dispatch(DEVI(pdip)->devi_taskq, func, arg, tqflag) ==
60970Sstevel@tonic-gate 	    DDI_SUCCESS) {
60980Sstevel@tonic-gate 		return (NDI_SUCCESS);
60990Sstevel@tonic-gate 	}
61000Sstevel@tonic-gate 
61010Sstevel@tonic-gate fail:
61020Sstevel@tonic-gate 	NDI_CONFIG_DEBUG((CE_CONT, "%s%d: ddi_taskq_dispatch failed",
61030Sstevel@tonic-gate 	    ddi_driver_name(pdip), ddi_get_instance(pdip)));
61040Sstevel@tonic-gate 
61050Sstevel@tonic-gate 	if (arg)
61060Sstevel@tonic-gate 		kmem_free(arg, sizeof (*arg));
61070Sstevel@tonic-gate 	return (NDI_FAILURE);
61080Sstevel@tonic-gate }
61090Sstevel@tonic-gate 
61100Sstevel@tonic-gate static void
61110Sstevel@tonic-gate i_ndi_devi_bind_driver_cb(struct async_arg *arg)
61120Sstevel@tonic-gate {
61130Sstevel@tonic-gate 	(void) ndi_devi_bind_driver(arg->dip, arg->flags);
61140Sstevel@tonic-gate 	kmem_free(arg, sizeof (*arg));
61150Sstevel@tonic-gate }
61160Sstevel@tonic-gate 
61170Sstevel@tonic-gate int
61180Sstevel@tonic-gate ndi_devi_bind_driver_async(dev_info_t *dip, uint_t flags)
61190Sstevel@tonic-gate {
61200Sstevel@tonic-gate 	return (i_ndi_devi_async_common(dip, flags,
61210Sstevel@tonic-gate 	    (void (*)())i_ndi_devi_bind_driver_cb));
61220Sstevel@tonic-gate }
61230Sstevel@tonic-gate 
61240Sstevel@tonic-gate /*
61250Sstevel@tonic-gate  * place the devinfo in the ONLINE state.
61260Sstevel@tonic-gate  */
61270Sstevel@tonic-gate int
61280Sstevel@tonic-gate ndi_devi_online(dev_info_t *dip, uint_t flags)
61290Sstevel@tonic-gate {
61300Sstevel@tonic-gate 	int circ, rv;
61310Sstevel@tonic-gate 	dev_info_t *pdip = ddi_get_parent(dip);
61320Sstevel@tonic-gate 	int branch_event = 0;
61330Sstevel@tonic-gate 
61340Sstevel@tonic-gate 	ASSERT(pdip);
61350Sstevel@tonic-gate 
61360Sstevel@tonic-gate 	NDI_CONFIG_DEBUG((CE_CONT, "ndi_devi_online: %s%d (%p)\n",
61374950Scth 	    ddi_driver_name(dip), ddi_get_instance(dip), (void *)dip));
61380Sstevel@tonic-gate 
61390Sstevel@tonic-gate 	ndi_devi_enter(pdip, &circ);
61400Sstevel@tonic-gate 	/* bind child before merging .conf nodes */
61410Sstevel@tonic-gate 	rv = i_ndi_config_node(dip, DS_BOUND, flags);
61420Sstevel@tonic-gate 	if (rv != NDI_SUCCESS) {
61430Sstevel@tonic-gate 		ndi_devi_exit(pdip, circ);
61440Sstevel@tonic-gate 		return (rv);
61450Sstevel@tonic-gate 	}
61460Sstevel@tonic-gate 
61470Sstevel@tonic-gate 	/* merge .conf properties */
61480Sstevel@tonic-gate 	(void) i_ndi_make_spec_children(pdip, flags);
61490Sstevel@tonic-gate 
61502009Sdm120769 	flags |= (NDI_DEVI_ONLINE | NDI_CONFIG);
61510Sstevel@tonic-gate 
61520Sstevel@tonic-gate 	if (flags & NDI_NO_EVENT) {
61530Sstevel@tonic-gate 		/*
61540Sstevel@tonic-gate 		 * Caller is specifically asking for not to generate an event.
61550Sstevel@tonic-gate 		 * Set the following flag so that devi_attach_node() don't
61560Sstevel@tonic-gate 		 * change the event state.
61570Sstevel@tonic-gate 		 */
61580Sstevel@tonic-gate 		flags |= NDI_NO_EVENT_STATE_CHNG;
61590Sstevel@tonic-gate 	}
61600Sstevel@tonic-gate 
61610Sstevel@tonic-gate 	if ((flags & (NDI_NO_EVENT | NDI_BRANCH_EVENT_OP)) == 0 &&
61620Sstevel@tonic-gate 	    ((flags & NDI_CONFIG) || DEVI_NEED_NDI_CONFIG(dip))) {
61630Sstevel@tonic-gate 		flags |= NDI_BRANCH_EVENT_OP;
61640Sstevel@tonic-gate 		branch_event = 1;
61650Sstevel@tonic-gate 	}
61660Sstevel@tonic-gate 
61670Sstevel@tonic-gate 	/*
61680Sstevel@tonic-gate 	 * devi_attach_node() may remove dip on failure
61690Sstevel@tonic-gate 	 */
61700Sstevel@tonic-gate 	if ((rv = devi_attach_node(dip, flags)) == NDI_SUCCESS) {
61710Sstevel@tonic-gate 		if ((flags & NDI_CONFIG) || DEVI_NEED_NDI_CONFIG(dip)) {
61720Sstevel@tonic-gate 			(void) ndi_devi_config(dip, flags);
61730Sstevel@tonic-gate 		}
61740Sstevel@tonic-gate 
61750Sstevel@tonic-gate 		if (branch_event)
61760Sstevel@tonic-gate 			(void) i_log_devfs_branch_add(dip);
61770Sstevel@tonic-gate 	}
61780Sstevel@tonic-gate 
61790Sstevel@tonic-gate 	ndi_devi_exit(pdip, circ);
61800Sstevel@tonic-gate 
61810Sstevel@tonic-gate 	/*
61820Sstevel@tonic-gate 	 * Notify devfs that we have a new node. Devfs needs to invalidate
61830Sstevel@tonic-gate 	 * cached directory contents.
61840Sstevel@tonic-gate 	 *
61850Sstevel@tonic-gate 	 * For PCMCIA devices, it is possible the pdip is not fully
61860Sstevel@tonic-gate 	 * attached. In this case, calling back into devfs will
61870Sstevel@tonic-gate 	 * result in a loop or assertion error. Hence, the check
61880Sstevel@tonic-gate 	 * on node state.
61890Sstevel@tonic-gate 	 *
61900Sstevel@tonic-gate 	 * If we own parent lock, this is part of a branch operation.
61910Sstevel@tonic-gate 	 * We skip the devfs_clean() step because the cache invalidation
61920Sstevel@tonic-gate 	 * is done higher up in the device tree.
61930Sstevel@tonic-gate 	 */
61941333Scth 	if (rv == NDI_SUCCESS && i_ddi_devi_attached(pdip) &&
61950Sstevel@tonic-gate 	    !DEVI_BUSY_OWNED(pdip))
61960Sstevel@tonic-gate 		(void) devfs_clean(pdip, NULL, 0);
61970Sstevel@tonic-gate 	return (rv);
61980Sstevel@tonic-gate }
61990Sstevel@tonic-gate 
62000Sstevel@tonic-gate static void
62010Sstevel@tonic-gate i_ndi_devi_online_cb(struct async_arg *arg)
62020Sstevel@tonic-gate {
62030Sstevel@tonic-gate 	(void) ndi_devi_online(arg->dip, arg->flags);
62040Sstevel@tonic-gate 	kmem_free(arg, sizeof (*arg));
62050Sstevel@tonic-gate }
62060Sstevel@tonic-gate 
62070Sstevel@tonic-gate int
62080Sstevel@tonic-gate ndi_devi_online_async(dev_info_t *dip, uint_t flags)
62090Sstevel@tonic-gate {
62100Sstevel@tonic-gate 	/* mark child as need config if requested. */
6211495Scth 	if (flags & NDI_CONFIG) {
6212495Scth 		mutex_enter(&(DEVI(dip)->devi_lock));
62130Sstevel@tonic-gate 		DEVI_SET_NDI_CONFIG(dip);
6214495Scth 		mutex_exit(&(DEVI(dip)->devi_lock));
6215495Scth 	}
62160Sstevel@tonic-gate 
62170Sstevel@tonic-gate 	return (i_ndi_devi_async_common(dip, flags,
62180Sstevel@tonic-gate 	    (void (*)())i_ndi_devi_online_cb));
62190Sstevel@tonic-gate }
62200Sstevel@tonic-gate 
62210Sstevel@tonic-gate /*
62220Sstevel@tonic-gate  * Take a device node Offline
62230Sstevel@tonic-gate  * To take a device Offline means to detach the device instance from
62240Sstevel@tonic-gate  * the driver and prevent devfs requests from re-attaching the device
62250Sstevel@tonic-gate  * instance.
62260Sstevel@tonic-gate  *
62270Sstevel@tonic-gate  * The flag NDI_DEVI_REMOVE causes removes the device node from
62280Sstevel@tonic-gate  * the driver list and the device tree. In this case, the device
62290Sstevel@tonic-gate  * is assumed to be removed from the system.
62300Sstevel@tonic-gate  */
62310Sstevel@tonic-gate int
62320Sstevel@tonic-gate ndi_devi_offline(dev_info_t *dip, uint_t flags)
62330Sstevel@tonic-gate {
62342155Scth 	int		circ, rval = 0;
62352155Scth 	dev_info_t	*pdip = ddi_get_parent(dip);
62362155Scth 	dev_info_t	*vdip = NULL;
62372155Scth 	int		v_circ;
62380Sstevel@tonic-gate 	struct brevq_node *brevq = NULL;
62390Sstevel@tonic-gate 
62400Sstevel@tonic-gate 	ASSERT(pdip);
62410Sstevel@tonic-gate 
62420Sstevel@tonic-gate 	flags |= NDI_DEVI_OFFLINE;
62432155Scth 
62442155Scth 	/*
62452155Scth 	 * If child is pHCI and vHCI and pHCI are not siblings then enter vHCI
62462155Scth 	 * before parent(pHCI) to avoid deadlock with mpxio Client power
62472155Scth 	 * management operations.
62482155Scth 	 */
62492155Scth 	if (MDI_PHCI(dip)) {
62502155Scth 		vdip = mdi_devi_get_vdip(dip);
62512155Scth 		if (vdip && (ddi_get_parent(vdip) != pdip))
62522155Scth 			ndi_devi_enter(vdip, &v_circ);
62532155Scth 		else
62542155Scth 			vdip = NULL;
62552155Scth 	}
62560Sstevel@tonic-gate 	ndi_devi_enter(pdip, &circ);
62572155Scth 
62580Sstevel@tonic-gate 	if (i_ddi_node_state(dip) == DS_READY) {
62590Sstevel@tonic-gate 		/*
62600Sstevel@tonic-gate 		 * If dip is in DS_READY state, there may be cached dv_nodes
62610Sstevel@tonic-gate 		 * referencing this dip, so we invoke devfs code path.
62620Sstevel@tonic-gate 		 * Note that we must release busy changing on pdip to
62630Sstevel@tonic-gate 		 * avoid deadlock against devfs.
62640Sstevel@tonic-gate 		 */
62650Sstevel@tonic-gate 		char *devname = kmem_alloc(MAXNAMELEN + 1, KM_SLEEP);
62660Sstevel@tonic-gate 		(void) ddi_deviname(dip, devname);
62672155Scth 
62680Sstevel@tonic-gate 		ndi_devi_exit(pdip, circ);
62692155Scth 		if (vdip)
62702155Scth 			ndi_devi_exit(vdip, v_circ);
62710Sstevel@tonic-gate 
62720Sstevel@tonic-gate 		/*
62730Sstevel@tonic-gate 		 * If we own parent lock, this is part of a branch
62740Sstevel@tonic-gate 		 * operation. We skip the devfs_clean() step.
62750Sstevel@tonic-gate 		 */
62760Sstevel@tonic-gate 		if (!DEVI_BUSY_OWNED(pdip))
62774411Svikram 			(void) devfs_clean(pdip, devname + 1, DV_CLEAN_FORCE);
62780Sstevel@tonic-gate 		kmem_free(devname, MAXNAMELEN + 1);
62790Sstevel@tonic-gate 
62804411Svikram 		rval = devi_unconfig_branch(dip, NULL, flags|NDI_UNCONFIG,
62814411Svikram 		    &brevq);
62824411Svikram 
62830Sstevel@tonic-gate 		if (rval)
62840Sstevel@tonic-gate 			return (NDI_FAILURE);
62850Sstevel@tonic-gate 
62862155Scth 		if (vdip)
62872155Scth 			ndi_devi_enter(vdip, &v_circ);
62880Sstevel@tonic-gate 		ndi_devi_enter(pdip, &circ);
62890Sstevel@tonic-gate 	}
62900Sstevel@tonic-gate 
62910Sstevel@tonic-gate 	init_bound_node_ev(pdip, dip, flags);
62920Sstevel@tonic-gate 
62930Sstevel@tonic-gate 	rval = devi_detach_node(dip, flags);
62940Sstevel@tonic-gate 	if (brevq) {
62950Sstevel@tonic-gate 		if (rval != NDI_SUCCESS)
62960Sstevel@tonic-gate 			log_and_free_brevq_dip(dip, brevq);
62970Sstevel@tonic-gate 		else
62980Sstevel@tonic-gate 			free_brevq(brevq);
62990Sstevel@tonic-gate 	}
63000Sstevel@tonic-gate 
63010Sstevel@tonic-gate 	ndi_devi_exit(pdip, circ);
63022155Scth 	if (vdip)
63032155Scth 		ndi_devi_exit(vdip, v_circ);
63040Sstevel@tonic-gate 
63050Sstevel@tonic-gate 	return (rval);
63060Sstevel@tonic-gate }
63070Sstevel@tonic-gate 
63080Sstevel@tonic-gate /*
63090Sstevel@tonic-gate  * Find the child dev_info node of parent nexus 'p' whose name
63100Sstevel@tonic-gate  * matches "cname@caddr".  Recommend use of ndi_devi_findchild() instead.
63110Sstevel@tonic-gate  */
63120Sstevel@tonic-gate dev_info_t *
63130Sstevel@tonic-gate ndi_devi_find(dev_info_t *pdip, char *cname, char *caddr)
63140Sstevel@tonic-gate {
63150Sstevel@tonic-gate 	dev_info_t *child;
63160Sstevel@tonic-gate 	int circ;
63170Sstevel@tonic-gate 
63180Sstevel@tonic-gate 	if (pdip == NULL || cname == NULL || caddr == NULL)
63190Sstevel@tonic-gate 		return ((dev_info_t *)NULL);
63200Sstevel@tonic-gate 
63210Sstevel@tonic-gate 	ndi_devi_enter(pdip, &circ);
63224145Scth 	child = find_sibling(ddi_get_child(pdip), cname, caddr,
63234145Scth 	    FIND_NODE_BY_NODENAME, NULL);
63240Sstevel@tonic-gate 	ndi_devi_exit(pdip, circ);
63250Sstevel@tonic-gate 	return (child);
63260Sstevel@tonic-gate }
63270Sstevel@tonic-gate 
63280Sstevel@tonic-gate /*
63290Sstevel@tonic-gate  * Find the child dev_info node of parent nexus 'p' whose name
63300Sstevel@tonic-gate  * matches devname "name@addr".  Permits caller to hold the parent.
63310Sstevel@tonic-gate  */
63320Sstevel@tonic-gate dev_info_t *
63330Sstevel@tonic-gate ndi_devi_findchild(dev_info_t *pdip, char *devname)
63340Sstevel@tonic-gate {
63350Sstevel@tonic-gate 	dev_info_t *child;
63360Sstevel@tonic-gate 	char	*cname, *caddr;
63370Sstevel@tonic-gate 	char	*devstr;
63380Sstevel@tonic-gate 
63390Sstevel@tonic-gate 	ASSERT(DEVI_BUSY_OWNED(pdip));
63400Sstevel@tonic-gate 
63410Sstevel@tonic-gate 	devstr = i_ddi_strdup(devname, KM_SLEEP);
63420Sstevel@tonic-gate 	i_ddi_parse_name(devstr, &cname, &caddr, NULL);
63430Sstevel@tonic-gate 
63440Sstevel@tonic-gate 	if (cname == NULL || caddr == NULL) {
63450Sstevel@tonic-gate 		kmem_free(devstr, strlen(devname)+1);
63460Sstevel@tonic-gate 		return ((dev_info_t *)NULL);
63470Sstevel@tonic-gate 	}
63480Sstevel@tonic-gate 
63494145Scth 	child = find_sibling(ddi_get_child(pdip), cname, caddr,
63504145Scth 	    FIND_NODE_BY_NODENAME, NULL);
63510Sstevel@tonic-gate 	kmem_free(devstr, strlen(devname)+1);
63520Sstevel@tonic-gate 	return (child);
63530Sstevel@tonic-gate }
63540Sstevel@tonic-gate 
63550Sstevel@tonic-gate /*
63560Sstevel@tonic-gate  * Misc. routines called by framework only
63570Sstevel@tonic-gate  */
63580Sstevel@tonic-gate 
63590Sstevel@tonic-gate /*
63600Sstevel@tonic-gate  * Clear the DEVI_MADE_CHILDREN/DEVI_ATTACHED_CHILDREN flags
63610Sstevel@tonic-gate  * if new child spec has been added.
63620Sstevel@tonic-gate  */
63630Sstevel@tonic-gate static int
63640Sstevel@tonic-gate reset_nexus_flags(dev_info_t *dip, void *arg)
63650Sstevel@tonic-gate {
6366298Scth 	struct hwc_spec	*list;
6367298Scth 	int		circ;
63680Sstevel@tonic-gate 
63690Sstevel@tonic-gate 	if (((DEVI(dip)->devi_flags & DEVI_MADE_CHILDREN) == 0) ||
63700Sstevel@tonic-gate 	    ((list = hwc_get_child_spec(dip, (major_t)(uintptr_t)arg)) == NULL))
63710Sstevel@tonic-gate 		return (DDI_WALK_CONTINUE);
63720Sstevel@tonic-gate 
63730Sstevel@tonic-gate 	hwc_free_spec_list(list);
6374298Scth 
6375298Scth 	/* coordinate child state update */
6376298Scth 	ndi_devi_enter(dip, &circ);
63770Sstevel@tonic-gate 	mutex_enter(&DEVI(dip)->devi_lock);
63780Sstevel@tonic-gate 	DEVI(dip)->devi_flags &= ~(DEVI_MADE_CHILDREN | DEVI_ATTACHED_CHILDREN);
63790Sstevel@tonic-gate 	mutex_exit(&DEVI(dip)->devi_lock);
6380298Scth 	ndi_devi_exit(dip, circ);
63810Sstevel@tonic-gate 
63820Sstevel@tonic-gate 	return (DDI_WALK_CONTINUE);
63830Sstevel@tonic-gate }
63840Sstevel@tonic-gate 
63850Sstevel@tonic-gate /*
63860Sstevel@tonic-gate  * Helper functions, returns NULL if no memory.
63870Sstevel@tonic-gate  */
63880Sstevel@tonic-gate 
63890Sstevel@tonic-gate /*
63900Sstevel@tonic-gate  * path_to_major:
63910Sstevel@tonic-gate  *
63920Sstevel@tonic-gate  * Return an alternate driver name binding for the leaf device
63930Sstevel@tonic-gate  * of the given pathname, if there is one. The purpose of this
63940Sstevel@tonic-gate  * function is to deal with generic pathnames. The default action
63950Sstevel@tonic-gate  * for platforms that can't do this (ie: x86 or any platform that
63960Sstevel@tonic-gate  * does not have prom_finddevice functionality, which matches
63970Sstevel@tonic-gate  * nodenames and unit-addresses without the drivers participation)
63987009Scth  * is to return DDI_MAJOR_T_NONE.
63990Sstevel@tonic-gate  *
64000Sstevel@tonic-gate  * Used in loadrootmodules() in the swapgeneric module to
64010Sstevel@tonic-gate  * associate a given pathname with a given leaf driver.
64020Sstevel@tonic-gate  *
64030Sstevel@tonic-gate  */
64040Sstevel@tonic-gate major_t
64050Sstevel@tonic-gate path_to_major(char *path)
64060Sstevel@tonic-gate {
64070Sstevel@tonic-gate 	dev_info_t *dip;
64080Sstevel@tonic-gate 	char *p, *q;
6409789Sahrens 	pnode_t nodeid;
64104145Scth 	major_t major;
64114145Scth 
64124145Scth 	/* check for path-oriented alias */
64134145Scth 	major = ddi_name_to_major(path);
64147009Scth 	if ((major != DDI_MAJOR_T_NONE) &&
64154145Scth 	    !(devnamesp[major].dn_flags & DN_DRIVER_REMOVED)) {
64164145Scth 		NDI_CONFIG_DEBUG((CE_NOTE, "path_to_major: %s path bound %s\n",
64174145Scth 		    path, ddi_major_to_name(major)));
64184145Scth 		return (major);
64194145Scth 	}
64200Sstevel@tonic-gate 
64210Sstevel@tonic-gate 	/*
64220Sstevel@tonic-gate 	 * Get the nodeid of the given pathname, if such a mapping exists.
64230Sstevel@tonic-gate 	 */
64240Sstevel@tonic-gate 	dip = NULL;
64250Sstevel@tonic-gate 	nodeid = prom_finddevice(path);
64260Sstevel@tonic-gate 	if (nodeid != OBP_BADNODE) {
64270Sstevel@tonic-gate 		/*
64280Sstevel@tonic-gate 		 * Find the nodeid in our copy of the device tree and return
64290Sstevel@tonic-gate 		 * whatever name we used to bind this node to a driver.
64300Sstevel@tonic-gate 		 */
64310Sstevel@tonic-gate 		dip = e_ddi_nodeid_to_dip(nodeid);
64320Sstevel@tonic-gate 	}
64330Sstevel@tonic-gate 
64340Sstevel@tonic-gate 	if (dip == NULL) {
64350Sstevel@tonic-gate 		NDI_CONFIG_DEBUG((CE_WARN,
64360Sstevel@tonic-gate 		    "path_to_major: can't bind <%s>\n", path));
64377009Scth 		return (DDI_MAJOR_T_NONE);
64380Sstevel@tonic-gate 	}
64390Sstevel@tonic-gate 
64400Sstevel@tonic-gate 	/*
64410Sstevel@tonic-gate 	 * If we're bound to something other than the nodename,
64420Sstevel@tonic-gate 	 * note that in the message buffer and system log.
64430Sstevel@tonic-gate 	 */
64440Sstevel@tonic-gate 	p = ddi_binding_name(dip);
64450Sstevel@tonic-gate 	q = ddi_node_name(dip);
64460Sstevel@tonic-gate 	if (p && q && (strcmp(p, q) != 0))
64470Sstevel@tonic-gate 		NDI_CONFIG_DEBUG((CE_NOTE, "path_to_major: %s bound to %s\n",
64480Sstevel@tonic-gate 		    path, p));
64490Sstevel@tonic-gate 
64504145Scth 	major = ddi_name_to_major(p);
64514145Scth 
64524145Scth 	ndi_rele_devi(dip);		/* release e_ddi_nodeid_to_dip hold */
64534145Scth 
64544145Scth 	return (major);
64550Sstevel@tonic-gate }
64560Sstevel@tonic-gate 
64570Sstevel@tonic-gate /*
64580Sstevel@tonic-gate  * Return the held dip for the specified major and instance, attempting to do
64590Sstevel@tonic-gate  * an attach if specified. Return NULL if the devi can't be found or put in
64600Sstevel@tonic-gate  * the proper state. The caller must release the hold via ddi_release_devi if
64610Sstevel@tonic-gate  * a non-NULL value is returned.
64620Sstevel@tonic-gate  *
64630Sstevel@tonic-gate  * Some callers expect to be able to perform a hold_devi() while in a context
64640Sstevel@tonic-gate  * where using ndi_devi_enter() to ensure the hold might cause deadlock (see
64650Sstevel@tonic-gate  * open-from-attach code in consconfig_dacf.c). Such special-case callers
64660Sstevel@tonic-gate  * must ensure that an ndi_devi_enter(parent)/ndi_devi_hold() from a safe
64670Sstevel@tonic-gate  * context is already active. The hold_devi() implementation must accommodate
64680Sstevel@tonic-gate  * these callers.
64690Sstevel@tonic-gate  */
64700Sstevel@tonic-gate static dev_info_t *
64710Sstevel@tonic-gate hold_devi(major_t major, int instance, int flags)
64720Sstevel@tonic-gate {
64730Sstevel@tonic-gate 	struct devnames	*dnp;
64740Sstevel@tonic-gate 	dev_info_t	*dip;
64750Sstevel@tonic-gate 	char		*path;
64760Sstevel@tonic-gate 
64770Sstevel@tonic-gate 	if ((major >= devcnt) || (instance == -1))
64780Sstevel@tonic-gate 		return (NULL);
64790Sstevel@tonic-gate 
64800Sstevel@tonic-gate 	/* try to find the instance in the per driver list */
64810Sstevel@tonic-gate 	dnp = &(devnamesp[major]);
64820Sstevel@tonic-gate 	LOCK_DEV_OPS(&(dnp->dn_lock));
64830Sstevel@tonic-gate 	for (dip = dnp->dn_head; dip;
64840Sstevel@tonic-gate 	    dip = (dev_info_t *)DEVI(dip)->devi_next) {
64850Sstevel@tonic-gate 		/* skip node if instance field is not valid */
64860Sstevel@tonic-gate 		if (i_ddi_node_state(dip) < DS_INITIALIZED)
64870Sstevel@tonic-gate 			continue;
64880Sstevel@tonic-gate 
64890Sstevel@tonic-gate 		/* look for instance match */
64900Sstevel@tonic-gate 		if (DEVI(dip)->devi_instance == instance) {
64910Sstevel@tonic-gate 			/*
64920Sstevel@tonic-gate 			 * To accommodate callers that can't block in
64930Sstevel@tonic-gate 			 * ndi_devi_enter() we do an ndi_devi_hold(), and
64940Sstevel@tonic-gate 			 * afterwards check that the node is in a state where
64950Sstevel@tonic-gate 			 * the hold prevents detach(). If we did not manage to
64960Sstevel@tonic-gate 			 * prevent detach then we ndi_rele_devi() and perform
64970Sstevel@tonic-gate 			 * the slow path below (which can result in a blocking
64980Sstevel@tonic-gate 			 * ndi_devi_enter() while driving attach top-down).
64990Sstevel@tonic-gate 			 * This code depends on the ordering of
65000Sstevel@tonic-gate 			 * DEVI_SET_DETACHING and the devi_ref check in the
65010Sstevel@tonic-gate 			 * detach_node() code path.
65020Sstevel@tonic-gate 			 */
65030Sstevel@tonic-gate 			ndi_hold_devi(dip);
65041333Scth 			if (i_ddi_devi_attached(dip) &&
65050Sstevel@tonic-gate 			    !DEVI_IS_DETACHING(dip)) {
65060Sstevel@tonic-gate 				UNLOCK_DEV_OPS(&(dnp->dn_lock));
65070Sstevel@tonic-gate 				return (dip);	/* fast-path with devi held */
65080Sstevel@tonic-gate 			}
65090Sstevel@tonic-gate 			ndi_rele_devi(dip);
65100Sstevel@tonic-gate 
65110Sstevel@tonic-gate 			/* try slow-path */
65120Sstevel@tonic-gate 			dip = NULL;
65130Sstevel@tonic-gate 			break;
65140Sstevel@tonic-gate 		}
65150Sstevel@tonic-gate 	}
65160Sstevel@tonic-gate 	ASSERT(dip == NULL);
65170Sstevel@tonic-gate 	UNLOCK_DEV_OPS(&(dnp->dn_lock));
65180Sstevel@tonic-gate 
65190Sstevel@tonic-gate 	if (flags & E_DDI_HOLD_DEVI_NOATTACH)
65200Sstevel@tonic-gate 		return (NULL);		/* told not to drive attach */
65210Sstevel@tonic-gate 
65220Sstevel@tonic-gate 	/* slow-path may block, so it should not occur from interrupt */
65230Sstevel@tonic-gate 	ASSERT(!servicing_interrupt());
65240Sstevel@tonic-gate 	if (servicing_interrupt())
65250Sstevel@tonic-gate 		return (NULL);
65260Sstevel@tonic-gate 
65270Sstevel@tonic-gate 	/* reconstruct the path and drive attach by path through devfs. */
65280Sstevel@tonic-gate 	path = kmem_alloc(MAXPATHLEN, KM_SLEEP);
65290Sstevel@tonic-gate 	if (e_ddi_majorinstance_to_path(major, instance, path) == 0)
65300Sstevel@tonic-gate 		dip = e_ddi_hold_devi_by_path(path, flags);
65310Sstevel@tonic-gate 	kmem_free(path, MAXPATHLEN);
65320Sstevel@tonic-gate 	return (dip);			/* with devi held */
65330Sstevel@tonic-gate }
65340Sstevel@tonic-gate 
65350Sstevel@tonic-gate /*
65360Sstevel@tonic-gate  * The {e_}ddi_hold_devi{_by_{instance|dev|path}} hold the devinfo node
65370Sstevel@tonic-gate  * associated with the specified arguments.  This hold should be released
65380Sstevel@tonic-gate  * by calling ddi_release_devi.
65390Sstevel@tonic-gate  *
65400Sstevel@tonic-gate  * The E_DDI_HOLD_DEVI_NOATTACH flag argument allows the caller to to specify
65410Sstevel@tonic-gate  * a failure return if the node is not already attached.
65420Sstevel@tonic-gate  *
65430Sstevel@tonic-gate  * NOTE: by the time we make e_ddi_hold_devi public, we should be able to reuse
65440Sstevel@tonic-gate  * ddi_hold_devi again.
65450Sstevel@tonic-gate  */
65460Sstevel@tonic-gate dev_info_t *
65470Sstevel@tonic-gate ddi_hold_devi_by_instance(major_t major, int instance, int flags)
65480Sstevel@tonic-gate {
65490Sstevel@tonic-gate 	return (hold_devi(major, instance, flags));
65500Sstevel@tonic-gate }
65510Sstevel@tonic-gate 
65520Sstevel@tonic-gate dev_info_t *
65530Sstevel@tonic-gate e_ddi_hold_devi_by_dev(dev_t dev, int flags)
65540Sstevel@tonic-gate {
65550Sstevel@tonic-gate 	major_t	major = getmajor(dev);
65560Sstevel@tonic-gate 	dev_info_t	*dip;
65570Sstevel@tonic-gate 	struct dev_ops	*ops;
65580Sstevel@tonic-gate 	dev_info_t	*ddip = NULL;
65590Sstevel@tonic-gate 
65600Sstevel@tonic-gate 	dip = hold_devi(major, dev_to_instance(dev), flags);
65610Sstevel@tonic-gate 
65620Sstevel@tonic-gate 	/*
65630Sstevel@tonic-gate 	 * The rest of this routine is legacy support for drivers that
65640Sstevel@tonic-gate 	 * have broken DDI_INFO_DEVT2INSTANCE implementations but may have
65650Sstevel@tonic-gate 	 * functional DDI_INFO_DEVT2DEVINFO implementations.  This code will
65660Sstevel@tonic-gate 	 * diagnose inconsistency and, for maximum compatibility with legacy
65670Sstevel@tonic-gate 	 * drivers, give preference to the drivers DDI_INFO_DEVT2DEVINFO
65680Sstevel@tonic-gate 	 * implementation over the above derived dip based the driver's
65690Sstevel@tonic-gate 	 * DDI_INFO_DEVT2INSTANCE implementation. This legacy support should
65700Sstevel@tonic-gate 	 * be removed when DDI_INFO_DEVT2DEVINFO is deprecated.
65710Sstevel@tonic-gate 	 *
65720Sstevel@tonic-gate 	 * NOTE: The following code has a race condition. DEVT2DEVINFO
65730Sstevel@tonic-gate 	 *	returns a dip which is not held. By the time we ref ddip,
65740Sstevel@tonic-gate 	 *	it could have been freed. The saving grace is that for
65750Sstevel@tonic-gate 	 *	most drivers, the dip returned from hold_devi() is the
65760Sstevel@tonic-gate 	 *	same one as the one returned by DEVT2DEVINFO, so we are
65770Sstevel@tonic-gate 	 *	safe for drivers with the correct getinfo(9e) impl.
65780Sstevel@tonic-gate 	 */
65790Sstevel@tonic-gate 	if (((ops = ddi_hold_driver(major)) != NULL) &&
65800Sstevel@tonic-gate 	    CB_DRV_INSTALLED(ops) && ops->devo_getinfo)  {
65810Sstevel@tonic-gate 		if ((*ops->devo_getinfo)(NULL, DDI_INFO_DEVT2DEVINFO,
65820Sstevel@tonic-gate 		    (void *)dev, (void **)&ddip) != DDI_SUCCESS)
65830Sstevel@tonic-gate 			ddip = NULL;
65840Sstevel@tonic-gate 	}
65850Sstevel@tonic-gate 
65860Sstevel@tonic-gate 	/* give preference to the driver returned DEVT2DEVINFO dip */
65870Sstevel@tonic-gate 	if (ddip && (dip != ddip)) {
65880Sstevel@tonic-gate #ifdef	DEBUG
65890Sstevel@tonic-gate 		cmn_err(CE_WARN, "%s: inconsistent getinfo(9E) implementation",
65900Sstevel@tonic-gate 		    ddi_driver_name(ddip));
65910Sstevel@tonic-gate #endif	/* DEBUG */
65920Sstevel@tonic-gate 		ndi_hold_devi(ddip);
65930Sstevel@tonic-gate 		if (dip)
65940Sstevel@tonic-gate 			ndi_rele_devi(dip);
65950Sstevel@tonic-gate 		dip = ddip;
65960Sstevel@tonic-gate 	}
65970Sstevel@tonic-gate 
65980Sstevel@tonic-gate 	if (ops)
65990Sstevel@tonic-gate 		ddi_rele_driver(major);
66000Sstevel@tonic-gate 
66010Sstevel@tonic-gate 	return (dip);
66020Sstevel@tonic-gate }
66030Sstevel@tonic-gate 
66040Sstevel@tonic-gate /*
66050Sstevel@tonic-gate  * For compatibility only. Do not call this function!
66060Sstevel@tonic-gate  */
66070Sstevel@tonic-gate dev_info_t *
66080Sstevel@tonic-gate e_ddi_get_dev_info(dev_t dev, vtype_t type)
66090Sstevel@tonic-gate {
66100Sstevel@tonic-gate 	dev_info_t *dip = NULL;
66110Sstevel@tonic-gate 	if (getmajor(dev) >= devcnt)
66120Sstevel@tonic-gate 		return (NULL);
66130Sstevel@tonic-gate 
66140Sstevel@tonic-gate 	switch (type) {
66150Sstevel@tonic-gate 	case VCHR:
66160Sstevel@tonic-gate 	case VBLK:
66170Sstevel@tonic-gate 		dip = e_ddi_hold_devi_by_dev(dev, 0);
66180Sstevel@tonic-gate 	default:
66190Sstevel@tonic-gate 		break;
66200Sstevel@tonic-gate 	}
66210Sstevel@tonic-gate 
66220Sstevel@tonic-gate 	/*
66230Sstevel@tonic-gate 	 * For compatibility reasons, we can only return the dip with
66240Sstevel@tonic-gate 	 * the driver ref count held. This is not a safe thing to do.
66250Sstevel@tonic-gate 	 * For certain broken third-party software, we are willing
66260Sstevel@tonic-gate 	 * to venture into unknown territory.
66270Sstevel@tonic-gate 	 */
66280Sstevel@tonic-gate 	if (dip) {
66290Sstevel@tonic-gate 		(void) ndi_hold_driver(dip);
66300Sstevel@tonic-gate 		ndi_rele_devi(dip);
66310Sstevel@tonic-gate 	}
66320Sstevel@tonic-gate 	return (dip);
66330Sstevel@tonic-gate }
66340Sstevel@tonic-gate 
66350Sstevel@tonic-gate dev_info_t *
66360Sstevel@tonic-gate e_ddi_hold_devi_by_path(char *path, int flags)
66370Sstevel@tonic-gate {
66380Sstevel@tonic-gate 	dev_info_t	*dip;
66390Sstevel@tonic-gate 
66400Sstevel@tonic-gate 	/* can't specify NOATTACH by path */
66410Sstevel@tonic-gate 	ASSERT(!(flags & E_DDI_HOLD_DEVI_NOATTACH));
66420Sstevel@tonic-gate 
66430Sstevel@tonic-gate 	return (resolve_pathname(path, &dip, NULL, NULL) ? NULL : dip);
66440Sstevel@tonic-gate }
66450Sstevel@tonic-gate 
66460Sstevel@tonic-gate void
66470Sstevel@tonic-gate e_ddi_hold_devi(dev_info_t *dip)
66480Sstevel@tonic-gate {
66490Sstevel@tonic-gate 	ndi_hold_devi(dip);
66500Sstevel@tonic-gate }
66510Sstevel@tonic-gate 
66520Sstevel@tonic-gate void
66530Sstevel@tonic-gate ddi_release_devi(dev_info_t *dip)
66540Sstevel@tonic-gate {
66550Sstevel@tonic-gate 	ndi_rele_devi(dip);
66560Sstevel@tonic-gate }
66570Sstevel@tonic-gate 
66580Sstevel@tonic-gate /*
66590Sstevel@tonic-gate  * Associate a streams queue with a devinfo node
66600Sstevel@tonic-gate  * NOTE: This function is called by STREAM driver's put procedure.
66610Sstevel@tonic-gate  *	It cannot block.
66620Sstevel@tonic-gate  */
66630Sstevel@tonic-gate void
66640Sstevel@tonic-gate ddi_assoc_queue_with_devi(queue_t *q, dev_info_t *dip)
66650Sstevel@tonic-gate {
66660Sstevel@tonic-gate 	queue_t *rq = _RD(q);
66670Sstevel@tonic-gate 	struct stdata *stp;
66680Sstevel@tonic-gate 	vnode_t *vp;
66690Sstevel@tonic-gate 
66700Sstevel@tonic-gate 	/* set flag indicating that ddi_assoc_queue_with_devi was called */
66710Sstevel@tonic-gate 	mutex_enter(QLOCK(rq));
66720Sstevel@tonic-gate 	rq->q_flag |= _QASSOCIATED;
66730Sstevel@tonic-gate 	mutex_exit(QLOCK(rq));
66740Sstevel@tonic-gate 
66750Sstevel@tonic-gate 	/* get the vnode associated with the queue */
66760Sstevel@tonic-gate 	stp = STREAM(rq);
66770Sstevel@tonic-gate 	vp = stp->sd_vnode;
66780Sstevel@tonic-gate 	ASSERT(vp);
66790Sstevel@tonic-gate 
66800Sstevel@tonic-gate 	/* change the hardware association of the vnode */
66810Sstevel@tonic-gate 	spec_assoc_vp_with_devi(vp, dip);
66820Sstevel@tonic-gate }
66830Sstevel@tonic-gate 
66840Sstevel@tonic-gate /*
66850Sstevel@tonic-gate  * ddi_install_driver(name)
66860Sstevel@tonic-gate  *
66870Sstevel@tonic-gate  * Driver installation is currently a byproduct of driver loading.  This
66880Sstevel@tonic-gate  * may change.
66890Sstevel@tonic-gate  */
66900Sstevel@tonic-gate int
66910Sstevel@tonic-gate ddi_install_driver(char *name)
66920Sstevel@tonic-gate {
66930Sstevel@tonic-gate 	major_t major = ddi_name_to_major(name);
66940Sstevel@tonic-gate 
66957009Scth 	if ((major == DDI_MAJOR_T_NONE) ||
66960Sstevel@tonic-gate 	    (ddi_hold_installed_driver(major) == NULL)) {
66970Sstevel@tonic-gate 		return (DDI_FAILURE);
66980Sstevel@tonic-gate 	}
66990Sstevel@tonic-gate 	ddi_rele_driver(major);
67000Sstevel@tonic-gate 	return (DDI_SUCCESS);
67010Sstevel@tonic-gate }
67020Sstevel@tonic-gate 
67030Sstevel@tonic-gate struct dev_ops *
67040Sstevel@tonic-gate ddi_hold_driver(major_t major)
67050Sstevel@tonic-gate {
67060Sstevel@tonic-gate 	return (mod_hold_dev_by_major(major));
67070Sstevel@tonic-gate }
67080Sstevel@tonic-gate 
67090Sstevel@tonic-gate 
67100Sstevel@tonic-gate void
67110Sstevel@tonic-gate ddi_rele_driver(major_t major)
67120Sstevel@tonic-gate {
67130Sstevel@tonic-gate 	mod_rele_dev_by_major(major);
67140Sstevel@tonic-gate }
67150Sstevel@tonic-gate 
67160Sstevel@tonic-gate 
67170Sstevel@tonic-gate /*
67180Sstevel@tonic-gate  * This is called during boot to force attachment order of special dips
67190Sstevel@tonic-gate  * dip must be referenced via ndi_hold_devi()
67200Sstevel@tonic-gate  */
67210Sstevel@tonic-gate int
67220Sstevel@tonic-gate i_ddi_attach_node_hierarchy(dev_info_t *dip)
67230Sstevel@tonic-gate {
67242155Scth 	dev_info_t	*parent;
67252155Scth 	int		ret, circ;
67262155Scth 
67272155Scth 	/*
67282155Scth 	 * Recurse up until attached parent is found.
67292155Scth 	 */
67302009Sdm120769 	if (i_ddi_devi_attached(dip))
67312009Sdm120769 		return (DDI_SUCCESS);
67320Sstevel@tonic-gate 	parent = ddi_get_parent(dip);
67330Sstevel@tonic-gate 	if (i_ddi_attach_node_hierarchy(parent) != DDI_SUCCESS)
67340Sstevel@tonic-gate 		return (DDI_FAILURE);
67350Sstevel@tonic-gate 
67360Sstevel@tonic-gate 	/*
67372155Scth 	 * Come top-down, expanding .conf nodes under this parent
67382155Scth 	 * and driving attach.
67390Sstevel@tonic-gate 	 */
67402155Scth 	ndi_devi_enter(parent, &circ);
67410Sstevel@tonic-gate 	(void) i_ndi_make_spec_children(parent, 0);
67422155Scth 	ret = i_ddi_attachchild(dip);
67432155Scth 	ndi_devi_exit(parent, circ);
67442155Scth 
67452155Scth 	return (ret);
67460Sstevel@tonic-gate }
67470Sstevel@tonic-gate 
67480Sstevel@tonic-gate /* keep this function static */
67490Sstevel@tonic-gate static int
67500Sstevel@tonic-gate attach_driver_nodes(major_t major)
67510Sstevel@tonic-gate {
67520Sstevel@tonic-gate 	struct devnames *dnp;
67530Sstevel@tonic-gate 	dev_info_t *dip;
67540Sstevel@tonic-gate 	int error = DDI_FAILURE;
67550Sstevel@tonic-gate 
67560Sstevel@tonic-gate 	dnp = &devnamesp[major];
67570Sstevel@tonic-gate 	LOCK_DEV_OPS(&dnp->dn_lock);
67580Sstevel@tonic-gate 	dip = dnp->dn_head;
67590Sstevel@tonic-gate 	while (dip) {
67600Sstevel@tonic-gate 		ndi_hold_devi(dip);
67610Sstevel@tonic-gate 		UNLOCK_DEV_OPS(&dnp->dn_lock);
67620Sstevel@tonic-gate 		if (i_ddi_attach_node_hierarchy(dip) == DDI_SUCCESS)
67630Sstevel@tonic-gate 			error = DDI_SUCCESS;
67640Sstevel@tonic-gate 		LOCK_DEV_OPS(&dnp->dn_lock);
67650Sstevel@tonic-gate 		ndi_rele_devi(dip);
67660Sstevel@tonic-gate 		dip = ddi_get_next(dip);
67670Sstevel@tonic-gate 	}
67680Sstevel@tonic-gate 	if (error == DDI_SUCCESS)
67690Sstevel@tonic-gate 		dnp->dn_flags |= DN_NO_AUTODETACH;
67700Sstevel@tonic-gate 	UNLOCK_DEV_OPS(&dnp->dn_lock);
67710Sstevel@tonic-gate 
67720Sstevel@tonic-gate 
67730Sstevel@tonic-gate 	return (error);
67740Sstevel@tonic-gate }
67750Sstevel@tonic-gate 
67760Sstevel@tonic-gate /*
67770Sstevel@tonic-gate  * i_ddi_attach_hw_nodes configures and attaches all hw nodes
67780Sstevel@tonic-gate  * bound to a specific driver. This function replaces calls to
67790Sstevel@tonic-gate  * ddi_hold_installed_driver() for drivers with no .conf
67800Sstevel@tonic-gate  * enumerated nodes.
67810Sstevel@tonic-gate  *
67820Sstevel@tonic-gate  * This facility is typically called at boot time to attach
67830Sstevel@tonic-gate  * platform-specific hardware nodes, such as ppm nodes on xcal
67840Sstevel@tonic-gate  * and grover and keyswitch nodes on cherrystone. It does not
67850Sstevel@tonic-gate  * deal with .conf enumerated node. Calling it beyond the boot
67860Sstevel@tonic-gate  * process is strongly discouraged.
67870Sstevel@tonic-gate  */
67880Sstevel@tonic-gate int
67890Sstevel@tonic-gate i_ddi_attach_hw_nodes(char *driver)
67900Sstevel@tonic-gate {
67910Sstevel@tonic-gate 	major_t major;
67920Sstevel@tonic-gate 
67930Sstevel@tonic-gate 	major = ddi_name_to_major(driver);
67947009Scth 	if (major == DDI_MAJOR_T_NONE)
67950Sstevel@tonic-gate 		return (DDI_FAILURE);
67960Sstevel@tonic-gate 
67970Sstevel@tonic-gate 	return (attach_driver_nodes(major));
67980Sstevel@tonic-gate }
67990Sstevel@tonic-gate 
68000Sstevel@tonic-gate /*
68010Sstevel@tonic-gate  * i_ddi_attach_pseudo_node configures pseudo drivers which
68020Sstevel@tonic-gate  * has a single node. The .conf nodes must be enumerated
68030Sstevel@tonic-gate  * before calling this interface. The dip is held attached
68040Sstevel@tonic-gate  * upon returning.
68050Sstevel@tonic-gate  *
68060Sstevel@tonic-gate  * This facility should only be called only at boot time
68070Sstevel@tonic-gate  * by the I/O framework.
68080Sstevel@tonic-gate  */
68090Sstevel@tonic-gate dev_info_t *
68100Sstevel@tonic-gate i_ddi_attach_pseudo_node(char *driver)
68110Sstevel@tonic-gate {
68120Sstevel@tonic-gate 	major_t major;
68130Sstevel@tonic-gate 	dev_info_t *dip;
68140Sstevel@tonic-gate 
68150Sstevel@tonic-gate 	major = ddi_name_to_major(driver);
68167009Scth 	if (major == DDI_MAJOR_T_NONE)
68170Sstevel@tonic-gate 		return (NULL);
68180Sstevel@tonic-gate 
68190Sstevel@tonic-gate 	if (attach_driver_nodes(major) != DDI_SUCCESS)
68200Sstevel@tonic-gate 		return (NULL);
68210Sstevel@tonic-gate 
68220Sstevel@tonic-gate 	dip = devnamesp[major].dn_head;
68230Sstevel@tonic-gate 	ASSERT(dip && ddi_get_next(dip) == NULL);
68240Sstevel@tonic-gate 	ndi_hold_devi(dip);
68250Sstevel@tonic-gate 	return (dip);
68260Sstevel@tonic-gate }
68270Sstevel@tonic-gate 
68280Sstevel@tonic-gate static void
68290Sstevel@tonic-gate diplist_to_parent_major(dev_info_t *head, char parents[])
68300Sstevel@tonic-gate {
68310Sstevel@tonic-gate 	major_t major;
68320Sstevel@tonic-gate 	dev_info_t *dip, *pdip;
68330Sstevel@tonic-gate 
68340Sstevel@tonic-gate 	for (dip = head; dip != NULL; dip = ddi_get_next(dip)) {
68350Sstevel@tonic-gate 		pdip = ddi_get_parent(dip);
68360Sstevel@tonic-gate 		ASSERT(pdip);	/* disallow rootnex.conf nodes */
68370Sstevel@tonic-gate 		major = ddi_driver_major(pdip);
68387009Scth 		if ((major != DDI_MAJOR_T_NONE) && parents[major] == 0)
68390Sstevel@tonic-gate 			parents[major] = 1;
68400Sstevel@tonic-gate 	}
68410Sstevel@tonic-gate }
68420Sstevel@tonic-gate 
68430Sstevel@tonic-gate /*
68440Sstevel@tonic-gate  * Call ddi_hold_installed_driver() on each parent major
68450Sstevel@tonic-gate  * and invoke mt_config_driver() to attach child major.
68460Sstevel@tonic-gate  * This is part of the implementation of ddi_hold_installed_driver.
68470Sstevel@tonic-gate  */
68480Sstevel@tonic-gate static int
68490Sstevel@tonic-gate attach_driver_by_parent(major_t child_major, char parents[])
68500Sstevel@tonic-gate {
68510Sstevel@tonic-gate 	major_t par_major;
68520Sstevel@tonic-gate 	struct mt_config_handle *hdl;
68530Sstevel@tonic-gate 	int flags = NDI_DEVI_PERSIST | NDI_NO_EVENT;
68540Sstevel@tonic-gate 
68550Sstevel@tonic-gate 	hdl = mt_config_init(NULL, NULL, flags, child_major, MT_CONFIG_OP,
68560Sstevel@tonic-gate 	    NULL);
68570Sstevel@tonic-gate 	for (par_major = 0; par_major < devcnt; par_major++) {
68580Sstevel@tonic-gate 		/* disallow recursion on the same driver */
68590Sstevel@tonic-gate 		if (parents[par_major] == 0 || par_major == child_major)
68600Sstevel@tonic-gate 			continue;
68610Sstevel@tonic-gate 		if (ddi_hold_installed_driver(par_major) == NULL)
68620Sstevel@tonic-gate 			continue;
68630Sstevel@tonic-gate 		hdl->mtc_parmajor = par_major;
68640Sstevel@tonic-gate 		mt_config_driver(hdl);
68650Sstevel@tonic-gate 		ddi_rele_driver(par_major);
68660Sstevel@tonic-gate 	}
68670Sstevel@tonic-gate 	(void) mt_config_fini(hdl);
68680Sstevel@tonic-gate 
68690Sstevel@tonic-gate 	return (i_ddi_devs_attached(child_major));
68700Sstevel@tonic-gate }
68710Sstevel@tonic-gate 
68720Sstevel@tonic-gate int
68730Sstevel@tonic-gate i_ddi_devs_attached(major_t major)
68740Sstevel@tonic-gate {
68750Sstevel@tonic-gate 	dev_info_t *dip;
68760Sstevel@tonic-gate 	struct devnames *dnp;
68770Sstevel@tonic-gate 	int error = DDI_FAILURE;
68780Sstevel@tonic-gate 
68790Sstevel@tonic-gate 	/* check for attached instances */
68800Sstevel@tonic-gate 	dnp = &devnamesp[major];
68810Sstevel@tonic-gate 	LOCK_DEV_OPS(&dnp->dn_lock);
68820Sstevel@tonic-gate 	for (dip = dnp->dn_head; dip != NULL; dip = ddi_get_next(dip)) {
68831333Scth 		if (i_ddi_devi_attached(dip)) {
68840Sstevel@tonic-gate 			error = DDI_SUCCESS;
68850Sstevel@tonic-gate 			break;
68860Sstevel@tonic-gate 		}
68870Sstevel@tonic-gate 	}
68880Sstevel@tonic-gate 	UNLOCK_DEV_OPS(&dnp->dn_lock);
68890Sstevel@tonic-gate 
68900Sstevel@tonic-gate 	return (error);
68910Sstevel@tonic-gate }
68920Sstevel@tonic-gate 
68935895Syz147064 int
68945895Syz147064 i_ddi_minor_node_count(dev_info_t *ddip, const char *node_type)
68955895Syz147064 {
68967224Scth 	int			circ;
68977224Scth 	struct ddi_minor_data	*dp;
68987224Scth 	int			count = 0;
68997224Scth 
69007224Scth 	ndi_devi_enter(ddip, &circ);
69017224Scth 	for (dp = DEVI(ddip)->devi_minor; dp != NULL; dp = dp->next) {
69025895Syz147064 		if (strcmp(dp->ddm_node_type, node_type) == 0)
69035895Syz147064 			count++;
69047224Scth 	}
69057224Scth 	ndi_devi_exit(ddip, circ);
69065895Syz147064 	return (count);
69075895Syz147064 }
69085895Syz147064 
69090Sstevel@tonic-gate /*
69100Sstevel@tonic-gate  * ddi_hold_installed_driver configures and attaches all
69110Sstevel@tonic-gate  * instances of the specified driver. To accomplish this
69120Sstevel@tonic-gate  * it configures and attaches all possible parents of
69130Sstevel@tonic-gate  * the driver, enumerated both in h/w nodes and in the
69140Sstevel@tonic-gate  * driver's .conf file.
69150Sstevel@tonic-gate  *
69160Sstevel@tonic-gate  * NOTE: This facility is for compatibility purposes only and will
69170Sstevel@tonic-gate  *	eventually go away. Its usage is strongly discouraged.
69180Sstevel@tonic-gate  */
69190Sstevel@tonic-gate static void
69200Sstevel@tonic-gate enter_driver(struct devnames *dnp)
69210Sstevel@tonic-gate {
69220Sstevel@tonic-gate 	mutex_enter(&dnp->dn_lock);
69230Sstevel@tonic-gate 	ASSERT(dnp->dn_busy_thread != curthread);
69240Sstevel@tonic-gate 	while (dnp->dn_flags & DN_DRIVER_BUSY)
69250Sstevel@tonic-gate 		cv_wait(&dnp->dn_wait, &dnp->dn_lock);
69260Sstevel@tonic-gate 	dnp->dn_flags |= DN_DRIVER_BUSY;
69270Sstevel@tonic-gate 	dnp->dn_busy_thread = curthread;
69280Sstevel@tonic-gate 	mutex_exit(&dnp->dn_lock);
69290Sstevel@tonic-gate }
69300Sstevel@tonic-gate 
69310Sstevel@tonic-gate static void
69320Sstevel@tonic-gate exit_driver(struct devnames *dnp)
69330Sstevel@tonic-gate {
69340Sstevel@tonic-gate 	mutex_enter(&dnp->dn_lock);
69350Sstevel@tonic-gate 	ASSERT(dnp->dn_busy_thread == curthread);
69360Sstevel@tonic-gate 	dnp->dn_flags &= ~DN_DRIVER_BUSY;
69370Sstevel@tonic-gate 	dnp->dn_busy_thread = NULL;
69380Sstevel@tonic-gate 	cv_broadcast(&dnp->dn_wait);
69390Sstevel@tonic-gate 	mutex_exit(&dnp->dn_lock);
69400Sstevel@tonic-gate }
69410Sstevel@tonic-gate 
69420Sstevel@tonic-gate struct dev_ops *
69430Sstevel@tonic-gate ddi_hold_installed_driver(major_t major)
69440Sstevel@tonic-gate {
69450Sstevel@tonic-gate 	struct dev_ops *ops;
69460Sstevel@tonic-gate 	struct devnames *dnp;
69470Sstevel@tonic-gate 	char *parents;
69480Sstevel@tonic-gate 	int error;
69490Sstevel@tonic-gate 
69500Sstevel@tonic-gate 	ops = ddi_hold_driver(major);
69510Sstevel@tonic-gate 	if (ops == NULL)
69520Sstevel@tonic-gate 		return (NULL);
69530Sstevel@tonic-gate 
69540Sstevel@tonic-gate 	/*
69550Sstevel@tonic-gate 	 * Return immediately if all the attach operations associated
69560Sstevel@tonic-gate 	 * with a ddi_hold_installed_driver() call have already been done.
69570Sstevel@tonic-gate 	 */
69580Sstevel@tonic-gate 	dnp = &devnamesp[major];
69590Sstevel@tonic-gate 	enter_driver(dnp);
69600Sstevel@tonic-gate 	if (dnp->dn_flags & DN_DRIVER_HELD) {
69610Sstevel@tonic-gate 		exit_driver(dnp);
69620Sstevel@tonic-gate 		if (i_ddi_devs_attached(major) == DDI_SUCCESS)
69630Sstevel@tonic-gate 			return (ops);
69640Sstevel@tonic-gate 		ddi_rele_driver(major);
69650Sstevel@tonic-gate 		return (NULL);
69660Sstevel@tonic-gate 	}
69670Sstevel@tonic-gate 
69680Sstevel@tonic-gate 	LOCK_DEV_OPS(&dnp->dn_lock);
69690Sstevel@tonic-gate 	dnp->dn_flags |= (DN_DRIVER_HELD | DN_NO_AUTODETACH);
69700Sstevel@tonic-gate 	UNLOCK_DEV_OPS(&dnp->dn_lock);
69710Sstevel@tonic-gate 
69720Sstevel@tonic-gate 	DCOMPATPRINTF((CE_CONT,
69730Sstevel@tonic-gate 	    "ddi_hold_installed_driver: %s\n", dnp->dn_name));
69740Sstevel@tonic-gate 
69750Sstevel@tonic-gate 	/*
69760Sstevel@tonic-gate 	 * When the driver has no .conf children, it is sufficient
69770Sstevel@tonic-gate 	 * to attach existing nodes in the device tree. Nodes not
69780Sstevel@tonic-gate 	 * enumerated by the OBP are not attached.
69790Sstevel@tonic-gate 	 */
69800Sstevel@tonic-gate 	if (dnp->dn_pl == NULL) {
69810Sstevel@tonic-gate 		if (attach_driver_nodes(major) == DDI_SUCCESS) {
69820Sstevel@tonic-gate 			exit_driver(dnp);
69830Sstevel@tonic-gate 			return (ops);
69840Sstevel@tonic-gate 		}
69850Sstevel@tonic-gate 		exit_driver(dnp);
69860Sstevel@tonic-gate 		ddi_rele_driver(major);
69870Sstevel@tonic-gate 		return (NULL);
69880Sstevel@tonic-gate 	}
69890Sstevel@tonic-gate 
69900Sstevel@tonic-gate 	/*
69910Sstevel@tonic-gate 	 * Driver has .conf nodes. We find all possible parents
69920Sstevel@tonic-gate 	 * and recursively all ddi_hold_installed_driver on the
69930Sstevel@tonic-gate 	 * parent driver; then we invoke ndi_config_driver()
69940Sstevel@tonic-gate 	 * on all possible parent node in parallel to speed up
69950Sstevel@tonic-gate 	 * performance.
69960Sstevel@tonic-gate 	 */
69970Sstevel@tonic-gate 	parents = kmem_zalloc(devcnt * sizeof (char), KM_SLEEP);
69980Sstevel@tonic-gate 
69990Sstevel@tonic-gate 	LOCK_DEV_OPS(&dnp->dn_lock);
70000Sstevel@tonic-gate 	/* find .conf parents */
70010Sstevel@tonic-gate 	(void) impl_parlist_to_major(dnp->dn_pl, parents);
70020Sstevel@tonic-gate 	/* find hw node parents */
70030Sstevel@tonic-gate 	diplist_to_parent_major(dnp->dn_head, parents);
70040Sstevel@tonic-gate 	UNLOCK_DEV_OPS(&dnp->dn_lock);
70050Sstevel@tonic-gate 
70060Sstevel@tonic-gate 	error = attach_driver_by_parent(major, parents);
70070Sstevel@tonic-gate 	kmem_free(parents, devcnt * sizeof (char));
70080Sstevel@tonic-gate 	if (error == DDI_SUCCESS) {
70090Sstevel@tonic-gate 		exit_driver(dnp);
70100Sstevel@tonic-gate 		return (ops);
70110Sstevel@tonic-gate 	}
70120Sstevel@tonic-gate 
70130Sstevel@tonic-gate 	exit_driver(dnp);
70140Sstevel@tonic-gate 	ddi_rele_driver(major);
70150Sstevel@tonic-gate 	return (NULL);
70160Sstevel@tonic-gate }
70170Sstevel@tonic-gate 
70180Sstevel@tonic-gate /*
70190Sstevel@tonic-gate  * Default bus_config entry point for nexus drivers
70200Sstevel@tonic-gate  */
70210Sstevel@tonic-gate int
70220Sstevel@tonic-gate ndi_busop_bus_config(dev_info_t *pdip, uint_t flags, ddi_bus_config_op_t op,
70230Sstevel@tonic-gate     void *arg, dev_info_t **child, clock_t timeout)
70240Sstevel@tonic-gate {
70250Sstevel@tonic-gate 	major_t major;
70260Sstevel@tonic-gate 
70270Sstevel@tonic-gate 	/*
70280Sstevel@tonic-gate 	 * A timeout of 30 minutes or more is probably a mistake
70290Sstevel@tonic-gate 	 * This is intended to catch uses where timeout is in
70300Sstevel@tonic-gate 	 * the wrong units.  timeout must be in units of ticks.
70310Sstevel@tonic-gate 	 */
70320Sstevel@tonic-gate 	ASSERT(timeout < SEC_TO_TICK(1800));
70330Sstevel@tonic-gate 
70347009Scth 	major = DDI_MAJOR_T_NONE;
70350Sstevel@tonic-gate 	switch (op) {
70360Sstevel@tonic-gate 	case BUS_CONFIG_ONE:
70370Sstevel@tonic-gate 		NDI_DEBUG(flags, (CE_CONT, "%s%d: bus config %s timeout=%ld\n",
70384950Scth 		    ddi_driver_name(pdip), ddi_get_instance(pdip),
70394950Scth 		    (char *)arg, timeout));
70400Sstevel@tonic-gate 		return (devi_config_one(pdip, (char *)arg, child, flags,
70410Sstevel@tonic-gate 		    timeout));
70420Sstevel@tonic-gate 
70430Sstevel@tonic-gate 	case BUS_CONFIG_DRIVER:
70440Sstevel@tonic-gate 		major = (major_t)(uintptr_t)arg;
70450Sstevel@tonic-gate 		/*FALLTHROUGH*/
70460Sstevel@tonic-gate 	case BUS_CONFIG_ALL:
70470Sstevel@tonic-gate 		NDI_DEBUG(flags, (CE_CONT, "%s%d: bus config timeout=%ld\n",
70484950Scth 		    ddi_driver_name(pdip), ddi_get_instance(pdip),
70494950Scth 		    timeout));
70500Sstevel@tonic-gate 		if (timeout > 0) {
70510Sstevel@tonic-gate 			NDI_DEBUG(flags, (CE_CONT,
70520Sstevel@tonic-gate 			    "%s%d: bus config all timeout=%ld\n",
70530Sstevel@tonic-gate 			    ddi_driver_name(pdip), ddi_get_instance(pdip),
70540Sstevel@tonic-gate 			    timeout));
70550Sstevel@tonic-gate 			delay(timeout);
70560Sstevel@tonic-gate 		}
70570Sstevel@tonic-gate 		return (config_immediate_children(pdip, flags, major));
70580Sstevel@tonic-gate 
70590Sstevel@tonic-gate 	default:
70600Sstevel@tonic-gate 		return (NDI_FAILURE);
70610Sstevel@tonic-gate 	}
70620Sstevel@tonic-gate 	/*NOTREACHED*/
70630Sstevel@tonic-gate }
70640Sstevel@tonic-gate 
70650Sstevel@tonic-gate /*
70660Sstevel@tonic-gate  * Default busop bus_unconfig handler for nexus drivers
70670Sstevel@tonic-gate  */
70680Sstevel@tonic-gate int
70690Sstevel@tonic-gate ndi_busop_bus_unconfig(dev_info_t *pdip, uint_t flags, ddi_bus_config_op_t op,
70700Sstevel@tonic-gate     void *arg)
70710Sstevel@tonic-gate {
70720Sstevel@tonic-gate 	major_t major;
70730Sstevel@tonic-gate 
70747009Scth 	major = DDI_MAJOR_T_NONE;
70750Sstevel@tonic-gate 	switch (op) {
70760Sstevel@tonic-gate 	case BUS_UNCONFIG_ONE:
70770Sstevel@tonic-gate 		NDI_DEBUG(flags, (CE_CONT, "%s%d: bus unconfig %s\n",
70780Sstevel@tonic-gate 		    ddi_driver_name(pdip), ddi_get_instance(pdip),
70790Sstevel@tonic-gate 		    (char *)arg));
70800Sstevel@tonic-gate 		return (devi_unconfig_one(pdip, (char *)arg, flags));
70810Sstevel@tonic-gate 
70820Sstevel@tonic-gate 	case BUS_UNCONFIG_DRIVER:
70830Sstevel@tonic-gate 		major = (major_t)(uintptr_t)arg;
70840Sstevel@tonic-gate 		/*FALLTHROUGH*/
70850Sstevel@tonic-gate 	case BUS_UNCONFIG_ALL:
70860Sstevel@tonic-gate 		NDI_DEBUG(flags, (CE_CONT, "%s%d: bus unconfig all\n",
70870Sstevel@tonic-gate 		    ddi_driver_name(pdip), ddi_get_instance(pdip)));
70880Sstevel@tonic-gate 		return (unconfig_immediate_children(pdip, NULL, flags, major));
70890Sstevel@tonic-gate 
70900Sstevel@tonic-gate 	default:
70910Sstevel@tonic-gate 		return (NDI_FAILURE);
70920Sstevel@tonic-gate 	}
70930Sstevel@tonic-gate 	/*NOTREACHED*/
70940Sstevel@tonic-gate }
70950Sstevel@tonic-gate 
70960Sstevel@tonic-gate /*
70970Sstevel@tonic-gate  * dummy functions to be removed
70980Sstevel@tonic-gate  */
70990Sstevel@tonic-gate void
71000Sstevel@tonic-gate impl_rem_dev_props(dev_info_t *dip)
71010Sstevel@tonic-gate {
71020Sstevel@tonic-gate 	_NOTE(ARGUNUSED(dip))
71030Sstevel@tonic-gate 	/* do nothing */
71040Sstevel@tonic-gate }
71050Sstevel@tonic-gate 
71060Sstevel@tonic-gate /*
71070Sstevel@tonic-gate  * Determine if a node is a leaf node. If not sure, return false (0).
71080Sstevel@tonic-gate  */
71090Sstevel@tonic-gate static int
71100Sstevel@tonic-gate is_leaf_node(dev_info_t *dip)
71110Sstevel@tonic-gate {
71120Sstevel@tonic-gate 	major_t major = ddi_driver_major(dip);
71130Sstevel@tonic-gate 
71147009Scth 	if (major == DDI_MAJOR_T_NONE)
71150Sstevel@tonic-gate 		return (0);
71160Sstevel@tonic-gate 
71170Sstevel@tonic-gate 	return (devnamesp[major].dn_flags & DN_LEAF_DRIVER);
71180Sstevel@tonic-gate }
71190Sstevel@tonic-gate 
71200Sstevel@tonic-gate /*
71210Sstevel@tonic-gate  * Multithreaded [un]configuration
71220Sstevel@tonic-gate  */
71230Sstevel@tonic-gate static struct mt_config_handle *
71240Sstevel@tonic-gate mt_config_init(dev_info_t *pdip, dev_info_t **dipp, int flags,
71250Sstevel@tonic-gate     major_t major, int op, struct brevq_node **brevqp)
71260Sstevel@tonic-gate {
71270Sstevel@tonic-gate 	struct mt_config_handle	*hdl = kmem_alloc(sizeof (*hdl), KM_SLEEP);
71280Sstevel@tonic-gate 
71290Sstevel@tonic-gate 	mutex_init(&hdl->mtc_lock, NULL, MUTEX_DEFAULT, NULL);
71300Sstevel@tonic-gate 	cv_init(&hdl->mtc_cv, NULL, CV_DEFAULT, NULL);
71310Sstevel@tonic-gate 	hdl->mtc_pdip = pdip;
71320Sstevel@tonic-gate 	hdl->mtc_fdip = dipp;
71337009Scth 	hdl->mtc_parmajor = DDI_MAJOR_T_NONE;
71340Sstevel@tonic-gate 	hdl->mtc_flags = flags;
71350Sstevel@tonic-gate 	hdl->mtc_major = major;
71360Sstevel@tonic-gate 	hdl->mtc_thr_count = 0;
71370Sstevel@tonic-gate 	hdl->mtc_op = op;
71380Sstevel@tonic-gate 	hdl->mtc_error = 0;
71390Sstevel@tonic-gate 	hdl->mtc_brevqp = brevqp;
71400Sstevel@tonic-gate 
71410Sstevel@tonic-gate #ifdef DEBUG
71420Sstevel@tonic-gate 	gethrestime(&hdl->start_time);
71430Sstevel@tonic-gate 	hdl->total_time = 0;
71440Sstevel@tonic-gate #endif /* DEBUG */
71450Sstevel@tonic-gate 
71460Sstevel@tonic-gate 	return (hdl);
71470Sstevel@tonic-gate }
71480Sstevel@tonic-gate 
71490Sstevel@tonic-gate #ifdef DEBUG
71500Sstevel@tonic-gate static int
71510Sstevel@tonic-gate time_diff_in_msec(timestruc_t start, timestruc_t end)
71520Sstevel@tonic-gate {
71530Sstevel@tonic-gate 	int	nsec, sec;
71540Sstevel@tonic-gate 
71550Sstevel@tonic-gate 	sec = end.tv_sec - start.tv_sec;
71560Sstevel@tonic-gate 	nsec = end.tv_nsec - start.tv_nsec;
71570Sstevel@tonic-gate 	if (nsec < 0) {
71580Sstevel@tonic-gate 		nsec += NANOSEC;
71590Sstevel@tonic-gate 		sec -= 1;
71600Sstevel@tonic-gate 	}
71610Sstevel@tonic-gate 
71620Sstevel@tonic-gate 	return (sec * (NANOSEC >> 20) + (nsec >> 20));
71630Sstevel@tonic-gate }
71640Sstevel@tonic-gate 
71650Sstevel@tonic-gate #endif	/* DEBUG */
71660Sstevel@tonic-gate 
71670Sstevel@tonic-gate static int
71680Sstevel@tonic-gate mt_config_fini(struct mt_config_handle *hdl)
71690Sstevel@tonic-gate {
71700Sstevel@tonic-gate 	int		rv;
71710Sstevel@tonic-gate #ifdef DEBUG
71720Sstevel@tonic-gate 	int		real_time;
71730Sstevel@tonic-gate 	timestruc_t	end_time;
71740Sstevel@tonic-gate #endif /* DEBUG */
71750Sstevel@tonic-gate 
71760Sstevel@tonic-gate 	mutex_enter(&hdl->mtc_lock);
71770Sstevel@tonic-gate 	while (hdl->mtc_thr_count > 0)
71780Sstevel@tonic-gate 		cv_wait(&hdl->mtc_cv, &hdl->mtc_lock);
71790Sstevel@tonic-gate 	rv = hdl->mtc_error;
71800Sstevel@tonic-gate 	mutex_exit(&hdl->mtc_lock);
71810Sstevel@tonic-gate 
71820Sstevel@tonic-gate #ifdef DEBUG
71830Sstevel@tonic-gate 	gethrestime(&end_time);
71840Sstevel@tonic-gate 	real_time = time_diff_in_msec(hdl->start_time, end_time);
71850Sstevel@tonic-gate 	if ((ddidebug & DDI_MTCONFIG) && hdl->mtc_pdip)
71860Sstevel@tonic-gate 		cmn_err(CE_NOTE,
71870Sstevel@tonic-gate 		    "config %s%d: total time %d msec, real time %d msec",
71884950Scth 		    ddi_driver_name(hdl->mtc_pdip),
71894950Scth 		    ddi_get_instance(hdl->mtc_pdip),
71904950Scth 		    hdl->total_time, real_time);
71910Sstevel@tonic-gate #endif /* DEBUG */
71920Sstevel@tonic-gate 
71930Sstevel@tonic-gate 	cv_destroy(&hdl->mtc_cv);
71940Sstevel@tonic-gate 	mutex_destroy(&hdl->mtc_lock);
71950Sstevel@tonic-gate 	kmem_free(hdl, sizeof (*hdl));
71960Sstevel@tonic-gate 
71970Sstevel@tonic-gate 	return (rv);
71980Sstevel@tonic-gate }
71990Sstevel@tonic-gate 
72000Sstevel@tonic-gate struct mt_config_data {
72010Sstevel@tonic-gate 	struct mt_config_handle	*mtc_hdl;
72020Sstevel@tonic-gate 	dev_info_t		*mtc_dip;
72030Sstevel@tonic-gate 	major_t			mtc_major;
72040Sstevel@tonic-gate 	int			mtc_flags;
72050Sstevel@tonic-gate 	struct brevq_node	*mtc_brn;
72060Sstevel@tonic-gate 	struct mt_config_data	*mtc_next;
72070Sstevel@tonic-gate };
72080Sstevel@tonic-gate 
72090Sstevel@tonic-gate static void
72100Sstevel@tonic-gate mt_config_thread(void *arg)
72110Sstevel@tonic-gate {
72120Sstevel@tonic-gate 	struct mt_config_data	*mcd = (struct mt_config_data *)arg;
72130Sstevel@tonic-gate 	struct mt_config_handle	*hdl = mcd->mtc_hdl;
72140Sstevel@tonic-gate 	dev_info_t		*dip = mcd->mtc_dip;
72150Sstevel@tonic-gate 	dev_info_t		*rdip, **dipp;
72160Sstevel@tonic-gate 	major_t			major = mcd->mtc_major;
72170Sstevel@tonic-gate 	int			flags = mcd->mtc_flags;
72180Sstevel@tonic-gate 	int			rv = 0;
72190Sstevel@tonic-gate 
72200Sstevel@tonic-gate #ifdef DEBUG
72210Sstevel@tonic-gate 	timestruc_t start_time, end_time;
72220Sstevel@tonic-gate 	gethrestime(&start_time);
72230Sstevel@tonic-gate #endif /* DEBUG */
72240Sstevel@tonic-gate 
72250Sstevel@tonic-gate 	rdip = NULL;
72260Sstevel@tonic-gate 	dipp = hdl->mtc_fdip ? &rdip : NULL;
72270Sstevel@tonic-gate 
72280Sstevel@tonic-gate 	switch (hdl->mtc_op) {
72290Sstevel@tonic-gate 	case MT_CONFIG_OP:
72300Sstevel@tonic-gate 		rv = devi_config_common(dip, flags, major);
72310Sstevel@tonic-gate 		break;
72320Sstevel@tonic-gate 	case MT_UNCONFIG_OP:
72330Sstevel@tonic-gate 		if (mcd->mtc_brn) {
72340Sstevel@tonic-gate 			struct brevq_node *brevq = NULL;
72350Sstevel@tonic-gate 			rv = devi_unconfig_common(dip, dipp, flags, major,
72360Sstevel@tonic-gate 			    &brevq);
72371317Scth 			mcd->mtc_brn->brn_child = brevq;
72380Sstevel@tonic-gate 		} else
72390Sstevel@tonic-gate 			rv = devi_unconfig_common(dip, dipp, flags, major,
72400Sstevel@tonic-gate 			    NULL);
72410Sstevel@tonic-gate 		break;
72420Sstevel@tonic-gate 	}
72430Sstevel@tonic-gate 
72440Sstevel@tonic-gate 	mutex_enter(&hdl->mtc_lock);
72450Sstevel@tonic-gate #ifdef DEBUG
72460Sstevel@tonic-gate 	gethrestime(&end_time);
72470Sstevel@tonic-gate 	hdl->total_time += time_diff_in_msec(start_time, end_time);
72480Sstevel@tonic-gate #endif /* DEBUG */
72492155Scth 
72502155Scth 	if ((rv != NDI_SUCCESS) && (hdl->mtc_error == 0)) {
72510Sstevel@tonic-gate 		hdl->mtc_error = rv;
72522155Scth #ifdef	DEBUG
72537009Scth 		if ((ddidebug & DDI_DEBUG) && (major != DDI_MAJOR_T_NONE)) {
72542155Scth 			char	*path = kmem_alloc(MAXPATHLEN, KM_SLEEP);
72552155Scth 
72562155Scth 			(void) ddi_pathname(dip, path);
72572155Scth 			cmn_err(CE_NOTE, "mt_config_thread: "
72582155Scth 			    "op %d.%d.%x at %s failed %d",
72592155Scth 			    hdl->mtc_op, major, flags, path, rv);
72602155Scth 			kmem_free(path, MAXPATHLEN);
72612155Scth 		}
72622155Scth #endif	/* DEBUG */
72632155Scth 	}
72642155Scth 
72650Sstevel@tonic-gate 	if (hdl->mtc_fdip && *hdl->mtc_fdip == NULL) {
72660Sstevel@tonic-gate 		*hdl->mtc_fdip = rdip;
72670Sstevel@tonic-gate 		rdip = NULL;
72680Sstevel@tonic-gate 	}
72690Sstevel@tonic-gate 
72700Sstevel@tonic-gate 	if (rdip) {
72710Sstevel@tonic-gate 		ASSERT(rv != NDI_SUCCESS);
72720Sstevel@tonic-gate 		ndi_rele_devi(rdip);
72730Sstevel@tonic-gate 	}
72740Sstevel@tonic-gate 
72750Sstevel@tonic-gate 	ndi_rele_devi(dip);
72761826Sbm42561 
72771826Sbm42561 	if (--hdl->mtc_thr_count == 0)
72781826Sbm42561 		cv_broadcast(&hdl->mtc_cv);
72791826Sbm42561 	mutex_exit(&hdl->mtc_lock);
72800Sstevel@tonic-gate 	kmem_free(mcd, sizeof (*mcd));
72810Sstevel@tonic-gate }
72820Sstevel@tonic-gate 
72830Sstevel@tonic-gate /*
72840Sstevel@tonic-gate  * Multi-threaded config/unconfig of child nexus
72850Sstevel@tonic-gate  */
72860Sstevel@tonic-gate static void
72870Sstevel@tonic-gate mt_config_children(struct mt_config_handle *hdl)
72880Sstevel@tonic-gate {
72890Sstevel@tonic-gate 	dev_info_t		*pdip = hdl->mtc_pdip;
72900Sstevel@tonic-gate 	major_t			major = hdl->mtc_major;
72910Sstevel@tonic-gate 	dev_info_t		*dip;
72920Sstevel@tonic-gate 	int			circ;
72931317Scth 	struct brevq_node	*brn;
72940Sstevel@tonic-gate 	struct mt_config_data	*mcd_head = NULL;
72950Sstevel@tonic-gate 	struct mt_config_data	*mcd_tail = NULL;
72960Sstevel@tonic-gate 	struct mt_config_data	*mcd;
72970Sstevel@tonic-gate #ifdef DEBUG
72980Sstevel@tonic-gate 	timestruc_t		end_time;
72990Sstevel@tonic-gate 
73000Sstevel@tonic-gate 	/* Update total_time in handle */
73010Sstevel@tonic-gate 	gethrestime(&end_time);
73020Sstevel@tonic-gate 	hdl->total_time += time_diff_in_msec(hdl->start_time, end_time);
73030Sstevel@tonic-gate #endif
73040Sstevel@tonic-gate 
73050Sstevel@tonic-gate 	ndi_devi_enter(pdip, &circ);
73060Sstevel@tonic-gate 	dip = ddi_get_child(pdip);
73070Sstevel@tonic-gate 	while (dip) {
73080Sstevel@tonic-gate 		if (hdl->mtc_op == MT_UNCONFIG_OP && hdl->mtc_brevqp &&
73090Sstevel@tonic-gate 		    !(DEVI_EVREMOVE(dip)) &&
73100Sstevel@tonic-gate 		    i_ddi_node_state(dip) >= DS_INITIALIZED) {
73110Sstevel@tonic-gate 			/*
73120Sstevel@tonic-gate 			 * Enqueue this dip's deviname.
73130Sstevel@tonic-gate 			 * No need to hold a lock while enqueuing since this
73140Sstevel@tonic-gate 			 * is the only thread doing the enqueue and no one
73150Sstevel@tonic-gate 			 * walks the queue while we are in multithreaded
73160Sstevel@tonic-gate 			 * unconfiguration.
73170Sstevel@tonic-gate 			 */
73180Sstevel@tonic-gate 			brn = brevq_enqueue(hdl->mtc_brevqp, dip, NULL);
73191317Scth 		} else
73201317Scth 			brn = NULL;
73210Sstevel@tonic-gate 
73220Sstevel@tonic-gate 		/*
73230Sstevel@tonic-gate 		 * Hold the child that we are processing so he does not get
73240Sstevel@tonic-gate 		 * removed. The corrisponding ndi_rele_devi() for children
73250Sstevel@tonic-gate 		 * that are not being skipped is done at the end of
73260Sstevel@tonic-gate 		 * mt_config_thread().
73270Sstevel@tonic-gate 		 */
73280Sstevel@tonic-gate 		ndi_hold_devi(dip);
73290Sstevel@tonic-gate 
73300Sstevel@tonic-gate 		/*
73310Sstevel@tonic-gate 		 * skip leaf nodes and (for configure) nodes not
73320Sstevel@tonic-gate 		 * fully attached.
73330Sstevel@tonic-gate 		 */
73340Sstevel@tonic-gate 		if (is_leaf_node(dip) ||
73350Sstevel@tonic-gate 		    (hdl->mtc_op == MT_CONFIG_OP &&
73360Sstevel@tonic-gate 		    i_ddi_node_state(dip) < DS_READY)) {
73370Sstevel@tonic-gate 			ndi_rele_devi(dip);
73380Sstevel@tonic-gate 			dip = ddi_get_next_sibling(dip);
73390Sstevel@tonic-gate 			continue;
73400Sstevel@tonic-gate 		}
73410Sstevel@tonic-gate 
73420Sstevel@tonic-gate 		mcd = kmem_alloc(sizeof (*mcd), KM_SLEEP);
73430Sstevel@tonic-gate 		mcd->mtc_dip = dip;
73440Sstevel@tonic-gate 		mcd->mtc_hdl = hdl;
73450Sstevel@tonic-gate 		mcd->mtc_brn = brn;
73460Sstevel@tonic-gate 
73470Sstevel@tonic-gate 		/*
73480Sstevel@tonic-gate 		 * Switch a 'driver' operation to an 'all' operation below a
73490Sstevel@tonic-gate 		 * node bound to the driver.
73500Sstevel@tonic-gate 		 */
73517009Scth 		if ((major == DDI_MAJOR_T_NONE) ||
73527009Scth 		    (major == ddi_driver_major(dip)))
73537009Scth 			mcd->mtc_major = DDI_MAJOR_T_NONE;
73540Sstevel@tonic-gate 		else
73550Sstevel@tonic-gate 			mcd->mtc_major = major;
73560Sstevel@tonic-gate 
73570Sstevel@tonic-gate 		/*
73580Sstevel@tonic-gate 		 * The unconfig-driver to unconfig-all conversion above
73590Sstevel@tonic-gate 		 * constitutes an autodetach for NDI_DETACH_DRIVER calls,
73600Sstevel@tonic-gate 		 * set NDI_AUTODETACH.
73610Sstevel@tonic-gate 		 */
73620Sstevel@tonic-gate 		mcd->mtc_flags = hdl->mtc_flags;
73630Sstevel@tonic-gate 		if ((mcd->mtc_flags & NDI_DETACH_DRIVER) &&
73640Sstevel@tonic-gate 		    (hdl->mtc_op == MT_UNCONFIG_OP) &&
73650Sstevel@tonic-gate 		    (major == ddi_driver_major(pdip)))
73660Sstevel@tonic-gate 			mcd->mtc_flags |= NDI_AUTODETACH;
73670Sstevel@tonic-gate 
73680Sstevel@tonic-gate 		mutex_enter(&hdl->mtc_lock);
73690Sstevel@tonic-gate 		hdl->mtc_thr_count++;
73700Sstevel@tonic-gate 		mutex_exit(&hdl->mtc_lock);
73710Sstevel@tonic-gate 
73720Sstevel@tonic-gate 		/*
73730Sstevel@tonic-gate 		 * Add to end of list to process after ndi_devi_exit to avoid
73740Sstevel@tonic-gate 		 * locking differences depending on value of mtc_off.
73750Sstevel@tonic-gate 		 */
73760Sstevel@tonic-gate 		mcd->mtc_next = NULL;
73770Sstevel@tonic-gate 		if (mcd_head == NULL)
73780Sstevel@tonic-gate 			mcd_head = mcd;
73790Sstevel@tonic-gate 		else
73800Sstevel@tonic-gate 			mcd_tail->mtc_next = mcd;
73810Sstevel@tonic-gate 		mcd_tail = mcd;
73820Sstevel@tonic-gate 
73830Sstevel@tonic-gate 		dip = ddi_get_next_sibling(dip);
73840Sstevel@tonic-gate 	}
73850Sstevel@tonic-gate 	ndi_devi_exit(pdip, circ);
73860Sstevel@tonic-gate 
73870Sstevel@tonic-gate 	/* go through the list of held children */
73880Sstevel@tonic-gate 	for (mcd = mcd_head; mcd; mcd = mcd_head) {
73890Sstevel@tonic-gate 		mcd_head = mcd->mtc_next;
73902155Scth 		if (mtc_off || (mcd->mtc_flags & NDI_MTC_OFF))
73910Sstevel@tonic-gate 			mt_config_thread(mcd);
73920Sstevel@tonic-gate 		else
73930Sstevel@tonic-gate 			(void) thread_create(NULL, 0, mt_config_thread, mcd,
73940Sstevel@tonic-gate 			    0, &p0, TS_RUN, minclsyspri);
73950Sstevel@tonic-gate 	}
73960Sstevel@tonic-gate }
73970Sstevel@tonic-gate 
73980Sstevel@tonic-gate static void
73990Sstevel@tonic-gate mt_config_driver(struct mt_config_handle *hdl)
74000Sstevel@tonic-gate {
74010Sstevel@tonic-gate 	major_t			par_major = hdl->mtc_parmajor;
74020Sstevel@tonic-gate 	major_t			major = hdl->mtc_major;
74030Sstevel@tonic-gate 	struct devnames		*dnp = &devnamesp[par_major];
74040Sstevel@tonic-gate 	dev_info_t		*dip;
74050Sstevel@tonic-gate 	struct mt_config_data	*mcd_head = NULL;
74060Sstevel@tonic-gate 	struct mt_config_data	*mcd_tail = NULL;
74070Sstevel@tonic-gate 	struct mt_config_data	*mcd;
74080Sstevel@tonic-gate #ifdef DEBUG
74090Sstevel@tonic-gate 	timestruc_t		end_time;
74100Sstevel@tonic-gate 
74110Sstevel@tonic-gate 	/* Update total_time in handle */
74120Sstevel@tonic-gate 	gethrestime(&end_time);
74130Sstevel@tonic-gate 	hdl->total_time += time_diff_in_msec(hdl->start_time, end_time);
74140Sstevel@tonic-gate #endif
74157009Scth 	ASSERT(par_major != DDI_MAJOR_T_NONE);
74167009Scth 	ASSERT(major != DDI_MAJOR_T_NONE);
74170Sstevel@tonic-gate 
74180Sstevel@tonic-gate 	LOCK_DEV_OPS(&dnp->dn_lock);
74190Sstevel@tonic-gate 	dip = devnamesp[par_major].dn_head;
74200Sstevel@tonic-gate 	while (dip) {
74210Sstevel@tonic-gate 		/*
74220Sstevel@tonic-gate 		 * Hold the child that we are processing so he does not get
74230Sstevel@tonic-gate 		 * removed. The corrisponding ndi_rele_devi() for children
74240Sstevel@tonic-gate 		 * that are not being skipped is done at the end of
74250Sstevel@tonic-gate 		 * mt_config_thread().
74260Sstevel@tonic-gate 		 */
74270Sstevel@tonic-gate 		ndi_hold_devi(dip);
74280Sstevel@tonic-gate 
74290Sstevel@tonic-gate 		/* skip leaf nodes and nodes not fully attached */
74301333Scth 		if (!i_ddi_devi_attached(dip) || is_leaf_node(dip)) {
74310Sstevel@tonic-gate 			ndi_rele_devi(dip);
74320Sstevel@tonic-gate 			dip = ddi_get_next(dip);
74330Sstevel@tonic-gate 			continue;
74340Sstevel@tonic-gate 		}
74350Sstevel@tonic-gate 
74360Sstevel@tonic-gate 		mcd = kmem_alloc(sizeof (*mcd), KM_SLEEP);
74370Sstevel@tonic-gate 		mcd->mtc_dip = dip;
74380Sstevel@tonic-gate 		mcd->mtc_hdl = hdl;
74390Sstevel@tonic-gate 		mcd->mtc_major = major;
74400Sstevel@tonic-gate 		mcd->mtc_flags = hdl->mtc_flags;
74410Sstevel@tonic-gate 
74420Sstevel@tonic-gate 		mutex_enter(&hdl->mtc_lock);
74430Sstevel@tonic-gate 		hdl->mtc_thr_count++;
74440Sstevel@tonic-gate 		mutex_exit(&hdl->mtc_lock);
74450Sstevel@tonic-gate 
74460Sstevel@tonic-gate 		/*
74470Sstevel@tonic-gate 		 * Add to end of list to process after UNLOCK_DEV_OPS to avoid
74480Sstevel@tonic-gate 		 * locking differences depending on value of mtc_off.
74490Sstevel@tonic-gate 		 */
74500Sstevel@tonic-gate 		mcd->mtc_next = NULL;
74510Sstevel@tonic-gate 		if (mcd_head == NULL)
74520Sstevel@tonic-gate 			mcd_head = mcd;
74530Sstevel@tonic-gate 		else
74540Sstevel@tonic-gate 			mcd_tail->mtc_next = mcd;
74550Sstevel@tonic-gate 		mcd_tail = mcd;
74560Sstevel@tonic-gate 
74570Sstevel@tonic-gate 		dip = ddi_get_next(dip);
74580Sstevel@tonic-gate 	}
74590Sstevel@tonic-gate 	UNLOCK_DEV_OPS(&dnp->dn_lock);
74600Sstevel@tonic-gate 
74610Sstevel@tonic-gate 	/* go through the list of held children */
74620Sstevel@tonic-gate 	for (mcd = mcd_head; mcd; mcd = mcd_head) {
74630Sstevel@tonic-gate 		mcd_head = mcd->mtc_next;
74642155Scth 		if (mtc_off || (mcd->mtc_flags & NDI_MTC_OFF))
74650Sstevel@tonic-gate 			mt_config_thread(mcd);
74660Sstevel@tonic-gate 		else
74670Sstevel@tonic-gate 			(void) thread_create(NULL, 0, mt_config_thread, mcd,
74680Sstevel@tonic-gate 			    0, &p0, TS_RUN, minclsyspri);
74690Sstevel@tonic-gate 	}
74700Sstevel@tonic-gate }
74710Sstevel@tonic-gate 
74720Sstevel@tonic-gate /*
74730Sstevel@tonic-gate  * Given the nodeid for a persistent (PROM or SID) node, return
74740Sstevel@tonic-gate  * the corresponding devinfo node
74750Sstevel@tonic-gate  * NOTE: This function will return NULL for .conf nodeids.
74760Sstevel@tonic-gate  */
74770Sstevel@tonic-gate dev_info_t *
7478789Sahrens e_ddi_nodeid_to_dip(pnode_t nodeid)
74790Sstevel@tonic-gate {
74800Sstevel@tonic-gate 	dev_info_t		*dip = NULL;
74810Sstevel@tonic-gate 	struct devi_nodeid	*prev, *elem;
74820Sstevel@tonic-gate 
74830Sstevel@tonic-gate 	mutex_enter(&devimap->dno_lock);
74840Sstevel@tonic-gate 
74850Sstevel@tonic-gate 	prev = NULL;
74860Sstevel@tonic-gate 	for (elem = devimap->dno_head; elem; elem = elem->next) {
74870Sstevel@tonic-gate 		if (elem->nodeid == nodeid) {
74880Sstevel@tonic-gate 			ndi_hold_devi(elem->dip);
74890Sstevel@tonic-gate 			dip = elem->dip;
74900Sstevel@tonic-gate 			break;
74910Sstevel@tonic-gate 		}
74920Sstevel@tonic-gate 		prev = elem;
74930Sstevel@tonic-gate 	}
74940Sstevel@tonic-gate 
74950Sstevel@tonic-gate 	/*
74960Sstevel@tonic-gate 	 * Move to head for faster lookup next time
74970Sstevel@tonic-gate 	 */
74980Sstevel@tonic-gate 	if (elem && prev) {
74990Sstevel@tonic-gate 		prev->next = elem->next;
75000Sstevel@tonic-gate 		elem->next = devimap->dno_head;
75010Sstevel@tonic-gate 		devimap->dno_head = elem;
75020Sstevel@tonic-gate 	}
75030Sstevel@tonic-gate 
75040Sstevel@tonic-gate 	mutex_exit(&devimap->dno_lock);
75050Sstevel@tonic-gate 	return (dip);
75060Sstevel@tonic-gate }
75070Sstevel@tonic-gate 
75080Sstevel@tonic-gate static void
75090Sstevel@tonic-gate free_cache_task(void *arg)
75100Sstevel@tonic-gate {
75110Sstevel@tonic-gate 	ASSERT(arg == NULL);
75120Sstevel@tonic-gate 
75130Sstevel@tonic-gate 	mutex_enter(&di_cache.cache_lock);
75140Sstevel@tonic-gate 
75150Sstevel@tonic-gate 	/*
75160Sstevel@tonic-gate 	 * The cache can be invalidated without holding the lock
75170Sstevel@tonic-gate 	 * but it can be made valid again only while the lock is held.
75180Sstevel@tonic-gate 	 * So if the cache is invalid when the lock is held, it will
75190Sstevel@tonic-gate 	 * stay invalid until lock is released.
75200Sstevel@tonic-gate 	 */
75210Sstevel@tonic-gate 	if (!di_cache.cache_valid)
75220Sstevel@tonic-gate 		i_ddi_di_cache_free(&di_cache);
75230Sstevel@tonic-gate 
75240Sstevel@tonic-gate 	mutex_exit(&di_cache.cache_lock);
75250Sstevel@tonic-gate 
75260Sstevel@tonic-gate 	if (di_cache_debug)
75270Sstevel@tonic-gate 		cmn_err(CE_NOTE, "system_taskq: di_cache freed");
75280Sstevel@tonic-gate }
75290Sstevel@tonic-gate 
75300Sstevel@tonic-gate extern int modrootloaded;
75310Sstevel@tonic-gate 
75320Sstevel@tonic-gate void
75330Sstevel@tonic-gate i_ddi_di_cache_free(struct di_cache *cache)
75340Sstevel@tonic-gate {
75350Sstevel@tonic-gate 	int	error;
75367656SSherry.Moore@Sun.COM 	extern int sys_shutdown;
75370Sstevel@tonic-gate 
75380Sstevel@tonic-gate 	ASSERT(mutex_owned(&cache->cache_lock));
75390Sstevel@tonic-gate 
75400Sstevel@tonic-gate 	if (cache->cache_size) {
75410Sstevel@tonic-gate 		ASSERT(cache->cache_size > 0);
75420Sstevel@tonic-gate 		ASSERT(cache->cache_data);
75430Sstevel@tonic-gate 
75440Sstevel@tonic-gate 		kmem_free(cache->cache_data, cache->cache_size);
75450Sstevel@tonic-gate 		cache->cache_data = NULL;
75460Sstevel@tonic-gate 		cache->cache_size = 0;
75470Sstevel@tonic-gate 
75480Sstevel@tonic-gate 		if (di_cache_debug)
75490Sstevel@tonic-gate 			cmn_err(CE_NOTE, "i_ddi_di_cache_free: freed cachemem");
75500Sstevel@tonic-gate 	} else {
75510Sstevel@tonic-gate 		ASSERT(cache->cache_data == NULL);
75520Sstevel@tonic-gate 		if (di_cache_debug)
75530Sstevel@tonic-gate 			cmn_err(CE_NOTE, "i_ddi_di_cache_free: NULL cache");
75540Sstevel@tonic-gate 	}
75550Sstevel@tonic-gate 
75567576SJerry.Gilliam@Sun.COM 	if (!modrootloaded || rootvp == NULL ||
75577576SJerry.Gilliam@Sun.COM 	    vn_is_readonly(rootvp) || sys_shutdown) {
75580Sstevel@tonic-gate 		if (di_cache_debug) {
75590Sstevel@tonic-gate 			cmn_err(CE_WARN, "/ not mounted/RDONLY. Skip unlink");
75600Sstevel@tonic-gate 		}
75610Sstevel@tonic-gate 		return;
75620Sstevel@tonic-gate 	}
75630Sstevel@tonic-gate 
75640Sstevel@tonic-gate 	error = vn_remove(DI_CACHE_FILE, UIO_SYSSPACE, RMFILE);
75650Sstevel@tonic-gate 	if (di_cache_debug && error && error != ENOENT) {
75660Sstevel@tonic-gate 		cmn_err(CE_WARN, "%s: unlink failed: %d", DI_CACHE_FILE, error);
75670Sstevel@tonic-gate 	} else if (di_cache_debug && !error) {
75680Sstevel@tonic-gate 		cmn_err(CE_NOTE, "i_ddi_di_cache_free: unlinked cache file");
75690Sstevel@tonic-gate 	}
75700Sstevel@tonic-gate }
75710Sstevel@tonic-gate 
75720Sstevel@tonic-gate void
75730Sstevel@tonic-gate i_ddi_di_cache_invalidate(int kmflag)
75740Sstevel@tonic-gate {
75756065Scth 	int	cache_valid;
75760Sstevel@tonic-gate 
75770Sstevel@tonic-gate 	if (!modrootloaded || !i_ddi_io_initialized()) {
75780Sstevel@tonic-gate 		if (di_cache_debug)
75790Sstevel@tonic-gate 			cmn_err(CE_NOTE, "I/O not inited. Skipping invalidate");
75800Sstevel@tonic-gate 		return;
75810Sstevel@tonic-gate 	}
75820Sstevel@tonic-gate 
75836065Scth 	/* Increment devtree generation number. */
75842621Sllai1 	atomic_inc_ulong(&devtree_gen);
75850Sstevel@tonic-gate 
75866065Scth 	/* Invalidate the in-core cache and dispatch free on valid->invalid */
75876065Scth 	cache_valid = atomic_swap_uint(&di_cache.cache_valid, 0);
75886065Scth 	if (cache_valid) {
75896065Scth 		(void) taskq_dispatch(system_taskq, free_cache_task, NULL,
75906065Scth 		    (kmflag == KM_SLEEP) ? TQ_SLEEP : TQ_NOSLEEP);
75916065Scth 	}
75920Sstevel@tonic-gate 
75930Sstevel@tonic-gate 	if (di_cache_debug) {
75940Sstevel@tonic-gate 		cmn_err(CE_NOTE, "invalidation with km_flag: %s",
75950Sstevel@tonic-gate 		    kmflag == KM_SLEEP ? "KM_SLEEP" : "KM_NOSLEEP");
75960Sstevel@tonic-gate 	}
75970Sstevel@tonic-gate }
75980Sstevel@tonic-gate 
75990Sstevel@tonic-gate 
76000Sstevel@tonic-gate static void
76010Sstevel@tonic-gate i_bind_vhci_node(dev_info_t *dip)
76020Sstevel@tonic-gate {
76034145Scth 	DEVI(dip)->devi_major = ddi_name_to_major(ddi_node_name(dip));
76040Sstevel@tonic-gate 	i_ddi_set_node_state(dip, DS_BOUND);
76050Sstevel@tonic-gate }
76060Sstevel@tonic-gate 
76070Sstevel@tonic-gate static char vhci_node_addr[2];
76080Sstevel@tonic-gate 
76090Sstevel@tonic-gate static int
76100Sstevel@tonic-gate i_init_vhci_node(dev_info_t *dip)
76110Sstevel@tonic-gate {
76120Sstevel@tonic-gate 	add_global_props(dip);
76130Sstevel@tonic-gate 	DEVI(dip)->devi_ops = ndi_hold_driver(dip);
76140Sstevel@tonic-gate 	if (DEVI(dip)->devi_ops == NULL)
76150Sstevel@tonic-gate 		return (-1);
76160Sstevel@tonic-gate 
76170Sstevel@tonic-gate 	DEVI(dip)->devi_instance = e_ddi_assign_instance(dip);
76180Sstevel@tonic-gate 	e_ddi_keep_instance(dip);
76190Sstevel@tonic-gate 	vhci_node_addr[0]	= '\0';
76200Sstevel@tonic-gate 	ddi_set_name_addr(dip, vhci_node_addr);
76210Sstevel@tonic-gate 	i_ddi_set_node_state(dip, DS_INITIALIZED);
76220Sstevel@tonic-gate 	return (0);
76230Sstevel@tonic-gate }
76240Sstevel@tonic-gate 
76250Sstevel@tonic-gate static void
76260Sstevel@tonic-gate i_link_vhci_node(dev_info_t *dip)
76270Sstevel@tonic-gate {
76281093Shiremath 	ASSERT(MUTEX_HELD(&global_vhci_lock));
76291093Shiremath 
76300Sstevel@tonic-gate 	/*
76310Sstevel@tonic-gate 	 * scsi_vhci should be kept left most of the device tree.
76320Sstevel@tonic-gate 	 */
76330Sstevel@tonic-gate 	if (scsi_vhci_dip) {
76340Sstevel@tonic-gate 		DEVI(dip)->devi_sibling = DEVI(scsi_vhci_dip)->devi_sibling;
76350Sstevel@tonic-gate 		DEVI(scsi_vhci_dip)->devi_sibling = DEVI(dip);
76360Sstevel@tonic-gate 	} else {
76370Sstevel@tonic-gate 		DEVI(dip)->devi_sibling = DEVI(top_devinfo)->devi_child;
76380Sstevel@tonic-gate 		DEVI(top_devinfo)->devi_child = DEVI(dip);
76390Sstevel@tonic-gate 	}
76400Sstevel@tonic-gate }
76410Sstevel@tonic-gate 
76420Sstevel@tonic-gate 
76430Sstevel@tonic-gate /*
76440Sstevel@tonic-gate  * This a special routine to enumerate vhci node (child of rootnex
76450Sstevel@tonic-gate  * node) without holding the ndi_devi_enter() lock. The device node
76460Sstevel@tonic-gate  * is allocated, initialized and brought into DS_READY state before
76470Sstevel@tonic-gate  * inserting into the device tree. The VHCI node is handcrafted
76480Sstevel@tonic-gate  * here to bring the node to DS_READY, similar to rootnex node.
76490Sstevel@tonic-gate  *
76500Sstevel@tonic-gate  * The global_vhci_lock protects linking the node into the device
76510Sstevel@tonic-gate  * as same lock is held before linking/unlinking any direct child
76520Sstevel@tonic-gate  * of rootnex children.
76530Sstevel@tonic-gate  *
76540Sstevel@tonic-gate  * This routine is a workaround to handle a possible deadlock
76550Sstevel@tonic-gate  * that occurs while trying to enumerate node in a different sub-tree
76560Sstevel@tonic-gate  * during _init/_attach entry points.
76570Sstevel@tonic-gate  */
76580Sstevel@tonic-gate /*ARGSUSED*/
76590Sstevel@tonic-gate dev_info_t *
76600Sstevel@tonic-gate ndi_devi_config_vhci(char *drvname, int flags)
76610Sstevel@tonic-gate {
76620Sstevel@tonic-gate 	struct devnames		*dnp;
76630Sstevel@tonic-gate 	dev_info_t		*dip;
76640Sstevel@tonic-gate 	major_t			major = ddi_name_to_major(drvname);
76650Sstevel@tonic-gate 
76660Sstevel@tonic-gate 	if (major == -1)
76670Sstevel@tonic-gate 		return (NULL);
76680Sstevel@tonic-gate 
76690Sstevel@tonic-gate 	/* Make sure we create the VHCI node only once */
76700Sstevel@tonic-gate 	dnp = &devnamesp[major];
76710Sstevel@tonic-gate 	LOCK_DEV_OPS(&dnp->dn_lock);
76720Sstevel@tonic-gate 	if (dnp->dn_head) {
76730Sstevel@tonic-gate 		dip = dnp->dn_head;
76740Sstevel@tonic-gate 		UNLOCK_DEV_OPS(&dnp->dn_lock);
76750Sstevel@tonic-gate 		return (dip);
76760Sstevel@tonic-gate 	}
76770Sstevel@tonic-gate 	UNLOCK_DEV_OPS(&dnp->dn_lock);
76780Sstevel@tonic-gate 
76790Sstevel@tonic-gate 	/* Allocate the VHCI node */
76800Sstevel@tonic-gate 	ndi_devi_alloc_sleep(top_devinfo, drvname, DEVI_SID_NODEID, &dip);
76810Sstevel@tonic-gate 	ndi_hold_devi(dip);
76820Sstevel@tonic-gate 
76830Sstevel@tonic-gate 	/* Mark the node as VHCI */
76840Sstevel@tonic-gate 	DEVI(dip)->devi_node_attributes |= DDI_VHCI_NODE;
76850Sstevel@tonic-gate 
76860Sstevel@tonic-gate 	i_ddi_add_devimap(dip);
76870Sstevel@tonic-gate 	i_bind_vhci_node(dip);
76880Sstevel@tonic-gate 	if (i_init_vhci_node(dip) == -1) {
76890Sstevel@tonic-gate 		ndi_rele_devi(dip);
76900Sstevel@tonic-gate 		(void) ndi_devi_free(dip);
76910Sstevel@tonic-gate 		return (NULL);
76920Sstevel@tonic-gate 	}
76930Sstevel@tonic-gate 
7694495Scth 	mutex_enter(&(DEVI(dip)->devi_lock));
76950Sstevel@tonic-gate 	DEVI_SET_ATTACHING(dip);
7696495Scth 	mutex_exit(&(DEVI(dip)->devi_lock));
7697495Scth 
76980Sstevel@tonic-gate 	if (devi_attach(dip, DDI_ATTACH) != DDI_SUCCESS) {
76990Sstevel@tonic-gate 		cmn_err(CE_CONT, "Could not attach %s driver", drvname);
77000Sstevel@tonic-gate 		e_ddi_free_instance(dip, vhci_node_addr);
77010Sstevel@tonic-gate 		ndi_rele_devi(dip);
77020Sstevel@tonic-gate 		(void) ndi_devi_free(dip);
77030Sstevel@tonic-gate 		return (NULL);
77040Sstevel@tonic-gate 	}
7705495Scth 	mutex_enter(&(DEVI(dip)->devi_lock));
77060Sstevel@tonic-gate 	DEVI_CLR_ATTACHING(dip);
7707495Scth 	mutex_exit(&(DEVI(dip)->devi_lock));
77080Sstevel@tonic-gate 
77091093Shiremath 	mutex_enter(&global_vhci_lock);
77100Sstevel@tonic-gate 	i_link_vhci_node(dip);
77111093Shiremath 	mutex_exit(&global_vhci_lock);
77120Sstevel@tonic-gate 	i_ddi_set_node_state(dip, DS_READY);
77130Sstevel@tonic-gate 
77140Sstevel@tonic-gate 	LOCK_DEV_OPS(&dnp->dn_lock);
77150Sstevel@tonic-gate 	dnp->dn_flags |= DN_DRIVER_HELD;
77160Sstevel@tonic-gate 	dnp->dn_head = dip;
77170Sstevel@tonic-gate 	UNLOCK_DEV_OPS(&dnp->dn_lock);
77180Sstevel@tonic-gate 
77190Sstevel@tonic-gate 	i_ndi_devi_report_status_change(dip, NULL);
77200Sstevel@tonic-gate 
77210Sstevel@tonic-gate 	return (dip);
77220Sstevel@tonic-gate }
77230Sstevel@tonic-gate 
77240Sstevel@tonic-gate /*
77250Sstevel@tonic-gate  * ibt_hw_is_present() returns 0 when there is no IB hardware actively
77260Sstevel@tonic-gate  * running.  This is primarily useful for modules like rpcmod which
77270Sstevel@tonic-gate  * needs a quick check to decide whether or not it should try to use
77280Sstevel@tonic-gate  * InfiniBand
77290Sstevel@tonic-gate  */
77300Sstevel@tonic-gate int ib_hw_status = 0;
77310Sstevel@tonic-gate int
77320Sstevel@tonic-gate ibt_hw_is_present()
77330Sstevel@tonic-gate {
77340Sstevel@tonic-gate 	return (ib_hw_status);
77350Sstevel@tonic-gate }
77364845Svikram 
77374845Svikram /*
77384845Svikram  * ASSERT that constraint flag is not set and then set the "retire attempt"
77394845Svikram  * flag.
77404845Svikram  */
77414845Svikram int
77424845Svikram e_ddi_mark_retiring(dev_info_t *dip, void *arg)
77434845Svikram {
77444845Svikram 	char	**cons_array = (char **)arg;
77454845Svikram 	char	*path;
77464845Svikram 	int	constraint;
77474845Svikram 	int	i;
77484845Svikram 
77494845Svikram 	constraint = 0;
77504845Svikram 	if (cons_array) {
77514845Svikram 		path = kmem_alloc(MAXPATHLEN, KM_SLEEP);
77524845Svikram 		(void) ddi_pathname(dip, path);
77534845Svikram 		for (i = 0; cons_array[i] != NULL; i++) {
77544845Svikram 			if (strcmp(path, cons_array[i]) == 0) {
77554845Svikram 				constraint = 1;
77564845Svikram 				break;
77574845Svikram 			}
77584845Svikram 		}
77594845Svikram 		kmem_free(path, MAXPATHLEN);
77604845Svikram 	}
77614845Svikram 
77624845Svikram 	mutex_enter(&DEVI(dip)->devi_lock);
77634845Svikram 	ASSERT(!(DEVI(dip)->devi_flags & DEVI_R_CONSTRAINT));
77644845Svikram 	DEVI(dip)->devi_flags |= DEVI_RETIRING;
77654845Svikram 	if (constraint)
77664845Svikram 		DEVI(dip)->devi_flags |= DEVI_R_CONSTRAINT;
77674845Svikram 	mutex_exit(&DEVI(dip)->devi_lock);
77684845Svikram 
77694845Svikram 	RIO_VERBOSE((CE_NOTE, "marked dip as undergoing retire process dip=%p",
77704845Svikram 	    (void *)dip));
77714845Svikram 
77724845Svikram 	if (constraint)
77734845Svikram 		RIO_DEBUG((CE_NOTE, "marked dip as constrained, dip=%p",
77744845Svikram 		    (void *)dip));
77754845Svikram 
77764845Svikram 	if (MDI_PHCI(dip))
77774845Svikram 		mdi_phci_mark_retiring(dip, cons_array);
77784845Svikram 
77794845Svikram 	return (DDI_WALK_CONTINUE);
77804845Svikram }
77814845Svikram 
77824845Svikram static void
77834845Svikram free_array(char **cons_array)
77844845Svikram {
77854845Svikram 	int	i;
77864845Svikram 
77874845Svikram 	if (cons_array == NULL)
77884845Svikram 		return;
77894845Svikram 
77904845Svikram 	for (i = 0; cons_array[i] != NULL; i++) {
77914845Svikram 		kmem_free(cons_array[i], strlen(cons_array[i]) + 1);
77924845Svikram 	}
77934845Svikram 	kmem_free(cons_array, (i+1) * sizeof (char *));
77944845Svikram }
77954845Svikram 
77964845Svikram /*
77974845Svikram  * Walk *every* node in subtree and check if it blocks, allows or has no
77984845Svikram  * comment on a proposed retire.
77994845Svikram  */
78004845Svikram int
78014845Svikram e_ddi_retire_notify(dev_info_t *dip, void *arg)
78024845Svikram {
78034845Svikram 	int	*constraint = (int *)arg;
78044845Svikram 
78054845Svikram 	RIO_DEBUG((CE_NOTE, "retire notify: dip = %p", (void *)dip));
78064845Svikram 
78074845Svikram 	(void) e_ddi_offline_notify(dip);
78084845Svikram 
78094845Svikram 	mutex_enter(&(DEVI(dip)->devi_lock));
78104845Svikram 	if (!(DEVI(dip)->devi_flags & DEVI_RETIRING)) {
78114845Svikram 		RIO_DEBUG((CE_WARN, "retire notify: dip in retire "
78124845Svikram 		    "subtree is not marked: dip = %p", (void *)dip));
78134845Svikram 		*constraint = 0;
78144845Svikram 	} else if (DEVI(dip)->devi_flags & DEVI_R_BLOCKED) {
78154845Svikram 		ASSERT(!(DEVI(dip)->devi_flags & DEVI_R_CONSTRAINT));
78164845Svikram 		RIO_DEBUG((CE_NOTE, "retire notify: BLOCKED: dip = %p",
78174845Svikram 		    (void *)dip));
78184845Svikram 		*constraint = 0;
78194845Svikram 	} else if (!(DEVI(dip)->devi_flags & DEVI_R_CONSTRAINT)) {
78204845Svikram 		RIO_DEBUG((CE_NOTE, "retire notify: NO CONSTRAINT: "
78214845Svikram 		    "dip = %p", (void *)dip));
78224845Svikram 		*constraint = 0;
78234845Svikram 	} else {
78244845Svikram 		RIO_DEBUG((CE_NOTE, "retire notify: CONSTRAINT set: "
78254845Svikram 		    "dip = %p", (void *)dip));
78264845Svikram 	}
78274845Svikram 	mutex_exit(&DEVI(dip)->devi_lock);
78284845Svikram 
78294845Svikram 	if (MDI_PHCI(dip))
78304845Svikram 		mdi_phci_retire_notify(dip, constraint);
78314845Svikram 
78324845Svikram 	return (DDI_WALK_CONTINUE);
78334845Svikram }
78344845Svikram 
78354845Svikram int
78364845Svikram e_ddi_retire_finalize(dev_info_t *dip, void *arg)
78374845Svikram {
78384845Svikram 	int constraint = *(int *)arg;
78394845Svikram 	int finalize;
78404845Svikram 	int phci_only;
78414845Svikram 
78424845Svikram 	ASSERT(DEVI_BUSY_OWNED(ddi_get_parent(dip)));
78434845Svikram 
78444845Svikram 	mutex_enter(&DEVI(dip)->devi_lock);
78454845Svikram 	if (!(DEVI(dip)->devi_flags & DEVI_RETIRING)) {
78464845Svikram 		RIO_DEBUG((CE_WARN,
78474845Svikram 		    "retire: unmarked dip(%p) in retire subtree",
78484845Svikram 		    (void *)dip));
78494845Svikram 		ASSERT(!(DEVI(dip)->devi_flags & DEVI_RETIRED));
78504845Svikram 		ASSERT(!(DEVI(dip)->devi_flags & DEVI_R_CONSTRAINT));
78514845Svikram 		ASSERT(!(DEVI(dip)->devi_flags & DEVI_R_BLOCKED));
78524845Svikram 		mutex_exit(&DEVI(dip)->devi_lock);
78534845Svikram 		return (DDI_WALK_CONTINUE);
78544845Svikram 	}
78554845Svikram 
78564845Svikram 	/*
78574845Svikram 	 * retire the device if constraints have been applied
78584845Svikram 	 * or if the device is not in use
78594845Svikram 	 */
78604845Svikram 	finalize = 0;
78614845Svikram 	if (constraint) {
78624845Svikram 		ASSERT(DEVI(dip)->devi_flags & DEVI_R_CONSTRAINT);
78634845Svikram 		ASSERT(!(DEVI(dip)->devi_flags & DEVI_R_BLOCKED));
78644845Svikram 		DEVI(dip)->devi_flags &= ~DEVI_R_CONSTRAINT;
78654845Svikram 		DEVI(dip)->devi_flags &= ~DEVI_RETIRING;
78664845Svikram 		DEVI(dip)->devi_flags |= DEVI_RETIRED;
78674845Svikram 		mutex_exit(&DEVI(dip)->devi_lock);
78684845Svikram 		(void) spec_fence_snode(dip, NULL);
78694845Svikram 		RIO_DEBUG((CE_NOTE, "Fenced off: dip = %p", (void *)dip));
78704845Svikram 		e_ddi_offline_finalize(dip, DDI_SUCCESS);
78714845Svikram 	} else {
78724845Svikram 		if (DEVI(dip)->devi_flags & DEVI_R_BLOCKED) {
78734845Svikram 			ASSERT(!(DEVI(dip)->devi_flags & DEVI_R_CONSTRAINT));
78744845Svikram 			DEVI(dip)->devi_flags &= ~DEVI_R_BLOCKED;
78754845Svikram 			DEVI(dip)->devi_flags &= ~DEVI_RETIRING;
78764845Svikram 			/* we have already finalized during notify */
78774845Svikram 		} else if (DEVI(dip)->devi_flags & DEVI_R_CONSTRAINT) {
78784845Svikram 			DEVI(dip)->devi_flags &= ~DEVI_R_CONSTRAINT;
78794845Svikram 			DEVI(dip)->devi_flags &= ~DEVI_RETIRING;
78804845Svikram 			finalize = 1;
78814845Svikram 		} else {
78824845Svikram 			DEVI(dip)->devi_flags &= ~DEVI_RETIRING;
78834845Svikram 			/*
78844845Svikram 			 * even if no contracts, need to call finalize
78854845Svikram 			 * to clear the contract barrier on the dip
78864845Svikram 			 */
78874845Svikram 			finalize = 1;
78884845Svikram 		}
78894845Svikram 		mutex_exit(&DEVI(dip)->devi_lock);
78904845Svikram 		RIO_DEBUG((CE_NOTE, "finalize: NOT retired: dip = %p",
78914845Svikram 		    (void *)dip));
78924845Svikram 		if (finalize)
78934845Svikram 			e_ddi_offline_finalize(dip, DDI_FAILURE);
78944845Svikram 	}
78954845Svikram 
78964845Svikram 	/*
78974845Svikram 	 * phci_only variable indicates no client checking, just
78984845Svikram 	 * offline the PHCI. We set that to 0 to enable client
78994845Svikram 	 * checking
79004845Svikram 	 */
79014845Svikram 	phci_only = 0;
79024845Svikram 	if (MDI_PHCI(dip))
79034845Svikram 		mdi_phci_retire_finalize(dip, phci_only);
79044845Svikram 
79054845Svikram 	return (DDI_WALK_CONTINUE);
79064845Svikram }
79074845Svikram 
79084845Svikram /*
79094845Svikram  * Returns
79104845Svikram  * 	DDI_SUCCESS if constraints allow retire
79114845Svikram  *	DDI_FAILURE if constraints don't allow retire.
79124845Svikram  * cons_array is a NULL terminated array of node paths for
79134845Svikram  * which constraints have already been applied.
79144845Svikram  */
79154845Svikram int
79164845Svikram e_ddi_retire_device(char *path, char **cons_array)
79174845Svikram {
79184845Svikram 	dev_info_t	*dip;
79194845Svikram 	dev_info_t	*pdip;
79204845Svikram 	int		circ;
79214845Svikram 	int		circ2;
79224845Svikram 	int		constraint;
79234845Svikram 	char		*devnm;
79244845Svikram 
79254845Svikram 	/*
79264845Svikram 	 * First, lookup the device
79274845Svikram 	 */
79284845Svikram 	dip = e_ddi_hold_devi_by_path(path, 0);
79294845Svikram 	if (dip == NULL) {
79304845Svikram 		/*
79314845Svikram 		 * device does not exist. This device cannot be
79324845Svikram 		 * a critical device since it is not in use. Thus
79334845Svikram 		 * this device is always retireable. Return DDI_SUCCESS
79344845Svikram 		 * to indicate this. If this device is ever
79354845Svikram 		 * instantiated, I/O framework will consult the
79364845Svikram 		 * the persistent retire store, mark it as
79374845Svikram 		 * retired and fence it off.
79384845Svikram 		 */
79394845Svikram 		RIO_DEBUG((CE_NOTE, "Retire device: device doesn't exist."
79404845Svikram 		    " NOP. Just returning SUCCESS. path=%s", path));
79414845Svikram 		free_array(cons_array);
79424845Svikram 		return (DDI_SUCCESS);
79434845Svikram 	}
79444845Svikram 
79454845Svikram 	RIO_DEBUG((CE_NOTE, "Retire device: found dip = %p.", (void *)dip));
79464845Svikram 
79474845Svikram 	pdip = ddi_get_parent(dip);
79484845Svikram 	ndi_hold_devi(pdip);
79494845Svikram 
79504845Svikram 	/*
79514845Svikram 	 * Run devfs_clean() in case dip has no constraints and is
79524845Svikram 	 * not in use, so is retireable but there are dv_nodes holding
79534845Svikram 	 * ref-count on the dip. Note that devfs_clean() always returns
79544845Svikram 	 * success.
79554845Svikram 	 */
79564845Svikram 	devnm = kmem_alloc(MAXNAMELEN + 1, KM_SLEEP);
79574845Svikram 	(void) ddi_deviname(dip, devnm);
79584845Svikram 	(void) devfs_clean(pdip, devnm + 1, DV_CLEAN_FORCE);
79594845Svikram 	kmem_free(devnm, MAXNAMELEN + 1);
79604845Svikram 
79614845Svikram 	ndi_devi_enter(pdip, &circ);
79624845Svikram 
79634845Svikram 	/* release hold from e_ddi_hold_devi_by_path */
79644845Svikram 	ndi_rele_devi(dip);
79654845Svikram 
79664845Svikram 	/*
79674845Svikram 	 * If it cannot make a determination, is_leaf_node() assumes
79684845Svikram 	 * dip is a nexus.
79694845Svikram 	 */
79704845Svikram 	(void) e_ddi_mark_retiring(dip, cons_array);
79714845Svikram 	if (!is_leaf_node(dip)) {
79724845Svikram 		ndi_devi_enter(dip, &circ2);
79734845Svikram 		ddi_walk_devs(ddi_get_child(dip), e_ddi_mark_retiring,
79744845Svikram 		    cons_array);
79754845Svikram 		ndi_devi_exit(dip, circ2);
79764845Svikram 	}
79774845Svikram 	free_array(cons_array);
79784845Svikram 
79794845Svikram 	/*
79804845Svikram 	 * apply constraints
79814845Svikram 	 */
79824845Svikram 	RIO_DEBUG((CE_NOTE, "retire: subtree retire notify: path = %s", path));
79834845Svikram 
79844845Svikram 	constraint = 1;	/* assume constraints allow retire */
79854845Svikram 	(void) e_ddi_retire_notify(dip, &constraint);
79864845Svikram 	if (!is_leaf_node(dip)) {
79874845Svikram 		ndi_devi_enter(dip, &circ2);
79884845Svikram 		ddi_walk_devs(ddi_get_child(dip), e_ddi_retire_notify,
79894845Svikram 		    &constraint);
79904845Svikram 		ndi_devi_exit(dip, circ2);
79914845Svikram 	}
79924845Svikram 
79934845Svikram 	/*
79944845Svikram 	 * Now finalize the retire
79954845Svikram 	 */
79964845Svikram 	(void) e_ddi_retire_finalize(dip, &constraint);
79974845Svikram 	if (!is_leaf_node(dip)) {
79984845Svikram 		ndi_devi_enter(dip, &circ2);
79994845Svikram 		ddi_walk_devs(ddi_get_child(dip), e_ddi_retire_finalize,
80004845Svikram 		    &constraint);
80014845Svikram 		ndi_devi_exit(dip, circ2);
80024845Svikram 	}
80034845Svikram 
80044845Svikram 	if (!constraint) {
80054845Svikram 		RIO_DEBUG((CE_WARN, "retire failed: path = %s", path));
80064845Svikram 	} else {
80074845Svikram 		RIO_DEBUG((CE_NOTE, "retire succeeded: path = %s", path));
80084845Svikram 	}
80094845Svikram 
80104845Svikram 	ndi_devi_exit(pdip, circ);
80114845Svikram 	ndi_rele_devi(pdip);
80124845Svikram 	return (constraint ? DDI_SUCCESS : DDI_FAILURE);
80134845Svikram }
80144845Svikram 
80154845Svikram static int
80164845Svikram unmark_and_unfence(dev_info_t *dip, void *arg)
80174845Svikram {
80184845Svikram 	char	*path = (char *)arg;
80194845Svikram 
80204845Svikram 	ASSERT(path);
80214845Svikram 
80224845Svikram 	(void) ddi_pathname(dip, path);
80234845Svikram 
80244845Svikram 	mutex_enter(&DEVI(dip)->devi_lock);
80254845Svikram 	DEVI(dip)->devi_flags &= ~DEVI_RETIRED;
80264845Svikram 	DEVI_SET_DEVICE_ONLINE(dip);
80274845Svikram 	mutex_exit(&DEVI(dip)->devi_lock);
80284845Svikram 
80294845Svikram 	RIO_VERBOSE((CE_NOTE, "Cleared RETIRED flag: dip=%p, path=%s",
80304845Svikram 	    (void *)dip, path));
80314845Svikram 
80324845Svikram 	(void) spec_unfence_snode(dip);
80334845Svikram 	RIO_DEBUG((CE_NOTE, "Unfenced device: %s", path));
80344845Svikram 
80354845Svikram 	if (MDI_PHCI(dip))
80364845Svikram 		mdi_phci_unretire(dip);
80374845Svikram 
80384845Svikram 	return (DDI_WALK_CONTINUE);
80394845Svikram }
80404845Svikram 
80414845Svikram struct find_dip {
80424845Svikram 	char	*fd_buf;
80434845Svikram 	char	*fd_path;
80444845Svikram 	dev_info_t *fd_dip;
80454845Svikram };
80464845Svikram 
80474845Svikram static int
80484845Svikram find_dip_fcn(dev_info_t *dip, void *arg)
80494845Svikram {
80504845Svikram 	struct find_dip *findp = (struct find_dip *)arg;
80514845Svikram 
80524845Svikram 	(void) ddi_pathname(dip, findp->fd_buf);
80534845Svikram 
80544845Svikram 	if (strcmp(findp->fd_path, findp->fd_buf) != 0)
80554845Svikram 		return (DDI_WALK_CONTINUE);
80564845Svikram 
80574845Svikram 	ndi_hold_devi(dip);
80584845Svikram 	findp->fd_dip = dip;
80594845Svikram 
80604845Svikram 	return (DDI_WALK_TERMINATE);
80614845Svikram }
80624845Svikram 
80634845Svikram int
80644845Svikram e_ddi_unretire_device(char *path)
80654845Svikram {
80664845Svikram 	int		circ;
80677235Svikram 	int		circ2;
80684845Svikram 	char		*path2;
80694845Svikram 	dev_info_t	*pdip;
80704845Svikram 	dev_info_t	*dip;
80714845Svikram 	struct find_dip	 find_dip;
80724845Svikram 
80734845Svikram 	ASSERT(path);
80744845Svikram 	ASSERT(*path == '/');
80754845Svikram 
80764845Svikram 	if (strcmp(path, "/") == 0) {
80774845Svikram 		cmn_err(CE_WARN, "Root node cannot be retired. Skipping "
80784845Svikram 		    "device unretire: %s", path);
80794845Svikram 		return (0);
80804845Svikram 	}
80814845Svikram 
80824845Svikram 	/*
80834845Svikram 	 * We can't lookup the dip (corresponding to path) via
80844845Svikram 	 * e_ddi_hold_devi_by_path() because the dip may be offline
80854845Svikram 	 * and may not attach. Use ddi_walk_devs() instead;
80864845Svikram 	 */
80874845Svikram 	find_dip.fd_buf = kmem_alloc(MAXPATHLEN, KM_SLEEP);
80884845Svikram 	find_dip.fd_path = path;
80894845Svikram 	find_dip.fd_dip = NULL;
80904845Svikram 
80914845Svikram 	pdip = ddi_root_node();
80924845Svikram 
80934845Svikram 	ndi_devi_enter(pdip, &circ);
80944845Svikram 	ddi_walk_devs(ddi_get_child(pdip), find_dip_fcn, &find_dip);
80954845Svikram 	ndi_devi_exit(pdip, circ);
80964845Svikram 
80974845Svikram 	kmem_free(find_dip.fd_buf, MAXPATHLEN);
80984845Svikram 
80994845Svikram 	if (find_dip.fd_dip == NULL) {
81004845Svikram 		cmn_err(CE_WARN, "Device not found in device tree. Skipping "
81014845Svikram 		    "device unretire: %s", path);
81024845Svikram 		return (0);
81034845Svikram 	}
81044845Svikram 
81054845Svikram 	dip = find_dip.fd_dip;
81064845Svikram 
81074845Svikram 	pdip = ddi_get_parent(dip);
81084845Svikram 
81094845Svikram 	ndi_hold_devi(pdip);
81104845Svikram 
81114845Svikram 	ndi_devi_enter(pdip, &circ);
81124845Svikram 
81134845Svikram 	path2 = kmem_alloc(MAXPATHLEN, KM_SLEEP);
81144845Svikram 
81154845Svikram 	(void) unmark_and_unfence(dip, path2);
81164845Svikram 	if (!is_leaf_node(dip)) {
81177235Svikram 		ndi_devi_enter(dip, &circ2);
81184845Svikram 		ddi_walk_devs(ddi_get_child(dip), unmark_and_unfence, path2);
81197235Svikram 		ndi_devi_exit(dip, circ2);
81204845Svikram 	}
81214845Svikram 
81224845Svikram 	kmem_free(path2, MAXPATHLEN);
81234845Svikram 
81244845Svikram 	/* release hold from find_dip_fcn() */
81254845Svikram 	ndi_rele_devi(dip);
81264845Svikram 
81274845Svikram 	ndi_devi_exit(pdip, circ);
81284845Svikram 
81294845Svikram 	ndi_rele_devi(pdip);
81304845Svikram 
81314845Svikram 	return (0);
81324845Svikram }
81334845Svikram 
81344845Svikram /*
81354845Svikram  * Called before attach on a dip that has been retired.
81364845Svikram  */
81374845Svikram static int
81384845Svikram mark_and_fence(dev_info_t *dip, void *arg)
81394845Svikram {
81404845Svikram 	char    *fencepath = (char *)arg;
81414845Svikram 
81424845Svikram 	/*
81434845Svikram 	 * We have already decided to retire this device. The various
81444845Svikram 	 * constraint checking should not be set.
81454845Svikram 	 * NOTE that the retire flag may already be set due to
81464845Svikram 	 * fenced -> detach -> fenced transitions.
81474845Svikram 	 */
81484845Svikram 	mutex_enter(&DEVI(dip)->devi_lock);
81494845Svikram 	ASSERT(!(DEVI(dip)->devi_flags & DEVI_R_CONSTRAINT));
81504845Svikram 	ASSERT(!(DEVI(dip)->devi_flags & DEVI_R_BLOCKED));
81514845Svikram 	ASSERT(!(DEVI(dip)->devi_flags & DEVI_RETIRING));
81524845Svikram 	DEVI(dip)->devi_flags |= DEVI_RETIRED;
81534845Svikram 	mutex_exit(&DEVI(dip)->devi_lock);
81544845Svikram 	RIO_VERBOSE((CE_NOTE, "marked as RETIRED dip=%p", (void *)dip));
81554845Svikram 
81564845Svikram 	if (fencepath) {
81574845Svikram 		(void) spec_fence_snode(dip, NULL);
81584845Svikram 		RIO_DEBUG((CE_NOTE, "Fenced: %s",
81594845Svikram 		    ddi_pathname(dip, fencepath)));
81604845Svikram 	}
81614845Svikram 
81624845Svikram 	return (DDI_WALK_CONTINUE);
81634845Svikram }
81644845Svikram 
81654845Svikram /*
81664845Svikram  * Checks the retire database and:
81674845Svikram  *
81684845Svikram  * - if device is present in the retire database, marks the device retired
81694845Svikram  *   and fences it off.
81704845Svikram  * - if device is not in retire database, allows the device to attach normally
81714845Svikram  *
81724845Svikram  * To be called only by framework attach code on first attach attempt.
81734845Svikram  *
81744845Svikram  */
81754845Svikram static void
81764845Svikram i_ddi_check_retire(dev_info_t *dip)
81774845Svikram {
81784845Svikram 	char		*path;
81794845Svikram 	dev_info_t	*pdip;
81804845Svikram 	int		circ;
81814845Svikram 	int		phci_only;
81824845Svikram 
81834845Svikram 	pdip = ddi_get_parent(dip);
81844845Svikram 
81854845Svikram 	/*
81864845Svikram 	 * Root dip is treated special and doesn't take this code path.
81874845Svikram 	 * Also root can never be retired.
81884845Svikram 	 */
81894845Svikram 	ASSERT(pdip);
81904845Svikram 	ASSERT(DEVI_BUSY_OWNED(pdip));
81914845Svikram 	ASSERT(i_ddi_node_state(dip) < DS_ATTACHED);
81924845Svikram 
81934845Svikram 	path = kmem_alloc(MAXPATHLEN, KM_SLEEP);
81944845Svikram 
81954845Svikram 	(void) ddi_pathname(dip, path);
81964845Svikram 
81974845Svikram 	RIO_VERBOSE((CE_NOTE, "Checking if dip should attach: dip=%p, path=%s",
81984845Svikram 	    (void *)dip, path));
81994845Svikram 
82004845Svikram 	/*
82014845Svikram 	 * Check if this device is in the "retired" store i.e.  should
82024845Svikram 	 * be retired. If not, we have nothing to do.
82034845Svikram 	 */
82044845Svikram 	if (e_ddi_device_retired(path) == 0) {
82054845Svikram 		RIO_VERBOSE((CE_NOTE, "device is NOT retired: path=%s", path));
82064845Svikram 		kmem_free(path, MAXPATHLEN);
82074845Svikram 		return;
82084845Svikram 	}
82094845Svikram 
82104845Svikram 	RIO_DEBUG((CE_NOTE, "attach: device is retired: path=%s", path));
82114845Svikram 
82124845Svikram 	/*
82134845Svikram 	 * Mark dips and fence off snodes (if any)
82144845Svikram 	 */
82154845Svikram 	RIO_DEBUG((CE_NOTE, "attach: Mark and fence subtree: path=%s", path));
82164845Svikram 	(void) mark_and_fence(dip, path);
82174845Svikram 	if (!is_leaf_node(dip)) {
82184845Svikram 		ndi_devi_enter(dip, &circ);
82194845Svikram 		ddi_walk_devs(ddi_get_child(dip), mark_and_fence, path);
82204845Svikram 		ndi_devi_exit(dip, circ);
82214845Svikram 	}
82224845Svikram 
82234845Svikram 	kmem_free(path, MAXPATHLEN);
82244845Svikram 
82254845Svikram 	/*
82264845Svikram 	 * We don't want to check the client. We just want to
82274845Svikram 	 * offline the PHCI
82284845Svikram 	 */
82294845Svikram 	phci_only = 1;
82304845Svikram 	if (MDI_PHCI(dip))
82314845Svikram 		mdi_phci_retire_finalize(dip, phci_only);
82324845Svikram }
8233