[ViewVC] Diff of: cvs/Convert-UUlib/UUlib.pm

Comparing Convert-UUlib/UUlib.pm (file contents):
Revision 1.15 by root, Tue Oct 15 23:35:31 2002 UTC vs.
Revision 1.55 by root, Sun Dec 13 06:36:09 2020 UTC

…		…
1	package Convert::UUlib;	1	package Convert::UUlib;
		2
		3	use common::sense;
2		4
3	use Carp;	5	use Carp;
4		6
5	require Exporter;	7	require Exporter;
6	require DynaLoader;	8	require DynaLoader;
7		9
8	$VERSION = 0.31;	10	our $VERSION = 1.71;
9		11
10	@ISA = qw(Exporter DynaLoader);	12	our @ISA = qw(Exporter DynaLoader);
11		13
12	@_consts = qw(	14	our @_consts = qw(
13	ACT_COPYING ACT_DECODING ACT_ENCODING ACT_IDLE ACT_SCANNING	15	ACT_COPYING ACT_DECODING ACT_ENCODING ACT_IDLE ACT_SCANNING
14		16
15	FILE_DECODED FILE_ERROR FILE_MISPART FILE_NOBEGIN FILE_NODATA	17	FILE_DECODED FILE_ERROR FILE_MISPART FILE_NOBEGIN FILE_NODATA
16	FILE_NOEND FILE_OK FILE_READ FILE_TMPFILE	18	FILE_NOEND FILE_OK FILE_READ FILE_TMPFILE
17		19
18	MSG_ERROR MSG_FATAL MSG_MESSAGE MSG_NOTE MSG_PANIC MSG_WARNING	20	MSG_ERROR MSG_FATAL MSG_MESSAGE MSG_NOTE MSG_PANIC MSG_WARNING
19		21
		22	OPT_RBUF OPT_WBUF
20	OPT_BRACKPOL OPT_DEBUG OPT_DESPERATE OPT_DUMBNESS OPT_ENCEXT	23	OPT_BRACKPOL OPT_DEBUG OPT_DESPERATE OPT_DUMBNESS OPT_ENCEXT
21	OPT_ERRNO OPT_FAST OPT_IGNMODE OPT_IGNREPLY OPT_OVERWRITE OPT_PREAMB	24	OPT_ERRNO OPT_FAST OPT_IGNMODE OPT_IGNREPLY OPT_OVERWRITE OPT_PREAMB
22	OPT_PROGRESS OPT_SAVEPATH OPT_TINYB64 OPT_USETEXT OPT_VERBOSE	25	OPT_PROGRESS OPT_SAVEPATH OPT_TINYB64 OPT_USETEXT OPT_VERBOSE
23	OPT_VERSION OPT_REMOVE OPT_MOREMIME OPT_DOTDOT	26	OPT_VERSION OPT_REMOVE OPT_MOREMIME OPT_DOTDOT OPT_AUTOCHECK
24		27
25	RET_CANCEL RET_CONT RET_EXISTS RET_ILLVAL RET_IOERR RET_NODATA	28	RET_CANCEL RET_CONT RET_EXISTS RET_ILLVAL RET_IOERR RET_NODATA
26	RET_NOEND RET_NOMEM RET_OK RET_UNSUP	29	RET_NOEND RET_NOMEM RET_OK RET_UNSUP
27		30
28	B64_ENCODED BH_ENCODED PT_ENCODED QP_ENCODED	31	B64_ENCODED BH_ENCODED PT_ENCODED QP_ENCODED
29	XX_ENCODED UU_ENCODED YENC_ENCODED	32	XX_ENCODED UU_ENCODED YENC_ENCODED
30	);	33	);
31		34
32	@_funcs = qw(	35	our @_funcs = qw(
33	Initialize CleanUp GetOption SetOption strerror SetMsgCallback	36	Initialize CleanUp GetOption SetOption strerror SetMsgCallback
34	SetBusyCallback SetFileCallback SetFNameFilter SetFileNameCallback	37	SetBusyCallback SetFileCallback SetFNameFilter SetFileNameCallback
35	FNameFilter LoadFile GetFileListItem RenameFile DecodeToTemp	38	FNameFilter LoadFile GetFileListItem GetFileList RenameFile DecodeToTemp
36	RemoveTemp DecodeFile InfoFile Smerge QuickDecode EncodeMulti	39	RemoveTemp DecodeFile InfoFile Smerge QuickDecode EncodeMulti
37	EncodePartial EncodeToStream EncodeToFile E_PrepSingle	40	EncodePartial EncodeToStream EncodeToFile E_PrepSingle
38	E_PrepPartial	41	E_PrepPartial
39		42
40	straction strencoding strmsglevel	43	straction strencoding strmsglevel
41	);	44	);
42		45
43	@EXPORT = @_consts;	46	our @EXPORT = @_consts;
44	@EXPORT_OK = @_funcs;	47	our @EXPORT_OK = @_funcs;
45	%EXPORT_TAGS = (all => [@_consts,@_funcs], constants => \@_consts);	48	our %EXPORT_TAGS = (all => [@_consts,@_funcs], constants => \@_consts);
46		49
47	bootstrap Convert::UUlib $VERSION;	50	bootstrap Convert::UUlib $VERSION;
48		51
49	Initialize();	52	# dummy function for compatiiblity with pre-1.7 versions
50		53	sub Initialize { }
51	# not when < 5.005_6x
52	# END { CleanUp() }
53
54	for (@_consts) {
55	my $constant = constant($_);
56	*$_ = sub () { $constant };
57	}
58		54
59	# action code -> string mapping	55	# action code -> string mapping
60	sub straction($) {	56	sub straction($) {
61	return 'copying' if $_[0] == &ACT_COPYING;	57	return 'copying' if $_[0] == &ACT_COPYING;
62	return 'decoding' if $_[0] == &ACT_DECODING;	58	return 'decoding' if $_[0] == &ACT_DECODING;
91	1;	87	1;
92	__END__	88	__END__
93		89
94	=head1 NAME	90	=head1 NAME
95		91
96	Convert::UUlib - Perl interface to the uulib library (a.k.a. uudeview/uuenview).	92	Convert::UUlib - decode uu/xx/b64/mime/yenc/etc-encoded data from a massive number of files
97		93
98	=head1 SYNOPSIS	94	=head1 SYNOPSIS
99		95
100	use Convert::UUlib ':all';	96	use Convert::UUlib ':all';
101		97
102	# read all the files named on the commandline and decode them	98	# read all the files named on the commandline and decode them
103	# into the CURRENT directory. See below for a longer example.	99	# into the CURRENT directory. See below for a longer example.
104	LoadFile $_ for @ARGV;	100	LoadFile $_ for @ARGV;
105	for (my $i = 0; my $uu = GetFileListItem $i; $i++) {	101
		102	for my $uu (GetFileList) {
106	if ($uu->state & FILE_OK) {	103	if ($uu->state & FILE_OK) {
107	$uu->decode;	104	$uu->decode;
108	print $uu->filename, "\n";	105	print $uu->filename, "\n";
109	}	106	}
110	}	107	}
111		108
112	=head1 DESCRIPTION	109	=head1 DESCRIPTION
		110
		111	This module started as an interface to the uulib/uudeview library by Frank
		112	Pilhofer that can be used to decode all kinds of usenet (and other)
		113	binary messages.
		114
		115	After upstream abondoned the project, th library was continuously bugfixed
		116	and improved in this module, with major focuses on security fixes,
		117	correctness and speed (that does not mean that this library is considered
		118	safe with untrusted data, but it surely is safer than the poriginal
		119	uudeview).
113		120
114	Read the file doc/library.pdf from the distribution for in-depth	121	Read the file doc/library.pdf from the distribution for in-depth
115	information about the C-library used in this interface, and the rest of	122	information about the C-library used in this interface, and the rest of
116	this document and especially the non-trivial decoder program at the end.	123	this document and especially the non-trivial decoder program at the end.
117		124
…		…
154	OPT_TINYB64 detect short B64 outside of Mime	161	OPT_TINYB64 detect short B64 outside of Mime
155	OPT_ENCEXT extension for single-part encoded files	162	OPT_ENCEXT extension for single-part encoded files
156	OPT_REMOVE remove input files after decoding (dangerous)	163	OPT_REMOVE remove input files after decoding (dangerous)
157	OPT_MOREMIME strict MIME adherence	164	OPT_MOREMIME strict MIME adherence
158	OPT_DOTDOT ".."-unescaping has not yet been done on input files	165	OPT_DOTDOT ".."-unescaping has not yet been done on input files
		166	OPT_RBUF set default read I/O buffer size in bytes
		167	OPT_WBUF set default write I/O buffer size in bytes
		168	OPT_AUTOCHECK automatically check file list after every loadfile
159		169
160	=head2 Result/Error codes	170	=head2 Result/Error codes
161		171
162	RET_OK everything went fine	172	RET_OK everything went fine
163	RET_IOERR I/O Error - examine errno	173	RET_IOERR I/O Error - examine errno
…		…
206	again.	216	again.
207		217
208	On my machine, a fairly complete decode with DBI backend needs about 10MB	218	On my machine, a fairly complete decode with DBI backend needs about 10MB
209	RSS to decode 20000 files.	219	RSS to decode 20000 files.
210		220
211	=over 4	221	=over
212
213	=item Initialize
214
215	Not normally necessary, (re-)initializes the library.
216		222
217	=item CleanUp	223	=item CleanUp
218		224
219	Not normally necessary, could be called at the end to release memory	225	Release memory, file items and clean up files. Should be called after a
220	before starting a new decoding round.	226	decoidng run, if you want to start a new one.
221		227
222	=back	228	=back
223		229
224	=head2 Setting and querying options	230	=head2 Setting and querying options
225		231
226	=over 4	232	=over
227		233
228	=item $option = GetOption OPT_xxx	234	=item $option = GetOption OPT_xxx
229		235
230	=item SetOption OPT_xxx, opt-value	236	=item SetOption OPT_xxx, opt-value
231		237
…		…
233		239
234	See the C<OPT_xxx> constants above to see which options exist.	240	See the C<OPT_xxx> constants above to see which options exist.
235		241
236	=head2 Setting various callbacks	242	=head2 Setting various callbacks
237		243
238	=over 4	244	=over
239		245
240	=item SetMsgCallback [callback-function]	246	=item SetMsgCallback [callback-function]
241		247
242	=item SetBusyCallback [callback-function]	248	=item SetBusyCallback [callback-function]
243		249
…		…
247		253
248	=back	254	=back
249		255
250	=head2 Call the currently selected FNameFilter	256	=head2 Call the currently selected FNameFilter
251		257
252	=over 4	258	=over
253		259
254	=item $file = FNameFilter $file	260	=item $file = FNameFilter $file
255		261
256	=back	262	=back
257		263
258	=head2 Loading sourcefiles, optionally fuzzy merge and start decoding	264	=head2 Loading sourcefiles, optionally fuzzy merge and start decoding
259		265
260	=over 4	266	=over
261		267
262	=item ($retval, $count) = LoadFile $fname, [$id, [$delflag]]	268	=item ($retval, $count) = LoadFile $fname, [$id, [$delflag, [$partno]]]
263		269
264	Load the given file and scan it for encoded contents. Optionally tag it	270	Load the given file and scan it for encoded contents. Optionally tag it
265	with the given id, and if C<$delflag> is true, delete the file after it is	271	with the given id, and if C<$delflag> is true, delete the file after it
266	no longer necessary.	272	is no longer necessary. If you are certain of the part number, you can
		273	specify it as the last argument.
		274
		275	A better (usually faster) way of doing this is using the C<SetFNameFilter>
		276	functionality.
267		277
268	=item $retval = Smerge $pass	278	=item $retval = Smerge $pass
269		279
270	If you are desperate, try to call C<Smerge> with increasing C<$pass>	280	If you are desperate, try to call C<Smerge> with increasing C<$pass>
271	values, beginning at C<0>, to try to merge parts that usually would not	281	values, beginning at C<0>, to try to merge parts that usually would not
272	have been merged.	282	have been merged.
273		283
274	Most probably this will result in garbled files, so never do this by	284	Most probably this will result in garbled files, so never do this by
275	default.	285	default, except:
		286
		287	If the C<OPT_AUTOCHECK> option has been disabled (by default it is
		288	enabled) to speed up file loading, then you I<have> to call C<Smerge -1>
		289	after loading all files as an additional pre-pass (which is normally done
		290	by C<LoadFile>).
276		291
277	=item $item = GetFileListItem $item_number	292	=item $item = GetFileListItem $item_number
278		293
279	Return the C<$item> structure for the C<$item_number>'th found file, or	294	Return the C<$item> structure for the C<$item_number>'th found file, or
280	C<undef> of no file with that number exists.	295	C<undef> of no file with that number exists.
281		296
282	The first file has number C<0>, and the series has no holes, so you can	297	The first file has number C<0>, and the series has no holes, so you can
283	iterate over all files by starting with zero and incrementing until you	298	iterate over all files by starting with zero and incrementing until you
284	hit C<undef>.	299	hit C<undef>.
285		300
		301	This function has to walk the linear list of fils on each access, so
		302	if you want to iterate over all items, it is usually faster to use
		303	C<GetFileList>.
		304
		305	=item @items = GetFileList
		306
		307	Similar to C<GetFileListItem>, but returns all files in one go, which is
		308	very much faster for large number of items, and has no drawbacks when used
		309	for a small number of items.
		310
286	=back	311	=back
287		312
288	=head2 Decoding files	313	=head2 Decoding files
289		314
290	=over 4	315	=over
291		316
292	=item $retval = $item->rename($newname)	317	=item $retval = $item->rename ($newname)
293		318
294	Change the ondisk filename where the decoded file will be saved.	319	Change the ondisk filename where the decoded file will be saved.
295		320
296	=item $retval = $item->decode_temp	321	=item $retval = $item->decode_temp
297		322
…		…
300		325
301	=item $retval = $item->remove_temp	326	=item $retval = $item->remove_temp
302		327
303	Remove the temporarily decoded file again.	328	Remove the temporarily decoded file again.
304		329
305	=item $retval = $item->decode([$target_path])	330	=item $retval = $item->decode ([$target_path])
306		331
307	Decode the file to it's destination, or the given target path.	332	Decode the file to its destination, or the given target path.
308		333
309	=item $retval = $item->info(callback-function)	334	=item $retval = $item->info (callback-function)
310		335
311	=back	336	=back
312		337
313	=head2 Querying (and setting) item attributes	338	=head2 Querying (and setting) item attributes
314		339
315	=over 4	340	=over
316		341
317	=item $state = $item->state	342	=item $state = $item->state
318		343
319	=item $mode = $item->mode([newmode])	344	=item $mode = $item->mode ([newmode])
320		345
321	=item $uudet = $item->uudet	346	=item $uudet = $item->uudet
322		347
323	=item $size = $item->size	348	=item $size = $item->size
324		349
325	=item $filename = $item->filename([newfilename})	350	=item $filename = $item->filename ([newfilename})
326		351
327	=item $subfname = $item->subfname	352	=item $subfname = $item->subfname
328		353
329	=item $mimeid = $item->mimeid	354	=item $mimeid = $item->mimeid
330		355
…		…
334		359
335	=back	360	=back
336		361
337	=head2 Information about source parts	362	=head2 Information about source parts
338		363
339	=over 4	364	=over
340		365
341	=item $parts = $item->parts	366	=item $parts = $item->parts
342		367
343	Return information about all parts (source files) used to decode the file	368	Return information about all parts (source files) used to decode the file
344	as a list of hashrefs with the following structure:	369	as a list of hashrefs with the following structure:
…		…
358	Usually you are interested mostly the C<sfname> and possibly the C<partno>	383	Usually you are interested mostly the C<sfname> and possibly the C<partno>
359	and C<filename> members.	384	and C<filename> members.
360		385
361	=back	386	=back
362		387
363	=head2 Functions below not documented and not very well tested	388	=head2 Functions below are not documented and not very well tested - feedback welcome
364		389
365	QuickDecode	390	QuickDecode
366	EncodeMulti	391	EncodeMulti
367	EncodePartial	392	EncodePartial
368	EncodeToStream	393	EncodeToStream
…		…
372		397
373	=head2 EXTENSION FUNCTIONS	398	=head2 EXTENSION FUNCTIONS
374		399
375	Functions found in this module but not documented in the uulib documentation:	400	Functions found in this module but not documented in the uulib documentation:
376		401
377	=over 4	402	=over
378		403
379	=item $msg = straction ACT_xxx	404	=item $msg = straction ACT_xxx
380		405
381	Return a human readable string representing the given action code.	406	Return a human readable string representing the given action code.
382		407
…		…
423		448
424	=back	449	=back
425		450
426	=head1 LARGE EXAMPLE DECODER	451	=head1 LARGE EXAMPLE DECODER
427		452
		453	The general workflow for decoding is like this:
		454
		455	=over
		456
		457	=item 1. Configure options with C<SetOption> or C<SetXXXCallback>.
		458
		459	=item 2. Load all source files with C<LoadFile>.
		460
		461	=item 3. Optionally C<Smerge>.
		462
		463	=item 4. Iterate over all C<GetFileList> items (i.e. result files).
		464
		465	=item 5. C<CleanUp> to delete files and free items.
		466
		467	=back
		468
428	This is the file C<example-decoder> from the distribution, put here	469	What follows is the file C<example-decoder> from the distribution that
429	instead of more thorough documentation.	470	illustrates the above worklfow in a non-trivial example.
430		471
		472	#!/usr/bin/perl
		473
431	# decode all the files in the directory uusrc/ and copy	474	# decode all the files in the directory uusrc/ and copy
432	# the resulting files to uudst/	475	# the resulting files to uudst/
433		476
434	use Convert::UUlib ':all';	477	use Convert::UUlib ':all';
435		478
436	sub namefilter {	479	sub namefilter {
437	my($path)=@_;	480	my ($path) = @_;
		481
438	$path=~s/^.*[\/\\]//;	482	$path=~s/^.*[\/\\]//;
		483
439	$path;	484	$path
440	}	485	}
441		486
442	sub busycb {	487	sub busycb {
443	my ($action, $curfile, $partno, $numparts, $percent, $fsize) = @_;	488	my ($action, $curfile, $partno, $numparts, $percent, $fsize) = @_;
444	$_[0]=straction($action);	489	$_[0]=straction($action);
445	print "busy_callback(", (join ",",@_), ")\n";	490	print "busy_callback(", (join ",",@_), ")\n";
446	0;	491	0
447	}	492	}
448		493
		494	SetOption OPT_RBUF, 128*1024;
		495	SetOption OPT_WBUF, 1024*1024;
449	SetOption OPT_IGNMODE, 1;	496	SetOption OPT_IGNMODE, 1;
		497	SetOption OPT_IGNMODE, 1;
450	SetOption OPT_VERBOSE, 1;	498	SetOption OPT_VERBOSE, 1;
		499	SetOption OPT_AUTOCHK, 0;
451		500
452	# show the three ways you can set callback functions. I normally	501	# show the three ways you can set callback functions. I normally
453	# prefer the one with the sub inplace.	502	# prefer the one with the sub inplace.
454	SetFNameFilter \&namefilter;	503	SetFNameFilter \&namefilter;
455		504
456	SetBusyCallback "busycb", 333;	505	SetBusyCallback "busycb", 333;
457		506
458	SetMsgCallback sub {	507	SetMsgCallback sub {
459	my ($msg, $level) = @_;	508	my ($msg, $level) = @_;
460	print uc strmsglevel $_[1], ": $msg\n";	509	print uc strmsglevel $_[1], ": $msg\n";
461	};	510	};
462		511
463	# the following non-trivial FileNameCallback takes care	512	# the following non-trivial FileNameCallback takes care
464	# of some subject lines not detected properly by uulib:	513	# of some subject lines not detected properly by uulib:
465	SetFileNameCallback sub {	514	SetFileNameCallback sub {
466	return unless $_[1]; # skip "Re:"-plies et al.	515	return unless $_[1]; # skip "Re:"-plies et al.
467	local $_ = $_[0];	516	local $_ = $_[0];
468		517
469	# the following rules are rather effective on some newsgroups,	518	# the following rules are rather effective on some newsgroups,
470	# like alt.binaries.games.anime, where non-mime, uuencoded data	519	# like alt.binaries.games.anime, where non-mime, uuencoded data
471	# is very common	520	# is very common
472		521
473	# if we find some *.rar, take it as the filename	522	# if we find some *.rar, take it as the filename
474	return $1 if /(\S{3,}\.(?:[rstuvwxyz]\d\d\|rar))\s/i;	523	return $1 if /(\S{3,}\.(?:[rstuvwxyz]\d\d\|rar))\s/i;
475		524
476	# one common subject format	525	# one common subject format
477	return $1 if /- "(.{2,}?\..+?)" (?:yenc )?$\d+\/\d+$/i;	526	return $1 if /- "(.{2,}?\..+?)" (?:yenc )?$\d+\/\d+$/i;
478		527
479	# - filename.par (04/55)	528	# - filename.par (04/55)
480	return $1 if /- "?(\S{3,}\.\S+?)"? (?:yenc )?$\d+\/\d+$/i;	529	return $1 if /- "?(\S{3,}\.\S+?)"? (?:yenc )?$\d+\/\d+$/i;
481		530
482	# - (xxx) No. 1 sayuri81.jpg 756565 bytes	531	# - (xxx) No. 1 sayuri81.jpg 756565 bytes
483	# - (20 files) No.17 Roseanne.jpg [2/2]	532	# - (20 files) No.17 Roseanne.jpg [2/2]
484	return $1 if /No\.[ 0-9]+ (\S+\....) (?:\d+ bytes )?\[/;	533	return $1 if /No\.[ 0-9]+ (\S+\....) (?:\d+ bytes )?\[/;
485		534
		535	# try to detect some common forms of filenames
		536	return $1 if /([a-z0-9_\-+.]{3,}\.[a-z]{3,4}(?:.\d+))/i;
		537
486	# otherwise just pass what we have	538	# otherwise just pass what we have
487	return ();	539	()
488	};	540	};
489		541
490	# now read all files in the directory uusrc/*	542	# now read all files in the directory uusrc/*
491	for(<uusrc/*>) {	543	for (<uusrc/*>) {
492	my($retval,$count)=LoadFile ($_, $_, 1);	544	my ($retval, $count) = LoadFile ($_, $_, 1);
493	print "file($_), status(", strerror $retval, ") parts($count)\n";	545	print "file($_), status(", strerror $retval, ") parts($count)\n";
494	}	546	}
495		547
		548	Smerge -1;
		549
496	SetOption OPT_SAVEPATH, "uudst/";	550	SetOption OPT_SAVEPATH, "uudst/";
497		551
498	# now wade through all files and their source parts	552	# now wade through all files and their source parts
499	$i = 0;	553	for my $uu (GetFileList) {
500	while ($uu = GetFileListItem($i)) {	554	print "file ", $uu->filename, "\n";
501	$i++;
502	print "file nr. $i";
503	print " state ", $uu->state;	555	print " state ", $uu->state, "\n";
504	print " mode ", $uu->mode;	556	print " mode ", $uu->mode, "\n";
505	print " uudet ", strencoding $uu->uudet;	557	print " uudet ", strencoding $uu->uudet, "\n";
506	print " size ", $uu->size;	558	print " size ", $uu->size, "\n";
507	print " filename ", $uu->filename;
508	print " subfname ", $uu->subfname;	559	print " subfname ", $uu->subfname, "\n";
509	print " mimeid ", $uu->mimeid;	560	print " mimeid ", $uu->mimeid, "\n";
510	print " mimetype ", $uu->mimetype;	561	print " mimetype ", $uu->mimetype, "\n";
511	print "\n";
512		562
513	# print additional info about all parts	563	# print additional info about all parts
		564	print " parts";
514	for ($uu->parts) {	565	for ($uu->parts) {
515	while (my ($k, $v) = each %$_) {	566	for my $k (sort keys %$_) {
516	print "$k > $v, ";	567	print " $k=$_->{$k}";
517	}	568	}
518	print "\n";	569	print "\n";
519	}	570	}
520		571
521	$uu->decode_temp;
522	print " temporarily decoded to ", $uu->binfile, "\n";
523	$uu->remove_temp;	572	$uu->remove_temp;
524		573
525	print strerror $uu->decode;	574	if (my $err = $uu->decode) {
		575	print " ERROR ", strerror $err, "\n";
		576	} else {
526	print " saved as uudst/", $uu->filename, "\n";	577	print " successfully saved as uudst/", $uu->filename, "\n";
527	}	578	}
		579	}
528		580
529	print "cleanup...\n";	581	print "cleanup...\n";
530		582
531	CleanUp();	583	CleanUp;
		584
		585	=head1 PERLMULTICORE SUPPORT
		586
		587	This module supports the perlmulticore standard (see
		588	L<http://perlmulticore.schmorp.de/> for more info) for the following
		589	functions - generally these are functions accessing the disk and/or using
		590	considerable CPU time:
		591
		592	LoadFile
		593	$item->decode
		594	$item->decode_temp
		595	$item->remove_temp
		596	$item->info
		597
		598	The perl interpreter will be reacquired/released on every callback
		599	invocation, so for performance reasons, callbacks should be avoided if
		600	that is costly.
		601
		602	Future versions might enable multicore support for more functions.
		603
		604	=head1 BUGS AND LIMITATIONS
		605
		606	The original uulib library this module uses was written at a time where
		607	main memory of measured in megabytes and buffer overflows as a security
		608	thign didn't exist. While a lot of security fixes have been applied over
		609	the years (includign some defense in depth mechanism that can shield
		610	against a lot of as-of-yet undetected bugs), using this library for
		611	security purposes requires care.
		612
		613	Likewise, file sizes when the uulib library was written were tiny compared
		614	to today, so do not expect this library to handle files larger than 2GB.
		615
		616	Lastly, this module uses a very "C-like" interface, which means it doesn't
		617	protect you from invalid points as you might expect from "more perlish"
		618	modules - for example, accessing a file item object after callinbg
		619	C<CleanUp> will likely result in crashes, memory corruption, or worse.
532		620
533	=head1 AUTHOR	621	=head1 AUTHOR
534		622
535	Marc Lehmann <pcg@goof.com>, the original uulib library was written	623	Marc Lehmann <schmorp@schmorp.de>, the original uulib library was written
536	by Frank Pilhofer <fp@informatik.uni-frankfurt.de>, and later heavily	624	by Frank Pilhofer <fp@informatik.uni-frankfurt.de>, and later heavily
537	bugfixed by Marc Lehmann.	625	bugfixed by Marc Lehmann.
538		626
539	=head1 SEE ALSO	627	=head1 SEE ALSO
540		628
541	perl(1), uudeview homepage at http://www.uni-frankfurt.de/~fp/uudeview/.	629	perl(1), uudeview homepage at L<http://www.fpx.de/fp/Software/UUDeview/>.
542		630
543	=cut	631	=cut
		632

Diff Legend

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

Comparing Convert-UUlib/UUlib.pm (file contents): Revision 1.15 by root, Tue Oct 15 23:35:31 2002 UTC vs. Revision 1.55 by root, Sun Dec 13 06:36:09 2020 UTC

Diff Legend

Comparing Convert-UUlib/UUlib.pm (file contents):
Revision 1.15 by root, Tue Oct 15 23:35:31 2002 UTC vs.
Revision 1.55 by root, Sun Dec 13 06:36:09 2020 UTC