Mercurial > octave
view libinterp/corefcn/hash.cc @ 31221:f5755dbacd8d
maint: merge stable to default
author | Pantxo Diribarne <pantxo.diribarne@gmail.com> |
---|---|
date | Wed, 31 Aug 2022 22:04:02 +0200 |
parents | 32d2b6604a9f |
children | e88a07dec498 |
line wrap: on
line source
//////////////////////////////////////////////////////////////////////// // // Copyright (C) 2007-2022 The Octave Project Developers // // See the file COPYRIGHT.md in the top-level directory of this // distribution or <https://octave.org/copyright/>. // // This file is part of Octave. // // Octave is free software: you can redistribute it and/or modify it // under the terms of the GNU General Public License as published by // the Free Software Foundation, either version 3 of the License, or // (at your option) any later version. // // Octave is distributed in the hope that it will be useful, but // WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU General Public License for more details. // // You should have received a copy of the GNU General Public License // along with Octave; see the file COPYING. If not, see // <https://www.gnu.org/licenses/>. // //////////////////////////////////////////////////////////////////////// /* Implementation note (Dec, 2015): All supported cryptographic hash functions are calling "low-level" implementations of the GNULIB. The GNULIB, contains even more HMAC based algorithms, c.f. https://www.gnu.org/software/gnulib/MODULES.html#module=crypto/hmac-md5 so a future project might be including these algorithms as well, adding a third key input parameter. There is also a GNULIB "high-level" interface to Libcrypt. It might be easier to use, but it introduces a new build dependency, so better stick to the "low-level" functions for now. */ #if defined (HAVE_CONFIG_H) # include "config.h" #endif #include <string> #include "lo-hash.h" #include "defun.h" #include "error.h" #include "ov.h" #include "ovl.h" OCTAVE_NAMESPACE_BEGIN DEFUN (hash, args, , doc: /* -*- texinfo -*- @deftypefn {} {@var{hashval} =} hash ("@var{hashfcn}", @var{str}) Calculate the hash value of the string @var{str} using the hash function @var{hashfcn}. The available hash functions are given in the table below. @table @samp @item MD2 Message-Digest Algorithm 2 (RFC 1319). @item MD4 Message-Digest Algorithm 4 (RFC 1320). @item MD5 Message-Digest Algorithm 5 (RFC 1321). @item SHA1 Secure Hash Algorithm 1 (RFC 3174) @item SHA224 Secure Hash Algorithm 2 (224 Bits, RFC 3874) @item SHA256 Secure Hash Algorithm 2 (256 Bits, RFC 6234) @item SHA384 Secure Hash Algorithm 2 (384 Bits, RFC 6234) @item SHA512 Secure Hash Algorithm 2 (512 Bits, RFC 6234) @end table To calculate for example the MD5 hash value of the string @nospell{@qcode{"abc"}} the @code{hash} function is called as follows: @example @group hash ("md5", "abc") @print{} ans = 900150983cd24fb0d6963f7d28e17f72 @end group @end example For the same string, the SHA-1 hash value is calculated with: @example @group hash ("sha1", "abc") @print{} ans = a9993e364706816aba3e25717850c26c9cd0d89d @end group @end example And to compute the hash value of a file, e.g., @code{file = "file.txt"}, call @code{hash} in combination with the @code{fileread}: @example @group hash ("md5", fileread (file)); @end group @end example @end deftypefn */) { if (args.length () != 2) print_usage (); std::string hash_type = args(0).string_value (); std::string str = args(1).string_value (); return ovl (crypto::hash (hash_type, str)); } /* ## MD2 test suite (RFC 1319) %!assert (hash ("md2", ""), "8350e5a3e24c153df2275c9f80692773") %!assert (hash ("md2", "a"), "32ec01ec4a6dac72c0ab96fb34c0b5d1") %!assert (hash ("md2", "abc"), "da853b0d3f88d99b30283a69e6ded6bb") %!assert (hash ("md2", "message digest"), "ab4f496bfb2a530b219ff33031fe06b0") %!assert (hash ("md2", "abcdefghijklmnopqrstuvwxyz"), %! "4e8ddff3650292ab5a4108c3aa47940b"); %!assert (hash ("md2", ["ABCDEFGHIJKLMNOPQRSTUVWXYZ", ... %! "abcdefghijklmnopqrstuvwxyz0123456789"]), %! "da33def2a42df13975352846c30338cd"); %!assert (hash ("md2", ["123456789012345678901234567890123456789", ... %! "01234567890123456789012345678901234567890"]), %! "d5976f79d83d3a0dc9806c3c66f3efd8"); ## MD4 test suite (RFC 1320) %!assert (hash ("md4", ""), "31d6cfe0d16ae931b73c59d7e0c089c0") %!assert (hash ("md4", "a"), "bde52cb31de33e46245e05fbdbd6fb24") %!assert (hash ("md4", "abc"), "a448017aaf21d8525fc10ae87aa6729d") %!assert (hash ("md4", "message digest"), "d9130a8164549fe818874806e1c7014b") %!assert (hash ("md4", "abcdefghijklmnopqrstuvwxyz"), %! "d79e1c308aa5bbcdeea8ed63df412da9"); %!assert (hash ("md4", ["ABCDEFGHIJKLMNOPQRSTUVWXYZ", ... %! "abcdefghijklmnopqrstuvwxyz0123456789"]), %! "043f8582f241db351ce627e153e7f0e4"); %!assert (hash ("md4", ["123456789012345678901234567890123456789", ... %! "01234567890123456789012345678901234567890"]), %! "e33b4ddc9c38f2199c3e7b164fcc0536"); ## MD5 test suite (RFC 1321) %!assert (hash ("md5", ""), "d41d8cd98f00b204e9800998ecf8427e") %!assert (hash ("md5", "a"), "0cc175b9c0f1b6a831c399e269772661") %!assert (hash ("md5", "abc"), "900150983cd24fb0d6963f7d28e17f72") %!assert (hash ("md5", "message digest"), "f96b697d7cb7938d525a2f31aaf161d0") %!assert (hash ("md5", "abcdefghijklmnopqrstuvwxyz"), %! "c3fcd3d76192e4007dfb496cca67e13b"); %!assert (hash ("md5", ["ABCDEFGHIJKLMNOPQRSTUVWXYZ", ... %! "abcdefghijklmnopqrstuvwxyz0123456789"]), %! "d174ab98d277d9f5a5611c2c9f419d9f"); %!assert (hash ("md5", ["123456789012345678901234567890123456789", ... %! "01234567890123456789012345678901234567890"]), %! "57edf4a22be3c955ac49da2e2107b67a"); ## SHA1 test suite (RFC 3174) and more %!assert (hash ("sha1", ""), "da39a3ee5e6b4b0d3255bfef95601890afd80709") %!assert (hash ("sha1", "a"), "86f7e437faa5a7fce15d1ddcb9eaeaea377667b8") %!assert (hash ("sha1", "abc"), "a9993e364706816aba3e25717850c26c9cd0d89d") %!assert (hash ("sha1", ["abcdbcdecdefdefgefghfghighijhi", ... %! "jkijkljklmklmnlmnomnopnopq"]), %! "84983e441c3bd26ebaae4aa1f95129e5e54670f1"); %!assert (hash ("sha1", ["01234567012345670123456701234567", ... %! "01234567012345670123456701234567"]), %! "e0c094e867ef46c350ef54a7f59dd60bed92ae83"); %!assert (hash ("sha1", "The quick brown fox jumps over the lazy dog"), %! "2fd4e1c67a2d28fced849ee1bb76e7391b93eb12"); ## SHA224 test suite (RFC 3874) and more %!assert (hash ("sha224", ""), %! "d14a028c2a3a2bc9476102bb288234c415a2b01f828ea62ac5b3e42f"); %!assert (hash ("sha224", "a"), %! "abd37534c7d9a2efb9465de931cd7055ffdb8879563ae98078d6d6d5"); %!assert (hash ("sha224", "abc"), %! "23097d223405d8228642a477bda255b32aadbce4bda0b3f7e36c9da7"); %!assert (hash ("sha224", ["abcdbcdecdefdefgefghfghighijh", ... %! "ijkijkljklmklmnlmnomnopnopq"]), %! "75388b16512776cc5dba5da1fd890150b0c6455cb4f58b1952522525"); ## SHA256/384/512 tests (RFC 6234) and more %!assert (hash ("sha256", ""), %! "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855"); %!assert (hash ("sha384", ""), %! ["38b060a751ac96384cd9327eb1b1e36a21fdb71114be07434c0cc", ... %! "7bf63f6e1da274edebfe76f65fbd51ad2f14898b95b"]); %!assert (hash ("sha512", ""), %! ["cf83e1357eefb8bdf1542850d66d8007d620e4050b5715dc83f4a", ... %! "921d36ce9ce47d0d13c5d85f2b0ff8318d2877eec2f63b931bd47", ... %! "417a81a538327af927da3e"]); ## Test special character behavior %!assert <*31689> (hash ("md2", "abc\0"), "5a636d615002a7874ac1c9e9a43361f7") %!assert <*31689> (hash ("md4", "abc\0"), "0ee5201897ecb206c4eaba1d2da5224d") %!assert <*31689> (hash ("md5", "abc\0"), "147a664a2ca9410911e61986d3f0d52a") %!assert <*31689> (hash ("sha1", "abc\0"), %! "686483805ac47ca14e03514f7481a7973b401762") %!assert <*31689> (hash ("sha224", "abc\0"), %! "fbc8e47920e108bb1d0b631d18b36ae9b1549d28362aa15ebe960cfb"); %!assert <*31689> (hash ("sha256", "abc\0"), %! "dc1114cd074914bd872cc1f9a23ec910ea2203bc79779ab2e17da25782a624fc"); %!assert <*31689> (hash ("sha384", "abc\0"), %! ["eba81f2dfba4ec60d3f786c89d91b08e6c0b63d55986874378e385", ... %! "e6fac587cce7a520ca9437290fe626cbf75c855e17"]); %!assert <*31689> (hash ("sha512", "abc\0"), %! ["7ce05eda233e545a2d5c626862a5ddaafb09b9d8ec3bec08aa458b", ... %! "7c9e7d939d84a57d5a20d8a9002983aabae2457b19c50ba326bf5b", ... %! "081f75b41342f42c3383"]); ## Test equivalence to deprecated md5sum offering file hashing %!test %! tfile = tempname (); %! fid = fopen (tfile, "wb"); %! fwrite (fid, "abc\0"); %! fclose (fid); %! assert (hash ("md5", fileread (tfile)), "147a664a2ca9410911e61986d3f0d52a"); %! unlink (tfile); ## Test bad function calls %!error hash () %!error hash ("") %!error hash ("", "") %!error hash ("", "", "") %!error hash (1, "") %!error hash ([1, 0; 0, 1], "") %!error hash ("unknown", "") %!error hash ("md5") %!error hash ("sha1") %!error hash ("sha512") */ OCTAVE_NAMESPACE_END