Document Perl libs installation

Add a 'cpanfile' for easy installation of everything needed for running
the various converters.

Add a separate 'cpanfile.pass_gen' for pass_gen.pl as there's a lot of
dependencies and that tool is not a converter.

Add instructions to README-UBUNTU.

Author: magnumripper

doc/INSTALL-UBUNTU

@@ -142,3 +142,7 @@ build CPU fallback chains for any x86-64 CPU.
     (run your converter as needed)
     deactivate
 
+=== Install all Perl libs required for things like keepass2john.pl
+
+    sudo apt install cpanminus
+    cpanm --installdeps .

run/cpanfile

@@ -0,0 +1,43 @@
+# cpanfile for John the Ripper (perl scripts)
+#
+# This file lists dependencies for the .pl scripts in the run/ directory,
+# with the exception of pass_gen.pl, which has its own separate cpanfile.
+# To install dependencies, use a tool like 'cpanm':
+#   cpanm --installdeps .
+#
+# For "pass_gen.pl" there are lots of requirements usually not needed for
+# the casual user. To install them:
+#   cpanm --installdeps < cpanfile.pass_gen
+
+# Required for netntlm.pl (used for NTLMv1/NTLMv2 hash processing)
+requires 'Digest::HMAC', '1.03';
+
+# Required for netntlm.pl and ldap2john.pl
+requires 'MIME::Base64';
+
+# Required for bip39-derive-offline.pl
+requires 'Crypt::PBKDF2';
+
+# Required for hccapx2john.pl and hccap2john.pl
+requires 'Digest::MD5';
+
+# Required for keepass2john.pl
+requires 'XML::Parser';
+
+# Required for radius2john.pl
+requires 'Net::Pcap';
+requires 'NetPacket::IP';
+requires 'Net::Radius::Dictionary';
+requires 'Digest::HMAC_MD5';
+
+# Comments on optional/conditional dependencies:
+# - db2john.pl: Requires a DBI driver like DBD::SQLite if used with SQLite.
+#   This is highly conditional, so it's not listed here. If you use it,
+#   you would 'requires' the specific driver you need, e.g.:
+#   requires 'DBD::SQLite';
+#
+# - wpapcap2john.pl: The script itself does not have explicit 'use' statements
+#   for external Perl modules. It relies on the tshark utility.
+#
+# - sap2john.pl: Requires the SAP RFC SDK, which is not a Perl module
+#   but an external C library. This must be installed separately.~

run/cpanfile.pass_gen

@@ -0,0 +1,38 @@
+# cpanfile for John the Ripper pass_gen.pl
+#
+# cat cpanfile.pass_gen >> cpanfile
+# cpanm --installdeps .
+#
+
+requires 'Convert::EBCDIC';
+requires 'Crypt::AuthEnc::CCM';
+requires 'Crypt::CBC';
+requires 'Crypt::Cipher::AES';
+requires 'Crypt::Cipher::Blowfish';
+requires 'Crypt::DES_EDE3';
+requires 'Crypt::DES_EDE3'; require Crypt::CBC;
+requires 'Crypt::DES';
+requires 'Crypt::Digest::RIPEMD128';
+requires 'Crypt::Digest::RIPEMD160';
+requires 'Crypt::Digest::RIPEMD256';
+requires 'Crypt::Digest::RIPEMD320';
+requires 'Crypt::ECB';
+requires 'Crypt::Eksblowfish::Bcrypt';
+requires 'Crypt::Eksblowfish::Uklblowfish';
+requires 'Crypt::Mode::CFB';
+requires 'Crypt::RC4';
+requires 'Crypt::Rhash';
+requires 'Crypt::ScryptKDF';
+requires 'Crypt::UnixCrypt_XS';
+requires 'Digest::BLAKE2';
+requires 'Digest::GOST';
+requires 'Digest::Haval256';
+requires 'Digest::Keccak';
+requires 'Digest::MD2';
+requires 'Digest::MD4';
+requires 'Digest::MD5';
+requires 'Digest::SHA';
+requires 'Digest::SHA3';
+requires 'Digest::Tiger';
+requires 'Math::BigInt';
+requires 'Net::SSLeay';