| 1 |
CHANGELOG |
| 2 |
|
| 3 |
v2.10 (2022/??/??) |
| 4 |
================== |
| 5 |
--Added subPre/Postamble convenience functions to Paranoid::Debug, |
| 6 |
along with argument summarization |
| 7 |
--Changed pdebug output to make it easier to match entrance/exit |
| 8 |
points in subroutine messages |
| 9 |
--Added file import/export functionality to Paranoid::Data::AVLTree |
| 10 |
--Added basic internal profiling support to Paranoid::Data::AVLTree |
| 11 |
--Modified default PATH for pSecureEnv to include sbin directories |
| 12 |
--Added quad/long conversion functions to Paranoid::Data, along with |
| 13 |
a boolean function to detect native quad support |
| 14 |
--Various documentation fixes/enhancements |
| 15 |
|
| 16 |
v2.09 (2021/12/28) |
| 17 |
================== |
| 18 |
--Added new export options for Paranoid::IO |
| 19 |
--Added new flock stack mechanism to support transactional I/O patterns |
| 20 |
--Improved open flag filtering on reopens |
| 21 |
--pflock now performs and popen in order to make sure an flock is |
| 22 |
properly applied to reopened file handles in children |
| 23 |
--Improved pdebug logging for items geting passed arbitrary content |
| 24 |
(logging bytes in content, rather that spilling complete content into the |
| 25 |
logs) |
| 26 |
--Added non-flocking variants of I/O functions |
| 27 |
--Added I/O tests w/pflock stack enabled to ensure consistent behaviour |
| 28 |
--Added Paranoid::IO::FileMultiplexer class, which allows for multiple |
| 29 |
data stream I/O within a single file, but using normal discrete file |
| 30 |
I/O semantics |
| 31 |
--Fixed Paranoid::Filesystem test to account for NetBSD's noatime |
| 32 |
implementation (utime calls for atime fail entirely) |
| 33 |
|
| 34 |
v2.08 (2020/12/31) |
| 35 |
================== |
| 36 |
--Updated licensing information to reflect Paranoid trademark impact |
| 37 |
--Added IMPORT LISTS section to all modules with exportable functions |
| 38 |
Paranoid::Args: |
| 39 |
--Added template list for exports |
| 40 |
Paranoid::Data::AVLTree: |
| 41 |
--Added a tree & node class implementing AVL-balanced tree structures |
| 42 |
Paranoid:Debug: |
| 43 |
--Added constants list for exports |
| 44 |
--Documentation updates |
| 45 |
Paranoid::Log: |
| 46 |
--Minor internal refactoring |
| 47 |
Paranoid::Process: |
| 48 |
--Added pcommFork to facilitate forking with bi-directional process |
| 49 |
communication |
| 50 |
|
| 51 |
v2.07 (2019/02/01) |
| 52 |
================== |
| 53 |
Paranoid::Args: |
| 54 |
--Consolidate error messages, removing reports for both short/long argument |
| 55 |
versions, etc |
| 56 |
--Correlate AccompaniedBy/ExclusiveOf errors to both long/short versions |
| 57 |
--Automatically set Multiple/CanBundle and Template for any templates |
| 58 |
w/CountShort |
| 59 |
--Automatically set CanBundle for any options w/a short option and a |
| 60 |
template of '' or '$'. The latter is done if there is also a long |
| 61 |
name for the option |
| 62 |
--Add templates for debug, verbose, help, and version for convenience |
| 63 |
Paranoid::Debug: |
| 64 |
--Modified pdebug to provide support for plog-passing of messages |
| 65 |
--PDPREFIX subroutines are now passed the appropriate caller name during |
| 66 |
invocation |
| 67 |
--Added PDEBUG1 - PDEBUG8 for developer convenience |
| 68 |
Paranoid::Filesystem: |
| 69 |
--Fix pmkdir to treat permissions as explicit, not relative to umask |
| 70 |
--Modified ptranslatePerms to allow it to be passed octal numbers (or string |
| 71 |
representations of octal numbers) and have it return those values |
| 72 |
unmodified. This makes it agnostic to translated or untranslated input. |
| 73 |
Paranoid::Glob: |
| 74 |
--Prune redundant / in paths |
| 75 |
Paranoid::Input: |
| 76 |
--Documented NEWLINE_REGEX |
| 77 |
Paranoid::IO: |
| 78 |
--File locking had some corner cases in which flocks weren't applied. |
| 79 |
Removed that logic entirely, locks are now applied, regardless. |
| 80 |
Paranoid::Log: |
| 81 |
--Added Stdout mechanism that passes log messages to STDOUT |
| 82 |
--Added Stderr mechanism that passes log messages to STDERR |
| 83 |
--Added PDebug mechanism that passes log messages to pdebug, and allows |
| 84 |
for pdebug to be used as a message preprocessor for sprintf functionality |
| 85 |
--Added plverbosity as a convenience function to support Stdout/Stderr |
| 86 |
messages for non-interactive applications |
| 87 |
Paranoid::Process: |
| 88 |
--fixed pfork to make sure the children counters were reset for the child, |
| 89 |
so max children limits apply on a per-process basis. Doing it globally |
| 90 |
was unreliable, especially since children only knew what the parent's |
| 91 |
count was prior to forking. |
| 92 |
|
| 93 |
v2.06 (2018/08/06) |
| 94 |
================== |
| 95 |
--Typos in documentation (Debian Perl Group) |
| 96 |
--Fixed bug in pflock in Paranoid::Process that failed to apply the |
| 97 |
flock as requested |
| 98 |
--Improved pflock testing as used by Paranoid::Log::File |
| 99 |
--Updated Paranoid::IO::Line POD to clarify the third option to many |
| 100 |
functions which control line chomping. |
| 101 |
--Improved Paranoid::Process to constrain SIGCHLD handling to only those |
| 102 |
children forked specifically with/pfork(). This keeps evals and |
| 103 |
miscellaneous system calls from skewing the counter. |
| 104 |
--Fixed pchown tests for platforms that use negative numbers for uid/gid |
| 105 |
|
| 106 |
v2.05 (2017/03/23) |
| 107 |
================== |
| 108 |
--pkmdir would fail when given paths that included . or .. subdirs, |
| 109 |
fixed |
| 110 |
--improved error message from pkmdir to make it obvious what specific |
| 111 |
portion of the path failed |
| 112 |
--fixed a bug in popen where reopening a filehandle that was stored |
| 113 |
under its absolute name deleted the internal cache record |
| 114 |
--fixed sigchld signal preemption so it doesn't miss children exit |
| 115 |
codes |
| 116 |
|
| 117 |
v2.04 (2016/09/19) |
| 118 |
================== |
| 119 |
--Added signal dispatcher functionality to Paranoid::Process |
| 120 |
|
| 121 |
v2.03 (2016/08/09) |
| 122 |
================== |
| 123 |
--Bad plan for non-IPv6-enabled systems |
| 124 |
|
| 125 |
v2.02 (2016/08/09) |
| 126 |
================== |
| 127 |
--Typos in documentation (Debial Perl Group) |
| 128 |
--Regex improvement for IPv6 addresses ([email protected]) |
| 129 |
|
| 130 |
v2.01 (2016/06/23) |
| 131 |
================== |
| 132 |
--Fixed error in prm where files weren't actually deleted if there was a |
| 133 |
previous error in $! that set ENOENT |
| 134 |
--Fixed error in Paranoid::Filesystem where umask was improperly applied |
| 135 |
--Fixed error in popen where mode & perms weren't detainted completely |
| 136 |
--Adjusted log file test to account for some timing issues on some platforms |
| 137 |
--Expanded documentation for Paranoid::Input (documenting known regexes) |
| 138 |
|
| 139 |
v2.00 (2015/10/12) |
| 140 |
================== |
| 141 |
--Dropped support for Perl 5.6 |
| 142 |
--Eliminated most instances of croak/die in favor of expecting developers |
| 143 |
to check the return value |
| 144 |
--Complete rewrite of I/O layers and functions |
| 145 |
--Added Paranoid::IO |
| 146 |
--Added Paranoid::IO::Line |
| 147 |
--Moved slurp, sip, etc., to Paranoid::IO::Line |
| 148 |
--Rewrote slurp, sip, etc., to provide non-locking versions of functions |
| 149 |
--Rewrote slurp, sip, etc., to leverage tuneable performance options from |
| 150 |
Paranoid::IO |
| 151 |
--Rewrote and moved Paranoid::Lockfile to Paranoid::IO::Lockfile |
| 152 |
--Rewrote Paranoid::Log, Paranoid::Log::Buffer, and Paranoid::Log::File |
| 153 |
--Renamed perror to pderror in Paranoid::Debug to avoid name conflict |
| 154 |
with POSIX |
| 155 |
--Added printf functionality to pdebug |
| 156 |
--Added platform-agnostic pchomp to Paranoid::Input |
| 157 |
--Added passed regex functionality to detaint |
| 158 |
--Updated detaint to make target var (third argument) optional |
| 159 |
--Updated detaint to work on arrays and hashes as well |
| 160 |
--Improved/expanded module unit tests |
| 161 |
--Eliminated use of prototypes except where absolutely needed |
| 162 |
(which eliminates the need to pass by reference for many functions) |
| 163 |
--Eliminated pglob from Paranoid::Filesystem. Globs should be handled |
| 164 |
exclusively through Paranoid::Glob. |
| 165 |
--Modified all Paranoid::Filesystem functions to reorder arguments in |
| 166 |
actual order of importance, making optional arguments truly optional |
| 167 |
--Made all Paranoid::Filesystem functions consistent in declaring |
| 168 |
a filesystem target: you can pass either a string or a glob, but if |
| 169 |
specifying disparate targets as a list you must pass it as a |
| 170 |
Paranoid::Glob. |
| 171 |
--Removed Paranoid::BerkeleyDB, Paranoid::Log::Syslog, and |
| 172 |
Paranoid::Log::Email. Those are now in their own CPAN distributions. |
| 173 |
--Added/improved various regexes in Paranoid::Input |
| 174 |
--Improved Paranoid::Network's extractIPs to also extract network |
| 175 |
addresses |
| 176 |
--Added deepCmp to the Paranoid::Data module. |
| 177 |
|
| 178 |
v0.36 (2012/09/24) |
| 179 |
================== |
| 180 |
--Documentation updates |
| 181 |
--Added IPv4/6 sorting functions, supporting string, packed, and |
| 182 |
integer formats |
| 183 |
--Fixed MAXIPV6CIDR constant to 128 |
| 184 |
--Fixed bare words warnings in Perl 5.6 for IPv6 modules |
| 185 |
|
| 186 |
v0.34 (2012/05/29) |
| 187 |
================== |
| 188 |
--Added Paranoid::Network::IPv4 & Paranoid::Network::IPv6 to provide |
| 189 |
general protocol-specific functions |
| 190 |
--Added ipv4NetConvert function to convert IPv4 IPs to native integer |
| 191 |
format, and network ranges to base, broadcast, and netmasks in |
| 192 |
native integer format |
| 193 |
--Added ipv6NetConvert function to convert IPv6 IPs to 32bit integer |
| 194 |
arrays, and network ranges to base, broadcast, and netmasks in |
| 195 |
32bit integer arrays |
| 196 |
--Added ipv4NetIntersect function to test whether two IPv4 IP/network |
| 197 |
address ranges intersect |
| 198 |
--Added ipv6NetIntersect function to test whether two IPv6 IP/network |
| 199 |
address ranges intersect |
| 200 |
--Reworked Paranoid::Network to make use of IPv4/IPv6 modules for |
| 201 |
use in ipInNetwork |
| 202 |
--Added netIntersect to Paranoid::Network, which is an IPv4/IPv6- |
| 203 |
agnostic wrapper for the related functions in the IPv4/IPv6 modules |
| 204 |
--Typo fixed in Paranoid::Network::Socket documentation |
| 205 |
|
| 206 |
v0.33 (2011/12/29) |
| 207 |
================== |
| 208 |
--Detection of imported symbols in the local namespace wasn't working |
| 209 |
correctly. Fixed. |
| 210 |
|
| 211 |
v0.32 (2011/12/19) |
| 212 |
================== |
| 213 |
--Added new wrapper module for simpler, more portable IPv6 support and |
| 214 |
checking (Paranoid::Network::Socket) |
| 215 |
--Modified Paranoid::Network to use Paranoid::Network::Socket, and removed |
| 216 |
Socket, Socket6, and Paranoid::Module dependencies |
| 217 |
--Improved Paranoid::Module to reduce the number of detaints, requires, |
| 218 |
and evals for high frequency calls |
| 219 |
--Improved debug output of Paranoid::Module |
| 220 |
|
| 221 |
v0.31 (2011/12/06) |
| 222 |
================== |
| 223 |
--Use of cached file handles in Paranoid::Lockfile is now fork-safe |
| 224 |
--Use of open databases in Paranoid::BerkeleyDB is now fork-safe |
| 225 |
--Added lock/unlock methods to Paranoid::BerkeleyDB objects for |
| 226 |
multiple operations that need to be atomic |
| 227 |
--Socket6 is no longer needed or looked for if on Perl 5.14 or newer |
| 228 |
|
| 229 |
v0.30 (2011/08/17) |
| 230 |
================== |
| 231 |
--Added file permissions support to BerkekelyDB module |
| 232 |
--Moved flocking of lockfile to the BerkelelyDB internals |
| 233 |
--plock, etc., now returns exit value of flock routine in Lockfile |
| 234 |
--Fixed optional prereqs in generated META.yml file |
| 235 |
--Added CREDITS file (with recognition for Slaven Rezic ([email protected])) |
| 236 |
|
| 237 |
v0.29 (2011/04/15) |
| 238 |
================== |
| 239 |
--Perl-5.6 compatibility fix: Socket in 5.6 doesn't export AF/PF_INET6, |
| 240 |
so using Socket6's exclusively |
| 241 |
--Perl-5.8 compatibility fix: Perl's parser chokes on the use of 'bare |
| 242 |
word' imports (i.e., AF_INET), so calling them as subs. |
| 243 |
--Optimizing regexes with code-based interpolations of constants |
| 244 |
--Misc code adjustments |
| 245 |
|
| 246 |
v0.28 (2011/04/12) |
| 247 |
================== |
| 248 |
--Updated ipInNetwork in Paranoid::Network to support IPv6 networks & |
| 249 |
addresses |
| 250 |
--Added new function extractIPs to Paranoid::Network which can extract IPv4/ |
| 251 |
IPv6 addresses from arbitrary text |
| 252 |
--Minor tweaks to some regexes in Paranoid::Input |
| 253 |
|
| 254 |
v0.27 (2010/06/03) |
| 255 |
================== |
| 256 |
--Added the ability to restrict level of indentation for pdebug messages in |
| 257 |
Paranoid::Debug |
| 258 |
--Fixed pchmod so that relative permissions applied to a symlink doesn't use |
| 259 |
the symlink's permissions to apply, but rather the target |
| 260 |
--Rewrote Paranoid::Log's internals |
| 261 |
--Added '!' as a supported scope for logging facilities |
| 262 |
--Added more severity level aliases |
| 263 |
|
| 264 |
v0.26 (2010/05/08) |
| 265 |
================== |
| 266 |
--Changed daemonize's behavior: reopening STD* on /dev/null and chdir'ing |
| 267 |
to /. Hindsight's 20/20, eh? |
| 268 |
--Made backup/restore of SIGCHLD in pcapture dependent upon an actual |
| 269 |
sighandler being installed |
| 270 |
|
| 271 |
v0.25 (2010/05/05) |
| 272 |
================== |
| 273 |
--Fixed tail's behavior to be consistent with documentation |
| 274 |
--Fixed tail/sip to preserve file position and buffers when |
| 275 |
reopening the file in children |
| 276 |
--Fixed tail functionality to handle deleted, truncated, moved, or replaced |
| 277 |
files |
| 278 |
--Expanded tail/sip documentation |
| 279 |
--Added daemonize function to Paranoid::Process |
| 280 |
|
| 281 |
v0.24 (2010/04/15) |
| 282 |
================== |
| 283 |
|
| 284 |
--Added Paranoid::Glob |
| 285 |
--Major cleanup to satisfy PerlCritic and PerlTidy |
| 286 |
--Fixed pmkdir to allow permissions that include sticky bits, etc. |
| 287 |
--Updated filesystem functions to use Paranoid::Glob instead of pglob |
| 288 |
--pglob is now just a wrapper around Paranoid::Glob as well |
| 289 |
--Removed excessive external locking in Paranoid::BerkeleyDB -- hopefully |
| 290 |
internal CDB locking mechanism is robust enough |
| 291 |
--Made user input validation on Paranoid::Filesystem non-fatal (handing in |
| 292 |
undefs as filenames, etc.) |
| 293 |
--Removed MAXLINKS in Paranoid::Filesystem |
| 294 |
|
| 295 |
|
| 296 |
v0.23 (2009/03/17) |
| 297 |
=================== |
| 298 |
--Fixed tests that weren't fully supported on all platforms |
| 299 |
--Commented out pchown tests which were failing to due to a bug |
| 300 |
in Perl. A patch has been submitted to bleadperl to address it. |
| 301 |
--Added manual detaint of TERM environment variable in psecureEnv |
| 302 |
--Updated documentation to include Paranoid::Data |
| 303 |
--Made getKeys in Paranoid::BerkeleyDB use finer grained locking |
| 304 |
--Added Paranoid::Data |
| 305 |
--Added sip, tail, and closeFile functions |
| 306 |
--Fixed bug in preadDir that added undef records while filtering out |
| 307 |
symlinks (bug introduced in v0.21) |
| 308 |
|
| 309 |
v0.21 (2009/03/04) |
| 310 |
=================== |
| 311 |
--Massive reformat with Perl::Tidy |
| 312 |
--Massive rewrite to accommodate Perl::Critic |
| 313 |
--Converted all tests to use Test::More |
| 314 |
--Converted licensing to be same as Perl |
| 315 |
--Documentation updates |
| 316 |
--Updated to only support Perl 5.6 or better |
| 317 |
--Fixed bug in pcapture to return appropriate return values |
| 318 |
--Fixed bug in pchmodR/pchownR to return correct RV (false) |
| 319 |
with non-existant targets |
| 320 |
--Added Paranoid::Args |
| 321 |
|
| 322 |
v0.20 (2008/04/28) |
| 323 |
=================== |
| 324 |
--Misc. POD updates |
| 325 |
|
| 326 |
Paranoid::Filesystem: |
| 327 |
--Fixed bug in the recursion wrapper where there were errors in certain |
| 328 |
modes when called on a hierarchy that included an empty subdirectory |
| 329 |
--Fixed bug in pchmod where subtracting perms (i.e., o-w) wouldn't result |
| 330 |
in the correct permissions |
| 331 |
--Added automatic argument detainting for most functions |
| 332 |
--Replaced the horrible manual kludge of pglob with an intelligent wrapper for |
| 333 |
the shell glob |
| 334 |
--ptouch now supports full shell globbing, even for non-existent files. |
| 335 |
--ptouchR can now create files, but won't automatically create subdirectories |
| 336 |
|
| 337 |
Paranoid::Input: |
| 338 |
--Added automatic filename detainting for slurp |
| 339 |
--Updated filename/fileglob regexes (expanded allowed characters) |
| 340 |
|
| 341 |
Paranoid::Log & Paranoid::Module: |
| 342 |
--Added automatic detainting of module names |
| 343 |
|
| 344 |
Paranoid::Log::File: |
| 345 |
--Added automatic detainting of log filenames |
| 346 |
|
| 347 |
v0.19 (2008/04/28) |
| 348 |
=================== |
| 349 |
--Made the croak statements more internally consistent |
| 350 |
--Made releasing the lockfiles and db entries in BerkeleyDB more explicit |
| 351 |
--Updated filename regex in Input |
| 352 |
--Added study to stringMatch |
| 353 |
--Added pcapture function to Process |
| 354 |
|
| 355 |
v0.18 (2008/02/29) |
| 356 |
=================== |
| 357 |
--Fixed mail headers for Email module when there are multiple recipients |
| 358 |
--Fixed tests to account for FreeBSD's comments in /etc/passwd, /etc/group |
| 359 |
|
| 360 |
v0.17 (2008/02/28) |
| 361 |
=================== |
| 362 |
--Made more tests conditional to account for more types of |
| 363 |
system configurations |
| 364 |
--Made error checking more explicit for e-mail logging, and storing |
| 365 |
those errors in Paranoid::ERROR |
| 366 |
|
| 367 |
v0.16 (2008/02/27) |
| 368 |
=================== |
| 369 |
--Fixed conditional tests |
| 370 |
--Added new function to Paranoid::Debug (psetDebug) |
| 371 |
|
| 372 |
v0.15 (2008/02/26) |
| 373 |
=================== |
| 374 |
--Initial public release |