[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.227 by root, Tue May 29 03:58:02 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)
225	aio_unlink $pathname, $callback->($status)	226	aio_unlink $pathname, $callback->($status)
226	aio_mknod $pathname, $mode, $dev, $callback->($status)	227	aio_mknod $pathname, $mode, $dev, $callback->($status)
227	aio_link $srcpath, $dstpath, $callback->($status)	228	aio_link $srcpath, $dstpath, $callback->($status)
228	aio_symlink $srcpath, $dstpath, $callback->($status)	229	aio_symlink $srcpath, $dstpath, $callback->($status)
229	aio_readlink $pathname, $callback->($link)	230	aio_readlink $pathname, $callback->($link)
…		…
271	IO::AIO::nready	272	IO::AIO::nready
272	IO::AIO::npending	273	IO::AIO::npending
273		274
274	IO::AIO::sendfile $ofh, $ifh, $offset, $count	275	IO::AIO::sendfile $ofh, $ifh, $offset, $count
275	IO::AIO::fadvise $fh, $offset, $len, $advice	276	IO::AIO::fadvise $fh, $offset, $len, $advice
		277	IO::AIO::mmap $scalar, $length, $prot, $flags[, $fh[, $offset]]
		278	IO::AIO::munmap $scalar
276	IO::AIO::madvise $scalar, $offset, $length, $advice	279	IO::AIO::madvise $scalar, $offset, $length, $advice
277	IO::AIO::mprotect $scalar, $offset, $length, $protect	280	IO::AIO::mprotect $scalar, $offset, $length, $protect
278	IO::AIO::munlock $scalar, $offset = 0, $length = undef	281	IO::AIO::munlock $scalar, $offset = 0, $length = undef
279	IO::AIO::munlockall	282	IO::AIO::munlockall
280		283
…		…
409		412
410	Or in other words: the file descriptor will be closed, but it will not be	413	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.	414	free for reuse until the perl filehandle is closed.
412		415
413	=cut	416	=cut
		417
		418	=item aio_seek $fh, $offset, $whence, $callback->($offs)
		419
		420	Seeks the filehandle to the new C<$offset>, similarly to perl's
		421	C<sysseek>. The C<$whence> can use the traditional values (C<0> for
		422	C<IO::AIO::SEEK_SET>, C<1> for C<IO::AIO::SEEK_CUR> or C<2> for
		423	C<IO::AIO::SEEK_END>).
		424
		425	The resulting absolute offset will be passed to the callback, or C<-1> in
		426	case of an error.
		427
		428	In theory, the C<$whence> constants could be different than the
		429	corresponding values from L<Fcntl>, but perl guarantees they are the same,
		430	so don't panic.
		431
		432	As a GNU/Linux (and maybe Solaris) extension, also the constants
		433	C<IO::AIO::SEEK_DATA> and C<IO::AIO::SEEK_HOLE> are available, if they
		434	could be found. No guarantees about suitability for use in C<aio_seek> or
		435	Perl's C<sysseek> can be made though, although I would naively assume they
		436	"just work".
414		437
415	=item aio_read $fh,$offset,$length, $data,$dataoffset, $callback->($retval)	438	=item aio_read $fh,$offset,$length, $data,$dataoffset, $callback->($retval)
416		439
417	=item aio_write $fh,$offset,$length, $data,$dataoffset, $callback->($retval)	440	=item aio_write $fh,$offset,$length, $data,$dataoffset, $callback->($retval)
418		441
…		…
1234		1257
1235	Example: asynchronously lock all current and future pages into memory.	1258	Example: asynchronously lock all current and future pages into memory.
1236		1259
1237	aio_mlockall IO::AIO::MCL_FUTURE;	1260	aio_mlockall IO::AIO::MCL_FUTURE;
1238		1261
		1262	=item aio_fiemap $fh, $start, $length, $flags, $count, $cb->(\@extents)
		1263
		1264	Queries the extents of the given file (by calling the Linux FIEMAP ioctl,
		1265	see L<http://cvs.schmorp.de/IO-AIO/doc/fiemap.txt> for details). If the
		1266	C<ioctl> is not available on your OS, then this rquiest will fail with
		1267	C<ENOSYS>.
		1268
		1269	C<$start> is the starting offset to query extents for, C<$length> is the
		1270	size of the range to query - if it is C<undef>, then the whole file will
		1271	be queried.
		1272
		1273	C<$flags> is a combination of flags (C<IO::AIO::FIEMAP_FLAG_SYNC> or
		1274	C<IO::AIO::FIEMAP_FLAG_XATTR> - C<IO::AIO::FIEMAP_FLAGS_COMPAT> is also
		1275	exported), and is normally C<0> or C<IO::AIO::FIEMAP_FLAG_SYNC> to query
		1276	the data portion.
		1277
		1278	C<$count> is the maximum number of extent records to return. If it is
		1279	C<undef>, then IO::AIO queries all extents of the file. As a very special
		1280	case, if it is C<0>, then the callback receives the number of extents
		1281	instead of the extents themselves.
		1282
		1283	If an error occurs, the callback receives no arguments. The special
		1284	C<errno> value C<IO::AIO::EBADR> is available to test for flag errors.
		1285
		1286	Otherwise, the callback receives an array reference with extent
		1287	structures. Each extent structure is an array reference itself, with the
		1288	following members:
		1289
		1290	[$logical, $physical, $length, $flags]
		1291
		1292	Flags is any combination of the following flag values (typically either C<0>
		1293	or C<IO::AIO::FIEMAP_EXTENT_LAST>):
		1294
		1295	C<IO::AIO::FIEMAP_EXTENT_LAST>, C<IO::AIO::FIEMAP_EXTENT_UNKNOWN>,
		1296	C<IO::AIO::FIEMAP_EXTENT_DELALLOC>, C<IO::AIO::FIEMAP_EXTENT_ENCODED>,
		1297	C<IO::AIO::FIEMAP_EXTENT_DATA_ENCRYPTED>, C<IO::AIO::FIEMAP_EXTENT_NOT_ALIGNED>,
		1298	C<IO::AIO::FIEMAP_EXTENT_DATA_INLINE>, C<IO::AIO::FIEMAP_EXTENT_DATA_TAIL>,
		1299	C<IO::AIO::FIEMAP_EXTENT_UNWRITTEN>, C<IO::AIO::FIEMAP_EXTENT_MERGED> or
		1300	C<IO::AIO::FIEMAP_EXTENT_SHARED>.
		1301
1239	=item aio_group $callback->(...)	1302	=item aio_group $callback->(...)
1240		1303
1241	This is a very special aio request: Instead of doing something, it is a	1304	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	1305	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	1306	many requests into a single, composite, request with a definite callback
…		…
1908	Calls the C<munlockall> function.	1971	Calls the C<munlockall> function.
1909		1972
1910	On systems that do not implement C<munlockall>, this function returns	1973	On systems that do not implement C<munlockall>, this function returns
1911	ENOSYS, otherwise the return value of C<munlockall>.	1974	ENOSYS, otherwise the return value of C<munlockall>.
1912		1975
		1976	=item IO::AIO::splice $r_fh, $r_off, $w_fh, $w_off, $length, $flags
		1977
		1978	Calls the GNU/Linux C<splice(2)> syscall, if available. If C<$r_off> or
		1979	C<$w_off> are C<undef>, then C<NULL> is passed for these, otherwise they
		1980	should be the file offset.
		1981
		1982	C<$r_fh> and C<$w_fh> should not refer to the same file, as splice might
		1983	silently corrupt the data in this case.
		1984
		1985	The following symbol flag values are available: C<IO::AIO::SPLICE_F_MOVE>,
		1986	C<IO::AIO::SPLICE_F_NONBLOCK>, C<IO::AIO::SPLICE_F_MORE> and
		1987	C<IO::AIO::SPLICE_F_GIFT>.
		1988
		1989	See the C<splice(2)> manpage for details.
		1990
		1991	=item IO::AIO::tee $r_fh, $w_fh, $length, $flags
		1992
		1993	Calls the GNU/Linux C<tee(2)> syscall, see it's manpage and the
		1994	description for C<IO::AIO::splice> above for details.
		1995
1913	=back	1996	=back
1914		1997
1915	=cut	1998	=cut
1916		1999
1917	min_parallel 8;	2000	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.227 by root, Tue May 29 03:58:02 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.227 by root, Tue May 29 03:58:02 2012 UTC