1 /* 2 * CDDL HEADER START 3 * 4 * The contents of this file are subject to the terms of the 5 * Common Development and Distribution License, Version 1.0 only 6 * (the "License"). You may not use this file except in compliance 7 * with the License. 8 * 9 * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE 10 * or http://www.opensolaris.org/os/licensing. 11 * See the License for the specific language governing permissions 12 * and limitations under the License. 13 * 14 * When distributing Covered Code, include this CDDL HEADER in each 15 * file and include the License file at usr/src/OPENSOLARIS.LICENSE. 16 * If applicable, add the following below this CDDL HEADER, with the 17 * fields enclosed by brackets "[]" replaced with your own identifying 18 * information: Portions Copyright [yyyy] [name of copyright owner] 19 * 20 * CDDL HEADER END 21 */ 22 /* 23 * Copyright 2005 Sun Microsystems, Inc. All rights reserved. 24 * Use is subject to license terms. 25 */ 26 27 #pragma ident "%Z%%M% %I% %E% SMI" 28 29 #include <sys/types.h> 30 #include <sys/sysmacros.h> 31 32 #include <assert.h> 33 #include <limits.h> 34 #include <strings.h> 35 #include <stdlib.h> 36 #include <alloca.h> 37 #include <unistd.h> 38 #include <errno.h> 39 40 #include <dt_provider.h> 41 #include <dt_module.h> 42 #include <dt_string.h> 43 #include <dt_list.h> 44 45 static dt_provider_t * 46 dt_provider_insert(dtrace_hdl_t *dtp, dt_provider_t *pvp, uint_t h) 47 { 48 dt_list_append(&dtp->dt_provlist, pvp); 49 50 pvp->pv_next = dtp->dt_provs[h]; 51 dtp->dt_provs[h] = pvp; 52 dtp->dt_nprovs++; 53 54 return (pvp); 55 } 56 57 dt_provider_t * 58 dt_provider_lookup(dtrace_hdl_t *dtp, const char *name) 59 { 60 uint_t h = dt_strtab_hash(name, NULL) % dtp->dt_provbuckets; 61 dtrace_providerdesc_t desc; 62 dt_provider_t *pvp; 63 64 for (pvp = dtp->dt_provs[h]; pvp != NULL; pvp = pvp->pv_next) { 65 if (strcmp(pvp->pv_desc.dtvd_name, name) == 0) 66 return (pvp); 67 } 68 69 if (strisglob(name) || name[0] == '\0') { 70 (void) dt_set_errno(dtp, EDT_NOPROV); 71 return (NULL); 72 } 73 74 bzero(&desc, sizeof (desc)); 75 (void) strlcpy(desc.dtvd_name, name, DTRACE_PROVNAMELEN); 76 77 if (dt_ioctl(dtp, DTRACEIOC_PROVIDER, &desc) == -1) { 78 (void) dt_set_errno(dtp, errno == ESRCH ? EDT_NOPROV : errno); 79 return (NULL); 80 } 81 82 if ((pvp = dt_provider_create(dtp, name)) == NULL) 83 return (NULL); /* dt_errno is set for us */ 84 85 bcopy(&desc, &pvp->pv_desc, sizeof (desc)); 86 pvp->pv_flags |= DT_PROVIDER_IMPL; 87 return (pvp); 88 } 89 90 dt_provider_t * 91 dt_provider_create(dtrace_hdl_t *dtp, const char *name) 92 { 93 dt_provider_t *pvp; 94 95 if ((pvp = dt_zalloc(dtp, sizeof (dt_provider_t))) == NULL) 96 return (NULL); 97 98 (void) strlcpy(pvp->pv_desc.dtvd_name, name, DTRACE_PROVNAMELEN); 99 pvp->pv_probes = dt_idhash_create(pvp->pv_desc.dtvd_name, NULL, 0, 0); 100 pvp->pv_gen = dtp->dt_gen; 101 pvp->pv_hdl = dtp; 102 103 if (pvp->pv_probes == NULL) { 104 dt_free(dtp, pvp); 105 (void) dt_set_errno(dtp, EDT_NOMEM); 106 return (NULL); 107 } 108 109 pvp->pv_desc.dtvd_attr.dtpa_provider = _dtrace_prvattr; 110 pvp->pv_desc.dtvd_attr.dtpa_mod = _dtrace_prvattr; 111 pvp->pv_desc.dtvd_attr.dtpa_func = _dtrace_prvattr; 112 pvp->pv_desc.dtvd_attr.dtpa_name = _dtrace_prvattr; 113 pvp->pv_desc.dtvd_attr.dtpa_args = _dtrace_prvattr; 114 115 return (dt_provider_insert(dtp, pvp, 116 dt_strtab_hash(name, NULL) % dtp->dt_provbuckets)); 117 } 118 119 void 120 dt_provider_destroy(dtrace_hdl_t *dtp, dt_provider_t *pvp) 121 { 122 dt_provider_t **pp; 123 uint_t h; 124 125 assert(pvp->pv_hdl == dtp); 126 127 h = dt_strtab_hash(pvp->pv_desc.dtvd_name, NULL) % dtp->dt_provbuckets; 128 pp = &dtp->dt_provs[h]; 129 130 while (*pp != NULL && *pp != pvp) 131 pp = &(*pp)->pv_next; 132 133 assert(*pp != NULL && *pp == pvp); 134 *pp = pvp->pv_next; 135 136 dt_list_delete(&dtp->dt_provlist, pvp); 137 dtp->dt_nprovs--; 138 139 if (pvp->pv_probes != NULL) 140 dt_idhash_destroy(pvp->pv_probes); 141 142 dt_node_link_free(&pvp->pv_nodes); 143 dt_free(dtp, pvp->pv_xrefs); 144 dt_free(dtp, pvp); 145 } 146 147 int 148 dt_provider_xref(dtrace_hdl_t *dtp, dt_provider_t *pvp, id_t id) 149 { 150 size_t oldsize = BT_SIZEOFMAP(pvp->pv_xrmax); 151 size_t newsize = BT_SIZEOFMAP(dtp->dt_xlatorid); 152 153 assert(id >= 0 && id < dtp->dt_xlatorid); 154 155 if (newsize > oldsize) { 156 ulong_t *xrefs = dt_zalloc(dtp, newsize); 157 158 if (xrefs == NULL) 159 return (-1); 160 161 bcopy(pvp->pv_xrefs, xrefs, oldsize); 162 dt_free(dtp, pvp->pv_xrefs); 163 164 pvp->pv_xrefs = xrefs; 165 pvp->pv_xrmax = dtp->dt_xlatorid; 166 } 167 168 BT_SET(pvp->pv_xrefs, id); 169 return (0); 170 } 171 172 static uint8_t 173 dt_probe_argmap(dt_node_t *xnp, dt_node_t *nnp) 174 { 175 uint8_t i; 176 177 for (i = 0; nnp != NULL; i++) { 178 if (nnp->dn_string != NULL && 179 strcmp(nnp->dn_string, xnp->dn_string) == 0) 180 break; 181 else 182 nnp = nnp->dn_list; 183 } 184 185 return (i); 186 } 187 188 static dt_node_t * 189 dt_probe_alloc_args(dt_provider_t *pvp, int argc) 190 { 191 dt_node_t *args = NULL, *pnp = NULL, *dnp; 192 int i; 193 194 for (i = 0; i < argc; i++, pnp = dnp) { 195 if ((dnp = dt_node_xalloc(pvp->pv_hdl, DT_NODE_TYPE)) == NULL) 196 return (NULL); 197 198 dnp->dn_link = pvp->pv_nodes; 199 pvp->pv_nodes = dnp; 200 201 if (args == NULL) 202 args = dnp; 203 else 204 pnp->dn_list = dnp; 205 } 206 207 return (args); 208 } 209 210 static size_t 211 dt_probe_keylen(const dtrace_probedesc_t *pdp) 212 { 213 return (strlen(pdp->dtpd_mod) + 1 + 214 strlen(pdp->dtpd_func) + 1 + strlen(pdp->dtpd_name) + 1); 215 } 216 217 static char * 218 dt_probe_key(const dtrace_probedesc_t *pdp, char *s) 219 { 220 (void) snprintf(s, INT_MAX, "%s:%s:%s", 221 pdp->dtpd_mod, pdp->dtpd_func, pdp->dtpd_name); 222 return (s); 223 } 224 225 /* 226 * If a probe was discovered from the kernel, ask dtrace(7D) for a description 227 * of each of its arguments, including native and translated types. 228 */ 229 static dt_probe_t * 230 dt_probe_discover(dt_provider_t *pvp, const dtrace_probedesc_t *pdp) 231 { 232 dtrace_hdl_t *dtp = pvp->pv_hdl; 233 char *name = dt_probe_key(pdp, alloca(dt_probe_keylen(pdp))); 234 235 dt_node_t *xargs, *nargs; 236 dt_ident_t *idp; 237 dt_probe_t *prp; 238 239 dtrace_typeinfo_t dtt; 240 int i, nc, xc; 241 242 int adc = _dtrace_argmax; 243 dtrace_argdesc_t *adv = alloca(sizeof (dtrace_argdesc_t) * adc); 244 dtrace_argdesc_t *adp = adv; 245 246 assert(strcmp(pvp->pv_desc.dtvd_name, pdp->dtpd_provider) == 0); 247 assert(pdp->dtpd_id != DTRACE_IDNONE); 248 249 dt_dprintf("discovering probe %s:%s id=%d\n", 250 pvp->pv_desc.dtvd_name, name, pdp->dtpd_id); 251 252 for (nc = -1, i = 0; i < adc; i++, adp++) { 253 bzero(adp, sizeof (dtrace_argdesc_t)); 254 adp->dtargd_ndx = i; 255 adp->dtargd_id = pdp->dtpd_id; 256 257 if (dt_ioctl(dtp, DTRACEIOC_PROBEARG, adp) != 0) { 258 (void) dt_set_errno(dtp, errno); 259 return (NULL); 260 } 261 262 if (adp->dtargd_ndx == DTRACE_ARGNONE) 263 break; /* all argument descs have been retrieved */ 264 265 nc = MAX(nc, adp->dtargd_mapping); 266 } 267 268 xc = i; 269 nc++; 270 271 /* 272 * Now that we have discovered the number of native and translated 273 * arguments from the argument descriptions, allocate a new probe ident 274 * and corresponding dt_probe_t and hash it into the provider. 275 */ 276 xargs = dt_probe_alloc_args(pvp, xc); 277 nargs = dt_probe_alloc_args(pvp, nc); 278 279 if ((xc != 0 && xargs == NULL) || (nc != 0 && nargs == NULL)) 280 return (NULL); /* dt_errno is set for us */ 281 282 idp = dt_ident_create(name, DT_IDENT_PROBE, 283 DT_IDFLG_ORPHAN, pdp->dtpd_id, _dtrace_defattr, 0, 284 &dt_idops_probe, NULL, dtp->dt_gen); 285 286 if (idp == NULL) { 287 (void) dt_set_errno(dtp, EDT_NOMEM); 288 return (NULL); 289 } 290 291 if ((prp = dt_probe_create(dtp, idp, 2, 292 nargs, nc, xargs, xc)) == NULL) { 293 dt_ident_destroy(idp); 294 return (NULL); 295 } 296 297 dt_probe_declare(pvp, prp); 298 299 /* 300 * Once our new dt_probe_t is fully constructed, iterate over the 301 * cached argument descriptions and assign types to prp->pr_nargv[] 302 * and prp->pr_xargv[] and assign mappings to prp->pr_mapping[]. 303 */ 304 for (adp = adv, i = 0; i < xc; i++, adp++) { 305 if (dtrace_type_strcompile(dtp, 306 adp->dtargd_native, &dtt) != 0) { 307 dt_dprintf("failed to resolve input type %s " 308 "for %s:%s arg #%d: %s\n", adp->dtargd_native, 309 pvp->pv_desc.dtvd_name, name, i + 1, 310 dtrace_errmsg(dtp, dtrace_errno(dtp))); 311 312 dtt.dtt_object = NULL; 313 dtt.dtt_ctfp = NULL; 314 dtt.dtt_type = CTF_ERR; 315 } else { 316 dt_node_type_assign(prp->pr_nargv[adp->dtargd_mapping], 317 dtt.dtt_ctfp, dtt.dtt_type); 318 } 319 320 if (dtt.dtt_type != CTF_ERR && (adp->dtargd_xlate[0] == '\0' || 321 strcmp(adp->dtargd_native, adp->dtargd_xlate) == 0)) { 322 dt_node_type_propagate(prp->pr_nargv[ 323 adp->dtargd_mapping], prp->pr_xargv[i]); 324 } else if (dtrace_type_strcompile(dtp, 325 adp->dtargd_xlate, &dtt) != 0) { 326 dt_dprintf("failed to resolve output type %s " 327 "for %s:%s arg #%d: %s\n", adp->dtargd_xlate, 328 pvp->pv_desc.dtvd_name, name, i + 1, 329 dtrace_errmsg(dtp, dtrace_errno(dtp))); 330 331 dtt.dtt_object = NULL; 332 dtt.dtt_ctfp = NULL; 333 dtt.dtt_type = CTF_ERR; 334 } else { 335 dt_node_type_assign(prp->pr_xargv[i], 336 dtt.dtt_ctfp, dtt.dtt_type); 337 } 338 339 prp->pr_mapping[i] = adp->dtargd_mapping; 340 prp->pr_argv[i] = dtt; 341 } 342 343 return (prp); 344 } 345 346 /* 347 * Lookup a probe declaration based on a known provider and full or partially 348 * specified module, function, and name. If the probe is not known to us yet, 349 * ask dtrace(7D) to match the description and then cache any useful results. 350 */ 351 dt_probe_t * 352 dt_probe_lookup(dt_provider_t *pvp, const char *s) 353 { 354 dtrace_hdl_t *dtp = pvp->pv_hdl; 355 dtrace_probedesc_t pd; 356 dt_ident_t *idp; 357 size_t keylen; 358 char *key; 359 360 if (dtrace_str2desc(dtp, DTRACE_PROBESPEC_NAME, s, &pd) != 0) 361 return (NULL); /* dt_errno is set for us */ 362 363 keylen = dt_probe_keylen(&pd); 364 key = dt_probe_key(&pd, alloca(keylen)); 365 366 /* 367 * If the probe is already declared, then return the dt_probe_t from 368 * the existing identifier. This could come from a static declaration 369 * or it could have been cached from an earlier call to this function. 370 */ 371 if ((idp = dt_idhash_lookup(pvp->pv_probes, key)) != NULL) 372 return (idp->di_data); 373 374 /* 375 * If the probe isn't known, use the probe description computed above 376 * to ask dtrace(7D) to find the first matching probe. 377 */ 378 if (dt_ioctl(dtp, DTRACEIOC_PROBEMATCH, &pd) == 0) 379 return (dt_probe_discover(pvp, &pd)); 380 381 if (errno == ESRCH || errno == EBADF) 382 (void) dt_set_errno(dtp, EDT_NOPROBE); 383 else 384 (void) dt_set_errno(dtp, errno); 385 386 return (NULL); 387 } 388 389 dt_probe_t * 390 dt_probe_create(dtrace_hdl_t *dtp, dt_ident_t *idp, int protoc, 391 dt_node_t *nargs, uint_t nargc, dt_node_t *xargs, uint_t xargc) 392 { 393 dt_module_t *dmp; 394 dt_probe_t *prp; 395 const char *p; 396 uint_t i; 397 398 assert(idp->di_kind == DT_IDENT_PROBE); 399 assert(idp->di_data == NULL); 400 401 /* 402 * If only a single prototype is given, set xargc/s to nargc/s to 403 * simplify subsequent use. Note that we can have one or both of nargs 404 * and xargs be specified but set to NULL, indicating a void prototype. 405 */ 406 if (protoc < 2) { 407 assert(xargs == NULL); 408 assert(xargc == 0); 409 xargs = nargs; 410 xargc = nargc; 411 } 412 413 if ((prp = dt_alloc(dtp, sizeof (dt_probe_t))) == NULL) 414 return (NULL); 415 416 prp->pr_pvp = NULL; 417 prp->pr_ident = idp; 418 419 p = strrchr(idp->di_name, ':'); 420 assert(p != NULL); 421 prp->pr_name = p + 1; 422 423 prp->pr_nargs = nargs; 424 prp->pr_nargv = dt_alloc(dtp, sizeof (dt_node_t *) * nargc); 425 prp->pr_nargc = nargc; 426 prp->pr_xargs = xargs; 427 prp->pr_xargv = dt_alloc(dtp, sizeof (dt_node_t *) * xargc); 428 prp->pr_xargc = xargc; 429 prp->pr_mapping = dt_alloc(dtp, sizeof (uint8_t) * xargc); 430 prp->pr_inst = NULL; 431 prp->pr_argv = dt_alloc(dtp, sizeof (dtrace_typeinfo_t) * xargc); 432 prp->pr_argc = xargc; 433 434 if ((prp->pr_nargc != 0 && prp->pr_nargv == NULL) || 435 (prp->pr_xargc != 0 && prp->pr_xargv == NULL) || 436 (prp->pr_xargc != 0 && prp->pr_mapping == NULL) || 437 (prp->pr_argc != 0 && prp->pr_argv == NULL)) { 438 dt_probe_destroy(prp); 439 return (NULL); 440 } 441 442 for (i = 0; i < xargc; i++, xargs = xargs->dn_list) { 443 if (xargs->dn_string != NULL) 444 prp->pr_mapping[i] = dt_probe_argmap(xargs, nargs); 445 else 446 prp->pr_mapping[i] = i; 447 448 prp->pr_xargv[i] = xargs; 449 450 if ((dmp = dt_module_lookup_by_ctf(dtp, 451 xargs->dn_ctfp)) != NULL) 452 prp->pr_argv[i].dtt_object = dmp->dm_name; 453 else 454 prp->pr_argv[i].dtt_object = NULL; 455 456 prp->pr_argv[i].dtt_ctfp = xargs->dn_ctfp; 457 prp->pr_argv[i].dtt_type = xargs->dn_type; 458 } 459 460 for (i = 0; i < nargc; i++, nargs = nargs->dn_list) 461 prp->pr_nargv[i] = nargs; 462 463 idp->di_data = prp; 464 return (prp); 465 } 466 467 void 468 dt_probe_declare(dt_provider_t *pvp, dt_probe_t *prp) 469 { 470 assert(prp->pr_ident->di_kind == DT_IDENT_PROBE); 471 assert(prp->pr_ident->di_data == prp); 472 assert(prp->pr_pvp == NULL); 473 474 if (prp->pr_xargs != prp->pr_nargs) 475 pvp->pv_flags &= ~DT_PROVIDER_INTF; 476 477 prp->pr_pvp = pvp; 478 dt_idhash_xinsert(pvp->pv_probes, prp->pr_ident); 479 } 480 481 void 482 dt_probe_destroy(dt_probe_t *prp) 483 { 484 dt_probe_instance_t *pip, *pip_next; 485 dtrace_hdl_t *dtp; 486 487 if (prp->pr_pvp != NULL) 488 dtp = prp->pr_pvp->pv_hdl; 489 else 490 dtp = yypcb->pcb_hdl; 491 492 dt_node_list_free(&prp->pr_nargs); 493 dt_node_list_free(&prp->pr_xargs); 494 495 dt_free(dtp, prp->pr_nargv); 496 dt_free(dtp, prp->pr_xargv); 497 498 for (pip = prp->pr_inst; pip != NULL; pip = pip_next) { 499 pip_next = pip->pi_next; 500 dt_free(dtp, pip->pi_offs); 501 dt_free(dtp, pip); 502 } 503 504 dt_free(dtp, prp->pr_mapping); 505 dt_free(dtp, prp->pr_argv); 506 dt_free(dtp, prp); 507 } 508 509 int 510 dt_probe_define(dt_provider_t *pvp, dt_probe_t *prp, 511 const char *fname, uint32_t offset) 512 { 513 dtrace_hdl_t *dtp = pvp->pv_hdl; 514 dt_probe_instance_t *pip; 515 516 for (pip = prp->pr_inst; pip != NULL; pip = pip->pi_next) { 517 if (strcmp(pip->pi_fname, fname) == 0) 518 break; 519 } 520 521 if (pip == NULL) { 522 if ((pip = dt_alloc(dtp, sizeof (*pip))) == NULL || 523 (pip->pi_offs = dt_alloc(dtp, sizeof (uint32_t))) == NULL) { 524 dt_free(dtp, pip); 525 return (-1); 526 } 527 528 (void) strlcpy(pip->pi_fname, fname, sizeof (pip->pi_fname)); 529 pip->pi_noffs = 0; 530 pip->pi_maxoffs = 1; 531 pip->pi_next = prp->pr_inst; 532 533 prp->pr_inst = pip; 534 } 535 536 if (pip->pi_noffs == pip->pi_maxoffs) { 537 uint_t new_max = pip->pi_maxoffs * 2; 538 uint32_t *new_offs = dt_alloc(dtp, sizeof (uint32_t) * new_max); 539 540 if (new_offs == NULL) 541 return (-1); 542 543 bcopy(pip->pi_offs, new_offs, 544 sizeof (uint32_t) * pip->pi_maxoffs); 545 546 dt_free(dtp, pip->pi_offs); 547 pip->pi_maxoffs = new_max; 548 pip->pi_offs = new_offs; 549 } 550 551 dt_dprintf("defined probe %s:%s %s() +0x%x\n", 552 pvp->pv_desc.dtvd_name, prp->pr_ident->di_name, fname, offset); 553 554 assert(pip->pi_noffs < pip->pi_maxoffs); 555 pip->pi_offs[pip->pi_noffs++] = offset; 556 557 return (0); 558 } 559 560 /* 561 * Lookup the dynamic translator type tag for the specified probe argument and 562 * assign the type to the specified node. If the type is not yet defined, add 563 * it to the "D" module's type container as a typedef for an unknown type. 564 */ 565 dt_node_t * 566 dt_probe_tag(dt_probe_t *prp, uint_t argn, dt_node_t *dnp) 567 { 568 dtrace_hdl_t *dtp = prp->pr_pvp->pv_hdl; 569 dtrace_typeinfo_t dtt; 570 size_t len; 571 char *tag; 572 573 len = snprintf(NULL, 0, "__dtrace_%s___%s_arg%u", 574 prp->pr_pvp->pv_desc.dtvd_name, prp->pr_name, argn); 575 576 tag = alloca(len + 1); 577 578 (void) snprintf(tag, len + 1, "__dtrace_%s___%s_arg%u", 579 prp->pr_pvp->pv_desc.dtvd_name, prp->pr_name, argn); 580 581 if (dtrace_lookup_by_type(dtp, DTRACE_OBJ_DDEFS, tag, &dtt) != 0) { 582 dtt.dtt_object = DTRACE_OBJ_DDEFS; 583 dtt.dtt_ctfp = DT_DYN_CTFP(dtp); 584 dtt.dtt_type = ctf_add_typedef(DT_DYN_CTFP(dtp), 585 CTF_ADD_ROOT, tag, DT_DYN_TYPE(dtp)); 586 587 if (dtt.dtt_type == CTF_ERR || 588 ctf_update(dtt.dtt_ctfp) == CTF_ERR) { 589 xyerror(D_UNKNOWN, "cannot define type %s: %s\n", 590 tag, ctf_errmsg(ctf_errno(dtt.dtt_ctfp))); 591 } 592 } 593 594 bzero(dnp, sizeof (dt_node_t)); 595 dnp->dn_kind = DT_NODE_TYPE; 596 597 dt_node_type_assign(dnp, dtt.dtt_ctfp, dtt.dtt_type); 598 dt_node_attr_assign(dnp, _dtrace_defattr); 599 600 return (dnp); 601 } 602 603 /*ARGSUSED*/ 604 static int 605 dt_probe_desc(dtrace_hdl_t *dtp, const dtrace_probedesc_t *pdp, void *arg) 606 { 607 if (((dtrace_probedesc_t *)arg)->dtpd_id == DTRACE_IDNONE) { 608 bcopy(pdp, arg, sizeof (dtrace_probedesc_t)); 609 return (0); 610 } 611 612 return (1); 613 } 614 615 dt_probe_t * 616 dt_probe_info(dtrace_hdl_t *dtp, 617 const dtrace_probedesc_t *pdp, dtrace_probeinfo_t *pip) 618 { 619 int m_is_glob = pdp->dtpd_mod[0] == '\0' || strisglob(pdp->dtpd_mod); 620 int f_is_glob = pdp->dtpd_func[0] == '\0' || strisglob(pdp->dtpd_func); 621 int n_is_glob = pdp->dtpd_name[0] == '\0' || strisglob(pdp->dtpd_name); 622 623 dt_probe_t *prp = NULL; 624 const dtrace_pattr_t *pap; 625 dt_provider_t *pvp; 626 dt_ident_t *idp; 627 628 /* 629 * Attempt to lookup the probe in our existing cache for this provider. 630 * If none is found and an explicit probe ID was specified, discover 631 * that specific probe and cache its description and arguments. 632 */ 633 if ((pvp = dt_provider_lookup(dtp, pdp->dtpd_provider)) != NULL) { 634 size_t keylen = dt_probe_keylen(pdp); 635 char *key = dt_probe_key(pdp, alloca(keylen)); 636 637 if ((idp = dt_idhash_lookup(pvp->pv_probes, key)) != NULL) 638 prp = idp->di_data; 639 else if (pdp->dtpd_id != DTRACE_IDNONE) 640 prp = dt_probe_discover(pvp, pdp); 641 } 642 643 /* 644 * If no probe was found in our cache, convert the caller's partial 645 * probe description into a fully-formed matching probe description by 646 * iterating over up to at most two probes that match 'pdp'. We then 647 * call dt_probe_discover() on the resulting probe identifier. 648 */ 649 if (prp == NULL) { 650 dtrace_probedesc_t pd; 651 int m; 652 653 bzero(&pd, sizeof (pd)); 654 pd.dtpd_id = DTRACE_IDNONE; 655 656 /* 657 * Call dtrace_probe_iter() to find matching probes. Our 658 * dt_probe_desc() callback will produce the following results: 659 * 660 * m < 0 dtrace_probe_iter() found zero matches (or failed). 661 * m > 0 dtrace_probe_iter() found more than one match. 662 * m = 0 dtrace_probe_iter() found exactly one match. 663 */ 664 if ((m = dtrace_probe_iter(dtp, pdp, dt_probe_desc, &pd)) < 0) 665 return (NULL); /* dt_errno is set for us */ 666 667 if ((pvp = dt_provider_lookup(dtp, pd.dtpd_provider)) == NULL) 668 return (NULL); /* dt_errno is set for us */ 669 670 /* 671 * If more than one probe was matched, then do not report probe 672 * information if either of the following conditions is true: 673 * 674 * (a) The Arguments Data stability of the matched provider is 675 * less than Evolving. 676 * 677 * (b) Any description component that is at least Evolving is 678 * empty or is specified using a globbing expression. 679 * 680 * These conditions imply that providers that provide Evolving 681 * or better Arguments Data stability must guarantee that all 682 * probes with identical field names in a field of Evolving or 683 * better Name stability have identical argument signatures. 684 */ 685 if (m > 0) { 686 if (pvp->pv_desc.dtvd_attr.dtpa_args.dtat_data < 687 DTRACE_STABILITY_EVOLVING) { 688 (void) dt_set_errno(dtp, EDT_UNSTABLE); 689 return (NULL); 690 } 691 692 693 if (pvp->pv_desc.dtvd_attr.dtpa_mod.dtat_name >= 694 DTRACE_STABILITY_EVOLVING && m_is_glob) { 695 (void) dt_set_errno(dtp, EDT_UNSTABLE); 696 return (NULL); 697 } 698 699 if (pvp->pv_desc.dtvd_attr.dtpa_func.dtat_name >= 700 DTRACE_STABILITY_EVOLVING && f_is_glob) { 701 (void) dt_set_errno(dtp, EDT_UNSTABLE); 702 return (NULL); 703 } 704 705 if (pvp->pv_desc.dtvd_attr.dtpa_name.dtat_name >= 706 DTRACE_STABILITY_EVOLVING && n_is_glob) { 707 (void) dt_set_errno(dtp, EDT_UNSTABLE); 708 return (NULL); 709 } 710 } 711 712 /* 713 * If we matched a probe exported by dtrace(7D), then discover 714 * the real attributes. Otherwise grab the static declaration. 715 */ 716 if (pd.dtpd_id != DTRACE_IDNONE) 717 prp = dt_probe_discover(pvp, &pd); 718 else 719 prp = dt_probe_lookup(pvp, pd.dtpd_name); 720 721 if (prp == NULL) 722 return (NULL); /* dt_errno is set for us */ 723 } 724 725 assert(pvp != NULL && prp != NULL); 726 727 /* 728 * Compute the probe description attributes by taking the minimum of 729 * the attributes of the specified fields. If no provider is specified 730 * or a glob pattern is used for the provider, use Unstable attributes. 731 */ 732 if (pdp->dtpd_provider[0] == '\0' || strisglob(pdp->dtpd_provider)) 733 pap = &_dtrace_prvdesc; 734 else 735 pap = &pvp->pv_desc.dtvd_attr; 736 737 pip->dtp_attr = pap->dtpa_provider; 738 739 if (!m_is_glob) 740 pip->dtp_attr = dt_attr_min(pip->dtp_attr, pap->dtpa_mod); 741 if (!f_is_glob) 742 pip->dtp_attr = dt_attr_min(pip->dtp_attr, pap->dtpa_func); 743 if (!n_is_glob) 744 pip->dtp_attr = dt_attr_min(pip->dtp_attr, pap->dtpa_name); 745 746 pip->dtp_arga = pap->dtpa_args; 747 pip->dtp_argv = prp->pr_argv; 748 pip->dtp_argc = prp->pr_argc; 749 750 return (prp); 751 } 752 753 int 754 dtrace_probe_info(dtrace_hdl_t *dtp, 755 const dtrace_probedesc_t *pdp, dtrace_probeinfo_t *pip) 756 { 757 return (dt_probe_info(dtp, pdp, pip) != NULL ? 0 : -1); 758 } 759 760 /*ARGSUSED*/ 761 static int 762 dt_probe_iter(dt_idhash_t *ihp, dt_ident_t *idp, dt_probe_iter_t *pit) 763 { 764 const dt_probe_t *prp = idp->di_data; 765 766 if (!dt_gmatch(prp->pr_name, pit->pit_pat)) 767 return (0); /* continue on and examine next probe in hash */ 768 769 (void) strlcpy(pit->pit_desc.dtpd_name, prp->pr_name, DTRACE_NAMELEN); 770 pit->pit_desc.dtpd_id = idp->di_id; 771 pit->pit_matches++; 772 773 return (pit->pit_func(pit->pit_hdl, &pit->pit_desc, pit->pit_arg)); 774 } 775 776 int 777 dtrace_probe_iter(dtrace_hdl_t *dtp, 778 const dtrace_probedesc_t *pdp, dtrace_probe_f *func, void *arg) 779 { 780 const char *provider = pdp ? pdp->dtpd_provider : NULL; 781 dtrace_id_t id = DTRACE_IDNONE; 782 783 dtrace_probedesc_t pd; 784 dt_probe_iter_t pit; 785 int cmd, rv; 786 787 bzero(&pit, sizeof (pit)); 788 pit.pit_hdl = dtp; 789 pit.pit_func = func; 790 pit.pit_arg = arg; 791 pit.pit_pat = pdp ? pdp->dtpd_name : NULL; 792 793 for (pit.pit_pvp = dt_list_next(&dtp->dt_provlist); 794 pit.pit_pvp != NULL; pit.pit_pvp = dt_list_next(pit.pit_pvp)) { 795 796 if (pit.pit_pvp->pv_flags & DT_PROVIDER_IMPL) 797 continue; /* we'll get these later using dt_ioctl() */ 798 799 if (!dt_gmatch(pit.pit_pvp->pv_desc.dtvd_name, provider)) 800 continue; 801 802 (void) strlcpy(pit.pit_desc.dtpd_provider, 803 pit.pit_pvp->pv_desc.dtvd_name, DTRACE_PROVNAMELEN); 804 805 if ((rv = dt_idhash_iter(pit.pit_pvp->pv_probes, 806 (dt_idhash_f *)dt_probe_iter, &pit)) != 0) 807 return (rv); 808 } 809 810 if (pdp != NULL) 811 cmd = DTRACEIOC_PROBEMATCH; 812 else 813 cmd = DTRACEIOC_PROBES; 814 815 for (;;) { 816 if (pdp != NULL) 817 bcopy(pdp, &pd, sizeof (pd)); 818 819 pd.dtpd_id = id; 820 821 if (dt_ioctl(dtp, cmd, &pd) != 0) 822 break; 823 else if ((rv = func(dtp, &pd, arg)) != 0) 824 return (rv); 825 826 pit.pit_matches++; 827 id = pd.dtpd_id + 1; 828 } 829 830 switch (errno) { 831 case ESRCH: 832 case EBADF: 833 return (pit.pit_matches ? 0 : dt_set_errno(dtp, EDT_NOPROBE)); 834 case EINVAL: 835 return (dt_set_errno(dtp, EDT_BADPGLOB)); 836 default: 837 return (dt_set_errno(dtp, errno)); 838 } 839 } 840