Next: Tracepoint Conditions, Previous: Enable and Disable Tracepoints, Up: Commands to Set Tracepoints [Contents][Index]

#### 13.1.3 Tracepoint Passcounts

`passcount [n [num]]`

  Set the passcount of a tracepoint. The passcount is a way to automatically stop a trace experiment. If a tracepoint’s passcount is n, then the trace experiment will be automatically stopped on the n’th time that tracepoint is hit. If the tracepoint number num is not specified, the `passcount` command sets the passcount of the most recently defined tracepoint. If no passcount is given, the trace experiment will run until stopped explicitly by the user.

  Examples:

      (gdb) passcount 5 2 // Stop on the 5th execution of

                                         // tracepoint 2

      (gdb) passcount 12  // Stop on the 12th execution of the

                                         // most recently defined tracepoint.

      (gdb) trace foo
      (gdb) pass 3
      (gdb) trace bar
      (gdb) pass 2
      (gdb) trace baz
      (gdb) pass 1        // Stop tracing when foo has been

                                          // executed 3 times OR when bar has

                                          // been executed 2 times

                                          // OR when baz has been executed 1 time.