hl_sha512wrapper.h 4.2 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143
  1. /*
  2. * hashlib++ - a simple hash library for C++
  3. *
  4. * Copyright (c) 2007-2010 Benjamin Grüdelbach
  5. *
  6. * Redistribution and use in source and binary forms, with or without modification,
  7. * are permitted provided that the following conditions are met:
  8. *
  9. * 1) Redistributions of source code must retain the above copyright
  10. * notice, this list of conditions and the following disclaimer.
  11. *
  12. * 2) Redistributions in binary form must reproduce the above copyright
  13. * notice, this list of conditions and the following disclaimer in
  14. * the documentation and/or other materials provided with the
  15. * distribution.
  16. *
  17. * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
  18. * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
  19. * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
  20. * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
  21. * ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
  22. * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
  23. * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
  24. * ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  25. * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
  26. * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  27. */
  28. //----------------------------------------------------------------------
  29. /**
  30. * @file hl_sha512wrapper.h
  31. * @brief This file contains the definition of the sha512wrapper
  32. * class.
  33. * @date Mo 12 Nov 2007
  34. */
  35. //----------------------------------------------------------------------
  36. //include protection
  37. #ifndef SHA512WRAPPER_H
  38. #define SHA512WRAPPER_H
  39. //----------------------------------------------------------------------
  40. //hashlib++ includes
  41. #include "hl_hashwrapper.h"
  42. #include "hl_sha2ext.h"
  43. //----------------------------------------------------------------------
  44. //STL
  45. #include <string>
  46. //----------------------------------------------------------------------
  47. /**
  48. * @brief This class represents the SHA512 wrapper-class
  49. *
  50. * You can use this class to easily create a sha512 hash.
  51. * Just create an instance of sha512wrapper and call the
  52. * inherited memberfunctions getHashFromString()
  53. * and getHashFromFile() to create a hash based on a
  54. * string or a file.
  55. *
  56. * Have a look at the following example:
  57. *
  58. * @include sha512example.cpp
  59. *
  60. * sha512wrapper implements resetContext(), updateContext()
  61. * and hashIt() to create a hash.
  62. */
  63. class sha512wrapper : public hashwrapper
  64. {
  65. private:
  66. /**
  67. * SHA512 access
  68. * via extended SHA2
  69. */
  70. SHA2ext *sha512;
  71. /**
  72. * SHA512 context
  73. */
  74. HL_SHA512_CTX context;
  75. /**
  76. * @brief This method ends the hash process
  77. * and returns the hash as string.
  78. *
  79. * @return a hash as std::string
  80. */
  81. virtual std::string hashIt(void);
  82. /**
  83. * @brief This internal member-function
  84. * convertes the hash-data to a
  85. * std::string (HEX).
  86. *
  87. * @param data The hash-data to covert into HEX
  88. * @return the converted data as std::string
  89. */
  90. virtual std::string convToString(unsigned char *data);
  91. /**
  92. * @brief This method adds the given data to the
  93. * current hash context
  94. *
  95. * @param data The data to add to the current context
  96. * @param len The length of the data to add
  97. */
  98. virtual void updateContext(unsigned char *data, unsigned int len);
  99. /**
  100. * @brief This method resets the current hash context.
  101. * In other words: It starts a new hash process.
  102. */
  103. virtual void resetContext(void);
  104. /**
  105. * @brief This method should return the hash of the
  106. * test-string "The quick brown fox jumps over the lazy
  107. * dog"
  108. */
  109. virtual std::string getTestHash(void);
  110. public:
  111. /**
  112. * @brief default constructor
  113. */
  114. sha512wrapper();
  115. /**
  116. * @brief default destructor
  117. */
  118. virtual ~sha512wrapper();
  119. };
  120. //----------------------------------------------------------------------
  121. //end of include protection
  122. #endif
  123. //----------------------------------------------------------------------
  124. //EOF