Diff of autodoc.git/traditional_manual/chapter_9.html (875daa76b32e4d6ad6ce95604f88ca10fdd02f85 » f7261b6792e6ba97f6cad01e2d34b2a77efbccb1)

autodoc.git/traditional_manual/chapter_9.html:1029: <dt class='head--type'>Method query_read_callback Method query_write_callback Method query_read_oob_callback Method query_write_oob_callback Method query_close_callback + Method + query_callbacks </dt> <dd><code><code class='datatype'>function</code>(<code class='datatype'>mixed</code>, <code class='datatype'>string</code>:<code class='datatype'>int</code>) query_read_callback()</code> <code><code class='datatype'>function</code>(<code class='datatype'>mixed</code>:<code class='datatype'>int</code>) query_write_callback()</code> <code><code class='datatype'>function</code>(<code class='datatype'>mixed</code>, <code class='datatype'>string</code>:<code class='datatype'>int</code>) query_read_oob_callback()</code> <code><code class='datatype'>function</code>(<code class='datatype'>mixed</code>:<code class='datatype'>int</code>) query_write_oob_callback()</code> - <code><code class='datatype'>function</code>(<code class='datatype'>mixed</code>:<code class='datatype'>int</code>) query_close_callback()</code></dd> + <code><code class='datatype'>function</code>(<code class='datatype'>mixed</code>:<code class='datatype'>int</code>) query_close_callback()</code> + <code><code class='datatype'>array</code>(<code class='datatype'>function</code>(<code class='datatype'>mixed</code>, <code class='datatype'>void</code>|<code class='datatype'>string</code>:<code class='datatype'>int</code>)) query_callbacks()</code></dd> <dt class='head--doc'>Description</dt> <dd class='body--doc'>These functions return the currently installed callbacks for the respective events. - + <code>query_callbacks</code> returns the callbacks in the same order as + <code>set_callbacks</code> and <code>set_nonblocking</code> expect them. </dd> <dt class='head--doc'>See also</dt> <dd class='body--doc'><code>set_nonblocking()</code>, <code>set_read_callback</code>, <code>set_write_callback</code>, <code>set_read_oob_callback</code>, - <code>set_write_oob_callback</code>, <code>set_close_callback</code> + <code>set_write_oob_callback</code>, <code>set_close_callback</code>, + <code>set_callbacks</code> </dd></dl> <hr /> <dl class='group--doc'> <dt class='head--type'>Method query_fd </dt> <dd><code><code class='datatype'>int</code> query_fd()</code></dd>
autodoc.git/traditional_manual/chapter_9.html:1365: but it certainly helps to increase data transfer speed when it does. </dd> <dt class='head--doc'>See also</dt> <dd class='body--doc'><code>open_socket()</code>, <code>accept()</code> </dd></dl> <hr /> <dl class='group--doc'> <dt class='head--type'>Method + set_callbacks + </dt> + <dd><code><code class='datatype'>void</code> set_callbacks(<code class='datatype'>void</code>|<code class='datatype'>function</code>(<code class='datatype'>mixed</code>, <code class='datatype'>string</code>:<code class='datatype'>int</code>) <code class='argument'>read_cb</code>, <code class='datatype'>void</code>|<code class='datatype'>function</code>(<code class='datatype'>mixed</code>:<code class='datatype'>int</code>) <code class='argument'>write_cb</code>, <code class='datatype'>void</code>|<code class='datatype'>function</code>(<code class='datatype'>mixed</code>:<code class='datatype'>int</code>) <code class='argument'>close_cb</code>, <code class='datatype'>void</code>|<code class='datatype'>function</code>(<code class='datatype'>mixed</code>, <code class='datatype'>string</code>:<code class='datatype'>int</code>) <code class='argument'>read_oob_cb</code>, <code class='datatype'>void</code>|<code class='datatype'>function</code>(<code class='datatype'>mixed</code>:<code class='datatype'>int</code>) <code class='argument'>write_oob_cb</code>)</code></dd> + + <dt class='head--doc'>Description</dt> + <dd class='body--doc'>Installs all the specified callbacks at once. Use <code>UNDEFINED</code> + to keep the current setting for a callback. + Like <code>set_nonblocking</code>, the callbacks are installed atomically. + As opposed to <code>set_nonblocking</code>, this function does not do + anything with the stream, and it doesn't even have to be open. + </dd> + <dt class='head--doc'>See also</dt> + <dd class='body--doc'><code>set_read_callback</code>, <code>set_write_callback</code>, + <code>set_read_oob_callback</code>, <code>set_write_oob_callback</code>, + <code>set_close_callback</code>, <code>query_callbacks</code> + </dd></dl> + + + <hr /> + <dl class='group--doc'> + <dt class='head--type'>Method set_read_callback Method set_write_callback Method set_read_oob_callback Method set_write_oob_callback Method set_close_callback </dt>
autodoc.git/traditional_manual/chapter_9.html:1451: If a callback returns <code class='expr'>-1</code>, no other callback or call out will be called by the backend in that round. I.e. the caller of the backend will get control back right away. For the default backend that means it will immediately start another round and check files and call outs anew. </dd> <dt class='head--doc'>Note</dt> <dd class='body--doc'>These functions do not set the file nonblocking. </dd> <dt class='head--doc'>Note</dt> - <dd class='body--doc'>Callbacks are also set by <code>set_nonblocking()</code>. + <dd class='body--doc'>Callbacks are also set by <code>set_callbacks</code> and + <code>set_nonblocking()</code>. </dd> <dt class='head--doc'>Note</dt> <dd class='body--doc'>After a callback has been called, it's disabled until it has accessed the stream accordingly, i.e. the <code>write_cb</code> callback is disabled after it's been called until something has been written with <code>write</code>, and the <code>write_oob_cb</code> callback is likewise disabled until something has been written with <code>write_oob</code>. Since the data already has been read when the read callbacks are called, this effect is not noticeable for them. </dd>
autodoc.git/traditional_manual/chapter_9.html:1490: <dd class='body--doc'>The file object will stay referenced from the backend object as long as there are callbacks that can receive events. </dd> <dt class='head--doc'>Bugs</dt> <dd class='body--doc'>Setting a close callback without a read callback currently only works when there's no risk of getting more data on the stream. Otherwise the close callback will be silently deregistered if data arrives. </dd> <dt class='head--doc'>See also</dt> - <dd class='body--doc'><code>set_nonblocking()</code>, <code>set_id()</code>, <code>set_backend</code>, - <code>query_read_callback</code>, <code>query_write_callback</code>, + <dd class='body--doc'><code>set_callbacks</code>, <code>set_nonblocking()</code>, <code>set_id()</code>, + <code>set_backend</code>, <code>query_read_callback</code>, <code>query_write_callback</code>, <code>query_read_oob_callback</code>, <code>query_write_oob_callback</code>, <code>query_close_callback</code> </dd></dl> <hr /> <dl class='group--doc'> <dt class='head--type'>Method set_close_on_exec </dt>
autodoc.git/traditional_manual/chapter_9.html:1592: this function will set all the callbacks and nonblocking mode atomically so that no callback gets called in between. That avoids races in case the backend is executed by another thread. </dd> <dt class='head--doc'>Note</dt> <dd class='body--doc'>Out-of-band data was not be supported on Pike 0.5 and earlier, and not on Pike 0.6 through 7.4 if they were compiled with the option <tt>'--without-oob'</tt>. </dd> <dt class='head--doc'>See also</dt> - <dd class='body--doc'><code>set_blocking()</code>, <code>set_read_callback()</code>, + <dd class='body--doc'><code>set_blocking()</code>, <code>set_callbacks</code>, <code>set_read_callback()</code>, <code>set_write_callback()</code>, <code>set_read_oob_callback()</code>, <code>set_write_oob_callback()</code>, <code>set_close_callback()</code> <code>set_nonblocking_keep_callbacks()</code>, <code>set_blocking_keep_callbacks()</code> </dd></dl> <hr /> <dl class='group--doc'> <dt class='head--type'>Method

autodoc.git / traditional_manual / chapter_9.html