[ViewVC] Diff of: cvs/IO-AIO/AIO.pm

Comparing IO-AIO/AIO.pm (file contents):
Revision 1.284 by root, Fri Mar 23 01:14:08 2018 UTC vs.
Revision 1.317 by root, Sun Sep 25 16:30:50 2022 UTC

…		…
171	use common::sense;	171	use common::sense;
172		172
173	use base 'Exporter';	173	use base 'Exporter';
174		174
175	BEGIN {	175	BEGIN {
176	our $VERSION = 4.4;	176	our $VERSION = 4.79;
177		177
178	our @AIO_REQ = qw(aio_sendfile aio_seek aio_read aio_write aio_open aio_close	178	our @AIO_REQ = qw(aio_sendfile aio_seek aio_read aio_write aio_open aio_close
179	aio_stat aio_lstat aio_unlink aio_rmdir aio_readdir aio_readdirx	179	aio_stat aio_lstat aio_unlink aio_rmdir aio_readdir aio_readdirx
180	aio_scandir aio_symlink aio_readlink aio_realpath aio_fcntl aio_ioctl	180	aio_scandir aio_symlink aio_readlink aio_realpath aio_fcntl aio_ioctl
181	aio_sync aio_fsync aio_syncfs aio_fdatasync aio_sync_file_range	181	aio_sync aio_fsync aio_syncfs aio_fdatasync aio_sync_file_range
…		…
192	our @EXPORT_OK = qw(poll_fileno poll_cb poll_wait flush	192	our @EXPORT_OK = qw(poll_fileno poll_cb poll_wait flush
193	min_parallel max_parallel max_idle idle_timeout	193	min_parallel max_parallel max_idle idle_timeout
194	nreqs nready npending nthreads	194	nreqs nready npending nthreads
195	max_poll_time max_poll_reqs	195	max_poll_time max_poll_reqs
196	sendfile fadvise madvise	196	sendfile fadvise madvise
197	mmap munmap munlock munlockall);	197	mmap munmap mremap munlock munlockall
		198
		199	accept4 tee splice pipe2 pipesize
		200	fexecve mount umount memfd_create eventfd
		201	timerfd_create timerfd_settime timerfd_gettime
		202	pidfd_open pidfd_send_signal pidfd_getfd);
198		203
199	push @AIO_REQ, qw(aio_busy); # not exported	204	push @AIO_REQ, qw(aio_busy); # not exported
200		205
201	@IO::AIO::GRP::ISA = 'IO::AIO::REQ';	206	@IO::AIO::GRP::ISA = 'IO::AIO::REQ';
202		207
…		…
278	IO::AIO::idle_timeout $seconds	283	IO::AIO::idle_timeout $seconds
279	IO::AIO::max_outstanding $maxreqs	284	IO::AIO::max_outstanding $maxreqs
280	IO::AIO::nreqs	285	IO::AIO::nreqs
281	IO::AIO::nready	286	IO::AIO::nready
282	IO::AIO::npending	287	IO::AIO::npending
		288	IO::AIO::reinit
		289
283	$nfd = IO::AIO::get_fdlimit [EXPERIMENTAL]	290	$nfd = IO::AIO::get_fdlimit
284	IO::AIO::min_fdlimit $nfd [EXPERIMENTAL]	291	IO::AIO::min_fdlimit $nfd
285		292
286	IO::AIO::sendfile $ofh, $ifh, $offset, $count	293	IO::AIO::sendfile $ofh, $ifh, $offset, $count
287	IO::AIO::fadvise $fh, $offset, $len, $advice	294	IO::AIO::fadvise $fh, $offset, $len, $advice
		295	IO::AIO::fexecve $fh, $argv, $envp
		296
288	IO::AIO::mmap $scalar, $length, $prot, $flags[, $fh[, $offset]]	297	IO::AIO::mmap $scalar, $length, $prot, $flags[, $fh[, $offset]]
289	IO::AIO::munmap $scalar	298	IO::AIO::munmap $scalar
		299	IO::AIO::mremap $scalar, $new_length, $flags[, $new_address]
290	IO::AIO::madvise $scalar, $offset, $length, $advice	300	IO::AIO::madvise $scalar, $offset, $length, $advice
291	IO::AIO::mprotect $scalar, $offset, $length, $protect	301	IO::AIO::mprotect $scalar, $offset, $length, $protect
292	IO::AIO::munlock $scalar, $offset = 0, $length = undef	302	IO::AIO::munlock $scalar, $offset = 0, $length = undef
293	IO::AIO::munlockall	303	IO::AIO::munlockall
		304
		305	# stat extensions
		306	$counter = IO::AIO::st_gen
		307	$seconds = IO::AIO::st_atime, IO::AIO::st_mtime, IO::AIO::st_ctime, IO::AIO::st_btime
		308	($atime, $mtime, $ctime, $btime, ...) = IO::AIO::st_xtime
		309	$nanoseconds = IO::AIO::st_atimensec, IO::AIO::st_mtimensec, IO::AIO::st_ctimensec, IO::AIO::st_btimensec
		310	$seconds = IO::AIO::st_btimesec
		311	($atime, $mtime, $ctime, $btime, ...) = IO::AIO::st_xtimensec
		312
		313	# very much unportable syscalls
		314	IO::AIO::accept4 $r_fh, $sockaddr, $sockaddr_len, $flags
		315	IO::AIO::splice $r_fh, $r_off, $w_fh, $w_off, $length, $flags
		316	IO::AIO::tee $r_fh, $w_fh, $length, $flags
		317
		318	$actual_size = IO::AIO::pipesize $r_fh[, $new_size]
		319	($rfh, $wfh) = IO::AIO::pipe2 [$flags]
		320
		321	$fh = IO::AIO::eventfd [$initval, [$flags]]
		322	$fh = IO::AIO::memfd_create $pathname[, $flags]
		323
		324	$fh = IO::AIO::timerfd_create $clockid[, $flags]
		325	($cur_interval, $cur_value) = IO::AIO::timerfd_settime $fh, $flags, $new_interval, $nbw_value
		326	($cur_interval, $cur_value) = IO::AIO::timerfd_gettime $fh
		327
		328	$fh = IO::AIO::pidfd_open $pid[, $flags]
		329	$status = IO::AIO::pidfd_send_signal $pidfh, $signal[, $siginfo[, $flags]]
		330	$fh = IO::AIO::pidfd_getfd $pidfh, $targetfd[, $flags]
		331
		332	$retval = IO::AIO::mount $special, $path, $fstype, $flags = 0, $data = undef
		333	$retval = IO::AIO::umount $path, $flags = 0
294		334
295	=head2 API NOTES	335	=head2 API NOTES
296		336
297	All the C<aio_*> calls are more or less thin wrappers around the syscall	337	All the C<aio_*> calls are more or less thin wrappers around the syscall
298	with the same name (sans C<aio_>). The arguments are similar or identical,	338	with the same name (sans C<aio_>). The arguments are similar or identical,
…		…
404	following POSIX and non-POSIX constants are available (missing ones on	444	following POSIX and non-POSIX constants are available (missing ones on
405	your system are, as usual, C<0>):	445	your system are, as usual, C<0>):
406		446
407	C<O_ASYNC>, C<O_DIRECT>, C<O_NOATIME>, C<O_CLOEXEC>, C<O_NOCTTY>, C<O_NOFOLLOW>,	447	C<O_ASYNC>, C<O_DIRECT>, C<O_NOATIME>, C<O_CLOEXEC>, C<O_NOCTTY>, C<O_NOFOLLOW>,
408	C<O_NONBLOCK>, C<O_EXEC>, C<O_SEARCH>, C<O_DIRECTORY>, C<O_DSYNC>,	448	C<O_NONBLOCK>, C<O_EXEC>, C<O_SEARCH>, C<O_DIRECTORY>, C<O_DSYNC>,
409	C<O_RSYNC>, C<O_SYNC>, C<O_PATH>, C<O_TMPFILE>, and C<O_TTY_INIT>.	449	C<O_RSYNC>, C<O_SYNC>, C<O_PATH>, C<O_TMPFILE>, C<O_TTY_INIT> and C<O_ACCMODE>.
410		450
411		451
412	=item aio_close $fh, $callback->($status)	452	=item aio_close $fh, $callback->($status)
413		453
414	Asynchronously close a file and call the callback with the result	454	Asynchronously close a file and call the callback with the result
…		…
540		580
541	=item aio_stat $fh_or_path, $callback->($status)	581	=item aio_stat $fh_or_path, $callback->($status)
542		582
543	=item aio_lstat $fh, $callback->($status)	583	=item aio_lstat $fh, $callback->($status)
544		584
545	Works like perl's C<stat> or C<lstat> in void context. The callback will	585	Works almost exactly like perl's C<stat> or C<lstat> in void context. The
546	be called after the stat and the results will be available using C<stat _>	586	callback will be called after the stat and the results will be available
547	or C<-s _> etc...	587	using C<stat _> or C<-s _> and other tests (with the exception of C<-B>
		588	and C<-T>).
548		589
549	The pathname passed to C<aio_stat> must be absolute. See API NOTES, above,	590	The pathname passed to C<aio_stat> must be absolute. See API NOTES, above,
550	for an explanation.	591	for an explanation.
551		592
552	Currently, the stats are always 64-bit-stats, i.e. instead of returning an	593	Currently, the stats are always 64-bit-stats, i.e. instead of returning an
…		…
559	behaviour).	600	behaviour).
560		601
561	C<S_IFMT>, C<S_IFIFO>, C<S_IFCHR>, C<S_IFBLK>, C<S_IFLNK>, C<S_IFREG>,	602	C<S_IFMT>, C<S_IFIFO>, C<S_IFCHR>, C<S_IFBLK>, C<S_IFLNK>, C<S_IFREG>,
562	C<S_IFDIR>, C<S_IFWHT>, C<S_IFSOCK>, C<IO::AIO::major $dev_t>,	603	C<S_IFDIR>, C<S_IFWHT>, C<S_IFSOCK>, C<IO::AIO::major $dev_t>,
563	C<IO::AIO::minor $dev_t>, C<IO::AIO::makedev $major, $minor>.	604	C<IO::AIO::minor $dev_t>, C<IO::AIO::makedev $major, $minor>.
		605
		606	To access higher resolution stat timestamps, see L<SUBSECOND STAT TIME
		607	ACCESS>.
564		608
565	Example: Print the length of F</etc/passwd>:	609	Example: Print the length of F</etc/passwd>:
566		610
567	aio_stat "/etc/passwd", sub {	611	aio_stat "/etc/passwd", sub {
568	$_[0] and die "stat failed: $!";	612	$_[0] and die "stat failed: $!";
…		…
618		662
619	Works like perl's C<utime> function (including the special case of $atime	663	Works like perl's C<utime> function (including the special case of $atime
620	and $mtime being undef). Fractional times are supported if the underlying	664	and $mtime being undef). Fractional times are supported if the underlying
621	syscalls support them.	665	syscalls support them.
622		666
623	When called with a pathname, uses utimes(2) if available, otherwise	667	When called with a pathname, uses utimensat(2) or utimes(2) if available,
624	utime(2). If called on a file descriptor, uses futimes(2) if available,	668	otherwise utime(2). If called on a file descriptor, uses futimens(2)
625	otherwise returns ENOSYS, so this is not portable.	669	or futimes(2) if available, otherwise returns ENOSYS, so this is not
		670	portable.
626		671
627	Examples:	672	Examples:
628		673
629	# set atime and mtime to current time (basically touch(1)):	674	# set atime and mtime to current time (basically touch(1)):
630	aio_utime "path", undef, undef;	675	aio_utime "path", undef, undef;
…		…
1103	aioreq_pri $pri;	1148	aioreq_pri $pri;
1104	add $grp aio_stat $wd, sub {	1149	add $grp aio_stat $wd, sub {
1105	return $grp->result () if $_[0];	1150	return $grp->result () if $_[0];
1106	my $now = time;	1151	my $now = time;
1107	my $hash1 = join ":", (stat _)[0,1,3,7,9];	1152	my $hash1 = join ":", (stat _)[0,1,3,7,9];
		1153	my $rdxflags = READDIR_DIRS_FIRST;
		1154
		1155	if ((stat _)[3] < 2) {
		1156	# at least one non-POSIX filesystem exists
		1157	# that returns useful DT_type values: btrfs,
		1158	# so optimise for this here by requesting dents
		1159	$rdxflags \|= READDIR_DENTS;
		1160	}
1108		1161
1109	# read the directory entries	1162	# read the directory entries
1110	aioreq_pri $pri;	1163	aioreq_pri $pri;
1111	add $grp aio_readdirx $wd, READDIR_DIRS_FIRST, sub {	1164	add $grp aio_readdirx $wd, $rdxflags, sub {
1112	my $entries = shift	1165	my ($entries, $flags) = @_
1113	or return $grp->result ();	1166	or return $grp->result ();
		1167
		1168	if ($rdxflags & READDIR_DENTS) {
		1169	# if we requested type values, see if we can use them directly.
		1170
		1171	# if there were any DT_UNKNOWN entries then we assume we
		1172	# don't know. alternatively, we could assume that if we get
		1173	# one DT_DIR, then all directories are indeed marked with
		1174	# DT_DIR, but this seems not required for btrfs, and this
		1175	# is basically the "btrfs can't get it's act together" code
		1176	# branch.
		1177	unless ($flags & READDIR_FOUND_UNKNOWN) {
		1178	# now we have valid DT_ information for all entries,
		1179	# so use it as an optimisation without further stat's.
		1180	# they must also all be at the beginning of @$entries
		1181	# by now.
		1182
		1183	my $dirs;
		1184
		1185	if (@$entries) {
		1186	for (0 .. $#$entries) {
		1187	if ($entries->[$_][1] != DT_DIR) {
		1188	# splice out directories
		1189	$dirs = [splice @$entries, 0, $_];
		1190	last;
		1191	}
		1192	}
		1193
		1194	# if we didn't find any non-dir, then all entries are dirs
		1195	unless ($dirs) {
		1196	($dirs, $entries) = ($entries, []);
		1197	}
		1198	} else {
		1199	# directory is empty, so there are no sbdirs
		1200	$dirs = [];
		1201	}
		1202
		1203	# either splice'd the directories out or the dir was empty.
		1204	# convert dents to filenames
		1205	$_ = $_->[0] for @$dirs;
		1206	$_ = $_->[0] for @$entries;
		1207
		1208	return $grp->result ($dirs, $entries);
		1209	}
		1210
		1211	# cannot use, so return to our old ways
		1212	# by pretending we only scanned for names.
		1213	$_ = $_->[0] for @$entries;
		1214	}
1114		1215
1115	# stat the dir another time	1216	# stat the dir another time
1116	aioreq_pri $pri;	1217	aioreq_pri $pri;
1117	add $grp aio_stat $wd, sub {	1218	add $grp aio_stat $wd, sub {
1118	my $hash2 = join ":", (stat _)[0,1,3,7,9];	1219	my $hash2 = join ":", (stat _)[0,1,3,7,9];
…		…
1224	So in general, you should only use these calls for things that do	1325	So in general, you should only use these calls for things that do
1225	(filesystem) I/O, not for things that wait for other events (network,	1326	(filesystem) I/O, not for things that wait for other events (network,
1226	other processes), although if you are careful and know what you are doing,	1327	other processes), although if you are careful and know what you are doing,
1227	you still can.	1328	you still can.
1228		1329
1229	The following constants are available (missing ones are, as usual C<0>):	1330	The following constants are available and can be used for normal C<ioctl>
		1331	and C<fcntl> as well (missing ones are, as usual C<0>):
1230		1332
1231	C<F_DUPFD_CLOEXEC>,	1333	C<F_DUPFD_CLOEXEC>,
1232		1334
1233	C<F_OFD_GETLK>, C<F_OFD_SETLK>, C<F_OFD_GETLKW>,	1335	C<F_OFD_GETLK>, C<F_OFD_SETLK>, C<F_OFD_GETLKW>,
1234		1336
1235	C<FIFREEZE>, C<FITHAW>, C<FITRIM>, C<FICLONE>, C<FICLONERANGE>, C<FIDEDUPERANGE>.	1337	C<FIFREEZE>, C<FITHAW>, C<FITRIM>, C<FICLONE>, C<FICLONERANGE>, C<FIDEDUPERANGE>.
		1338
		1339	C<F_ADD_SEALS>, C<F_GET_SEALS>, C<F_SEAL_SEAL>, C<F_SEAL_SHRINK>, C<F_SEAL_GROW> and
		1340	C<F_SEAL_WRITE>.
1236		1341
1237	C<FS_IOC_GETFLAGS>, C<FS_IOC_SETFLAGS>, C<FS_IOC_GETVERSION>, C<FS_IOC_SETVERSION>,	1342	C<FS_IOC_GETFLAGS>, C<FS_IOC_SETFLAGS>, C<FS_IOC_GETVERSION>, C<FS_IOC_SETVERSION>,
1238	C<FS_IOC_FIEMAP>.	1343	C<FS_IOC_FIEMAP>.
1239		1344
1240	C<FS_IOC_FSGETXATTR>, C<FS_IOC_FSSETXATTR>, C<FS_IOC_SET_ENCRYPTION_POLICY>,	1345	C<FS_IOC_FSGETXATTR>, C<FS_IOC_FSSETXATTR>, C<FS_IOC_SET_ENCRYPTION_POLICY>,
…		…
1248		1353
1249	C<FS_XFLAG_REALTIME>, C<FS_XFLAG_PREALLOC>, C<FS_XFLAG_IMMUTABLE>, C<FS_XFLAG_APPEND>,	1354	C<FS_XFLAG_REALTIME>, C<FS_XFLAG_PREALLOC>, C<FS_XFLAG_IMMUTABLE>, C<FS_XFLAG_APPEND>,
1250	C<FS_XFLAG_SYNC>, C<FS_XFLAG_NOATIME>, C<FS_XFLAG_NODUMP>, C<FS_XFLAG_RTINHERIT>,	1355	C<FS_XFLAG_SYNC>, C<FS_XFLAG_NOATIME>, C<FS_XFLAG_NODUMP>, C<FS_XFLAG_RTINHERIT>,
1251	C<FS_XFLAG_PROJINHERIT>, C<FS_XFLAG_NOSYMLINKS>, C<FS_XFLAG_EXTSIZE>, C<FS_XFLAG_EXTSZINHERIT>,	1356	C<FS_XFLAG_PROJINHERIT>, C<FS_XFLAG_NOSYMLINKS>, C<FS_XFLAG_EXTSIZE>, C<FS_XFLAG_EXTSZINHERIT>,
1252	C<FS_XFLAG_NODEFRAG>, C<FS_XFLAG_FILESTREAM>, C<FS_XFLAG_DAX>, C<FS_XFLAG_HASATTR>,	1357	C<FS_XFLAG_NODEFRAG>, C<FS_XFLAG_FILESTREAM>, C<FS_XFLAG_DAX>, C<FS_XFLAG_HASATTR>,
		1358
		1359	C<BLKROSET>, C<BLKROGET>, C<BLKRRPART>, C<BLKGETSIZE>, C<BLKFLSBUF>, C<BLKRASET>,
		1360	C<BLKRAGET>, C<BLKFRASET>, C<BLKFRAGET>, C<BLKSECTSET>, C<BLKSECTGET>, C<BLKSSZGET>,
		1361	C<BLKBSZGET>, C<BLKBSZSET>, C<BLKGETSIZE64>,
		1362
1253		1363
1254	=item aio_sync $callback->($status)	1364	=item aio_sync $callback->($status)
1255		1365
1256	Asynchronously call sync and call the callback when finished.	1366	Asynchronously call sync and call the callback when finished.
1257		1367
…		…
1379	IO::AIO::mmap $data, -s $fh, IO::AIO::PROT_READ, IO::AIO::MAP_SHARED, $fh;	1489	IO::AIO::mmap $data, -s $fh, IO::AIO::PROT_READ, IO::AIO::MAP_SHARED, $fh;
1380	aio_mlock $data; # mlock in background	1490	aio_mlock $data; # mlock in background
1381		1491
1382	=item aio_mlockall $flags, $callback->($status)	1492	=item aio_mlockall $flags, $callback->($status)
1383		1493
1384	Calls the C<mlockall> function with the given C<$flags> (a combination of	1494	Calls the C<mlockall> function with the given C<$flags> (a
1385	C<IO::AIO::MCL_CURRENT> and C<IO::AIO::MCL_FUTURE>).	1495	combination of C<IO::AIO::MCL_CURRENT>, C<IO::AIO::MCL_FUTURE> and
		1496	C<IO::AIO::MCL_ONFAULT>).
1386		1497
1387	On systems that do not implement C<mlockall>, this function returns C<-1>	1498	On systems that do not implement C<mlockall>, this function returns C<-1>
1388	and sets errno to C<ENOSYS>.	1499	and sets errno to C<ENOSYS>. Similarly, flag combinations not supported
		1500	by the system result in a return value of C<-1> with errno being set to
		1501	C<EINVAL>.
1389		1502
1390	Note that the corresponding C<munlockall> is synchronous and is	1503	Note that the corresponding C<munlockall> is synchronous and is
1391	documented under L<MISCELLANEOUS FUNCTIONS>.	1504	documented under L<MISCELLANEOUS FUNCTIONS>.
1392		1505
1393	Example: asynchronously lock all current and future pages into memory.	1506	Example: asynchronously lock all current and future pages into memory.
…		…
1587	C<aio_wd> callback, as future requests using the value will fail in the	1700	C<aio_wd> callback, as future requests using the value will fail in the
1588	expected way.	1701	expected way.
1589		1702
1590	=item IO::AIO::CWD	1703	=item IO::AIO::CWD
1591		1704
1592	This is a compiletime constant (object) that represents the process	1705	This is a compile time constant (object) that represents the process
1593	current working directory.	1706	current working directory.
1594		1707
1595	Specifying this object as working directory object for a pathname is as if	1708	Specifying this object as working directory object for a pathname is as if
1596	the pathname would be specified directly, without a directory object. For	1709	the pathname would be specified directly, without a directory object. For
1597	example, these calls are functionally identical:	1710	example, these calls are functionally identical:
…		…
1778	The default value for the limit is C<0>, but note that setting a feeder	1891	The default value for the limit is C<0>, but note that setting a feeder
1779	automatically bumps it up to C<2>.	1892	automatically bumps it up to C<2>.
1780		1893
1781	=back	1894	=back
1782		1895
		1896
1783	=head2 SUPPORT FUNCTIONS	1897	=head2 SUPPORT FUNCTIONS
1784		1898
1785	=head3 EVENT PROCESSING AND EVENT LOOP INTEGRATION	1899	=head3 EVENT PROCESSING AND EVENT LOOP INTEGRATION
1786		1900
1787	=over 4	1901	=over 4
…		…
1852	Strictly equivalent to:	1966	Strictly equivalent to:
1853		1967
1854	IO::AIO::poll_wait, IO::AIO::poll_cb	1968	IO::AIO::poll_wait, IO::AIO::poll_cb
1855	while IO::AIO::nreqs;	1969	while IO::AIO::nreqs;
1856		1970
		1971	This function can be useful at program aborts, to make sure outstanding
		1972	I/O has been done (C<IO::AIO> uses an C<END> block which already calls
		1973	this function on normal exits), or when you are merely using C<IO::AIO>
		1974	for its more advanced functions, rather than for async I/O, e.g.:
		1975
		1976	my ($dirs, $nondirs);
		1977	IO::AIO::aio_scandir "/tmp", 0, sub { ($dirs, $nondirs) = @_ };
		1978	IO::AIO::flush;
		1979	# $dirs, $nondirs are now set
		1980
1857	=item IO::AIO::max_poll_reqs $nreqs	1981	=item IO::AIO::max_poll_reqs $nreqs
1858		1982
1859	=item IO::AIO::max_poll_time $seconds	1983	=item IO::AIO::max_poll_time $seconds
1860		1984
1861	These set the maximum number of requests (default C<0>, meaning infinity)	1985	These set the maximum number of requests (default C<0>, meaning infinity)
…		…
1887	poll => 'r', nice => 1,	2011	poll => 'r', nice => 1,
1888	cb => &IO::AIO::poll_cb);	2012	cb => &IO::AIO::poll_cb);
1889		2013
1890	=back	2014	=back
1891		2015
		2016
1892	=head3 CONTROLLING THE NUMBER OF THREADS	2017	=head3 CONTROLLING THE NUMBER OF THREADS
1893		2018
1894	=over	2019	=over
1895		2020
1896	=item IO::AIO::min_parallel $nthreads	2021	=item IO::AIO::min_parallel $nthreads
…		…
1957	longer exceeded.	2082	longer exceeded.
1958		2083
1959	In other words, this setting does not enforce a queue limit, but can be	2084	In other words, this setting does not enforce a queue limit, but can be
1960	used to make poll functions block if the limit is exceeded.	2085	used to make poll functions block if the limit is exceeded.
1961		2086
1962	This is a very bad function to use in interactive programs because it	2087	This is a bad function to use in interactive programs because it blocks,
1963	blocks, and a bad way to reduce concurrency because it is inexact: Better	2088	and a bad way to reduce concurrency because it is inexact. If you need to
		2089	issue many requests without being able to call a poll function on demand,
1964	use an C<aio_group> together with a feed callback.	2090	it is better to use an C<aio_group> together with a feed callback.
1965		2091
1966	Its main use is in scripts without an event loop - when you want to stat	2092	Its main use is in scripts without an event loop - when you want to stat a
1967	a lot of files, you can write something like this:	2093	lot of files, you can write something like this:
1968		2094
1969	IO::AIO::max_outstanding 32;	2095	IO::AIO::max_outstanding 32;
1970		2096
1971	for my $path (...) {	2097	for my $path (...) {
1972	aio_stat $path , ...;	2098	aio_stat $path , ...;
1973	IO::AIO::poll_cb;	2099	IO::AIO::poll_cb;
1974	}	2100	}
1975		2101
1976	IO::AIO::flush;	2102	IO::AIO::flush;
1977		2103
1978	The call to C<poll_cb> inside the loop will normally return instantly, but	2104	The call to C<poll_cb> inside the loop will normally return instantly,
1979	as soon as more thna C<32> reqeusts are in-flight, it will block until	2105	allowing the loop to progress, but as soon as more than C<32> requests
1980	some requests have been handled. This keeps the loop from pushing a large	2106	are in-flight, it will block until some requests have been handled. This
1981	number of C<aio_stat> requests onto the queue.	2107	keeps the loop from pushing a large number of C<aio_stat> requests onto
		2108	the queue (which, with many paths to stat, can use up a lot of memory).
1982		2109
1983	The default value for C<max_outstanding> is very large, so there is no	2110	The default value for C<max_outstanding> is very large, so there is no
1984	practical limit on the number of outstanding requests.	2111	practical limit on the number of outstanding requests.
1985		2112
1986	=back	2113	=back
1987		2114
		2115
1988	=head3 STATISTICAL INFORMATION	2116	=head3 STATISTICAL INFORMATION
1989		2117
1990	=over	2118	=over
1991		2119
1992	=item IO::AIO::nreqs	2120	=item IO::AIO::nreqs
…		…
2008		2136
2009	Returns the number of requests currently in the pending state (executed,	2137	Returns the number of requests currently in the pending state (executed,
2010	but not yet processed by poll_cb).	2138	but not yet processed by poll_cb).
2011		2139
2012	=back	2140	=back
		2141
		2142
		2143	=head3 SUBSECOND STAT TIME ACCESS
		2144
		2145	Both C<aio_stat>/C<aio_lstat> and perl's C<stat>/C<lstat> functions can
		2146	generally find access/modification and change times with subsecond time
		2147	accuracy of the system supports it, but perl's built-in functions only
		2148	return the integer part.
		2149
		2150	The following functions return the timestamps of the most recent
		2151	stat with subsecond precision on most systems and work both after
		2152	C<aio_stat>/C<aio_lstat> and perl's C<stat>/C<lstat> calls. Their return
		2153	value is only meaningful after a successful C<stat>/C<lstat> call, or
		2154	during/after a successful C<aio_stat>/C<aio_lstat> callback.
		2155
		2156	This is similar to the L<Time::HiRes> C<stat> functions, but can return
		2157	full resolution without rounding and work with standard perl C<stat>,
		2158	alleviating the need to call the special C<Time::HiRes> functions, which
		2159	do not act like their perl counterparts.
		2160
		2161	On operating systems or file systems where subsecond time resolution is
		2162	not supported or could not be detected, a fractional part of C<0> is
		2163	returned, so it is always safe to call these functions.
		2164
		2165	=over 4
		2166
		2167	=item $seconds = IO::AIO::st_atime, IO::AIO::st_mtime, IO::AIO::st_ctime, IO::AIO::st_btime
		2168
		2169	Return the access, modication, change or birth time, respectively,
		2170	including fractional part. Due to the limited precision of floating point,
		2171	the accuracy on most platforms is only a bit better than milliseconds
		2172	for times around now - see the I<nsec> function family, below, for full
		2173	accuracy.
		2174
		2175	File birth time is only available when the OS and perl support it (on
		2176	FreeBSD and NetBSD at the time of this writing, although support is
		2177	adaptive, so if your OS/perl gains support, IO::AIO can take advantage of
		2178	it). On systems where it isn't available, C<0> is currently returned, but
		2179	this might change to C<undef> in a future version.
		2180
		2181	=item ($atime, $mtime, $ctime, $btime, ...) = IO::AIO::st_xtime
		2182
		2183	Returns access, modification, change and birth time all in one go, and
		2184	maybe more times in the future version.
		2185
		2186	=item $nanoseconds = IO::AIO::st_atimensec, IO::AIO::st_mtimensec, IO::AIO::st_ctimensec, IO::AIO::st_btimensec
		2187
		2188	Return the fractional access, modifcation, change or birth time, in nanoseconds,
		2189	as an integer in the range C<0> to C<999999999>.
		2190
		2191	Note that no accessors are provided for access, modification and
		2192	change times - you need to get those from C<stat _> if required (C<int
		2193	IO::AIO::st_atime> and so on will I<not> generally give you the correct
		2194	value).
		2195
		2196	=item $seconds = IO::AIO::st_btimesec
		2197
		2198	The (integral) seconds part of the file birth time, if available.
		2199
		2200	=item ($atime, $mtime, $ctime, $btime, ...) = IO::AIO::st_xtimensec
		2201
		2202	Like the functions above, but returns all four times in one go (and maybe
		2203	more in future versions).
		2204
		2205	=item $counter = IO::AIO::st_gen
		2206
		2207	Returns the generation counter (in practice this is just a random number)
		2208	of the file. This is only available on platforms which have this member in
		2209	their C<struct stat> (most BSDs at the time of this writing) and generally
		2210	only to the root usert. If unsupported, C<0> is returned, but this might
		2211	change to C<undef> in a future version.
		2212
		2213	=back
		2214
		2215	Example: print the high resolution modification time of F</etc>, using
		2216	C<stat>, and C<IO::AIO::aio_stat>.
		2217
		2218	if (stat "/etc") {
		2219	printf "stat(/etc) mtime: %f\n", IO::AIO::st_mtime;
		2220	}
		2221
		2222	IO::AIO::aio_stat "/etc", sub {
		2223	$_[0]
		2224	and return;
		2225
		2226	printf "aio_stat(/etc) mtime: %d.%09d\n", (stat _)[9], IO::AIO::st_mtimensec;
		2227	};
		2228
		2229	IO::AIO::flush;
		2230
		2231	Output of the awbove on my system, showing reduced and full accuracy:
		2232
		2233	stat(/etc) mtime: 1534043702.020808
		2234	aio_stat(/etc) mtime: 1534043702.020807792
		2235
2013		2236
2014	=head3 MISCELLANEOUS FUNCTIONS	2237	=head3 MISCELLANEOUS FUNCTIONS
2015		2238
2016	IO::AIO implements some functions that are useful when you want to use	2239	IO::AIO implements some functions that are useful when you want to use
2017	some "Advanced I/O" function not available to in Perl, without going the	2240	some "Advanced I/O" function not available to in Perl, without going the
2018	"Asynchronous I/O" route. Many of these have an asynchronous C<aio_*>	2241	"Asynchronous I/O" route. Many of these have an asynchronous C<aio_*>
2019	counterpart.	2242	counterpart.
2020		2243
2021	=over 4	2244	=over 4
2022		2245
		2246	=item $retval = IO::AIO::fexecve $fh, $argv, $envp
		2247
		2248	A more-or-less direct equivalent to the POSIX C<fexecve> functions, which
		2249	allows you to specify the program to be executed via a file descriptor (or
		2250	handle). Returns C<-1> and sets errno to C<ENOSYS> if not available.
		2251
		2252	=item $retval = IO::AIO::mount $special, $path, $fstype, $flags = 0, $data = undef
		2253
		2254	Calls the GNU/Linux mount syscall with the given arguments. All except
		2255	C<$flags> are strings, and if C<$data> is C<undef>, a C<NULL> will be
		2256	passed.
		2257
		2258	The following values for C<$flags> are available:
		2259
		2260	C<IO::AIO::MS_RDONLY>, C<IO::AIO::MS_NOSUID>, C<IO::AIO::MS_NODEV>, C<IO::AIO::MS_NOEXEC>, C<IO::AIO::MS_SYNCHRONOUS>,
		2261	C<IO::AIO::MS_REMOUNT>, C<IO::AIO::MS_MANDLOCK>, C<IO::AIO::MS_DIRSYNC>, C<IO::AIO::MS_NOATIME>,
		2262	C<IO::AIO::MS_NODIRATIME>, C<IO::AIO::MS_BIND>, C<IO::AIO::MS_MOVE>, C<IO::AIO::MS_REC>, C<IO::AIO::MS_SILENT>,
		2263	C<IO::AIO::MS_POSIXACL>, C<IO::AIO::MS_UNBINDABLE>, C<IO::AIO::MS_PRIVATE>, C<IO::AIO::MS_SLAVE>, C<IO::AIO::MS_SHARED>,
		2264	C<IO::AIO::MS_RELATIME>, C<IO::AIO::MS_KERNMOUNT>, C<IO::AIO::MS_I_VERSION>, C<IO::AIO::MS_STRICTATIME>,
		2265	C<IO::AIO::MS_LAZYTIME>, C<IO::AIO::MS_ACTIVE>, C<IO::AIO::MS_NOUSER>, C<IO::AIO::MS_RMT_MASK>, C<IO::AIO::MS_MGC_VAL> and
		2266	C<IO::AIO::MS_MGC_MSK>.
		2267
		2268	=item $retval = IO::AIO::umount $path, $flags = 0
		2269
		2270	Invokes the GNU/Linux C<umount> or C<umount2> syscalls. Always calls
		2271	C<umount> if C<$flags> is C<0>, otherwqise always tries to call
		2272	C<umount2>.
		2273
		2274	The following C<$flags> are available:
		2275
		2276	C<IO::AIO::MNT_FORCE>, C<IO::AIO::MNT_DETACH>, C<IO::AIO::MNT_EXPIRE> and C<IO::AIO::UMOUNT_NOFOLLOW>.
		2277
2023	=item $numfd = IO::AIO::get_fdlimit	2278	=item $numfd = IO::AIO::get_fdlimit
2024
2025	This function is I<EXPERIMENTAL> and subject to change.
2026		2279
2027	Tries to find the current file descriptor limit and returns it, or	2280	Tries to find the current file descriptor limit and returns it, or
2028	C<undef> and sets C<$!> in case of an error. The limit is one larger than	2281	C<undef> and sets C<$!> in case of an error. The limit is one larger than
2029	the highest valid file descriptor number.	2282	the highest valid file descriptor number.
2030		2283
2031	=item IO::AIO::min_fdlimit [$numfd]	2284	=item IO::AIO::min_fdlimit [$numfd]
2032
2033	This function is I<EXPERIMENTAL> and subject to change.
2034		2285
2035	Try to increase the current file descriptor limit(s) to at least C<$numfd>	2286	Try to increase the current file descriptor limit(s) to at least C<$numfd>
2036	by changing the soft or hard file descriptor resource limit. If C<$numfd>	2287	by changing the soft or hard file descriptor resource limit. If C<$numfd>
2037	is missing, it will try to set a very high limit, although this is not	2288	is missing, it will try to set a very high limit, although this is not
2038	recommended when you know the actual minimum that you require.	2289	recommended when you know the actual minimum that you require.
…		…
2133	C<IO::AIO::MAP_POPULATE>,	2384	C<IO::AIO::MAP_POPULATE>,
2134	C<IO::AIO::MAP_NONBLOCK>,	2385	C<IO::AIO::MAP_NONBLOCK>,
2135	C<IO::AIO::MAP_FIXED>,	2386	C<IO::AIO::MAP_FIXED>,
2136	C<IO::AIO::MAP_GROWSDOWN>,	2387	C<IO::AIO::MAP_GROWSDOWN>,
2137	C<IO::AIO::MAP_32BIT>,	2388	C<IO::AIO::MAP_32BIT>,
2138	C<IO::AIO::MAP_HUGETLB> or	2389	C<IO::AIO::MAP_HUGETLB>,
2139	C<IO::AIO::MAP_STACK>.	2390	C<IO::AIO::MAP_STACK>,
		2391	C<IO::AIO::MAP_FIXED_NOREPLACE>,
		2392	C<IO::AIO::MAP_SHARED_VALIDATE>,
		2393	C<IO::AIO::MAP_SYNC> or
		2394	C<IO::AIO::MAP_UNINITIALIZED>.
2140		2395
2141	If C<$fh> is C<undef>, then a file descriptor of C<-1> is passed.	2396	If C<$fh> is C<undef>, then a file descriptor of C<-1> is passed.
2142		2397
2143	C<$offset> is the offset from the start of the file - it generally must be	2398	C<$offset> is the offset from the start of the file - it generally must be
2144	a multiple of C<IO::AIO::PAGESIZE> and defaults to C<0>.	2399	a multiple of C<IO::AIO::PAGESIZE> and defaults to C<0>.
…		…
2158		2413
2159	=item IO::AIO::munmap $scalar	2414	=item IO::AIO::munmap $scalar
2160		2415
2161	Removes a previous mmap and undefines the C<$scalar>.	2416	Removes a previous mmap and undefines the C<$scalar>.
2162		2417
		2418	=item IO::AIO::mremap $scalar, $new_length, $flags = MREMAP_MAYMOVE[, $new_address = 0]
		2419
		2420	Calls the Linux-specific mremap(2) system call. The C<$scalar> must have
		2421	been mapped by C<IO::AIO::mmap>, and C<$flags> must currently either be
		2422	C<0> or C<IO::AIO::MREMAP_MAYMOVE>.
		2423
		2424	Returns true if successful, and false otherwise. If the underlying mmapped
		2425	region has changed address, then the true value has the numerical value
		2426	C<1>, otherwise it has the numerical value C<0>:
		2427
		2428	my $success = IO::AIO::mremap $mmapped, 8192, IO::AIO::MREMAP_MAYMOVE
		2429	or die "mremap: $!";
		2430
		2431	if ($success*1) {
		2432	warn "scalar has chanegd address in memory\n";
		2433	}
		2434
		2435	C<IO::AIO::MREMAP_FIXED> and the C<$new_address> argument are currently
		2436	implemented, but not supported and might go away in a future version.
		2437
		2438	On systems where this call is not supported or is not emulated, this call
		2439	returns falls and sets C<$!> to C<ENOSYS>.
		2440
		2441	=item IO::AIO::mlockall $flags
		2442
		2443	Calls the C<eio_mlockall_sync> function, which is like C<aio_mlockall>,
		2444	but is blocking.
		2445
2163	=item IO::AIO::munlock $scalar, $offset = 0, $length = undef	2446	=item IO::AIO::munlock $scalar, $offset = 0, $length = undef
2164		2447
2165	Calls the C<munlock> function, undoing the effects of a previous	2448	Calls the C<munlock> function, undoing the effects of a previous
2166	C<aio_mlock> call (see its description for details).	2449	C<aio_mlock> call (see its description for details).
2167		2450
…		…
2169		2452
2170	Calls the C<munlockall> function.	2453	Calls the C<munlockall> function.
2171		2454
2172	On systems that do not implement C<munlockall>, this function returns	2455	On systems that do not implement C<munlockall>, this function returns
2173	ENOSYS, otherwise the return value of C<munlockall>.	2456	ENOSYS, otherwise the return value of C<munlockall>.
		2457
		2458	=item $fh = IO::AIO::accept4 $r_fh, $sockaddr, $sockaddr_maxlen, $flags
		2459
		2460	Uses the GNU/Linux C<accept4(2)> syscall, if available, to accept a socket
		2461	and return the new file handle on success, or sets C<$!> and returns
		2462	C<undef> on error.
		2463
		2464	The remote name of the new socket will be stored in C<$sockaddr>, which
		2465	will be extended to allow for at least C<$sockaddr_maxlen> octets. If the
		2466	socket name does not fit into C<$sockaddr_maxlen> octets, this is signaled
		2467	by returning a longer string in C<$sockaddr>, which might or might not be
		2468	truncated.
		2469
		2470	To accept name-less sockets, use C<undef> for C<$sockaddr> and C<0> for
		2471	C<$sockaddr_maxlen>.
		2472
		2473	The main reasons to use this syscall rather than portable C<accept(2)>
		2474	are that you can specify C<SOCK_NONBLOCK> and/or C<SOCK_CLOEXEC>
		2475	flags and you can accept name-less sockets by specifying C<0> for
		2476	C<$sockaddr_maxlen>, which is sadly not possible with perl's interface to
		2477	C<accept>.
2174		2478
2175	=item IO::AIO::splice $r_fh, $r_off, $w_fh, $w_off, $length, $flags	2479	=item IO::AIO::splice $r_fh, $r_off, $w_fh, $w_off, $length, $flags
2176		2480
2177	Calls the GNU/Linux C<splice(2)> syscall, if available. If C<$r_off> or	2481	Calls the GNU/Linux C<splice(2)> syscall, if available. If C<$r_off> or
2178	C<$w_off> are C<undef>, then C<NULL> is passed for these, otherwise they	2482	C<$w_off> are C<undef>, then C<NULL> is passed for these, otherwise they
…		…
2222	Example: create a pipe race-free w.r.t. threads and fork:	2526	Example: create a pipe race-free w.r.t. threads and fork:
2223		2527
2224	my ($rfh, $wfh) = IO::AIO::pipe2 IO::AIO::O_CLOEXEC	2528	my ($rfh, $wfh) = IO::AIO::pipe2 IO::AIO::O_CLOEXEC
2225	or die "pipe2: $!\n";	2529	or die "pipe2: $!\n";
2226		2530
		2531	=item $fh = IO::AIO::memfd_create $pathname[, $flags]
		2532
		2533	This is a direct interface to the Linux L<memfd_create(2)> system
		2534	call. The (unhelpful) default for C<$flags> is C<0>, but your default
		2535	should be C<IO::AIO::MFD_CLOEXEC>.
		2536
		2537	On success, the new memfd filehandle is returned, otherwise returns
		2538	C<undef>. If the memfd_create syscall is missing, fails with C<ENOSYS>.
		2539
		2540	Please refer to L<memfd_create(2)> for more info on this call.
		2541
		2542	The following C<$flags> values are available: C<IO::AIO::MFD_CLOEXEC>,
		2543	C<IO::AIO::MFD_ALLOW_SEALING>, C<IO::AIO::MFD_HUGETLB>,
		2544	C<IO::AIO::MFD_HUGETLB_2MB> and C<IO::AIO::MFD_HUGETLB_1GB>.
		2545
		2546	Example: create a new memfd.
		2547
		2548	my $fh = IO::AIO::memfd_create "somenameforprocfd", IO::AIO::MFD_CLOEXEC
		2549	or die "memfd_create: $!\n";
		2550
		2551	=item $fh = IO::AIO::pidfd_open $pid[, $flags]
		2552
		2553	This is an interface to the Linux L<pidfd_open(2)> system call. The
		2554	default for C<$flags> is C<0>.
		2555
		2556	On success, a new pidfd filehandle is returned (that is already set to
		2557	close-on-exec), otherwise returns C<undef>. If the syscall is missing,
		2558	fails with C<ENOSYS>.
		2559
		2560	Example: open pid 6341 as pidfd.
		2561
		2562	my $fh = IO::AIO::pidfd_open 6341
		2563	or die "pidfd_open: $!\n";
		2564
		2565	=item $status = IO::AIO::pidfd_send_signal $pidfh, $signal[, $siginfo[, $flags]]
		2566
		2567	This is an interface to the Linux L<pidfd_send_signal> system call. The
		2568	default for C<$siginfo> is C<undef> and the default for C<$flags> is C<0>.
		2569
		2570	Returns the system call status. If the syscall is missing, fails with
		2571	C<ENOSYS>.
		2572
		2573	When specified, C<$siginfo> must be a reference to a hash with one or more
		2574	of the following members:
		2575
		2576	=over
		2577
		2578	=item code - the C<si_code> member
		2579
		2580	=item pid - the C<si_pid> member
		2581
		2582	=item uid - the C<si_uid> member
		2583
		2584	=item value_int - the C<si_value.sival_int> member
		2585
		2586	=item value_ptr - the C<si_value.sival_ptr> member, specified as an integer
		2587
		2588	=back
		2589
		2590	Example: send a SIGKILL to the specified process.
		2591
		2592	my $status = IO::AIO::pidfd_send_signal $pidfh, 9, undef
		2593	and die "pidfd_send_signal: $!\n";
		2594
		2595	Example: send a SIGKILL to the specified process with extra data.
		2596
		2597	my $status = IO::AIO::pidfd_send_signal $pidfh, 9, { code => -1, value_int => 7 }
		2598	and die "pidfd_send_signal: $!\n";
		2599
		2600	=item $fh = IO::AIO::pidfd_getfd $pidfh, $targetfd[, $flags]
		2601
		2602	This is an interface to the Linux L<pidfd_getfd> system call. The default
		2603	for C<$flags> is C<0>.
		2604
		2605	On success, returns a dup'ed copy of the target file descriptor (specified
		2606	as an integer) returned (that is already set to close-on-exec), otherwise
		2607	returns C<undef>. If the syscall is missing, fails with C<ENOSYS>.
		2608
		2609	Example: get a copy of standard error of another process and print soemthing to it.
		2610
		2611	my $errfh = IO::AIO::pidfd_getfd $pidfh, 2
		2612	or die "pidfd_getfd: $!\n";
		2613	print $errfh "stderr\n";
		2614
2227	=item $fh = IO::AIO::eventfd [$initval, [$flags]]	2615	=item $fh = IO::AIO::eventfd [$initval, [$flags]]
2228		2616
2229	This is a direct interface to the Linux L<eventfd(2)> system call. The	2617	This is a direct interface to the Linux L<eventfd(2)> system call. The
2230	(unhelpful) defaults for C<$initval> and C<$flags> are C<0> for both.	2618	(unhelpful) defaults for C<$initval> and C<$flags> are C<0> for both.
2231		2619
…		…
2237	The following symbol flag values are available: C<IO::AIO::EFD_CLOEXEC>,	2625	The following symbol flag values are available: C<IO::AIO::EFD_CLOEXEC>,
2238	C<IO::AIO::EFD_NONBLOCK> and C<IO::AIO::EFD_SEMAPHORE> (Linux 2.6.30).	2626	C<IO::AIO::EFD_NONBLOCK> and C<IO::AIO::EFD_SEMAPHORE> (Linux 2.6.30).
2239		2627
2240	Example: create a new eventfd filehandle:	2628	Example: create a new eventfd filehandle:
2241		2629
2242	$fh = IO::AIO::eventfd 0, IO::AIO::O_CLOEXEC	2630	$fh = IO::AIO::eventfd 0, IO::AIO::EFD_CLOEXEC
2243	or die "eventfd: $!\n";	2631	or die "eventfd: $!\n";
2244		2632
2245	=item $fh = IO::AIO::timerfd_create $clockid[, $flags]	2633	=item $fh = IO::AIO::timerfd_create $clockid[, $flags]
2246		2634
2247	This is a direct interface to the Linux L<timerfd_create(2)> system call. The	2635	This is a direct interface to the Linux L<timerfd_create(2)> system
2248	(unhelpful) default for C<$flags> is C<0>.	2636	call. The (unhelpful) default for C<$flags> is C<0>, but your default
		2637	should be C<IO::AIO::TFD_CLOEXEC>.
2249		2638
2250	On success, the new timerfd filehandle is returned, otherwise returns	2639	On success, the new timerfd filehandle is returned, otherwise returns
2251	C<undef>. If the eventfd syscall is missing, fails with C<ENOSYS>.	2640	C<undef>. If the timerfd_create syscall is missing, fails with C<ENOSYS>.
2252		2641
2253	Please refer to L<timerfd_create(2)> for more info on this call.	2642	Please refer to L<timerfd_create(2)> for more info on this call.
2254		2643
2255	The following C<$clockid> values are	2644	The following C<$clockid> values are
2256	available: C<IO::AIO::CLOCK_REALTIME>, C<IO::AIO::CLOCK_MONOTONIC>	2645	available: C<IO::AIO::CLOCK_REALTIME>, C<IO::AIO::CLOCK_MONOTONIC>
…		…
2422	known issue, rather than a bug.	2811	known issue, rather than a bug.
2423		2812
2424	=head1 SEE ALSO	2813	=head1 SEE ALSO
2425		2814
2426	L<AnyEvent::AIO> for easy integration into event loops, L<Coro::AIO> for a	2815	L<AnyEvent::AIO> for easy integration into event loops, L<Coro::AIO> for a
2427	more natural syntax.	2816	more natural syntax and L<IO::FDPass> for file descriptor passing.
2428		2817
2429	=head1 AUTHOR	2818	=head1 AUTHOR
2430		2819
2431	Marc Lehmann <schmorp@schmorp.de>	2820	Marc Lehmann <schmorp@schmorp.de>
2432	http://home.schmorp.de/	2821	http://home.schmorp.de/

Diff Legend

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

Comparing IO-AIO/AIO.pm (file contents): Revision 1.284 by root, Fri Mar 23 01:14:08 2018 UTC vs. Revision 1.317 by root, Sun Sep 25 16:30:50 2022 UTC

Diff Legend

Comparing IO-AIO/AIO.pm (file contents):
Revision 1.284 by root, Fri Mar 23 01:14:08 2018 UTC vs.
Revision 1.317 by root, Sun Sep 25 16:30:50 2022 UTC