STAPBPF(8)                  System Manager's Manual                 STAPBPF(8)

<?><?><?> (NAME)
       stapbpf - <?><?><?><?><?><?><?><?><?><?> BPF <?><?><?><?><?> systemtap




<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       stapbpf [ OPTIONS ] MODULE


<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?><?> stapbpf <?><?><?> <?><?><?><?> (<?><?><?><?><?><?>)
       <?><?><?><?><?> <?><?> BPF <?><?><?><?> <?><?><?><?><?> Systemtap
       <?><?><?>. <?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?> bpf-elf <?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> stap (<?><?><?><?><?>
       <?><?><?><?> <?><?> <?><?><?><?><?> --runtime=bpf) <?><?> <?><?><?><?>.


       <?><?><?><?><?> <?><?><?><?><?> systemtap <?><?> <?><?> <?><?><?>
       <?><?><?><?><?><?><?><?><?> <?> <?><?> <?><?><?> <?><?><?><?><?><?>
       <?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?><?><?><?> systemtap <?><?> <?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?> <?><?><?> <?> <?><?><?> <?><?><?> <?><?><?><?><?>
       (shared object) <?><?><?><?> <?><?> <?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?>.

       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?> stappaths(7) <?><?><?><?><?><?> <?><?><?><?><?>
       <?><?> <?><?><?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?>:

        $ rpm -q systemtap # (<?><?><?><?> Fedora/RHEL)
        $ apt-get -v systemtap # (<?><?><?><?> Ubuntu)


<?><?><?><?><?><?><?><?> (OPTIONS)
       <?><?><?><?><?><?> stapbpf <?><?> <?><?><?><?><?><?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>. <?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?><?>.

       -v     <?><?><?><?> <?><?><?><?> (<?><?><?><?><?> <?><?>
              <?><?><?><?><?><?> <?><?><?><?>).

       -V     <?><?><?> <?><?><?><?><?> <?><?><?><?> <?> <?><?><?><?>.

       -w     <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?>.

       -h     <?><?><?> <?><?><?><?> <?><?><?><?><?><?>.

       -x PID <?><?><?><?><?> '_stp_target' <?><?> PID
              <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?> <?><?>.

       -o FILE
              <?><?><?><?><?> <?><?><?><?><?> <?><?> FILE.


<?><?><?><?><?><?><?><?><?><?> (ARGUMENTS)
       MODULE <?><?><?><?> <?><?> <?><?><?><?> bpf-elf
       <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> stap (<?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?> --runtime=bpf) <?><?><?>.


<?><?><?><?><?><?><?> (EXAMPLES)
       <?><?> <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?> stapbpf <?><?><?><?><?> <?><?><?> <?><?><?>.
       <?><?><?><?><?> <?><?> stap <?><?><?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>.
       <?><?><?><?><?><?> stap <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?>.

        $ stap --runtime=bpf -p4 -e 'probe begin { printf("Hello World!\n");
       exit() }'
        stap_28784.bo

       <?><?><?><?><?><?> stapbpf <?><?> <?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>.

        $ stapbpf ./stap_28784.bo
        Hello World!

       <?><?><?> <?><?><?><?><?> -p4 <?><?><?> <?><?><?><?> stap
       <?><?><?><?><?><?> <?><?><?><?><?><?> stapbpf <?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?>.


<?><?><?><?><?><?><?><?><?><?> (LIMITATIONS)
       <?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?> <?> <?><?> <?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?>.
       <?><?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?>
       (probe points) <?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?>:


              begin
              end
              kernel.*
              process.*
              timer.*
              perf.*
              procfs.*



       <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?><?> kprobes<?>
       uprobes<?> tracepoint <?> perf <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?>. <?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?> stapprobes(3stap) <?><?><?><?><?><?> <?><?><?><?>.

       <?><?><?><?><?><?><?><?> for<?> <?><?><?><?><?><?><?><?> foreach <?>
       <?><?><?><?><?><?><?><?> while <?><?><?> <?><?>
       <?><?><?><?><?><?><?><?> begin <?> end <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?>. <?><?><?><?><?><?> try
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>.

       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>. <?><?><?><?><?><?><?>
       <?> <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?>
       (literals) <?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> printf <?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>.

       <?><?><?><?><?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?> <?> <?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?> @count(), @sum(), @avg()
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>.

       <?><?><?> <?><?><?><?> bpf-elf <?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> stap <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?>.


<?><?><?><?><?> <?> <?><?><?><?><?> (SAFETY AND SECURITY)
       <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?> <?> <?><?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> stap(1) <?><?><?><?><?><?> <?><?><?><?>.


<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       stap(1), stapprobes(3stap), staprun(8), stapex(3stap)


<?><?><?><?><?><?><?> (BUGS)
       <?><?> <?><?><?><?><?> Bugzilla <?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?><?><?>.  http://sourceware.org/systemtap,
       <systemtap@sourceware.org>.

                                                                    STAPBPF(8)