topo_node.c revision c40d7343efa60b18ad1ceb316eb337caeea79046
17aec1d6cindi/*
27aec1d6cindi * CDDL HEADER START
37aec1d6cindi *
47aec1d6cindi * The contents of this file are subject to the terms of the
50eb822acindi * Common Development and Distribution License (the "License").
60eb822acindi * You may not use this file except in compliance with the License.
77aec1d6cindi *
87aec1d6cindi * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
97aec1d6cindi * or http://www.opensolaris.org/os/licensing.
107aec1d6cindi * See the License for the specific language governing permissions
117aec1d6cindi * and limitations under the License.
127aec1d6cindi *
137aec1d6cindi * When distributing Covered Code, include this CDDL HEADER in each
147aec1d6cindi * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
157aec1d6cindi * If applicable, add the following below this CDDL HEADER, with the
167aec1d6cindi * fields enclosed by brackets "[]" replaced with your own identifying
177aec1d6cindi * information: Portions Copyright [yyyy] [name of copyright owner]
187aec1d6cindi *
197aec1d6cindi * CDDL HEADER END
207aec1d6cindi */
217aec1d6cindi/*
22c40d734cindi * Copyright 2007 Sun Microsystems, Inc.  All rights reserved.
237aec1d6cindi * Use is subject to license terms.
247aec1d6cindi */
257aec1d6cindi
267aec1d6cindi#pragma ident	"%Z%%M%	%I%	%E% SMI"
277aec1d6cindi
287aec1d6cindi/*
297aec1d6cindi * Topology Nodes
307aec1d6cindi *
317aec1d6cindi * Topology nodes, tnode_t, are data structures containing per-FMRI
327aec1d6cindi * information and are linked together to form the topology tree.
337aec1d6cindi * Nodes are created during the enumeration process of topo_snap_hold()
347aec1d6cindi * and destroyed during topo_snap_rele().  For the most part, tnode_t data
357aec1d6cindi * is read-only and no lock protection is required.  Nodes are
367aec1d6cindi * held in place during tree walk functions.  Tree walk functions
377aec1d6cindi * may access node data safely without locks.  The exception to this rule
387aec1d6cindi * is data associated with node properties (topo_prop.c).  Properties
39