update documentation using scripts/update-doc

update copyright year using scripts/update-copyright

PRERELEASE marker updates

prerelease: regenerate update-po

No more sapce anywhere

configury BuildRequire: need only dyninst 10.0

Save entire register set for dyninst runtime on aarch64 and ppclle

Dyninst generated calls only allow register parms, so save register set in
chunks via successive calls to enter_dyninst_uprobe_regs:
arg1 = probe index arg2 = first regno in registers arg3... registers

* runtime/dyninst/uprobes-regs.c (enter_dyninst_uprobe_regs):  New
* stapdyn/mutatee.cxx (get_dwarf_registers):  Add aarch sp.  Don't prune
   ppcle and aarch64 register set.
  (mutatee::instrument_dynprobe_target):  Add dyninst snippet to generate
   calls to enter_dyninst_uprobe_regs

session.cxx tested-kernel-versions liste: drop rhel5 2.6.18

It's been a long time since we tested on rhel5; our c++11
transition probably nuked effective support.

AUTHORS bump

buildrun.cxx: adapt to kernel 5.4+

Tracequery module building can't take the pre-5.4 _modules_/FOO
shortcut to building only the .o files any more.

correct filename in syscallsrw.stp description

update NEWS for PR24953

runtime/tapset: gcc9 /*fallthrough*/ pass

Mark up a few more locations where gcc9 on fedora rawhide has
had a cow about intentional fallthroughs in switch/case statements.

testsuite/busybox.exp: tweak

Run inferior make only partially, to build the target binary
and not any aux doc stuff (which buildrequires pod2html e.g.).
Tweak separate pass/fail messages to disambiguate $test.

configury: default to --enable-pie

On fedora rawhide, -fpic/-fpie flags are sneaking in all over
the place, so plain configure/make stap builds can break if
we don't build everything that way too.  So flip around --enable-pie
to default-on.  Sorry, PR9922 (2009).

relevant to PR25168: add user_string to bpf tapsets, x86_64 only

previously noted https://lwn.net/Articles/803587/

After some discussion with fche, I added user_string() but for x86_64 only.
After bpf_probe_read_user() helpers are added, can extend to other architectures.

* tapset/bpf/conversions.stp (kernel_string, kernel_string_n):
  note probe_read_str() future deprecation, fix error msg.
* tapset/uconversions.stp (user_string_n): add BPF variants.
(user_string_n_warn): add BPF variant.
* testsuite/systemtap.bpf/bpf.exp: launch /usr/bin/sleep to probe start of main().
* testsuite/systemtap.bpf/bpf_tests/user_string.stp: new testcase.

PR25174: support string auto-concat more thoroughly

The @const, @var, and @cast operators took strings that were not
subject to the usual auto-concatenation of adjacent string literals.
Fixed by calling consume_string_literals() in parser::expect_unknown().
(Sibling functions nearby are not called with tok_string so are
currently unaffected.)

runtime gen-map.c: add /* fallthru */ to satisfy gcc 9's -Wimplicit-fallthrough

stapbpf PR25169 initial fix: strcpy overlap between transport arg and string on-stack

PR24812: support order-parametrized begin/end probes

It was found that begin probes were already order parameterized but,
end probes were not. The end probes were being added using a reverse
iterator which made them run in the wrong order. This patch fixes
this by replacing the reverse iterator with a normal iterator.

1) Replaced reverse iterator with normal iterator.
2) Added testcase which checks for correct running order.
3) Updated NEWS.

PR25133: fix stabpf foreach loop segfault

There was a foreach loop example that was observed to cause a
segmentation fault. After some investigation, it was found that
one of the registers was clobbered in the optimization process.

This patch modifies the register interference implementation.
Previously, variables that were defined at an instruction were
not considered in the register interference graph. However, by
defintion, a variable is live where it is defined and wherever
it holds a value that is used in the future. With this patch,
the register interference graph also takes into account where
the variables are defined, and considers them to be live.

1) Included variables that are being defined in live set.
2) Split foreach_string.stp test probes to accomodate for stack size.

PR24953 Fix: check for existence of value symbol

In commit 724b7014a, the code assumed that the foreach loop
structure always had a valid value symbol. However, this is
not true. Consider the following examples:

foreach loop (k in arr) ...
foreach loop (v = k in arr) ...

In the former case, the loop is only iterating over the keys
whereas in the latter case, both the key and value are being
iterated over. Consequently, the former loop will have a
nullptr value symbol.

This patch provides a fix by checking for the existence of a
value symbol and generating the BPF instructions accordingly.

Revert some parts of commit 1d3e6fd90

Some of the bpf-translation.cxx code was deleted accidentally. This
caused the raw_tracepoint1.stp test to fail as the context variables
could not be resolved.

PR25113: correct typo in beginner's guide

A sample file name was incorrect in the text.

PR25107: -v -L options print duplicate probe points

With this option combination, duplicate probe points are now included
along with their PC addresses which act as discriminators. For example,
a probe that refers to a function that is inlined in multiple places
will appear multiple times in the output with different PC addresses.

1) Modified functionality of -v -L option combination.
2) Nested printing can now be disabled in printsig(...).

configure.ac :: default --with-python3=auto to handle Python3-only systems

add test to examine impact of LTO on debuginfo

The test uses BusyBox binaries which are compiled with (-g) and
(-g -flto -ffat-lto-objects). It can be observed that when LTO
is enabled, SystemTap is unable to probe some functions and that
some probe points have source file name mismatches.

rhbz1741831: support arm64 with linux/sched.h include order

On some arm64 kernels, <linux/sched.h> needs to be #include'd
ahead of <asm/*> bits in our autoconf-* tests, or else things
break.  New variant tested on these kernels plus x86-64 f30.

stapbpf PR23478:: Initial support to allow use of multi-dimensional arrays.

The patch allows multi-dimensional arrays to be used lhs and rhs
expression.  It also allows deletion and check of existence of
particular elements with multi-dimensional key values.  However, this
patch does not support foreach statements with multi-dimensional
arrays.  Now something like the following trivial example works with
the bpf backend:

 sudo ../install/bin/stap --bpf   -v -e 'global x; probe begin{ x[4,2] = 2; x[2,4]= -2; exit()} probe end{ printf("%d ", x[4,2]); printf("%d ", x[3,3]); printf("%d ", x[2,4])}'
Pass 1: parsed user script and 51 library scripts using 250084virt/23932res/9000shr/14756data kb, in 10usr/0sys/15real ms.
Pass 2: analyzed script: 2 probes, 3 functions, 0 embeds, 1 global using 250084virt/23932res/9000shr/14756data kb, in 0usr/0sys/0real ms.
Pass 3: pass skipped for stapbpf runtime in 0usr/0sys/0real ms.
Pass 4: compiled BPF into "stap_29813.bo" in 0usr/0sys/0real ms.
Pass 5: starting run.
2 0 -2 Pass 5: run completed in 0usr/0sys/3real ms.

tweak stap --help text

Fix a typo.

PR24953: fix foreach (v = v1 in arr) loop behaviour

Previously, keys were correctly propagated to foreach loops, however,
values were defaulted to 0. The new implementation allows values to
be propagated along with the keys.

1) Added instructions to load corresponding values.
2) Added block to check for invalid key/value pairs.
3) Added test which checks for correct key/value pairs.

Revise inodewatch2.stp to work on a wider range of kernels and filesystems

The inodewatch2.stp instrumented specific functions that actually
changed the the mode of the inode.  Depending on the file system used
the orginally instrumented functions would miss chmod operations on
some file systems.  Moved the instrumentation to the common
notify_change function that all the operations go through.

cache.cxx: fix 64-bit time_t differently

Always narrow %ld parameter to (long) instead of
conditional-compilation alternatives.

configury: regenerate after configure.ac changes

cache.cxx: Fix errors on x32 builds

Fix time_t print because in x32 ABI is long long int instead of long int.

Signed-off-by: Aníbal Limón <anibal.limon@linux.intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>

configure: Remove explicit msgfmt check

There is no need to explicitly check that msgfmt was found as the gettext macros
handle this for us if NLS is enabled.

Signed-off-by: Ross Burton <ross.burton@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>

configure: Allow explicit configuration of the monitor

Add an option to explicitly disable the monitor (and therefore the dependency on
json-c and ncurses) with the aim of deterministic builds.

Signed-off-by: Ross Burton <ross.burton@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>

configure: Allow to disable libvirt

Rather than just autodetecting libvirt allow it to be explictly disabled even
if present (important for reproducibile builds).

Signed-off-by: Wenzong Fan <wenzong.fan@windriver.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>

runtime: 5.2 and later kernels removed get_ds() on arm and other architectures

https://github.com/torvalds/linux/commit/736706bee3298208343a76096370e4f6a5c55915

Add in a fallback so systemtap works on arm in these cases.

Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>

buildrun: adapt to loss of "flags" filter in linux scripts/Kbuild.include

This $(call filter,...) was used since 2008 to pass KBUILD_CFLAGS
through a mechanism that preserved O= data somehow.  But this
filter is gone from the kernel as of commit cdd750bf, so add a
fallback for the filtered $KBUILD_CFLAGS directly.

Reported-By: RP on #systemtap

PR24947, PR24946: check for valid hex and octal sequences

Hex escape sequences no longer causes scripts to crash on stapbpf,
and checks have been added to ensure valid sequence ranges.

1) Fixed incorrect looping of hex sequences.
2) Added octal sequence range check: o < \400.
3) Added hex sequence range check: h < \x100.

PR23285 (2): enable prometheus-exporter type scripts on stapbpf

The eBPF backend now supports prometheus-exporter scripts. This implementation
introduces character escaping macros enabling the array dump macros on stapbpf.
However, there are some issues with foreach loops which are used in the macros
(PR24953).

1) Developed character escaping macros helper functions.
2) Added prometheus probe tapset for stapbpf.
3) Added stapbpf procfs file path to stap-exporter.
4) Introduced a sample stapbpf prometheus-exporter script in EXAMPLES.
5) Updated NEWS.

PR24926: correct printing of utf-8 characters on stapbpf

There were two bugs corrupting the string bytes and instructions. The
first bug involved the implicit sign extension of negative char values.
The second bug involved a faulty optimization (fixup_operands) which
used the incorrect instruction opcode.

1) Cast char to unsigned char before casting to uint32_t.
2) Changed opcode of optimized instruction to (BPF_STX | BPF_MEM | BPF_W).

enable concatenation operator for stapbpf userspace probes

kernel tracepoints: support afs, rxrpc, siox tracepoints for kernel 5.2

Added the usual forward-declarations or such for incomplete
tracepoint header files into tracepoint_extra_decls().

rhbz1731333: nfsd.proc.write, tolerate awol 'vlen'

This variable has disappeared from the kernel via commit
8154ef2776aa512a3eaa0e7db030dc4803354d61.  Substitute a 0.

dyninst configury: require 10.1+ but permit ppc64le and aarch64

Modern dyninst works okay on ppc64le and aarch64.

stapbpf: correct 32-bit handling of EXIT bpf-map value type

The bpf bytecode declares a 4byte->8byte map for the shared globals;
the userspace must use a 64-bit type to receive those values, lest
it suffer a most unfortunate stack smash.

testsuite procfs_bpf.exp: tolerate stapbpf early exit

It was observed on some platforms that the stap/bpf test case could
abort so quickly that the dejagnu (tclsh) code to open the bpf/procfs
pipes could itself hang - and indefinitely!  Replaced these tclsh
level ops with a /bin/timeout-wrapped echo or cat operation.

PR23879, PR24875: fix task-finder-vma on f29+

It was reported & rediscovered that some vma-dependent runtime
facilities have been broken: @vma() and *ubacktrace().  It turns out
that modern gcc/ld.so links/loads binaries in slightly different ways
than older toolchains.  Specifically, the first page of ELF files is
now loaded only r--p instead of r-xp protection flags.  The
_stp_vma_mmap_cb() routine now accepts the r--p case too.  It now
ignores the flags entirely.

PR24904: support linux 5.2's stacktrace.c changes with -DDEBUG_UNWIND too

PR24904: support linux 5.2's stacktrace.c changes

The following kernel commit disabled the older struct stack_trace APIs
on architectures that support the newer stackwalk APIs.  Provide an
adaptation layer to stack_trace_save_regs().

commit 214d8ca6ee854f696f75e75511fe66b409e656db
Author: Thomas Gleixner <tglx@linutronix.de>
Date:   Thu Apr 25 11:45:21 2019 +0200

    stacktrace: Provide common infrastructure

stapbpf PR23858 :: support sorting by value in foreach loop

Previously stapbpf's behaviour on this was wrong.
This slightly nightmarish bit of code handles more cases.
XXX Also need to take into account s->sort_aggr for statistics aggregates
-- currently unsupported.

To support nested foreach loops, map_get_next_key was changed to take & return
addresses-of string addresses rather than string addresses. Previously
we'd need to allocate and copy multiple string keys onto one tiny stack,
which is not feasible.

* bpf-internal.h (SORT_FLAGS): New define packs sort_column, sort_direction in one word.
  (GET_SORT_COLUMN): New define unpacks sort_column from SORT_FLAGS.
  (GET_SORT_DIRECTION): New define unpacks sort_direction from SORT_FLAGS.
* bpf-translate.cxx (bpf_unparser::visit_foreach_loop): String key/value iteration,
  hardcode keysize on stack to 8bytes (either an int or an address of a string),
  check for sort_aggr (UNSUPPORTED),
  pack sort_column and sort_direction into sort_flags,
  properly handle returned address of a string.
* stapbpf/bpfinterp.cxx (map_int_keys, map_str_keys): Remove typedefs.
  (struct map_keys): Nightmare begins. Support 4 cases of int/str keys/values.
  (convert_int_key, convert_str_key, convert_int_kp, convert_str_kp): More nightmare,
  handle different cases of packing/unpacking BPF key/val into C++ key/val.
  (convert_key, convert_kp): More nightmare. 'Overload' pack/unpack for ANY key/val.
  (compute_key_size): More nightmare. Calculate memory required for a key.
  (map_sort): New function handles initial sorting of map.
  (map_next): New function handles retrieval from sorted map.
  (map_get_next_key): Handle sorted int/str keys/values on different columns,
  now takes strings to give a place to allocate returned str key/vals
  that is not on the BPF stack.
  (bpf_intepret): Pass strings to map_get_next_key.

* testsuite/systemtap.bpf/bpf_tests/foreach_string.stp: Enable full testcase.
* testsuite/systemtap.bpf/bpf_tests/foreach_pr23858.stp: New testcase.

bpf_translate.cxx :: fix another segfault in visit_delete_statement

stapbpf: 32-bit build tweaks

On 32-bit hosts, uint64_t != unsigned long .

PR23285: stapbpf/procfs: use effective-userid consistently

The euid is easy and consistent in the construction of the
stapbpf/procfs path name.  Use the umask() field at least for
the fifo nodes (should also on the parent directory probably).
For the stapbpf -v case, print some fifo-related diagnostics.
Split out the .stp test case into a separate file, for easier
hand-execution.

expliclity show pass3 for -v on bpf runtime

PR23285 (1): enable procfs probes for stapbpf

The eBPF backend now supports procfs probes. This implementation
uses FIFO special files instead of proc filesystem files. The file
path format used is /var/tmp/systemtap-USER/MODNAME. One limitation
is that both read and write probes cannot exist for the same file.

1) Added procfs probe data structures to hold probe information.
2) Created an interface between target variables and eBPF interpreter.
3) Dedicated a single thread for each file which monitors for I/O.
4) Developed a cleaning routine and error handling mechanisms.
5) Updated NEWS and man pages.

small fix

new procfs_bpf test

rhbz1737589: add /* fallthru */ to satisfy gcc 9's -Wimplicit-fallthrough

We need annotate switch statements with deliberate case-to-case fallthroughs.

Add example using the test_check_dyninst and test_installcheck_dyninst.

testsuite/systemtap.examples :: add test_{,install}check_dyninst tag to check.ex
p

stapbpf pr24811 test :: also test non-constant iteration limit in foreach.stp

stapbpf pr23875 bugfix :: allocate actual keysize in foreach to avoid stack clobber

* bpf-translate.cxx (bpf_unparser::visit_foreach_loop): allocate actual keysize.
* testsuite/systemtap.bpf/bpf_tests/foreach_string.stp: new partial PR23858 testcase,
  added only the parts necessary to trigger a segfault when bugfix not applied.

rhbz1732514: java runtime requires java-devel

This is not provided automagically via some other dependency,
so we must hard-Require: it ourselves.

tapset/bpf/conversions.stp :: typo, should be $rc not rc

Fix aarch64 to properly access arguments for wrapped syscalls

Linux 4.18 added wrappers for aarch64 syscalls that pass a pointer to
a struct pt_regs holding the values for the actual arguments.  The
syscall tapsets initialize CONTEXT->sregs to point at this data
structure.  However, the aarch64 specific register access code was
using the CONTEXT->kregs and just getting the processor register state
when the kprobe triggered rather than the expected arguments in the
data structure being passed into the syscall.  The aarch64 specific
register code now gets the syscall arguments from the correct pt_regs
structure.

runtime: adapt to inconsistent export of task_work_add and task_work_cancel

Ubuntu user <walac> reports their kernel 5.0.0-17-generic #18-Ubuntu
SMP encounters pass-5 errors with an unresolved task_work_cancel()
symbol.  It turns out this is due to a ubuntu-specific
(android-related) kernel commit that exports only task_work_add().
Updated buildrun.cxx and relevant runtime files to separately check
for exportedness of task_work_cancel().

commit 2cc291a463c42641b4146b2507fa4499da35d335
Author: Christian Brauner <christian@brauner.io>
Date:   Wed Jan 16 23:13:25 2019 +0100

    UBUNTU: SAUCE: binder: turn into module

Eliminate ambiguous python shebangs

Fedora rawhide (31) now throws errors for ambiguous python shebangs.
The systemtap.spec has been modified as outlined in the Fedora feature
wiki page to avoid those ambiguities:

https://fedoraproject.org/wiki/Changes/Make_ambiguous_python_shebangs_error

Add mmwriteback.stp to the list of examples that BPF can run.

Add a test for the BPF raw tracepoints functionality. (PR23866)

PR23866: Make the bpf backend use BPF raw tracepoints for kernel.trace("*")

The BPF raw tracepoints provide arguments that better match the
Systemtap lkm kernel tracepoint probes than regular BPF tracepoints.
The BPF backend will use the BPF raw tracepoints unless the user
specifies the old behavior with a --compatible=4.1 option on the
commandline to address.

The new BPF raw tracepoints and their argument are discovered in the
same way as the old BPF tracepoints.  A number of small machine
generated C files are generated with macros are compiled to query the
available tracepoints in the kernel. Debug information describing the
data structures passed into the BPF tracepoints is examined to
determine the type and location of the tracepoint arguments.

Each probe handler BPF code for BPF raw tracepoints is put into a
raw_trace section as the method of registering the BPF raw tracepoints
is different than the regular BPF tracepoints.

The bpf tests have been revised to include the --compatible=4.1 option
for the tests where it makes a difference.

stapbpf pr24811 bugfix :: don't pop keys.back() on first iteration

If key == NULL, the sorted data for the current foreach loop
has not yet been created. Hence if limit == 0, keys.back() shouldn't
be popped.

* stapbpf/bpfinterp.cxx (map_get_next_key): bugfix for limit == 0.

stapbpf PR24811 test :: unveil a nasty lurking segfault case in foreach loops

Add some minor tweaks to backtracing add-ons and mention in NEWS

* NEWS: mention new backtracing add-ons
* runtime/regs.h: fix bug with REG_LINK macro for __aarch64__
* tapset/linux/ucontext-unwind.stp: tweak the register-taking backtraces to be more general and work
  with other archs

Fix errors with new backtrace functions missed in backtracing patch

stapbpf/bpfinterp.cxx pr24758 :: add error info to abort() calls

This is still not a proper error reporting scheme but it lets me debug
things in the meantime without having to fire up a debugger just to
understand which place in the code called abort().

* bpfinterp.cxx (stapbpf_abort): New macro, prints reason + aborts.
  (stapbpf_just_abort): New macro, aborts for unspecified reason,
  but still prints the location of the abort() call.
  (stapbpf_stat_get): use stapbpf_abort().
  (bpf_handle_transport_msg): ditto.
  (bpf_interpret): ditto.

Add more capabilities to systemtap backtracing

* runtime/sym.c: simplified logic in _stp_snprint_addr because it doesn't need to be that verbose,
  also added ability to have file names and line numbers print in backtraces
* runtime/sym.h: added new symbol flag to generate a more "fuller" backtrace (includes file names
  and line numbers)
* tapset/linux/context-unwind.stp: added new backtrace tapset function that also prints file names
* tapset/linux/ucontext-unwind.stp: added new backtrace tapset function that also prints file names
  and functions to allow backtraces using a user provided pc & sp.

Make use of dwarf_aggregate_size to find size attr of types

When trying to probe go lang structure pointers, was getting
"cannot find byte_size attribute" errors. This patch fixes
that issue by using the dwarf_aggregate_size function in
elfutils.

runtime: stp_tracepoint_module_notifier rc change

Some LKML traffic indicates NOTIFY_OK may be better than NOTIFY_DONE (0)
to return in a routine success case.  Following suit for this site.
OTOH leaving another instance in runtime/linux/symbols.c alone for now.

https://lkml.org/lkml/2019/6/24/880

Reported-By: Mathieu Desnoyers <mathieu.desnoyers@efficios.com>

PR11353: enable probe elision optimization

Previously, the compiler only issued warnings for probes with empty
handlers. With the new implementation, the compiler additionally
elides probes with empty handlers. The joining of probes to their
groups has been delayed until after this optimization is performed.

Many tests in the testsuite were built under the assumption that
probes with empty handlers are not elided. Consequently, many of
them stopped working and were fixed.

1) Removed probes with empty handlers from session.
2) Issued warnings whenever a probe is elided.
3) Added tests which check for correct probe elision.
4) Fixed tests affected by probe elision.
5) Updated NEWS.

stapbpf pr24528 :: new bpf embeddedcode /* userspace */ annotation

* bpf-translate.cxx (bpf_unparser::visit_embeddedcode): guard against
  using embeddedcode blocks marked /* userspace */ in in-kernel BPF.

* tapset/bpf/context.stp (_stp_get_target): mark userspace-only.
* tapset/bpf/timestamp_gtod.stp (__gtod_get_ns): mark userspace-only.

stapbpf PR24543 oops in previous commit (mark_active_cpus)

PR24543 just-in-case fix :: stapbpf breaks when cpu0 is disabled

Certain perf_events constructs created by stapbpf must be pinned to
one cpu, it doesn't matter which. Previously cpu0 was used.

*Very rarely* it's possible for cpu0 to be disabled.
(It's not recommended,

In that case stapbpf will fail with a super confusing error.

This patch improves readability and allows stapbpf to use a fallback cpu.
cpu0 is still preferred whenever available.

* stapbpf/stapbpf.cxx (default_cpu): New global.
  (mark_active_cpus): Set default_cpu, prefer cpu0 whenever possible.
  (create_group_fds): Use default_cpu, not cpu0.
  (register_uprobes): Ditto.
  (register_kprobes): Ditto.
  (register_tracepoints): Ditto.
  (register_timers): Ditto.
  (register_perf): Ditto.
  (load_bpf_file): Clarifying comment on when active cpu info is checked,
    use default_cpu for uctx bpf_transport_context.

PR10280 :: revert prior fix as it does not work for all kernel configs

Will replace with a better fix only if I find a better solution.

stapbpf PR24528 housekeeping :: check for userspace-only constructs

And signal an error if they're used in the wrong locations.

* bpf-translate.cxx (bpf_unparser::visit_embeddedcode): comment
  noting future checking (we could mark tapset functions userspace-only).
  (bpf_unparser::visit_for_loop): userspace-only feature.
  (bpf_unparser::visit_foreach_loop): userspace-only feature.
  (bpf_unparser::emit_print_format): sprintf is userspace-only.
  (bpf_unparser::visit_stat_op): stats extraction is userspace-only.

* bpf-internal.h (enum bpf_target): clarify comment.

stap-prep: adapt to ubuntu 18.04

The /proc/version_signature file has disappeared there; copying
Debian parse of /proc/version instead.

stapbpf PR24528 housekeeping :: introduce enum bpf_target

Some housekeeping work to allow generating different code for the
less-restrictive userspace BPF interpreter vs. the more-restrictive
in-kernel BPF JIT interpreter.

* bpf-internal.h (enum bpf_target): New enum to track target BPF version.
  (struct program::target): New field,
  tracks the BPF version this program is intended for.
  (struct program::program): Require target to be specified on creation.
* bpf-base.cxx (struct program::program): Initialize target field.

* bpf-translate.cxx (translate_bpf_pass): Specify targets of each program,
  for now begin/end probes are being emitted for userspace BPF,
  all other probes are being emitted for in-kernel BPF.

Down the line we may have a userspace timer probe (PR23477)..

Add ansi_colors and ansi_colors2 to list of bpf compatible examples.

stapbpf PR23559 :: handle octal and hex escape codes

* bpf-translate.cxx (translate_escapes): handle numeric escapes.

stap hash.cxx PR10280 related fix :: also hash guru mode flag

Since PR10280 introduces the idea that guru-mode modules may be
built differently, we need to cache them separately from
non-guru-mode modules.

* hash.cxx (get_base_hash): Add guru-mode flag to hashed info.

stapbpf next.stp :: add diagnostic print for PR24659

PR12025: use the decimal or hex format specifier respectively in
the automatic printing of integers and pointers

Previously, the detailed types structures were not propagated to
global variables. Consequently, integers and pointers were both
printed using the hex format specifier. With the new implementation,
pointer and integer types can be differentiated.

1) Propagated detailed type structures to global variables.
2) Applied warning for potential type mismatch.
3) Added tests which check for hex and decimal format specifiers.

Add mmfilepage.stp to the list of examples that work with the bpf backend.

@count() and @sum() should provide 0 for empty entries

When compiled with the bpf backend mmfilepage.stp would have a
segmentation fault when printing out recorded information in the probe
end.  This was cause by a foreach using an index from one global array
for other global arrays that did not have entries for some of those
indices.  The code computing the @count() and @sum() values did not
handle the situation where there were no statistics for that
particular index in the global array.  The proper default is that
@count() and @sum() in those cases should be 0.

Add support for the target() function and -x option for bpf backend.

stapbpf PR24639 :: basic support for next statement

Only support next statement in probes (terminate probe),
not in functions (relates to not-supported overloading).

* bpf-translate.cxx (bpf_unparser::visit_next_statement): New method.
* testsuite/systemtap.bpf/bpf_tests/next_stp: New testcase.

PR24343: fix uninitialized variable warning and empty output of stap -L for return probes

The uninitialized variable warning was caused by exit syscalls as they don't have
conventional return strings. The incorrect output of stap -L was caused by synthetic
probes created from @entry variables which resulted in miscalculation of the set
intersection check.

1) Set 'never' filters for exit syscalls.
2) Applied synthetic probe flag to filter out synthetic probes from the set intersection.
3) Added tests which check for correct flagging of synethic probes.

Add aarch64 stapdyn support.

* runtime/dyninst/regs.c (_stp_print_regs): New for aarch64
* runtime/dyninst/stapdyn.h (struct pt_regs): New for aarch64 since
  asm/ptrace.h does not define it.
* runtime/dyninst/uprobes-regs.c (enter_dyninst_uprobe_regs):  Add aarch64.
* stapdyn/mutatee.cxx (get_dwarf_registers):  Add aarch64.

Add a couple more examples that now work with the bpf code generation:

  apps/libguestfs_log.stp
  network/sk_stream_wait_memory.stp

Provide gettimeofday_* functions for bpf backend

BPF has a helper function ktime_get_ns() that provides a nanosecond
time from the time that the machine was booted.  When working across
machines really want to have a timestamp based on gettimeofday.  This
new BPF backend tapset computes an offset and scaling to convert the
ktime_get_ns() values into gettimeofday_*().  This will allow easier
comparison of timestamped traces between machines.

RHBZ1613157: support powerpc64 sdt.h rN,rM operand syntax

This syntax appears in some ppc64le binaries, including of stap
itself.  It means the same thing as "0(rN,rM)" on other architectures.