The twelfth batch
[git.git] / gpg-interface.h
blob80567e4894868d5d7a192cab0afb9ca9c09cb70d
1 #ifndef GPG_INTERFACE_H
2 #define GPG_INTERFACE_H
4 struct strbuf;
6 #define GPG_VERIFY_VERBOSE 1
7 #define GPG_VERIFY_RAW 2
8 #define GPG_VERIFY_OMIT_STATUS 4
10 enum signature_trust_level {
11 TRUST_UNDEFINED,
12 TRUST_NEVER,
13 TRUST_MARGINAL,
14 TRUST_FULLY,
15 TRUST_ULTIMATE,
18 struct signature_check {
19 char *payload;
20 char *gpg_output;
21 char *gpg_status;
24 * possible "result":
25 * 0 (not checked)
26 * N (checked but no further result)
27 * G (good)
28 * B (bad)
30 char result;
31 char *signer;
32 char *key;
33 char *fingerprint;
34 char *primary_key_fingerprint;
35 enum signature_trust_level trust_level;
38 void signature_check_clear(struct signature_check *sigc);
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.
45 int parse_signature(const char *buf, size_t size, struct strbuf *payload, struct strbuf *signature);
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.
53 size_t parse_signed_buffer(const char *buf, size_t size);
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.
61 int sign_buffer(struct strbuf *buffer, struct strbuf *signature,
62 const char *signing_key);
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);
73 #endif