This manual page is for Mac OS X version 10.6

If you are running a different version of Mac OS X, view the documentation locally:

  • In Terminal, using the man(1) command

Reading manual pages

Manual pages are intended as a quick reference for people who already understand a technology.

  • For more information about the manual page format, see the manual page for manpages(5).

  • For more information about this technology, look for other documentation in the Apple Reference Library.

  • For general information about writing shell scripts, read Shell Scripting Primer.


IO::Poll(3pm)                         Perl Programmers Reference Guide                         IO::Poll(3pm)



NAME
       IO::Poll - Object interface to system poll call

SYNOPSIS
           use IO::Poll qw(POLLRDNORM POLLWRNORM POLLIN POLLHUP);

           $poll = new IO::Poll;

           $poll->mask($input_handle => POLLIN);
           $poll->mask($output_handle => POLLOUT);

           $poll->poll($timeout);

           $ev = $poll->events($input);

DESCRIPTION
       "IO::Poll" is a simple interface to the system level poll routine.

METHODS
       mask ( IO [, EVENT_MASK ] )
           If EVENT_MASK is given, then, if EVENT_MASK is non-zero, IO is added to the list of file descrip-tors descriptors
           tors and the next call to poll will check for any event specified in EVENT_MASK. If EVENT_MASK is
           zero then IO will be removed from the list of file descriptors.

           If EVENT_MASK is not given then the return value will be the current event mask value for IO.

       poll ( [ TIMEOUT ] )
           Call the system level poll routine. If TIMEOUT is not specified then the call will block. Returns
           the number of handles which had events happen, or -1 on error.

       events ( IO )
           Returns the event mask which represents the events that happened on IO during the last call to
           "poll".

       remove ( IO )
           Remove IO from the list of file descriptors for the next poll.

       handles( [ EVENT_MASK ] )
           Returns a list of handles. If EVENT_MASK is not given then a list of all handles known will be
           returned. If EVENT_MASK is given then a list of handles will be returned which had one of the
           events specified by EVENT_MASK happen during the last call ti "poll"

SEE ALSO
       poll(2), IO::Handle, IO::Select

AUTHOR
       Graham Barr. Currently maintained by the Perl Porters.  Please report all bugs to
       <[email protected]>.

COPYRIGHT
       Copyright (c) 1997-8 Graham Barr <[email protected]>. All rights reserved.  This program is free soft-ware; software;
       ware; you can redistribute it and/or modify it under the same terms as Perl itself.



perl v5.8.9                                      2001-09-21                                    IO::Poll(3pm)

Reporting Problems

The way to report a problem with this manual page depends on the type of problem:

Content errors
Report errors in the content of this documentation to the Perl project. (See perlbug(1) for submission instructions.)
Bug reports
Report bugs in the functionality of the described tool or API to Apple through Bug Reporter and to the Perl project using perlbug(1).
Formatting problems
Report formatting mistakes in the online version of these pages with the feedback links below.