4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh * CDDL HEADER START
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh * The contents of this file are subject to the terms of the
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh * Common Development and Distribution License (the "License").
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh * You may not use this file except in compliance with the License.
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh * See the License for the specific language governing permissions
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh * and limitations under the License.
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh * When distributing Covered Code, include this CDDL HEADER in each
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh * If applicable, add the following below this CDDL HEADER, with the
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh * fields enclosed by brackets "[]" replaced with your own identifying
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh * information: Portions Copyright [yyyy] [name of copyright owner]
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh * CDDL HEADER END
5d562cec9a5c49bc665980c775f32f708cb2f3e9Milos Muzik * Copyright (c) 2009, 2010, Oracle and/or its affiliates. All rights reserved.
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh mdb_printf("EXAMPLE: SCSI: To display the SCSI tgtmap damaps ");
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh mdb_printf("associated with a scsi HBA driver iport dip:\n");
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh mdb_printf("<iport-dip>::print struct dev_info devi_driver_data|");
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dhstatic char *
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dhstatic void
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dhstatic void
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh bs->bs_set = mdb_alloc(bs->bs_words * sizeof (ulong_t), UM_SLEEP);
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh return (bs);
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dhstatic void
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh /* free in dam_da_t softstate */
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh /* free dam_active/stable/report_set embedded in dam */
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh /* free dam_name */
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh /* free dam */
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh * The dam implementation uses a number of different abstractions. Given a
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh * pointer to a damap_t, this function make an mdb instantiation of the dam -
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh * many, but not all, of the different abstractions used in the dam
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh * implementation are also instantiated in mdb. This means that callers of
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh * damap_get can perform some (but not all) types of structure pointer
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh * traversals.
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dhdamap_get(uintptr_t damaddr, void ***pkdamda, int *pkdamda_n)
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh /* variables that hold instantiation read from kernel */
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh /* variables that hold mdb instantiation */
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh /* read kernel: dam */
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh /* read kernel: dam->dam_name */
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh mdb_readstr(kstring, sizeof (kstring), (uintptr_t)kdam.dam_name);
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh /* read kernel: dam->dam_da (softstate) */
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh if (mdb_vread(&kss, sizeof (kss), (uintptr_t)kdam.dam_da) == -1) {
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh /* read kernel ((struct i_ddi_soft_state *)dam->dam_da)->array */
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh if (mdb_vread(kssarray, array_sz, (uintptr_t)kss.array) == -1) {
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh * Produce mdb instantiation of kernel data structures.
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh * Structure copy kdam to dam, then clear out pointers in dam (some
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh * will be filled in by mdb instantiation code below).
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh /* dam_addr_hash, dam_taskqp, dam_kstatp left as kernel addresses */
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh /* fill in dam_name */
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh /* fill in dam_active/stable/report_set embedded in the dam */
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh bs = bitset_get(damaddr + (offsetof(struct dam, dam_active_set)));
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh bs = bitset_get(damaddr + (offsetof(struct dam, dam_stable_set)));
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh bs = bitset_get(damaddr + (offsetof(struct dam, dam_report_set)));
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh /* fill in dam_da_t softstate */
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh ss = mdb_zalloc(sizeof (struct i_ddi_soft_state), UM_SLEEP);
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh if (mdb_vread(da, sizeof (*da), (uintptr_t)kssarray[i]) == -1) {
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh /* da_nvl, da_ppriv_rpt, da_nvl_rpt left as kernel addresses */
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh /* read kernel: da->da_addr */
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh mdb_readstr(kstring, sizeof (kstring), (uintptr_t)da->da_addr);
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh /* return array of kernel dam_da_t pointers associated with each id */
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh /* return pointer to mdb instantiation of the dam */
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dherr: damap_free(dam, kssarray, array_sz / sizeof (void *));
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh/*ARGSUSED*/
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dhstatic void
5d562cec9a5c49bc665980c775f32f708cb2f3e9Milos Muzik mdb_printf(" #: %-20s [ASR] ref config-private provider-private\n",
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh /* Print index and address. */
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh /* Print shorthand of Active/Stable/Report set membership */
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh /* Print the reference count and priv */
5d562cec9a5c49bc665980c775f32f708cb2f3e9Milos Muzik mdb_printf(" %p::print -ta dam_da_t\n", kdamda[i]);
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh/*ARGSUSED*/