security/nss/lib/util/secdig.h@6474c204b198
security/nss/lib/util/secdig.h
Wed, 31 Dec 2014 06:09:35 +0100
- author
- Michael Schloh von Bennewitz <michael@schloh.com>
- date
- Wed, 31 Dec 2014 06:09:35 +0100
- changeset 0
- 6474c204b198
- permissions
- -rw-r--r--
Cloned upstream origin tor-browser at tor-browser-31.3.0esr-4.5-1-build1
revision ID fc1c9ff7c1b2defdbc039f12214767608f46423f for hacking purpose.
1 /*
2 * secdig.h - public prototypes for digest-info functions
3 *
4 * This Source Code Form is subject to the terms of the Mozilla Public
5 * License, v. 2.0. If a copy of the MPL was not distributed with this
6 * file, You can obtain one at http://mozilla.org/MPL/2.0/. */
8 #ifndef _SECDIG_H_
9 #define _SECDIG_H_
11 #include "utilrename.h"
12 #include "secdigt.h"
14 #include "seccomon.h"
15 #include "secasn1t.h"
16 #include "secdert.h"
18 SEC_BEGIN_PROTOS
21 extern const SEC_ASN1Template sgn_DigestInfoTemplate[];
23 SEC_ASN1_CHOOSER_DECLARE(sgn_DigestInfoTemplate)
25 /****************************************/
26 /*
27 ** Digest-info functions
28 */
30 /*
31 ** Create a new digest-info object
32 ** "algorithm" one of SEC_OID_MD2, SEC_OID_MD5, or SEC_OID_SHA1
33 ** "sig" the raw signature data (from MD2 or MD5)
34 ** "sigLen" the length of the signature data
35 **
36 ** NOTE: this is a low level routine used to prepare some data for PKCS#1
37 ** digital signature formatting.
38 **
39 ** XXX It might be nice to combine the create and encode functions.
40 ** I think that is all anybody ever wants to do anyway.
41 */
42 extern SGNDigestInfo *SGN_CreateDigestInfo(SECOidTag algorithm,
43 const unsigned char *sig,
44 unsigned int sigLen);
46 /*
47 ** Destroy a digest-info object
48 */
49 extern void SGN_DestroyDigestInfo(SGNDigestInfo *info);
51 /*
52 ** Encode a digest-info object
53 ** "poolp" is where to allocate the result from; it can be NULL in
54 ** which case generic heap allocation (XP_ALLOC) will be used
55 ** "dest" is where to store the result; it can be NULL, in which case
56 ** it will be allocated (from poolp or heap, as explained above)
57 ** "diginfo" is the object to be encoded
58 ** The return value is NULL if any error occurred, otherwise it is the
59 ** resulting SECItem (either allocated or the same as the "dest" parameter).
60 **
61 ** XXX It might be nice to combine the create and encode functions.
62 ** I think that is all anybody ever wants to do anyway.
63 */
64 extern SECItem *SGN_EncodeDigestInfo(PLArenaPool *poolp, SECItem *dest,
65 SGNDigestInfo *diginfo);
67 /*
68 ** Decode a DER encoded digest info objct.
69 ** didata is thr source of the encoded digest.
70 ** The return value is NULL if an error occurs. Otherwise, a
71 ** digest info object which is allocated within it's own
72 ** pool is returned. The digest info should be deleted
73 ** by later calling SGN_DestroyDigestInfo.
74 */
75 extern SGNDigestInfo *SGN_DecodeDigestInfo(SECItem *didata);
78 /*
79 ** Copy digest info.
80 ** poolp is the arena to which the digest will be copied.
81 ** a is the destination digest, it must be non-NULL.
82 ** b is the source digest
83 ** This function is for copying digests. It allows digests
84 ** to be copied into a specified pool. If the digest is in
85 ** the same pool as other data, you do not want to delete
86 ** the digest by calling SGN_DestroyDigestInfo.
87 ** A return value of SECFailure indicates an error. A return
88 ** of SECSuccess indicates no error occurred.
89 */
90 extern SECStatus SGN_CopyDigestInfo(PLArenaPool *poolp,
91 SGNDigestInfo *a,
92 SGNDigestInfo *b);
94 /*
95 ** Compare two digest-info objects, returning the difference between
96 ** them.
97 */
98 extern SECComparison SGN_CompareDigestInfo(SGNDigestInfo *a, SGNDigestInfo *b);
101 SEC_END_PROTOS
103 #endif /* _SECDIG_H_ */
