worktree: use 'worktree' over 'working tree'
[git/debian.git] / gpg-interface.h
blobb30cbdcd3da546888fb1f8f206205c2373ad633b
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 enum payload_type {
19 SIGNATURE_PAYLOAD_UNDEFINED,
20 SIGNATURE_PAYLOAD_COMMIT,
21 SIGNATURE_PAYLOAD_TAG,
22 SIGNATURE_PAYLOAD_PUSH_CERT,
25 struct signature_check {
26 char *payload;
27 size_t payload_len;
28 enum payload_type payload_type;
29 timestamp_t payload_timestamp;
30 char *output;
31 char *gpg_status;
34 * possible "result":
35 * 0 (not checked)
36 * N (checked but no further result)
37 * G (good)
38 * B (bad)
40 char result;
41 char *signer;
42 char *key;
43 char *fingerprint;
44 char *primary_key_fingerprint;
45 enum signature_trust_level trust_level;
48 void signature_check_clear(struct signature_check *sigc);
51 * Look at a GPG signed tag object. If such a signature exists, store it in
52 * signature and the signed content in payload. Return 1 if a signature was
53 * found, and 0 otherwise.
55 int parse_signature(const char *buf, size_t size, struct strbuf *payload, struct strbuf *signature);
58 * Look at GPG signed content (e.g. a signed tag object), whose
59 * payload is followed by a detached signature on it. Return the
60 * offset where the embedded detached signature begins, or the end of
61 * the data when there is no such signature.
63 size_t parse_signed_buffer(const char *buf, size_t size);
66 * Create a detached signature for the contents of "buffer" and append
67 * it after "signature"; "buffer" and "signature" can be the same
68 * strbuf instance, which would cause the detached signature appended
69 * at the end.
71 int sign_buffer(struct strbuf *buffer, struct strbuf *signature,
72 const char *signing_key);
74 int git_gpg_config(const char *, const char *, void *);
75 void set_signing_key(const char *);
76 const char *get_signing_key(void);
79 * Returns a textual unique representation of the signing key in use
80 * Either a GPG KeyID or a SSH Key Fingerprint
82 const char *get_signing_key_id(void);
83 int check_signature(struct signature_check *sigc,
84 const char *signature, size_t slen);
85 void print_signature_buffer(const struct signature_check *sigc,
86 unsigned flags);
88 #endif