#include <string.h>
Go to the source code of this file.
Text from RFC-2440 in comments is Copyright (C) The Internet Society (1998). All Rights Reserved.
Definition in file rpmpgp.h.
#define PGPARMOR_ERROR PGPARMOR_ERR_NO_BEGIN_PGP |
typedef struct DIGEST_CTX_s* DIGEST_CTX |
typedef enum pgpArmor_e pgpArmor |
typedef enum pgpArmorKey_e pgpArmorKey |
typedef enum pgpCompressAlgo_e pgpCompressAlgo |
typedef enum pgpHashAlgo_e pgpHashAlgo |
typedef struct pgpPktCdata_s pgpPktCdata |
typedef struct pgpPktEdata_s pgpPktEdata |
typedef union pgpPktKey_u pgpPktKey |
typedef struct pgpPktKeyV3_s * pgpPktKeyV3 |
typedef struct pgpPktKeyV4_s * pgpPktKeyV4 |
typedef struct pgpPktLdata_s pgpPktLdata |
typedef struct pgpPktOnepass_s * pgpPktOnepass |
typedef struct pgpPktPubkey_s pgpPktPubkey |
typedef union pgpPktSig_u * pgpPktSig |
typedef struct pgpPktSigV3_s * pgpPktSigV3 |
typedef struct pgpPktSigV4_s * pgpPktSigV4 |
typedef struct pgpPktSymkey_s pgpPktSymkey |
typedef struct pgpPktTrust_s pgpPktTrust |
typedef struct pgpPktUid_s pgpPktUid |
typedef enum pgpPubkeyAlgo_e pgpPubkeyAlgo |
typedef enum pgpSigType_e pgpSigType |
typedef enum pgpSubType_e pgpSubType |
typedef enum pgpSymkeyAlgo_e pgpSymkeyAlgo |
typedef struct pgpValTbl_s * pgpValTbl |
enum pgpArmor_e |
enum pgpArmorKey_e |
enum pgpCompressAlgo_e |
9.3.
Compression Algorithms
ID Algorithm -- --------- 0 - Uncompressed 1 - ZIP (RFC 1951) 2 - ZLIB (RFC 1950) 100 to 110 - Private/Experimental algorithm.
Implementations MUST implement uncompressed data. Implementations SHOULD implement ZIP. Implementations MAY implement ZLIB.
enum pgpHashAlgo_e |
9.4.
Hash Algorithms
ID Algorithm Text Name -- --------- ---- ---- 1 - MD5 "MD5" 2 - SHA-1 "SHA1" 3 - RIPE-MD/160 "RIPEMD160" 4 - Reserved for double-width SHA (experimental) 5 - MD2 "MD2" 6 - Reserved for TIGER/192 "TIGER192" 7 - Reserved for HAVAL (5 pass, 160-bit) "HAVAL-5-160" 100 to 110 - Private/Experimental algorithm.
Implementations MUST implement SHA-1. Implementations SHOULD implement MD5.
enum pgpPubkeyAlgo_e |
9.1.
Public Key Algorithms
ID Algorithm -- --------- 1 - RSA (Encrypt or Sign) 2 - RSA Encrypt-Only 3 - RSA Sign-Only 16 - Elgamal (Encrypt-Only), see [ELGAMAL] 17 - DSA (Digital Signature Standard) 18 - Reserved for Elliptic Curve 19 - Reserved for ECDSA 20 - Elgamal (Encrypt or Sign) 21 - Reserved for Diffie-Hellman (X9.42, as defined for IETF-S/MIME) 100 to 110 - Private/Experimental algorithm.
Implementations MUST implement DSA for signatures, and Elgamal for encryption. Implementations SHOULD implement RSA keys. Implementations MAY implement any other algorithm.
enum pgpSigType_e |
5.2.1.
Signature Types
There are a number of possible meanings for a signature, which are specified in a signature type octet in any given signature.
enum pgpSubType_e |
5.2.3.1.
Signature Subpacket Specification
The subpacket fields consist of zero or more signature subpackets. Each set of subpackets is preceded by a two-octet scalar count of the length of the set of subpackets.
Each subpacket consists of a subpacket header and a body. The header consists of:
The length includes the type octet but not this length. Its format is similar to the "new" format packet header lengths, but cannot have partial body lengths. That is:
if the 1st octet < 192, then lengthOfLength = 1 subpacketLen = 1st_octet if the 1st octet >= 192 and < 255, then lengthOfLength = 2 subpacketLen = ((1st_octet - 192) << 8) + (2nd_octet) + 192 if the 1st octet = 255, then lengthOfLength = 5 subpacket length = [four-octet scalar starting at 2nd_octet]
The value of the subpacket type octet may be:
2 = signature creation time 3 = signature expiration time 4 = exportable certification 5 = trust signature 6 = regular expression 7 = revocable 9 = key expiration time 10 = placeholder for backward compatibility 11 = preferred symmetric algorithms 12 = revocation key 16 = issuer key ID 20 = notation data 21 = preferred hash algorithms 22 = preferred compression algorithms 23 = key server preferences 24 = preferred key server 25 = primary user id 26 = policy URL 27 = key flags 28 = signer's user id 29 = reason for revocation 100 to 110 = internal or user-defined
An implementation SHOULD ignore any subpacket of a type that it does not recognize.
Bit 7 of the subpacket type is the "critical" bit. If set, it denotes that the subpacket is one that is critical for the evaluator of the signature to recognize. If a subpacket is encountered that is marked critical but is unknown to the evaluating software, the evaluator SHOULD consider the signature to be in error.
enum pgpSymkeyAlgo_e |
9.2.
Symmetric Key Algorithms
ID Algorithm -- --------- 0 - Plaintext or unencrypted data 1 - IDEA [IDEA] 2 - Triple-DES (DES-EDE, as per spec - 168 bit key derived from 192) 3 - CAST5 (128 bit key, as per RFC 2144) 4 - Blowfish (128 bit key, 16 rounds) [BLOWFISH] 5 - SAFER-SK128 (13 rounds) [SAFER] 6 - Reserved for DES/SK 7 - Reserved for AES with 128-bit key 8 - Reserved for AES with 192-bit key 9 - Reserved for AES with 256-bit key 100 to 110 - Private/Experimental algorithm.
Implementations MUST implement Triple-DES. Implementations SHOULD implement IDEA and CAST5. Implementations MAY implement any other algorithm.
enum pgpTag_e |
4.3.
Packet Tags
The packet tag denotes what type of packet the body holds. Note that old format headers can only have tags less than 16, whereas new format headers can have tags as great as 63.
char* pgpArmorWrap | ( | int | atype, | |
const unsigned char * | s, | |||
size_t | ns | |||
) |
Wrap a OpenPGP packets in ascii armor for transport.
atype | type of armor | |
s | binary pkt data | |
ns | binary pkt data length |
Definition at line 1285 of file rpmpgp.c.
References _free(), pgpValStr(), stpcpy(), pgpValTbl_s::val, VERSION, and xmalloc().
Referenced by armorFormat().
void pgpCleanDig | ( | pgpDig | dig | ) |
Release (malloc'd) data from container.
dig | container |
Definition at line 1021 of file rpmpgp.c.
References _free(), pgpDig_s::c, pgpDigParams_s::hash, pgpDig_s::hm, pgpDig_s::m, pgpDig_s::md5, pgpDigParams_s::params, pgpDig_s::pubkey, pgpDig_s::r, pgpDig_s::rsa_pk, pgpDig_s::rsahm, pgpDig_s::s, pgpDig_s::sha1, pgpDig_s::signature, and pgpDigParams_s::userid.
Referenced by pgpFreeDig(), and rpmVerifySignatures().
static unsigned int pgpCRC | ( | const byte * | octets, | |
size_t | len | |||
) | [inline, static] |
Return CRC of a buffer.
octets | bytes | |
len | no. of bytes |
Definition at line 1367 of file rpmpgp.h.
References CRC24_INIT, and CRC24_POLY.
Referenced by pgpReadPkts().
Destroy a container for parsed OpenPGP packates.
dig | container |
Definition at line 1056 of file rpmpgp.c.
References _free(), pgpDig_s::c, pgpDig_s::g, pgpDig_s::hdrmd5ctx, pgpDig_s::hdrsha1ctx, pgpDig_s::hm, pgpDig_s::m, pgpDig_s::md5ctx, pgpDig_s::p, pgpCleanDig(), pgpDig_s::q, pgpDig_s::r, rpmDigestFinal(), pgpDig_s::rsa_pk, pgpDig_s::s, pgpDig_s::sha1ctx, and pgpDig_s::y.
Referenced by getSignid(), makeGPGSignature(), makePGPSignature(), pgpsigFormat(), rpmcliImportPubkey(), and rpmtsCleanDig().
static unsigned int pgpGrab | ( | const byte * | s, | |
int | nbytes | |||
) | [inline, static] |
Return (native-endian) integer from big-endian representation.
s | pointer to big-endian integer | |
nbytes | no. of bytes |
Definition at line 994 of file rpmpgp.h.
Referenced by pgpLen(), pgpMpiStr(), pgpPrtKey(), pgpPrtPkt(), pgpPrtSig(), pgpPrtSubType(), pgpReadPkts(), pgpsigFormat(), rpmtsFindPubkey(), and rpmtsStashKeyid().
static char* pgpHexCvt | ( | char * | t, | |
const byte * | s, | |||
int | nbytes | |||
) | [inline, static] |
Convert to hex.
t | target buffer (returned) | |
s | source bytes | |
nbytes | no. of bytes |
Definition at line 1064 of file rpmpgp.h.
Referenced by pgpHexStr(), pgpMpiHex(), pgpMpiStr(), verifyDSASignature(), verifyMD5Signature(), and verifyRSASignature().
static char* pgpHexStr | ( | const byte * | p, | |
unsigned int | plen | |||
) | [inline, static] |
Return hex formatted representation of bytes.
p | bytes | |
plen | no. of bytes |
Definition at line 1088 of file rpmpgp.h.
References pgpHexCvt().
Referenced by pgpPrtHex(), pgpPrtSig(), pgpsigFormat(), rpmcliImportPubkey(), rpmReSign(), and rpmtsFindPubkey().
static int pgpIsPkt | ( | const byte * | p | ) | [inline, static] |
Is buffer at beginning of an OpenPGP packet?
p | buffer |
Definition at line 1305 of file rpmpgp.h.
References PGPTAG_COMMENT, PGPTAG_COMMENT_OLD, PGPTAG_COMPRESSED_DATA, PGPTAG_CONTROL, PGPTAG_ENCRYPTED_MDC, PGPTAG_LITERAL_DATA, PGPTAG_MARKER, PGPTAG_MDC, PGPTAG_ONEPASS_SIGNATURE, PGPTAG_PHOTOID, PGPTAG_PRIVATE_60, PGPTAG_PRIVATE_62, PGPTAG_PUBLIC_KEY, PGPTAG_PUBLIC_SESSION_KEY, PGPTAG_PUBLIC_SUBKEY, PGPTAG_RESERVED, PGPTAG_SECRET_KEY, PGPTAG_SECRET_SUBKEY, PGPTAG_SIGNATURE, PGPTAG_SYMMETRIC_DATA, PGPTAG_SYMMETRIC_SESSION_KEY, PGPTAG_TRUST, PGPTAG_USER_ID, and pgpValTbl_s::val.
Referenced by pgpReadPkts().
static int pgpLen | ( | const byte * | s, | |
unsigned int * | lenp | |||
) | [inline, static] |
Return length of an OpenPGP packet.
s | pointer to packet |
*lenp | no. of bytes in packet |
Definition at line 1013 of file rpmpgp.h.
References pgpGrab().
Referenced by pgpPrtPkt(), pgpPrtSubType(), and pgpsigFormat().
static unsigned int pgpMpiBits | ( | const byte * | p | ) | [inline, static] |
Return no.
of bits in a multiprecision integer.
p | pointer to multiprecision integer |
Definition at line 1036 of file rpmpgp.h.
Referenced by pgpHexSet(), and pgpMpiLen().
static unsigned int pgpMpiLen | ( | const byte * | p | ) | [inline, static] |
Return no.
of bytes in a multiprecision integer.
p | pointer to multiprecision integer |
Definition at line 1049 of file rpmpgp.h.
References pgpMpiBits().
Referenced by pgpMpiHex(), pgpMpiStr(), pgpPrtPubkeyParams(), pgpPrtSeckeyParams(), pgpPrtSigParams(), and pgpPubkeyFingerprint().
static const char* pgpMpiStr | ( | const byte * | p | ) | [inline, static] |
Return hex formatted representation of a multiprecision integer.
p | bytes |
Definition at line 1104 of file rpmpgp.h.
References pgpGrab(), pgpHexCvt(), and pgpMpiLen().
Referenced by pgpPrtPubkeyParams(), pgpPrtSeckeyParams(), and pgpPrtSigParams().
pgpDig pgpNewDig | ( | void | ) |
Create a container for parsed OpenPGP packates.
Definition at line 1014 of file rpmpgp.c.
References xcalloc().
Referenced by getSignid(), makeGPGSignature(), makePGPSignature(), pgpsigFormat(), rpmcliImportPubkey(), and rpmtsDig().
Print/parse an OpenPGP comment packet.
tag | packet tag | |
h | packet contents | |
hlen | packet length (no. of bytes) |
Definition at line 844 of file rpmpgp.c.
References _print, pgpPrtHex(), pgpPrtNL(), and pgpPrtVal().
Referenced by pgpPrtPkt().
Print/parse an OpenPGP key packet.
tag | packet tag | |
h | packet contents | |
hlen | packet length (no. of bytes) |
Definition at line 765 of file rpmpgp.c.
References _print, pgpGrab(), pgpPrtNL(), pgpPrtPubkeyParams(), pgpPrtSeckeyParams(), pgpPrtVal(), PGPTAG_PUBLIC_KEY, PGPTAG_PUBLIC_SUBKEY, pgpPktKeyV4_s::pubkey_algo, pgpDigParams_s::pubkey_algo, pgpPktKeyV3_s::pubkey_algo, pgpDigParams_s::tag, pgpPktKeyV4_s::time, pgpDigParams_s::time, pgpPktKeyV3_s::time, pgpPktKeyV3_s::valid, pgpPktKeyV4_s::version, pgpPktKeyV3_s::version, and pgpDigParams_s::version.
Referenced by pgpPrtPkt().
int pgpPrtPkt | ( | const byte * | pkt, | |
unsigned int | pleft | |||
) |
Print/parse next OpenPGP packet.
pkt | OpenPGP packet | |
pleft | no. bytes remaining |
Definition at line 932 of file rpmpgp.c.
References PGPDIG_SAVED_ID, pgpGrab(), pgpLen(), pgpPrtComment(), pgpPrtHex(), pgpPrtKey(), pgpPrtNL(), pgpPrtSig(), pgpPrtUserID(), pgpPrtVal(), pgpPubkeyFingerprint(), PGPTAG_COMMENT, PGPTAG_COMMENT_OLD, PGPTAG_COMPRESSED_DATA, PGPTAG_CONTROL, PGPTAG_ENCRYPTED_MDC, PGPTAG_LITERAL_DATA, PGPTAG_MARKER, PGPTAG_MDC, PGPTAG_PHOTOID, PGPTAG_PRIVATE_60, PGPTAG_PRIVATE_62, PGPTAG_PUBLIC_KEY, PGPTAG_PUBLIC_SESSION_KEY, PGPTAG_PUBLIC_SUBKEY, PGPTAG_RESERVED, PGPTAG_SECRET_KEY, PGPTAG_SECRET_SUBKEY, PGPTAG_SIGNATURE, PGPTAG_SYMMETRIC_DATA, PGPTAG_SYMMETRIC_SESSION_KEY, PGPTAG_TRUST, PGPTAG_USER_ID, pgpDigParams_s::saved, pgpDigParams_s::signid, and pgpValTbl_s::val.
Referenced by pgpPrtPkts().
Print/parse a OpenPGP packet(s).
pkts | OpenPGP packet(s) | |
pktlen | OpenPGP packet(s) length (no. of bytes) |
dig | parsed output of signature/pubkey packet parameters |
printing | should packets be printed? |
Definition at line 1109 of file rpmpgp.c.
References _print, pgpPrtPkt(), PGPTAG_SIGNATURE, pgpDig_s::pubkey, pgpDig_s::signature, pgpDigParams_s::tag, and pgpValTbl_s::val.
Referenced by getSignid(), headerCheck(), makeGPGSignature(), makePGPSignature(), pgpsigFormat(), rpmcliImportPubkey(), rpmReadPackageFile(), rpmts_PgpPrtPkts(), rpmtsFindPubkey(), and rpmVerifySignatures().
Print/parse an OpenPGP signature packet.
tag | packet tag | |
h | packet contents | |
hlen | packet length (no. of bytes) |
Definition at line 467 of file rpmpgp.c.
References _debug, _print, pgpDigParams_s::hash, pgpPktSigV4_s::hash_algo, pgpDigParams_s::hash_algo, pgpPktSigV3_s::hash_algo, pgpPktSigV4_s::hashlen, pgpDigParams_s::hashlen, pgpPktSigV3_s::hashlen, pgpGrab(), pgpHexStr(), pgpPrtHex(), pgpPrtNL(), pgpPrtSigParams(), pgpPrtSubType(), pgpPrtVal(), pgpPktSigV4_s::pubkey_algo, pgpDigParams_s::pubkey_algo, pgpPktSigV3_s::pubkey_algo, pgpDigParams_s::signhash16, pgpPktSigV3_s::signhash16, pgpDigParams_s::signid, pgpPktSigV3_s::signid, pgpPktSigV4_s::sigtype, pgpDigParams_s::sigtype, pgpPktSigV3_s::sigtype, pgpDigParams_s::time, pgpPktSigV3_s::time, pgpPktSigV4_s::version, pgpPktSigV3_s::version, pgpDigParams_s::version, and xmalloc().
Referenced by pgpPrtPkt().
int pgpPrtSubType | ( | const byte * | h, | |
unsigned int | hlen, | |||
pgpSigType | sigtype | |||
) |
Print/parse an OpenPGP subtype packet.
h | packet | |
hlen | packet length (no. of bytes) | |
sigtype | signature type |
Definition at line 296 of file rpmpgp.c.
References _print, PGPDIG_SAVED_ID, PGPDIG_SAVED_TIME, pgpGrab(), pgpLen(), pgpPrtHex(), pgpPrtNL(), pgpPrtVal(), PGPSIGTYPE_BINARY, PGPSIGTYPE_POSITIVE_CERT, PGPSIGTYPE_STANDALONE, PGPSIGTYPE_TEXT, PGPSUBTYPE_ARR, PGPSUBTYPE_CRITICAL, PGPSUBTYPE_EMBEDDED_SIG, PGPSUBTYPE_EXPORTABLE_CERT, PGPSUBTYPE_FEATURES, PGPSUBTYPE_INTERNAL_100, PGPSUBTYPE_INTERNAL_101, PGPSUBTYPE_INTERNAL_102, PGPSUBTYPE_INTERNAL_103, PGPSUBTYPE_INTERNAL_104, PGPSUBTYPE_INTERNAL_105, PGPSUBTYPE_INTERNAL_106, PGPSUBTYPE_INTERNAL_107, PGPSUBTYPE_INTERNAL_108, PGPSUBTYPE_INTERNAL_109, PGPSUBTYPE_INTERNAL_110, PGPSUBTYPE_ISSUER_KEYID, PGPSUBTYPE_KEY_EXPIRE_TIME, PGPSUBTYPE_KEY_FLAGS, PGPSUBTYPE_KEYSERVER_PREFERS, PGPSUBTYPE_NOTATION, PGPSUBTYPE_POLICY_URL, PGPSUBTYPE_PREFER_COMPRESS, PGPSUBTYPE_PREFER_HASH, PGPSUBTYPE_PREFER_KEYSERVER, PGPSUBTYPE_PREFER_SYMKEY, PGPSUBTYPE_PRIMARY_USERID, PGPSUBTYPE_REGEX, PGPSUBTYPE_REVOCABLE, PGPSUBTYPE_REVOKE_KEY, PGPSUBTYPE_REVOKE_REASON, PGPSUBTYPE_SIG_CREATE_TIME, PGPSUBTYPE_SIG_EXPIRE_TIME, PGPSUBTYPE_SIGNER_USERID, PGPSUBTYPE_TRUST_SIG, pgpDigParams_s::saved, pgpDigParams_s::signid, and pgpDigParams_s::time.
Referenced by pgpPrtSig().
Print/parse an OpenPGP userid packet.
tag | packet tag | |
h | packet contents | |
hlen | packet length (no. of bytes) |
Definition at line 827 of file rpmpgp.c.
References _print, pgpPrtNL(), pgpPrtVal(), pgpDigParams_s::userid, and xmalloc().
Referenced by pgpPrtPkt().
Print an OpenPGP value.
pre | output prefix | |
vs | table of (string,value) pairs | |
val | byte value to print |
Definition at line 237 of file rpmpgp.c.
References _print, and pgpValStr().
Referenced by pgpPrtComment(), pgpPrtKey(), pgpPrtPkt(), pgpPrtSeckeyParams(), pgpPrtSig(), pgpPrtSubType(), and pgpPrtUserID().
Calculate OpenPGP public key fingerprint.
pkt | OpenPGP packet (i.e. PGPTAG_PUBLIC_KEY) | |
pktlen | OpenPGP packet length (no. of bytes) |
keyid | publick key fingerprint |
Definition at line 870 of file rpmpgp.c.
References PGPHASHALGO_SHA1, pgpMpiLen(), PGPPUBKEYALGO_DSA, PGPPUBKEYALGO_RSA, pgpPktKeyV4_s::pubkey_algo, pgpPktKeyV3_s::pubkey_algo, RPMDIGEST_NONE, rpmDigestFinal(), rpmDigestInit(), and rpmDigestUpdate().
Referenced by pgpPrtPkt().
Parse armored OpenPGP packets from a file.
fn | file name |
pkt | dearmored OpenPGP packet(s) | |
pktlen | dearmored OpenPGP packet(s) length in bytes |
Definition at line 1138 of file rpmpgp.c.
References _free(), PGPARMOR_ERR_BODY_DECODE, PGPARMOR_ERR_CRC_CHECK, PGPARMOR_ERR_CRC_DECODE, PGPARMOR_ERR_NO_BEGIN_PGP, PGPARMOR_ERR_NO_END_PGP, PGPARMOR_ERR_UNKNOWN_ARMOR_TYPE, PGPARMOR_NONE, PGPARMOR_PUBKEY, pgpCRC(), pgpGrab(), pgpIsPkt(), pgpValTok(), rpmioSlurp(), and TOKEQ.
Referenced by rpmcliImportPubkeys(), and rpmtsFindPubkey().
Return string representation of am OpenPGP value.
vs | table of (string,value) pairs | |
val | byte value to lookup |
Definition at line 1123 of file rpmpgp.h.
References pgpValTbl_s::str, and pgpValTbl_s::val.
Referenced by pgpArmorWrap(), and pgpPrtVal().
static int pgpValTok | ( | pgpValTbl | vs, | |
const char * | s, | |||
const char * | se | |||
) | [inline, static] |
Return value of an OpenPGP string.
vs | table of (string,value) pairs | |
s | string token to lookup | |
se | end-of-string address |
Definition at line 1141 of file rpmpgp.h.
References pgpValTbl_s::str, and pgpValTbl_s::val.
Referenced by pgpReadPkts().
struct pgpValTbl_s pgpArmorKeyTbl[] |
struct pgpValTbl_s pgpArmorTbl[] |
struct pgpValTbl_s pgpCompressionTbl[] |
struct pgpValTbl_s pgpHashTbl[] |
struct pgpValTbl_s pgpPubkeyTbl[] |
struct pgpValTbl_s pgpSigTypeTbl[] |
struct pgpValTbl_s pgpSubTypeTbl[] |
struct pgpValTbl_s pgpSymkeyTbl[] |
struct pgpValTbl_s pgpTagTbl[] |