Gecko [ beriskala.com ]

Name	Size	Permission	Date
%60-i.ri	969 B	-rw-r--r--	2026-04-07 17:22
Array-i.ri	828 B	-rw-r--r--	2026-04-07 17:22
BigDecimal-i.ri	2.43 KB	-rw-r--r--	2026-04-07 17:22
Complex-i.ri	2.46 KB	-rw-r--r--	2026-04-07 17:22
Float-i.ri	1.12 KB	-rw-r--r--	2026-04-07 17:22
Hash-i.ri	972 B	-rw-r--r--	2026-04-07 17:22
Integer-i.ri	3.42 KB	-rw-r--r--	2026-04-07 17:22
JSON-i.ri	651 B	-rw-r--r--	2026-04-07 17:22
Pathname-i.ri	749 B	-rw-r--r--	2026-04-07 17:22
Rational-i.ri	1.59 KB	-rw-r--r--	2026-04-07 17:22
String-i.ri	746 B	-rw-r--r--	2026-04-07 17:22
URI-c.ri	677 B	-rw-r--r--	2026-04-07 17:22
URI-i.ri	676 B	-rw-r--r--	2026-04-07 17:22
__callee__-i.ri	427 B	-rw-r--r--	2026-04-07 17:22
__dir__-i.ri	613 B	-rw-r--r--	2026-04-07 17:22
__method__-i.ri	445 B	-rw-r--r--	2026-04-07 17:22
abort-i.ri	610 B	-rw-r--r--	2026-04-07 17:22
at_exit-i.ri	834 B	-rw-r--r--	2026-04-07 17:22
autoload%3f-i.ri	533 B	-rw-r--r--	2026-04-07 17:22
autoload-i.ri	745 B	-rw-r--r--	2026-04-07 17:22
binding-i.ri	1.62 KB	-rw-r--r--	2026-04-07 17:22
block_given%3f-i.ri	779 B	-rw-r--r--	2026-04-07 17:22
callcc-i.ri	871 B	-rw-r--r--	2026-04-07 17:22
caller-i.ri	1.51 KB	-rw-r--r--	2026-04-07 17:22
caller_locations-i.ri	1.07 KB	-rw-r--r--	2026-04-07 17:22
catch-i.ri	1.81 KB	-rw-r--r--	2026-04-07 17:22
cdesc-Kernel.ri	11.23 KB	-rw-r--r--	2026-04-07 17:22
chomp-i.ri	461 B	-rw-r--r--	2026-04-07 17:22
chop-i.ri	448 B	-rw-r--r--	2026-04-07 17:22
class-i.ri	567 B	-rw-r--r--	2026-04-07 17:22
clone-i.ri	1.21 KB	-rw-r--r--	2026-04-07 17:22
eval-i.ri	941 B	-rw-r--r--	2026-04-07 17:22
exec-i.ri	3.44 KB	-rw-r--r--	2026-04-07 17:22
exit%21-i.ri	722 B	-rw-r--r--	2026-04-07 17:22
exit-i.ri	1.44 KB	-rw-r--r--	2026-04-07 17:22
fail-i.ri	1.4 KB	-rw-r--r--	2026-04-07 17:22
fork-i.ri	2.35 KB	-rw-r--r--	2026-04-07 17:22
format-i.ri	513 B	-rw-r--r--	2026-04-07 17:22
frozen%3f-i.ri	504 B	-rw-r--r--	2026-04-07 17:22
gem-i.ri	1.71 KB	-rw-r--r--	2026-04-07 17:22
gets-i.ri	1.61 KB	-rw-r--r--	2026-04-07 17:22
global_variables-i.ri	697 B	-rw-r--r--	2026-04-07 17:22
gsub-i.ri	515 B	-rw-r--r--	2026-04-07 17:22
iterator%3f-i.ri	344 B	-rw-r--r--	2026-04-07 17:22
j-i.ri	365 B	-rw-r--r--	2026-04-07 17:22
jj-i.ri	382 B	-rw-r--r--	2026-04-07 17:22
lambda-i.ri	414 B	-rw-r--r--	2026-04-07 17:22
load-i.ri	1.64 KB	-rw-r--r--	2026-04-07 17:22
local_variables-i.ri	535 B	-rw-r--r--	2026-04-07 17:22
loop-i.ri	941 B	-rw-r--r--	2026-04-07 17:22
open-i.ri	1.03 KB	-rw-r--r--	2026-04-07 17:22
p-i.ri	1.1 KB	-rw-r--r--	2026-04-07 17:22
pp-c.ri	442 B	-rw-r--r--	2026-04-07 17:22
pp-i.ri	441 B	-rw-r--r--	2026-04-07 17:22
pretty_inspect-i.ri	403 B	-rw-r--r--	2026-04-07 17:22
print-i.ri	1.78 KB	-rw-r--r--	2026-04-07 17:22
printf-i.ri	1.21 KB	-rw-r--r--	2026-04-07 17:22
proc-i.ri	318 B	-rw-r--r--	2026-04-07 17:22
putc-i.ri	469 B	-rw-r--r--	2026-04-07 17:22
puts-i.ri	397 B	-rw-r--r--	2026-04-07 17:22
raise-i.ri	1.56 KB	-rw-r--r--	2026-04-07 17:22
rand-i.ri	1.32 KB	-rw-r--r--	2026-04-07 17:22
readline-i.ri	872 B	-rw-r--r--	2026-04-07 17:22
readlines-i.ri	2.59 KB	-rw-r--r--	2026-04-07 17:22
require-i.ri	998 B	-rw-r--r--	2026-04-07 17:22
require_relative-i.ri	592 B	-rw-r--r--	2026-04-07 17:22
select-i.ri	6.04 KB	-rw-r--r--	2026-04-07 17:22
set_trace_func-i.ri	2.75 KB	-rw-r--r--	2026-04-07 17:22
sleep-i.ri	769 B	-rw-r--r--	2026-04-07 17:22
spawn-i.ri	4.51 KB	-rw-r--r--	2026-04-07 17:22
sprintf-i.ri	563 B	-rw-r--r--	2026-04-07 17:22
srand-i.ri	1.32 KB	-rw-r--r--	2026-04-07 17:22
sub-i.ri	518 B	-rw-r--r--	2026-04-07 17:22
syscall-i.ri	1.27 KB	-rw-r--r--	2026-04-07 17:22
system-i.ri	5.03 KB	-rw-r--r--	2026-04-07 17:22
tap-i.ri	836 B	-rw-r--r--	2026-04-07 17:22
test-i.ri	2.96 KB	-rw-r--r--	2026-04-07 17:22
then-i.ri	1.33 KB	-rw-r--r--	2026-04-07 17:22
throw-i.ri	623 B	-rw-r--r--	2026-04-07 17:22
trace_var-i.ri	1 KB	-rw-r--r--	2026-04-07 17:22
trap-i.ri	1.56 KB	-rw-r--r--	2026-04-07 17:22
untrace_var-i.ri	566 B	-rw-r--r--	2026-04-07 17:22
warn-i.ri	1.79 KB	-rw-r--r--	2026-04-07 17:22
y-i.ri	332 B	-rw-r--r--	2026-04-07 17:22
yield_self-i.ri	521 B	-rw-r--r--	2026-04-07 17:22

Rename

U:RDoc::AnyMethod[iI"select:ETI"Kernel#select;TF:privateo:RDoc::Markup::Document:@parts[6o:RDoc::Markup::Paragraph;	[	I"JInvokes system call {select(2)}[https://linux.die.net/man/2/select], ;TI"/which monitors multiple file descriptors, ;TI"7waiting until one or more of the file descriptors ;TI"3becomes ready for some class of I/O operation.;To:RDoc::Markup::BlankLine�o;
;	[I"&Not implemented on all platforms.;T@o;
;	[I"DEach of the arguments +read_ios+, +write_ios+, and +error_ios+ ;TI"is an array of IO objects.;T@o;
;	[I"BArgument +timeout+ is an integer timeout interval in seconds.;T@o;
;	[I"DThe method monitors the \IO objects given in all three arrays, ;TI"#waiting for some to be ready; ;TI"2returns a 3-element array whose elements are:;T@o:RDoc::Markup::List:
@type:BULLET:@items[o:RDoc::Markup::ListItem:@label0;	[o;
;	[I"FAn array of the objects in +read_ios+ that are ready for reading.;To;;0;	[o;
;	[I"GAn array of the objects in +write_ios+ that are ready for writing.;To;;0;	[o;
;	[I"DAn array of the objects in +error_ios+ have pending exceptions.;T@o;
;	[I"NIf no object becomes ready within the given +timeout+, +nil+ is returned.;T@o;
;	[	I"I\IO.select peeks the buffer of \IO objects for testing readability. ;TI"EIf the \IO buffer is not empty, \IO.select immediately notifies ;TI"Jreadability.  This "peek" only happens for \IO objects.  It does not ;TI"@happen for IO-like objects such as OpenSSL::SSL::SSLSocket.;T@o;
;	[I"FThe best way to use \IO.select is invoking it after non-blocking ;TI"Hmethods such as #read_nonblock, #write_nonblock, etc.  The methods ;TI"Araise an exception which is extended by IO::WaitReadable or ;TI"FIO::WaitWritable.  The modules notify how the caller should wait ;TI"Hwith \IO.select.  If IO::WaitReadable is raised, the caller should ;TI"Iwait for reading.  If IO::WaitWritable is raised, the caller should ;TI"wait for writing.;T@o;
;	[I"<So, blocking read (#readpartial) can be emulated using ;TI".#read_nonblock and \IO.select as follows:;T@o:RDoc::Markup::Verbatim;	[I"begin
;TI".  result = io_like.read_nonblock(maxlen)
;TI"rescue IO::WaitReadable
;TI"  IO.select([io_like])
;TI"
  retry
;TI"rescue IO::WaitWritable
;TI"!  IO.select(nil, [io_like])
;TI"
  retry
;TI"	end
;T:@format0o;
;	[	I"KEspecially, the combination of non-blocking methods and \IO.select is ;TI"Hpreferred for IO like objects such as OpenSSL::SSL::SSLSocket.  It ;TI"Hhas #to_io method to return underlying IO object.  IO.select calls ;TI"2#to_io to obtain the file descriptor to wait.;T@o;
;	[I"EThis means that readability notified by \IO.select doesn't mean ;TI"5readability from OpenSSL::SSL::SSLSocket object.;T@o;
;	[I"GThe most likely situation is that OpenSSL::SSL::SSLSocket buffers ;TI"Gsome data.  \IO.select doesn't see the buffer.  So \IO.select can ;TI"Bblock when OpenSSL::SSL::SSLSocket#readpartial doesn't block.;T@o;
;	[I"8However, several more complicated situations exist.;T@o;
;	[
I"5SSL is a protocol which is sequence of records. ;TI",The record consists of multiple bytes. ;TI"BSo, the remote side of SSL sends a partial record, IO.select ;TI"Gnotifies readability but OpenSSL::SSL::SSLSocket cannot decrypt a ;TI"=byte and OpenSSL::SSL::SSLSocket#readpartial will block.;T@o;
;	[
I"FAlso, the remote side can request SSL renegotiation which forces ;TI".the local SSL engine to write some data. ;TI"FThis means OpenSSL::SSL::SSLSocket#readpartial may invoke #write ;TI"#system call and it can block. ;TI"GIn such a situation, OpenSSL::SSL::SSLSocket#read_nonblock raises ;TI"+IO::WaitWritable instead of blocking. ;TI"CSo, the caller should wait for ready for writability as above ;TI"
example.;T@o;
;	[I"KThe combination of non-blocking methods and \IO.select is also useful ;TI"Ifor streams such as tty, pipe socket socket when multiple processes ;TI"read from a stream.;T@o;
;	[	I";Finally, Linux kernel developers don't guarantee that ;TI"Jreadability of select(2) means readability of following read(2) even ;TI"for a single process; ;TI"8see {select(2)}[https://linux.die.net/man/2/select];T@o;
;	[I"DInvoking \IO.select before IO#readpartial works well as usual. ;TI"6However it is not the best way to use \IO.select.;T@o;
;	[I"8The writability notified by select(2) doesn't show ;TI""how many bytes are writable. ;TI"AIO#write method blocks until given whole string is written. ;TI">So, <tt>IO#write(two or more bytes)</tt> can block after ;TI"Kwritability is notified by \IO.select.  IO#write_nonblock is required ;TI"to avoid the blocking.;T@o;
;	[I"GBlocking write (#write) can be emulated using #write_nonblock and ;TI"GIO.select as follows: IO::WaitReadable should also be rescued for ;TI"2SSL renegotiation in OpenSSL::SSL::SSLSocket.;T@o;;	[I"while 0 < string.bytesize
;TI"
  begin
;TI"2    written = io_like.write_nonblock(string)
;TI"  rescue IO::WaitReadable
;TI"    IO.select([io_like])
;TI"    retry
;TI"  rescue IO::WaitWritable
;TI"#    IO.select(nil, [io_like])
;TI"    retry
;TI"  end
;TI".  string = string.byteslice(written..-1)
;TI"	end
;T;0o;
;	[I"
Example:;T@o;;	[I"rp, wp = IO.pipe
;TI"mesg = "ping "
;TI"100.times {
;TI"H  # IO.select follows IO#read.  Not the best way to use IO.select.
;TI"'  rs, ws, = IO.select([rp], [wp])
;TI"  if r = rs[0]
;TI"    ret = r.read(5)
;TI"    print ret
;TI"    case ret
;TI"    when /ping/
;TI"      mesg = "pong\n"
;TI"    when /pong/
;TI"      mesg = "ping "
;TI"
    end
;TI"  end
;TI"  if w = ws[0]
;TI"    w.write(mesg)
;TI"  end
;TI"}
;T;0o;
;	[I"Output:;T@o;;	[
I"ping pong
;TI"ping pong
;TI"ping pong
;TI"(snipped)
;TI"	ping;T;0:
@fileI"	io.c;T:0@omit_headings_from_table_of_contents_below0I"XIO.select(read_ios, write_ios = [], error_ios = [], timeout = nil) -> array or nil
;T0[�I"$(p1, p2 = v2, p3 = v3, p4 = v4);T@�FI"Kernel;TcRDoc::NormalModule00