--- IO-AIO/README 2018/08/25 19:59:18 1.62 +++ IO-AIO/README 2019/03/04 10:28:38 1.63 @@ -1018,10 +1018,13 @@ aio_mlockall $flags, $callback->($status) Calls the "mlockall" function with the given $flags (a combination - of "IO::AIO::MCL_CURRENT" and "IO::AIO::MCL_FUTURE"). + of "IO::AIO::MCL_CURRENT", "IO::AIO::MCL_FUTURE" and + "IO::AIO::MCL_ONFAULT"). On systems that do not implement "mlockall", this function returns - -1 and sets errno to "ENOSYS". + -1 and sets errno to "ENOSYS". Similarly, flag combinations not + supported by the system result in a return value of -1 with errno + being set to "EINVAL". Note that the corresponding "munlockall" is synchronous and is documented under "MISCELLANEOUS FUNCTIONS". @@ -1666,11 +1669,11 @@ maybe more in future versions). $counter = IO::AIO::st_gen - Returns the generation counter of the file. This is only available - on platforms which have this member in their "struct stat" (most - BSDs at the time of this writing) and generally only to the root - usert. If unsupported, 0 is returned, but this might change to - "undef" in a future version. + Returns the generation counter (in practice this is just a random + number) of the file. This is only available on platforms which have + this member in their "struct stat" (most BSDs at the time of this + writing) and generally only to the root usert. If unsupported, 0 is + returned, but this might change to "undef" in a future version. Example: print the high resolution modification time of /etc, using "stat", and "IO::AIO::aio_stat". @@ -1853,6 +1856,10 @@ On systems where this call is not supported or is not emulated, this call returns falls and sets $! to "ENOSYS". + IO::AIO::mlockall $flags + Calls the "eio_mlockall_sync" function, which is like + "aio_mlockall", but is blocking. + IO::AIO::munlock $scalar, $offset = 0, $length = undef Calls the "munlock" function, undoing the effects of a previous "aio_mlock" call (see its description for details).