Gecko [ beriskala.com ]

Name	Size	Permission	Date
%60-i.ri	715 B	-rw-r--r--	2024-06-26 17:25
Array-i.ri	931 B	-rw-r--r--	2024-06-26 17:25
BigDecimal-i.ri	1.82 KB	-rw-r--r--	2024-06-26 17:25
Complex-i.ri	1.62 KB	-rw-r--r--	2024-06-26 17:25
Float-i.ri	1.12 KB	-rw-r--r--	2024-06-26 17:25
Hash-i.ri	658 B	-rw-r--r--	2024-06-26 17:25
Integer-i.ri	1.84 KB	-rw-r--r--	2024-06-26 17:25
JSON-i.ri	651 B	-rw-r--r--	2024-06-26 17:25
Pathname-i.ri	749 B	-rw-r--r--	2024-06-26 17:25
Rational-i.ri	1.59 KB	-rw-r--r--	2024-06-26 17:25
String-i.ri	611 B	-rw-r--r--	2024-06-26 17:25
URI-c.ri	309 B	-rw-r--r--	2024-06-26 17:25
URI-i.ri	308 B	-rw-r--r--	2024-06-26 17:25
__callee__-i.ri	427 B	-rw-r--r--	2024-06-26 17:25
__dir__-i.ri	613 B	-rw-r--r--	2024-06-26 17:25
__method__-i.ri	445 B	-rw-r--r--	2024-06-26 17:25
abort-i.ri	486 B	-rw-r--r--	2024-06-26 17:25
at_exit-i.ri	834 B	-rw-r--r--	2024-06-26 17:25
autoload%3f-i.ri	533 B	-rw-r--r--	2024-06-26 17:25
autoload-i.ri	592 B	-rw-r--r--	2024-06-26 17:25
binding-i.ri	739 B	-rw-r--r--	2024-06-26 17:25
block_given%3f-i.ri	779 B	-rw-r--r--	2024-06-26 17:25
callcc-i.ri	871 B	-rw-r--r--	2024-06-26 17:25
caller-i.ri	1.51 KB	-rw-r--r--	2024-06-26 17:25
caller_locations-i.ri	1.07 KB	-rw-r--r--	2024-06-26 17:25
catch-i.ri	1.81 KB	-rw-r--r--	2024-06-26 17:25
cdesc-Kernel.ri	4 KB	-rw-r--r--	2024-06-26 17:25
chomp-i.ri	461 B	-rw-r--r--	2024-06-26 17:25
chop-i.ri	448 B	-rw-r--r--	2024-06-26 17:25
class-i.ri	567 B	-rw-r--r--	2024-06-26 17:25
clone-i.ri	1.21 KB	-rw-r--r--	2024-06-26 17:25
eval-i.ri	941 B	-rw-r--r--	2024-06-26 17:25
exec-i.ri	3.53 KB	-rw-r--r--	2024-06-26 17:25
exit%21-i.ri	535 B	-rw-r--r--	2024-06-26 17:25
exit-i.ri	1.46 KB	-rw-r--r--	2024-06-26 17:25
fail-i.ri	1.4 KB	-rw-r--r--	2024-06-26 17:25
fork-i.ri	1.37 KB	-rw-r--r--	2024-06-26 17:25
format-i.ri	12.79 KB	-rw-r--r--	2024-06-26 17:25
frozen%3f-i.ri	504 B	-rw-r--r--	2024-06-26 17:25
gem-i.ri	1.71 KB	-rw-r--r--	2024-06-26 17:25
gem_original_require-i.ri	302 B	-rw-r--r--	2024-06-26 17:25
gets-i.ri	1.61 KB	-rw-r--r--	2024-06-26 17:25
global_variables-i.ri	697 B	-rw-r--r--	2024-06-26 17:25
gsub-i.ri	515 B	-rw-r--r--	2024-06-26 17:25
iterator%3f-i.ri	344 B	-rw-r--r--	2024-06-26 17:25
j-i.ri	365 B	-rw-r--r--	2024-06-26 17:25
jj-i.ri	382 B	-rw-r--r--	2024-06-26 17:25
lambda-i.ri	414 B	-rw-r--r--	2024-06-26 17:25
load-i.ri	1.53 KB	-rw-r--r--	2024-06-26 17:25
local_variables-i.ri	535 B	-rw-r--r--	2024-06-26 17:25
loop-i.ri	935 B	-rw-r--r--	2024-06-26 17:25
open-i.ri	3.49 KB	-rw-r--r--	2024-06-26 17:25
p-i.ri	680 B	-rw-r--r--	2024-06-26 17:25
pp-c.ri	442 B	-rw-r--r--	2024-06-26 17:25
pp-i.ri	441 B	-rw-r--r--	2024-06-26 17:25
pretty_inspect-i.ri	545 B	-rw-r--r--	2024-06-26 17:25
print-i.ri	987 B	-rw-r--r--	2024-06-26 17:25
printf-i.ri	524 B	-rw-r--r--	2024-06-26 17:25
proc-i.ri	318 B	-rw-r--r--	2024-06-26 17:25
putc-i.ri	505 B	-rw-r--r--	2024-06-26 17:25
puts-i.ri	398 B	-rw-r--r--	2024-06-26 17:25
raise-i.ri	1.56 KB	-rw-r--r--	2024-06-26 17:25
rand-i.ri	1.3 KB	-rw-r--r--	2024-06-26 17:25
readline-i.ri	451 B	-rw-r--r--	2024-06-26 17:25
readlines-i.ri	491 B	-rw-r--r--	2024-06-26 17:25
require-i.ri	2.08 KB	-rw-r--r--	2024-06-26 17:25
require_relative-i.ri	551 B	-rw-r--r--	2024-06-26 17:25
select-i.ri	5.86 KB	-rw-r--r--	2024-06-26 17:25
set_trace_func-i.ri	2.4 KB	-rw-r--r--	2024-06-26 17:25
sleep-i.ri	900 B	-rw-r--r--	2024-06-26 17:25
spawn-i.ri	12.65 KB	-rw-r--r--	2024-06-26 17:25
sprintf-i.ri	12.9 KB	-rw-r--r--	2024-06-26 17:25
srand-i.ri	1.32 KB	-rw-r--r--	2024-06-26 17:25
sub-i.ri	518 B	-rw-r--r--	2024-06-26 17:25
syscall-i.ri	1.49 KB	-rw-r--r--	2024-06-26 17:25
system-i.ri	2.05 KB	-rw-r--r--	2024-06-26 17:25
tap-i.ri	836 B	-rw-r--r--	2024-06-26 17:25
test-i.ri	3 KB	-rw-r--r--	2024-06-26 17:25
then-i.ri	1.08 KB	-rw-r--r--	2024-06-26 17:25
throw-i.ri	623 B	-rw-r--r--	2024-06-26 17:25
trace_var-i.ri	1 KB	-rw-r--r--	2024-06-26 17:25
trap-i.ri	1.55 KB	-rw-r--r--	2024-06-26 17:25
untrace_var-i.ri	566 B	-rw-r--r--	2024-06-26 17:25
warn-i.ri	1.81 KB	-rw-r--r--	2024-06-26 17:25
y-i.ri	332 B	-rw-r--r--	2024-06-26 17:25
yield_self-i.ri	781 B	-rw-r--r--	2024-06-26 17:25

Rename

U:RDoc::AnyMethod[iI"select:ETI"Kernel#select;TF:privateo:RDoc::Markup::Document:@parts[-o:RDoc::Markup::Paragraph;	[I""Calls select(2) system call. ;TI"HIt monitors given arrays of IO objects, waits until one or more of ;TI"GIO objects are ready for reading, are ready for writing, and have ;TI"Ipending exceptions respectively, and returns an array that contains ;TI"Carrays of those IO objects. It will return +nil+ if optional ;TI"@timeout value is given and no IO object is ready in ;TI"timeout seconds.;To:RDoc::Markup::BlankLine�o;
;	[	I"GIO.select peeks the buffer of IO objects for testing readability. ;TI"CIf the IO buffer is not empty, IO.select immediately notifies ;TI"Ireadability. This "peek" only happens for IO objects. It does not ;TI"@happen for IO-like objects such as OpenSSL::SSL::SSLSocket.;T@o;
;	[I"DThe best way to use IO.select is invoking it after nonblocking ;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"Gwith 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"IEspecially, the combination of nonblocking 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"DThis 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"Esome 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"IThe combination of nonblocking 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".See select(2) manual on GNU/Linux system.;T@o;
;	[I"CInvoking IO.select before IO#readpartial works well as usual. ;TI"5However 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"BSo, <code>IO#write(two or more bytes)</code> can block after ;TI"Jwritability 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;
0S:RDoc::Markup::Heading:
leveli:	textI"Parameters;To:RDoc::Markup::List:
@type:	NOTE:@items[	o:RDoc::Markup::ListItem:@label[I"read_array;T;	[o;
;	[I":an array of IO objects that wait until ready for read;To;;[I"write_array;T;	[o;
;	[I";an array of IO objects that wait until ready for write;To;;[I"error_array;T;	[o;
;	[I"4an array of IO objects that wait for exceptions;To;;[I"timeout;T;	[o;
;	[I"a numeric value in second;T@S;;i;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"produces:;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"WIO.select(read_array [, write_array [, error_array [, timeout]]]) -> array or nil
;T0[�I"$(p1, p2 = v2, p3 = v3, p4 = v4);T@�FI"Kernel;TcRDoc::NormalModule00