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

Comparing Convert-UUlib/UUlib.pm (file contents):
Revision 1.13 by root, Tue Oct 15 23:20:29 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
…		…
151	OPT_PROGRESS retrieve progress information	158	OPT_PROGRESS retrieve progress information
152	OPT_USETEXT handle text messages	159	OPT_USETEXT handle text messages
153	OPT_PREAMB handle Mime preambles/epilogues	160	OPT_PREAMB handle Mime preambles/epilogues
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	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
…		…
203		213
204	Initialize is automatically called when the module is loaded and allocates	214	Initialize is automatically called when the module is loaded and allocates
205	quite a small amount of memory for todays machines ;) CleanUp releases that	215	quite a small amount of memory for todays machines ;) CleanUp releases that
206	again.	216	again.
207		217
		218	On my machine, a fairly complete decode with DBI backend needs about 10MB
		219	RSS to decode 20000 files.
		220
208	=over 4	221	=over
209
210	=item Initialize
211
212	Not normally necessary, (re-)initializes the library.
213		222
214	=item CleanUp	223	=item CleanUp
215		224
216	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
217	before starting a new decoding round.	226	decoidng run, if you want to start a new one.
218		227
219	=back	228	=back
220		229
221	=head2 Setting and querying options	230	=head2 Setting and querying options
222		231
223	=over 4	232	=over
224		233
225	=item $option = GetOption OPT_xxx	234	=item $option = GetOption OPT_xxx
226		235
227	=item SetOption OPT_xxx, opt-value	236	=item SetOption OPT_xxx, opt-value
228		237
…		…
230		239
231	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.
232		241
233	=head2 Setting various callbacks	242	=head2 Setting various callbacks
234		243
235	=over 4	244	=over
236		245
237	=item SetMsgCallback [callback-function]	246	=item SetMsgCallback [callback-function]
238		247
239	=item SetBusyCallback [callback-function]	248	=item SetBusyCallback [callback-function]
240		249
…		…
244		253
245	=back	254	=back
246		255
247	=head2 Call the currently selected FNameFilter	256	=head2 Call the currently selected FNameFilter
248		257
249	=over 4	258	=over
250		259
251	=item $file = FNameFilter $file	260	=item $file = FNameFilter $file
252		261
253	=back	262	=back
254		263
255	=head2 Loading sourcefiles, optionally fuzzy merge and start decoding	264	=head2 Loading sourcefiles, optionally fuzzy merge and start decoding
256		265
257	=over 4	266	=over
258		267
259	=item ($retval, $count) = LoadFile $fname, [$id, [$delflag]]	268	=item ($retval, $count) = LoadFile $fname, [$id, [$delflag, [$partno]]]
260		269
261	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
262	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
263	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.
264		277
265	=item $retval = Smerge $pass	278	=item $retval = Smerge $pass
266		279
267	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>
268	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
269	have been merged.	282	have been merged.
270		283
271	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
272	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>).
273		291
274	=item $item = GetFileListItem $item_number	292	=item $item = GetFileListItem $item_number
275		293
276	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
277	C<undef> of no file with that number exists.	295	C<undef> of no file with that number exists.
278		296
279	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
280	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
281	hit C<undef>.	299	hit C<undef>.
282		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
283	=back	311	=back
284		312
285	=head2 Decoding files	313	=head2 Decoding files
286		314
287	=over 4	315	=over
288		316
289	=item $retval = $item->rename($newname)	317	=item $retval = $item->rename ($newname)
290		318
291	Change the ondisk filename where the decoded file will be saved.	319	Change the ondisk filename where the decoded file will be saved.
292		320
293	=item $retval = $item->decode_temp	321	=item $retval = $item->decode_temp
294		322
…		…
297		325
298	=item $retval = $item->remove_temp	326	=item $retval = $item->remove_temp
299		327
300	Remove the temporarily decoded file again.	328	Remove the temporarily decoded file again.
301		329
302	=item $retval = $item->decode([$target_path])	330	=item $retval = $item->decode ([$target_path])
303		331
304	Decode the file to it's destination, or the given target path.	332	Decode the file to its destination, or the given target path.
305		333
306	=item $retval = $item->info(callback-function)	334	=item $retval = $item->info (callback-function)
307		335
308	=back	336	=back
309		337
310	=head2 Querying (and setting) item attributes	338	=head2 Querying (and setting) item attributes
311		339
312	=over 4	340	=over
313		341
314	=item $state = $item->state	342	=item $state = $item->state
315		343
316	=item $mode = $item->mode([newmode])	344	=item $mode = $item->mode ([newmode])
317		345
318	=item $uudet = $item->uudet	346	=item $uudet = $item->uudet
319		347
320	=item $size = $item->size	348	=item $size = $item->size
321		349
322	=item $filename = $item->filename([newfilename})	350	=item $filename = $item->filename ([newfilename})
323		351
324	=item $subfname = $item->subfname	352	=item $subfname = $item->subfname
325		353
326	=item $mimeid = $item->mimeid	354	=item $mimeid = $item->mimeid
327		355
…		…
331		359
332	=back	360	=back
333		361
334	=head2 Information about source parts	362	=head2 Information about source parts
335		363
336	=over 4	364	=over
337		365
338	=item $parts = $item->parts	366	=item $parts = $item->parts
339		367
340	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
341	as a list of hashrefs with the following structure:	369	as a list of hashrefs with the following structure:
…		…
355	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>
356	and C<filename> members.	384	and C<filename> members.
357		385
358	=back	386	=back
359		387
360	=head2 Functions below not documented and not very well tested	388	=head2 Functions below are not documented and not very well tested - feedback welcome
361		389
362	QuickDecode	390	QuickDecode
363	EncodeMulti	391	EncodeMulti
364	EncodePartial	392	EncodePartial
365	EncodeToStream	393	EncodeToStream
…		…
369		397
370	=head2 EXTENSION FUNCTIONS	398	=head2 EXTENSION FUNCTIONS
371		399
372	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:
373		401
374	=over 4	402	=over
375		403
376	=item $msg = straction ACT_xxx	404	=item $msg = straction ACT_xxx
377		405
378	Return a human readable string representing the given action code.	406	Return a human readable string representing the given action code.
379		407
…		…
420		448
421	=back	449	=back
422		450
423	=head1 LARGE EXAMPLE DECODER	451	=head1 LARGE EXAMPLE DECODER
424		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
425	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
426	instead of more thorough documentation.	470	illustrates the above worklfow in a non-trivial example.
427		471
		472	#!/usr/bin/perl
		473
428	# decode all the files in the directory uusrc/ and copy	474	# decode all the files in the directory uusrc/ and copy
429	# the resulting files to uudst/	475	# the resulting files to uudst/
430		476
431	use Convert::UUlib ':all';	477	use Convert::UUlib ':all';
432		478
433	sub namefilter {	479	sub namefilter {
434	my($path)=@_;	480	my ($path) = @_;
		481
435	$path=~s/^.*[\/\\]//;	482	$path=~s/^.*[\/\\]//;
		483
436	$path;	484	$path
437	}	485	}
438		486
439	sub busycb {	487	sub busycb {
440	my ($action, $curfile, $partno, $numparts, $percent, $fsize) = @_;	488	my ($action, $curfile, $partno, $numparts, $percent, $fsize) = @_;
441	$_[0]=straction($action);	489	$_[0]=straction($action);
442	print "busy_callback(", (join ",",@_), ")\n";	490	print "busy_callback(", (join ",",@_), ")\n";
443	0;	491	0
444	}	492	}
445		493
		494	SetOption OPT_RBUF, 128*1024;
		495	SetOption OPT_WBUF, 1024*1024;
446	SetOption OPT_IGNMODE, 1;	496	SetOption OPT_IGNMODE, 1;
		497	SetOption OPT_IGNMODE, 1;
447	SetOption OPT_VERBOSE, 1;	498	SetOption OPT_VERBOSE, 1;
		499	SetOption OPT_AUTOCHK, 0;
448		500
449	# show the three ways you can set callback functions. I normally	501	# show the three ways you can set callback functions. I normally
450	# prefer the one with the sub inplace.	502	# prefer the one with the sub inplace.
451	SetFNameFilter \&namefilter;	503	SetFNameFilter \&namefilter;
452		504
453	SetBusyCallback "busycb", 333;	505	SetBusyCallback "busycb", 333;
454		506
455	SetMsgCallback sub {	507	SetMsgCallback sub {
456	my ($msg, $level) = @_;	508	my ($msg, $level) = @_;
457	print uc strmsglevel $_[1], ": $msg\n";	509	print uc strmsglevel $_[1], ": $msg\n";
458	};	510	};
459		511
460	# the following non-trivial FileNameCallback takes care	512	# the following non-trivial FileNameCallback takes care
461	# of some subject lines not detected properly by uulib:	513	# of some subject lines not detected properly by uulib:
462	SetFileNameCallback sub {	514	SetFileNameCallback sub {
463	return unless $_[1]; # skip "Re:"-plies et al.	515	return unless $_[1]; # skip "Re:"-plies et al.
464	local $_ = $_[0];	516	local $_ = $_[0];
465		517
466	# the following rules are rather effective on some newsgroups,	518	# the following rules are rather effective on some newsgroups,
467	# like alt.binaries.games.anime, where non-mime, uuencoded data	519	# like alt.binaries.games.anime, where non-mime, uuencoded data
468	# is very common	520	# is very common
469		521
470	# if we find some *.rar, take it as the filename	522	# if we find some *.rar, take it as the filename
471	return $1 if /(\S{3,}\.(?:[rstuvwxyz]\d\d\|rar))\s/i;	523	return $1 if /(\S{3,}\.(?:[rstuvwxyz]\d\d\|rar))\s/i;
472		524
473	# one common subject format	525	# one common subject format
474	return $1 if /- "(.{2,}?\..+?)" (?:yenc )?$\d+\/\d+$/i;	526	return $1 if /- "(.{2,}?\..+?)" (?:yenc )?$\d+\/\d+$/i;
475		527
476	# - filename.par (04/55)	528	# - filename.par (04/55)
477	return $1 if /- "?(\S{3,}\.\S+?)"? (?:yenc )?$\d+\/\d+$/i;	529	return $1 if /- "?(\S{3,}\.\S+?)"? (?:yenc )?$\d+\/\d+$/i;
478		530
479	# - (xxx) No. 1 sayuri81.jpg 756565 bytes	531	# - (xxx) No. 1 sayuri81.jpg 756565 bytes
480	# - (20 files) No.17 Roseanne.jpg [2/2]	532	# - (20 files) No.17 Roseanne.jpg [2/2]
481	return $1 if /No\.[ 0-9]+ (\S+\....) (?:\d+ bytes )?\[/;	533	return $1 if /No\.[ 0-9]+ (\S+\....) (?:\d+ bytes )?\[/;
482		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
483	# otherwise just pass what we have	538	# otherwise just pass what we have
484	return ();	539	()
485	};	540	};
486		541
487	# now read all files in the directory uusrc/*	542	# now read all files in the directory uusrc/*
488	for(<uusrc/*>) {	543	for (<uusrc/*>) {
489	my($retval,$count)=LoadFile ($_, $_, 1);	544	my ($retval, $count) = LoadFile ($_, $_, 1);
490	print "file($_), status(", strerror $retval, ") parts($count)\n";	545	print "file($_), status(", strerror $retval, ") parts($count)\n";
491	}	546	}
492		547
		548	Smerge -1;
		549
493	SetOption OPT_SAVEPATH, "uudst/";	550	SetOption OPT_SAVEPATH, "uudst/";
494		551
495	# now wade through all files and their source parts	552	# now wade through all files and their source parts
496	$i = 0;	553	for my $uu (GetFileList) {
497	while ($uu = GetFileListItem($i)) {	554	print "file ", $uu->filename, "\n";
498	$i++;
499	print "file nr. $i";
500	print " state ", $uu->state;	555	print " state ", $uu->state, "\n";
501	print " mode ", $uu->mode;	556	print " mode ", $uu->mode, "\n";
502	print " uudet ", strencoding $uu->uudet;	557	print " uudet ", strencoding $uu->uudet, "\n";
503	print " size ", $uu->size;	558	print " size ", $uu->size, "\n";
504	print " filename ", $uu->filename;
505	print " subfname ", $uu->subfname;	559	print " subfname ", $uu->subfname, "\n";
506	print " mimeid ", $uu->mimeid;	560	print " mimeid ", $uu->mimeid, "\n";
507	print " mimetype ", $uu->mimetype;	561	print " mimetype ", $uu->mimetype, "\n";
508	print "\n";
509		562
510	# print additional info about all parts	563	# print additional info about all parts
		564	print " parts";
511	for ($uu->parts) {	565	for ($uu->parts) {
512	while (my ($k, $v) = each %$_) {	566	for my $k (sort keys %$_) {
513	print "$k > $v, ";	567	print " $k=$_->{$k}";
514	}	568	}
515	print "\n";	569	print "\n";
516	}	570	}
517		571
518	$uu->decode_temp;
519	print " temporarily decoded to ", $uu->binfile, "\n";
520	$uu->remove_temp;	572	$uu->remove_temp;
521		573
522	print strerror $uu->decode;	574	if (my $err = $uu->decode) {
		575	print " ERROR ", strerror $err, "\n";
		576	} else {
523	print " saved as uudst/", $uu->filename, "\n";	577	print " successfully saved as uudst/", $uu->filename, "\n";
524	}	578	}
		579	}
525		580
526	print "cleanup...\n";	581	print "cleanup...\n";
527		582
528	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.
529		620
530	=head1 AUTHOR	621	=head1 AUTHOR
531		622
532	Marc Lehmann <pcg@goof.com>, the original uulib library was written	623	Marc Lehmann <schmorp@schmorp.de>, the original uulib library was written
533	by Frank Pilhofer <fp@informatik.uni-frankfurt.de>, and later heavily	624	by Frank Pilhofer <fp@informatik.uni-frankfurt.de>, and later heavily
534	bugfixed by Marc Lehmann.	625	bugfixed by Marc Lehmann.
535		626
536	=head1 SEE ALSO	627	=head1 SEE ALSO
537		628
538	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/>.
539		630
540	=cut	631	=cut
		632

Diff Legend

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

Comparing Convert-UUlib/UUlib.pm (file contents): Revision 1.13 by root, Tue Oct 15 23:20:29 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.13 by root, Tue Oct 15 23:20:29 2002 UTC vs.
Revision 1.55 by root, Sun Dec 13 06:36:09 2020 UTC