rbbcc 0.11.6 → 0.11.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4bd5c0ae3d72c8e4e931d4ecb48872212c1389dd56897a5c16ca3626a1a7a725
-  data.tar.gz: c117a487cbc4c1b5fed3df4eea8813d4b6c16ea3c6dcd306e41b504fb2776bc3
+  metadata.gz: 59d0fb02bff1acabccf1f231bd3642bfa3da9ef1fc796c580d8c1d9c4c5098bc
+  data.tar.gz: 5e033fa5c3957b1d7e822eec06c4bff9f1158046a292897f61401206d56fff9d
 SHA512:
-  metadata.gz: 1c11515d0a7b919ffaa6c0001cc74b96f0bbc217e07fa46c2fe6b37398499a6cb81fac23425e45f32b8802b6b90a6c107f845ef3b610ea7838d8b29178129adc
-  data.tar.gz: 253c500eebc928aa13327496b4cdb96f844a91df06aa5c4bf85561a1958f2c181f792e24262b1ae9d5ac0562796ffb475ae178b2a88a8451f17e50f6c1f7f727
+  metadata.gz: ca57cd8e17b0035c4e670e0a3fc18ee53544cd14b81a5cdf62b91a504b848b59b3ad1f38658ae68fff0c1cc33126f36ea708b73b5378a2d83223651ce0a5441d
+  data.tar.gz: d37158b96887c9500ee791209d44bc03902efda99466623eccff0d1de83c18dc6fca174beb37c50a4d36d0caa84f3dbf2b6e1aee21470a47e9cc2af7ce2fbc10

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    rbbcc (0.11.6)
+    rbbcc (0.11.7)
       fiddle
 
 GEM

data/lib/rbbcc/version.rb

@@ -1,3 +1,3 @@
 module RbBCC
-  VERSION = "0.11.6"
+  VERSION = "0.11.7"
 end

data/rbbcc.gemspec

@@ -15,9 +15,12 @@ Gem::Specification.new do |spec|
 
   # Specify which files should be added to the gem when it is released.
   # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
-  spec.files         = Dir.chdir(File.expand_path('..', __FILE__)) do
-    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  spec.files = Dir.chdir(File.expand_path('..', __FILE__)) do
+    `git ls-files -z`.split("\x0").reject do |f|
+      f.match(%r{^(test|spec|features|docs|examples)/}) || f.match(/\.(gif|jpe?g|png)\Z/)
+    end
   end
+
   spec.bindir        = "exe"
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ["lib"]

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rbbcc
 version: !ruby/object:Gem::Version
-  version: 0.11.6
+  version: 0.11.7
 platform: ruby
 authors:
 - Uchio Kondo
@@ -53,66 +53,6 @@ files:
 - ci/Dockerfile.0.17.0-2.7.2
 - ci/Dockerfile.0.17.0-3.0.0
 - ci/Dockerfile.ci_base
-- docs/README.md
-- docs/answers/01-hello-world.rb
-- docs/answers/02-sys_sync.rb
-- docs/answers/03-hello_fields.rb
-- docs/answers/04-sync_timing.rb
-- docs/answers/05-sync_count.rb
-- docs/answers/06-disksnoop.rb
-- docs/answers/07-hello_perf_output.rb
-- docs/answers/08-sync_perf_output.rb
-- docs/answers/09-bitehist.rb
-- docs/answers/10-disklatency.rb
-- docs/answers/11-vfsreadlat.c
-- docs/answers/11-vfsreadlat.rb
-- docs/answers/12-urandomread.rb
-- docs/answers/13-disksnoop_fixed.rb
-- docs/answers/14-strlen_count.rb
-- docs/answers/15-nodejs_http_server.rb
-- docs/answers/16-task_switch.c
-- docs/answers/16-task_switch.rb
-- docs/answers/node-server.js
-- docs/getting_started.md
-- docs/projects_using_rbbcc.md
-- docs/tutorial_bcc_ruby_developer.md
-- docs/tutorial_bcc_ruby_developer_japanese.md
-- examples/bitehist.rb
-- examples/charty/Gemfile
-- examples/charty/Gemfile.lock
-- examples/charty/bitehist-unicode.rb
-- examples/collectsyscall.rb
-- examples/dddos.rb
-- examples/disksnoop.rb
-- examples/dns_blocker.rb
-- examples/example.gif
-- examples/extract_arg.rb
-- examples/hello_fields.rb
-- examples/hello_perf_output.rb
-- examples/hello_ring_buffer.rb
-- examples/hello_world.rb
-- examples/kvm_hypercall.rb
-- examples/lsm_sockblock.rb
-- examples/mallocstack.rb
-- examples/networking/http_filter/http-parse-simple.c
-- examples/networking/http_filter/http-parse-simple.rb
-- examples/pin_maps_a.rb
-- examples/pin_maps_b.rb
-- examples/py-orig/sockblock.py
-- examples/ringbuf_pin_a.rb
-- examples/ringbuf_pin_b.rb
-- examples/ruby_usdt.rb
-- examples/sbrk_trace.rb
-- examples/ssl_http_trace.rb
-- examples/syscalluname.rb
-- examples/table.rb
-- examples/tools/bashreadline.rb
-- examples/tools/execsnoop.rb
-- examples/tools/runqlat.rb
-- examples/urandomread-explicit.rb
-- examples/urandomread.rb
-- examples/usdt-test.rb
-- examples/usdt.rb
 - exe/rbbcc
 - lib/rbbcc.rb
 - lib/rbbcc/bcc.rb
@@ -149,7 +89,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.6
+rubygems_version: 4.0.10
 specification_version: 4
 summary: BCC port for MRI
 test_files: []

data/docs/README.md

@@ -1,7 +0,0 @@
-# RbBCC Docs
-
-* [Getting Started](getting_started.md)
-* [Ruby Tutorial](tutorial_bcc_ruby_developer.md)
-* [Projects Using RbBCC](projects_using_rbbcc.md)
-
-**Please see also [BCC itself's README](https://github.com/iovisor/bcc/#readme) and [docs](https://github.com/iovisor/bcc/tree/master/docs).** 

data/docs/answers/01-hello-world.rb

@@ -1,16 +0,0 @@
-#!/usr/bin/env ruby
-# Original hello_world.py:
-# Copyright (c) PLUMgrid, Inc.
-# Licensed under the Apache License, Version 2.0 (the "License")
-#
-# This Ruby version follows the Apache License 2.0
-
-# run in project examples directory with:
-# sudo ./hello_world.rb"
-# see trace_fields.rb for a longer example
-
-require "rbbcc"
-include RbBCC
-
-# This may not work for 4.17 on x64, you need replace kprobe__sys_clone with kprobe____x64_sys_clone
-BCC.new(text: 'int kprobe__sys_clone(void *ctx) { bpf_trace_printk("Hello, World!\\n"); return 0; }').trace_print

data/docs/answers/02-sys_sync.rb

@@ -1,18 +0,0 @@
-#!/usr/bin/env ruby
-# Licensed under the Apache License, Version 2.0 (the "License")
-
-require "rbbcc"
-include RbBCC
-
-puts "Tracing sys_sync()... Ctrl-C to end."
-begin
-  BCC.new(text: <<~BPF).trace_print
-    int kprobe__sys_sync(void *ctx) {
-      bpf_trace_printk("sys_sync() called\\n");
-      return 0;
-    }
-  BPF
-rescue Interrupt
-  puts
-  puts "Done"
-end

data/docs/answers/03-hello_fields.rb

@@ -1,33 +0,0 @@
-#!/usr/bin/env ruby
-# Licensed under the Apache License, Version 2.0 (the "License")
-
-require "rbbcc"
-include RbBCC
-
-# define BPF program
-prog = <<BPF
-int hello(void *ctx) {
-    bpf_trace_printk("Hello, World!\\n");
-    return 0;
-}
-BPF
-
-# load BPF program
-b = BCC.new(text: prog)
-b.attach_kprobe(event: b.get_syscall_fnname("clone"), fn_name: "hello")
-
-# header
-puts("%-18s %-16s %-6s %s" % ["TIME(s)", "COMM", "PID", "MESSAGE"])
-
-# format output
-begin
-  b.trace_fields do |task, pid, cpu, flags, ts, msg|
-    print("%-18.9f %-16s %-6d %s" % [ts, task, pid, msg])
-  end
-rescue Interrupt
-  puts
-  puts "Done"
-rescue => e
-  p e
-  retry
-end

data/docs/answers/04-sync_timing.rb

@@ -1,46 +0,0 @@
-#!/usr/bin/env ruby
-# Original sync_timing.py:
-# Licensed under the Apache License, Version 2.0 (the "License")
-#
-# This Ruby version follows the Apache License 2.0
-
-require "rbbcc"
-include RbBCC
-
-# load BPF program
-b = BCC.new(text: <<BPF)
-#include <uapi/linux/ptrace.h>
-
-BPF_HASH(last);
-
-int do_trace(struct pt_regs *ctx) {
-    u64 ts, *tsp, delta, key = 0;
-
-    // attempt to read stored timestamp
-    tsp = last.lookup(&key);
-    if (tsp != 0) {
-        delta = bpf_ktime_get_ns() - *tsp;
-        if (delta < 1000000000) {
-            // output if time is less than 1 second
-            bpf_trace_printk("%d\\n", delta / 1000000);
-        }
-        last.delete(&key);
-    }
-
-    // update stored timestamp
-    ts = bpf_ktime_get_ns();
-    last.update(&key, &ts);
-    return 0;
-}
-BPF
-
-b.attach_kprobe(event: b.get_syscall_fnname("sync"), fn_name: "do_trace")
-puts("Tracing for quick sync's... Ctrl-C to end")
-
-# format output
-start = 0
-b.trace_fields do |task, pid, cpu, flags, ts, ms|
-  start = ts.to_f if start.zero?
-  ts = ts.to_f - start
-  puts("At time %.2f s: multiple syncs detected, last %s ms ago" % [ts, ms.chomp])
-end

data/docs/answers/05-sync_count.rb

@@ -1,54 +0,0 @@
-#!/usr/bin/env ruby
-# Licensed under the Apache License, Version 2.0 (the "License")
-
-require "rbbcc"
-include RbBCC
-
-# load BPF program
-b = BCC.new(text: <<BPF)
-#include <uapi/linux/ptrace.h>
-
-BPF_HASH(last);
-
-int do_trace(struct pt_regs *ctx) {
-    u64 ts, *tsp, delta, key = 0, counter_key = 1, zero = 0;
-
-    // initialize counter key
-    if (last.lookup_or_try_init(&counter_key, &zero))
-        last.increment(counter_key);
-
-    // attempt to read stored timestamp
-    tsp = last.lookup(&key);
-    if (tsp != 0) {
-        delta = bpf_ktime_get_ns() - *tsp;
-        if (delta < 1000000000) {
-            // output if time is less than 1 second
-            bpf_trace_printk("%d\\n", delta / 1000000);
-        }
-        last.delete(&key);
-    }
-
-    // update stored timestamp
-    ts = bpf_ktime_get_ns();
-    last.update(&key, &ts);
-    return 0;
-}
-BPF
-
-COUNTER_KEY = 1
-
-b.attach_kprobe(event: b.get_syscall_fnname("sync"), fn_name: "do_trace")
-puts("Tracing for quick sync's... Ctrl-C to end")
-
-# format output
-start = 0
-begin
-  b.trace_fields do |task, pid, cpu, flags, ts, ms|
-    start = ts.to_f if start.zero?
-    ts = ts.to_f - start
-    puts("At time %.2f s: multiple syncs detected, last %s ms ago" % [ts, ms.chomp])
-  end
-rescue Interrupt
-  table = b["last"]
-  puts "Count of sys_sync: %d" % table[COUNTER_KEY].to_bcc_value
-end

data/docs/answers/06-disksnoop.rb

@@ -1,71 +0,0 @@
-#!/usr/bin/env ruby
-#
-# disksnoop.rb	Trace block device I/O: basic version of iosnoop.
-#		For Linux, uses BCC, eBPF. Embedded C.
-# This is ported from original disksnoop.py
-#
-# Written as a basic example of tracing latency.
-#
-# Licensed under the Apache License, Version 2.0 (the "License")
-#
-# 11-Aug-2015	Brendan Gregg	Created disksnoop.py
-
-require 'rbbcc'
-include RbBCC
-
-REQ_WRITE = 1		# from include/linux/blk_types.h
-
-# load BPF program
-b = BCC.new(text: <<CLANG)
-#include <uapi/linux/ptrace.h>
-#include <linux/blkdev.h>
-
-BPF_HASH(start, struct request *);
-
-void trace_start(struct pt_regs *ctx, struct request *req) {
-  // stash start timestamp by request ptr
-  u64 ts = bpf_ktime_get_ns();
-
-  start.update(&req, &ts);
-}
-
-void trace_completion(struct pt_regs *ctx, struct request *req) {
-  u64 *tsp, delta;
-
-  tsp = start.lookup(&req);
-  if (tsp != 0) {
-    delta = bpf_ktime_get_ns() - *tsp;
-    bpf_trace_printk("%d %x %d\\n", req->__data_len,
-        req->cmd_flags, delta / 1000);
-    start.delete(&req);
-  }
-}
-CLANG
-
-b.attach_kprobe(event: "blk_start_request", fn_name: "trace_start") if BCC.get_kprobe_functions('blk_start_request')
-b.attach_kprobe(event: "blk_mq_start_request", fn_name: "trace_start")
-b.attach_kprobe(event: "blk_account_io_completion", fn_name: "trace_completion")
-
-# header
-puts("%-18s %-2s %-7s %8s" % ["TIME(s)", "T", "BYTES", "LAT(ms)"])
-
-# format output
-loop do
-  begin
-    task, pid, cpu, flags, ts, msg = b.trace_fields
-    bytes_s, bflags_s, us_s = msg.split
-
-    if (bflags_s.to_i(16) & REQ_WRITE).nonzero?
-      type_s = "W"
-    elsif bytes_s == "0" # see blk_fill_rwbs() for logic
-      type_s = "M"
-    else
-      type_s = "R"
-    end
-    ms = us_s.to_i.to_f / 1000
-
-    puts("%-18.9f %-2s %-7s %8.2f" % [ts, type_s, bytes_s, ms])
-  rescue Interrupt
-    exit
-  end
-end

data/docs/answers/07-hello_perf_output.rb

@@ -1,59 +0,0 @@
-#!/usr/bin/env ruby
-#
-# This is a Hello World example that uses BPF_PERF_OUTPUT.
-# Ported from hello_perf_output.py
-
-require 'rbbcc'
-include RbBCC
-
-# define BPF program
-prog = """
-#include <linux/sched.h>
-
-// define output data structure in C
-struct data_t {
-    u32 pid;
-    u64 ts;
-    char comm[TASK_COMM_LEN];
-};
-BPF_PERF_OUTPUT(events);
-
-int hello(struct pt_regs *ctx) {
-    struct data_t data = {};
-
-    data.pid = bpf_get_current_pid_tgid();
-    data.ts = bpf_ktime_get_ns();
-    bpf_get_current_comm(&data.comm, sizeof(data.comm));
-
-    events.perf_submit(ctx, &data, sizeof(data));
-
-    return 0;
-}
-"""
-
-# load BPF program
-b = BCC.new(text: prog)
-b.attach_kprobe(event: b.get_syscall_fnname("clone"), fn_name: "hello")
-
-# header
-puts("%-18s %-16s %-6s %s" % ["TIME(s)", "COMM", "PID", "MESSAGE"])
-
-# process event
-start = 0
-print_event = lambda { |cpu, data, size|
-  event = b["events"].event(data)
-  if start == 0
-    start = event.ts
-  end
-
-  time_s = ((event.ts - start).to_f) / 1000000000
-  puts("%-18.9f %-16s %-6d %s" % [time_s, event.comm, event.pid,
-                                  "Hello, perf_output!"])
-}
-
-# loop with callback to print_event
-b["events"].open_perf_buffer(&print_event)
-
-loop do
-  b.perf_buffer_poll()
-end

data/docs/answers/08-sync_perf_output.rb

@@ -1,60 +0,0 @@
-#!/usr/bin/env ruby
-# Licensed under the Apache License, Version 2.0 (the "License")
-
-require "rbbcc"
-include RbBCC
-
-# load BPF program
-b = BCC.new(text: <<BPF)
-#include <uapi/linux/ptrace.h>
-
-struct data_t {
-    u32 pid;
-    u64 ts;
-    u64 delta;
-};
-BPF_PERF_OUTPUT(events);
-BPF_HASH(last);
-
-int do_trace(struct pt_regs *ctx) {
-    u64 ts, *tsp, delta, key = 0;
-
-    // attempt to read stored timestamp
-    tsp = last.lookup(&key);
-    if (tsp != 0) {
-        struct data_t data = {};
-        delta = bpf_ktime_get_ns() - *tsp;
-        if (delta < 1000000000) {
-            data.pid = bpf_get_current_pid_tgid();
-            data.ts = bpf_ktime_get_ns();
-            data.delta = delta;
-            events.perf_submit(ctx, &data, sizeof(data));
-        }
-        last.delete(&key);
-    }
-
-    // update stored timestamp
-    ts = bpf_ktime_get_ns();
-    last.update(&key, &ts);
-    return 0;
-}
-BPF
-
-b.attach_kprobe(event: b.get_syscall_fnname("sync"), fn_name: "do_trace")
-puts("Tracing for quick sync's... Ctrl-C to end")
-
-# format output
-start = 0
-b["events"].open_perf_buffer do |_, data, _|
-  event = b["events"].event(data)
-  if start == 0
-    start = event.ts
-  end
-
-  time_s = ((event.ts - start).to_f) / 1_000_000_000
-  puts("At time %.2f s: multiple syncs detected, last %s ms ago" % [time_s, event.delta / 1_000_000])
-end
-
-loop do
-  b.perf_buffer_poll()
-end

data/docs/answers/09-bitehist.rb

@@ -1,32 +0,0 @@
-#!/usr/bin/env ruby
-# Licensed under the Apache License, Version 2.0 (the "License")
-
-require 'rbbcc'
-include RbBCC
-
-# load BPF program
-b = BCC.new(text: <<BPF)
-#include <uapi/linux/ptrace.h>
-#include <linux/blkdev.h>
-
-BPF_HISTOGRAM(dist);
-
-int kprobe__blk_account_io_completion(struct pt_regs *ctx, struct request *req)
-{
-  dist.increment(bpf_log2l(req->__data_len / 1024));
-  return 0;
-}
-BPF
-
-# header
-puts("Tracing... Hit Ctrl-C to end.")
-
-# trace until Ctrl-C
-begin
-  loop { sleep 0.1 }
-rescue Interrupt
-  puts
-end
-
-# output
-b["dist"].print_log2_hist("kbytes")

data/docs/answers/10-disklatency.rb

@@ -1,51 +0,0 @@
-#!/usr/bin/env ruby
-# Licensed under the Apache License, Version 2.0 (the "License")
-
-require 'rbbcc'
-include RbBCC
-
-b = BCC.new(text: <<BPF)
-#include <uapi/linux/ptrace.h>
-#include <linux/blkdev.h>
-
-BPF_HASH(start, struct request *);
-BPF_HISTOGRAM(dist);
-
-// note this program mixes R/W
-// For next step, handle req->cmd_flags and prepare hist hash per op.
-
-void trace_start(struct pt_regs *ctx, struct request *req) {
-  // stash start timestamp by request ptr
-  u64 ts = bpf_ktime_get_ns();
-
-  start.update(&req, &ts);
-}
-
-void trace_completion(struct pt_regs *ctx, struct request *req) {
-  u64 *tsp, delta;
-
-  tsp = start.lookup(&req);
-  if (tsp != 0) {
-    delta = bpf_ktime_get_ns() - *tsp;
-    dist.increment(bpf_log2l(delta / 1000)); // us
-    start.delete(&req);
-  }
-}
-BPF
-
-b.attach_kprobe(event: "blk_start_request", fn_name: "trace_start") if BCC.get_kprobe_functions('blk_start_request')
-b.attach_kprobe(event: "blk_mq_start_request", fn_name: "trace_start")
-b.attach_kprobe(event: "blk_account_io_completion", fn_name: "trace_completion")
-
-# header
-puts("Tracing... Hit Ctrl-C to end.")
-
-# trace until Ctrl-C
-begin
-  loop { sleep 0.1 }
-rescue Interrupt
-  puts
-end
-
-# output
-b["dist"].print_log2_hist("usec")

data/docs/answers/11-vfsreadlat.c

@@ -1,46 +0,0 @@
-/*
- * From: https://github.com/iovisor/bcc/blob/master/examples/tracing/vfsreadlat.c
- *
- * vfsreadlat.c		VFS read latency distribution.
- *			For Linux, uses BCC, eBPF. See .py/.rb file.
- *
- * Copyright (c) 2013-2015 PLUMgrid, http://plumgrid.com
- * This program is free software; you can redistribute it and/or
- * modify it under the terms of version 2 of the GNU General Public
- * License as published by the Free Software Foundation.
- *
- * 15-Aug-2015	Brendan Gregg	Created this.
- */
-
-#include <uapi/linux/ptrace.h>
-
-BPF_HASH(start, u32);
-BPF_HISTOGRAM(dist);
-
-int do_entry(struct pt_regs *ctx)
-{
-  u32 pid;
-  u64 ts, *val;
-
-  pid = bpf_get_current_pid_tgid();
-  ts = bpf_ktime_get_ns();
-  start.update(&pid, &ts);
-  return 0;
-}
-
-int do_return(struct pt_regs *ctx)
-{
-  u32 pid;
-  u64 *tsp, delta;
-
-  pid = bpf_get_current_pid_tgid();
-  tsp = start.lookup(&pid);
-
-  if (tsp != 0) {
-    delta = bpf_ktime_get_ns() - *tsp;
-    dist.increment(bpf_log2l(delta / 1000));
-    start.delete(&pid);
-  }
-
-  return 0;
-}