14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync/*
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync * CDDL HEADER START
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync *
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync * The contents of this file are subject to the terms of the
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync * Common Development and Distribution License, Version 1.0 only
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync * (the "License"). You may not use this file except in compliance
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync * with the License.
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync *
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync * or http://www.opensolaris.org/os/licensing.
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync * See the License for the specific language governing permissions
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync * and limitations under the License.
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync *
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync * When distributing Covered Code, include this CDDL HEADER in each
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync * If applicable, add the following below this CDDL HEADER, with the
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync * fields enclosed by brackets "[]" replaced with your own identifying
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync * information: Portions Copyright [yyyy] [name of copyright owner]
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync *
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync * CDDL HEADER END
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync */
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync/*
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync * Copyright 2005 Sun Microsystems, Inc. All rights reserved.
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync * Use is subject to license terms.
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync */
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync#ifndef _DT_IDENT_H
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync#define _DT_IDENT_H
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync
dfd08267d2958ae1cd559dd7dc2f36bf5461648dvboxsync#ifndef VBOX
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync#pragma ident "%Z%%M% %I% %E% SMI"
dfd08267d2958ae1cd559dd7dc2f36bf5461648dvboxsync#endif
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync#include <libctf.h>
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync#include <dtrace.h>
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync#ifdef __cplusplus
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsyncextern "C" {
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync#endif
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync#include <dt_list.h>
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsyncstruct dt_node;
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsyncstruct dt_ident;
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsyncstruct dt_idhash;
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsyncstruct dt_irlist;
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsyncstruct dt_regset;
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsynctypedef struct dt_idsig {
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync int dis_varargs; /* argument index of start of varargs (or -1) */
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync int dis_optargs; /* argument index of start of optargs (or -1) */
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync int dis_argc; /* number of types in this signature */
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync struct dt_node *dis_args; /* array of nodes representing formal types */
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync uint64_t dis_auxinfo; /* auxiliary signature information, if any */
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync} dt_idsig_t;
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsynctypedef struct dt_idnode {
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync struct dt_node *din_list; /* allocation list for parse tree nodes */
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync struct dt_node *din_root; /* root of this identifier's parse tree */
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync struct dt_idhash *din_hash; /* identifiers private to this subtree */
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync struct dt_ident **din_argv; /* identifiers in din_hash for arguments */
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync int din_argc; /* length of din_argv[] array */
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync} dt_idnode_t;
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsynctypedef struct dt_idops {
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync void (*di_cook)(struct dt_node *, struct dt_ident *,
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync int, struct dt_node *);
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync void (*di_dtor)(struct dt_ident *);
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync size_t (*di_size)(struct dt_ident *);
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync} dt_idops_t;
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsynctypedef struct dt_ident {
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync char *di_name; /* identifier name */
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync ushort_t di_kind; /* identifier kind (see below) */
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync ushort_t di_flags; /* identifier flags (see below) */
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync uint_t di_id; /* variable or subr id (see <sys/dtrace.h>) */
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync dtrace_attribute_t di_attr; /* identifier stability attributes */
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync uint_t di_vers; /* identifier version number (dt_version_t) */
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync const dt_idops_t *di_ops; /* identifier's class-specific ops vector */
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync void *di_iarg; /* initial argument pointer for ops vector */
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync void *di_data; /* private data pointer for ops vector */
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync ctf_file_t *di_ctfp; /* CTF container for the variable data type */
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync ctf_id_t di_type; /* CTF identifier for the variable data type */
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync struct dt_ident *di_next; /* pointer to next ident in hash chain */
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync ulong_t di_gen; /* generation number (pass that created me) */
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync int di_lineno; /* line number that defined this identifier */
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync} dt_ident_t;
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync#define DT_IDENT_ARRAY 0 /* identifier is an array variable */
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync#define DT_IDENT_SCALAR 1 /* identifier is a scalar variable */
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync#define DT_IDENT_PTR 2 /* identifier is a magic pointer */
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync#define DT_IDENT_FUNC 3 /* identifier is a built-in function */
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync#define DT_IDENT_AGG 4 /* identifier is an aggregation */
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync#define DT_IDENT_AGGFUNC 5 /* identifier is an aggregating function */
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync#define DT_IDENT_ACTFUNC 6 /* identifier is an action function */
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync#define DT_IDENT_XLSOU 7 /* identifier is a translated struct or union */
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync#define DT_IDENT_XLPTR 8 /* identifier is a translated pointer */
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync#define DT_IDENT_SYMBOL 9 /* identifier is an external symbol */
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync#define DT_IDENT_ENUM 10 /* identifier is an enumerator */
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync#define DT_IDENT_PRAGAT 11 /* identifier is #pragma attributes */
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync#define DT_IDENT_PRAGBN 12 /* identifier is #pragma binding */
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync#define DT_IDENT_PROBE 13 /* identifier is a probe definition */
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync#define DT_IDFLG_TLS 0x0001 /* variable is thread-local storage */
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync#define DT_IDFLG_LOCAL 0x0002 /* variable is local storage */
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync#define DT_IDFLG_WRITE 0x0004 /* variable is writable (can be modified) */
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync#define DT_IDFLG_INLINE 0x0008 /* variable is an inline definition */
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync#define DT_IDFLG_REF 0x0010 /* variable is referenced by this program */
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync#define DT_IDFLG_MOD 0x0020 /* variable is modified by this program */
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync#define DT_IDFLG_DIFR 0x0040 /* variable is referenced by current DIFO */
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync#define DT_IDFLG_DIFW 0x0080 /* variable is modified by current DIFO */
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync#define DT_IDFLG_CGREG 0x0100 /* variable is inlined by code generator */
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync#define DT_IDFLG_USER 0x0200 /* variable is associated with userland */
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync#define DT_IDFLG_PRIM 0x0400 /* variable is associated with primary object */
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync#define DT_IDFLG_DECL 0x0800 /* variable is associated with explicit decl */
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync#define DT_IDFLG_ORPHAN 0x1000 /* variable is in a dt_node and not dt_idhash */
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsynctypedef struct dt_idhash {
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync dt_list_t dh_list; /* list prev/next pointers for dt_idstack */
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync const char *dh_name; /* name of this hash table */
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync void (*dh_defer)(struct dt_idhash *, dt_ident_t *); /* defer callback */
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync const dt_ident_t *dh_tmpl; /* template for initial ident population */
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync uint_t dh_nextid; /* next id to be returned by idhash_nextid() */
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync uint_t dh_minid; /* min id to be returned by idhash_nextid() */
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync uint_t dh_maxid; /* max id to be returned by idhash_nextid() */
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync ulong_t dh_nelems; /* number of identifiers in hash table */
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync ulong_t dh_hashsz; /* number of entries in dh_buckets array */
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync dt_ident_t *dh_hash[1]; /* array of hash table bucket pointers */
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync} dt_idhash_t;
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsynctypedef struct dt_idstack {
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync dt_list_t dids_list; /* list meta-data for dt_idhash_t stack */
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync} dt_idstack_t;
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsyncextern const dt_idops_t dt_idops_assc; /* associative array or aggregation */
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsyncextern const dt_idops_t dt_idops_func; /* function call built-in */
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsyncextern const dt_idops_t dt_idops_args; /* args[] built-in */
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsyncextern const dt_idops_t dt_idops_regs; /* regs[]/uregs[] built-in */
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsyncextern const dt_idops_t dt_idops_type; /* predefined type name string */
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsyncextern const dt_idops_t dt_idops_thaw; /* prefrozen type identifier */
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsyncextern const dt_idops_t dt_idops_inline; /* inline variable */
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsyncextern const dt_idops_t dt_idops_probe; /* probe definition */
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsyncextern dt_idhash_t *dt_idhash_create(const char *, const dt_ident_t *,
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync uint_t, uint_t);
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsyncextern void dt_idhash_destroy(dt_idhash_t *);
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsyncextern void dt_idhash_update(dt_idhash_t *);
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsyncextern dt_ident_t *dt_idhash_lookup(dt_idhash_t *, const char *);
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsyncextern int dt_idhash_nextid(dt_idhash_t *, uint_t *);
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsyncextern ulong_t dt_idhash_size(const dt_idhash_t *);
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsyncextern const char *dt_idhash_name(const dt_idhash_t *);
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsyncextern dt_ident_t *dt_idhash_insert(dt_idhash_t *, const char *, ushort_t,
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync ushort_t, uint_t, dtrace_attribute_t, uint_t,
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync const dt_idops_t *, void *, ulong_t);
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsyncextern void dt_idhash_xinsert(dt_idhash_t *, dt_ident_t *);
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsyncextern void dt_idhash_delete(dt_idhash_t *, dt_ident_t *);
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsynctypedef int dt_idhash_f(dt_idhash_t *, dt_ident_t *, void *);
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsyncextern int dt_idhash_iter(dt_idhash_t *, dt_idhash_f *, void *);
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsyncextern dt_ident_t *dt_idstack_lookup(dt_idstack_t *, const char *);
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsyncextern void dt_idstack_push(dt_idstack_t *, dt_idhash_t *);
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsyncextern void dt_idstack_pop(dt_idstack_t *, dt_idhash_t *);
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsyncextern dt_ident_t *dt_ident_create(const char *, ushort_t, ushort_t, uint_t,
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync dtrace_attribute_t, uint_t, const dt_idops_t *, void *, ulong_t);
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsyncextern void dt_ident_destroy(dt_ident_t *);
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsyncextern void dt_ident_morph(dt_ident_t *, ushort_t, const dt_idops_t *, void *);
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsyncextern dtrace_attribute_t dt_ident_cook(struct dt_node *,
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync dt_ident_t *, struct dt_node **);
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsyncextern void dt_ident_type_assign(dt_ident_t *, ctf_file_t *, ctf_id_t);
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsyncextern dt_ident_t *dt_ident_resolve(dt_ident_t *);
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsyncextern size_t dt_ident_size(dt_ident_t *);
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsyncextern int dt_ident_unref(const dt_ident_t *);
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsyncextern const char *dt_idkind_name(uint_t);
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync#ifdef __cplusplus
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync}
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync#endif
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync
14ea49401f3c8c61422aefbda43809e275f60c6cvboxsync#endif /* _DT_IDENT_H */