Gecko [ beriskala.com ]

Name	Size	Permission	Date
Backtrace	[ DIR ]	drwxr-xr-x	2026-05-01 04:24
%5b%5d%3d-i.ri	577 B	-rw-r--r--	2023-07-26 17:38
%5b%5d-i.ri	2.09 KB	-rw-r--r--	2023-07-26 17:38
DEBUG%3d-c.ri	371 B	-rw-r--r--	2023-07-26 17:38
DEBUG-c.ri	375 B	-rw-r--r--	2023-07-26 17:38
abort_on_exception%3d-c.ri	928 B	-rw-r--r--	2023-07-26 17:38
abort_on_exception%3d-i.ri	536 B	-rw-r--r--	2023-07-26 17:38
abort_on_exception-c.ri	792 B	-rw-r--r--	2023-07-26 17:38
abort_on_exception-i.ri	517 B	-rw-r--r--	2023-07-26 17:38
add_trace_func-i.ri	425 B	-rw-r--r--	2023-07-26 17:38
alive%3f-i.ri	593 B	-rw-r--r--	2023-07-26 17:38
backtrace-i.ri	353 B	-rw-r--r--	2023-07-26 17:38
backtrace_locations-i.ri	668 B	-rw-r--r--	2023-07-26 17:38
cdesc-Thread.ri	1.57 KB	-rw-r--r--	2023-07-26 17:38
current-c.ri	452 B	-rw-r--r--	2023-07-26 17:38
exclusive-c.ri	464 B	-rw-r--r--	2023-07-26 17:38
exit-c.ri	549 B	-rw-r--r--	2023-07-26 17:38
exit-i.ri	597 B	-rw-r--r--	2023-07-26 17:38
fork-c.ri	538 B	-rw-r--r--	2023-07-26 17:38
group-i.ri	534 B	-rw-r--r--	2023-07-26 17:38
handle_interrupt-c.ri	4.5 KB	-rw-r--r--	2023-07-26 17:38
inspect-i.ri	341 B	-rw-r--r--	2023-07-26 17:38
join-i.ri	1.52 KB	-rw-r--r--	2023-07-26 17:38
key%3f-i.ri	584 B	-rw-r--r--	2023-07-26 17:38
keys-i.ri	621 B	-rw-r--r--	2023-07-26 17:38
kill-c.ri	649 B	-rw-r--r--	2023-07-26 17:38
kill-i.ri	597 B	-rw-r--r--	2023-07-26 17:38
list-c.ri	783 B	-rw-r--r--	2023-07-26 17:38
main-c.ri	309 B	-rw-r--r--	2023-07-26 17:38
new-c.ri	949 B	-rw-r--r--	2023-07-26 17:38
pass-c.ri	430 B	-rw-r--r--	2023-07-26 17:38
pending_interrupt%3f-c.ri	1.95 KB	-rw-r--r--	2023-07-26 17:38
pending_interrupt%3f-i.ri	606 B	-rw-r--r--	2023-07-26 17:38
priority%3d-i.ri	964 B	-rw-r--r--	2023-07-26 17:38
priority-i.ri	792 B	-rw-r--r--	2023-07-26 17:38
raise-i.ri	804 B	-rw-r--r--	2023-07-26 17:38
run-i.ri	625 B	-rw-r--r--	2023-07-26 17:38
safe_level-i.ri	643 B	-rw-r--r--	2023-07-26 17:38
set_trace_func-i.ri	493 B	-rw-r--r--	2023-07-26 17:38
start-c.ri	540 B	-rw-r--r--	2023-07-26 17:38
status-i.ri	1.12 KB	-rw-r--r--	2023-07-26 17:38
stop%3f-i.ri	534 B	-rw-r--r--	2023-07-26 17:38
stop-c.ri	673 B	-rw-r--r--	2023-07-26 17:38
terminate-i.ri	607 B	-rw-r--r--	2023-07-26 17:38
thread_variable%3f-i.ri	804 B	-rw-r--r--	2023-07-26 17:38
thread_variable_get-i.ri	1.38 KB	-rw-r--r--	2023-07-26 17:38
thread_variable_set-i.ri	521 B	-rw-r--r--	2023-07-26 17:38
thread_variables-i.ri	860 B	-rw-r--r--	2023-07-26 17:38
value-i.ri	644 B	-rw-r--r--	2023-07-26 17:38
wakeup-i.ri	688 B	-rw-r--r--	2023-07-26 17:38

Rename

U:RDoc::AnyMethod[iI"handle_interrupt:ETI"Thread::handle_interrupt;TT:publico:RDoc::Markup::Document:@parts[2o: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"8  Thead.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 TimeoutError;T@o;
;	[	I"NIn the next example, we will guard from the TimeoutError exception. This ;TI"Qwill help prevent from leaking resources when TimeoutError 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"7Thread.handle_interrupt(TimeoutError => :never) {
;TI"  timeout(10){
;TI"+    # TimeoutError doesn't occur here
;TI"A    Thread.handle_interrupt(TimeoutError => :on_blocking) {
;TI"3      # possible to be killed by TimeoutError
;TI"&      # while blocking operation
;TI"    }
;TI"+    # TimeoutError doesn't occur here
;TI"	  }
;TI"}
;T;0o;
;	[	I"QIn the first part of the +timeout+ block, we can rely on TimeoutError being ;TI"Oignored. Then in the <code>TimeoutError => :on_blocking</code> block, any ;TI"Foperation that will block the calling thread is susceptible to a ;TI")TimeoutError 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;0:
@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::NormalClass0