[ViewVC] Diff of: cvs/IO-AIO/README

Comparing IO-AIO/README (file contents):
Revision 1.53 by root, Thu Oct 11 03:20:52 2012 UTC vs.
Revision 1.57 by root, Mon Jan 18 11:53:09 2016 UTC

…		…
64		64
65	EXAMPLE	65	EXAMPLE
66	This is a simple example that uses the EV module and loads /etc/passwd	66	This is a simple example that uses the EV module and loads /etc/passwd
67	asynchronously:	67	asynchronously:
68		68
69	use Fcntl;
70	use EV;	69	use EV;
71	use IO::AIO;	70	use IO::AIO;
72		71
73	# register the IO::AIO callback with EV	72	# register the IO::AIO callback with EV
74	my $aio_w = EV::io IO::AIO::poll_fileno, EV::READ, \&IO::AIO::poll_cb;	73	my $aio_w = EV::io IO::AIO::poll_fileno, EV::READ, \&IO::AIO::poll_cb;
…		…
91		90
92	# file contents now in $contents	91	# file contents now in $contents
93	print $contents;	92	print $contents;
94		93
95	# exit event loop and program	94	# exit event loop and program
96	EV::unloop;	95	EV::break;
97	};	96	};
98	};	97	};
99		98
100	# possibly queue up other requests, or open GUI windows,	99	# possibly queue up other requests, or open GUI windows,
101	# check for sockets etc. etc.	100	# check for sockets etc. etc.
102		101
103	# process events as long as there are some:	102	# process events as long as there are some:
104	EV::loop;	103	EV::run;
105		104
106	REQUEST ANATOMY AND LIFETIME	105	REQUEST ANATOMY AND LIFETIME
107	Every "aio_*" function creates a request. which is a C data structure	106	Every "aio_*" function creates a request. which is a C data structure
108	not directly visible to Perl.	107	not directly visible to Perl.
109		108
…		…
172	aio_unlink $pathname, $callback->($status)	171	aio_unlink $pathname, $callback->($status)
173	aio_mknod $pathname, $mode, $dev, $callback->($status)	172	aio_mknod $pathname, $mode, $dev, $callback->($status)
174	aio_link $srcpath, $dstpath, $callback->($status)	173	aio_link $srcpath, $dstpath, $callback->($status)
175	aio_symlink $srcpath, $dstpath, $callback->($status)	174	aio_symlink $srcpath, $dstpath, $callback->($status)
176	aio_readlink $pathname, $callback->($link)	175	aio_readlink $pathname, $callback->($link)
177	aio_realpath $pathname, $callback->($link)	176	aio_realpath $pathname, $callback->($path)
178	aio_rename $srcpath, $dstpath, $callback->($status)	177	aio_rename $srcpath, $dstpath, $callback->($status)
179	aio_mkdir $pathname, $mode, $callback->($status)	178	aio_mkdir $pathname, $mode, $callback->($status)
180	aio_rmdir $pathname, $callback->($status)	179	aio_rmdir $pathname, $callback->($status)
181	aio_readdir $pathname, $callback->($entries)	180	aio_readdir $pathname, $callback->($entries)
182	aio_readdirx $pathname, $flags, $callback->($entries, $flags)	181	aio_readdirx $pathname, $flags, $callback->($entries, $flags)
…		…
331	"O_APPEND"), the following POSIX and non-POSIX constants are	330	"O_APPEND"), the following POSIX and non-POSIX constants are
332	available (missing ones on your system are, as usual, 0):	331	available (missing ones on your system are, as usual, 0):
333		332
334	"O_ASYNC", "O_DIRECT", "O_NOATIME", "O_CLOEXEC", "O_NOCTTY",	333	"O_ASYNC", "O_DIRECT", "O_NOATIME", "O_CLOEXEC", "O_NOCTTY",
335	"O_NOFOLLOW", "O_NONBLOCK", "O_EXEC", "O_SEARCH", "O_DIRECTORY",	334	"O_NOFOLLOW", "O_NONBLOCK", "O_EXEC", "O_SEARCH", "O_DIRECTORY",
336	"O_DSYNC", "O_RSYNC", "O_SYNC" and "O_TTY_INIT".	335	"O_DSYNC", "O_RSYNC", "O_SYNC", "O_PATH", "O_TMPFILE", and
		336	"O_TTY_INIT".
337		337
338	aio_close $fh, $callback->($status)	338	aio_close $fh, $callback->($status)
339	Asynchronously close a file and call the callback with the result	339	Asynchronously close a file and call the callback with the result
340	code.	340	code.
341		341
…		…
530	namemax => 255,	530	namemax => 255,
531	frsize => 1024,	531	frsize => 1024,
532	fsid => 1810	532	fsid => 1810
533	}	533	}
534		534
535	Here is a (likely partial) list of fsid values used by Linux - it is	535	Here is a (likely partial - send me updates!) list of fsid values
536	safe to hardcode these when the $^O is "linux":	536	used by Linux - it is safe to hardcode these when $^O is "linux":
537		537
538	0x0000adf5 adfs	538	0x0000adf5 adfs
539	0x0000adff affs	539	0x0000adff affs
540	0x5346414f afs	540	0x5346414f afs
541	0x09041934 anon-inode filesystem	541	0x09041934 anon-inode filesystem
…		…
554	0x00001373 devfs	554	0x00001373 devfs
555	0x00001cd1 devpts	555	0x00001cd1 devpts
556	0x0000f15f ecryptfs	556	0x0000f15f ecryptfs
557	0x00414a53 efs	557	0x00414a53 efs
558	0x0000137d ext	558	0x0000137d ext
559	0x0000ef53 ext2/ext3	559	0x0000ef53 ext2/ext3/ext4
560	0x0000ef51 ext2	560	0x0000ef51 ext2
		561	0xf2f52010 f2fs
561	0x00004006 fat	562	0x00004006 fat
562	0x65735546 fuseblk	563	0x65735546 fuseblk
563	0x65735543 fusectl	564	0x65735543 fusectl
564	0x0bad1dea futexfs	565	0x0bad1dea futexfs
565	0x01161970 gfs2	566	0x01161970 gfs2
566	0x47504653 gpfs	567	0x47504653 gpfs
567	0x00004244 hfs	568	0x00004244 hfs
568	0xf995e849 hpfs	569	0xf995e849 hpfs
		570	0x00c0ffee hostfs
569	0x958458f6 hugetlbfs	571	0x958458f6 hugetlbfs
570	0x2bad1dea inotifyfs	572	0x2bad1dea inotifyfs
571	0x00009660 isofs	573	0x00009660 isofs
572	0x000072b6 jffs2	574	0x000072b6 jffs2
573	0x3153464a jfs	575	0x3153464a jfs
…		…
588	0x00009fa1 openprom	590	0x00009fa1 openprom
589	0x7461636F ocfs2	591	0x7461636F ocfs2
590	0x00009fa0 proc	592	0x00009fa0 proc
591	0x6165676c pstorefs	593	0x6165676c pstorefs
592	0x0000002f qnx4	594	0x0000002f qnx4
		595	0x68191122 qnx6
593	0x858458f6 ramfs	596	0x858458f6 ramfs
594	0x52654973 reiserfs	597	0x52654973 reiserfs
595	0x00007275 romfs	598	0x00007275 romfs
596	0x67596969 rpc_pipefs	599	0x67596969 rpc_pipefs
597	0x73636673 securityfs	600	0x73636673 securityfs
…		…
644		647
645	aio_truncate $fh_or_path, $offset, $callback->($status)	648	aio_truncate $fh_or_path, $offset, $callback->($status)
646	Works like truncate(2) or ftruncate(2).	649	Works like truncate(2) or ftruncate(2).
647		650
648	aio_allocate $fh, $mode, $offset, $len, $callback->($status)	651	aio_allocate $fh, $mode, $offset, $len, $callback->($status)
649	Allocates or freed disk space according to the $mode argument. See	652	Allocates or frees disk space according to the $mode argument. See
650	the linux "fallocate" docuemntation for details.	653	the linux "fallocate" documentation for details.
651		654
652	$mode can currently be 0 or "IO::AIO::FALLOC_FL_KEEP_SIZE" to	655	$mode is usually 0 or "IO::AIO::FALLOC_FL_KEEP_SIZE" to allocate
653	allocate space, or "IO::AIO::FALLOC_FL_PUNCH_HOLE \|	656	space, or "IO::AIO::FALLOC_FL_PUNCH_HOLE \|
654	IO::AIO::FALLOC_FL_KEEP_SIZE", to deallocate a file range.	657	IO::AIO::FALLOC_FL_KEEP_SIZE", to deallocate a file range.
		658
		659	IO::AIO also supports "FALLOC_FL_COLLAPSE_RANGE", to remove a range
		660	(without leaving a hole) and "FALLOC_FL_ZERO_RANGE", to zero a range
		661	(see your fallocate(2) manpage).
655		662
656	The file system block size used by "fallocate" is presumably the	663	The file system block size used by "fallocate" is presumably the
657	"f_bsize" returned by "statvfs".	664	"f_bsize" returned by "statvfs".
658		665
659	If "fallocate" isn't available or cannot be emulated (currently no	666	If "fallocate" isn't available or cannot be emulated (currently no
…		…
692	the callback. If an error occurs, nothing or undef gets passed to	699	the callback. If an error occurs, nothing or undef gets passed to
693	the callback.	700	the callback.
694		701
695	aio_realpath $pathname, $callback->($path)	702	aio_realpath $pathname, $callback->($path)
696	Asynchronously make the path absolute and resolve any symlinks in	703	Asynchronously make the path absolute and resolve any symlinks in
697	$path. The resulting path only consists of directories (Same as	704	$path. The resulting path only consists of directories (same as
698	Cwd::realpath).	705	Cwd::realpath).
699		706
700	This request can be used to get the absolute path of the current	707	This request can be used to get the absolute path of the current
701	working directory by passing it a path of . (a single dot).	708	working directory by passing it a path of . (a single dot).
702		709
703	aio_rename $srcpath, $dstpath, $callback->($status)	710	aio_rename $srcpath, $dstpath, $callback->($status)
704	Asynchronously rename the object at $srcpath to $dstpath, just as	711	Asynchronously rename the object at $srcpath to $dstpath, just as
705	rename(2) and call the callback with the result code.	712	rename(2) and call the callback with the result code.
		713
		714	On systems that support the AIO::WD working directory abstraction
		715	natively, the case "[$wd, "."]" as $srcpath is specialcased -
		716	instead of failing, "rename" is called on the absolute path of $wd.
706		717
707	aio_mkdir $pathname, $mode, $callback->($status)	718	aio_mkdir $pathname, $mode, $callback->($status)
708	Asynchronously mkdir (create) a directory and call the callback with	719	Asynchronously mkdir (create) a directory and call the callback with
709	the result code. $mode will be modified by the umask at the time the	720	the result code. $mode will be modified by the umask at the time the
710	request is executed, so do not change your umask.	721	request is executed, so do not change your umask.
711		722
712	aio_rmdir $pathname, $callback->($status)	723	aio_rmdir $pathname, $callback->($status)
713	Asynchronously rmdir (delete) a directory and call the callback with	724	Asynchronously rmdir (delete) a directory and call the callback with
714	the result code.	725	the result code.
		726
		727	On systems that support the AIO::WD working directory abstraction
		728	natively, the case "[$wd, "."]" is specialcased - instead of
		729	failing, "rmdir" is called on the absolute path of $wd.
715		730
716	aio_readdir $pathname, $callback->($entries)	731	aio_readdir $pathname, $callback->($entries)
717	Unlike the POSIX call of the same name, "aio_readdir" reads an	732	Unlike the POSIX call of the same name, "aio_readdir" reads an
718	entire directory (i.e. opendir + readdir + closedir). The entries	733	entire directory (i.e. opendir + readdir + closedir). The entries
719	will not be sorted, and will NOT include the "." and ".." entries.	734	will not be sorted, and will NOT include the "." and ".." entries.
…		…
942		957
943	It touches (reads or writes) all memory pages in the specified range	958	It touches (reads or writes) all memory pages in the specified range
944	inside the scalar. All caveats and parameters are the same as for	959	inside the scalar. All caveats and parameters are the same as for
945	"aio_msync", above, except for flags, which must be either 0 (which	960	"aio_msync", above, except for flags, which must be either 0 (which
946	reads all pages and ensures they are instantiated) or	961	reads all pages and ensures they are instantiated) or
947	"IO::AIO::MT_MODIFY", which modifies the memory page s(by reading	962	"IO::AIO::MT_MODIFY", which modifies the memory pages (by reading
948	and writing an octet from it, which dirties the page).	963	and writing an octet from it, which dirties the page).
949		964
950	aio_mlock $scalar, $offset = 0, $length = undef, $callback->($status)	965	aio_mlock $scalar, $offset = 0, $length = undef, $callback->($status)
951	This is a rather advanced IO::AIO call, which works best on	966	This is a rather advanced IO::AIO call, which works best on
952	mmap(2)ed scalars.	967	mmap(2)ed scalars.
…		…
1121	aio_stat [$etcdir, "passwd"], sub {	1136	aio_stat [$etcdir, "passwd"], sub {
1122	# yay	1137	# yay
1123	};	1138	};
1124	};	1139	};
1125		1140
1126	That "aio_wd" is a request and not a normal function shows that creating	1141	The fact that "aio_wd" is a request and not a normal function shows that
1127	an IO::AIO::WD object is itself a potentially blocking operation, which	1142	creating an IO::AIO::WD object is itself a potentially blocking
1128	is why it is done asynchronously.	1143	operation, which is why it is done asynchronously.
1129		1144
1130	To stat the directory obtained with "aio_wd" above, one could write	1145	To stat the directory obtained with "aio_wd" above, one could write
1131	either of the following three request calls:	1146	either of the following three request calls:
1132		1147
1133	aio_lstat "/etc" , sub { ... # pathname as normal string	1148	aio_lstat "/etc" , sub { ... # pathname as normal string
…		…
1153	will still point to the original directory. Most functions accepting a	1168	will still point to the original directory. Most functions accepting a
1154	pathname will use the directory fd on newer systems, and the string on	1169	pathname will use the directory fd on newer systems, and the string on
1155	older systems. Some functions (such as realpath) will always rely on the	1170	older systems. Some functions (such as realpath) will always rely on the
1156	string form of the pathname.	1171	string form of the pathname.
1157		1172
1158	So this fucntionality is mainly useful to get some protection against	1173	So this functionality is mainly useful to get some protection against
1159	"chdir", to easily get an absolute path out of a relative path for	1174	"chdir", to easily get an absolute path out of a relative path for
1160	future reference, and to speed up doing many operations in the same	1175	future reference, and to speed up doing many operations in the same
1161	directory (e.g. when stat'ing all files in a directory).	1176	directory (e.g. when stat'ing all files in a directory).
1162		1177
1163	The following functions implement this working directory abstraction:	1178	The following functions implement this working directory abstraction:
…		…
1173	Since passing "undef" as working directory component of a pathname	1188	Since passing "undef" as working directory component of a pathname
1174	fails the request with "ENOENT", there is often no need for error	1189	fails the request with "ENOENT", there is often no need for error
1175	checking in the "aio_wd" callback, as future requests using the	1190	checking in the "aio_wd" callback, as future requests using the
1176	value will fail in the expected way.	1191	value will fail in the expected way.
1177		1192
1178	If this call isn't available because your OS lacks it or it couldn't
1179	be detected, it will be emulated by calling "fsync" instead.
1180
1181	IO::AIO::CWD	1193	IO::AIO::CWD
1182	This is a compiletime constant (object) that represents the process	1194	This is a compiletime constant (object) that represents the process
1183	current working directory.	1195	current working directory.
1184		1196
1185	Specifying this object as working directory object for a pathname is	1197	Specifying this object as working directory object for a pathname is
1186	as if the pathname would be specified directly, without a directory	1198	as if the pathname would be specified directly, without a directory
1187	object, e.g., these calls are functionally identical:	1199	object. For example, these calls are functionally identical:
1188		1200
1189	aio_stat "somefile", sub { ... };	1201	aio_stat "somefile", sub { ... };
1190	aio_stat [IO::AIO::CWD, "somefile"], sub { ... };	1202	aio_stat [IO::AIO::CWD, "somefile"], sub { ... };
		1203
		1204	To recover the path associated with an IO::AIO::WD object, you can use
		1205	"aio_realpath":
		1206
		1207	aio_realpath $wd, sub {
		1208	warn "path is $_[0]\n";
		1209	};
		1210
		1211	Currently, "aio_statvfs" always, and "aio_rename" and "aio_rmdir"
		1212	sometimes, fall back to using an absolue path.
1191		1213
1192	IO::AIO::REQ CLASS	1214	IO::AIO::REQ CLASS
1193	All non-aggregate "aio_*" functions return an object of this class when	1215	All non-aggregate "aio_*" functions return an object of this class when
1194	called in non-void context.	1216	called in non-void context.
1195		1217
…		…
1347	results.	1369	results.
1348		1370
1349	See "poll_cb" for an example.	1371	See "poll_cb" for an example.
1350		1372
1351	IO::AIO::poll_cb	1373	IO::AIO::poll_cb
1352	Process some outstanding events on the result pipe. You have to call	1374	Process some requests that have reached the result phase (i.e. they
		1375	have been executed but the results are not yet reported). You have
		1376	to call this "regularly" to finish outstanding requests.
		1377
1353	this regularly. Returns 0 if all events could be processed (or there	1378	Returns 0 if all events could be processed (or there were no events
1354	were no events to process), or -1 if it returned earlier for	1379	to process), or -1 if it returned earlier for whatever reason.
1355	whatever reason. Returns immediately when no events are outstanding.	1380	Returns immediately when no events are outstanding. The amount of
1356	The amount of events processed depends on the settings of	1381	events processed depends on the settings of "IO::AIO::max_poll_req",
1357	"IO::AIO::max_poll_req" and "IO::AIO::max_poll_time".	1382	"IO::AIO::max_poll_time" and "IO::AIO::max_outstanding".
1358		1383
1359	If not all requests were processed for whatever reason, the	1384	If not all requests were processed for whatever reason, the poll
1360	filehandle will still be ready when "poll_cb" returns, so normally	1385	file descriptor will still be ready when "poll_cb" returns, so
1361	you don't have to do anything special to have it called later.	1386	normally you don't have to do anything special to have it called
		1387	later.
1362		1388
1363	Apart from calling "IO::AIO::poll_cb" when the event filehandle	1389	Apart from calling "IO::AIO::poll_cb" when the event filehandle
1364	becomes ready, it can be beneficial to call this function from loops	1390	becomes ready, it can be beneficial to call this function from loops
1365	which submit a lot of requests, to make sure the results get	1391	which submit a lot of requests, to make sure the results get
1366	processed when they become available and not just when the loop is	1392	processed when they become available and not just when the loop is
…		…
1374	Event->io (fd => IO::AIO::poll_fileno,	1400	Event->io (fd => IO::AIO::poll_fileno,
1375	poll => 'r', async => 1,	1401	poll => 'r', async => 1,
1376	cb => \&IO::AIO::poll_cb);	1402	cb => \&IO::AIO::poll_cb);
1377		1403
1378	IO::AIO::poll_wait	1404	IO::AIO::poll_wait
1379	If there are any outstanding requests and none of them in the result	1405	Wait until either at least one request is in the result phase or no
1380	phase, wait till the result filehandle becomes ready for reading	1406	requests are outstanding anymore.
1381	(simply does a "select" on the filehandle. This is useful if you	1407
1382	want to synchronously wait for some requests to finish).	1408	This is useful if you want to synchronously wait for some requests
		1409	to become ready, without actually handling them.
1383		1410
1384	See "nreqs" for an example.	1411	See "nreqs" for an example.
1385		1412
1386	IO::AIO::poll	1413	IO::AIO::poll
1387	Waits until some requests have been handled.	1414	Waits until some requests have been handled.
…		…
1499		1526
1500	This is a very bad function to use in interactive programs because	1527	This is a very bad function to use in interactive programs because
1501	it blocks, and a bad way to reduce concurrency because it is	1528	it blocks, and a bad way to reduce concurrency because it is
1502	inexact: Better use an "aio_group" together with a feed callback.	1529	inexact: Better use an "aio_group" together with a feed callback.
1503		1530
1504	It's main use is in scripts without an event loop - when you want to	1531	Its main use is in scripts without an event loop - when you want to
1505	stat a lot of files, you can write somehting like this:	1532	stat a lot of files, you can write somehting like this:
1506		1533
1507	IO::AIO::max_outstanding 32;	1534	IO::AIO::max_outstanding 32;
1508		1535
1509	for my $path (...) {	1536	for my $path (...) {
…		…
1540	IO::AIO::npending	1567	IO::AIO::npending
1541	Returns the number of requests currently in the pending state	1568	Returns the number of requests currently in the pending state
1542	(executed, but not yet processed by poll_cb).	1569	(executed, but not yet processed by poll_cb).
1543		1570
1544	MISCELLANEOUS FUNCTIONS	1571	MISCELLANEOUS FUNCTIONS
1545	IO::AIO implements some functions that might be useful, but are not	1572	IO::AIO implements some functions that are useful when you want to use
1546	asynchronous.	1573	some "Advanced I/O" function not available to in Perl, without going the
		1574	"Asynchronous I/O" route. Many of these have an asynchronous "aio_*"
		1575	counterpart.
1547		1576
1548	IO::AIO::sendfile $ofh, $ifh, $offset, $count	1577	IO::AIO::sendfile $ofh, $ifh, $offset, $count
1549	Calls the "eio_sendfile_sync" function, which is like	1578	Calls the "eio_sendfile_sync" function, which is like
1550	"aio_sendfile", but is blocking (this makes most sense if you know	1579	"aio_sendfile", but is blocking (this makes most sense if you know
1551	the input data is likely cached already and the output filehandle is	1580	the input data is likely cached already and the output filehandle is
…		…
1607	"IO::AIO::PROT_EXEC", "IO::AIO::PROT_READ" and/or	1636	"IO::AIO::PROT_EXEC", "IO::AIO::PROT_READ" and/or
1608	"IO::AIO::PROT_WRITE",	1637	"IO::AIO::PROT_WRITE",
1609		1638
1610	$flags can be a combination of "IO::AIO::MAP_SHARED" or	1639	$flags can be a combination of "IO::AIO::MAP_SHARED" or
1611	"IO::AIO::MAP_PRIVATE", or a number of system-specific flags (when	1640	"IO::AIO::MAP_PRIVATE", or a number of system-specific flags (when
1612	not available, the are defined as 0): "IO::AIO::MAP_ANONYMOUS"	1641	not available, the are 0): "IO::AIO::MAP_ANONYMOUS" (which is set to
1613	(which is set to "MAP_ANON" if your system only provides this	1642	"MAP_ANON" if your system only provides this constant),
1614	constant), "IO::AIO::MAP_HUGETLB", "IO::AIO::MAP_LOCKED",	1643	"IO::AIO::MAP_HUGETLB", "IO::AIO::MAP_LOCKED",
1615	"IO::AIO::MAP_NORESERVE", "IO::AIO::MAP_POPULATE" or	1644	"IO::AIO::MAP_NORESERVE", "IO::AIO::MAP_POPULATE",
1616	"IO::AIO::MAP_NONBLOCK"	1645	"IO::AIO::MAP_NONBLOCK", "IO::AIO::MAP_FIXED",
		1646	"IO::AIO::MAP_GROWSDOWN", "IO::AIO::MAP_32BIT",
		1647	"IO::AIO::MAP_HUGETLB" or "IO::AIO::MAP_STACK".
1617		1648
1618	If $fh is "undef", then a file descriptor of -1 is passed.	1649	If $fh is "undef", then a file descriptor of -1 is passed.
1619		1650
1620	$offset is the offset from the start of the file - it generally must	1651	$offset is the offset from the start of the file - it generally must
1621	be a multiple of "IO::AIO::PAGESIZE" and defaults to 0.	1652	be a multiple of "IO::AIO::PAGESIZE" and defaults to 0.
…		…
1659	"IO::AIO::SPLICE_F_MORE" and "IO::AIO::SPLICE_F_GIFT".	1690	"IO::AIO::SPLICE_F_MORE" and "IO::AIO::SPLICE_F_GIFT".
1660		1691
1661	See the splice(2) manpage for details.	1692	See the splice(2) manpage for details.
1662		1693
1663	IO::AIO::tee $r_fh, $w_fh, $length, $flags	1694	IO::AIO::tee $r_fh, $w_fh, $length, $flags
1664	Calls the GNU/Linux tee(2) syscall, see it's manpage and the	1695	Calls the GNU/Linux tee(2) syscall, see its manpage and the
1665	description for "IO::AIO::splice" above for details.	1696	description for "IO::AIO::splice" above for details.
		1697
		1698	$actual_size = IO::AIO::pipesize $r_fh[, $new_size]
		1699	Attempts to query or change the pipe buffer size. Obviously works
		1700	only on pipes, and currently works only on GNU/Linux systems, and
		1701	fails with -1/"ENOSYS" everywhere else. If anybody knows how to
		1702	influence pipe buffer size on other systems, drop me a note.
		1703
		1704	($rfh, $wfh) = IO::AIO::pipe2 [$flags]
		1705	This is a direct interface to the Linux pipe2(2) system call. If
		1706	$flags is missing or 0, then this should be the same as a call to
		1707	perl's built-in "pipe" function and create a new pipe, and works on
		1708	systems that lack the pipe2 syscall. On win32, this case invokes
		1709	"_pipe (..., 4096, O_BINARY)".
		1710
		1711	If $flags is non-zero, it tries to invoke the pipe2 system call with
		1712	the given flags (Linux 2.6.27, glibc 2.9).
		1713
		1714	On success, the read and write file handles are returned.
		1715
		1716	On error, nothing will be returned. If the pipe2 syscall is missing
		1717	and $flags is non-zero, fails with "ENOSYS".
		1718
		1719	Please refer to pipe2(2) for more info on the $flags, but at the
		1720	time of this writing, "IO::AIO::O_CLOEXEC", "IO::AIO::O_NONBLOCK"
		1721	and "IO::AIO::O_DIRECT" (Linux 3.4, for packet-based pipes) were
		1722	supported.
1666		1723
1667	EVENT LOOP INTEGRATION	1724	EVENT LOOP INTEGRATION
1668	It is recommended to use AnyEvent::AIO to integrate IO::AIO	1725	It is recommended to use AnyEvent::AIO to integrate IO::AIO
1669	automatically into many event loops:	1726	automatically into many event loops:
1670		1727

Diff Legend

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

Comparing IO-AIO/README (file contents): Revision 1.53 by root, Thu Oct 11 03:20:52 2012 UTC vs. Revision 1.57 by root, Mon Jan 18 11:53:09 2016 UTC

Diff Legend

Comparing IO-AIO/README (file contents):
Revision 1.53 by root, Thu Oct 11 03:20:52 2012 UTC vs.
Revision 1.57 by root, Mon Jan 18 11:53:09 2016 UTC