ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/IO-AIO/AIO.pm
(Generate patch)

Comparing IO-AIO/AIO.pm (file contents):
Revision 1.191 by root, Thu May 19 23:57:12 2011 UTC vs.
Revision 1.193 by root, Thu May 26 04:15:37 2011 UTC

… …
692systems that do not deliver the inode information. 692systems that do not deliver the inode information.
693 693
694=item IO::AIO::READDIR_DIRS_FIRST 694=item IO::AIO::READDIR_DIRS_FIRST
695 695
696When this flag is set, then the names will be returned in an order where 696When this flag is set, then the names will be returned in an order where
697likely directories come first. This is useful when you need to quickly 697likely directories come first, in optimal stat order. This is useful when
698find directories, or you want to find all directories while avoiding to 698you need to quickly find directories, or you want to find all directories
699stat() each entry. 699while avoiding to stat() each entry.
700 700
701If the system returns type information in readdir, then this is used 701If the system returns type information in readdir, then this is used
702to find directories directly. Otherwise, likely directories are files 702to find directories directly. Otherwise, likely directories are names
703beginning with ".", or otherwise files with no dots, of which files with 703beginning with ".", or otherwise names with no dots, of which names with
704short names are tried first. 704short names are tried first.
705 705
706=item IO::AIO::READDIR_STAT_ORDER 706=item IO::AIO::READDIR_STAT_ORDER
707 707
708When this flag is set, then the names will be returned in an order 708When this flag is set, then the names will be returned in an order
… …
1417 1417
1418If not all requests were processed for whatever reason, the filehandle 1418If not all requests were processed for whatever reason, the filehandle
1419will still be ready when C<poll_cb> returns, so normally you don't have to 1419will still be ready when C<poll_cb> returns, so normally you don't have to
1420do anything special to have it called later. 1420do anything special to have it called later.
1421 1421
1422Apart from calling C<IO::AIO::poll_cb> when the event filehandle becomes
1423ready, it can be beneficial to call this function from loops which submit
1424a lot of requests, to make sure the results get processed when they become
1425available and not just when the loop is finished and the event loop takes
1426over again. This function returns very fast when there are no outstanding
1427requests.
1428
1422Example: Install an Event watcher that automatically calls 1429Example: Install an Event watcher that automatically calls
1423IO::AIO::poll_cb with high priority (more examples can be found in the 1430IO::AIO::poll_cb with high priority (more examples can be found in the
1424SYNOPSIS section, at the top of this document): 1431SYNOPSIS section, at the top of this document):
1425 1432
1426 Event->io (fd => IO::AIO::poll_fileno, 1433 Event->io (fd => IO::AIO::poll_fileno,

Diff Legend

– Removed lines
+ Added lines
< Changed lines
> Changed lines