root/usr/src/cmd/mdb/common/modules/ptm/ptm.c
/*
 * CDDL HEADER START
 *
 * The contents of this file are subject to the terms of the
 * Common Development and Distribution License, Version 1.0 only
 * (the "License").  You may not use this file except in compliance
 * with the License.
 *
 * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
 * or http://www.opensolaris.org/os/licensing.
 * See the License for the specific language governing permissions
 * and limitations under the License.
 *
 * When distributing Covered Code, include this CDDL HEADER in each
 * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
 * If applicable, add the following below this CDDL HEADER, with the
 * fields enclosed by brackets "[]" replaced with your own identifying
 * information: Portions Copyright [yyyy] [name of copyright owner]
 *
 * CDDL HEADER END
 */
/*
 * Copyright 2003 Sun Microsystems, Inc.  All rights reserved.
 * Use is subject to license terms.
 * Copyright 2017 Joyent, Inc.
 */

#include <mdb/mdb_modapi.h>
#include <mdb/mdb_ks.h>

#include <sys/types.h>
#include <sys/strsubr.h>
#include <sys/ptms.h>

typedef struct pt_flags {
        const char *pt_name;
        const char *pt_descr;
} ptflags_t;

static const struct pt_flags pf[] = {
        { "PTLOCK",             "Master/slave pair is locked" },
        { "PTMOPEN",            "Master side is open" },
        { "PTSOPEN",            "Slave side is open" },
        { "PTSTTY",             "Slave side is tty" },
        { NULL },
};

static int
pt_parse_flag(const ptflags_t ftable[],  const char *arg, uint32_t *flag)
{
        int i;

        for (i = 0; ftable[i].pt_name != NULL; i++) {
                if (strcasecmp(arg, ftable[i].pt_name) == 0) {
                        *flag |= (1 << i);
                        return (0);
                }
        }

        return (-1);
}

static void
pt_flag_usage(const ptflags_t ftable[])
{
        int i;

        for (i = 0; ftable[i].pt_name != NULL; i++)
                mdb_printf("%12s %s\n",
                    ftable[i].pt_name, ftable[i].pt_descr);
}



static void
ptms_pr_qinfo(char *buf, size_t nbytes, struct pt_ttys *pt, char *peername,
    queue_t *peerq, char *procname)
{
        (void) mdb_snprintf(buf, nbytes,
            "pts/%d:%s: %p\nprocess:    %d(%s)",
            pt->pt_minor, peername, peerq, pt->pt_pid, procname);
}

static int
ptms(uintptr_t addr, uint_t flags, int argc, const mdb_arg_t *argv)
{
        const int PT_FLGDELT = (int)(sizeof (uintptr_t) * 2 + 5);

        struct pt_ttys pt;
        char c[MAXCOMLEN + 1];
        const char *flag = NULL, *not_flag = NULL;
        proc_t p;
        uint_t verbose = FALSE;
        uint32_t mask = 0, not_mask = 0;

        if (!(flags & DCMD_ADDRSPEC))
                return (mdb_walk_dcmd("ptms", "ptms", argc, argv));

        if (mdb_getopts(argc, argv,
            'v', MDB_OPT_SETBITS, TRUE, &verbose,
            'f', MDB_OPT_STR, &flag,
            'F', MDB_OPT_STR, &not_flag, NULL) != argc)
                return (DCMD_USAGE);

        if (DCMD_HDRSPEC(flags) && flag == NULL && not_flag == NULL) {
                (void) mdb_printf("%?-s %s %s %?-s %?-s %3s %-6s %s\n",
                    "ADDR", "PTY", "FL", "MASTERQ", "SLAVEQ",
                    "ZID", "PID", "PROC");
        }

        if (flag != NULL && pt_parse_flag(pf, flag, &mask) == -1) {
                mdb_warn("unrecognized pty flag '%s'\n", flag);
                pt_flag_usage(pf);
                return (DCMD_USAGE);
        }

        if (not_flag != NULL && pt_parse_flag(pf, not_flag, &not_mask) == -1) {
                mdb_warn("unrecognized queue flag '%s'\n", flag);
                pt_flag_usage(pf);
                return (DCMD_USAGE);
        }

        if (mdb_vread(&pt, sizeof (pt), addr) == -1) {
                mdb_warn("failed to read pty structure");
                return (DCMD_ERR);
        }

        if (mask != 0 && !(pt.pt_state & mask))
                return (DCMD_OK);

        if (not_mask != 0 && (pt.pt_state & not_mask))
                return (DCMD_OK);

        /*
         * Options are specified for filtering, so If any option is specified on
         * the command line, just print address and exit.
         */
        if (flag != NULL || not_flag != NULL) {
                mdb_printf("%0?p\n", addr);
                return (DCMD_OK);
        }

        if (pt.pt_pid != 0) {
                if (mdb_pid2proc(pt.pt_pid, &p) == 0)
                        (void) strcpy(c, "<defunct>");
                else
                        (void) strcpy(c, p.p_user.u_comm);
        } else
                (void) strcpy(c, "<unknown>");

        (void) mdb_printf("%0?p %3d %2x %0?p %0?p %3d %6d %s\n",
            addr, pt.pt_minor, pt.pt_state, pt.ptm_rdq, pt.pts_rdq,
            pt.pt_zoneid, pt.pt_pid, c);

        if (verbose) {
                int i, arm = 0;

                for (i = 0; pf[i].pt_name != NULL; i++) {
                        if (!(pt.pt_state & (1 << i)))
                                continue;
                        if (!arm) {
                                mdb_printf("%*s|\n%*s+-->  ",
                                    PT_FLGDELT, "", PT_FLGDELT, "");
                                arm = 1;
                        } else
                                mdb_printf("%*s      ", PT_FLGDELT, "");

                        mdb_printf("%-12s %s\n",
                            pf[i].pt_name, pf[i].pt_descr);
                }
        }

        return (DCMD_OK);
}

static void
ptms_qinfo(const queue_t *q, char *buf, size_t nbytes, int ismaster)
{
        char c[MAXCOMLEN + 1];
        struct pt_ttys pt;
        proc_t p;

        (void) mdb_vread(&pt, sizeof (pt), (uintptr_t)q->q_ptr);

        if (pt.pt_pid != 0) {
                if (mdb_pid2proc(pt.pt_pid, &p) == 0)
                        (void) strcpy(c, "<defunct>");
                else
                        (void) strcpy(c, p.p_user.u_comm);
        } else
                (void) strcpy(c, "<unknown>");

        if (ismaster)
                ptms_pr_qinfo(buf, nbytes, &pt, "slave", pt.pts_rdq, c);
        else
                ptms_pr_qinfo(buf, nbytes, &pt, "master", pt.ptm_rdq, c);
}

void
ptm_qinfo(const queue_t *q, char *buf, size_t nbytes)
{
        ptms_qinfo(q, buf, nbytes, 1);
}

void
pts_qinfo(const queue_t *q, char *buf, size_t nbytes)
{
        ptms_qinfo(q, buf, nbytes, 0);
}

static int
ptms_walk_init(mdb_walk_state_t *wsp)
{
        size_t nslots;

        if (wsp->walk_addr != 0) {
                mdb_warn("ptms supports only global walks");
                return (WALK_ERR);
        }

        if (mdb_readvar(&wsp->walk_addr, "ptms_slots") == -1) {
                mdb_warn("failed to read 'ptms_slots'");
                return (WALK_ERR);
        }

        if (mdb_readvar(&nslots, "ptms_nslots") == -1) {
                mdb_warn("failed to read 'ptms_nslots'");
                return (WALK_ERR);
        }

        /*
         * We remember the pointer value at the end of the array.  When
         * the walk gets there, we're done.
         */
        wsp->walk_arg = (((struct pt_ttys **)wsp->walk_addr) + (nslots - 1));
        wsp->walk_data = mdb_alloc(sizeof (struct pt_ttys), UM_SLEEP);

        return (WALK_NEXT);
}

static int
ptms_walk_step(mdb_walk_state_t *wsp)
{
        int status;
        uintptr_t ptr;

        if (wsp->walk_addr > (uintptr_t)wsp->walk_arg)
                return (WALK_DONE);

        if (mdb_vread(&ptr, sizeof (struct pt_ttys *), wsp->walk_addr) !=
            (sizeof (struct pt_ttys *))) {
                mdb_warn("failed to read pt_ttys* at %p", wsp->walk_addr);
                return (WALK_DONE);
        }

        if (ptr == 0) {
                wsp->walk_addr += sizeof (uintptr_t);
                return (WALK_NEXT);
        }

        if (mdb_vread(wsp->walk_data, sizeof (struct pt_ttys), ptr) !=
            sizeof (struct pt_ttys)) {
                mdb_warn("failed to read pt_ttys at %p", ptr);
                return (WALK_DONE);
        }

        status = wsp->walk_callback(ptr, wsp->walk_data, wsp->walk_cbdata);
        wsp->walk_addr += sizeof (uintptr_t);

        return (status);
}

static void
ptms_walk_fini(mdb_walk_state_t *wsp)
{
        mdb_free(wsp->walk_data, sizeof (struct pt_ttys));
}

static const mdb_dcmd_t dcmds[] = {
        { "ptms", "?[-v] [-f flag] [-F flag]",
            "print pseudo-terminal information", ptms },
        { "pty", "?[-v] [-f flag] [-F flag]",
            "print pseudo-terminal information (alias of ::ptms", ptms },
        { NULL }
};

static const mdb_walker_t walkers[] = {
        { "ptms", "walk list of pseudo-tty's",
            ptms_walk_init, ptms_walk_step, ptms_walk_fini },
        { "pty", "walk list of pseudo-tty's (alias of ::walk ptms)",
            ptms_walk_init, ptms_walk_step, ptms_walk_fini },
        { NULL }
};

static const mdb_qops_t ptm_qops = {
        .q_info = ptm_qinfo,
        .q_rnext = mdb_qrnext_default,
        .q_wnext = mdb_qwnext_default,
};

static const mdb_qops_t pts_qops = {
        .q_info = pts_qinfo,
        .q_rnext = mdb_qrnext_default,
        .q_wnext = mdb_qwnext_default,
};

static const mdb_modinfo_t modinfo = {
        MDB_API_VERSION, dcmds, walkers
};

const mdb_modinfo_t *
_mdb_init(void)
{
        GElf_Sym sym;

        if (mdb_lookup_by_obj("ptm", "ptmwint", &sym) == 0)
                mdb_qops_install(&ptm_qops, (uintptr_t)sym.st_value);
        if (mdb_lookup_by_obj("pts", "ptswint", &sym) == 0)
                mdb_qops_install(&pts_qops, (uintptr_t)sym.st_value);

        return (&modinfo);
}

void
_mdb_fini(void)
{
        GElf_Sym sym;

        if (mdb_lookup_by_obj("ptm", "ptmwint", &sym) == 0)
                mdb_qops_remove(&ptm_qops, (uintptr_t)sym.st_value);
        if (mdb_lookup_by_obj("pts", "ptswint", &sym) == 0)
                mdb_qops_remove(&pts_qops, (uintptr_t)sym.st_value);
}