errors

Documentation

Overview

Package errors contains common error types for the OpenPGP packages.

Index

• Variables
• func HandleSensitiveParsingError(err error, decrypted bool) error
• type AEADError
  • func (ae AEADError) Error() string
• type CriticalUnknownPacketTypeError
  • func (upte CriticalUnknownPacketTypeError) Error() string
• type DecryptWithSessionKeyError
  • func (s DecryptWithSessionKeyError) Error() string
• type ErrDummyPrivateKey
  • func (dke ErrDummyPrivateKey) Error() string
• type ErrMalformedMessage
  • func (dke ErrMalformedMessage) Error() string
• type InvalidArgumentError
  • func (i InvalidArgumentError) Error() string
• type KeyInvalidError
  • func (e KeyInvalidError) Error() string
• type SignatureError
  • func (b SignatureError) Error() string
• type StructuralError
  • func (s StructuralError) Error() string
• type UnknownPacketTypeError
  • func (upte UnknownPacketTypeError) Error() string
• type UnsupportedError
  • func (s UnsupportedError) Error() string
• type WeakAlgorithmError
  • func (e WeakAlgorithmError) Error() string

Variables

var (
	// ErrDecryptSessionKeyParsing is a generic error message for parsing errors in decrypted data
	// to reduce the risk of oracle attacks.
	ErrDecryptSessionKeyParsing = DecryptWithSessionKeyError("parsing error")
	// ErrAEADTagVerification is returned if one of the tag verifications in SEIPDv2 fails
	ErrAEADTagVerification error = DecryptWithSessionKeyError("AEAD tag verification failed")
	// ErrMDCHashMismatch
	ErrMDCHashMismatch error = SignatureError("MDC hash mismatch")
	// ErrMDCMissing
	ErrMDCMissing error = SignatureError("MDC packet not found")
)

var ErrKeyExpired error = keyExpiredError(0)

var ErrKeyIncorrect error = keyIncorrectError(0)

var ErrKeyRevoked error = keyRevokedError(0)

var ErrSignatureExpired error = signatureExpiredError(0)

var ErrSignatureOlderThanKey error = signatureOlderThanKeyError(0)

var ErrUnknownIssuer error = unknownIssuerError(0)

var InvalidForwardeeKeyError = InvalidArgumentError("invalid forwardee key")

Functions

func HandleSensitiveParsingError

func HandleSensitiveParsingError(err error, decrypted bool) error

HandleSensitiveParsingError handles parsing errors when reading data from potentially decrypted data. The function makes parsing errors generic to reduce the risk of oracle attacks in SEIPDv1.

Types

type AEADError

type AEADError string

AEADError indicates that there is a problem when initializing or using a AEAD instance, configuration struct, nonces or index values.

func (AEADError) Error

func (ae AEADError) Error() string

type CriticalUnknownPacketTypeError

type CriticalUnknownPacketTypeError uint8

func (CriticalUnknownPacketTypeError) Error

func (upte CriticalUnknownPacketTypeError) Error() string

type DecryptWithSessionKeyError

type DecryptWithSessionKeyError string

A DecryptWithSessionKeyError is returned when a failure occurs when reading from symmetrically decrypted data or an authentication tag verification fails. Such an error indicates that the supplied session key is likely wrong or the data got corrupted.

func (DecryptWithSessionKeyError) Error

func (s DecryptWithSessionKeyError) Error() string

type ErrDummyPrivateKey

type ErrDummyPrivateKey string

ErrDummyPrivateKey results when operations are attempted on a private key that is just a dummy key. See https://git.gnupg.org/cgi-bin/gitweb.cgi?p=gnupg.git;a=blob;f=doc/DETAILS;h=fe55ae16ab4e26d8356dc574c9e8bc935e71aef1;hb=23191d7851eae2217ecdac6484349849a24fd94a#l1109

func (ErrDummyPrivateKey) Error

func (dke ErrDummyPrivateKey) Error() string

type ErrMalformedMessage

type ErrMalformedMessage string

ErrMalformedMessage results when the packet sequence is incorrect

func (ErrMalformedMessage) Error

func (dke ErrMalformedMessage) Error() string

type InvalidArgumentError

type InvalidArgumentError string

InvalidArgumentError indicates that the caller is in error and passed an incorrect value.

func (InvalidArgumentError) Error

func (i InvalidArgumentError) Error() string

type KeyInvalidError

type KeyInvalidError string

KeyInvalidError indicates that the public key parameters are invalid as they do not match the private ones

func (KeyInvalidError) Error

func (e KeyInvalidError) Error() string

type SignatureError

type SignatureError string

SignatureError indicates that a syntactically valid signature failed to validate.

func (SignatureError) Error

func (b SignatureError) Error() string

type StructuralError

type StructuralError string

A StructuralError is returned when OpenPGP data is found to be syntactically invalid.

func (StructuralError) Error

func (s StructuralError) Error() string

type UnknownPacketTypeError

type UnknownPacketTypeError uint8

func (UnknownPacketTypeError) Error

func (upte UnknownPacketTypeError) Error() string

type UnsupportedError

type UnsupportedError string

UnsupportedError indicates that, although the OpenPGP data is valid, it makes use of currently unimplemented features.

func (UnsupportedError) Error

func (s UnsupportedError) Error() string

type WeakAlgorithmError

type WeakAlgorithmError string

func (WeakAlgorithmError) Error

func (e WeakAlgorithmError) Error() string