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

Comparing Convert-UUlib/UUlib.pm (file contents):
Revision 1.25 by root, Mon May 2 19:58:40 2005 UTC vs.
Revision 1.56 by root, Thu Dec 17 01:24:59 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 = "1.06";	10	our $VERSION = 1.8;
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
19		21
20	OPT_RBUF OPT_WBUF	22	OPT_RBUF OPT_WBUF
21	OPT_BRACKPOL OPT_DEBUG OPT_DESPERATE OPT_DUMBNESS OPT_ENCEXT	23	OPT_BRACKPOL OPT_DEBUG OPT_DESPERATE OPT_DUMBNESS OPT_ENCEXT
22	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
23	OPT_PROGRESS OPT_SAVEPATH OPT_TINYB64 OPT_USETEXT OPT_VERBOSE	25	OPT_PROGRESS OPT_SAVEPATH OPT_TINYB64 OPT_USETEXT OPT_VERBOSE
24	OPT_VERSION OPT_REMOVE OPT_MOREMIME OPT_DOTDOT	26	OPT_VERSION OPT_REMOVE OPT_MOREMIME OPT_DOTDOT OPT_AUTOCHECK
25		27
26	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
27	RET_NOEND RET_NOMEM RET_OK RET_UNSUP	29	RET_NOEND RET_NOMEM RET_OK RET_UNSUP
28		30
29	B64_ENCODED BH_ENCODED PT_ENCODED QP_ENCODED	31	B64_ENCODED BH_ENCODED PT_ENCODED QP_ENCODED
30	XX_ENCODED UU_ENCODED YENC_ENCODED	32	XX_ENCODED UU_ENCODED YENC_ENCODED
31	);	33	);
32		34
33	@_funcs = qw(	35	our @_funcs = qw(
34	Initialize CleanUp GetOption SetOption strerror SetMsgCallback	36	Initialize CleanUp GetOption SetOption strerror SetMsgCallback
35	SetBusyCallback SetFileCallback SetFNameFilter SetFileNameCallback	37	SetBusyCallback SetFileCallback SetFNameFilter SetFileNameCallback
36	FNameFilter LoadFile GetFileListItem RenameFile DecodeToTemp	38	FNameFilter LoadFile GetFileListItem GetFileList RenameFile DecodeToTemp
37	RemoveTemp DecodeFile InfoFile Smerge QuickDecode EncodeMulti	39	RemoveTemp DecodeFile InfoFile Smerge QuickDecode EncodeMulti
38	EncodePartial EncodeToStream EncodeToFile E_PrepSingle	40	EncodePartial EncodeToStream EncodeToFile E_PrepSingle
39	E_PrepPartial	41	E_PrepPartial
40		42
41	straction strencoding strmsglevel	43	straction strencoding strmsglevel
42	);	44	);
43		45
44	@EXPORT = @_consts;	46	our @EXPORT = @_consts;
45	@EXPORT_OK = @_funcs;	47	our @EXPORT_OK = @_funcs;
46	%EXPORT_TAGS = (all => [@_consts,@_funcs], constants => \@_consts);	48	our %EXPORT_TAGS = (all => [@_consts,@_funcs], constants => \@_consts);
47		49
48	bootstrap Convert::UUlib $VERSION;	50	bootstrap Convert::UUlib $VERSION;
49		51
50	Initialize();	52	# dummy function for compatiiblity with pre-1.7 versions
51		53	sub Initialize { }
52	# not when < 5.005_6x
53	# END { CleanUp() }
54
55	for (@_consts) {
56	my $constant = constant($_);
57	*$_ = sub () { $constant };
58	}
59		54
60	# action code -> string mapping	55	# action code -> string mapping
61	sub straction($) {	56	sub straction($) {
62	return 'copying' if $_[0] == &ACT_COPYING;	57	return 'copying' if $_[0] == &ACT_COPYING;
63	return 'decoding' if $_[0] == &ACT_DECODING;	58	return 'decoding' if $_[0] == &ACT_DECODING;
…		…
92	1;	87	1;
93	__END__	88	__END__
94		89
95	=head1 NAME	90	=head1 NAME
96		91
97	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
98		93
99	=head1 SYNOPSIS	94	=head1 SYNOPSIS
100		95
101	use Convert::UUlib ':all';	96	use Convert::UUlib ':all';
102		97
103	# read all the files named on the commandline and decode them	98	# read all the files named on the commandline and decode them
104	# into the CURRENT directory. See below for a longer example.	99	# into the CURRENT directory. See below for a longer example.
105	LoadFile $_ for @ARGV;	100	LoadFile $_ for @ARGV;
106	for (my $i = 0; my $uu = GetFileListItem $i; $i++) {	101
		102	for my $uu (GetFileList) {
107	if ($uu->state & FILE_OK) {	103	if ($uu->state & FILE_OK) {
108	$uu->decode;	104	$uu->decode;
109	print $uu->filename, "\n";	105	print $uu->filename, "\n";
110	}	106	}
111	}	107	}
112		108
113	=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).
114		120
115	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
116	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
117	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.
118		124
…		…
155	OPT_TINYB64 detect short B64 outside of Mime	161	OPT_TINYB64 detect short B64 outside of Mime
156	OPT_ENCEXT extension for single-part encoded files	162	OPT_ENCEXT extension for single-part encoded files
157	OPT_REMOVE remove input files after decoding (dangerous)	163	OPT_REMOVE remove input files after decoding (dangerous)
158	OPT_MOREMIME strict MIME adherence	164	OPT_MOREMIME strict MIME adherence
159	OPT_DOTDOT ".."-unescaping has not yet been done on input files	165	OPT_DOTDOT ".."-unescaping has not yet been done on input files
160	OPT_RBUF set default read I/O buffer size in bytes EXPERIMENTAL	166	OPT_RBUF set default read I/O buffer size in bytes
161	OPT_WBUF set default write I/O buffer size in bytes EXPERIMENTAL	167	OPT_WBUF set default write I/O buffer size in bytes
		168	OPT_AUTOCHECK automatically check file list after every loadfile
162		169
163	=head2 Result/Error codes	170	=head2 Result/Error codes
164		171
165	RET_OK everything went fine	172	RET_OK everything went fine
166	RET_IOERR I/O Error - examine errno	173	RET_IOERR I/O Error - examine errno
…		…
209	again.	216	again.
210		217
211	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
212	RSS to decode 20000 files.	219	RSS to decode 20000 files.
213		220
214	=over 4	221	=over
215
216	=item Initialize
217
218	Not normally necessary, (re-)initializes the library.
219		222
220	=item CleanUp	223	=item CleanUp
221		224
222	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
223	before starting a new decoding round.	226	decoidng run, if you want to start a new one.
224		227
225	=back	228	=back
226		229
227	=head2 Setting and querying options	230	=head2 Setting and querying options
228		231
229	=over 4	232	=over
230		233
231	=item $option = GetOption OPT_xxx	234	=item $option = GetOption OPT_xxx
232		235
233	=item SetOption OPT_xxx, opt-value	236	=item SetOption OPT_xxx, opt-value
234		237
…		…
236		239
237	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.
238		241
239	=head2 Setting various callbacks	242	=head2 Setting various callbacks
240		243
241	=over 4	244	=over
242		245
243	=item SetMsgCallback [callback-function]	246	=item SetMsgCallback [callback-function]
244		247
245	=item SetBusyCallback [callback-function]	248	=item SetBusyCallback [callback-function]
246		249
…		…
250		253
251	=back	254	=back
252		255
253	=head2 Call the currently selected FNameFilter	256	=head2 Call the currently selected FNameFilter
254		257
255	=over 4	258	=over
256		259
257	=item $file = FNameFilter $file	260	=item $file = FNameFilter $file
258		261
259	=back	262	=back
260		263
261	=head2 Loading sourcefiles, optionally fuzzy merge and start decoding	264	=head2 Loading sourcefiles, optionally fuzzy merge and start decoding
262		265
263	=over 4	266	=over
264		267
265	=item ($retval, $count) = LoadFile $fname, [$id, [$delflag, [$partno]]]	268	=item ($retval, $count) = LoadFile $fname, [$id, [$delflag, [$partno]]]
266		269
267	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
268	with the given id, and if C<$delflag> is true, delete the file after it	271	with the given id, and if C<$delflag> is true, delete the file after it
…		…
277	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>
278	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
279	have been merged.	282	have been merged.
280		283
281	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
282	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>).
283		291
284	=item $item = GetFileListItem $item_number	292	=item $item = GetFileListItem $item_number
285		293
286	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
287	C<undef> of no file with that number exists.	295	C<undef> of no file with that number exists.
288		296
289	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
290	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
291	hit C<undef>.	299	hit C<undef>.
292		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
293	=back	311	=back
294		312
295	=head2 Decoding files	313	=head2 Decoding files
296		314
297	=over 4	315	=over
298		316
299	=item $retval = $item->rename($newname)	317	=item $retval = $item->rename ($newname)
300		318
301	Change the ondisk filename where the decoded file will be saved.	319	Change the ondisk filename where the decoded file will be saved.
302		320
303	=item $retval = $item->decode_temp	321	=item $retval = $item->decode_temp
304		322
…		…
307		325
308	=item $retval = $item->remove_temp	326	=item $retval = $item->remove_temp
309		327
310	Remove the temporarily decoded file again.	328	Remove the temporarily decoded file again.
311		329
312	=item $retval = $item->decode([$target_path])	330	=item $retval = $item->decode ([$target_path])
313		331
314	Decode the file to it's destination, or the given target path.	332	Decode the file to its destination, or the given target path.
315		333
316	=item $retval = $item->info(callback-function)	334	=item $retval = $item->info (callback-function)
317		335
318	=back	336	=back
319		337
320	=head2 Querying (and setting) item attributes	338	=head2 Querying (and setting) item attributes
321		339
322	=over 4	340	=over
323		341
324	=item $state = $item->state	342	=item $state = $item->state
325		343
326	=item $mode = $item->mode([newmode])	344	=item $mode = $item->mode ([newmode])
327		345
328	=item $uudet = $item->uudet	346	=item $uudet = $item->uudet
329		347
330	=item $size = $item->size	348	=item $size = $item->size
331		349
332	=item $filename = $item->filename([newfilename})	350	=item $filename = $item->filename ([newfilename})
333		351
334	=item $subfname = $item->subfname	352	=item $subfname = $item->subfname
335		353
336	=item $mimeid = $item->mimeid	354	=item $mimeid = $item->mimeid
337		355
…		…
341		359
342	=back	360	=back
343		361
344	=head2 Information about source parts	362	=head2 Information about source parts
345		363
346	=over 4	364	=over
347		365
348	=item $parts = $item->parts	366	=item $parts = $item->parts
349		367
350	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
351	as a list of hashrefs with the following structure:	369	as a list of hashrefs with the following structure:
…		…
365	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>
366	and C<filename> members.	384	and C<filename> members.
367		385
368	=back	386	=back
369		387
370	=head2 Functions below not documented and not very well tested	388	=head2 Functions below are not documented and not very well tested - feedback welcome
371		389
372	QuickDecode	390	QuickDecode
373	EncodeMulti	391	EncodeMulti
374	EncodePartial	392	EncodePartial
375	EncodeToStream	393	EncodeToStream
…		…
379		397
380	=head2 EXTENSION FUNCTIONS	398	=head2 EXTENSION FUNCTIONS
381		399
382	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:
383		401
384	=over 4	402	=over
385		403
386	=item $msg = straction ACT_xxx	404	=item $msg = straction ACT_xxx
387		405
388	Return a human readable string representing the given action code.	406	Return a human readable string representing the given action code.
389		407
…		…
430		448
431	=back	449	=back
432		450
433	=head1 LARGE EXAMPLE DECODER	451	=head1 LARGE EXAMPLE DECODER
434		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
435	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
436	instead of more thorough documentation.	470	illustrates the above worklfow in a non-trivial example.
437		471
		472	#!/usr/bin/perl
		473
438	# decode all the files in the directory uusrc/ and copy	474	# decode all the files in the directory uusrc/ and copy
439	# the resulting files to uudst/	475	# the resulting files to uudst/
440		476
441	use Convert::UUlib ':all';	477	use Convert::UUlib ':all';
442		478
443	sub namefilter {	479	sub namefilter {
444	my($path)=@_;	480	my ($path) = @_;
		481
445	$path=~s/^.*[\/\\]//;	482	$path=~s/^.*[\/\\]//;
		483
446	$path;	484	$path
447	}	485	}
448		486
449	sub busycb {	487	sub busycb {
450	my ($action, $curfile, $partno, $numparts, $percent, $fsize) = @_;	488	my ($action, $curfile, $partno, $numparts, $percent, $fsize) = @_;
451	$_[0]=straction($action);	489	$_[0]=straction($action);
452	print "busy_callback(", (join ",",@_), ")\n";	490	print "busy_callback(", (join ",",@_), ")\n";
453	0;	491	0
454	}	492	}
455		493
		494	SetOption OPT_RBUF, 128*1024;
		495	SetOption OPT_WBUF, 1024*1024;
456	SetOption OPT_IGNMODE, 1;	496	SetOption OPT_IGNMODE, 1;
		497	SetOption OPT_IGNMODE, 1;
457	SetOption OPT_VERBOSE, 1;	498	SetOption OPT_VERBOSE, 1;
		499	SetOption OPT_AUTOCHK, 0;
458		500
459	# show the three ways you can set callback functions. I normally	501	# show the three ways you can set callback functions. I normally
460	# prefer the one with the sub inplace.	502	# prefer the one with the sub inplace.
461	SetFNameFilter \&namefilter;	503	SetFNameFilter \&namefilter;
462		504
463	SetBusyCallback "busycb", 333;	505	SetBusyCallback "busycb", 333;
464		506
465	SetMsgCallback sub {	507	SetMsgCallback sub {
466	my ($msg, $level) = @_;	508	my ($msg, $level) = @_;
467	print uc strmsglevel $_[1], ": $msg\n";	509	print uc strmsglevel $_[1], ": $msg\n";
468	};	510	};
469		511
470	# the following non-trivial FileNameCallback takes care	512	# the following non-trivial FileNameCallback takes care
471	# of some subject lines not detected properly by uulib:	513	# of some subject lines not detected properly by uulib:
472	SetFileNameCallback sub {	514	SetFileNameCallback sub {
473	return unless $_[1]; # skip "Re:"-plies et al.	515	return unless $_[1]; # skip "Re:"-plies et al.
474	local $_ = $_[0];	516	local $_ = $_[0];
475		517
476	# the following rules are rather effective on some newsgroups,	518	# the following rules are rather effective on some newsgroups,
477	# like alt.binaries.games.anime, where non-mime, uuencoded data	519	# like alt.binaries.games.anime, where non-mime, uuencoded data
478	# is very common	520	# is very common
479		521
480	# if we find some *.rar, take it as the filename	522	# if we find some *.rar, take it as the filename
481	return $1 if /(\S{3,}\.(?:[rstuvwxyz]\d\d\|rar))\s/i;	523	return $1 if /(\S{3,}\.(?:[rstuvwxyz]\d\d\|rar))\s/i;
482		524
483	# one common subject format	525	# one common subject format
484	return $1 if /- "(.{2,}?\..+?)" (?:yenc )?$\d+\/\d+$/i;	526	return $1 if /- "(.{2,}?\..+?)" (?:yenc )?$\d+\/\d+$/i;
485		527
486	# - filename.par (04/55)	528	# - filename.par (04/55)
487	return $1 if /- "?(\S{3,}\.\S+?)"? (?:yenc )?$\d+\/\d+$/i;	529	return $1 if /- "?(\S{3,}\.\S+?)"? (?:yenc )?$\d+\/\d+$/i;
488		530
489	# - (xxx) No. 1 sayuri81.jpg 756565 bytes	531	# - (xxx) No. 1 sayuri81.jpg 756565 bytes
490	# - (20 files) No.17 Roseanne.jpg [2/2]	532	# - (20 files) No.17 Roseanne.jpg [2/2]
491	return $1 if /No\.[ 0-9]+ (\S+\....) (?:\d+ bytes )?\[/;	533	return $1 if /No\.[ 0-9]+ (\S+\....) (?:\d+ bytes )?\[/;
492		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
493	# otherwise just pass what we have	538	# otherwise just pass what we have
494	return ();	539	()
495	};	540	};
496		541
497	# now read all files in the directory uusrc/*	542	# now read all files in the directory uusrc/*
498	for(<uusrc/*>) {	543	for (<uusrc/*>) {
499	my($retval,$count)=LoadFile ($_, $_, 1);	544	my ($retval, $count) = LoadFile ($_, $_, 1);
500	print "file($_), status(", strerror $retval, ") parts($count)\n";	545	print "file($_), status(", strerror $retval, ") parts($count)\n";
501	}	546	}
502		547
		548	Smerge -1;
		549
503	SetOption OPT_SAVEPATH, "uudst/";	550	SetOption OPT_SAVEPATH, "uudst/";
504		551
505	# now wade through all files and their source parts	552	# now wade through all files and their source parts
506	$i = 0;	553	for my $uu (GetFileList) {
507	while ($uu = GetFileListItem($i)) {	554	print "file ", $uu->filename, "\n";
508	$i++;
509	print "file nr. $i";
510	print " state ", $uu->state;	555	print " state ", $uu->state, "\n";
511	print " mode ", $uu->mode;	556	print " mode ", $uu->mode, "\n";
512	print " uudet ", strencoding $uu->uudet;	557	print " uudet ", strencoding $uu->uudet, "\n";
513	print " size ", $uu->size;	558	print " size ", $uu->size, "\n";
514	print " filename ", $uu->filename;
515	print " subfname ", $uu->subfname;	559	print " subfname ", $uu->subfname, "\n";
516	print " mimeid ", $uu->mimeid;	560	print " mimeid ", $uu->mimeid, "\n";
517	print " mimetype ", $uu->mimetype;	561	print " mimetype ", $uu->mimetype, "\n";
518	print "\n";
519		562
520	# print additional info about all parts	563	# print additional info about all parts
		564	print " parts";
521	for ($uu->parts) {	565	for ($uu->parts) {
522	while (my ($k, $v) = each %$_) {	566	for my $k (sort keys %$_) {
523	print "$k > $v, ";	567	print " $k=$_->{$k}";
524	}	568	}
525	print "\n";	569	print "\n";
526	}	570	}
527		571
528	$uu->decode_temp;
529	print " temporarily decoded to ", $uu->binfile, "\n";
530	$uu->remove_temp;	572	$uu->remove_temp;
531		573
532	print strerror $uu->decode;	574	if (my $err = $uu->decode) {
		575	print " ERROR ", strerror $err, "\n";
		576	} else {
533	print " saved as uudst/", $uu->filename, "\n";	577	print " successfully saved as uudst/", $uu->filename, "\n";
534	}	578	}
		579	}
535		580
536	print "cleanup...\n";	581	print "cleanup...\n";
537		582
538	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.
539		620
540	=head1 AUTHOR	621	=head1 AUTHOR
541		622
542	Marc Lehmann <schmorp@schmorp.de>, the original uulib library was written	623	Marc Lehmann <schmorp@schmorp.de>, the original uulib library was written
543	by Frank Pilhofer <fp@informatik.uni-frankfurt.de>, and later heavily	624	by Frank Pilhofer <fp@informatik.uni-frankfurt.de>, and later heavily
544	bugfixed by Marc Lehmann.	625	bugfixed by Marc Lehmann.
545		626
546	=head1 SEE ALSO	627	=head1 SEE ALSO
547		628
548	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/>.
549		630
550	=cut	631	=cut
		632

Diff Legend

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

Comparing Convert-UUlib/UUlib.pm (file contents): Revision 1.25 by root, Mon May 2 19:58:40 2005 UTC vs. Revision 1.56 by root, Thu Dec 17 01:24:59 2020 UTC

Diff Legend

Comparing Convert-UUlib/UUlib.pm (file contents):
Revision 1.25 by root, Mon May 2 19:58:40 2005 UTC vs.
Revision 1.56 by root, Thu Dec 17 01:24:59 2020 UTC