Gecko [ beriskala.com ]

Name	Size	Permission	Date
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	573 B	-rw-r--r--	2023-06-06 18:25
advise-i.ri	2.44 KB	-rw-r--r--	2023-06-06 18:25
autoclose%3d-i.ri	635 B	-rw-r--r--	2023-06-06 18:25
autoclose%3f-i.ri	429 B	-rw-r--r--	2023-06-06 18:25
beep-i.ri	226 B	-rw-r--r--	2023-06-06 18:25
binmode%3f-i.ri	344 B	-rw-r--r--	2023-06-06 18:25
binmode-i.ri	658 B	-rw-r--r--	2023-06-06 18:25
binread-c.ri	907 B	-rw-r--r--	2023-06-06 18:25
binwrite-c.ri	502 B	-rw-r--r--	2023-06-06 18:25
bytes-i.ri	288 B	-rw-r--r--	2023-06-06 18:25
cdesc-IO.ri	8.35 KB	-rw-r--r--	2023-06-06 18:25
chars-i.ri	288 B	-rw-r--r--	2023-06-06 18:25
check_winsize_changed-i.ri	260 B	-rw-r--r--	2023-06-06 18:25
clear_screen-i.ri	242 B	-rw-r--r--	2023-06-06 18:25
close-i.ri	764 B	-rw-r--r--	2023-06-06 18:25
close_on_exec%3d-i.ri	1.01 KB	-rw-r--r--	2023-06-06 18:25
close_on_exec%3f-i.ri	678 B	-rw-r--r--	2023-06-06 18:25
close_read-i.ri	833 B	-rw-r--r--	2023-06-06 18:25
close_write-i.ri	873 B	-rw-r--r--	2023-06-06 18:25
closed%3f-i.ri	764 B	-rw-r--r--	2023-06-06 18:25
codepoints-i.ri	303 B	-rw-r--r--	2023-06-06 18:25
console-c.ri	637 B	-rw-r--r--	2023-06-06 18:25
console_mode%3d-i.ri	436 B	-rw-r--r--	2023-06-06 18:25
console_mode-i.ri	458 B	-rw-r--r--	2023-06-06 18:25
cooked%21-i.ri	476 B	-rw-r--r--	2023-06-06 18:25
cooked-i.ri	561 B	-rw-r--r--	2023-06-06 18:25
copy_stream-c.ri	1.41 KB	-rw-r--r--	2023-06-06 18:25
cursor%3d-i.ri	234 B	-rw-r--r--	2023-06-06 18:25
cursor-i.ri	230 B	-rw-r--r--	2023-06-06 18:25
cursor_down-i.ri	242 B	-rw-r--r--	2023-06-06 18:25
cursor_left-i.ri	242 B	-rw-r--r--	2023-06-06 18:25
cursor_right-i.ri	244 B	-rw-r--r--	2023-06-06 18:25
cursor_up-i.ri	238 B	-rw-r--r--	2023-06-06 18:25
each-i.ri	1.35 KB	-rw-r--r--	2023-06-06 18:25
each_byte-i.ri	830 B	-rw-r--r--	2023-06-06 18:25
each_char-i.ri	755 B	-rw-r--r--	2023-06-06 18:25
each_codepoint-i.ri	728 B	-rw-r--r--	2023-06-06 18:25
each_line-i.ri	1.11 KB	-rw-r--r--	2023-06-06 18:25
echo%3d-i.ri	509 B	-rw-r--r--	2023-06-06 18:25
echo%3f-i.ri	434 B	-rw-r--r--	2023-06-06 18:25
eof%3f-i.ri	1.24 KB	-rw-r--r--	2023-06-06 18:25
eof-i.ri	1.26 KB	-rw-r--r--	2023-06-06 18:25
erase_line-i.ri	240 B	-rw-r--r--	2023-06-06 18:25
erase_screen-i.ri	244 B	-rw-r--r--	2023-06-06 18:25
expect-i.ri	1.44 KB	-rw-r--r--	2023-06-06 18:25
external_encoding-i.ri	457 B	-rw-r--r--	2023-06-06 18:25
fcntl-i.ri	765 B	-rw-r--r--	2023-06-06 18:25
fdatasync-i.ri	549 B	-rw-r--r--	2023-06-06 18:25
fileno-i.ri	542 B	-rw-r--r--	2023-06-06 18:25
flush-i.ri	637 B	-rw-r--r--	2023-06-06 18:25
for_fd-c.ri	316 B	-rw-r--r--	2023-06-06 18:25
foreach-c.ri	1.23 KB	-rw-r--r--	2023-06-06 18:25
fsync-i.ri	702 B	-rw-r--r--	2023-06-06 18:25
getbyte-i.ri	538 B	-rw-r--r--	2023-06-06 18:25
getc-i.ri	518 B	-rw-r--r--	2023-06-06 18:25
getch-i.ri	517 B	-rw-r--r--	2023-06-06 18:25
getpass-i.ri	497 B	-rw-r--r--	2023-06-06 18:25
gets-i.ri	1.73 KB	-rw-r--r--	2023-06-06 18:25
goto-i.ri	232 B	-rw-r--r--	2023-06-06 18:25
goto_column-i.ri	242 B	-rw-r--r--	2023-06-06 18:25
iflush-i.ri	406 B	-rw-r--r--	2023-06-06 18:25
inspect-i.ri	322 B	-rw-r--r--	2023-06-06 18:25
internal_encoding-i.ri	415 B	-rw-r--r--	2023-06-06 18:25
ioctl-i.ri	687 B	-rw-r--r--	2023-06-06 18:25
ioflush-i.ri	421 B	-rw-r--r--	2023-06-06 18:25
isatty-i.ri	564 B	-rw-r--r--	2023-06-06 18:25
lineno%3d-i.ri	869 B	-rw-r--r--	2023-06-06 18:25
lineno-i.ri	1000 B	-rw-r--r--	2023-06-06 18:25
lines-i.ri	293 B	-rw-r--r--	2023-06-06 18:25
new-c.ri	5.98 KB	-rw-r--r--	2023-06-06 18:25
noecho-i.ri	553 B	-rw-r--r--	2023-06-06 18:25
nonblock%3d-i.ri	420 B	-rw-r--r--	2023-06-06 18:25
nonblock%3f-i.ri	361 B	-rw-r--r--	2023-06-06 18:25
nonblock-i.ri	564 B	-rw-r--r--	2023-06-06 18:25
nread-i.ri	389 B	-rw-r--r--	2023-06-06 18:25
oflush-i.ri	407 B	-rw-r--r--	2023-06-06 18:25
open-c.ri	759 B	-rw-r--r--	2023-06-06 18:25
pathconf-i.ri	730 B	-rw-r--r--	2023-06-06 18:25
pid-i.ri	730 B	-rw-r--r--	2023-06-06 18:25
pipe-c.ri	2.65 KB	-rw-r--r--	2023-06-06 18:25
popen-c.ri	3.71 KB	-rw-r--r--	2023-06-06 18:25
pos%3d-i.ri	597 B	-rw-r--r--	2023-06-06 18:25
pos-i.ri	508 B	-rw-r--r--	2023-06-06 18:25
pread-i.ri	1.33 KB	-rw-r--r--	2023-06-06 18:25
pressed%3f-i.ri	236 B	-rw-r--r--	2023-06-06 18:25
print-i.ri	1.01 KB	-rw-r--r--	2023-06-06 18:25
printf-i.ri	439 B	-rw-r--r--	2023-06-06 18:25
putc-i.ri	679 B	-rw-r--r--	2023-06-06 18:25
puts-i.ri	1.04 KB	-rw-r--r--	2023-06-06 18:25
pwrite-i.ri	1.01 KB	-rw-r--r--	2023-06-06 18:25
raw%21-i.ri	593 B	-rw-r--r--	2023-06-06 18:25
raw-i.ri	1.08 KB	-rw-r--r--	2023-06-06 18:25
read-c.ri	1.92 KB	-rw-r--r--	2023-06-06 18:25
read-i.ri	2.9 KB	-rw-r--r--	2023-06-06 18:25
read_nonblock-i.ri	2.78 KB	-rw-r--r--	2023-06-06 18:25
readbyte-i.ri	362 B	-rw-r--r--	2023-06-06 18:25
readchar-i.ri	526 B	-rw-r--r--	2023-06-06 18:25
readline-i.ri	488 B	-rw-r--r--	2023-06-06 18:25
readlines-c.ri	1.42 KB	-rw-r--r--	2023-06-06 18:25
readlines-i.ri	1.17 KB	-rw-r--r--	2023-06-06 18:25
readpartial-i.ri	3.53 KB	-rw-r--r--	2023-06-06 18:25
ready%3f-i.ri	354 B	-rw-r--r--	2023-06-06 18:25
reopen-i.ri	893 B	-rw-r--r--	2023-06-06 18:25
rewind-i.ri	686 B	-rw-r--r--	2023-06-06 18:25
scroll_backward-i.ri	250 B	-rw-r--r--	2023-06-06 18:25
scroll_forward-i.ri	248 B	-rw-r--r--	2023-06-06 18:25
seek-i.ri	1.07 KB	-rw-r--r--	2023-06-06 18:25
select-c.ri	5.85 KB	-rw-r--r--	2023-06-06 18:25
set_encoding-i.ri	1.11 KB	-rw-r--r--	2023-06-06 18:25
set_encoding_by_bom-i.ri	910 B	-rw-r--r--	2023-06-06 18:25
stat-i.ri	595 B	-rw-r--r--	2023-06-06 18:25
sync%3d-i.ri	659 B	-rw-r--r--	2023-06-06 18:25
sync-i.ri	626 B	-rw-r--r--	2023-06-06 18:25
sysopen-c.ri	509 B	-rw-r--r--	2023-06-06 18:25
sysread-i.ri	991 B	-rw-r--r--	2023-06-06 18:25
sysseek-i.ri	698 B	-rw-r--r--	2023-06-06 18:25
syswrite-i.ri	678 B	-rw-r--r--	2023-06-06 18:25
tell-i.ri	510 B	-rw-r--r--	2023-06-06 18:25
to_i-i.ri	223 B	-rw-r--r--	2023-06-06 18:25
to_io-i.ri	291 B	-rw-r--r--	2023-06-06 18:25
try_convert-c.ri	823 B	-rw-r--r--	2023-06-06 18:25
tty%3f-i.ri	560 B	-rw-r--r--	2023-06-06 18:25
ungetbyte-i.ri	935 B	-rw-r--r--	2023-06-06 18:25
ungetc-i.ri	921 B	-rw-r--r--	2023-06-06 18:25
wait-i.ri	586 B	-rw-r--r--	2023-06-06 18:25
wait_readable-i.ri	539 B	-rw-r--r--	2023-06-06 18:25
wait_writable-i.ri	452 B	-rw-r--r--	2023-06-06 18:25
winsize%3d-i.ri	498 B	-rw-r--r--	2023-06-06 18:25
winsize-i.ri	422 B	-rw-r--r--	2023-06-06 18:25
write-c.ri	1.85 KB	-rw-r--r--	2023-06-06 18:25
write-i.ri	794 B	-rw-r--r--	2023-06-06 18:25
write_nonblock-i.ri	2.55 KB	-rw-r--r--	2023-06-06 18:25

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