Gecko [ beriskala.com ]

Name	Size	Permission	Date
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	572 B	-rw-r--r--	2023-07-26 18:33
advise-i.ri	2.55 KB	-rw-r--r--	2023-07-26 18:33
autoclose%3d-i.ri	623 B	-rw-r--r--	2023-07-26 18:33
autoclose%3f-i.ri	428 B	-rw-r--r--	2023-07-26 18:33
beep-i.ri	225 B	-rw-r--r--	2023-07-26 18:33
binmode%3f-i.ri	343 B	-rw-r--r--	2023-07-26 18:33
binmode-i.ri	657 B	-rw-r--r--	2023-07-26 18:33
binread-c.ri	904 B	-rw-r--r--	2023-07-26 18:33
binwrite-c.ri	501 B	-rw-r--r--	2023-07-26 18:33
block_scanf-i.ri	244 B	-rw-r--r--	2023-07-26 18:33
bytes-i.ri	299 B	-rw-r--r--	2023-07-26 18:33
cdesc-IO.ri	8.14 KB	-rw-r--r--	2023-07-26 18:33
chars-i.ri	299 B	-rw-r--r--	2023-07-26 18:33
close-i.ri	808 B	-rw-r--r--	2023-07-26 18:33
close_on_exec%3d-i.ri	1.01 KB	-rw-r--r--	2023-07-26 18:33
close_on_exec%3f-i.ri	677 B	-rw-r--r--	2023-07-26 18:33
close_read-i.ri	845 B	-rw-r--r--	2023-07-26 18:33
close_write-i.ri	885 B	-rw-r--r--	2023-07-26 18:33
closed%3f-i.ri	763 B	-rw-r--r--	2023-07-26 18:33
codepoints-i.ri	314 B	-rw-r--r--	2023-07-26 18:33
console-c.ri	636 B	-rw-r--r--	2023-07-26 18:33
cooked%21-i.ri	475 B	-rw-r--r--	2023-07-26 18:33
cooked-i.ri	560 B	-rw-r--r--	2023-07-26 18:33
copy_stream-c.ri	1.45 KB	-rw-r--r--	2023-07-26 18:33
cursor%3d-i.ri	233 B	-rw-r--r--	2023-07-26 18:33
cursor-i.ri	229 B	-rw-r--r--	2023-07-26 18:33
each-i.ri	1.36 KB	-rw-r--r--	2023-07-26 18:33
each_byte-i.ri	842 B	-rw-r--r--	2023-07-26 18:33
each_char-i.ri	767 B	-rw-r--r--	2023-07-26 18:33
each_codepoint-i.ri	753 B	-rw-r--r--	2023-07-26 18:33
each_line-i.ri	1.12 KB	-rw-r--r--	2023-07-26 18:33
echo%3d-i.ri	508 B	-rw-r--r--	2023-07-26 18:33
echo%3f-i.ri	433 B	-rw-r--r--	2023-07-26 18:33
eof%3f-i.ri	1.32 KB	-rw-r--r--	2023-07-26 18:33
eof-i.ri	1.34 KB	-rw-r--r--	2023-07-26 18:33
expect-i.ri	1.44 KB	-rw-r--r--	2023-07-26 18:33
external_encoding-i.ri	456 B	-rw-r--r--	2023-07-26 18:33
fcntl-i.ri	776 B	-rw-r--r--	2023-07-26 18:33
fdatasync-i.ri	574 B	-rw-r--r--	2023-07-26 18:33
fileno-i.ri	541 B	-rw-r--r--	2023-07-26 18:33
flush-i.ri	636 B	-rw-r--r--	2023-07-26 18:33
for_fd-c.ri	328 B	-rw-r--r--	2023-07-26 18:33
foreach-c.ri	1.23 KB	-rw-r--r--	2023-07-26 18:33
fsync-i.ri	746 B	-rw-r--r--	2023-07-26 18:33
getbyte-i.ri	537 B	-rw-r--r--	2023-07-26 18:33
getc-i.ri	517 B	-rw-r--r--	2023-07-26 18:33
getch-i.ri	511 B	-rw-r--r--	2023-07-26 18:33
getpass-i.ri	496 B	-rw-r--r--	2023-07-26 18:33
gets-i.ri	1.74 KB	-rw-r--r--	2023-07-26 18:33
goto-i.ri	231 B	-rw-r--r--	2023-07-26 18:33
iflush-i.ri	405 B	-rw-r--r--	2023-07-26 18:33
inspect-i.ri	321 B	-rw-r--r--	2023-07-26 18:33
internal_encoding-i.ri	414 B	-rw-r--r--	2023-07-26 18:33
ioctl-i.ri	686 B	-rw-r--r--	2023-07-26 18:33
ioflush-i.ri	420 B	-rw-r--r--	2023-07-26 18:33
isatty-i.ri	563 B	-rw-r--r--	2023-07-26 18:33
lineno%3d-i.ri	868 B	-rw-r--r--	2023-07-26 18:33
lineno-i.ri	1023 B	-rw-r--r--	2023-07-26 18:33
lines-i.ri	304 B	-rw-r--r--	2023-07-26 18:33
new-c.ri	6.01 KB	-rw-r--r--	2023-07-26 18:33
noecho-i.ri	552 B	-rw-r--r--	2023-07-26 18:33
nonblock%3d-i.ri	419 B	-rw-r--r--	2023-07-26 18:33
nonblock%3f-i.ri	360 B	-rw-r--r--	2023-07-26 18:33
nonblock-i.ri	563 B	-rw-r--r--	2023-07-26 18:33
nread-i.ri	388 B	-rw-r--r--	2023-07-26 18:33
oflush-i.ri	406 B	-rw-r--r--	2023-07-26 18:33
open-c.ri	771 B	-rw-r--r--	2023-07-26 18:33
pathconf-i.ri	729 B	-rw-r--r--	2023-07-26 18:33
pid-i.ri	742 B	-rw-r--r--	2023-07-26 18:33
pipe-c.ri	2.67 KB	-rw-r--r--	2023-07-26 18:33
popen-c.ri	3.78 KB	-rw-r--r--	2023-07-26 18:33
pos%3d-i.ri	596 B	-rw-r--r--	2023-07-26 18:33
pos-i.ri	507 B	-rw-r--r--	2023-07-26 18:33
pread-i.ri	1.38 KB	-rw-r--r--	2023-07-26 18:33
pressed%3f-i.ri	235 B	-rw-r--r--	2023-07-26 18:33
print-i.ri	1.01 KB	-rw-r--r--	2023-07-26 18:33
printf-i.ri	458 B	-rw-r--r--	2023-07-26 18:33
putc-i.ri	722 B	-rw-r--r--	2023-07-26 18:33
puts-i.ri	1.04 KB	-rw-r--r--	2023-07-26 18:33
pwrite-i.ri	1.04 KB	-rw-r--r--	2023-07-26 18:33
raw%21-i.ri	544 B	-rw-r--r--	2023-07-26 18:33
raw-i.ri	931 B	-rw-r--r--	2023-07-26 18:33
read-c.ri	1.93 KB	-rw-r--r--	2023-07-26 18:33
read-i.ri	2.89 KB	-rw-r--r--	2023-07-26 18:33
read_nonblock-i.ri	2.61 KB	-rw-r--r--	2023-07-26 18:33
readbyte-i.ri	387 B	-rw-r--r--	2023-07-26 18:33
readchar-i.ri	538 B	-rw-r--r--	2023-07-26 18:33
readline-i.ri	520 B	-rw-r--r--	2023-07-26 18:33
readlines-c.ri	1.42 KB	-rw-r--r--	2023-07-26 18:33
readlines-i.ri	1.18 KB	-rw-r--r--	2023-07-26 18:33
readpartial-i.ri	3.51 KB	-rw-r--r--	2023-07-26 18:33
ready%3f-i.ri	406 B	-rw-r--r--	2023-07-26 18:33
reopen-i.ri	892 B	-rw-r--r--	2023-07-26 18:33
rewind-i.ri	697 B	-rw-r--r--	2023-07-26 18:33
scanf-i.ri	1019 B	-rw-r--r--	2023-07-26 18:33
seek-i.ri	1.07 KB	-rw-r--r--	2023-07-26 18:33
select-c.ri	6.49 KB	-rw-r--r--	2023-07-26 18:33
set_encoding-i.ri	1.11 KB	-rw-r--r--	2023-07-26 18:33
soak_up_spaces-i.ri	234 B	-rw-r--r--	2023-07-26 18:33
stat-i.ri	607 B	-rw-r--r--	2023-07-26 18:33
sync%3d-i.ri	671 B	-rw-r--r--	2023-07-26 18:33
sync-i.ri	638 B	-rw-r--r--	2023-07-26 18:33
sysopen-c.ri	521 B	-rw-r--r--	2023-07-26 18:33
sysread-i.ri	1023 B	-rw-r--r--	2023-07-26 18:33
sysseek-i.ri	710 B	-rw-r--r--	2023-07-26 18:33
syswrite-i.ri	690 B	-rw-r--r--	2023-07-26 18:33
tell-i.ri	509 B	-rw-r--r--	2023-07-26 18:33
to_i-i.ri	222 B	-rw-r--r--	2023-07-26 18:33
to_io-i.ri	290 B	-rw-r--r--	2023-07-26 18:33
try_convert-c.ri	822 B	-rw-r--r--	2023-07-26 18:33
tty%3f-i.ri	559 B	-rw-r--r--	2023-07-26 18:33
ungetbyte-i.ri	947 B	-rw-r--r--	2023-07-26 18:33
ungetc-i.ri	933 B	-rw-r--r--	2023-07-26 18:33
wait-i.ri	585 B	-rw-r--r--	2023-07-26 18:33
wait_readable-i.ri	538 B	-rw-r--r--	2023-07-26 18:33
wait_writable-i.ri	451 B	-rw-r--r--	2023-07-26 18:33
winsize%3d-i.ri	497 B	-rw-r--r--	2023-07-26 18:33
winsize-i.ri	421 B	-rw-r--r--	2023-07-26 18:33
write-c.ri	1.87 KB	-rw-r--r--	2023-07-26 18:33
write-i.ri	793 B	-rw-r--r--	2023-07-26 18:33
write_nonblock-i.ri	2.55 KB	-rw-r--r--	2023-07-26 18:33

Rename

U:RDoc::AnyMethod[iI"select:ETI"IO::select;TT:publico:RDoc::Markup::Document:@parts[-o:RDoc::Markup::Paragraph;	[I""Calls select(2) system call. ;TI"RIt monitors given arrays of <code>IO</code> objects, waits until one or more ;TI"Nof <code>IO</code> objects are ready for reading, are ready for writing, ;TI"Iand have pending exceptions respectively, and returns an array that ;TI"@contains arrays of those IO objects. It will return +nil+ ;TI"Mif optional timeout value is given and no <code>IO</code> object ;TI"(is ready in timeout seconds.;To:RDoc::Markup::BlankLine�o;
;	[
I"a<code>IO.select</code> peeks the buffer of <code>IO</code> objects for testing readability. ;TI"1If the <code>IO</code> buffer is not empty, ;TI"><code>IO.select</code> immediately notifies readability. ;TI";This "peek" only happens for <code>IO</code> objects. ;TI"LIt does not happen for IO-like objects such as OpenSSL::SSL::SSLSocket.;T@o;
;	[I"?The best way to use <code>IO.select</code> is invoking it ;TI"eafter nonblocking methods such as <code>read_nonblock</code>, <code>write_nonblock</code>, etc. ;TI"9The methods raise an exception which is extended by ;TI"E<code>IO::WaitReadable</code> or <code>IO::WaitWritable</code>. ;TI"PThe modules notify how the caller should wait with <code>IO.select</code>. ;TI"UIf <code>IO::WaitReadable</code> is raised, the caller should wait for reading. ;TI"TIf <code>IO::WaitWritable</code> is raised, the caller should wait for writing.;T@o;
;	[I"HSo, blocking read (<code>readpartial</code>) can be emulated using ;TI"F<code>read_nonblock</code> and <code>IO.select</code> 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"<Especially, the combination of nonblocking methods and ;TI"B<code>IO.select</code> is preferred for <code>IO</code> like ;TI";objects such as <code>OpenSSL::SSL::SSLSocket</code>. ;TI"SIt has <code>to_io</code> method to return underlying <code>IO</code> object. ;TI"[<code>IO.select</code> calls <code>to_io</code> to obtain the file descriptor to wait.;T@o;
;	[I"QThis means that readability notified by <code>IO.select</code> doesn't mean ;TI"Breadability from <code>OpenSSL::SSL::SSLSocket</code> object.;T@o;
;	[I"_The most likely situation is that <code>OpenSSL::SSL::SSLSocket</code> buffers some data. ;TI"4<code>IO.select</code> doesn't see the buffer. ;TI"mSo <code>IO.select</code> can block when <code>OpenSSL::SSL::SSLSocket#readpartial</code> 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"8So, the remote side of SSL sends a partial record, ;TI"5<code>IO.select</code> notifies readability but ;TI"D<code>OpenSSL::SSL::SSLSocket</code> cannot decrypt a byte and ;TI"A<code>OpenSSL::SSL::SSLSocket#readpartial</code> 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"EThis means <code>OpenSSL::SSL::SSLSocket#readpartial</code> may ;TI"=invoke <code>write</code> system call and it can block. ;TI"MIn such a situation, <code>OpenSSL::SSL::SSLSocket#read_nonblock</code> ;TI"2raises IO::WaitWritable instead of blocking. ;TI"KSo, the caller should wait for ready for writability as above example.;T@o;
;	[I"JThe combination of nonblocking methods and <code>IO.select</code> is ;TI"Balso useful for streams such as tty, pipe socket socket when ;TI"+multiple processes 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"]Invoking <code>IO.select</code> before <code>IO#readpartial</code> works well as usual. ;TI"BHowever it is not the best way to use <code>IO.select</code>.;T@o;
;	[
I"8The writability notified by select(2) doesn't show ;TI""how many bytes are writable. ;TI"N<code>IO#write</code> method blocks until given whole string is written. ;TI"uSo, <code>IO#write(two or more bytes)</code> can block after writability is notified by <code>IO.select</code>. ;TI"F<code>IO#write_nonblock</code> is required to avoid the blocking.;T@o;
;	[I"?Blocking write (<code>write</code>) can be emulated using ;TI"H<code>write_nonblock</code> and <code>IO.select</code> as follows: ;TI"kIO::WaitReadable should also be rescued for SSL renegotiation in <code>OpenSSL::SSL::SSLSocket</code>.;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"Gan array of <code>IO</code> objects that wait until ready for read;To;;[I"write_array;T;	[o;
;	[I"Han array of <code>IO</code> objects that wait until ready for write;To;;[I"error_array;T;	[o;
;	[I"Aan array of <code>IO</code> 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