Gecko [ beriskala.com ]

Name	Size	Permission	Date
%60-i.ri	968 B	-rw-r--r--	2026-04-07 16:51
Array-i.ri	827 B	-rw-r--r--	2026-04-07 16:51
Complex-i.ri	2.46 KB	-rw-r--r--	2026-04-07 16:51
Float-i.ri	1.12 KB	-rw-r--r--	2026-04-07 16:51
Hash-i.ri	971 B	-rw-r--r--	2026-04-07 16:51
Integer-i.ri	3.43 KB	-rw-r--r--	2026-04-07 16:51
JSON-i.ri	651 B	-rw-r--r--	2026-04-07 16:51
Pathname-i.ri	748 B	-rw-r--r--	2026-04-07 16:51
Rational-i.ri	1.59 KB	-rw-r--r--	2026-04-07 16:51
String-i.ri	743 B	-rw-r--r--	2026-04-07 16:51
URI-c.ri	676 B	-rw-r--r--	2026-04-07 16:51
URI-i.ri	676 B	-rw-r--r--	2026-04-07 16:51
__callee__-i.ri	426 B	-rw-r--r--	2026-04-07 16:51
__dir__-i.ri	612 B	-rw-r--r--	2026-04-07 16:51
__method__-i.ri	444 B	-rw-r--r--	2026-04-07 16:51
abort-i.ri	609 B	-rw-r--r--	2026-04-07 16:51
at_exit-i.ri	833 B	-rw-r--r--	2026-04-07 16:51
autoload%3f-i.ri	864 B	-rw-r--r--	2026-04-07 16:51
autoload-i.ri	767 B	-rw-r--r--	2026-04-07 16:51
binding-i.ri	1.62 KB	-rw-r--r--	2026-04-07 16:51
block_given%3f-i.ri	778 B	-rw-r--r--	2026-04-07 16:51
callcc-i.ri	870 B	-rw-r--r--	2026-04-07 16:51
caller-i.ri	1.51 KB	-rw-r--r--	2026-04-07 16:51
caller_locations-i.ri	1.07 KB	-rw-r--r--	2026-04-07 16:51
catch-i.ri	1.81 KB	-rw-r--r--	2026-04-07 16:51
cdesc-Kernel.ri	10.8 KB	-rw-r--r--	2026-04-07 16:51
chomp-i.ri	460 B	-rw-r--r--	2026-04-07 16:51
chop-i.ri	447 B	-rw-r--r--	2026-04-07 16:51
class-i.ri	566 B	-rw-r--r--	2026-04-07 16:51
clone-i.ri	1.21 KB	-rw-r--r--	2026-04-07 16:51
eval-i.ri	940 B	-rw-r--r--	2026-04-07 16:51
exec-i.ri	3.52 KB	-rw-r--r--	2026-04-07 16:51
exit%21-i.ri	721 B	-rw-r--r--	2026-04-07 16:51
exit-i.ri	1.44 KB	-rw-r--r--	2026-04-07 16:51
fail-i.ri	3.96 KB	-rw-r--r--	2026-04-07 16:51
fork-i.ri	2.35 KB	-rw-r--r--	2026-04-07 16:51
format-i.ri	512 B	-rw-r--r--	2026-04-07 16:51
frozen%3f-i.ri	503 B	-rw-r--r--	2026-04-07 16:51
gem-i.ri	1.71 KB	-rw-r--r--	2026-04-07 16:51
gets-i.ri	1.61 KB	-rw-r--r--	2026-04-07 16:51
global_variables-i.ri	696 B	-rw-r--r--	2026-04-07 16:51
gsub-i.ri	514 B	-rw-r--r--	2026-04-07 16:51
iterator%3f-i.ri	343 B	-rw-r--r--	2026-04-07 16:51
j-i.ri	365 B	-rw-r--r--	2026-04-07 16:51
jj-i.ri	382 B	-rw-r--r--	2026-04-07 16:51
lambda-i.ri	413 B	-rw-r--r--	2026-04-07 16:51
load-i.ri	1.58 KB	-rw-r--r--	2026-04-07 16:51
local_variables-i.ri	534 B	-rw-r--r--	2026-04-07 16:51
loop-i.ri	941 B	-rw-r--r--	2026-04-07 16:51
open-i.ri	1.03 KB	-rw-r--r--	2026-04-07 16:51
p-i.ri	1.1 KB	-rw-r--r--	2026-04-07 16:51
pp-c.ri	359 B	-rw-r--r--	2026-04-07 16:51
pp-i.ri	359 B	-rw-r--r--	2026-04-07 16:51
pretty_inspect-i.ri	402 B	-rw-r--r--	2026-04-07 16:51
print-i.ri	1.77 KB	-rw-r--r--	2026-04-07 16:51
printf-i.ri	1.21 KB	-rw-r--r--	2026-04-07 16:51
proc-i.ri	317 B	-rw-r--r--	2026-04-07 16:51
putc-i.ri	468 B	-rw-r--r--	2026-04-07 16:51
puts-i.ri	396 B	-rw-r--r--	2026-04-07 16:51
raise-i.ri	4.06 KB	-rw-r--r--	2026-04-07 16:51
rand-i.ri	1.32 KB	-rw-r--r--	2026-04-07 16:51
readline-i.ri	871 B	-rw-r--r--	2026-04-07 16:51
readlines-i.ri	2.6 KB	-rw-r--r--	2026-04-07 16:51
require-i.ri	998 B	-rw-r--r--	2026-04-07 16:51
require_relative-i.ri	591 B	-rw-r--r--	2026-04-07 16:51
select-i.ri	6.08 KB	-rw-r--r--	2026-04-07 16:51
set_trace_func-i.ri	2.74 KB	-rw-r--r--	2026-04-07 16:51
sleep-i.ri	768 B	-rw-r--r--	2026-04-07 16:51
spawn-i.ri	4.44 KB	-rw-r--r--	2026-04-07 16:51
sprintf-i.ri	562 B	-rw-r--r--	2026-04-07 16:51
srand-i.ri	1.32 KB	-rw-r--r--	2026-04-07 16:51
sub-i.ri	517 B	-rw-r--r--	2026-04-07 16:51
syscall-i.ri	1.27 KB	-rw-r--r--	2026-04-07 16:51
system-i.ri	5.11 KB	-rw-r--r--	2026-04-07 16:51
tap-i.ri	834 B	-rw-r--r--	2026-04-07 16:51
test-i.ri	4.32 KB	-rw-r--r--	2026-04-07 16:51
then-i.ri	1.11 KB	-rw-r--r--	2026-04-07 16:51
throw-i.ri	622 B	-rw-r--r--	2026-04-07 16:51
trace_var-i.ri	1019 B	-rw-r--r--	2026-04-07 16:51
trap-i.ri	1.56 KB	-rw-r--r--	2026-04-07 16:51
untrace_var-i.ri	565 B	-rw-r--r--	2026-04-07 16:51
warn-i.ri	1.92 KB	-rw-r--r--	2026-04-07 16:51
y-i.ri	332 B	-rw-r--r--	2026-04-07 16:51
yield_self-i.ri	246 B	-rw-r--r--	2026-04-07 16:51

Rename

U:RDoc::AnyMethod[iI"select:ETI"Kernel#select;TF:publico: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"NArgument +timeout+ is a numeric value (such as integer or float) timeout ;TI"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