l10n: zh_TW.po: v2.31.0 round 2 (15 untranslated)
[git] / gpg-interface.h
1 #ifndef GPG_INTERFACE_H
2 #define GPG_INTERFACE_H
3
4 struct strbuf;
5
6 #define GPG_VERIFY_VERBOSE              1
7 #define GPG_VERIFY_RAW                  2
8 #define GPG_VERIFY_OMIT_STATUS  4
9
10 enum signature_trust_level {
11         TRUST_UNDEFINED,
12         TRUST_NEVER,
13         TRUST_MARGINAL,
14         TRUST_FULLY,
15         TRUST_ULTIMATE,
16 };
17
18 struct signature_check {
19         char *payload;
20         char *gpg_output;
21         char *gpg_status;
22
23         /*
24          * possible "result":
25          * 0 (not checked)
26          * N (checked but no further result)
27          * G (good)
28          * B (bad)
29          */
30         char result;
31         char *signer;
32         char *key;
33         char *fingerprint;
34         char *primary_key_fingerprint;
35         enum signature_trust_level trust_level;
36 };
37
38 void signature_check_clear(struct signature_check *sigc);
39
40 /*
41  * Look at a GPG signed tag object.  If such a signature exists, store it in
42  * signature and the signed content in payload.  Return 1 if a signature was
43  * found, and 0 otherwise.
44  */
45 int parse_signature(const char *buf, size_t size, struct strbuf *payload, struct strbuf *signature);
46
47 /*
48  * Look at GPG signed content (e.g. a signed tag object), whose
49  * payload is followed by a detached signature on it.  Return the
50  * offset where the embedded detached signature begins, or the end of
51  * the data when there is no such signature.
52  */
53 size_t parse_signed_buffer(const char *buf, size_t size);
54
55 /*
56  * Create a detached signature for the contents of "buffer" and append
57  * it after "signature"; "buffer" and "signature" can be the same
58  * strbuf instance, which would cause the detached signature appended
59  * at the end.
60  */
61 int sign_buffer(struct strbuf *buffer, struct strbuf *signature,
62                 const char *signing_key);
63
64 int git_gpg_config(const char *, const char *, void *);
65 void set_signing_key(const char *);
66 const char *get_signing_key(void);
67 int check_signature(const char *payload, size_t plen,
68                     const char *signature, size_t slen,
69                     struct signature_check *sigc);
70 void print_signature_buffer(const struct signature_check *sigc,
71                             unsigned flags);
72
73 #endif