Class: RubyMemcheck::Configuration

Inherits:
Object
  • Object
show all
Defined in:
lib/ruby_memcheck/configuration.rb

Constant Summary collapse

DEFAULT_VALGRIND = 
"valgrind"
DEFAULT_VALGRIND_OPTIONS = 
[
  "--num-callers=50",
  "--error-limit=no",
  "--trace-children=yes",
  "--undef-value-errors=no",
  "--leak-check=full",
  "--show-leak-kinds=definite",
].freeze
DEFAULT_VALGRIND_SUPPRESSIONS_DIR = 
"suppressions"
DEFAULT_SKIPPED_RUBY_FUNCTIONS = 
[
  /\Aeval_string_with_cref\z/,
  /\Aintern_str\z/, # Same as rb_intern, but sometimes rb_intern is optimized out
  /\Arb_add_method_cfunc\z/,
  /\Arb_check_funcall/,
  /\Arb_class_boot\z/, # Called for all the different ways to create a Class
  /\Arb_enc_raise\z/,
  /\Arb_exc_raise\z/,
  /\Arb_extend_object\z/,
  /\Arb_funcall/,
  /\Arb_intern/,
  /\Arb_ivar_set\z/,
  /\Arb_module_new\z/,
  /\Arb_raise\z/,
  /\Arb_rescue/,
  /\Arb_respond_to\z/,
  /\Arb_thread_create\z/, # Threads are relased to a cache, so they may be reported as a leak
  /\Arb_yield/,
].freeze

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(binary_name: nil, ruby: FileUtils::RUBY, valgrind: DEFAULT_VALGRIND, valgrind_options: DEFAULT_VALGRIND_OPTIONS, valgrind_suppressions_dir: DEFAULT_VALGRIND_SUPPRESSIONS_DIR, valgrind_generate_suppressions: false, skipped_ruby_functions: DEFAULT_SKIPPED_RUBY_FUNCTIONS, temp_dir: Dir.mktmpdir, output_io: $stderr, filter_all_errors: false) ⇒ Configuration

Returns a new instance of Configuration.



50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
 
# File 'lib/ruby_memcheck/configuration.rb', line 50

def initialize(
  binary_name: nil,
  ruby: FileUtils::RUBY,
  valgrind: DEFAULT_VALGRIND,
  valgrind_options: DEFAULT_VALGRIND_OPTIONS,
  valgrind_suppressions_dir: DEFAULT_VALGRIND_SUPPRESSIONS_DIR,
  valgrind_generate_suppressions: false,
  skipped_ruby_functions: DEFAULT_SKIPPED_RUBY_FUNCTIONS,
  temp_dir: Dir.mktmpdir,
  output_io: $stderr,
  filter_all_errors: false
)
  @binary_name = binary_name
  @ruby = ruby
  @valgrind = valgrind
  @valgrind_options = valgrind_options
  @valgrind_suppression_files =
    get_valgrind_suppression_files(File.join(__dir__, "../../suppressions")) +
    get_valgrind_suppression_files(valgrind_suppressions_dir)
  @valgrind_generate_suppressions = valgrind_generate_suppressions
  @skipped_ruby_functions = skipped_ruby_functions
  @output_io = output_io
  @filter_all_errors = filter_all_errors

  temp_dir = File.expand_path(temp_dir)
  FileUtils.mkdir_p(temp_dir)
  @temp_dir = temp_dir
  @valgrind_options += [
    "--xml=yes",
    # %p will be replaced with the PID
    # This prevents forking and shelling out from generating a corrupted XML
    # See --log-file from https://valgrind.org/docs/manual/manual-core.html
    "--xml-file=#{File.join(temp_dir, "%p.xml")}",
  ]

  @loaded_features_file = Tempfile.create("", @temp_dir)
end

Instance Attribute Details

#binary_name ⇒ Object (readonly)

Returns the value of attribute binary_name.



35
36
37
 
# File 'lib/ruby_memcheck/configuration.rb', line 35

def binary_name
  @binary_name
end

#filter_all_errors ⇒ Object (readonly) Also known as: filter_all_errors?

Returns the value of attribute filter_all_errors.



45
46
47
 
# File 'lib/ruby_memcheck/configuration.rb', line 45

def filter_all_errors
  @filter_all_errors
end

#loaded_features_file ⇒ Object (readonly)

Returns the value of attribute loaded_features_file.



43
44
45
 
# File 'lib/ruby_memcheck/configuration.rb', line 43

def loaded_features_file
  @loaded_features_file
end

#output_io ⇒ Object (readonly)

Returns the value of attribute output_io.



44
45
46
 
# File 'lib/ruby_memcheck/configuration.rb', line 44

def output_io
  @output_io
end

#ruby ⇒ Object (readonly)

Returns the value of attribute ruby.



36
37
38
 
# File 'lib/ruby_memcheck/configuration.rb', line 36

def ruby
  @ruby
end

#skipped_ruby_functions ⇒ Object (readonly)

Returns the value of attribute skipped_ruby_functions.



41
42
43
 
# File 'lib/ruby_memcheck/configuration.rb', line 41

def skipped_ruby_functions
  @skipped_ruby_functions
end

#temp_dir ⇒ Object (readonly)

Returns the value of attribute temp_dir.



42
43
44
 
# File 'lib/ruby_memcheck/configuration.rb', line 42

def temp_dir
  @temp_dir
end

#valgrind ⇒ Object (readonly)

Returns the value of attribute valgrind.



37
38
39
 
# File 'lib/ruby_memcheck/configuration.rb', line 37

def valgrind
  @valgrind
end

#valgrind_generate_suppressions ⇒ Object (readonly) Also known as: valgrind_generate_suppressions?

Returns the value of attribute valgrind_generate_suppressions.



40
41
42
 
# File 'lib/ruby_memcheck/configuration.rb', line 40

def valgrind_generate_suppressions
  @valgrind_generate_suppressions
end

#valgrind_options ⇒ Object (readonly)

Returns the value of attribute valgrind_options.



38
39
40
 
# File 'lib/ruby_memcheck/configuration.rb', line 38

def valgrind_options
  @valgrind_options
end

#valgrind_suppression_files ⇒ Object (readonly)

Returns the value of attribute valgrind_suppression_files.



39
40
41
 
# File 'lib/ruby_memcheck/configuration.rb', line 39

def valgrind_suppression_files
  @valgrind_suppression_files
end

Instance Method Details

#command(*args) ⇒ Object 



88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
 
# File 'lib/ruby_memcheck/configuration.rb', line 88

def command(*args)
  [
    # On some Rubies, not setting the stack size to be ulimited causes
    # Valgrind to report the following error:
    #   Invalid write of size 1
    #     reserve_stack (thread_pthread.c:845)
    #     ruby_init_stack (thread_pthread.c:871)
    #     main (main.c:48)
    "ulimit -s unlimited && ",
    valgrind,
    valgrind_options,
    valgrind_suppression_files.map { |f| "--suppressions=#{f}" },
    valgrind_generate_suppressions ? "--gen-suppressions=all" : "",
    ruby,
    "-r" + File.expand_path(File.join(__dir__, "test_helper.rb")),
    args,
  ].flatten.join(" ")
end