pf2 0.12.0 → 1.0.0.alpha1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ef67bdd8a362c1f5cd3dd37a47e13b64f5ee0663a204908d0f075d41acc94da3
-  data.tar.gz: 535d1fe8efb9a408ce47218910d6ad3ddfe88c2a4e4f42ac42c01ab8dceceacd
+  metadata.gz: 9f219b8aa5b5281a6ed662a085e00f82636ab52365d2b0f7a8d61a3e06bfc9c6
+  data.tar.gz: 162e1eae488afe17e33291f63f807642aa304d7df8069cb165e3a25ce6f10895
 SHA512:
-  metadata.gz: 15a65711f8c1a804b06d8b2195a9e620646972b7905a714fdab67561f9d796d7c92a1f332f9169ffa27c14b6b91d9f33ba254d84d47c281f66f7a069cc660d58
-  data.tar.gz: 411bdf85ef4db94bed73840224132498621f389e4f6092a45e222bf5834dd5d1e6aa6940cafcb56cdc86148163d1b9bda4eee45501cc9c307ce729894954613d
+  metadata.gz: 37b6a1aa4f6ab0753d86983d76cbdfae4b3dfbb7464afb0388aa113d728725f09eabcabb2ae7c2ffadc5ab797be75675b5b27b465c20565d5d69f30291d4837f
+  data.tar.gz: 7b69aea55c8873cfd6e28fba3bdddd09325e4c73e1e3e44a5be48fcb9ad776b03e811c707fc049ad8ccc1590e7c011032be7f4053e3d15a5ba5b50c4344db656

data/CHANGELOG.md

@@ -1,74 +1,5 @@
 ## [Unreleased]
 
-## [0.12.0] - 2026-01-09
-
-### Added
-
-- `Pf2.profile` now accepts the same options as `Pf2.start`.
-- The resulting profile now has `collected_sample_count` and `dropped_sample_count` fields.
-
-### Fixed
-
-- Samples captured after the collector thread was stopped now get included in the profile.
-  - This shouldn't matter in practice (this all happens after `Pf2.stop` is called).
-
-### Changed
-
-- Accepted max stack depth is expanded to 1024 for Ruby (was 200) and 512 for native (was 300).
-  - This is not configurable, but should be sufficient for most use cases. Please open an issue if you need higher limits.
-- Pf2.profile now accepts the same parameters as Pf2.start.
-- Internal changes
-  - Updated libbacktrace to the latest version as of 2026/1/8.
-  - Tests are now much more stabilized.
-
-
-## [0.11.3] - 2025-12-28
-
-This version is for testing the new release process through [Trusted Publishing](https://guides.rubygems.org/trusted-publishing/). All code is identical to 0.11.2.
-
-
-## [0.11.2] - 2025-12-28
-
-0.11.1 was yanked since it was accidentally published without libbacktrace vendored. Use 0.11.2.
-
-### Fixed
-
-- Fixed issues preventing builds on macOS.
-
-
-## [0.11.0] - 2025-12-27
-
-### Added
-
-- RDoc documentation is now online - https://osyoyu.github.io/pf2/
-- Native stack consolidation now supports LTO-ed binaries (@hanazuki)
-
-### Changed
-
-- `Pf2c` module is now completely removed. `Pf2c::Session` has been merged as `Pf2::Session`.
-
-### Fixed
-
-- Fixed an bug where the program crashes when a `Pf2::Session` is GC'd before profiling starts.
-- Fixed an bug where the program crashes when the native stack was more than 200 frames deep.
-
-
-## [0.10.0] - 2025-12-26
-
-### Added
-
-**This version contains a complete rewrite of the profiler!**
-
-- The default sample collection backend has been switched to the new C-based backend.
-  - The previous Rust-based backed has been removed. Use v0.9.0 if you need it.
-- macOS / non-Linux platform support!
-  - On platforms which lack `timer_create(3)` such as macOS, Pf2 now fall backs to `setitimer(3)` based sampling. This mode does not support per-thread CPU time sampling.
-
-### Changed
-
-- `logger` is now declared as a dependency (Ruby 4.0 compat).
-
-
 ## [0.9.0] - 2025-03-22
 
 ## Added
@@ -80,7 +11,6 @@ This version is for testing the new release process through [Trusted Publishing]
 
 - Set SA_RESTART flag to reduce EINTRs in profiled code
 
-
 ## [0.8.0] - 2025-01-27
 
 ## Added
@@ -89,14 +19,12 @@ This version is for testing the new release process through [Trusted Publishing]
   - This serializer is more efficient and has a smaller memory footprint than the default serializer.
   - Ser2 still lacks some features, such as weaving of native stacks.
 
-
 ## [0.7.1] - 2025-01-02
 
 ### Fixed
 
 - Reverted Cargo.lock version to 3 to support older versions of Rust (<1.78).
 
-
 ## [0.7.0] - 2025-01-03
 
 ### Changed

data/README.md

@@ -3,11 +3,6 @@ Pf2
 
 A experimental sampling-based profiler for Ruby 3.3+.
 
-- GitHub: https://github.com/osyoyu/pf2
-- Documentation: https://osyoyu.github.io/pf2/
-
-NOTE: This README contains some outdated information!
-
 Notable Capabilites
 --------
 
@@ -18,25 +13,6 @@ Notable Capabilites
 Usage
 --------
 
-### Installation
-
-You will need a C compiler to build the native extension.
-
-Add this line to your application's Gemfile:
-
-```ruby
-gem 'pf2'
-
-# When using the main branch, specify submodules: true
-gem 'pf2', git: 'https://github.com/osyoyu/pf2.git', submodules: true
-```
-
-Pf2 can be installed as a standalone CLI tool as well.
-
-```console
-gem install pf2
-```
-
 ### Quickstart
 
 Run your Ruby program through `pf2 serve`.

data/Rakefile

@@ -1,7 +1,6 @@
 require 'bundler/gem_tasks'
 require 'rake/extensiontask'
 require 'minitest/test_task'
-require 'rdoc/task'
 
 task default: %i[]
 
@@ -15,9 +14,4 @@ Minitest::TestTask.create(:test) do |t|
   t.libs << "lib"
   t.warning = false
   t.test_globs = ["test/**/*_test.rb"]
-  t.extra_args << "--verbose"
-end
-
-RDoc::Task.new do |doc|
-  doc.rdoc_dir = "_site" # for GitHub pages
 end

data/ext/pf2/configuration.c

@@ -1,12 +1,10 @@
 #include <ruby.h>
 #include <stdlib.h>
-#include <stdbool.h>
 
 #include "configuration.h"
 
 static int extract_interval_ms(VALUE options_hash);
 static enum pf2_time_mode extract_time_mode(VALUE options_hash);
-static bool extract__test_no_install_timer(VALUE options_hash);
 
 struct pf2_configuration *
 pf2_configuration_new_from_options_hash(VALUE options_hash)
@@ -18,7 +16,6 @@ pf2_configuration_new_from_options_hash(VALUE options_hash)
 
     config->interval_ms = extract_interval_ms(options_hash);
     config->time_mode = extract_time_mode(options_hash);
-    config->_test_no_install_timer = extract__test_no_install_timer(options_hash);
 
     return config;
 }
@@ -60,17 +57,6 @@ extract_time_mode(VALUE options_hash)
     }
 }
 
-static bool
-extract__test_no_install_timer(VALUE options_hash)
-{
-    if (options_hash == Qnil) {
-        return PF2_DEFAULT__TEST_NO_INSTALL_TIMER;
-    }
-
-    VALUE _test_no_install_timer = rb_hash_aref(options_hash, ID2SYM(rb_intern("_test_no_install_timer")));
-    return RTEST(_test_no_install_timer);
-}
-
 void
 pf2_configuration_free(struct pf2_configuration *config)
 {

data/ext/pf2/configuration.h

@@ -2,7 +2,6 @@
 #define PF2_CONFIGURATION_H
 
 #include <ruby.h>
-#include <stdbool.h>
 
 enum pf2_time_mode {
     PF2_TIME_MODE_CPU_TIME,
@@ -12,12 +11,10 @@ enum pf2_time_mode {
 struct pf2_configuration {
     int interval_ms;
     enum pf2_time_mode time_mode;
-    bool _test_no_install_timer; // for testing only
 };
 
 #define PF2_DEFAULT_INTERVAL_MS 9
 #define PF2_DEFAULT_TIME_MODE PF2_TIME_MODE_CPU_TIME
-#define PF2_DEFAULT__TEST_NO_INSTALL_TIMER false
 
 struct pf2_configuration *pf2_configuration_new_from_options_hash(VALUE options_hash);
 void pf2_configuration_free(struct pf2_configuration *config);

data/ext/pf2/extconf.rb

@@ -1,25 +1,10 @@
 require 'mkmf'
 require 'mini_portile2'
-require 'fileutils'
-
-gem_root = File.expand_path(File.join(File.dirname(__FILE__), '..', '..'))
 
 libbacktrace = MiniPortile.new('libbacktrace', '1.0.0')
-libbacktrace.source_directory = File.join(gem_root, 'vendor', 'libbacktrace')
-libbacktrace.patch_files = Dir.glob(File.join(gem_root, 'ext', 'patches', 'libbacktrace', '*.patch'))
+libbacktrace.source_directory = File.expand_path(File.join(File.dirname(__FILE__), '..', '..', 'vendor', 'libbacktrace'))
 libbacktrace.configure_options << 'CFLAGS=-fPIC'
-
-# Expand 'libbacktrace.cook' to call #patch on source_directory files
-libbacktrace.prepare_build_directory
-# Added: Copy source to build_directory
-build_directory = libbacktrace.send(:work_path)
-FileUtils.cp_r(File.join(libbacktrace.source_directory, '.'), build_directory)
-libbacktrace.patch
-libbacktrace.configure unless libbacktrace.configured?
-libbacktrace.compile
-libbacktrace.install unless libbacktrace.installed?
-# END expand 'libbacktrace.cook'
-
+libbacktrace.cook
 libbacktrace.mkmf_config
 
 if !have_func('backtrace_full', 'backtrace.h')

data/ext/pf2/pf2.c

@@ -2,16 +2,16 @@
 
 #include "session.h"
 
-VALUE rb_mPf2;
+VALUE rb_mPf2c;
 
 RUBY_FUNC_EXPORTED void
 Init_pf2(void)
 {
-    rb_mPf2 = rb_define_module("Pf2");
-    VALUE rb_mPf2_cSession = rb_define_class_under(rb_mPf2, "Session", rb_cObject);
-    rb_define_alloc_func(rb_mPf2_cSession, pf2_session_alloc);
-    rb_define_method(rb_mPf2_cSession, "initialize", rb_pf2_session_initialize, -1);
-    rb_define_method(rb_mPf2_cSession, "start", rb_pf2_session_start, 0);
-    rb_define_method(rb_mPf2_cSession, "stop", rb_pf2_session_stop, 0);
-    rb_define_method(rb_mPf2_cSession, "configuration", rb_pf2_session_configuration, 0);
+    rb_mPf2c = rb_define_module("Pf2c");
+    VALUE rb_mPf2c_cSession = rb_define_class_under(rb_mPf2c, "Session", rb_cObject);
+    rb_define_alloc_func(rb_mPf2c_cSession, pf2_session_alloc);
+    rb_define_method(rb_mPf2c_cSession, "initialize", rb_pf2_session_initialize, -1);
+    rb_define_method(rb_mPf2c_cSession, "start", rb_pf2_session_start, 0);
+    rb_define_method(rb_mPf2c_cSession, "stop", rb_pf2_session_stop, 0);
+    rb_define_method(rb_mPf2c_cSession, "configuration", rb_pf2_session_configuration, 0);
 }

data/ext/pf2/sample.c

@@ -9,6 +9,8 @@
 #include "backtrace_state.h"
 #include "sample.h"
 
+const int PF2_SAMPLE_MAX_NATIVE_DEPTH = 300;
+
 static int capture_native_backtrace(struct pf2_sample *sample);
 static int backtrace_on_ok(void *data, uintptr_t pc);
 
@@ -27,7 +29,7 @@ pf2_sample_capture(struct pf2_sample *sample)
     sample->context_pthread = pthread_self();
 
     // Obtain the current stack from Ruby
-    sample->depth = rb_profile_frames(0, PF2_SAMPLE_MAX_RUBY_DEPTH, sample->cmes, sample->linenos);
+    sample->depth = rb_profile_frames(0, 200, sample->cmes, sample->linenos);
 
     // Capture C-level backtrace
     sample->native_stack_depth = capture_native_backtrace(sample);

data/ext/pf2/sample.h

@@ -5,18 +5,17 @@
 
 #include <ruby.h>
 
-#define PF2_SAMPLE_MAX_RUBY_DEPTH 1024
-#define PF2_SAMPLE_MAX_NATIVE_DEPTH 512
+extern const int PF2_SAMPLE_MAX_NATIVE_DEPTH;
 
 struct pf2_sample {
     pthread_t context_pthread;
 
     int depth;
-    VALUE cmes[PF2_SAMPLE_MAX_RUBY_DEPTH];
-    int linenos[PF2_SAMPLE_MAX_RUBY_DEPTH];
+    VALUE cmes[200];
+    int linenos[200];
 
     size_t native_stack_depth;
-    uintptr_t native_stack[PF2_SAMPLE_MAX_NATIVE_DEPTH];
+    uintptr_t native_stack[200];
 
     uint64_t consumed_time_ns;
     uint64_t timestamp_ns;

data/ext/pf2/serializer.c

@@ -1,7 +1,6 @@
 #include <time.h>
 #include <stdint.h>
 #include <string.h>
-#include <stdatomic.h>
 
 #include <ruby.h>
 #include <ruby/debug.h>
@@ -17,8 +16,8 @@ static struct pf2_ser_function extract_function_from_ruby_frame(VALUE frame);
 static struct pf2_ser_function extract_function_from_native_pc(uintptr_t pc);
 // static int backtrace_pcinfo_callback(void *data, uintptr_t pc, const char *filename, int lineno, const char *function);
 static void pf2_backtrace_syminfo_callback(void *data, uintptr_t pc, const char *symname, uintptr_t symval, uintptr_t symsize);
-static size_t function_index_for(struct pf2_ser *serializer, struct pf2_ser_function *function);
-static size_t location_index_for(struct pf2_ser *serializer, size_t function_index, int32_t lineno);
+static int function_index_for(struct pf2_ser *serializer, struct pf2_ser_function *function);
+static int location_index_for(struct pf2_ser *serializer, int function_index, int32_t lineno);
 static void ensure_samples_capacity(struct pf2_ser *serializer);
 static void ensure_locations_capacity(struct pf2_ser *serializer);
 static void ensure_functions_capacity(struct pf2_ser *serializer);
@@ -30,9 +29,6 @@ pf2_ser_new(void) {
     ser->start_timestamp_ns = 0;
     ser->duration_ns = 0;
 
-    ser->collected_sample_count = 0;
-    ser->dropped_sample_count = 0;
-
     ser->samples = NULL;
     ser->samples_count = 0;
     ser->samples_capacity = 0;
@@ -80,10 +76,6 @@ pf2_ser_prepare(struct pf2_ser *serializer, struct pf2_session *session) {
         (uint64_t)session->start_time_realtime.tv_sec * 1000000000ULL +
         (uint64_t)session->start_time_realtime.tv_nsec;
     serializer->duration_ns = session->duration_ns;
-    serializer->collected_sample_count =
-        atomic_load_explicit(&session->collected_sample_count, memory_order_relaxed);
-    serializer->dropped_sample_count =
-        atomic_load_explicit(&session->dropped_sample_count, memory_order_relaxed);
 
     // Process samples
     for (size_t i = 0; i < session->samples_index; i++) {
@@ -91,7 +83,7 @@ pf2_ser_prepare(struct pf2_ser *serializer, struct pf2_session *session) {
         ensure_samples_capacity(serializer);
 
         struct pf2_ser_sample *ser_sample = &serializer->samples[serializer->samples_count++];
-        ser_sample->ruby_thread_id = (uintptr_t)sample->context_pthread;
+        ser_sample->ruby_thread_id = sample->context_pthread;
         ser_sample->elapsed_ns = sample->timestamp_ns - serializer->start_timestamp_ns;
 
         // Copy and process Ruby stack frames
@@ -135,8 +127,6 @@ pf2_ser_to_ruby_hash(struct pf2_ser *serializer) {
     // Add metadata
     rb_hash_aset(hash, ID2SYM(rb_intern("start_timestamp_ns")), ULL2NUM(serializer->start_timestamp_ns));
     rb_hash_aset(hash, ID2SYM(rb_intern("duration_ns")), ULL2NUM(serializer->duration_ns));
-    rb_hash_aset(hash, ID2SYM(rb_intern("collected_sample_count")), ULL2NUM(serializer->collected_sample_count));
-    rb_hash_aset(hash, ID2SYM(rb_intern("dropped_sample_count")), ULL2NUM(serializer->dropped_sample_count));
 
     // Add samples
     VALUE samples = rb_ary_new_capa(serializer->samples_count);
@@ -155,7 +145,7 @@ pf2_ser_to_ruby_hash(struct pf2_ser *serializer) {
         VALUE native_stack = rb_ary_new_capa(sample->native_stack_count);
         if (sample->native_stack != NULL) {
             for (size_t j = 0; j < sample->native_stack_count; j++) {
-                rb_ary_push(native_stack, SIZET2NUM(sample->native_stack[j]));
+                rb_ary_push(native_stack, ULL2NUM(sample->native_stack[j]));
             }
         }
         rb_hash_aset(sample_hash, ID2SYM(rb_intern("native_stack")), native_stack);
@@ -164,7 +154,7 @@ pf2_ser_to_ruby_hash(struct pf2_ser *serializer) {
         rb_hash_aset(
             sample_hash,
             ID2SYM(rb_intern("ruby_thread_id")),
-            sample->ruby_thread_id ? ULL2NUM(sample->ruby_thread_id) : Qnil
+            sample->ruby_thread_id ? SIZET2NUM(sample->ruby_thread_id) : Qnil
         );
         rb_hash_aset(sample_hash, ID2SYM(rb_intern("elapsed_ns")), ULL2NUM(sample->elapsed_ns));
 
@@ -314,7 +304,7 @@ pf2_backtrace_syminfo_callback(void *data, uintptr_t pc, const char *symname, ui
 
 // Returns the index of the function in `functions`.
 // Calling this method will modify `serializer->profile` in place.
-static size_t
+static int
 function_index_for(struct pf2_ser *serializer, struct pf2_ser_function *function) {
     for (size_t i = 0; i < serializer->functions_count; i++) {
         struct pf2_ser_function *existing = &serializer->functions[i];
@@ -342,8 +332,8 @@ function_index_for(struct pf2_ser *serializer, struct pf2_ser_function *function
 
 // Returns the index of the location in `locations`.
 // Calling this method will modify `self.profile` in place.
-static size_t
-location_index_for(struct pf2_ser *serializer, size_t function_index, int32_t lineno) {
+static int
+location_index_for(struct pf2_ser *serializer, int function_index, int32_t lineno) {
     for (size_t i = 0; i < serializer->locations_count; i++) {
         struct pf2_ser_location *existing = &serializer->locations[i];
         if (existing->function_index == function_index && existing->lineno == lineno) {

data/ext/pf2/serializer.h

@@ -1,23 +1,21 @@
 #ifndef PF2C_SERIALIZER_H
 #define PF2C_SERIALIZER_H
 
-#include <stdint.h>
-
 #include <ruby.h>
 
 #include "session.h"
 
 struct pf2_ser_sample {
-    size_t *stack; // array of location_indexes
+    int *stack;
     size_t stack_count;
-    size_t *native_stack; // array of location_indexes
+    int *native_stack;
     size_t native_stack_count;
-    uintptr_t ruby_thread_id;
+    size_t ruby_thread_id;
     uint64_t elapsed_ns;
 };
 
 struct pf2_ser_location {
-    size_t function_index;
+    int function_index;
     int32_t lineno;
     size_t address;
 };
@@ -38,8 +36,6 @@ struct pf2_ser_function {
 struct pf2_ser {
     uint64_t start_timestamp_ns;
     uint64_t duration_ns;
-    uint64_t collected_sample_count;
-    uint64_t dropped_sample_count;
 
     struct pf2_ser_sample *samples;
     size_t samples_count;

data/ext/pf2/session.c

@@ -1,3 +1,4 @@
+#include <bits/time.h>
 #include <pthread.h>
 #include <signal.h>
 #include <stdatomic.h>
@@ -19,14 +20,14 @@
 #include "session.h"
 #include "serializer.h"
 
-// Pointer to current active session, for access from signal handlers
+#ifndef HAVE_TIMER_CREATE
+// Global session pointer for setitimer fallback
 static struct pf2_session *global_current_session = NULL;
+#endif
 
 static void *sample_collector_thread(void *arg);
-static void drain_ringbuffer(struct pf2_session *session);
 static void sigprof_handler(int sig, siginfo_t *info, void *ucontext);
 bool ensure_sample_capacity(struct pf2_session *session);
-static void pf2_session_stop(struct pf2_session *session);
 
 VALUE
 rb_pf2_session_initialize(int argc, VALUE *argv, VALUE self)
@@ -39,11 +40,10 @@ rb_pf2_session_initialize(int argc, VALUE *argv, VALUE self)
     rb_scan_args(argc, argv, ":", &kwargs);
     ID kwarg_labels[] = {
         rb_intern("interval_ms"),
-        rb_intern("time_mode"),
-        rb_intern("_test_no_install_timer")
+        rb_intern("time_mode")
     };
     VALUE *kwarg_values = NULL;
-    rb_get_kwargs(kwargs, kwarg_labels, 0, 3, kwarg_values);
+    rb_get_kwargs(kwargs, kwarg_labels, 0, 2, kwarg_values);
 
     session->configuration = pf2_configuration_new_from_options_hash(kwargs);
 
@@ -56,9 +56,6 @@ rb_pf2_session_start(VALUE self)
     struct pf2_session *session;
     TypedData_Get_Struct(self, struct pf2_session, &pf2_session_type, session);
 
-    // Store pointer to current session for access from signal handlers
-    global_current_session = session;
-
     session->is_running = true;
 
     // Record start time
@@ -90,60 +87,58 @@ rb_pf2_session_start(VALUE self)
     }
 #endif
 
-    global_current_session = session;
-
-    if (!session->configuration->_test_no_install_timer) {
 #ifdef HAVE_TIMER_CREATE
-        // Configure a kernel timer to send SIGPROF periodically
-        struct sigevent sev;
-        sev.sigev_notify = SIGEV_SIGNAL;
-        sev.sigev_signo = SIGPROF;
-        if (timer_create(
-            session->configuration->time_mode == PF2_TIME_MODE_CPU_TIME
-                ? CLOCK_PROCESS_CPUTIME_ID
-                : CLOCK_MONOTONIC,
-            &sev,
-            &session->timer
-        ) == -1) {
-            rb_raise(rb_eRuntimeError, "Failed to create timer");
-        }
-        struct itimerspec its = {
-            .it_value = {
-                .tv_sec = 0,
-                .tv_nsec = session->configuration->interval_ms * 1000000,
-            },
-            .it_interval = {
-                .tv_sec = 0,
-                .tv_nsec = session->configuration->interval_ms * 1000000,
-            },
-        };
-        if (timer_settime(session->timer, 0, &its, NULL) == -1) {
-            rb_raise(rb_eRuntimeError, "Failed to start timer");
-        }
+    // Configure a kernel timer to send SIGPROF periodically
+    struct sigevent sev;
+    sev.sigev_notify = SIGEV_SIGNAL;
+    sev.sigev_signo = SIGPROF;
+    sev.sigev_value.sival_ptr = session; // Passed as info->si_value.sival_ptr
+    if (timer_create(
+        session->configuration->time_mode == PF2_TIME_MODE_CPU_TIME
+            ? CLOCK_PROCESS_CPUTIME_ID
+            : CLOCK_MONOTONIC,
+        &sev,
+        &session->timer
+    ) == -1) {
+        rb_raise(rb_eRuntimeError, "Failed to create timer");
+    }
+    struct itimerspec its = {
+        .it_value = {
+            .tv_sec = 0,
+            .tv_nsec = session->configuration->interval_ms * 1000000,
+        },
+        .it_interval = {
+            .tv_sec = 0,
+            .tv_nsec = session->configuration->interval_ms * 1000000,
+        },
+    };
+    if (timer_settime(session->timer, 0, &its, NULL) == -1) {
+        rb_raise(rb_eRuntimeError, "Failed to start timer");
+    }
 #else
-        // Use setitimer as fallback
-        // Some platforms (e.g. macOS) do not have timer_create(3).
-        // setitimer(3) can be used as a alternative, but has limited functionality.
-
-        struct itimerval itv = {
-            .it_value = {
-                .tv_sec = 0,
-                .tv_usec = session->configuration->interval_ms * 1000,
-            },
-            .it_interval = {
-                .tv_sec = 0,
-                .tv_usec = session->configuration->interval_ms * 1000,
-            },
-        };
-        int which_timer = session->configuration->time_mode == PF2_TIME_MODE_CPU_TIME
-            ? ITIMER_PROF  // CPU time (sends SIGPROF)
-            : ITIMER_REAL; // Wall time (sends SIGALRM)
-
-        if (setitimer(which_timer, &itv, NULL) == -1) {
-            rb_raise(rb_eRuntimeError, "Failed to start timer");
-        }
+    // Use setitimer as fallback
+    // Some platforms (e.g. macOS) do not have timer_create(3).
+    // setitimer(3) can be used as a alternative, but has limited functionality.
+    global_current_session = session;
+
+    struct itimerval itv = {
+        .it_value = {
+            .tv_sec = 0,
+            .tv_usec = session->configuration->interval_ms * 1000,
+        },
+        .it_interval = {
+            .tv_sec = 0,
+            .tv_usec = session->configuration->interval_ms * 1000,
+        },
+    };
+    int which_timer = session->configuration->time_mode == PF2_TIME_MODE_CPU_TIME
+        ? ITIMER_PROF  // CPU time (sends SIGPROF)
+        : ITIMER_REAL; // Wall time (sends SIGALRM)
+
+    if (setitimer(which_timer, &itv, NULL) == -1) {
+        rb_raise(rb_eRuntimeError, "Failed to start timer");
+    }
 #endif
-    } // if !__test_no_install_timer
 
     return Qtrue;
 }
@@ -155,7 +150,17 @@ sample_collector_thread(void *arg)
 
     while (session->is_running == true) {
         // Take samples from the ring buffer
-        drain_ringbuffer(session);
+        struct pf2_sample sample;
+        while (pf2_ringbuffer_pop(session->rbuf, &sample) == true) {
+            // Ensure we have capacity before adding a new sample
+            if (!ensure_sample_capacity(session)) {
+                // Failed to expand buffer
+                PF2_DEBUG_LOG("Failed to expand sample buffer. Dropping sample\n");
+                break;
+            }
+
+            session->samples[session->samples_index++] = sample;
+        }
 
         // Sleep for 100 ms
         // TODO: Replace with high watermark callback
@@ -166,24 +171,6 @@ sample_collector_thread(void *arg)
     return NULL;
 }
 
-static void
-drain_ringbuffer(struct pf2_session *session)
-{
-    struct pf2_sample sample;
-    while (pf2_ringbuffer_pop(session->rbuf, &sample) == true) {
-        // Ensure we have capacity before adding a new sample
-        if (!ensure_sample_capacity(session)) {
-            // Failed to expand buffer
-            atomic_fetch_add_explicit(&session->dropped_sample_count, 1, memory_order_relaxed);
-            PF2_DEBUG_LOG("Failed to expand sample buffer. Dropping sample\n");
-            break;
-        }
-
-        session->samples[session->samples_index++] = sample;
-        atomic_fetch_add_explicit(&session->collected_sample_count, 1, memory_order_relaxed);
-    }
-}
-
 // async-signal-safe
 static void
 sigprof_handler(int sig, siginfo_t *info, void *ucontext)
@@ -193,12 +180,16 @@ sigprof_handler(int sig, siginfo_t *info, void *ucontext)
     clock_gettime(CLOCK_MONOTONIC, &sig_start_time);
 #endif
 
-    struct pf2_session *session = global_current_session;
+    struct pf2_session *session;
+#ifdef HAVE_TIMER_CREATE
+    session = info->si_value.sival_ptr;
+#else
+    session = global_current_session;
+#endif
 
     // If garbage collection is in progress, don't collect samples.
     if (atomic_load_explicit(&session->is_marking, memory_order_acquire)) {
         PF2_DEBUG_LOG("Dropping sample: Garbage collection is in progress\n");
-        atomic_fetch_add_explicit(&session->dropped_sample_count, 1, memory_order_relaxed);
         return;
     }
 
@@ -206,7 +197,6 @@ sigprof_handler(int sig, siginfo_t *info, void *ucontext)
 
     if (pf2_sample_capture(&sample) == false) {
         PF2_DEBUG_LOG("Dropping sample: Failed to capture sample\n");
-        atomic_fetch_add_explicit(&session->dropped_sample_count, 1, memory_order_relaxed);
         return;
     }
 
@@ -214,7 +204,6 @@ sigprof_handler(int sig, siginfo_t *info, void *ucontext)
     if (pf2_ringbuffer_push(session->rbuf, &sample) == false) {
         // Copy failed. The sample buffer is full.
         PF2_DEBUG_LOG("Dropping sample: Sample buffer is full\n");
-        atomic_fetch_add_explicit(&session->dropped_sample_count, 1, memory_order_relaxed);
         return;
     }
 
@@ -262,20 +251,6 @@ rb_pf2_session_stop(VALUE self)
     struct pf2_session *session;
     TypedData_Get_Struct(self, struct pf2_session, &pf2_session_type, session);
 
-    pf2_session_stop(session);
-
-    // Create serializer and serialize
-    struct pf2_ser *serializer = pf2_ser_new();
-    pf2_ser_prepare(serializer, session);
-    VALUE result = pf2_ser_to_ruby_hash(serializer);
-    pf2_ser_free(serializer);
-
-    return result;
-}
-
-static void
-pf2_session_stop(struct pf2_session *session)
-{
     // Calculate duration
     struct timespec end_time;
     clock_gettime(CLOCK_MONOTONIC, &end_time);
@@ -285,10 +260,8 @@ pf2_session_stop(struct pf2_session *session)
 
     // Disarm and delete the timer.
 #ifdef HAVE_TIMER_CREATE
-    if (!session->configuration->_test_no_install_timer) {
-        if (timer_delete(session->timer) == -1) {
-            rb_raise(rb_eRuntimeError, "Failed to delete timer");
-        }
+    if (timer_delete(session->timer) == -1) {
+        rb_raise(rb_eRuntimeError, "Failed to delete timer");
     }
 #else
     struct itimerval zero_timer = {{0, 0}, {0, 0}};
@@ -304,7 +277,14 @@ pf2_session_stop(struct pf2_session *session)
     // Terminate the collector thread
     session->is_running = false;
     pthread_join(*session->collector_thread, NULL);
-    drain_ringbuffer(session);
+
+    // Create serializer and serialize
+    struct pf2_ser *serializer = pf2_ser_new();
+    pf2_ser_prepare(serializer, session);
+    VALUE result = pf2_ser_to_ruby_hash(serializer);
+    pf2_ser_free(serializer);
+
+    return result;
 }
 
 VALUE
@@ -320,7 +300,7 @@ pf2_session_alloc(VALUE self)
 {
     // Initialize state for libbacktrace
     if (global_backtrace_state == NULL) {
-        global_backtrace_state = backtrace_create_state(NULL, 1, pf2_backtrace_print_error, NULL);
+        global_backtrace_state = backtrace_create_state("pf2", 1, pf2_backtrace_print_error, NULL);
         if (global_backtrace_state == NULL) {
             rb_raise(rb_eRuntimeError, "Failed to initialize libbacktrace");
         }
@@ -331,32 +311,19 @@ pf2_session_alloc(VALUE self)
         rb_raise(rb_eNoMemError, "Failed to allocate memory");
     }
 
-    // is_running
-    session->is_running = false;
-
-    // timer
-#ifdef HAVE_TIMER_CREATE
-    session->timer = (timer_t)0;
-#else
-    session->timer = (struct itimerval){0};
-#endif
-
-    // rbuf
     session->rbuf = pf2_ringbuffer_new(1000);
     if (session->rbuf == NULL) {
         rb_raise(rb_eNoMemError, "Failed to allocate memory");
     }
 
-    // is_marking
     atomic_store_explicit(&session->is_marking, false, memory_order_relaxed);
-
-    // collector_thread
     session->collector_thread = malloc(sizeof(pthread_t));
     if (session->collector_thread == NULL) {
         rb_raise(rb_eNoMemError, "Failed to allocate memory");
     }
 
-    // samples, samples_index, samples_capacity
+    session->duration_ns = 0;
+
     session->samples_index = 0;
     session->samples_capacity = 500; // 10 seconds worth of samples at 50 Hz
     session->samples = malloc(sizeof(struct pf2_sample) * session->samples_capacity);
@@ -364,18 +331,6 @@ pf2_session_alloc(VALUE self)
         rb_raise(rb_eNoMemError, "Failed to allocate memory");
     }
 
-    // collected_sample_count, dropped_sample_count
-    atomic_store_explicit(&session->collected_sample_count, 0, memory_order_relaxed);
-    atomic_store_explicit(&session->dropped_sample_count, 0, memory_order_relaxed);
-
-    // start_time_realtime, start_time
-    session->start_time_realtime = (struct timespec){0};
-    session->start_time = (struct timespec){0};
-
-    // duration_ns
-    session->duration_ns = 0;
-
-    // configuration
     session->configuration = NULL;
 
     return TypedData_Wrap_Struct(self, &pf2_session_type, session);
@@ -418,15 +373,8 @@ pf2_session_dmark(void *sess)
 void
 pf2_session_dfree(void *sess)
 {
+    // TODO: Ensure the uninstall process is complete before freeing the session
     struct pf2_session *session = sess;
-
-    assert(session->is_running == false || session->is_running == true);
-
-    // Stop the session if it's still running
-    if (session->is_running) {
-        pf2_session_stop(session);
-    }
-
     pf2_configuration_free(session->configuration);
     pf2_ringbuffer_free(session->rbuf);
     free(session->samples);

data/ext/pf2/session.h

@@ -30,9 +30,6 @@ struct pf2_session {
     struct timespec start_time; // When profiling started
     uint64_t duration_ns; // Duration of profiling in nanoseconds
 
-    atomic_uint_fast64_t collected_sample_count; // Number of samples copied out of the ringbuffer
-    atomic_uint_fast64_t dropped_sample_count; // Number of samples dropped for any reason
-
     struct pf2_configuration *configuration;
 };
 
@@ -46,14 +43,14 @@ void pf2_session_dfree(void *sess);
 size_t pf2_session_dsize(const void *sess);
 
 static const rb_data_type_t pf2_session_type = {
-    .wrap_struct_name = "Pf2::Session",
+    .wrap_struct_name = "Pf2c::Session",
     .function = {
         .dmark = pf2_session_dmark,
         .dfree = pf2_session_dfree,
         .dsize = pf2_session_dsize,
     },
     .data = NULL,
-    .flags = 0,
+    .flags = RUBY_TYPED_FREE_IMMEDIATELY,
 };
 
 #endif // PF2_SESSION_H

data/lib/pf2/cli.rb

@@ -26,7 +26,7 @@ module Pf2
       when 'version'
         puts VERSION
         return 0
-      when nil, '--help'
+      when '--help'
         STDERR.puts <<~__EOS__
         Usage: #{program_name} COMMAND [options]
 

data/lib/pf2/reporter/stack_weaver.rb

@@ -82,7 +82,7 @@ module Pf2
 
         # If the next function is a vm_exec_core() (= VM_EXEC in vm_exec.h),
         # we switch to the Ruby stack.
-        function[:name]&.match?(/\Avm_exec_core(?:\.lto_priv\.\d+)?\z/)
+        function[:name] == 'vm_exec_core'
       end
     end
   end

data/lib/pf2/session.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module Pf2
+  class Session
+    attr_reader :configuration
+
+    # Implementation is in Rust code.
+  end
+end

data/lib/pf2/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Pf2
-  VERSION = '0.12.0'
+  VERSION = '1.0.0.alpha1'
 end

data/lib/pf2.rb

@@ -1,13 +1,14 @@
 # frozen_string_literal: true
 
 require_relative 'pf2/pf2'
+require_relative 'pf2/session'
 require_relative 'pf2/version'
 
 module Pf2
   class Error < StandardError; end
 
   def self.start(...)
-    @@session = Session.new(...)
+    @@session = Pf2c::Session.new(...)
     @@session.start
   end
 
@@ -15,17 +16,9 @@ module Pf2
     @@session.stop
   end
 
-  # Profiles the given block of code.
-  #
-  # Example:
-  #
-  #     profile = Pf2.profile(interval_ms: 42) do
-  #       your_code_here
-  #     end
-  #
-  def self.profile(**kwargs, &block)
+  def self.profile(&block)
     raise ArgumentError, "block required" unless block_given?
-    start(**kwargs)
+    start(threads: Thread.list)
     yield
     result = stop
     @@session = nil # let GC clean up the session

data/vendor/libbacktrace/atomic.c

@@ -103,7 +103,7 @@ backtrace_atomic_store_size_t (size_t *p, size_t v)
 void
 backtrace_atomic_store_int (int *p, int v)
 {
-  int old;
+  size_t old;
 
   old = *p;
   while (!__sync_bool_compare_and_swap (p, old, v))

data/vendor/libbacktrace/configure

@@ -812,7 +812,6 @@ enable_darwin_at_rpath
 enable_largefile
 enable_werror
 with_system_libunwind
-enable_host_pie
 enable_host_shared
 '
       ac_precious_vars='build_alias
@@ -1462,7 +1461,6 @@ Optional Features:
                           rpaths to be added to executables
   --disable-largefile     omit support for large files
   --disable-werror        disable building with -Werror
-  --enable-host-pie       build host code as PIE
   --enable-host-shared    build host code as shared libraries
 
 Optional Packages:
@@ -11397,7 +11395,7 @@ else
   lt_dlunknown=0; lt_dlno_uscore=1; lt_dlneed_uscore=2
   lt_status=$lt_dlunknown
   cat > conftest.$ac_ext <<_LT_EOF
-#line 11400 "configure"
+#line 11398 "configure"
 #include "confdefs.h"
 
 #if HAVE_DLFCN_H
@@ -11503,7 +11501,7 @@ else
   lt_dlunknown=0; lt_dlno_uscore=1; lt_dlneed_uscore=2
   lt_status=$lt_dlunknown
   cat > conftest.$ac_ext <<_LT_EOF
-#line 11506 "configure"
+#line 11504 "configure"
 #include "confdefs.h"
 
 #if HAVE_DLFCN_H
@@ -12192,18 +12190,12 @@ $as_echo "#define HAVE_GETIPINFO 1" >>confdefs.h
   fi
 fi
 
-# Enable --enable-host-pie.
-# Check whether --enable-host-pie was given.
-if test "${enable_host_pie+set}" = set; then :
-  enableval=$enable_host_pie; PIC_FLAG=-fPIE
-else
-  PIC_FLAG=
-fi
-
 # Enable --enable-host-shared.
 # Check whether --enable-host-shared was given.
 if test "${enable_host_shared+set}" = set; then :
   enableval=$enable_host_shared; PIC_FLAG=-fPIC
+else
+  PIC_FLAG=
 fi
 
 

data/vendor/libbacktrace/configure.ac

@@ -176,16 +176,11 @@ else
   fi
 fi
 
-# Enable --enable-host-pie.
-AC_ARG_ENABLE(host-pie,
-[AS_HELP_STRING([--enable-host-pie],
-                [build host code as PIE])],
-[PIC_FLAG=-fPIE], [PIC_FLAG=])
 # Enable --enable-host-shared.
 AC_ARG_ENABLE(host-shared,
 [AS_HELP_STRING([--enable-host-shared],
 		[build host code as shared libraries])],
-[PIC_FLAG=-fPIC])
+[PIC_FLAG=-fPIC], [PIC_FLAG=])
 AC_SUBST(PIC_FLAG)
 
 # Test for __sync support.

data/vendor/libbacktrace/elf.c

@@ -160,10 +160,10 @@ dl_iterate_phdr (int (*callback) (struct dl_phdr_info *,
 #undef EI_CLASS
 #undef EI_DATA
 #undef EI_VERSION
-#undef ELFMAG0
-#undef ELFMAG1
-#undef ELFMAG2
-#undef ELFMAG3
+#undef ELF_MAG0
+#undef ELF_MAG1
+#undef ELF_MAG2
+#undef ELF_MAG3
 #undef ELFCLASS32
 #undef ELFCLASS64
 #undef ELFDATA2LSB

data/vendor/libbacktrace/fileline.c

@@ -47,10 +47,6 @@ POSSIBILITY OF SUCH DAMAGE.  */
 #include <mach-o/dyld.h>
 #endif
 
-#ifdef __hpux__
-#include <dl.h>
-#endif
-
 #ifdef HAVE_WINDOWS_H
 #ifndef WIN32_LEAN_AND_MEAN
 #define WIN32_LEAN_AND_MEAN
@@ -70,33 +66,6 @@ POSSIBILITY OF SUCH DAMAGE.  */
 #define getexecname() NULL
 #endif
 
-#ifdef __hpux__
-static char *
-hpux_get_executable_path (struct backtrace_state *state,
-			  backtrace_error_callback error_callback, void *data)
-{
-  struct shl_descriptor *desc;
-  size_t len = sizeof (struct shl_descriptor);
-
-  desc = backtrace_alloc (state, len, error_callback, data);
-  if (desc == NULL)
-    return NULL;
-
-  if (shl_get_r (0, desc) == -1)
-    {
-      backtrace_free (state, desc, len, error_callback, data);
-      return NULL;
-    }
-
-  return desc->filename;
-}
-
-#else
-
-#define hpux_get_executable_path(state, error_callback, data) NULL
-
-#endif
-
 #if !defined (HAVE_KERN_PROC_ARGS) && !defined (HAVE_KERN_PROC)
 
 #define sysctl_exec_name1(state, error_callback, data) NULL
@@ -276,7 +245,7 @@ fileline_initialize (struct backtrace_state *state,
 
   descriptor = -1;
   called_error_callback = 0;
-  for (pass = 0; pass < 11; ++pass)
+  for (pass = 0; pass < 10; ++pass)
     {
       int does_not_exist;
 
@@ -316,9 +285,6 @@ fileline_initialize (struct backtrace_state *state,
 	case 9:
 	  filename = windows_get_executable_path (buf, error_callback, data);
 	  break;
-	case 10:
-	  filename = hpux_get_executable_path (state, error_callback, data);
-	  break;
 	default:
 	  abort ();
 	}

data/vendor/libbacktrace/filetype.awk

@@ -3,7 +3,6 @@
 /^\177ELF\002/      { if (NR == 1) { print "elf64"; exit } }
 /^\114\001/         { if (NR == 1) { print "pecoff"; exit } }
 /^\144\206/         { if (NR == 1) { print "pecoff"; exit } }
-/^\000\000\377\377/ { if (NR == 1) { print "pecoff"; exit } }
 /^\001\337/         { if (NR == 1) { print "xcoff32"; exit } }
 /^\001\367/         { if (NR == 1) { print "xcoff64"; exit } }
 /^\376\355\372\316/ { if (NR == 1) { print "macho"; exit } }

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: pf2
 version: !ruby/object:Gem::Version
-  version: 0.12.0
+  version: 1.0.0.alpha1
 platform: ruby
 authors:
 - Daisuke Aritomo
@@ -9,20 +9,6 @@ bindir: exe
 cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
-- !ruby/object:Gem::Dependency
-  name: logger
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
 - !ruby/object:Gem::Dependency
   name: rake-compiler
   requirement: !ruby/object:Gem::Requirement
@@ -93,20 +79,6 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-- !ruby/object:Gem::Dependency
-  name: rdoc
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
 email:
 - osyoyu@osyoyu.com
 executables:
@@ -115,8 +87,6 @@ extensions:
 - ext/pf2/extconf.rb
 extra_rdoc_files: []
 files:
-- ".document"
-- ".rdoc_options"
 - CHANGELOG.md
 - LICENSE.txt
 - README.md
@@ -125,7 +95,6 @@ files:
 - examples/mandelbrot.rb
 - examples/mandelbrot_ractor.rb
 - exe/pf2
-- ext/patches/libbacktrace/0001-Support-MACH_O_MH_BUNDLE.patch
 - ext/pf2/backtrace_state.c
 - ext/pf2/backtrace_state.h
 - ext/pf2/configuration.c
@@ -149,6 +118,7 @@ files:
 - lib/pf2/reporter/firefox_profiler_ser2.rb
 - lib/pf2/reporter/stack_weaver.rb
 - lib/pf2/serve.rb
+- lib/pf2/session.rb
 - lib/pf2/version.rb
 - vendor/libbacktrace/.gitignore
 - vendor/libbacktrace/Isaac.Newton-Opticks.txt
@@ -242,7 +212,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.3
+rubygems_version: 3.8.0.dev
 specification_version: 4
 summary: Yet another Ruby profiler
 test_files: []

data/.document

@@ -1,3 +0,0 @@
-ext/
-lib/
-*.md

data/.rdoc_options

@@ -1,6 +0,0 @@
-title: Pf2
-main_page: README.md
-encoding: UTF-8
-
-autolink_excluded_words:
-  - Pf2

data/ext/patches/libbacktrace/0001-Support-MACH_O_MH_BUNDLE.patch

@@ -1,32 +0,0 @@
-From 4cd047583bc48ad0617fb6c036174de062573e68 Mon Sep 17 00:00:00 2001
-From: Daisuke Aritomo <osyoyu@osyoyu.com>
-Date: Wed, 7 Jan 2026 02:50:54 +0900
-Subject: [PATCH] Support MACH_O_MH_BUNDLE
-
----
- macho.c | 2 ++
- 1 file changed, 2 insertions(+)
-
-diff --git a/macho.c b/macho.c
-index 9f8738d..5ea07ae 100644
---- a/macho.c
-+++ b/macho.c
-@@ -92,6 +92,7 @@ struct macho_header_fat
- 
- #define MACH_O_MH_EXECUTE	0x02
- #define MACH_O_MH_DYLIB		0x06
-+#define MACH_O_MH_BUNDLE	0x08
- #define MACH_O_MH_DSYM		0x0a
- 
- /* A component of a fat file.  A fat file starts with a
-@@ -1062,6 +1063,7 @@ macho_add (struct backtrace_state *state, const char *filename, int descriptor,
-     {
-     case MACH_O_MH_EXECUTE:
-     case MACH_O_MH_DYLIB:
-+    case MACH_O_MH_BUNDLE:
-     case MACH_O_MH_DSYM:
-       break;
-     default:
--- 
-2.39.5 (Apple Git-154)
-