Gecko [ www.beriskala.com ]

Name	Size	Permission	Date
Buffer	[ DIR ]	drwxr-xr-x	2026-05-01 04:23
ConsoleMode	[ DIR ]	drwxr-xr-x	2026-05-01 04:23
EAGAINWaitReadable	[ DIR ]	drwxr-xr-x	2026-05-01 04:23
EAGAINWaitWritable	[ DIR ]	drwxr-xr-x	2026-05-01 04:23
EINPROGRESSWaitReadable	[ DIR ]	drwxr-xr-x	2026-05-01 04:23
EINPROGRESSWaitWritable	[ DIR ]	drwxr-xr-x	2026-05-01 04:23
EWOULDBLOCKWaitReadable	[ DIR ]	drwxr-xr-x	2026-05-01 04:23
EWOULDBLOCKWaitWritable	[ DIR ]	drwxr-xr-x	2026-05-01 04:23
WaitReadable	[ DIR ]	drwxr-xr-x	2026-05-01 04:23
WaitWritable	[ DIR ]	drwxr-xr-x	2026-05-01 04:23
generic_readable	[ DIR ]	drwxr-xr-x	2026-05-01 04:23
generic_writable	[ DIR ]	drwxr-xr-x	2026-05-01 04:23
%3c%3c-i.ri	715 B	-rw-r--r--	2025-04-28 21:06
advise-i.ri	2.44 KB	-rw-r--r--	2025-04-28 21:06
autoclose%3d-i.ri	635 B	-rw-r--r--	2025-04-28 21:06
autoclose%3f-i.ri	429 B	-rw-r--r--	2025-04-28 21:06
beep-i.ri	226 B	-rw-r--r--	2025-04-28 21:06
binmode%3f-i.ri	344 B	-rw-r--r--	2025-04-28 21:06
binmode-i.ri	658 B	-rw-r--r--	2025-04-28 21:06
binread-c.ri	1.41 KB	-rw-r--r--	2025-04-28 21:06
binwrite-c.ri	1018 B	-rw-r--r--	2025-04-28 21:06
cdesc-IO.ri	30.2 KB	-rw-r--r--	2025-04-28 21:06
check_winsize_changed-i.ri	260 B	-rw-r--r--	2025-04-28 21:06
clear_screen-i.ri	242 B	-rw-r--r--	2025-04-28 21:06
close-i.ri	764 B	-rw-r--r--	2025-04-28 21:06
close_on_exec%3d-i.ri	1.01 KB	-rw-r--r--	2025-04-28 21:06
close_on_exec%3f-i.ri	678 B	-rw-r--r--	2025-04-28 21:06
close_read-i.ri	833 B	-rw-r--r--	2025-04-28 21:06
close_write-i.ri	873 B	-rw-r--r--	2025-04-28 21:06
closed%3f-i.ri	764 B	-rw-r--r--	2025-04-28 21:06
console-c.ri	637 B	-rw-r--r--	2025-04-28 21:06
console_mode%3d-i.ri	436 B	-rw-r--r--	2025-04-28 21:06
console_mode-i.ri	458 B	-rw-r--r--	2025-04-28 21:06
console_size-c.ri	284 B	-rw-r--r--	2025-04-28 21:06
cooked%21-i.ri	476 B	-rw-r--r--	2025-04-28 21:06
cooked-i.ri	561 B	-rw-r--r--	2025-04-28 21:06
copy_stream-c.ri	1.41 KB	-rw-r--r--	2025-04-28 21:06
cursor%3d-i.ri	234 B	-rw-r--r--	2025-04-28 21:06
cursor-i.ri	230 B	-rw-r--r--	2025-04-28 21:06
cursor_down-i.ri	242 B	-rw-r--r--	2025-04-28 21:06
cursor_left-i.ri	242 B	-rw-r--r--	2025-04-28 21:06
cursor_right-i.ri	244 B	-rw-r--r--	2025-04-28 21:06
cursor_up-i.ri	238 B	-rw-r--r--	2025-04-28 21:06
default_console_size-c.ri	374 B	-rw-r--r--	2025-04-28 21:06
each-i.ri	1.37 KB	-rw-r--r--	2025-04-28 21:06
each_byte-i.ri	830 B	-rw-r--r--	2025-04-28 21:06
each_char-i.ri	755 B	-rw-r--r--	2025-04-28 21:06
each_codepoint-i.ri	637 B	-rw-r--r--	2025-04-28 21:06
each_line-i.ri	888 B	-rw-r--r--	2025-04-28 21:06
echo%3d-i.ri	509 B	-rw-r--r--	2025-04-28 21:06
echo%3f-i.ri	434 B	-rw-r--r--	2025-04-28 21:06
eof%3f-i.ri	1.37 KB	-rw-r--r--	2025-04-28 21:06
eof-i.ri	1.39 KB	-rw-r--r--	2025-04-28 21:06
erase_line-i.ri	240 B	-rw-r--r--	2025-04-28 21:06
erase_screen-i.ri	244 B	-rw-r--r--	2025-04-28 21:06
expect-i.ri	1.44 KB	-rw-r--r--	2025-04-28 21:06
external_encoding-i.ri	457 B	-rw-r--r--	2025-04-28 21:06
fcntl-i.ri	765 B	-rw-r--r--	2025-04-28 21:06
fdatasync-i.ri	498 B	-rw-r--r--	2025-04-28 21:06
fileno-i.ri	615 B	-rw-r--r--	2025-04-28 21:06
flush-i.ri	572 B	-rw-r--r--	2025-04-28 21:06
for_fd-c.ri	316 B	-rw-r--r--	2025-04-28 21:06
foreach-c.ri	1.89 KB	-rw-r--r--	2025-04-28 21:06
fsync-i.ri	934 B	-rw-r--r--	2025-04-28 21:06
getbyte-i.ri	538 B	-rw-r--r--	2025-04-28 21:06
getc-i.ri	518 B	-rw-r--r--	2025-04-28 21:06
getch-i.ri	517 B	-rw-r--r--	2025-04-28 21:06
getpass-i.ri	635 B	-rw-r--r--	2025-04-28 21:06
gets-i.ri	3.24 KB	-rw-r--r--	2025-04-28 21:06
goto-i.ri	232 B	-rw-r--r--	2025-04-28 21:06
goto_column-i.ri	242 B	-rw-r--r--	2025-04-28 21:06
iflush-i.ri	406 B	-rw-r--r--	2025-04-28 21:06
inspect-i.ri	450 B	-rw-r--r--	2025-04-28 21:06
internal_encoding-i.ri	415 B	-rw-r--r--	2025-04-28 21:06
ioctl-i.ri	687 B	-rw-r--r--	2025-04-28 21:06
ioflush-i.ri	421 B	-rw-r--r--	2025-04-28 21:06
isatty-i.ri	610 B	-rw-r--r--	2025-04-28 21:06
lineno%3d-i.ri	869 B	-rw-r--r--	2025-04-28 21:06
lineno-i.ri	1000 B	-rw-r--r--	2025-04-28 21:06
new-c.ri	5.98 KB	-rw-r--r--	2025-04-28 21:06
noecho-i.ri	553 B	-rw-r--r--	2025-04-28 21:06
nonblock%3d-i.ri	420 B	-rw-r--r--	2025-04-28 21:06
nonblock%3f-i.ri	361 B	-rw-r--r--	2025-04-28 21:06
nonblock-i.ri	564 B	-rw-r--r--	2025-04-28 21:06
nread-i.ri	389 B	-rw-r--r--	2025-04-28 21:06
oflush-i.ri	407 B	-rw-r--r--	2025-04-28 21:06
open-c.ri	759 B	-rw-r--r--	2025-04-28 21:06
pathconf-i.ri	730 B	-rw-r--r--	2025-04-28 21:06
pid-i.ri	784 B	-rw-r--r--	2025-04-28 21:06
pipe-c.ri	2.65 KB	-rw-r--r--	2025-04-28 21:06
popen-c.ri	3.71 KB	-rw-r--r--	2025-04-28 21:06
pos%3d-i.ri	596 B	-rw-r--r--	2025-04-28 21:06
pos-i.ri	638 B	-rw-r--r--	2025-04-28 21:06
pread-i.ri	1.33 KB	-rw-r--r--	2025-04-28 21:06
pressed%3f-i.ri	236 B	-rw-r--r--	2025-04-28 21:06
print-i.ri	1.01 KB	-rw-r--r--	2025-04-28 21:06
printf-i.ri	439 B	-rw-r--r--	2025-04-28 21:06
putc-i.ri	679 B	-rw-r--r--	2025-04-28 21:06
puts-i.ri	1.04 KB	-rw-r--r--	2025-04-28 21:06
pwrite-i.ri	1.01 KB	-rw-r--r--	2025-04-28 21:06
raw%21-i.ri	593 B	-rw-r--r--	2025-04-28 21:06
raw-i.ri	1.08 KB	-rw-r--r--	2025-04-28 21:06
read-c.ri	2.15 KB	-rw-r--r--	2025-04-28 21:06
read-i.ri	3.08 KB	-rw-r--r--	2025-04-28 21:06
read_nonblock-i.ri	2.78 KB	-rw-r--r--	2025-04-28 21:06
readbyte-i.ri	362 B	-rw-r--r--	2025-04-28 21:06
readchar-i.ri	526 B	-rw-r--r--	2025-04-28 21:06
readline-i.ri	488 B	-rw-r--r--	2025-04-28 21:06
readlines-c.ri	1.99 KB	-rw-r--r--	2025-04-28 21:06
readlines-i.ri	1.17 KB	-rw-r--r--	2025-04-28 21:06
readpartial-i.ri	4.43 KB	-rw-r--r--	2025-04-28 21:06
ready%3f-i.ri	358 B	-rw-r--r--	2025-04-28 21:06
reopen-i.ri	893 B	-rw-r--r--	2025-04-28 21:06
rewind-i.ri	887 B	-rw-r--r--	2025-04-28 21:06
scroll_backward-i.ri	250 B	-rw-r--r--	2025-04-28 21:06
scroll_forward-i.ri	248 B	-rw-r--r--	2025-04-28 21:06
seek-i.ri	1.66 KB	-rw-r--r--	2025-04-28 21:06
select-c.ri	5.85 KB	-rw-r--r--	2025-04-28 21:06
set_encoding-i.ri	1.11 KB	-rw-r--r--	2025-04-28 21:06
set_encoding_by_bom-i.ri	910 B	-rw-r--r--	2025-04-28 21:06
stat-i.ri	595 B	-rw-r--r--	2025-04-28 21:06
sync%3d-i.ri	928 B	-rw-r--r--	2025-04-28 21:06
sync-i.ri	651 B	-rw-r--r--	2025-04-28 21:06
sysopen-c.ri	509 B	-rw-r--r--	2025-04-28 21:06
sysread-i.ri	991 B	-rw-r--r--	2025-04-28 21:06
sysseek-i.ri	698 B	-rw-r--r--	2025-04-28 21:06
syswrite-i.ri	678 B	-rw-r--r--	2025-04-28 21:06
tell-i.ri	661 B	-rw-r--r--	2025-04-28 21:06
to_i-i.ri	589 B	-rw-r--r--	2025-04-28 21:06
to_io-i.ri	281 B	-rw-r--r--	2025-04-28 21:06
try_convert-c.ri	653 B	-rw-r--r--	2025-04-28 21:06
tty%3f-i.ri	542 B	-rw-r--r--	2025-04-28 21:06
ungetbyte-i.ri	1.64 KB	-rw-r--r--	2025-04-28 21:06
ungetc-i.ri	1.51 KB	-rw-r--r--	2025-04-28 21:06
wait-i.ri	824 B	-rw-r--r--	2025-04-28 21:06
wait_priority-i.ri	452 B	-rw-r--r--	2025-04-28 21:06
wait_readable-i.ri	520 B	-rw-r--r--	2025-04-28 21:06
wait_writable-i.ri	452 B	-rw-r--r--	2025-04-28 21:06
winsize%3d-i.ri	498 B	-rw-r--r--	2025-04-28 21:06
winsize-i.ri	422 B	-rw-r--r--	2025-04-28 21:06
write-c.ri	2.42 KB	-rw-r--r--	2025-04-28 21:06
write-i.ri	788 B	-rw-r--r--	2025-04-28 21:06
write_nonblock-i.ri	2.55 KB	-rw-r--r--	2025-04-28 21:06

Rename

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