docs: add missing " * " line for tapset doc extraction tool

Merge branch 'master' of ssh://sourceware.org/git/systemtap

Conflicts:
NEWS
session.cxx
session.h

PR 11441 - continue with unprivileged test suite

- New unprivileged_all.exp replaces previously existing unprivileged
  mode test suites.
- Tests all known probe point types for expected success/failure for
  unprivileged users.
- Checks the above directly and also using an alias.
- Checks that all known probe point types have been tested (uses
  --dump-probe-types).

PR 13057 Provide a Command Line Option to Dump Supported Probe Points

New command line option, --dump-probe-types, has been added. If
--unprivilged is also specified, the dump will be limited to
probe types available to unprivileged users.

Fix pr10678.stp failure if system doesn't have ne2k-pci module.

Change from Han Pingtian <phan@redhat.com>

* testsuite/buildok/pr10678.stp: Just use a begin probe if the ne2k_pci
  module doesn't exist.

Correct atomic.stp documentation comments. They should be sfunction.

add copyright/license blurb to process/schedtimes.stp sample

Requested-By: Jason Baron <jbaron@redhat.com>

Default --disable-sdt-probes for  gcc version 3

    * configure.ac: Check for the function ppoll.
    * configure, config.in: Regenerate.

Convert 4 autoconf tests to exportconf tests.

* buildrun.cxx (output_dual_exportconf): New function.
(compile_pass): Converted several autoconf tests to exportconf tests.
* runtime/autoconf-probe-kernel.c: Removed unneeded autoconf test.
* runtime/autoconf-synchronize-sched.c: Ditto.
* runtime/autoconf-unregister-kprobes.c: Ditto.
* runtime/autoconf-vm-area.c: Ditto.

Document atomic.stp and add to the SystemTap Tapset Reference Manual.

PR13101 Add linuxmib-filter-default.stp to Tapset Reference Manual.

PR13101 Add ipmib-filter-default.stp to documentation.

Add documentation comments to inet_sock.stp

Document and relocate information about default tcpmib_filter_key function.

PR13101 Add structured comments to document rpc.stp.

Add documentation comments to nfs_proc.stp.

Fixed PR13055 by getting procfs probes working on 3.1 kernels.

* runtime/procfs.c (_stp_rmdir_proc_module): Fix problem where
  '/proc/systemtap' wasn't getting removed correctly.
  (_stp_mkdir_proc_module): Add support for kernels where neither
  path_lookup() or kern_path_parent() are exported (such as the 3.1
  kernels).
* buildrun.cxx (compile_pass): Convert compile test for kern_path_parent()
  to an export test.  Add exports tests for path_lookup() and
  vfs_path_lookup().
* runtime/autoconf-kern-path-parent.c: Removed.

Update parse_kernel_exports() for RHEL4.

* main.cxx (parse_kernel_exports): Now handles RHEL4 (2.6.9) kernels
  correctly, whose 'Modules.symvers' file only has 3 tokens per line.

debian bug#604453: tweak new blacklist items to exploit regexps

debian bug#604453: add more items to kprobe blacklist

Add documentation comments to inet.stp.

Initial checkin of nfsd.stp documentation.

Add tapset reference manual description for nfsderrno.stp.

PR13078: Support stap --remote unix:/path sockets

* remote.cxx (unix_stapsh): New, connects to an AF_UNIX socket.
  (stapsh::get_reply): Deal with possible stapsh stderr chatter.
  (stapsh::handle_poll): Rework to handle some corner cases better,
  like having the same fd for in and out.
* testsuite/systemtap.base/stapsh-unix.exp: New test using socat.
* testsuite/systemtap.base/stapsh-unix.stp: New test.

Add "documentation" for cpu parameter to tapset/timestamp_monotonic.stp.

Reorder the nfs tapset entries to group nfsd material together.

Add the structure comments for tapset reference manual to nfs.stp

Initialize POD members that were previously uninitialized

* coveragedb.h: initialize type in coverage_element
* csclient.h: initialize argc in compile_server_client
* dwflpp.cxx: initialize blacklist_func, blacklist_func_ret,
              and blacklist_file in dwflpp
* dwflpp.h: initialize entrypc in func_info
* elaborate.cxx: initialize num_newly_resolved, num_still_unresolved,
                 assert_resolvability and t in typeresolution_info
* session.cxx: initialize automatic_server_mode in systemtap_session
* staptree.cxx: initialize privileged in probe, tok in component,
                and epilogue_style in probe_alias
* staptree.h: initialize num_index and expr_index in component
* tapset-utrace.cxx: initialize has_library in derived_probe
* tapsets.cxx: initialize has_process and has_library in
               dwarf_derived_probe, has_library in base_query,
               has_relative, relative_val, choose_next_line, and
               entrypc_for_next_line in dwarf_query, op in
               var_expanding_visitor and probe_type, probe_loc,
               probe_scn_offset, probe_scn_addr, arg_count, base,
               and semaphore in sdt_query
* translate.cxx: initialize action_counter and
                 probe_or_function_needs_deref_fault_handler in
                 c_unparser

Really old kprobes didn't have a symbol_name field, autoconf it.

kprobes on addresses do just work and can now be build.
symbol_named kprobes now get a registration warning if the
symbol_name field isn't available.

PR1277 cont'd: NEWS and man page entry

PR6961 - backtrace from non-pt_regs probe context

When printing a kernel backtrace use the kernel dump_trace if available.
If the kernel is compiled with frame pointers we can guess the stack
pionter pretty reliably, otherwise let dump_stack figure it out and
skip some of the framework stack frames before starting the print the
remaining stack.

PR13103 substr 3 argument length description is wrong.

PR11209: Add cpu_clock and local_clock

This adds cpu_clock_ns(cpu), local_clock_ns(), and their coarser
variants.  These are monotonic wallclock time sources, rather than the
absolute time-since-epoch sort.  On kernels too old for these functions,
it falls back to stap's gettimeofday.

A kernel supports this only if it has the functions exported, and if it
is deemed new enough to have the patches that make it NMI-safe.  See the
comment in timestamp_monotonic.stp for details.

* buildrun.cxx: Add export checks for cpu_clock and local_clock.
* tapset/timestamp_monotonic.stp: Define the new functions.
* testsuite/buildok/timestamp_monotonic-embedded.stp: Build them.
* doc/SystemTap_Tapset_Reference/tapsets.tmpl: Include the new docs.

Testsuite Improvements.

Previously, server.log and the server certificates were cleared each
time a server was started. Clearing them once per test run instead
allows the log of all servers started during testing to be examined
after the tests are finished. It also ensures that the same server
certificates are used by all servers started during testing.

Check ix is not NULL before dereferencing for both cases

staptree.cxx: add the assert and remove the (now) redundant portion
              of the conditional.

doc: correct chapter heading for function::system

PR12773 cont'd: Added --download-debuginfo= option

 Possible values for option:

 'yes':      Automatically download debuginfo - no timeout.
             Also, if no value is given to the option, it
             is the same as this.
 'no':       Do not automatically download debuginfo. Also
             if the option is not specified at all, it
             defaults to this.
 'ask':      Show output from abrt, including file size of
             needed debuginfo, and make it wait for user
             input before downloading.
 '<number>'  A positive number, in seconds, to represent
             the timeout to use when downloading. If the
             download takes longer than this, it will
             abort the download.

 **NOTE** Due to a few bugs in abrt, both the 'ask' feature
 and the 'timeout' feature will not work properly. In terms
 of the 'ask feature (BZ726192), it will ask the user, but
 abrt then assumes 'yes' right away and continues the
 download. When this is fixed in abrt, stap should function
 properly. In terms of the timeout feature (BZ730107), stap
 does stop if a timeout occurs, but the download process
 continues to completion.

warn_overflow.exp: Add -DMAXSKIPPED=9999 to prevent false failures.

The syscall.* probe handlers try to overflow the cmd message buffers
which might take some time, so add -DMAXSKIPPED=9999 to not error
out because some probes take too long.

Bug 11859 - print_ubacktrace() prints kretprobe addresses

runtime/stack.c (_stp_stack_print): Check whether we are printing a user
or kernel stack, only handle [ku]retprobe addresses if the "right" kind.

Reintroduce timer for transport cmd channel, don't wake_up unconditionally.

Revert parts of commit a85c8a "runtime/io.c: Explicitly signal setting of
_stp_exit_flag" and commit 46ac9e "Remove _stp_ctl_work_timer from module
transport layer". Introduce a new test wake_up.exp that shows a deadlock
when sending cmd messages and waking up the reader immediately.

Renamed _stp_ctl_write to _stp_ctl_send, which can be called from
everywhere. Rename _stp_ctl_send to _stp_ctl_send_notify that can be
called from user context in the transport layer itself (this will
immediately notify any readers). Document all places that use
_stp_ctl_send_notify directly to clarify why that is safe.

See http://sourceware.org/ml/systemtap/2011-q3/msg00163.html

translate symbol/unwind extraction: shrink output

* translate.cxx (dump_unwindsyms): Use plain decimal formatting
  instead of 0xFF hex for bulk data, to save 1-3 bytes of C source per
  byte.

Add a compat #define FIELD_SIZEOF

This was added in kernel 2.6.18.  RHEL4 backported this definition, but
it was reported missing in another enterprise distro.  It's an easy
one-line definition to add for compatibility though.

tweak wording of SYSTEMTAP_DEBUGINFO_PATH env var

Update testsuite configury to autoconf 2.68 too

update autoconf files for 2.68

PR11775: Add more tapsets to the tapsets.tmpl file

doc/SystemTap_Tapset_Reference/tapsets.tmpl: Added tapsets and Network
File Storage chapter

Makefile: Add an srpm target

This target prepares a source rpm without doing a build, useful for
feeding into other build tools, like mock.

Implement and use select to wait for cmd channel data.

Add a poll implementation to runtime/transport/control.c
(_stp_ctl_poll_cmd) based on the _stp_ctl_ready_q wait queue.
Check whether select is supported in runtime/staprun/mainloop.c
(stp_main_loop) and use pselect with a sigmask that includes
SIGURG to get EINTR notifications whenever an interruptable
event occurred.

runtime/io.c: Explicitly signal setting of _stp_exit_flag.

Call wake_up_interruptible(&_stp_ctl_wq) in _stp_exit()
to signal possible waiters in _stp_ctl_read_cmd().

Remove _stp_ctl_work_timer from module transport layer.

The _stp_ctl_work_timer would trigger every 20ms to check whether
there were cmd messages queued, but not announced yet and to
check the _stp_exit_flag was set.

This commit makes all control messages announce themselves and
check the _stp_exit_flag in the _stp_ctl_read_cmd loop (delivery
is still possibly delayed since the messages are just pushed on
a wait queue).

Add the func_time_stats.stp to the index.

Add the func_time_stats.stp example.

Clean up func_time_stats information.

ucontext.stp: Remove STP_NEED_VMA_TRACKER, done through pragma:vma.

man: Convert 3-column table to 2-column table in stapprobes

This patch fixes the following error:

$ MANWIDTH=80 man stapprobes > /dev/null
warning: file `<standard input>', around line 105:
  table wider than line width

man: Add spaces after commas in tapset::nfsd

This patch fixes the following error:

$ MANWIDTH=80 man tapset::nfsd > /dev/null
<standard input>:419: warning [p 6, 10.5i]: cannot adjust line

man: Escape backslash properly in tapset::snmp

This patch fixes the following error:

$ man tapset::snmp > /dev/null
<standard input>:128: a space character is not allowed in an escape name

Fix the uprobes.ko path when used with remotes

When uprobes.ko is sent through stapsh, it will go in a temp path that
only stapsh knows.  However, we were sending -u/path/to/uprobes.ko with
a client side path, which would only work for --remote localhost.  :/
Now the path is sanitized to ./ for the stapsh working directory.

* buildrun.cxx (make_run_command): Take a remotedir instead of a module
  name.  When set, use it to normalize both the uprobes and module path.
  Also check versions that a uprobes path is even supported (>=1.4).
* remote.cxx (stapsh::start): The remotedir is simply "." for stapsh.
  (ssh_legacy_remote:start): The remotedir is the known from the prior
  mktemp -d.  Also start sending the module signature across, add a note
  why we unfortunately can't send uprobes in legacy mode, and specify
  the staprun command without any path in case the remote is different.

Be more explicit about when the session needs symbol data. pragma:symbols.

Introduce /* pragma:symbols */ which is added to those tapset functions
that use print_addr or print_stack with symbol resolving. Now we no longer
have to output the symbol tables at translate time if unnecessary.
Although we could do even less work (see the new comment in translate.cxx).

Only collect and emit unwind data in translator if the session needs it.

When we hit the translator the session already knows whether or not it
will possibly need the unwind data. Only collect and emit it, if the
session does. This can save writing out tens of MB to stap-symbols.h
for simple scripts that never call any backtrace() function.

Remove preempt_disable from unwind hotpath.

We only need to preempt_disable when we fail to find a kernel module to
unwind through so we can call __module_text_address.

Add the nfsd_unlink example to the index.

Add the nfsd_unlink.stp example.

Revert "Add the nfsd_unlink.stp example."

This reverts commit 2b44a2e7b73d5e1d3b433e01fdb3c732db986369.

Add the nfsd_unlink.stp example.

PR 11441: stap-server Roadmap to Legitimacy - New unprivileged test cases.

Run the buildok tests with --unprivileged and check that the expected tests
pass or fail.

Make sure that ".stp" is at the end of the file name for the check.

i18n: fix missing \n typo from -vvv message

PR12773: Fixed Test Suite Regressions

PR12773: Fixed NULL check - no longer aborts

PR12773: Use abrt to download and install debuginfo

dwflpp.cxx
  In setup_user(), pass the session to setup_dwfl_user().

setupdwfl.cxx
  Added internal_find_debuginfo() and
  execute_abrt_action_install_debuginfo_to_abrt_cache() to call
  abrt to automatically download and install the needed debuginfo.

setupdwfl.h
  Added function declarations.

util.h
  Added hex_dump() to convert a binary string to a hex string.

Relax -G regexp slightly to allow 1-char variable names

sdt*exp: When the compiler doesn't recognize flag, mark test as UNTESTED.

Older gcc compilers don't recognize all the -std=[c|gnu]++0x flags we
throw at them. Instead of marking these compilations as FAIL, mark them
as UNTESTED now, so we only see real FAILures in the result (there are
still a couple left against -pedantic).

Add NULL context when creating perf event counter, remove nmi from handler.

More fallout of kernel commit 4dc0da "perf: Add context field to perf_event"
and commit a8b0ca "perf: Remove the nmi parameter from the swevent and
verflow interface". And new autoconf checks for both.

proc_mem.stp: Always use atomic counters with kernel 3.1 or higher.

Kernel commit 172703 "mm: delete non-atomic mm counter implementation"
did away with the non-atomic variant of mm_struct rss_stat->count[member].

Add destructor to struct block and delete statements to avoid scope leaks

* staptree.h: Add destructor to struct block
* elaborate.cxx: Add delete statements to add_global_var_display

Check for hw_breakpoint context argument.

Kernel commit 4dc0da8 "perf: Add context field to perf_event" added
a new void *context field to the register_*_hw_breakpoint() functions.
Detect with a new runtime/autoconf-hw_breakpoint_context.c plus
STAPCONF_HW_BREAKPOINT_CONTEXT conditional.

context-unwind.stp: More STAPCONF_UPROBE_GET_PC wrapping.

runtime/stack.c: Wrap GET_PC_URETPROBE_NONE in #ifdef STAPCONF_UPROBE_GET_PC

Move the comment for STP_MAX_PROCFS_FILES closer

vim: bump the date and use a generic email contact

Use $dfd not $mode in testsuite/transok/tval-opt.stp.

Kernel commit 47c805 "switch do_filp_open() to struct open_flags"
changed the arguments of do_filp_open. Use another int argument
that hasn't changed in testcase.

Check whether syscalls2.stp sigprocmask argument is set or nset.

kernel commit b013c3 "signal: cleanup sys_sigprocmask()" renamed the set
parameter to nset. commit bb7efe "signal: cleanup sys_rt_sigprocmask()"
did the same. Check with @defined($set) to see if we want the old or
new definition.

Fix autoconf-ring_buffer_lost_events.c compile warning.

Newer GCC will warn about the event variable not being used,
making this test fail. Just remove the 'event' variable.

testsuite warn_overflow be more precise and a bit more lenient.

log exactly once for syscall probe hit and counter i == 256.
But do allow more than 3 overflow warning messages to occur
in case stap miraculously recovers and overflows immediately
afterwards.

testsuite warnings.stp: match all lines in bio_init@fs/bio.c:*.

Since we aren't actually interested in the probe itself, and
different kernels have different lines that can be probed, just
match them all.

Merge branch 'master' of git://sourceware.org/git/systemtap

Add pattern_root to destructor

* session.cxx: add delete pattern_root to ~systemtap_session()

probe_type: make unexpected types an error for probe_type()

implicitptr.exp: Add implicitptr.exp to test_flags.

Previously the testcase wouldn't compile unless the system had sys/sdt.h.

common_probe_context.h: Put Individual Probe State (ips) into a union.

Various probe handlers have dedicated fields in the common probe context
struct. Since the handlers cannot be active at the same time (on the same
cpu) these can just be put into a union to save space. In runtime code
when there might be ambiguity about which probe handler is running, the
CONTEXT->probe_type field can be used to check which field has actual
life data.

Add probe_type to common probe context.

This exposes the type of probe handler for use in runtime functions,
so they can better anticipate which common probe context is valid at
runtime. Also introduces a new context tapset function probe_type()
that exposes a (informational) probe handler string to scripts. Mainly
useful for debugging, when the user wants to find out which kind of
low level probe handler a high-level probe translates to for a particular
kernel/systemtap version.

Add destructor to struct dwarf_pretty_print

*tapsets.cxx: add destructor to deallocate ts

Remove old context.stp uaddr() comment.

PR10080 was resolved and we no have  VDSO tracking support.

Remove old comment in kretprobe handler.

c->ri -inst is saved just above the old comment.

PR12135: Pretty-print should skip masked inherited members

* tapsets.cxx (dwarf_pretty_print::recurse_struct_members): Traverse
  inheritance breadth-first, and remember shallower names printed.
* testsuite/systemtap.base/inherit.*: Add pretty-printing to the test.

PR12135: Discard inheritance "dupes" in suggested alternatives

* dwflpp.cxx (dwflpp::print_members): Track already seen members in a
  set, so we don't print names twice (as with masked inherited members).

PR12135: Prefer subclass members if they mask the superclass

* dwflpp.cxx (dwflpp::find_struct_member): Use a breadth-first search
  through inheritance trees, so masked members will be pulled from the
  subclass rather than the superclass.
* testsuite/systemtap.base/inherit.*: New test for inheritance games.

Probe context data field is only used for procfs. Rename to procfs_data.

itrace and mark probes would also scribble (useless) data into this
context field, without ever using it, for no apparent reason, except
that they had "data" around. Renamed the field to procfs_data to make
clear it has a specific purpose.

Also add documentation for remaining undocumented common_probe_context fields.

Restore stream state

* util.h: retore stream state back to std::dec