modules/genunix/group.c

fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe/*
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe * CDDL HEADER START
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe *
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe * The contents of this file are subject to the terms of the
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe * Common Development and Distribution License (the "License").
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe * You may not use this file except in compliance with the License.
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe *
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe * or http://www.opensolaris.org/os/licensing.
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe * See the License for the specific language governing permissions
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe * and limitations under the License.
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe *
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe * When distributing Covered Code, include this CDDL HEADER in each
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe * If applicable, add the following below this CDDL HEADER, with the
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe * fields enclosed by brackets "[]" replaced with your own identifying
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe * information: Portions Copyright [yyyy] [name of copyright owner]
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe *
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe * CDDL HEADER END
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe */
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe/*
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe * Copyright 2007 Sun Microsystems, Inc.  All rights reserved.
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe * Use is subject to license terms.
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe */
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe#pragma ident   "%Z%%M% %I% %E% SMI"
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe/*
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe * Display group information and walk all elements of a group
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe */
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe#include "group.h"
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe#include <mdb/mdb_modapi.h>
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe#include <sys/group.h>
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe/*
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe * Display group information
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe */
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe/* ARGSUSED */
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxeint
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxegroup(uintptr_t addr, uint_t flags, int argc, const mdb_arg_t *argv)
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe{
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe    group_t group;
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe    int opt_q = 0; /* display only address. */
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe    /* Should provide an address */
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe    if (!(flags & DCMD_ADDRSPEC))
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe        return (DCMD_USAGE);
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe    if (mdb_getopts(argc, argv,
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe        'q', MDB_OPT_SETBITS, TRUE, &opt_q,
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe        NULL) != argc)
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe        return (DCMD_USAGE);
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe    if (flags & DCMD_PIPE_OUT)
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe        opt_q = B_TRUE;
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe    if (DCMD_HDRSPEC(flags) && !opt_q) {
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe        mdb_printf("%?s %6s %9s %?s\n",
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe            "ADDR",
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe            "SIZE",
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe            "CAPACITY",
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe            "SET");
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe    }
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe    if (mdb_vread(&group, sizeof (struct group), addr) == -1) {
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe        mdb_warn("unable to read 'group' at %p", addr);
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe        return (DCMD_ERR);
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe    }
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe    if (opt_q) {
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe        mdb_printf("%0?p\n", addr);
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe        return (DCMD_OK);
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe    }
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe    mdb_printf("%?p %6d %9d %?p\n",
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe        addr, group.grp_size, group.grp_capacity, group.grp_set);
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe    return (DCMD_OK);
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe}
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe/*
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe * Walk all elements in the group set.
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe */
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxetypedef struct group_walk {
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe    uintptr_t *gw_set;
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe    int gw_size;
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe    int gw_pos;
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe    int gw_initialized;
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe} group_walk_t;
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe/*
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe * Initialize the walk structure with the copy of a group set, its size and the
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe * initial pointer position.
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe */
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxeint
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxegroup_walk_init(mdb_walk_state_t *wsp)
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe{
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe    group_walk_t    *gw;
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe    group_t     group;
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe    gw = mdb_alloc(sizeof (group_walk_t), UM_SLEEP | UM_GC);
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe    if (mdb_vread(&group, sizeof (struct group), wsp->walk_addr) == -1) {
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe        mdb_warn("couldn't read 'group' at %p", wsp->walk_addr);
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe        return (WALK_ERR);
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe    }
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe    gw->gw_size = group.grp_size;
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe    gw->gw_initialized = 0;
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe    gw->gw_pos = 0;
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe    if (gw->gw_size < 0) {
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe        mdb_warn("invalid group at %p", wsp->walk_addr);
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe        return (WALK_ERR);
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe    }
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe    if (gw->gw_size == 0)
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe        return (WALK_DONE);
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe    /*
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe     * Allocate space for the set and copy all set entries.
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe     */
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe    gw->gw_set = mdb_alloc(group.grp_size * sizeof (uintptr_t),
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe        UM_SLEEP | UM_GC);
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe    if (mdb_vread(gw->gw_set, group.grp_size * sizeof (uintptr_t),
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe        (uintptr_t)group.grp_set) == -1) {
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe        mdb_warn("couldn't read 'group set' at %p", group.grp_set);
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe        return (WALK_ERR);
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe    }
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe    wsp->walk_data = gw;
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe    wsp->walk_addr = gw->gw_set[0];
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe    gw->gw_pos = 0;
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe    return (WALK_NEXT);
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe}
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe/*
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe * Print element of the set and advance the pointer.
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe */
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxeint
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxegroup_walk_step(mdb_walk_state_t *wsp)
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe{
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe    group_walk_t *gw = (group_walk_t *)wsp->walk_data;
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe    int status;
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe    /*
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe     * Already visited all valid elements, nothing else to do.
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe     */
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe    if (gw->gw_size < 0)
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe        return (WALK_DONE);
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe    /*
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe     * Print non-NULL elements
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe     */
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe    status = wsp->walk_addr == NULL ?
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe        WALK_NEXT :
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe        wsp->walk_callback(wsp->walk_addr, wsp->walk_data,
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe        wsp->walk_cbdata);
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe    /*
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe     * Adjust walk_addr to point to the next element
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe     */
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe    gw->gw_size--;
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe    if (gw->gw_size > 0)
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe        wsp->walk_addr = gw->gw_set[++gw->gw_pos];
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe    else
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe        status = WALK_DONE;
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe    return (status);
fb2f18f820d90b001aea4fb27dd654bc1263c440esaxe}