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

Comparing IO-AIO/AIO.pm (file contents):
Revision 1.219 by root, Tue Mar 27 18:54:45 2012 UTC vs.
Revision 1.229 by root, Wed Jul 25 16:32:30 2012 UTC

…		…
168	use common::sense;	168	use common::sense;
169		169
170	use base 'Exporter';	170	use base 'Exporter';
171		171
172	BEGIN {	172	BEGIN {
173	our $VERSION = '4.12';	173	our $VERSION = '4.15';
174		174
175	our @AIO_REQ = qw(aio_sendfile aio_read aio_write aio_open aio_close	175	our @AIO_REQ = qw(aio_sendfile aio_seek aio_read aio_write aio_open aio_close
176	aio_stat aio_lstat aio_unlink aio_rmdir aio_readdir aio_readdirx	176	aio_stat aio_lstat aio_unlink aio_rmdir aio_readdir aio_readdirx
177	aio_scandir aio_symlink aio_readlink aio_realpath aio_sync	177	aio_scandir aio_symlink aio_readlink aio_realpath aio_sync
178	aio_fsync aio_syncfs aio_fdatasync aio_sync_file_range aio_fallocate	178	aio_fsync aio_syncfs aio_fdatasync aio_sync_file_range aio_fallocate
179	aio_pathsync aio_readahead	179	aio_pathsync aio_readahead aio_fiemap
180	aio_rename aio_link aio_move aio_copy aio_group	180	aio_rename aio_link aio_move aio_copy aio_group
181	aio_nop aio_mknod aio_load aio_rmtree aio_mkdir aio_chown	181	aio_nop aio_mknod aio_load aio_rmtree aio_mkdir aio_chown
182	aio_chmod aio_utime aio_truncate	182	aio_chmod aio_utime aio_truncate
183	aio_msync aio_mtouch aio_mlock aio_mlockall	183	aio_msync aio_mtouch aio_mlock aio_mlockall
184	aio_statvfs	184	aio_statvfs
…		…
209	documentation.	209	documentation.
210		210
211	aio_wd $pathname, $callback->($wd)	211	aio_wd $pathname, $callback->($wd)
212	aio_open $pathname, $flags, $mode, $callback->($fh)	212	aio_open $pathname, $flags, $mode, $callback->($fh)
213	aio_close $fh, $callback->($status)	213	aio_close $fh, $callback->($status)
		214	aio_seek $fh,$offset,$whence, $callback->($offs)
214	aio_read $fh,$offset,$length, $data,$dataoffset, $callback->($retval)	215	aio_read $fh,$offset,$length, $data,$dataoffset, $callback->($retval)
215	aio_write $fh,$offset,$length, $data,$dataoffset, $callback->($retval)	216	aio_write $fh,$offset,$length, $data,$dataoffset, $callback->($retval)
216	aio_sendfile $out_fh, $in_fh, $in_offset, $length, $callback->($retval)	217	aio_sendfile $out_fh, $in_fh, $in_offset, $length, $callback->($retval)
217	aio_readahead $fh,$offset,$length, $callback->($retval)	218	aio_readahead $fh,$offset,$length, $callback->($retval)
218	aio_stat $fh_or_path, $callback->($status)	219	aio_stat $fh_or_path, $callback->($status)
219	aio_lstat $fh, $callback->($status)	220	aio_lstat $fh, $callback->($status)
220	aio_statvfs $fh_or_path, $callback->($statvfs)	221	aio_statvfs $fh_or_path, $callback->($statvfs)
221	aio_utime $fh_or_path, $atime, $mtime, $callback->($status)	222	aio_utime $fh_or_path, $atime, $mtime, $callback->($status)
222	aio_chown $fh_or_path, $uid, $gid, $callback->($status)	223	aio_chown $fh_or_path, $uid, $gid, $callback->($status)
		224	aio_chmod $fh_or_path, $mode, $callback->($status)
223	aio_truncate $fh_or_path, $offset, $callback->($status)	225	aio_truncate $fh_or_path, $offset, $callback->($status)
224	aio_chmod $fh_or_path, $mode, $callback->($status)	226	aio_allocate $fh, $mode, $offset, $len, $callback->($status)
225	aio_unlink $pathname, $callback->($status)	227	aio_unlink $pathname, $callback->($status)
226	aio_mknod $pathname, $mode, $dev, $callback->($status)	228	aio_mknod $pathname, $mode, $dev, $callback->($status)
227	aio_link $srcpath, $dstpath, $callback->($status)	229	aio_link $srcpath, $dstpath, $callback->($status)
228	aio_symlink $srcpath, $dstpath, $callback->($status)	230	aio_symlink $srcpath, $dstpath, $callback->($status)
229	aio_readlink $pathname, $callback->($link)	231	aio_readlink $pathname, $callback->($link)
…		…
271	IO::AIO::nready	273	IO::AIO::nready
272	IO::AIO::npending	274	IO::AIO::npending
273		275
274	IO::AIO::sendfile $ofh, $ifh, $offset, $count	276	IO::AIO::sendfile $ofh, $ifh, $offset, $count
275	IO::AIO::fadvise $fh, $offset, $len, $advice	277	IO::AIO::fadvise $fh, $offset, $len, $advice
		278	IO::AIO::mmap $scalar, $length, $prot, $flags[, $fh[, $offset]]
		279	IO::AIO::munmap $scalar
276	IO::AIO::madvise $scalar, $offset, $length, $advice	280	IO::AIO::madvise $scalar, $offset, $length, $advice
277	IO::AIO::mprotect $scalar, $offset, $length, $protect	281	IO::AIO::mprotect $scalar, $offset, $length, $protect
278	IO::AIO::munlock $scalar, $offset = 0, $length = undef	282	IO::AIO::munlock $scalar, $offset = 0, $length = undef
279	IO::AIO::munlockall	283	IO::AIO::munlockall
280		284
…		…
409		413
410	Or in other words: the file descriptor will be closed, but it will not be	414	Or in other words: the file descriptor will be closed, but it will not be
411	free for reuse until the perl filehandle is closed.	415	free for reuse until the perl filehandle is closed.
412		416
413	=cut	417	=cut
		418
		419	=item aio_seek $fh, $offset, $whence, $callback->($offs)
		420
		421	Seeks the filehandle to the new C<$offset>, similarly to perl's
		422	C<sysseek>. The C<$whence> can use the traditional values (C<0> for
		423	C<IO::AIO::SEEK_SET>, C<1> for C<IO::AIO::SEEK_CUR> or C<2> for
		424	C<IO::AIO::SEEK_END>).
		425
		426	The resulting absolute offset will be passed to the callback, or C<-1> in
		427	case of an error.
		428
		429	In theory, the C<$whence> constants could be different than the
		430	corresponding values from L<Fcntl>, but perl guarantees they are the same,
		431	so don't panic.
		432
		433	As a GNU/Linux (and maybe Solaris) extension, also the constants
		434	C<IO::AIO::SEEK_DATA> and C<IO::AIO::SEEK_HOLE> are available, if they
		435	could be found. No guarantees about suitability for use in C<aio_seek> or
		436	Perl's C<sysseek> can be made though, although I would naively assume they
		437	"just work".
414		438
415	=item aio_read $fh,$offset,$length, $data,$dataoffset, $callback->($retval)	439	=item aio_read $fh,$offset,$length, $data,$dataoffset, $callback->($retval)
416		440
417	=item aio_write $fh,$offset,$length, $data,$dataoffset, $callback->($retval)	441	=item aio_write $fh,$offset,$length, $data,$dataoffset, $callback->($retval)
418		442
…		…
613		637
614		638
615	=item aio_truncate $fh_or_path, $offset, $callback->($status)	639	=item aio_truncate $fh_or_path, $offset, $callback->($status)
616		640
617	Works like truncate(2) or ftruncate(2).	641	Works like truncate(2) or ftruncate(2).
		642
		643
		644	=item aio_allocate $fh, $mode, $offset, $len, $callback->($status)
		645
		646	Allocates or freed disk space according to the C<$mode> argument. See the
		647	linux C<fallocate> docuemntation for details.
		648
		649	C<$mode> can currently be C<0> or C<IO::AIO::FALLOC_FL_KEEP_SIZE>
		650	to allocate space, or C<IO::AIO::FALLOC_FL_PUNCH_HOLE \|
		651	IO::AIO::FALLOC_FL_KEEP_SIZE>, to deallocate a file range.
		652
		653	The file system block size used by C<fallocate> is presumably the
		654	C<f_bsize> returned by C<statvfs>.
		655
		656	If C<fallocate> isn't available or cannot be emulated (currently no
		657	emulation will be attempted), passes C<-1> and sets C<$!> to C<ENOSYS>.
618		658
619		659
620	=item aio_chmod $fh_or_path, $mode, $callback->($status)	660	=item aio_chmod $fh_or_path, $mode, $callback->($status)
621		661
622	Works like perl's C<chmod> function.	662	Works like perl's C<chmod> function.
…		…
1234		1274
1235	Example: asynchronously lock all current and future pages into memory.	1275	Example: asynchronously lock all current and future pages into memory.
1236		1276
1237	aio_mlockall IO::AIO::MCL_FUTURE;	1277	aio_mlockall IO::AIO::MCL_FUTURE;
1238		1278
		1279	=item aio_fiemap $fh, $start, $length, $flags, $count, $cb->(\@extents)
		1280
		1281	Queries the extents of the given file (by calling the Linux FIEMAP ioctl,
		1282	see L<http://cvs.schmorp.de/IO-AIO/doc/fiemap.txt> for details). If the
		1283	C<ioctl> is not available on your OS, then this rquiest will fail with
		1284	C<ENOSYS>.
		1285
		1286	C<$start> is the starting offset to query extents for, C<$length> is the
		1287	size of the range to query - if it is C<undef>, then the whole file will
		1288	be queried.
		1289
		1290	C<$flags> is a combination of flags (C<IO::AIO::FIEMAP_FLAG_SYNC> or
		1291	C<IO::AIO::FIEMAP_FLAG_XATTR> - C<IO::AIO::FIEMAP_FLAGS_COMPAT> is also
		1292	exported), and is normally C<0> or C<IO::AIO::FIEMAP_FLAG_SYNC> to query
		1293	the data portion.
		1294
		1295	C<$count> is the maximum number of extent records to return. If it is
		1296	C<undef>, then IO::AIO queries all extents of the file. As a very special
		1297	case, if it is C<0>, then the callback receives the number of extents
		1298	instead of the extents themselves.
		1299
		1300	If an error occurs, the callback receives no arguments. The special
		1301	C<errno> value C<IO::AIO::EBADR> is available to test for flag errors.
		1302
		1303	Otherwise, the callback receives an array reference with extent
		1304	structures. Each extent structure is an array reference itself, with the
		1305	following members:
		1306
		1307	[$logical, $physical, $length, $flags]
		1308
		1309	Flags is any combination of the following flag values (typically either C<0>
		1310	or C<IO::AIO::FIEMAP_EXTENT_LAST>):
		1311
		1312	C<IO::AIO::FIEMAP_EXTENT_LAST>, C<IO::AIO::FIEMAP_EXTENT_UNKNOWN>,
		1313	C<IO::AIO::FIEMAP_EXTENT_DELALLOC>, C<IO::AIO::FIEMAP_EXTENT_ENCODED>,
		1314	C<IO::AIO::FIEMAP_EXTENT_DATA_ENCRYPTED>, C<IO::AIO::FIEMAP_EXTENT_NOT_ALIGNED>,
		1315	C<IO::AIO::FIEMAP_EXTENT_DATA_INLINE>, C<IO::AIO::FIEMAP_EXTENT_DATA_TAIL>,
		1316	C<IO::AIO::FIEMAP_EXTENT_UNWRITTEN>, C<IO::AIO::FIEMAP_EXTENT_MERGED> or
		1317	C<IO::AIO::FIEMAP_EXTENT_SHARED>.
		1318
1239	=item aio_group $callback->(...)	1319	=item aio_group $callback->(...)
1240		1320
1241	This is a very special aio request: Instead of doing something, it is a	1321	This is a very special aio request: Instead of doing something, it is a
1242	container for other aio requests, which is useful if you want to bundle	1322	container for other aio requests, which is useful if you want to bundle
1243	many requests into a single, composite, request with a definite callback	1323	many requests into a single, composite, request with a definite callback
…		…
1845	ENOSYS, otherwise the return value of C<mprotect>.	1925	ENOSYS, otherwise the return value of C<mprotect>.
1846		1926
1847	=item IO::AIO::mmap $scalar, $length, $prot, $flags, $fh[, $offset]	1927	=item IO::AIO::mmap $scalar, $length, $prot, $flags, $fh[, $offset]
1848		1928
1849	Memory-maps a file (or anonymous memory range) and attaches it to the	1929	Memory-maps a file (or anonymous memory range) and attaches it to the
1850	given C<$scalar>, which will act like a string scalar.	1930	given C<$scalar>, which will act like a string scalar. Returns true on
		1931	success, and false otherwise.
1851		1932
1852	The only operations allowed on the scalar are C<substr>/C<vec> that don't	1933	The only operations allowed on the scalar are C<substr>/C<vec> that don't
1853	change the string length, and most read-only operations such as copying it	1934	change the string length, and most read-only operations such as copying it
1854	or searching it with regexes and so on.	1935	or searching it with regexes and so on.
1855		1936
…		…
1908	Calls the C<munlockall> function.	1989	Calls the C<munlockall> function.
1909		1990
1910	On systems that do not implement C<munlockall>, this function returns	1991	On systems that do not implement C<munlockall>, this function returns
1911	ENOSYS, otherwise the return value of C<munlockall>.	1992	ENOSYS, otherwise the return value of C<munlockall>.
1912		1993
		1994	=item IO::AIO::splice $r_fh, $r_off, $w_fh, $w_off, $length, $flags
		1995
		1996	Calls the GNU/Linux C<splice(2)> syscall, if available. If C<$r_off> or
		1997	C<$w_off> are C<undef>, then C<NULL> is passed for these, otherwise they
		1998	should be the file offset.
		1999
		2000	C<$r_fh> and C<$w_fh> should not refer to the same file, as splice might
		2001	silently corrupt the data in this case.
		2002
		2003	The following symbol flag values are available: C<IO::AIO::SPLICE_F_MOVE>,
		2004	C<IO::AIO::SPLICE_F_NONBLOCK>, C<IO::AIO::SPLICE_F_MORE> and
		2005	C<IO::AIO::SPLICE_F_GIFT>.
		2006
		2007	See the C<splice(2)> manpage for details.
		2008
		2009	=item IO::AIO::tee $r_fh, $w_fh, $length, $flags
		2010
		2011	Calls the GNU/Linux C<tee(2)> syscall, see it's manpage and the
		2012	description for C<IO::AIO::splice> above for details.
		2013
1913	=back	2014	=back
1914		2015
1915	=cut	2016	=cut
1916		2017
1917	min_parallel 8;	2018	min_parallel 8;

Diff Legend

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

Comparing IO-AIO/AIO.pm (file contents): Revision 1.219 by root, Tue Mar 27 18:54:45 2012 UTC vs. Revision 1.229 by root, Wed Jul 25 16:32:30 2012 UTC

Diff Legend

Comparing IO-AIO/AIO.pm (file contents):
Revision 1.219 by root, Tue Mar 27 18:54:45 2012 UTC vs.
Revision 1.229 by root, Wed Jul 25 16:32:30 2012 UTC