Gecko [ beriskala.com ]

Name	Size	Permission	Date
Buffer	[ DIR ]	drwxr-xr-x	2026-05-05 23:08
ConsoleMode	[ DIR ]	drwxr-xr-x	2026-05-05 23:08
EAGAINWaitReadable	[ DIR ]	drwxr-xr-x	2026-05-05 23:08
EAGAINWaitWritable	[ DIR ]	drwxr-xr-x	2026-05-05 23:08
EINPROGRESSWaitReadable	[ DIR ]	drwxr-xr-x	2026-05-05 23:08
EINPROGRESSWaitWritable	[ DIR ]	drwxr-xr-x	2026-05-05 23:08
EWOULDBLOCKWaitReadable	[ DIR ]	drwxr-xr-x	2026-05-05 23:08
EWOULDBLOCKWaitWritable	[ DIR ]	drwxr-xr-x	2026-05-05 23:08
TimeoutError	[ DIR ]	drwxr-xr-x	2026-05-05 23:08
WaitReadable	[ DIR ]	drwxr-xr-x	2026-05-05 23:08
WaitWritable	[ DIR ]	drwxr-xr-x	2026-05-05 23:08
generic_readable	[ DIR ]	drwxr-xr-x	2026-05-05 23:08
generic_writable	[ DIR ]	drwxr-xr-x	2026-05-05 23:08
%3c%3c-i.ri	727 B	-rw-r--r--	2026-04-07 17:22
advise-i.ri	1.82 KB	-rw-r--r--	2026-04-07 17:22
autoclose%3d-i.ri	648 B	-rw-r--r--	2026-04-07 17:22
autoclose%3f-i.ri	436 B	-rw-r--r--	2026-04-07 17:22
beep-i.ri	226 B	-rw-r--r--	2026-04-07 17:22
binmode%3f-i.ri	399 B	-rw-r--r--	2026-04-07 17:22
binmode-i.ri	462 B	-rw-r--r--	2026-04-07 17:22
binread-c.ri	694 B	-rw-r--r--	2026-04-07 17:22
binwrite-c.ri	671 B	-rw-r--r--	2026-04-07 17:22
cdesc-IO.ri	30.43 KB	-rw-r--r--	2026-04-07 17:22
check_winsize_changed-i.ri	260 B	-rw-r--r--	2026-04-07 17:22
clear_screen-i.ri	242 B	-rw-r--r--	2026-04-07 17:22
close-i.ri	1.04 KB	-rw-r--r--	2026-04-07 17:22
close_on_exec%3d-i.ri	1.01 KB	-rw-r--r--	2026-04-07 17:22
close_on_exec%3f-i.ri	584 B	-rw-r--r--	2026-04-07 17:22
close_read-i.ri	1023 B	-rw-r--r--	2026-04-07 17:22
close_write-i.ri	1.06 KB	-rw-r--r--	2026-04-07 17:22
closed%3f-i.ri	837 B	-rw-r--r--	2026-04-07 17:22
console-c.ri	637 B	-rw-r--r--	2026-04-07 17:22
console_mode%3d-i.ri	436 B	-rw-r--r--	2026-04-07 17:22
console_mode-i.ri	458 B	-rw-r--r--	2026-04-07 17:22
cooked%21-i.ri	476 B	-rw-r--r--	2026-04-07 17:22
cooked-i.ri	561 B	-rw-r--r--	2026-04-07 17:22
copy_stream-c.ri	2.28 KB	-rw-r--r--	2026-04-07 17:22
cursor%3d-i.ri	234 B	-rw-r--r--	2026-04-07 17:22
cursor-i.ri	545 B	-rw-r--r--	2026-04-07 17:22
cursor_down-i.ri	242 B	-rw-r--r--	2026-04-07 17:22
cursor_left-i.ri	242 B	-rw-r--r--	2026-04-07 17:22
cursor_right-i.ri	244 B	-rw-r--r--	2026-04-07 17:22
cursor_up-i.ri	238 B	-rw-r--r--	2026-04-07 17:22
each-i.ri	3.13 KB	-rw-r--r--	2026-04-07 17:22
each_byte-i.ri	778 B	-rw-r--r--	2026-04-07 17:22
each_char-i.ri	766 B	-rw-r--r--	2026-04-07 17:22
each_codepoint-i.ri	729 B	-rw-r--r--	2026-04-07 17:22
each_line-i.ri	2.9 KB	-rw-r--r--	2026-04-07 17:22
echo%3d-i.ri	509 B	-rw-r--r--	2026-04-07 17:22
echo%3f-i.ri	434 B	-rw-r--r--	2026-04-07 17:22
eof%3f-i.ri	1.34 KB	-rw-r--r--	2026-04-07 17:22
eof-i.ri	1.36 KB	-rw-r--r--	2026-04-07 17:22
erase_line-i.ri	240 B	-rw-r--r--	2026-04-07 17:22
erase_screen-i.ri	244 B	-rw-r--r--	2026-04-07 17:22
expect-i.ri	1.74 KB	-rw-r--r--	2026-04-07 17:22
external_encoding-i.ri	544 B	-rw-r--r--	2026-04-07 17:22
fcntl-i.ri	835 B	-rw-r--r--	2026-04-07 17:22
fdatasync-i.ri	498 B	-rw-r--r--	2026-04-07 17:22
fileno-i.ri	580 B	-rw-r--r--	2026-04-07 17:22
flush-i.ri	572 B	-rw-r--r--	2026-04-07 17:22
for_fd-c.ri	319 B	-rw-r--r--	2026-04-07 17:22
foreach-c.ri	2.95 KB	-rw-r--r--	2026-04-07 17:22
fsync-i.ri	934 B	-rw-r--r--	2026-04-07 17:22
getbyte-i.ri	706 B	-rw-r--r--	2026-04-07 17:22
getc-i.ri	710 B	-rw-r--r--	2026-04-07 17:22
getch-i.ri	517 B	-rw-r--r--	2026-04-07 17:22
getpass-i.ri	798 B	-rw-r--r--	2026-04-07 17:22
gets-i.ri	2.84 KB	-rw-r--r--	2026-04-07 17:22
goto-i.ri	232 B	-rw-r--r--	2026-04-07 17:22
goto_column-i.ri	242 B	-rw-r--r--	2026-04-07 17:22
iflush-i.ri	406 B	-rw-r--r--	2026-04-07 17:22
inspect-i.ri	465 B	-rw-r--r--	2026-04-07 17:22
internal_encoding-i.ri	538 B	-rw-r--r--	2026-04-07 17:22
ioctl-i.ri	838 B	-rw-r--r--	2026-04-07 17:22
ioflush-i.ri	421 B	-rw-r--r--	2026-04-07 17:22
isatty-i.ri	584 B	-rw-r--r--	2026-04-07 17:22
lineno%3d-i.ri	385 B	-rw-r--r--	2026-04-07 17:22
lineno-i.ri	370 B	-rw-r--r--	2026-04-07 17:22
new-c.ri	1.73 KB	-rw-r--r--	2026-04-07 17:22
noecho-i.ri	553 B	-rw-r--r--	2026-04-07 17:22
nonblock%3d-i.ri	2.06 KB	-rw-r--r--	2026-04-07 17:22
nonblock%3f-i.ri	361 B	-rw-r--r--	2026-04-07 17:22
nonblock-i.ri	572 B	-rw-r--r--	2026-04-07 17:22
nread-i.ri	477 B	-rw-r--r--	2026-04-07 17:22
oflush-i.ri	407 B	-rw-r--r--	2026-04-07 17:22
open-c.ri	618 B	-rw-r--r--	2026-04-07 17:22
path-i.ri	624 B	-rw-r--r--	2026-04-07 17:22
pathconf-i.ri	730 B	-rw-r--r--	2026-04-07 17:22
pid-i.ri	784 B	-rw-r--r--	2026-04-07 17:22
pipe-c.ri	3.17 KB	-rw-r--r--	2026-04-07 17:22
popen-c.ri	5.73 KB	-rw-r--r--	2026-04-07 17:22
pos%3d-i.ri	607 B	-rw-r--r--	2026-04-07 17:22
pos-i.ri	583 B	-rw-r--r--	2026-04-07 17:22
pread-i.ri	1.34 KB	-rw-r--r--	2026-04-07 17:22
pressed%3f-i.ri	236 B	-rw-r--r--	2026-04-07 17:22
print-i.ri	1.8 KB	-rw-r--r--	2026-04-07 17:22
printf-i.ri	487 B	-rw-r--r--	2026-04-07 17:22
putc-i.ri	735 B	-rw-r--r--	2026-04-07 17:22
puts-i.ri	1.87 KB	-rw-r--r--	2026-04-07 17:22
pwrite-i.ri	1.17 KB	-rw-r--r--	2026-04-07 17:22
raw%21-i.ri	593 B	-rw-r--r--	2026-04-07 17:22
raw-i.ri	1.08 KB	-rw-r--r--	2026-04-07 17:22
read-c.ri	2.02 KB	-rw-r--r--	2026-04-07 17:22
read-i.ri	3.07 KB	-rw-r--r--	2026-04-07 17:22
read_nonblock-i.ri	2.78 KB	-rw-r--r--	2026-04-07 17:22
readbyte-i.ri	710 B	-rw-r--r--	2026-04-07 17:22
readchar-i.ri	723 B	-rw-r--r--	2026-04-07 17:22
readline-i.ri	643 B	-rw-r--r--	2026-04-07 17:22
readlines-c.ri	2.62 KB	-rw-r--r--	2026-04-07 17:22
readlines-i.ri	2.55 KB	-rw-r--r--	2026-04-07 17:22
readpartial-i.ri	4.4 KB	-rw-r--r--	2026-04-07 17:22
ready%3f-i.ri	469 B	-rw-r--r--	2026-04-07 17:22
reopen-i.ri	1.33 KB	-rw-r--r--	2026-04-07 17:22
rewind-i.ri	887 B	-rw-r--r--	2026-04-07 17:22
scroll_backward-i.ri	250 B	-rw-r--r--	2026-04-07 17:22
scroll_forward-i.ri	248 B	-rw-r--r--	2026-04-07 17:22
seek-i.ri	1.7 KB	-rw-r--r--	2026-04-07 17:22
select-c.ri	6.03 KB	-rw-r--r--	2026-04-07 17:22
set_encoding-i.ri	1.37 KB	-rw-r--r--	2026-04-07 17:22
set_encoding_by_bom-i.ri	1017 B	-rw-r--r--	2026-04-07 17:22
stat-i.ri	595 B	-rw-r--r--	2026-04-07 17:22
sync%3d-i.ri	943 B	-rw-r--r--	2026-04-07 17:22
sync-i.ri	666 B	-rw-r--r--	2026-04-07 17:22
sysopen-c.ri	794 B	-rw-r--r--	2026-04-07 17:22
sysread-i.ri	525 B	-rw-r--r--	2026-04-07 17:22
sysseek-i.ri	565 B	-rw-r--r--	2026-04-07 17:22
syswrite-i.ri	766 B	-rw-r--r--	2026-04-07 17:22
tell-i.ri	606 B	-rw-r--r--	2026-04-07 17:22
timeout%3d-i.ri	1.18 KB	-rw-r--r--	2026-04-07 17:22
timeout-i.ri	342 B	-rw-r--r--	2026-04-07 17:22
to_i-i.ri	554 B	-rw-r--r--	2026-04-07 17:22
to_io-i.ri	281 B	-rw-r--r--	2026-04-07 17:22
to_path-i.ri	599 B	-rw-r--r--	2026-04-07 17:22
try_convert-c.ri	653 B	-rw-r--r--	2026-04-07 17:22
tty%3f-i.ri	552 B	-rw-r--r--	2026-04-07 17:22
ungetbyte-i.ri	1.46 KB	-rw-r--r--	2026-04-07 17:22
ungetc-i.ri	1.57 KB	-rw-r--r--	2026-04-07 17:22
wait-i.ri	920 B	-rw-r--r--	2026-04-07 17:22
wait_priority-i.ri	692 B	-rw-r--r--	2026-04-07 17:22
wait_readable-i.ri	659 B	-rw-r--r--	2026-04-07 17:22
wait_writable-i.ri	582 B	-rw-r--r--	2026-04-07 17:22
winsize%3d-i.ri	498 B	-rw-r--r--	2026-04-07 17:22
winsize-i.ri	422 B	-rw-r--r--	2026-04-07 17:22
write-c.ri	1.97 KB	-rw-r--r--	2026-04-07 17:22
write-i.ri	840 B	-rw-r--r--	2026-04-07 17:22
write_nonblock-i.ri	2.55 KB	-rw-r--r--	2026-04-07 17:22

Rename

U:RDoc::AnyMethod[iI"select:ETI"IO::select;TT: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"IO;TcRDoc::NormalClass00