… | |
… | |
5 | use Carp; |
5 | use Carp; |
6 | |
6 | |
7 | require Exporter; |
7 | require Exporter; |
8 | require DynaLoader; |
8 | require DynaLoader; |
9 | |
9 | |
10 | our $VERSION = 1.71; |
10 | our $VERSION = 1.8; |
11 | |
11 | |
12 | our @ISA = qw(Exporter DynaLoader); |
12 | our @ISA = qw(Exporter DynaLoader); |
13 | |
13 | |
14 | our @_consts = qw( |
14 | our @_consts = qw( |
15 | ACT_COPYING ACT_DECODING ACT_ENCODING ACT_IDLE ACT_SCANNING |
15 | ACT_COPYING ACT_DECODING ACT_ENCODING ACT_IDLE ACT_SCANNING |
… | |
… | |
110 | |
110 | |
111 | This module started as an interface to the uulib/uudeview library by Frank |
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) |
112 | Pilhofer that can be used to decode all kinds of usenet (and other) |
113 | binary messages. |
113 | binary messages. |
114 | |
114 | |
115 | After upstream abondoned the project, th library was continuously bugfixed |
115 | After upstream abondoned the project, the library was continuously bugfixed |
116 | and improved in this module, with major focuses on security fixes, |
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 |
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 |
118 | safe with untrusted data, but it surely is safer than the original |
119 | uudeview). |
119 | uudeview). |
120 | |
120 | |
121 | 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 |
122 | 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 |
123 | 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. |
… | |
… | |
144 | =head2 Options |
144 | =head2 Options |
145 | |
145 | |
146 | OPT_VERSION version number MAJOR.MINORplPATCH (ro) |
146 | OPT_VERSION version number MAJOR.MINORplPATCH (ro) |
147 | OPT_FAST assumes only one part per file |
147 | OPT_FAST assumes only one part per file |
148 | OPT_DUMBNESS switch off the program's intelligence |
148 | OPT_DUMBNESS switch off the program's intelligence |
149 | OPT_BRACKPOL give numbers in [] higher precendence |
149 | OPT_BRACKPOL give numbers in [] higher precedence |
150 | OPT_VERBOSE generate informative messages |
150 | OPT_VERBOSE generate informative messages |
151 | OPT_DESPERATE try to decode incomplete files |
151 | OPT_DESPERATE try to decode incomplete files |
152 | OPT_IGNREPLY ignore RE:plies (off by default) |
152 | OPT_IGNREPLY ignore RE:plies (off by default) |
153 | OPT_OVERWRITE whether it's OK to overwrite ex. files |
153 | OPT_OVERWRITE whether it's OK to overwrite ex. files |
154 | OPT_SAVEPATH prefix to save-files on disk |
154 | OPT_SAVEPATH prefix to save-files on disk |
… | |
… | |
602 | Future versions might enable multicore support for more functions. |
602 | Future versions might enable multicore support for more functions. |
603 | |
603 | |
604 | =head1 BUGS AND LIMITATIONS |
604 | =head1 BUGS AND LIMITATIONS |
605 | |
605 | |
606 | The original uulib library this module uses was written at a time where |
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 |
607 | main memory was measured in megabytes and buffer overflows as a security |
608 | thign didn't exist. While a lot of security fixes have been applied over |
608 | thing 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 |
609 | the years (including some defense in depth mechanism that can shield |
610 | against a lot of as-of-yet undetected bugs), using this library for |
610 | against a lot of as-of-yet undetected bugs), using this library for |
611 | security purposes requires care. |
611 | security purposes requires care. |
612 | |
612 | |
613 | Likewise, file sizes when the uulib library was written were tiny compared |
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. |
614 | to today, so do not expect this library to handle files larger than 2GB, |
|
|
615 | certainly not on a 32 bit host. |
615 | |
616 | |
616 | Lastly, this module uses a very "C-like" interface, which means it doesn't |
617 | 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 | protect you from invalid pointers as you might expect from "more perlish" |
618 | modules - for example, accessing a file item object after callinbg |
619 | modules - for example, accessing a file item object after calling |
619 | C<CleanUp> will likely result in crashes, memory corruption, or worse. |
620 | C<CleanUp> will likely result in crashes, memory corruption, or worse. |
620 | |
621 | |
621 | =head1 AUTHOR |
622 | =head1 AUTHOR |
622 | |
623 | |
623 | Marc Lehmann <schmorp@schmorp.de>, the original uulib library was written |
624 | Marc Lehmann <schmorp@schmorp.de>, the original uulib library was written |