1 /*---------------------------------------------------------------------\
3 | |__ / \ / / . \ . \ |
8 \---------------------------------------------------------------------*/
9 /** \file zypp/Digest.h
11 * \todo replace by Blocxx
15 #ifndef ZYPP_MEDIA_DIGEST_H
16 #define ZYPP_MEDIA_DIGEST_H
21 #include <zypp/Callback.h>
22 #include <zypp/Pathname.h>
27 struct DigestReport : public callback::ReportBase
29 virtual bool askUserToAcceptNoDigest( const zypp::Pathname &file );
30 virtual bool askUserToAccepUnknownDigest( const Pathname &file, const std::string &name );
31 virtual bool askUserToAcceptWrongDigest( const Pathname &file, const std::string &requested, const std::string &found );
36 /** \brief Compute Message Digests (MD5, SHA1 etc)
38 * The computation works by initializing the algorithm using create(). This
39 * will construct an internal state. successive calls to update() deliver the
40 * data for which the digest is to be computed. After all data has been
41 * deliverd, a call to digest() finalizes the computation and returns the
51 Digest(const Digest& d);
53 const Digest& operator=(const Digest& d);
59 /** \brief initialize creation of a new message digest
61 * Since openssl is used as backend you may use anything that openssl
62 * supports (see man 1 dgst). Common examples are md5 or sha1. sha1
63 * should be preferred when creating digests to verify the authenticity
66 * successive calls to this funcion will destroy the internal state and
69 * @param name name of the message digest algorithm.
70 * @return whether an error occured
72 bool create(const std::string& name);
74 /** \brief get the name of the current digest algorithm */
75 const std::string& name();
77 /** \brief feed data into digest computation algorithm
80 * @return whether an error occured
82 bool update(const char* bytes, size_t len);
84 /** \brief get hex string representation of the digest
86 * this function will finalize the digest computation. calls to update
87 * after this function will start from scratch
89 * @return hex string representation of the digest
93 /** \brief compute digest of a stream. convenience function
95 * calls create, update and digest in one function. The data for the
96 * computation is read from the stream
98 * @param name name of the digest algorithm, \see create
99 * @param is an input stream to get the data from
100 * @param bufsize size of the buffer used for update(). Be careful, this is on the stack.
101 * @return the digest or empty on error
103 static std::string digest(const std::string& name, std::istream& is, size_t bufsize = 4096);