1 /* SystemTap probe support for GDB.
3 Copyright (C) 2012-2014 Free Software Foundation, Inc.
5 This file is part of GDB.
7 This program is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 3 of the License, or
10 (at your option) any later version.
12 This program is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with this program. If not, see <http://www.gnu.org/licenses/>. */
21 #include "stap-probe.h"
26 #include "arch-utils.h"
29 #include "filenames.h"
31 #include "exceptions.h"
34 #include "complaints.h"
35 #include "cli/cli-utils.h"
37 #include "user-regs.h"
38 #include "parser-defs.h"
44 /* The name of the SystemTap section where we will find information about
47 #define STAP_BASE_SECTION_NAME ".stapsdt.base"
49 /* Forward declaration. */
51 static const struct probe_ops stap_probe_ops;
53 /* Should we display debug information for the probe's argument expression
56 static unsigned int stap_expression_debug = 0;
58 /* The various possibilities of bitness defined for a probe's argument.
62 - STAP_ARG_BITNESS_UNDEFINED: The user hasn't specified the bitness.
63 - STAP_ARG_BITNESS_8BIT_UNSIGNED: argument string starts with `1@'.
64 - STAP_ARG_BITNESS_8BIT_SIGNED: argument string starts with `-1@'.
65 - STAP_ARG_BITNESS_16BIT_UNSIGNED: argument string starts with `2@'.
66 - STAP_ARG_BITNESS_16BIT_SIGNED: argument string starts with `-2@'.
67 - STAP_ARG_BITNESS_32BIT_UNSIGNED: argument string starts with `4@'.
68 - STAP_ARG_BITNESS_32BIT_SIGNED: argument string starts with `-4@'.
69 - STAP_ARG_BITNESS_64BIT_UNSIGNED: argument string starts with `8@'.
70 - STAP_ARG_BITNESS_64BIT_SIGNED: argument string starts with `-8@'. */
74 STAP_ARG_BITNESS_UNDEFINED,
75 STAP_ARG_BITNESS_8BIT_UNSIGNED,
76 STAP_ARG_BITNESS_8BIT_SIGNED,
77 STAP_ARG_BITNESS_16BIT_UNSIGNED,
78 STAP_ARG_BITNESS_16BIT_SIGNED,
79 STAP_ARG_BITNESS_32BIT_UNSIGNED,
80 STAP_ARG_BITNESS_32BIT_SIGNED,
81 STAP_ARG_BITNESS_64BIT_UNSIGNED,
82 STAP_ARG_BITNESS_64BIT_SIGNED,
85 /* The following structure represents a single argument for the probe. */
89 /* The bitness of this argument. */
90 enum stap_arg_bitness bitness;
92 /* The corresponding `struct type *' to the bitness. */
95 /* The argument converted to an internal GDB expression. */
96 struct expression *aexpr;
99 typedef struct stap_probe_arg stap_probe_arg_s;
100 DEF_VEC_O (stap_probe_arg_s);
104 /* Generic information about the probe. This shall be the first element
105 of this struct, in order to maintain binary compatibility with the
106 `struct probe' and be able to fully abstract it. */
109 /* If the probe has a semaphore associated, then this is the value of
110 it, relative to SECT_OFF_DATA. */
113 /* One if the arguments have been parsed. */
114 unsigned int args_parsed : 1;
120 /* Information about each argument. This is an array of `stap_probe_arg',
121 with each entry representing one argument. */
122 VEC (stap_probe_arg_s) *vec;
127 /* When parsing the arguments, we have to establish different precedences
128 for the various kinds of asm operators. This enumeration represents those
131 This logic behind this is available at
132 <http://sourceware.org/binutils/docs/as/Infix-Ops.html#Infix-Ops>, or using
133 the command "info '(as)Infix Ops'". */
135 enum stap_operand_prec
137 /* Lowest precedence, used for non-recognized operands or for the beginning
138 of the parsing process. */
139 STAP_OPERAND_PREC_NONE = 0,
141 /* Precedence of logical OR. */
142 STAP_OPERAND_PREC_LOGICAL_OR,
144 /* Precedence of logical AND. */
145 STAP_OPERAND_PREC_LOGICAL_AND,
147 /* Precedence of additive (plus, minus) and comparative (equal, less,
148 greater-than, etc) operands. */
149 STAP_OPERAND_PREC_ADD_CMP,
151 /* Precedence of bitwise operands (bitwise OR, XOR, bitwise AND,
153 STAP_OPERAND_PREC_BITWISE,
155 /* Precedence of multiplicative operands (multiplication, division,
156 remainder, left shift and right shift). */
157 STAP_OPERAND_PREC_MUL
160 static void stap_parse_argument_1 (struct stap_parse_info *p, int has_lhs,
161 enum stap_operand_prec prec);
163 static void stap_parse_argument_conditionally (struct stap_parse_info *p);
165 /* Returns 1 if *S is an operator, zero otherwise. */
167 static int stap_is_operator (const char *op);
170 show_stapexpressiondebug (struct ui_file *file, int from_tty,
171 struct cmd_list_element *c, const char *value)
173 fprintf_filtered (file, _("SystemTap Probe expression debugging is %s.\n"),
177 /* Returns the operator precedence level of OP, or STAP_OPERAND_PREC_NONE
178 if the operator code was not recognized. */
180 static enum stap_operand_prec
181 stap_get_operator_prec (enum exp_opcode op)
185 case BINOP_LOGICAL_OR:
186 return STAP_OPERAND_PREC_LOGICAL_OR;
188 case BINOP_LOGICAL_AND:
189 return STAP_OPERAND_PREC_LOGICAL_AND;
199 return STAP_OPERAND_PREC_ADD_CMP;
201 case BINOP_BITWISE_IOR:
202 case BINOP_BITWISE_AND:
203 case BINOP_BITWISE_XOR:
204 case UNOP_LOGICAL_NOT:
205 return STAP_OPERAND_PREC_BITWISE;
212 return STAP_OPERAND_PREC_MUL;
215 return STAP_OPERAND_PREC_NONE;
219 /* Given S, read the operator in it and fills the OP pointer with its code.
220 Return 1 on success, zero if the operator was not recognized. */
222 static enum exp_opcode
223 stap_get_opcode (const char **s)
278 op = BINOP_BITWISE_IOR;
282 op = BINOP_LOGICAL_OR;
287 op = BINOP_BITWISE_AND;
291 op = BINOP_LOGICAL_AND;
296 op = BINOP_BITWISE_XOR;
300 op = UNOP_LOGICAL_NOT;
312 gdb_assert (**s == '=');
317 internal_error (__FILE__, __LINE__,
318 _("Invalid opcode in expression `%s' for SystemTap"
325 /* Given the bitness of the argument, represented by B, return the
326 corresponding `struct type *'. */
329 stap_get_expected_argument_type (struct gdbarch *gdbarch,
330 enum stap_arg_bitness b)
334 case STAP_ARG_BITNESS_UNDEFINED:
335 if (gdbarch_addr_bit (gdbarch) == 32)
336 return builtin_type (gdbarch)->builtin_uint32;
338 return builtin_type (gdbarch)->builtin_uint64;
340 case STAP_ARG_BITNESS_8BIT_UNSIGNED:
341 return builtin_type (gdbarch)->builtin_uint8;
343 case STAP_ARG_BITNESS_8BIT_SIGNED:
344 return builtin_type (gdbarch)->builtin_int8;
346 case STAP_ARG_BITNESS_16BIT_UNSIGNED:
347 return builtin_type (gdbarch)->builtin_uint16;
349 case STAP_ARG_BITNESS_16BIT_SIGNED:
350 return builtin_type (gdbarch)->builtin_int16;
352 case STAP_ARG_BITNESS_32BIT_SIGNED:
353 return builtin_type (gdbarch)->builtin_int32;
355 case STAP_ARG_BITNESS_32BIT_UNSIGNED:
356 return builtin_type (gdbarch)->builtin_uint32;
358 case STAP_ARG_BITNESS_64BIT_SIGNED:
359 return builtin_type (gdbarch)->builtin_int64;
361 case STAP_ARG_BITNESS_64BIT_UNSIGNED:
362 return builtin_type (gdbarch)->builtin_uint64;
365 internal_error (__FILE__, __LINE__,
366 _("Undefined bitness for probe."));
371 /* Helper function to check for a generic list of prefixes. GDBARCH
372 is the current gdbarch being used. S is the expression being
373 analyzed. If R is not NULL, it will be used to return the found
374 prefix. PREFIXES is the list of expected prefixes.
376 This function does a case-insensitive match.
378 Return 1 if any prefix has been found, zero otherwise. */
381 stap_is_generic_prefix (struct gdbarch *gdbarch, const char *s,
382 const char **r, const char *const *prefixes)
384 const char *const *p;
386 if (prefixes == NULL)
394 for (p = prefixes; *p != NULL; ++p)
395 if (strncasecmp (s, *p, strlen (*p)) == 0)
406 /* Return 1 if S points to a register prefix, zero otherwise. For a
407 description of the arguments, look at stap_is_generic_prefix. */
410 stap_is_register_prefix (struct gdbarch *gdbarch, const char *s,
413 const char *const *t = gdbarch_stap_register_prefixes (gdbarch);
415 return stap_is_generic_prefix (gdbarch, s, r, t);
418 /* Return 1 if S points to a register indirection prefix, zero
419 otherwise. For a description of the arguments, look at
420 stap_is_generic_prefix. */
423 stap_is_register_indirection_prefix (struct gdbarch *gdbarch, const char *s,
426 const char *const *t = gdbarch_stap_register_indirection_prefixes (gdbarch);
428 return stap_is_generic_prefix (gdbarch, s, r, t);
431 /* Return 1 if S points to an integer prefix, zero otherwise. For a
432 description of the arguments, look at stap_is_generic_prefix.
434 This function takes care of analyzing whether we are dealing with
435 an expected integer prefix, or, if there is no integer prefix to be
436 expected, whether we are dealing with a digit. It does a
437 case-insensitive match. */
440 stap_is_integer_prefix (struct gdbarch *gdbarch, const char *s,
443 const char *const *t = gdbarch_stap_integer_prefixes (gdbarch);
444 const char *const *p;
448 /* A NULL value here means that integers do not have a prefix.
449 We just check for a digit then. */
456 for (p = t; *p != NULL; ++p)
458 size_t len = strlen (*p);
460 if ((len == 0 && isdigit (*s))
461 || (len > 0 && strncasecmp (s, *p, len) == 0))
463 /* Integers may or may not have a prefix. The "len == 0"
464 check covers the case when integers do not have a prefix
465 (therefore, we just check if we have a digit). The call
466 to "strncasecmp" covers the case when they have a
478 /* Helper function to check for a generic list of suffixes. If we are
479 not expecting any suffixes, then it just returns 1. If we are
480 expecting at least one suffix, then it returns 1 if a suffix has
481 been found, zero otherwise. GDBARCH is the current gdbarch being
482 used. S is the expression being analyzed. If R is not NULL, it
483 will be used to return the found suffix. SUFFIXES is the list of
484 expected suffixes. This function does a case-insensitive
488 stap_generic_check_suffix (struct gdbarch *gdbarch, const char *s,
489 const char **r, const char *const *suffixes)
491 const char *const *p;
494 if (suffixes == NULL)
502 for (p = suffixes; *p != NULL; ++p)
503 if (strncasecmp (s, *p, strlen (*p)) == 0)
515 /* Return 1 if S points to an integer suffix, zero otherwise. For a
516 description of the arguments, look at
517 stap_generic_check_suffix. */
520 stap_check_integer_suffix (struct gdbarch *gdbarch, const char *s,
523 const char *const *p = gdbarch_stap_integer_suffixes (gdbarch);
525 return stap_generic_check_suffix (gdbarch, s, r, p);
528 /* Return 1 if S points to a register suffix, zero otherwise. For a
529 description of the arguments, look at
530 stap_generic_check_suffix. */
533 stap_check_register_suffix (struct gdbarch *gdbarch, const char *s,
536 const char *const *p = gdbarch_stap_register_suffixes (gdbarch);
538 return stap_generic_check_suffix (gdbarch, s, r, p);
541 /* Return 1 if S points to a register indirection suffix, zero
542 otherwise. For a description of the arguments, look at
543 stap_generic_check_suffix. */
546 stap_check_register_indirection_suffix (struct gdbarch *gdbarch, const char *s,
549 const char *const *p = gdbarch_stap_register_indirection_suffixes (gdbarch);
551 return stap_generic_check_suffix (gdbarch, s, r, p);
554 /* Function responsible for parsing a register operand according to
555 SystemTap parlance. Assuming:
559 RIP = register indirection prefix
560 RIS = register indirection suffix
562 Then a register operand can be:
564 [RIP] [RP] REGISTER [RS] [RIS]
566 This function takes care of a register's indirection, displacement and
567 direct access. It also takes into consideration the fact that some
568 registers are named differently inside and outside GDB, e.g., PPC's
569 general-purpose registers are represented by integers in the assembly
570 language (e.g., `15' is the 15th general-purpose register), but inside
571 GDB they have a prefix (the letter `r') appended. */
574 stap_parse_register_operand (struct stap_parse_info *p)
576 /* Simple flag to indicate whether we have seen a minus signal before
579 /* Flags to indicate whether this register access is being displaced and/or
581 int disp_p = 0, indirect_p = 0;
582 struct gdbarch *gdbarch = p->gdbarch;
583 /* Needed to generate the register name as a part of an expression. */
585 /* Variables used to extract the register name from the probe's
590 const char *gdb_reg_prefix = gdbarch_stap_gdb_register_prefix (gdbarch);
591 int gdb_reg_prefix_len = gdb_reg_prefix ? strlen (gdb_reg_prefix) : 0;
592 const char *gdb_reg_suffix = gdbarch_stap_gdb_register_suffix (gdbarch);
593 int gdb_reg_suffix_len = gdb_reg_suffix ? strlen (gdb_reg_suffix) : 0;
594 const char *reg_prefix;
595 const char *reg_ind_prefix;
596 const char *reg_suffix;
597 const char *reg_ind_suffix;
599 /* Checking for a displacement argument. */
602 /* If it's a plus sign, we don't need to do anything, just advance the
613 if (isdigit (*p->arg))
615 /* The value of the displacement. */
620 displacement = strtol (p->arg, &endp, 10);
623 /* Generating the expression for the displacement. */
624 write_exp_elt_opcode (&p->pstate, OP_LONG);
625 write_exp_elt_type (&p->pstate, builtin_type (gdbarch)->builtin_long);
626 write_exp_elt_longcst (&p->pstate, displacement);
627 write_exp_elt_opcode (&p->pstate, OP_LONG);
629 write_exp_elt_opcode (&p->pstate, UNOP_NEG);
632 /* Getting rid of register indirection prefix. */
633 if (stap_is_register_indirection_prefix (gdbarch, p->arg, ®_ind_prefix))
636 p->arg += strlen (reg_ind_prefix);
639 if (disp_p && !indirect_p)
640 error (_("Invalid register displacement syntax on expression `%s'."),
643 /* Getting rid of register prefix. */
644 if (stap_is_register_prefix (gdbarch, p->arg, ®_prefix))
645 p->arg += strlen (reg_prefix);
647 /* Now we should have only the register name. Let's extract it and get
648 the associated number. */
651 /* We assume the register name is composed by letters and numbers. */
652 while (isalnum (*p->arg))
655 len = p->arg - start;
657 regname = alloca (len + gdb_reg_prefix_len + gdb_reg_suffix_len + 1);
660 /* We only add the GDB's register prefix/suffix if we are dealing with
661 a numeric register. */
662 if (gdb_reg_prefix && isdigit (*start))
664 strncpy (regname, gdb_reg_prefix, gdb_reg_prefix_len);
665 strncpy (regname + gdb_reg_prefix_len, start, len);
668 strncpy (regname + gdb_reg_prefix_len + len,
669 gdb_reg_suffix, gdb_reg_suffix_len);
671 len += gdb_reg_prefix_len + gdb_reg_suffix_len;
674 strncpy (regname, start, len);
678 /* Is this a valid register name? */
679 if (user_reg_map_name_to_regnum (gdbarch, regname, len) == -1)
680 error (_("Invalid register name `%s' on expression `%s'."),
681 regname, p->saved_arg);
683 write_exp_elt_opcode (&p->pstate, OP_REGISTER);
686 write_exp_string (&p->pstate, str);
687 write_exp_elt_opcode (&p->pstate, OP_REGISTER);
692 write_exp_elt_opcode (&p->pstate, BINOP_ADD);
694 /* Casting to the expected type. */
695 write_exp_elt_opcode (&p->pstate, UNOP_CAST);
696 write_exp_elt_type (&p->pstate, lookup_pointer_type (p->arg_type));
697 write_exp_elt_opcode (&p->pstate, UNOP_CAST);
699 write_exp_elt_opcode (&p->pstate, UNOP_IND);
702 /* Getting rid of the register name suffix. */
703 if (stap_check_register_suffix (gdbarch, p->arg, ®_suffix))
704 p->arg += strlen (reg_suffix);
706 error (_("Missing register name suffix on expression `%s'."),
709 /* Getting rid of the register indirection suffix. */
712 if (stap_check_register_indirection_suffix (gdbarch, p->arg,
714 p->arg += strlen (reg_ind_suffix);
716 error (_("Missing indirection suffix on expression `%s'."),
721 /* This function is responsible for parsing a single operand.
723 A single operand can be:
725 - an unary operation (e.g., `-5', `~2', or even with subexpressions
727 - a register displacement, which will be treated as a register
728 operand (e.g., `-4(%eax)' on x86)
729 - a numeric constant, or
730 - a register operand (see function `stap_parse_register_operand')
732 The function also calls special-handling functions to deal with
733 unrecognized operands, allowing arch-specific parsers to be
737 stap_parse_single_operand (struct stap_parse_info *p)
739 struct gdbarch *gdbarch = p->gdbarch;
740 const char *int_prefix = NULL;
742 /* We first try to parse this token as a "special token". */
743 if (gdbarch_stap_parse_special_token_p (gdbarch))
744 if (gdbarch_stap_parse_special_token (gdbarch, p) != 0)
746 /* If the return value of the above function is not zero,
747 it means it successfully parsed the special token.
749 If it is NULL, we try to parse it using our method. */
753 if (*p->arg == '-' || *p->arg == '~' || *p->arg == '+')
757 /* We use this variable to do a lookahead. */
758 const char *tmp = p->arg;
760 /* Skipping signal. */
763 /* This is an unary operation. Here is a list of allowed tokens
767 - number (from register displacement)
768 - subexpression (beginning with `(')
770 We handle the register displacement here, and the other cases
772 if (p->inside_paren_p)
773 tmp = skip_spaces_const (tmp);
779 number = strtol (tmp, &endp, 10);
783 if (!stap_is_register_indirection_prefix (gdbarch, tmp, NULL))
785 /* This is not a displacement. We skip the operator, and deal
788 stap_parse_argument_conditionally (p);
790 write_exp_elt_opcode (&p->pstate, UNOP_NEG);
792 write_exp_elt_opcode (&p->pstate, UNOP_COMPLEMENT);
796 /* If we are here, it means it is a displacement. The only
797 operations allowed here are `-' and `+'. */
799 error (_("Invalid operator `%c' for register displacement "
800 "on expression `%s'."), c, p->saved_arg);
802 stap_parse_register_operand (p);
805 else if (isdigit (*p->arg))
807 /* A temporary variable, needed for lookahead. */
808 const char *tmp = p->arg;
812 /* We can be dealing with a numeric constant, or with a register
814 number = strtol (tmp, &endp, 10);
817 if (p->inside_paren_p)
818 tmp = skip_spaces_const (tmp);
820 /* If "stap_is_integer_prefix" returns true, it means we can
821 accept integers without a prefix here. But we also need to
822 check whether the next token (i.e., "tmp") is not a register
823 indirection prefix. */
824 if (stap_is_integer_prefix (gdbarch, p->arg, NULL)
825 && !stap_is_register_indirection_prefix (gdbarch, tmp, NULL))
827 const char *int_suffix;
829 /* We are dealing with a numeric constant. */
830 write_exp_elt_opcode (&p->pstate, OP_LONG);
831 write_exp_elt_type (&p->pstate,
832 builtin_type (gdbarch)->builtin_long);
833 write_exp_elt_longcst (&p->pstate, number);
834 write_exp_elt_opcode (&p->pstate, OP_LONG);
838 if (stap_check_integer_suffix (gdbarch, p->arg, &int_suffix))
839 p->arg += strlen (int_suffix);
841 error (_("Invalid constant suffix on expression `%s'."),
844 else if (stap_is_register_indirection_prefix (gdbarch, tmp, NULL))
845 stap_parse_register_operand (p);
847 error (_("Unknown numeric token on expression `%s'."),
850 else if (stap_is_integer_prefix (gdbarch, p->arg, &int_prefix))
852 /* We are dealing with a numeric constant. */
855 const char *int_suffix;
857 p->arg += strlen (int_prefix);
858 number = strtol (p->arg, &endp, 10);
861 write_exp_elt_opcode (&p->pstate, OP_LONG);
862 write_exp_elt_type (&p->pstate, builtin_type (gdbarch)->builtin_long);
863 write_exp_elt_longcst (&p->pstate, number);
864 write_exp_elt_opcode (&p->pstate, OP_LONG);
866 if (stap_check_integer_suffix (gdbarch, p->arg, &int_suffix))
867 p->arg += strlen (int_suffix);
869 error (_("Invalid constant suffix on expression `%s'."),
872 else if (stap_is_register_prefix (gdbarch, p->arg, NULL)
873 || stap_is_register_indirection_prefix (gdbarch, p->arg, NULL))
874 stap_parse_register_operand (p);
876 error (_("Operator `%c' not recognized on expression `%s'."),
877 *p->arg, p->saved_arg);
880 /* This function parses an argument conditionally, based on single or
881 non-single operands. A non-single operand would be a parenthesized
882 expression (e.g., `(2 + 1)'), and a single operand is anything that
883 starts with `-', `~', `+' (i.e., unary operators), a digit, or
884 something recognized by `gdbarch_stap_is_single_operand'. */
887 stap_parse_argument_conditionally (struct stap_parse_info *p)
889 gdb_assert (gdbarch_stap_is_single_operand_p (p->gdbarch));
891 if (*p->arg == '-' || *p->arg == '~' || *p->arg == '+' /* Unary. */
893 || gdbarch_stap_is_single_operand (p->gdbarch, p->arg))
894 stap_parse_single_operand (p);
895 else if (*p->arg == '(')
897 /* We are dealing with a parenthesized operand. It means we
898 have to parse it as it was a separate expression, without
899 left-side or precedence. */
901 p->arg = skip_spaces_const (p->arg);
904 stap_parse_argument_1 (p, 0, STAP_OPERAND_PREC_NONE);
908 error (_("Missign close-paren on expression `%s'."),
912 if (p->inside_paren_p)
913 p->arg = skip_spaces_const (p->arg);
916 error (_("Cannot parse expression `%s'."), p->saved_arg);
919 /* Helper function for `stap_parse_argument'. Please, see its comments to
920 better understand what this function does. */
923 stap_parse_argument_1 (struct stap_parse_info *p, int has_lhs,
924 enum stap_operand_prec prec)
926 /* This is an operator-precedence parser.
928 We work with left- and right-sides of expressions, and
929 parse them depending on the precedence of the operators
932 gdb_assert (p->arg != NULL);
934 if (p->inside_paren_p)
935 p->arg = skip_spaces_const (p->arg);
939 /* We were called without a left-side, either because this is the
940 first call, or because we were called to parse a parenthesized
941 expression. It doesn't really matter; we have to parse the
942 left-side in order to continue the process. */
943 stap_parse_argument_conditionally (p);
946 /* Start to parse the right-side, and to "join" left and right sides
947 depending on the operation specified.
949 This loop shall continue until we run out of characters in the input,
950 or until we find a close-parenthesis, which means that we've reached
951 the end of a sub-expression. */
952 while (*p->arg != '\0' && *p->arg != ')' && !isspace (*p->arg))
954 const char *tmp_exp_buf;
955 enum exp_opcode opcode;
956 enum stap_operand_prec cur_prec;
958 if (!stap_is_operator (p->arg))
959 error (_("Invalid operator `%c' on expression `%s'."), *p->arg,
962 /* We have to save the current value of the expression buffer because
963 the `stap_get_opcode' modifies it in order to get the current
964 operator. If this operator's precedence is lower than PREC, we
965 should return and not advance the expression buffer pointer. */
966 tmp_exp_buf = p->arg;
967 opcode = stap_get_opcode (&tmp_exp_buf);
969 cur_prec = stap_get_operator_prec (opcode);
972 /* If the precedence of the operator that we are seeing now is
973 lower than the precedence of the first operator seen before
974 this parsing process began, it means we should stop parsing
979 p->arg = tmp_exp_buf;
980 if (p->inside_paren_p)
981 p->arg = skip_spaces_const (p->arg);
983 /* Parse the right-side of the expression. */
984 stap_parse_argument_conditionally (p);
986 /* While we still have operators, try to parse another
987 right-side, but using the current right-side as a left-side. */
988 while (*p->arg != '\0' && stap_is_operator (p->arg))
990 enum exp_opcode lookahead_opcode;
991 enum stap_operand_prec lookahead_prec;
993 /* Saving the current expression buffer position. The explanation
994 is the same as above. */
995 tmp_exp_buf = p->arg;
996 lookahead_opcode = stap_get_opcode (&tmp_exp_buf);
997 lookahead_prec = stap_get_operator_prec (lookahead_opcode);
999 if (lookahead_prec <= prec)
1001 /* If we are dealing with an operator whose precedence is lower
1002 than the first one, just abandon the attempt. */
1006 /* Parse the right-side of the expression, but since we already
1007 have a left-side at this point, set `has_lhs' to 1. */
1008 stap_parse_argument_1 (p, 1, lookahead_prec);
1011 write_exp_elt_opcode (&p->pstate, opcode);
1015 /* Parse a probe's argument.
1019 LP = literal integer prefix
1020 LS = literal integer suffix
1022 RP = register prefix
1023 RS = register suffix
1025 RIP = register indirection prefix
1026 RIS = register indirection suffix
1028 This routine assumes that arguments' tokens are of the form:
1031 - [RP] REGISTER [RS]
1032 - [RIP] [RP] REGISTER [RS] [RIS]
1033 - If we find a number without LP, we try to parse it as a literal integer
1034 constant (if LP == NULL), or as a register displacement.
1035 - We count parenthesis, and only skip whitespaces if we are inside them.
1036 - If we find an operator, we skip it.
1038 This function can also call a special function that will try to match
1039 unknown tokens. It will return 1 if the argument has been parsed
1040 successfully, or zero otherwise. */
1042 static struct expression *
1043 stap_parse_argument (const char **arg, struct type *atype,
1044 struct gdbarch *gdbarch)
1046 struct stap_parse_info p;
1047 struct cleanup *back_to;
1049 /* We need to initialize the expression buffer, in order to begin
1050 our parsing efforts. The language here does not matter, since we
1051 are using our own parser. */
1052 initialize_expout (&p.pstate, 10, current_language, gdbarch);
1053 back_to = make_cleanup (free_current_contents, &p.pstate.expout);
1058 p.gdbarch = gdbarch;
1059 p.inside_paren_p = 0;
1061 stap_parse_argument_1 (&p, 0, STAP_OPERAND_PREC_NONE);
1063 discard_cleanups (back_to);
1065 gdb_assert (p.inside_paren_p == 0);
1067 /* Casting the final expression to the appropriate type. */
1068 write_exp_elt_opcode (&p.pstate, UNOP_CAST);
1069 write_exp_elt_type (&p.pstate, atype);
1070 write_exp_elt_opcode (&p.pstate, UNOP_CAST);
1072 reallocate_expout (&p.pstate);
1074 p.arg = skip_spaces_const (p.arg);
1077 /* We can safely return EXPOUT here. */
1078 return p.pstate.expout;
1081 /* Function which parses an argument string from PROBE, correctly splitting
1082 the arguments and storing their information in properly ways.
1084 Consider the following argument string (x86 syntax):
1088 We have two arguments, `%eax' and `$10', both with 32-bit unsigned bitness.
1089 This function basically handles them, properly filling some structures with
1090 this information. */
1093 stap_parse_probe_arguments (struct stap_probe *probe, struct gdbarch *gdbarch)
1097 gdb_assert (!probe->args_parsed);
1098 cur = probe->args_u.text;
1099 probe->args_parsed = 1;
1100 probe->args_u.vec = NULL;
1102 if (cur == NULL || *cur == '\0' || *cur == ':')
1105 while (*cur != '\0')
1107 struct stap_probe_arg arg;
1108 enum stap_arg_bitness b;
1110 struct expression *expr;
1112 memset (&arg, 0, sizeof (arg));
1114 /* We expect to find something like:
1118 Where `N' can be [+,-][1,2,4,8]. This is not mandatory, so
1119 we check it here. If we don't find it, go to the next
1121 if ((cur[0] == '-' && isdigit (cur[1]) && cur[2] == '@')
1122 || (isdigit (cur[0]) && cur[1] == '@'))
1126 /* Discard the `-'. */
1131 /* Defining the bitness. */
1135 b = (got_minus ? STAP_ARG_BITNESS_8BIT_SIGNED
1136 : STAP_ARG_BITNESS_8BIT_UNSIGNED);
1140 b = (got_minus ? STAP_ARG_BITNESS_16BIT_SIGNED
1141 : STAP_ARG_BITNESS_16BIT_UNSIGNED);
1145 b = (got_minus ? STAP_ARG_BITNESS_32BIT_SIGNED
1146 : STAP_ARG_BITNESS_32BIT_UNSIGNED);
1150 b = (got_minus ? STAP_ARG_BITNESS_64BIT_SIGNED
1151 : STAP_ARG_BITNESS_64BIT_UNSIGNED);
1156 /* We have an error, because we don't expect anything
1157 except 1, 2, 4 and 8. */
1158 warning (_("unrecognized bitness %s%c' for probe `%s'"),
1159 got_minus ? "`-" : "`", *cur, probe->p.name);
1166 /* Discard the number and the `@' sign. */
1170 arg.bitness = STAP_ARG_BITNESS_UNDEFINED;
1172 arg.atype = stap_get_expected_argument_type (gdbarch, arg.bitness);
1174 expr = stap_parse_argument (&cur, arg.atype, gdbarch);
1176 if (stap_expression_debug)
1177 dump_raw_expression (expr, gdb_stdlog,
1178 "before conversion to prefix form");
1180 prefixify_expression (expr);
1182 if (stap_expression_debug)
1183 dump_prefix_expression (expr, gdb_stdlog);
1187 /* Start it over again. */
1188 cur = skip_spaces_const (cur);
1190 VEC_safe_push (stap_probe_arg_s, probe->args_u.vec, &arg);
1194 /* Implementation of the get_probe_address method. */
1197 stap_get_probe_address (struct probe *probe, struct objfile *objfile)
1199 return probe->address + ANOFFSET (objfile->section_offsets,
1200 SECT_OFF_DATA (objfile));
1203 /* Given PROBE, returns the number of arguments present in that probe's
1207 stap_get_probe_argument_count (struct probe *probe_generic,
1208 struct frame_info *frame)
1210 struct stap_probe *probe = (struct stap_probe *) probe_generic;
1211 struct gdbarch *gdbarch = get_frame_arch (frame);
1213 gdb_assert (probe_generic->pops == &stap_probe_ops);
1215 if (!probe->args_parsed)
1217 if (can_evaluate_probe_arguments (probe_generic))
1218 stap_parse_probe_arguments (probe, gdbarch);
1221 static int have_warned_stap_incomplete = 0;
1223 if (!have_warned_stap_incomplete)
1226 "The SystemTap SDT probe support is not fully implemented on this target;\n"
1227 "you will not be able to inspect the arguments of the probes.\n"
1228 "Please report a bug against GDB requesting a port to this target."));
1229 have_warned_stap_incomplete = 1;
1232 /* Marking the arguments as "already parsed". */
1233 probe->args_u.vec = NULL;
1234 probe->args_parsed = 1;
1238 gdb_assert (probe->args_parsed);
1239 return VEC_length (stap_probe_arg_s, probe->args_u.vec);
1242 /* Return 1 if OP is a valid operator inside a probe argument, or zero
1246 stap_is_operator (const char *op)
1271 /* We didn't find any operator. */
1278 static struct stap_probe_arg *
1279 stap_get_arg (struct stap_probe *probe, unsigned n, struct gdbarch *gdbarch)
1281 if (!probe->args_parsed)
1282 stap_parse_probe_arguments (probe, gdbarch);
1284 return VEC_index (stap_probe_arg_s, probe->args_u.vec, n);
1287 /* Implement the `can_evaluate_probe_arguments' method of probe_ops. */
1290 stap_can_evaluate_probe_arguments (struct probe *probe_generic)
1292 struct stap_probe *stap_probe = (struct stap_probe *) probe_generic;
1293 struct gdbarch *gdbarch = stap_probe->p.arch;
1295 /* For SystemTap probes, we have to guarantee that the method
1296 stap_is_single_operand is defined on gdbarch. If it is not, then it
1297 means that argument evaluation is not implemented on this target. */
1298 return gdbarch_stap_is_single_operand_p (gdbarch);
1301 /* Evaluate the probe's argument N (indexed from 0), returning a value
1302 corresponding to it. Assertion is thrown if N does not exist. */
1304 static struct value *
1305 stap_evaluate_probe_argument (struct probe *probe_generic, unsigned n,
1306 struct frame_info *frame)
1308 struct stap_probe *stap_probe = (struct stap_probe *) probe_generic;
1309 struct gdbarch *gdbarch = get_frame_arch (frame);
1310 struct stap_probe_arg *arg;
1313 gdb_assert (probe_generic->pops == &stap_probe_ops);
1315 arg = stap_get_arg (stap_probe, n, gdbarch);
1316 return evaluate_subexp_standard (arg->atype, arg->aexpr, &pos, EVAL_NORMAL);
1319 /* Compile the probe's argument N (indexed from 0) to agent expression.
1320 Assertion is thrown if N does not exist. */
1323 stap_compile_to_ax (struct probe *probe_generic, struct agent_expr *expr,
1324 struct axs_value *value, unsigned n)
1326 struct stap_probe *stap_probe = (struct stap_probe *) probe_generic;
1327 struct stap_probe_arg *arg;
1328 union exp_element *pc;
1330 gdb_assert (probe_generic->pops == &stap_probe_ops);
1332 arg = stap_get_arg (stap_probe, n, expr->gdbarch);
1334 pc = arg->aexpr->elts;
1335 gen_expr (arg->aexpr, &pc, expr, value);
1337 require_rvalue (expr, value);
1338 value->type = arg->atype;
1341 /* Destroy (free) the data related to PROBE. PROBE memory itself is not feed
1342 as it is allocated on an obstack. */
1345 stap_probe_destroy (struct probe *probe_generic)
1347 struct stap_probe *probe = (struct stap_probe *) probe_generic;
1349 gdb_assert (probe_generic->pops == &stap_probe_ops);
1351 if (probe->args_parsed)
1353 struct stap_probe_arg *arg;
1356 for (ix = 0; VEC_iterate (stap_probe_arg_s, probe->args_u.vec, ix, arg);
1359 VEC_free (stap_probe_arg_s, probe->args_u.vec);
1365 /* This is called to compute the value of one of the $_probe_arg*
1366 convenience variables. */
1368 static struct value *
1369 compute_probe_arg (struct gdbarch *arch, struct internalvar *ivar,
1372 struct frame_info *frame = get_selected_frame (_("No frame selected"));
1373 CORE_ADDR pc = get_frame_pc (frame);
1374 int sel = (int) (uintptr_t) data;
1375 struct bound_probe pc_probe;
1376 const struct sym_probe_fns *pc_probe_fns;
1379 /* SEL == -1 means "_probe_argc". */
1380 gdb_assert (sel >= -1);
1382 pc_probe = find_probe_by_pc (pc);
1383 if (pc_probe.probe == NULL)
1384 error (_("No SystemTap probe at PC %s"), core_addr_to_string (pc));
1386 n_args = get_probe_argument_count (pc_probe.probe, frame);
1388 return value_from_longest (builtin_type (arch)->builtin_int, n_args);
1391 error (_("Invalid probe argument %d -- probe has %u arguments available"),
1394 return evaluate_probe_argument (pc_probe.probe, sel, frame);
1397 /* This is called to compile one of the $_probe_arg* convenience
1398 variables into an agent expression. */
1401 compile_probe_arg (struct internalvar *ivar, struct agent_expr *expr,
1402 struct axs_value *value, void *data)
1404 CORE_ADDR pc = expr->scope;
1405 int sel = (int) (uintptr_t) data;
1406 struct bound_probe pc_probe;
1407 const struct sym_probe_fns *pc_probe_fns;
1409 struct frame_info *frame = get_selected_frame (NULL);
1411 /* SEL == -1 means "_probe_argc". */
1412 gdb_assert (sel >= -1);
1414 pc_probe = find_probe_by_pc (pc);
1415 if (pc_probe.probe == NULL)
1416 error (_("No SystemTap probe at PC %s"), core_addr_to_string (pc));
1418 n_args = get_probe_argument_count (pc_probe.probe, frame);
1422 value->kind = axs_rvalue;
1423 value->type = builtin_type (expr->gdbarch)->builtin_int;
1424 ax_const_l (expr, n_args);
1428 gdb_assert (sel >= 0);
1430 error (_("Invalid probe argument %d -- probe has %d arguments available"),
1433 pc_probe.probe->pops->compile_to_ax (pc_probe.probe, expr, value, sel);
1438 /* Set or clear a SystemTap semaphore. ADDRESS is the semaphore's
1439 address. SET is zero if the semaphore should be cleared, or one
1440 if it should be set. This is a helper function for `stap_semaphore_down'
1441 and `stap_semaphore_up'. */
1444 stap_modify_semaphore (CORE_ADDR address, int set, struct gdbarch *gdbarch)
1446 gdb_byte bytes[sizeof (LONGEST)];
1447 /* The ABI specifies "unsigned short". */
1448 struct type *type = builtin_type (gdbarch)->builtin_unsigned_short;
1454 /* Swallow errors. */
1455 if (target_read_memory (address, bytes, TYPE_LENGTH (type)) != 0)
1457 warning (_("Could not read the value of a SystemTap semaphore."));
1461 value = extract_unsigned_integer (bytes, TYPE_LENGTH (type),
1462 gdbarch_byte_order (gdbarch));
1463 /* Note that we explicitly don't worry about overflow or
1470 store_unsigned_integer (bytes, TYPE_LENGTH (type),
1471 gdbarch_byte_order (gdbarch), value);
1473 if (target_write_memory (address, bytes, TYPE_LENGTH (type)) != 0)
1474 warning (_("Could not write the value of a SystemTap semaphore."));
1477 /* Set a SystemTap semaphore. SEM is the semaphore's address. Semaphores
1478 act as reference counters, so calls to this function must be paired with
1479 calls to `stap_semaphore_down'.
1481 This function and `stap_semaphore_down' race with another tool changing
1482 the probes, but that is too rare to care. */
1485 stap_set_semaphore (struct probe *probe_generic, struct objfile *objfile,
1486 struct gdbarch *gdbarch)
1488 struct stap_probe *probe = (struct stap_probe *) probe_generic;
1491 gdb_assert (probe_generic->pops == &stap_probe_ops);
1493 addr = (probe->sem_addr
1494 + ANOFFSET (objfile->section_offsets, SECT_OFF_DATA (objfile)));
1495 stap_modify_semaphore (addr, 1, gdbarch);
1498 /* Clear a SystemTap semaphore. SEM is the semaphore's address. */
1501 stap_clear_semaphore (struct probe *probe_generic, struct objfile *objfile,
1502 struct gdbarch *gdbarch)
1504 struct stap_probe *probe = (struct stap_probe *) probe_generic;
1507 gdb_assert (probe_generic->pops == &stap_probe_ops);
1509 addr = (probe->sem_addr
1510 + ANOFFSET (objfile->section_offsets, SECT_OFF_DATA (objfile)));
1511 stap_modify_semaphore (addr, 0, gdbarch);
1514 /* Implementation of `$_probe_arg*' set of variables. */
1516 static const struct internalvar_funcs probe_funcs =
1523 /* Helper function that parses the information contained in a
1524 SystemTap's probe. Basically, the information consists in:
1526 - Probe's PC address;
1527 - Link-time section address of `.stapsdt.base' section;
1528 - Link-time address of the semaphore variable, or ZERO if the
1529 probe doesn't have an associated semaphore;
1530 - Probe's provider name;
1532 - Probe's argument format
1534 This function returns 1 if the handling was successful, and zero
1538 handle_stap_probe (struct objfile *objfile, struct sdt_note *el,
1539 VEC (probe_p) **probesp, CORE_ADDR base)
1541 bfd *abfd = objfile->obfd;
1542 int size = bfd_get_arch_size (abfd) / 8;
1543 struct gdbarch *gdbarch = get_objfile_arch (objfile);
1544 struct type *ptr_type = builtin_type (gdbarch)->builtin_data_ptr;
1546 const char *probe_args = NULL;
1547 struct stap_probe *ret;
1549 ret = obstack_alloc (&objfile->per_bfd->storage_obstack, sizeof (*ret));
1550 ret->p.pops = &stap_probe_ops;
1551 ret->p.arch = gdbarch;
1553 /* Provider and the name of the probe. */
1554 ret->p.provider = (char *) &el->data[3 * size];
1555 ret->p.name = memchr (ret->p.provider, '\0',
1556 (char *) el->data + el->size - ret->p.provider);
1557 /* Making sure there is a name. */
1558 if (ret->p.name == NULL)
1560 complaint (&symfile_complaints, _("corrupt probe name when "
1562 objfile_name (objfile));
1564 /* There is no way to use a probe without a name or a provider, so
1565 returning zero here makes sense. */
1571 /* Retrieving the probe's address. */
1572 ret->p.address = extract_typed_address (&el->data[0], ptr_type);
1574 /* Link-time sh_addr of `.stapsdt.base' section. */
1575 base_ref = extract_typed_address (&el->data[size], ptr_type);
1577 /* Semaphore address. */
1578 ret->sem_addr = extract_typed_address (&el->data[2 * size], ptr_type);
1580 ret->p.address += base - base_ref;
1581 if (ret->sem_addr != 0)
1582 ret->sem_addr += base - base_ref;
1584 /* Arguments. We can only extract the argument format if there is a valid
1585 name for this probe. */
1586 probe_args = memchr (ret->p.name, '\0',
1587 (char *) el->data + el->size - ret->p.name);
1589 if (probe_args != NULL)
1592 if (probe_args == NULL
1593 || (memchr (probe_args, '\0', (char *) el->data + el->size - ret->p.name)
1594 != el->data + el->size - 1))
1596 complaint (&symfile_complaints, _("corrupt probe argument when "
1598 objfile_name (objfile));
1599 /* If the argument string is NULL, it means some problem happened with
1600 it. So we return 0. */
1604 ret->args_parsed = 0;
1605 ret->args_u.text = (void *) probe_args;
1607 /* Successfully created probe. */
1608 VEC_safe_push (probe_p, *probesp, (struct probe *) ret);
1611 /* Helper function which tries to find the base address of the SystemTap
1612 base section named STAP_BASE_SECTION_NAME. */
1615 get_stap_base_address_1 (bfd *abfd, asection *sect, void *obj)
1617 asection **ret = obj;
1619 if ((sect->flags & (SEC_DATA | SEC_ALLOC | SEC_HAS_CONTENTS))
1620 && sect->name && !strcmp (sect->name, STAP_BASE_SECTION_NAME))
1624 /* Helper function which iterates over every section in the BFD file,
1625 trying to find the base address of the SystemTap base section.
1626 Returns 1 if found (setting BASE to the proper value), zero otherwise. */
1629 get_stap_base_address (bfd *obfd, bfd_vma *base)
1631 asection *ret = NULL;
1633 bfd_map_over_sections (obfd, get_stap_base_address_1, (void *) &ret);
1637 complaint (&symfile_complaints, _("could not obtain base address for "
1638 "SystemTap section on objfile `%s'."),
1649 /* Helper function for `elf_get_probes', which gathers information about all
1650 SystemTap probes from OBJFILE. */
1653 stap_get_probes (VEC (probe_p) **probesp, struct objfile *objfile)
1655 /* If we are here, then this is the first time we are parsing the
1656 SystemTap probe's information. We basically have to count how many
1657 probes the objfile has, and then fill in the necessary information
1659 bfd *obfd = objfile->obfd;
1661 struct sdt_note *iter;
1662 unsigned save_probesp_len = VEC_length (probe_p, *probesp);
1664 if (objfile->separate_debug_objfile_backlink != NULL)
1666 /* This is a .debug file, not the objfile itself. */
1670 if (elf_tdata (obfd)->sdt_note_head == NULL)
1672 /* There isn't any probe here. */
1676 if (!get_stap_base_address (obfd, &base))
1678 /* There was an error finding the base address for the section.
1679 Just return NULL. */
1683 /* Parsing each probe's information. */
1684 for (iter = elf_tdata (obfd)->sdt_note_head;
1688 /* We first have to handle all the information about the
1689 probe which is present in the section. */
1690 handle_stap_probe (objfile, iter, probesp, base);
1693 if (save_probesp_len == VEC_length (probe_p, *probesp))
1695 /* If we are here, it means we have failed to parse every known
1697 complaint (&symfile_complaints, _("could not parse SystemTap probe(s) "
1704 stap_probe_is_linespec (const char **linespecp)
1706 static const char *const keywords[] = { "-pstap", "-probe-stap", NULL };
1708 return probe_is_linespec_by_keyword (linespecp, keywords);
1712 stap_gen_info_probes_table_header (VEC (info_probe_column_s) **heads)
1714 info_probe_column_s stap_probe_column;
1716 stap_probe_column.field_name = "semaphore";
1717 stap_probe_column.print_name = _("Semaphore");
1719 VEC_safe_push (info_probe_column_s, *heads, &stap_probe_column);
1723 stap_gen_info_probes_table_values (struct probe *probe_generic,
1724 VEC (const_char_ptr) **ret)
1726 struct stap_probe *probe = (struct stap_probe *) probe_generic;
1727 struct gdbarch *gdbarch;
1728 const char *val = NULL;
1730 gdb_assert (probe_generic->pops == &stap_probe_ops);
1732 gdbarch = probe->p.arch;
1734 if (probe->sem_addr != 0)
1735 val = print_core_address (gdbarch, probe->sem_addr);
1737 VEC_safe_push (const_char_ptr, *ret, val);
1740 /* SystemTap probe_ops. */
1742 static const struct probe_ops stap_probe_ops =
1744 stap_probe_is_linespec,
1746 stap_get_probe_address,
1747 stap_get_probe_argument_count,
1748 stap_can_evaluate_probe_arguments,
1749 stap_evaluate_probe_argument,
1752 stap_clear_semaphore,
1754 stap_gen_info_probes_table_header,
1755 stap_gen_info_probes_table_values,
1758 /* Implementation of the `info probes stap' command. */
1761 info_probes_stap_command (char *arg, int from_tty)
1763 info_probes_for_ops (arg, from_tty, &stap_probe_ops);
1766 void _initialize_stap_probe (void);
1769 _initialize_stap_probe (void)
1771 VEC_safe_push (probe_ops_cp, all_probe_ops, &stap_probe_ops);
1773 add_setshow_zuinteger_cmd ("stap-expression", class_maintenance,
1774 &stap_expression_debug,
1775 _("Set SystemTap expression debugging."),
1776 _("Show SystemTap expression debugging."),
1777 _("When non-zero, the internal representation "
1778 "of SystemTap expressions will be printed."),
1780 show_stapexpressiondebug,
1781 &setdebuglist, &showdebuglist);
1783 create_internalvar_type_lazy ("_probe_argc", &probe_funcs,
1784 (void *) (uintptr_t) -1);
1785 create_internalvar_type_lazy ("_probe_arg0", &probe_funcs,
1786 (void *) (uintptr_t) 0);
1787 create_internalvar_type_lazy ("_probe_arg1", &probe_funcs,
1788 (void *) (uintptr_t) 1);
1789 create_internalvar_type_lazy ("_probe_arg2", &probe_funcs,
1790 (void *) (uintptr_t) 2);
1791 create_internalvar_type_lazy ("_probe_arg3", &probe_funcs,
1792 (void *) (uintptr_t) 3);
1793 create_internalvar_type_lazy ("_probe_arg4", &probe_funcs,
1794 (void *) (uintptr_t) 4);
1795 create_internalvar_type_lazy ("_probe_arg5", &probe_funcs,
1796 (void *) (uintptr_t) 5);
1797 create_internalvar_type_lazy ("_probe_arg6", &probe_funcs,
1798 (void *) (uintptr_t) 6);
1799 create_internalvar_type_lazy ("_probe_arg7", &probe_funcs,
1800 (void *) (uintptr_t) 7);
1801 create_internalvar_type_lazy ("_probe_arg8", &probe_funcs,
1802 (void *) (uintptr_t) 8);
1803 create_internalvar_type_lazy ("_probe_arg9", &probe_funcs,
1804 (void *) (uintptr_t) 9);
1805 create_internalvar_type_lazy ("_probe_arg10", &probe_funcs,
1806 (void *) (uintptr_t) 10);
1807 create_internalvar_type_lazy ("_probe_arg11", &probe_funcs,
1808 (void *) (uintptr_t) 11);
1810 add_cmd ("stap", class_info, info_probes_stap_command,
1812 Show information about SystemTap static probes.\n\
1813 Usage: info probes stap [PROVIDER [NAME [OBJECT]]]\n\
1814 Each argument is a regular expression, used to select probes.\n\
1815 PROVIDER matches probe provider names.\n\
1816 NAME matches the probe names.\n\
1817 OBJECT matches the executable or shared library name."),
1818 info_probes_cmdlist_get ());