Gecko [ beriskala.com ]

Name	Size	Permission	Date
Backtrace	[ DIR ]	drwxr-xr-x	2026-05-05 23:08
ConditionVariable	[ DIR ]	drwxr-xr-x	2026-05-05 23:08
Mutex	[ DIR ]	drwxr-xr-x	2026-05-05 23:08
Queue	[ DIR ]	drwxr-xr-x	2026-05-05 23:08
SizedQueue	[ DIR ]	drwxr-xr-x	2026-05-05 23:08
%5b%5d%3d-i.ri	577 B	-rw-r--r--	2026-04-07 17:42
%5b%5d-i.ri	2.05 KB	-rw-r--r--	2026-04-07 17:42
abort_on_exception%3d-c.ri	1.12 KB	-rw-r--r--	2026-04-07 17:42
abort_on_exception%3d-i.ri	657 B	-rw-r--r--	2026-04-07 17:42
abort_on_exception-c.ri	881 B	-rw-r--r--	2026-04-07 17:42
abort_on_exception-i.ri	651 B	-rw-r--r--	2026-04-07 17:42
add_trace_func-i.ri	453 B	-rw-r--r--	2026-04-07 17:42
alive%3f-i.ri	623 B	-rw-r--r--	2026-04-07 17:42
backtrace-i.ri	364 B	-rw-r--r--	2026-04-07 17:42
backtrace_locations-i.ri	670 B	-rw-r--r--	2026-04-07 17:42
cdesc-Thread.ri	7.95 KB	-rw-r--r--	2026-04-07 17:42
current-c.ri	454 B	-rw-r--r--	2026-04-07 17:42
each_caller_location-c.ri	436 B	-rw-r--r--	2026-04-07 17:42
exit-c.ri	571 B	-rw-r--r--	2026-04-07 17:42
exit-i.ri	442 B	-rw-r--r--	2026-04-07 17:42
fetch-i.ri	730 B	-rw-r--r--	2026-04-07 17:42
fork-c.ri	540 B	-rw-r--r--	2026-04-07 17:42
group-i.ri	471 B	-rw-r--r--	2026-04-07 17:42
handle_interrupt-c.ri	4.68 KB	-rw-r--r--	2026-04-07 17:42
ignore_deadlock%3d-c.ri	894 B	-rw-r--r--	2026-04-07 17:42
ignore_deadlock-c.ri	534 B	-rw-r--r--	2026-04-07 17:42
inspect-i.ri	328 B	-rw-r--r--	2026-04-07 17:42
join-i.ri	1.47 KB	-rw-r--r--	2026-04-07 17:42
key%3f-i.ri	575 B	-rw-r--r--	2026-04-07 17:42
keys-i.ri	620 B	-rw-r--r--	2026-04-07 17:42
kill-c.ri	635 B	-rw-r--r--	2026-04-07 17:42
kill-i.ri	537 B	-rw-r--r--	2026-04-07 17:42
list-c.ri	772 B	-rw-r--r--	2026-04-07 17:42
main-c.ri	311 B	-rw-r--r--	2026-04-07 17:42
name%3d-i.ri	399 B	-rw-r--r--	2026-04-07 17:42
name-i.ri	311 B	-rw-r--r--	2026-04-07 17:42
native_thread_id-i.ri	1.27 KB	-rw-r--r--	2026-04-07 17:42
new-c.ri	951 B	-rw-r--r--	2026-04-07 17:42
pass-c.ri	432 B	-rw-r--r--	2026-04-07 17:42
pending_interrupt%3f-c.ri	1.95 KB	-rw-r--r--	2026-04-07 17:42
pending_interrupt%3f-i.ri	607 B	-rw-r--r--	2026-04-07 17:42
priority%3d-i.ri	966 B	-rw-r--r--	2026-04-07 17:42
priority-i.ri	794 B	-rw-r--r--	2026-04-07 17:42
raise-i.ri	813 B	-rw-r--r--	2026-04-07 17:42
report_on_exception%3d-c.ri	1.23 KB	-rw-r--r--	2026-04-07 17:42
report_on_exception%3d-i.ri	671 B	-rw-r--r--	2026-04-07 17:42
report_on_exception-c.ri	2.06 KB	-rw-r--r--	2026-04-07 17:42
report_on_exception-i.ri	746 B	-rw-r--r--	2026-04-07 17:42
run-i.ri	675 B	-rw-r--r--	2026-04-07 17:42
set_trace_func-i.ri	534 B	-rw-r--r--	2026-04-07 17:42
start-c.ri	542 B	-rw-r--r--	2026-04-07 17:42
status-i.ri	1.34 KB	-rw-r--r--	2026-04-07 17:42
stop%3f-i.ri	565 B	-rw-r--r--	2026-04-07 17:42
stop-c.ri	635 B	-rw-r--r--	2026-04-07 17:42
terminate-i.ri	452 B	-rw-r--r--	2026-04-07 17:42
thread_variable%3f-i.ri	795 B	-rw-r--r--	2026-04-07 17:42
thread_variable_get-i.ri	1.35 KB	-rw-r--r--	2026-04-07 17:42
thread_variable_set-i.ri	523 B	-rw-r--r--	2026-04-07 17:42
thread_variables-i.ri	859 B	-rw-r--r--	2026-04-07 17:42
to_s-i.ri	350 B	-rw-r--r--	2026-04-07 17:42
value-i.ri	646 B	-rw-r--r--	2026-04-07 17:42
wakeup-i.ri	682 B	-rw-r--r--	2026-04-07 17:42

Rename

U:RDoc::AnyMethod[iI"handle_interrupt:ETI"Thread::handle_interrupt;TT:privateo:RDoc::Markup::Document:@parts[3o:RDoc::Markup::Paragraph;	[I"+Changes asynchronous interrupt timing.;To:RDoc::Markup::BlankLine�o;
;	[	I"F_interrupt_ means asynchronous event and corresponding procedure ;TI"Cby Thread#raise, Thread#kill, signal trap (not supported yet) ;TI"Fand main thread termination (if main thread terminates, then all ;TI""other thread will be killed).;T@o;
;	[I"=The given +hash+ has pairs like <code>ExceptionClass => ;TI"P:TimingSymbol</code>. Where the ExceptionClass is the interrupt handled by ;TI"Kthe given block. The TimingSymbol can be one of the following symbols:;T@o:RDoc::Markup::List:
@type:
LABEL:@items[o:RDoc::Markup::ListItem:@label[I"+:immediate+;T;	[o;
;	[I"#Invoke interrupts immediately.;To;;[I"+:on_blocking+;T;	[o;
;	[I"1Invoke interrupts while _BlockingOperation_.;To;;[I"
+:never+;T;	[o;
;	[I"!Never invoke all interrupts.;T@o;
;	[I"Q_BlockingOperation_ means that the operation will block the calling thread, ;TI"Rsuch as read and write.  On CRuby implementation, _BlockingOperation_ is any ;TI"$operation executed without GVL.;T@o;
;	[I"HMasked asynchronous interrupts are delayed until they are enabled. ;TI".This method is similar to sigprocmask(3).;T@S:RDoc::Markup::Heading:
leveli:	textI"	NOTE;T@o;
;	[I"2Asynchronous interrupts are difficult to use.;T@o;
;	[I"bIf you need to communicate between threads, please consider to use another way such as Queue.;T@o;
;	[I";Or use them with deep understanding about this method.;T@S;;i;I"
Usage;T@o;
;	[I"@In this example, we can guard from Thread#raise exceptions.;T@o;
;	[I"OUsing the +:never+ TimingSymbol the RuntimeError exception will always be ;TI"Bignored in the first block of the main thread. In the second ;TI"Q::handle_interrupt block we can purposefully handle RuntimeError exceptions.;T@o:RDoc::Markup::Verbatim;	[I"th = Thread.new do
;TI"9  Thread.handle_interrupt(RuntimeError => :never) {
;TI"    begin
;TI"<      # You can write resource allocation code safely.
;TI"A      Thread.handle_interrupt(RuntimeError => :immediate) {
;TI"        # ...
;TI"
      }
;TI"    ensure
;TI">      # You can write resource deallocation code safely.
;TI"
    end
;TI"	  }
;TI"	end
;TI"Thread.pass
;TI"# ...
;TI"th.raise "stop"
;T:@format0o;
;	[I"NWhile we are ignoring the RuntimeError exception, it's safe to write our ;TI"Mresource allocation code. Then, the ensure block is where we can safely ;TI"deallocate your resources.;T@S;;i	;I"!Guarding from Timeout::Error;T@o;
;	[	I"PIn the next example, we will guard from the Timeout::Error exception. This ;TI"Swill help prevent from leaking resources when Timeout::Error exceptions occur ;TI"Jduring normal ensure clause. For this example we use the help of the ;TI"2standard library Timeout, from lib/timeout.rb;T@o;;	[I"require 'timeout'
;TI"9Thread.handle_interrupt(Timeout::Error => :never) {
;TI"  timeout(10){
;TI"-    # Timeout::Error doesn't occur here
;TI"C    Thread.handle_interrupt(Timeout::Error => :on_blocking) {
;TI"5      # possible to be killed by Timeout::Error
;TI"&      # while blocking operation
;TI"    }
;TI"-    # Timeout::Error doesn't occur here
;TI"	  }
;TI"}
;T;0o;
;	[	I"SIn the first part of the +timeout+ block, we can rely on Timeout::Error being ;TI"Qignored. Then in the <code>Timeout::Error => :on_blocking</code> block, any ;TI"Foperation that will block the calling thread is susceptible to a ;TI"+Timeout::Error exception being raised.;T@S;;i	;I"Stack control settings;T@o;
;	[I"RIt's possible to stack multiple levels of ::handle_interrupt blocks in order ;TI"Hto control more than one ExceptionClass and TimingSymbol at a time.;T@o;;	[
I"3Thread.handle_interrupt(FooError => :never) {
;TI"5  Thread.handle_interrupt(BarError => :never) {
;TI"2     # FooError and BarError are prohibited.
;TI"	  }
;TI"}
;T;0S;;i	;I"$Inheritance with ExceptionClass;T@o;
;	[I"SAll exceptions inherited from the ExceptionClass parameter will be considered.;T@o;;	[I"4Thread.handle_interrupt(Exception => :never) {
;TI"A  # all exceptions inherited from Exception are prohibited.
;TI"}
;T;0o;
;	[I"CFor handling all interrupts, use +Object+ and not +Exception+ ;TI"Xas the ExceptionClass, as kill/terminate interrupts are not handled by +Exception+.;T:
@fileI"
thread.c;T:0@omit_headings_from_table_of_contents_below0I"BThread.handle_interrupt(hash) { ... } -> result of the block
;T0[�I"	(p1);T@�FI"Thread;TcRDoc::NormalClass00