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

Comparing IO-AIO/AIO.pm (file contents):
Revision 1.288 by root, Tue Jul 31 22:27:49 2018 UTC vs.
Revision 1.302 by root, Wed Apr 3 03:03:53 2019 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.5;	176	our $VERSION = 4.72;
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
…		…
278	IO::AIO::idle_timeout $seconds	278	IO::AIO::idle_timeout $seconds
279	IO::AIO::max_outstanding $maxreqs	279	IO::AIO::max_outstanding $maxreqs
280	IO::AIO::nreqs	280	IO::AIO::nreqs
281	IO::AIO::nready	281	IO::AIO::nready
282	IO::AIO::npending	282	IO::AIO::npending
		283	IO::AIO::reinit
		284
283	$nfd = IO::AIO::get_fdlimit [EXPERIMENTAL]	285	$nfd = IO::AIO::get_fdlimit [EXPERIMENTAL]
284	IO::AIO::min_fdlimit $nfd [EXPERIMENTAL]	286	IO::AIO::min_fdlimit $nfd [EXPERIMENTAL]
285		287
286	IO::AIO::sendfile $ofh, $ifh, $offset, $count	288	IO::AIO::sendfile $ofh, $ifh, $offset, $count
287	IO::AIO::fadvise $fh, $offset, $len, $advice	289	IO::AIO::fadvise $fh, $offset, $len, $advice
		290
288	IO::AIO::mmap $scalar, $length, $prot, $flags[, $fh[, $offset]]	291	IO::AIO::mmap $scalar, $length, $prot, $flags[, $fh[, $offset]]
289	IO::AIO::munmap $scalar	292	IO::AIO::munmap $scalar
290	IO::AIO::mremap $scalar, $new_length, $flags[, $new_address]	293	IO::AIO::mremap $scalar, $new_length, $flags[, $new_address]
291	IO::AIO::madvise $scalar, $offset, $length, $advice	294	IO::AIO::madvise $scalar, $offset, $length, $advice
292	IO::AIO::mprotect $scalar, $offset, $length, $protect	295	IO::AIO::mprotect $scalar, $offset, $length, $protect
293	IO::AIO::munlock $scalar, $offset = 0, $length = undef	296	IO::AIO::munlock $scalar, $offset = 0, $length = undef
294	IO::AIO::munlockall	297	IO::AIO::munlockall
		298
		299	# stat extensions
		300	$counter = IO::AIO::st_gen
		301	$seconds = IO::AIO::st_atime, IO::AIO::st_mtime, IO::AIO::st_ctime, IO::AIO::st_btime
		302	($atime, $mtime, $ctime, $btime, ...) = IO::AIO::st_xtime
		303	$nanoseconds = IO::AIO::st_atimensec, IO::AIO::st_mtimensec, IO::AIO::st_ctimensec, IO::AIO::st_btimensec
		304	$seconds = IO::AIO::st_btimesec
		305	($atime, $mtime, $ctime, $btime, ...) = IO::AIO::st_xtimensec
		306
		307	# very much unportable syscalls
		308	IO::AIO::splice $r_fh, $r_off, $w_fh, $w_off, $length, $flags
		309	IO::AIO::tee $r_fh, $w_fh, $length, $flags
		310	$actual_size = IO::AIO::pipesize $r_fh[, $new_size]
		311	($rfh, $wfh) = IO::AIO::pipe2 [$flags]
		312	$fh = IO::AIO::memfd_create $pathname[, $flags]
		313	$fh = IO::AIO::eventfd [$initval, [$flags]]
		314	$fh = IO::AIO::timerfd_create $clockid[, $flags]
		315	($cur_interval, $cur_value) = IO::AIO::timerfd_settime $fh, $flags, $new_interval, $nbw_value
		316	($cur_interval, $cur_value) = IO::AIO::timerfd_gettime $fh
295		317
296	=head2 API NOTES	318	=head2 API NOTES
297		319
298	All the C<aio_*> calls are more or less thin wrappers around the syscall	320	All the C<aio_*> calls are more or less thin wrappers around the syscall
299	with the same name (sans C<aio_>). The arguments are similar or identical,	321	with the same name (sans C<aio_>). The arguments are similar or identical,
…		…
541		563
542	=item aio_stat $fh_or_path, $callback->($status)	564	=item aio_stat $fh_or_path, $callback->($status)
543		565
544	=item aio_lstat $fh, $callback->($status)	566	=item aio_lstat $fh, $callback->($status)
545		567
546	Works like perl's C<stat> or C<lstat> in void context. The callback will	568	Works almost exactly like perl's C<stat> or C<lstat> in void context. The
547	be called after the stat and the results will be available using C<stat _>	569	callback will be called after the stat and the results will be available
548	or C<-s _> etc...	570	using C<stat _> or C<-s _> and other tests (with the exception of C<-B>
		571	and C<-T>).
549		572
550	The pathname passed to C<aio_stat> must be absolute. See API NOTES, above,	573	The pathname passed to C<aio_stat> must be absolute. See API NOTES, above,
551	for an explanation.	574	for an explanation.
552		575
553	Currently, the stats are always 64-bit-stats, i.e. instead of returning an	576	Currently, the stats are always 64-bit-stats, i.e. instead of returning an
…		…
560	behaviour).	583	behaviour).
561		584
562	C<S_IFMT>, C<S_IFIFO>, C<S_IFCHR>, C<S_IFBLK>, C<S_IFLNK>, C<S_IFREG>,	585	C<S_IFMT>, C<S_IFIFO>, C<S_IFCHR>, C<S_IFBLK>, C<S_IFLNK>, C<S_IFREG>,
563	C<S_IFDIR>, C<S_IFWHT>, C<S_IFSOCK>, C<IO::AIO::major $dev_t>,	586	C<S_IFDIR>, C<S_IFWHT>, C<S_IFSOCK>, C<IO::AIO::major $dev_t>,
564	C<IO::AIO::minor $dev_t>, C<IO::AIO::makedev $major, $minor>.	587	C<IO::AIO::minor $dev_t>, C<IO::AIO::makedev $major, $minor>.
		588
		589	To access higher resolution stat timestamps, see L<SUBSECOND STAT TIME
		590	ACCESS>.
565		591
566	Example: Print the length of F</etc/passwd>:	592	Example: Print the length of F</etc/passwd>:
567		593
568	aio_stat "/etc/passwd", sub {	594	aio_stat "/etc/passwd", sub {
569	$_[0] and die "stat failed: $!";	595	$_[0] and die "stat failed: $!";
…		…
619		645
620	Works like perl's C<utime> function (including the special case of $atime	646	Works like perl's C<utime> function (including the special case of $atime
621	and $mtime being undef). Fractional times are supported if the underlying	647	and $mtime being undef). Fractional times are supported if the underlying
622	syscalls support them.	648	syscalls support them.
623		649
624	When called with a pathname, uses utimes(2) if available, otherwise	650	When called with a pathname, uses utimensat(2) or utimes(2) if available,
625	utime(2). If called on a file descriptor, uses futimes(2) if available,	651	otherwise utime(2). If called on a file descriptor, uses futimens(2)
626	otherwise returns ENOSYS, so this is not portable.	652	or futimes(2) if available, otherwise returns ENOSYS, so this is not
		653	portable.
627		654
628	Examples:	655	Examples:
629		656
630	# set atime and mtime to current time (basically touch(1)):	657	# set atime and mtime to current time (basically touch(1)):
631	aio_utime "path", undef, undef;	658	aio_utime "path", undef, undef;
…		…
1104	aioreq_pri $pri;	1131	aioreq_pri $pri;
1105	add $grp aio_stat $wd, sub {	1132	add $grp aio_stat $wd, sub {
1106	return $grp->result () if $_[0];	1133	return $grp->result () if $_[0];
1107	my $now = time;	1134	my $now = time;
1108	my $hash1 = join ":", (stat _)[0,1,3,7,9];	1135	my $hash1 = join ":", (stat _)[0,1,3,7,9];
		1136	my $rdxflags = READDIR_DIRS_FIRST;
		1137
		1138	if ((stat _)[3] < 2) {
		1139	# at least one non-POSIX filesystem exists
		1140	# that returns useful DT_type values: btrfs,
		1141	# so optimise for this here by requesting dents
		1142	$rdxflags \|= READDIR_DENTS;
		1143	}
1109		1144
1110	# read the directory entries	1145	# read the directory entries
1111	aioreq_pri $pri;	1146	aioreq_pri $pri;
1112	add $grp aio_readdirx $wd, READDIR_DIRS_FIRST, sub {	1147	add $grp aio_readdirx $wd, $rdxflags, sub {
1113	my $entries = shift	1148	my ($entries, $flags) = @_
1114	or return $grp->result ();	1149	or return $grp->result ();
		1150
		1151	if ($rdxflags & READDIR_DENTS) {
		1152	# if we requested type values, see if we can use them directly.
		1153
		1154	# if there were any DT_UNKNOWN entries then we assume we
		1155	# don't know. alternatively, we could assume that if we get
		1156	# one DT_DIR, then all directories are indeed marked with
		1157	# DT_DIR, but this seems not required for btrfs, and this
		1158	# is basically the "btrfs can't get it's act together" code
		1159	# branch.
		1160	unless ($flags & READDIR_FOUND_UNKNOWN) {
		1161	# now we have valid DT_ information for all entries,
		1162	# so use it as an optimisation without further stat's.
		1163	# they must also all be at the beginning of @$entries
		1164	# by now.
		1165
		1166	my $dirs;
		1167
		1168	if (@$entries) {
		1169	for (0 .. $#$entries) {
		1170	if ($entries->[$_][1] != DT_DIR) {
		1171	# splice out directories
		1172	$dirs = [splice @$entries, 0, $_];
		1173	last;
		1174	}
		1175	}
		1176
		1177	# if we didn't find any non-dir, then all entries are dirs
		1178	unless ($dirs) {
		1179	($dirs, $entries) = ($entries, []);
		1180	}
		1181	} else {
		1182	# directory is empty, so there are no sbdirs
		1183	$dirs = [];
		1184	}
		1185
		1186	# either splice'd the directories out or the dir was empty.
		1187	# convert dents to filenames
		1188	$_ = $_->[0] for @$dirs;
		1189	$_ = $_->[0] for @$entries;
		1190
		1191	return $grp->result ($dirs, $entries);
		1192	}
		1193
		1194	# cannot use, so return to our old ways
		1195	# by pretending we only scanned for names.
		1196	$_ = $_->[0] for @$entries;
		1197	}
1115		1198
1116	# stat the dir another time	1199	# stat the dir another time
1117	aioreq_pri $pri;	1200	aioreq_pri $pri;
1118	add $grp aio_stat $wd, sub {	1201	add $grp aio_stat $wd, sub {
1119	my $hash2 = join ":", (stat _)[0,1,3,7,9];	1202	my $hash2 = join ":", (stat _)[0,1,3,7,9];
…		…
1380	IO::AIO::mmap $data, -s $fh, IO::AIO::PROT_READ, IO::AIO::MAP_SHARED, $fh;	1463	IO::AIO::mmap $data, -s $fh, IO::AIO::PROT_READ, IO::AIO::MAP_SHARED, $fh;
1381	aio_mlock $data; # mlock in background	1464	aio_mlock $data; # mlock in background
1382		1465
1383	=item aio_mlockall $flags, $callback->($status)	1466	=item aio_mlockall $flags, $callback->($status)
1384		1467
1385	Calls the C<mlockall> function with the given C<$flags> (a combination of	1468	Calls the C<mlockall> function with the given C<$flags> (a
1386	C<IO::AIO::MCL_CURRENT> and C<IO::AIO::MCL_FUTURE>).	1469	combination of C<IO::AIO::MCL_CURRENT>, C<IO::AIO::MCL_FUTURE> and
		1470	C<IO::AIO::MCL_ONFAULT>).
1387		1471
1388	On systems that do not implement C<mlockall>, this function returns C<-1>	1472	On systems that do not implement C<mlockall>, this function returns C<-1>
1389	and sets errno to C<ENOSYS>.	1473	and sets errno to C<ENOSYS>. Similarly, flag combinations not supported
		1474	by the system result in a return value of C<-1> with errno being set to
		1475	C<EINVAL>.
1390		1476
1391	Note that the corresponding C<munlockall> is synchronous and is	1477	Note that the corresponding C<munlockall> is synchronous and is
1392	documented under L<MISCELLANEOUS FUNCTIONS>.	1478	documented under L<MISCELLANEOUS FUNCTIONS>.
1393		1479
1394	Example: asynchronously lock all current and future pages into memory.	1480	Example: asynchronously lock all current and future pages into memory.
…		…
1779	The default value for the limit is C<0>, but note that setting a feeder	1865	The default value for the limit is C<0>, but note that setting a feeder
1780	automatically bumps it up to C<2>.	1866	automatically bumps it up to C<2>.
1781		1867
1782	=back	1868	=back
1783		1869
		1870
1784	=head2 SUPPORT FUNCTIONS	1871	=head2 SUPPORT FUNCTIONS
1785		1872
1786	=head3 EVENT PROCESSING AND EVENT LOOP INTEGRATION	1873	=head3 EVENT PROCESSING AND EVENT LOOP INTEGRATION
1787		1874
1788	=over 4	1875	=over 4
…		…
1853	Strictly equivalent to:	1940	Strictly equivalent to:
1854		1941
1855	IO::AIO::poll_wait, IO::AIO::poll_cb	1942	IO::AIO::poll_wait, IO::AIO::poll_cb
1856	while IO::AIO::nreqs;	1943	while IO::AIO::nreqs;
1857		1944
		1945	This function can be useful at program aborts, to make sure outstanding
		1946	I/O has been done (C<IO::AIO> uses an C<END> block which already calls
		1947	this function on normal exits), or when you are merely using C<IO::AIO>
		1948	for its more advanced functions, rather than for async I/O, e.g.:
		1949
		1950	my ($dirs, $nondirs);
		1951	IO::AIO::aio_scandir "/tmp", 0, sub { ($dirs, $nondirs) = @_ };
		1952	IO::AIO::flush;
		1953	# $dirs, $nondirs are now set
		1954
1858	=item IO::AIO::max_poll_reqs $nreqs	1955	=item IO::AIO::max_poll_reqs $nreqs
1859		1956
1860	=item IO::AIO::max_poll_time $seconds	1957	=item IO::AIO::max_poll_time $seconds
1861		1958
1862	These set the maximum number of requests (default C<0>, meaning infinity)	1959	These set the maximum number of requests (default C<0>, meaning infinity)
…		…
1888	poll => 'r', nice => 1,	1985	poll => 'r', nice => 1,
1889	cb => &IO::AIO::poll_cb);	1986	cb => &IO::AIO::poll_cb);
1890		1987
1891	=back	1988	=back
1892		1989
		1990
1893	=head3 CONTROLLING THE NUMBER OF THREADS	1991	=head3 CONTROLLING THE NUMBER OF THREADS
1894		1992
1895	=over	1993	=over
1896		1994
1897	=item IO::AIO::min_parallel $nthreads	1995	=item IO::AIO::min_parallel $nthreads
…		…
1984	The default value for C<max_outstanding> is very large, so there is no	2082	The default value for C<max_outstanding> is very large, so there is no
1985	practical limit on the number of outstanding requests.	2083	practical limit on the number of outstanding requests.
1986		2084
1987	=back	2085	=back
1988		2086
		2087
1989	=head3 STATISTICAL INFORMATION	2088	=head3 STATISTICAL INFORMATION
1990		2089
1991	=over	2090	=over
1992		2091
1993	=item IO::AIO::nreqs	2092	=item IO::AIO::nreqs
…		…
2009		2108
2010	Returns the number of requests currently in the pending state (executed,	2109	Returns the number of requests currently in the pending state (executed,
2011	but not yet processed by poll_cb).	2110	but not yet processed by poll_cb).
2012		2111
2013	=back	2112	=back
		2113
		2114
		2115	=head3 SUBSECOND STAT TIME ACCESS
		2116
		2117	Both C<aio_stat>/C<aio_lstat> and perl's C<stat>/C<lstat> functions can
		2118	generally find access/modification and change times with subsecond time
		2119	accuracy of the system supports it, but perl's built-in functions only
		2120	return the integer part.
		2121
		2122	The following functions return the timestamps of the most recent
		2123	stat with subsecond precision on most systems and work both after
		2124	C<aio_stat>/C<aio_lstat> and perl's C<stat>/C<lstat> calls. Their return
		2125	value is only meaningful after a successful C<stat>/C<lstat> call, or
		2126	during/after a successful C<aio_stat>/C<aio_lstat> callback.
		2127
		2128	This is similar to the L<Time::HiRes> C<stat> functions, but can return
		2129	full resolution without rounding and work with standard perl C<stat>,
		2130	alleviating the need to call the special C<Time::HiRes> functions, which
		2131	do not act like their perl counterparts.
		2132
		2133	On operating systems or file systems where subsecond time resolution is
		2134	not supported or could not be detected, a fractional part of C<0> is
		2135	returned, so it is always safe to call these functions.
		2136
		2137	=over 4
		2138
		2139	=item $seconds = IO::AIO::st_atime, IO::AIO::st_mtime, IO::AIO::st_ctime, IO::AIO::st_btime
		2140
		2141	Return the access, modication, change or birth time, respectively,
		2142	including fractional part. Due to the limited precision of floating point,
		2143	the accuracy on most platforms is only a bit better than milliseconds
		2144	for times around now - see the I<nsec> function family, below, for full
		2145	accuracy.
		2146
		2147	File birth time is only available when the OS and perl support it (on
		2148	FreeBSD and NetBSD at the time of this writing, although support is
		2149	adaptive, so if your OS/perl gains support, IO::AIO can take advantage of
		2150	it). On systems where it isn't available, C<0> is currently returned, but
		2151	this might change to C<undef> in a future version.
		2152
		2153	=item ($atime, $mtime, $ctime, $btime, ...) = IO::AIO::st_xtime
		2154
		2155	Returns access, modification, change and birth time all in one go, and
		2156	maybe more times in the future version.
		2157
		2158	=item $nanoseconds = IO::AIO::st_atimensec, IO::AIO::st_mtimensec, IO::AIO::st_ctimensec, IO::AIO::st_btimensec
		2159
		2160	Return the fractional access, modifcation, change or birth time, in nanoseconds,
		2161	as an integer in the range C<0> to C<999999999>.
		2162
		2163	Note that no accessors are provided for access, modification and
		2164	change times - you need to get those from C<stat _> if required (C<int
		2165	IO::AIO::st_atime> and so on will I<not> generally give you the correct
		2166	value).
		2167
		2168	=item $seconds = IO::AIO::st_btimesec
		2169
		2170	The (integral) seconds part of the file birth time, if available.
		2171
		2172	=item ($atime, $mtime, $ctime, $btime, ...) = IO::AIO::st_xtimensec
		2173
		2174	Like the functions above, but returns all four times in one go (and maybe
		2175	more in future versions).
		2176
		2177	=item $counter = IO::AIO::st_gen
		2178
		2179	Returns the generation counter (in practice this is just a random number)
		2180	of the file. This is only available on platforms which have this member in
		2181	their C<struct stat> (most BSDs at the time of this writing) and generally
		2182	only to the root usert. If unsupported, C<0> is returned, but this might
		2183	change to C<undef> in a future version.
		2184
		2185	=back
		2186
		2187	Example: print the high resolution modification time of F</etc>, using
		2188	C<stat>, and C<IO::AIO::aio_stat>.
		2189
		2190	if (stat "/etc") {
		2191	printf "stat(/etc) mtime: %f\n", IO::AIO::st_mtime;
		2192	}
		2193
		2194	IO::AIO::aio_stat "/etc", sub {
		2195	$_[0]
		2196	and return;
		2197
		2198	printf "aio_stat(/etc) mtime: %d.%09d\n", (stat _)[9], IO::AIO::st_mtimensec;
		2199	};
		2200
		2201	IO::AIO::flush;
		2202
		2203	Output of the awbove on my system, showing reduced and full accuracy:
		2204
		2205	stat(/etc) mtime: 1534043702.020808
		2206	aio_stat(/etc) mtime: 1534043702.020807792
		2207
2014		2208
2015	=head3 MISCELLANEOUS FUNCTIONS	2209	=head3 MISCELLANEOUS FUNCTIONS
2016		2210
2017	IO::AIO implements some functions that are useful when you want to use	2211	IO::AIO implements some functions that are useful when you want to use
2018	some "Advanced I/O" function not available to in Perl, without going the	2212	some "Advanced I/O" function not available to in Perl, without going the
…		…
2182	implemented, but not supported and might go away in a future version.	2376	implemented, but not supported and might go away in a future version.
2183		2377
2184	On systems where this call is not supported or is not emulated, this call	2378	On systems where this call is not supported or is not emulated, this call
2185	returns falls and sets C<$!> to C<ENOSYS>.	2379	returns falls and sets C<$!> to C<ENOSYS>.
2186		2380
		2381	=item IO::AIO::mlockall $flags
		2382
		2383	Calls the C<eio_mlockall_sync> function, which is like C<aio_mlockall>,
		2384	but is blocking.
		2385
2187	=item IO::AIO::munlock $scalar, $offset = 0, $length = undef	2386	=item IO::AIO::munlock $scalar, $offset = 0, $length = undef
2188		2387
2189	Calls the C<munlock> function, undoing the effects of a previous	2388	Calls the C<munlock> function, undoing the effects of a previous
2190	C<aio_mlock> call (see its description for details).	2389	C<aio_mlock> call (see its description for details).
2191		2390
…		…
2246	Example: create a pipe race-free w.r.t. threads and fork:	2445	Example: create a pipe race-free w.r.t. threads and fork:
2247		2446
2248	my ($rfh, $wfh) = IO::AIO::pipe2 IO::AIO::O_CLOEXEC	2447	my ($rfh, $wfh) = IO::AIO::pipe2 IO::AIO::O_CLOEXEC
2249	or die "pipe2: $!\n";	2448	or die "pipe2: $!\n";
2250		2449
		2450	=item $fh = IO::AIO::memfd_create $pathname[, $flags]
		2451
		2452	This is a direct interface to the Linux L<memfd_create(2)> system
		2453	call. The (unhelpful) default for C<$flags> is C<0>, but your default
		2454	should be C<IO::AIO::MFD_CLOEXEC>.
		2455
		2456	On success, the new memfd filehandle is returned, otherwise returns
		2457	C<undef>. If the memfd_create syscall is missing, fails with C<ENOSYS>.
		2458
		2459	Please refer to L<memfd_create(2)> for more info on this call.
		2460
		2461	The following C<$flags> values are available: C<IO::AIO::MFD_CLOEXEC>,
		2462	C<IO::AIO::MFD_ALLOW_SEALING> and C<IO::AIO::MFD_HUGETLB>.
		2463
		2464	Example: create a new memfd.
		2465
		2466	my $fh = IO::AIO::memfd_create "somenameforprocfd", IO::AIO::MFD_CLOEXEC
		2467	or die "m,emfd_create: $!\n";
2251	=item $fh = IO::AIO::eventfd [$initval, [$flags]]	2468	=item $fh = IO::AIO::eventfd [$initval, [$flags]]
2252		2469
2253	This is a direct interface to the Linux L<eventfd(2)> system call. The	2470	This is a direct interface to the Linux L<eventfd(2)> system call. The
2254	(unhelpful) defaults for C<$initval> and C<$flags> are C<0> for both.	2471	(unhelpful) defaults for C<$initval> and C<$flags> are C<0> for both.
2255		2472
…		…
2261	The following symbol flag values are available: C<IO::AIO::EFD_CLOEXEC>,	2478	The following symbol flag values are available: C<IO::AIO::EFD_CLOEXEC>,
2262	C<IO::AIO::EFD_NONBLOCK> and C<IO::AIO::EFD_SEMAPHORE> (Linux 2.6.30).	2479	C<IO::AIO::EFD_NONBLOCK> and C<IO::AIO::EFD_SEMAPHORE> (Linux 2.6.30).
2263		2480
2264	Example: create a new eventfd filehandle:	2481	Example: create a new eventfd filehandle:
2265		2482
2266	$fh = IO::AIO::eventfd 0, IO::AIO::O_CLOEXEC	2483	$fh = IO::AIO::eventfd 0, IO::AIO::EFD_CLOEXEC
2267	or die "eventfd: $!\n";	2484	or die "eventfd: $!\n";
2268		2485
2269	=item $fh = IO::AIO::timerfd_create $clockid[, $flags]	2486	=item $fh = IO::AIO::timerfd_create $clockid[, $flags]
2270		2487
2271	This is a direct interface to the Linux L<timerfd_create(2)> system call. The	2488	This is a direct interface to the Linux L<timerfd_create(2)> system
2272	(unhelpful) default for C<$flags> is C<0>.	2489	call. The (unhelpful) default for C<$flags> is C<0>, but your default
		2490	should be C<IO::AIO::TFD_CLOEXEC>.
2273		2491
2274	On success, the new timerfd filehandle is returned, otherwise returns	2492	On success, the new timerfd filehandle is returned, otherwise returns
2275	C<undef>. If the eventfd syscall is missing, fails with C<ENOSYS>.	2493	C<undef>. If the timerfd_create syscall is missing, fails with C<ENOSYS>.
2276		2494
2277	Please refer to L<timerfd_create(2)> for more info on this call.	2495	Please refer to L<timerfd_create(2)> for more info on this call.
2278		2496
2279	The following C<$clockid> values are	2497	The following C<$clockid> values are
2280	available: C<IO::AIO::CLOCK_REALTIME>, C<IO::AIO::CLOCK_MONOTONIC>	2498	available: C<IO::AIO::CLOCK_REALTIME>, C<IO::AIO::CLOCK_MONOTONIC>

Diff Legend

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

Comparing IO-AIO/AIO.pm (file contents): Revision 1.288 by root, Tue Jul 31 22:27:49 2018 UTC vs. Revision 1.302 by root, Wed Apr 3 03:03:53 2019 UTC

Diff Legend

Comparing IO-AIO/AIO.pm (file contents):
Revision 1.288 by root, Tue Jul 31 22:27:49 2018 UTC vs.
Revision 1.302 by root, Wed Apr 3 03:03:53 2019 UTC