PGP import commands

PGP import commands all return four items in the result structure:

• results: a statistical overview of what happened
• failed: details about keys which failed to be imported
• updated: details about keys which were updated (as they previously existed in the keyring)
• imported: details about keys which were imported as new

Results

Most of these statistics are not useful in most cases but may be of interest in edge cases. They are mostly included for completeness, since we get these statistics anyway from the GnuPG result.

  "results": {
   "count": 2, 
   "imported": 0, 
   "imported_rsa": 0, 
   "no_userids": 0, 
   "not_imported": 0, 
   "num_revoked": 0, 
   "num_signatures": 0, 
   "num_subkeys": 0, 
   "num_uids": 0, 
   "sec_dups": 0, 
   "sec_imported": 0, 
   "sec_read": 0, 
   "skipped_new_keys": 0, 
   "unchanged": 2
  }, 

• count: How many keys were processed
• imported: How many keys were imported as new
• imported_rsa: How many of the newly imported keys were RSA keys
• no_userids: Number of keys without a User ID
• not_imported: Number of keys specifically not imported
• num_revoked: Number of keys that were revoked through the action
• num_signatures: Number of new signatures seen
• num_subkeys: Number of new subkeys seen
• num_uids: Number of User ID's imported
• sec_dups: Private key duplicates seen
• sec_imported: Private keys imported
• sec_read: Private keys processed
• skipped_new_keys: New keys which were ignored
• unchanged: How many keys were left unchanged

Imported, Updated

Imported and updated contain lists of details, where each entry is like so:

   {
    "details": 0, 
    "details_text": "unchanged", 
    "fingerprint": "B2216FD2779AE5B59D79743CD5DC2A79C2E4AE92"
   }, 

The details field conforms to the details field in GnuPG's IMPORT_OK status, which is an integer field comprised of these values OR'd together:

• 0 : Not actually changed
• 1 : Entirely new key.
• 2 : New user IDs
• 4 : New signatures
• 8 : New subkeys
• 16 : Contains private key.

Failed

...