Update error reference.

--

1 files changed, 156 insertions, 11 deletions

diff --git a/doc/errorref.txt b/doc/errorref.txt
index f4ff673..666dca6 100644
--- a/doc/errorref.txt
+++ b/doc/errorref.txt
@@ -1,4 +1,6 @@
-grep -n -e ERR_CONFLICT ~/w/{gnupg,libksba,libgcrypt,gpgme,gpa}/*/*.[ch]
+# find ~/s/{gnupg,libgpg-error,libksba,libgcrypt,gpgme,gpa} -type f \
+#        -name '*.[ch]' -print0 | xargs -0 grep -n GPG_ERR_
+
 
 GPG_ERR_UNKNOWN_PACKET		Unknown packet
 
@@ -83,7 +85,7 @@ GPG_ERR_NO_PUBKEY		No public key
               does not necessary mean that the certifciate is not
               available but the specification method may not be usable
               for the given certificate.  May also happen for
-              certificates somehwere in the chain while validaiting a
+              certificates somewhere in the chain while validaiting a
               certificate chain.
             - The requested encryption certificate was not found.
             - A certificate specified in a CMS message is not
@@ -99,13 +101,21 @@ GPG_ERR_CHECKSUM		Checksum error
     GCRYPT: - Decryption in AESWRAP mode does not match the expected IV.
     [more to come]
 
-11	GPG_ERR_BAD_PASSPHRASE		Bad passphrase
+GPG_ERR_BAD_PASSPHRASE		Bad passphrase
+
+    GNUPG: - The entered passphrase does not verify
+
+
 12	GPG_ERR_CIPHER_ALGO		Invalid cipher algorithm
 13	GPG_ERR_KEYRING_OPEN		Keyring open
 14	GPG_ERR_INV_PACKET		Invalid packet
 15	GPG_ERR_INV_ARMOR		Invalid armor
 16	GPG_ERR_NO_USER_ID		No user ID
-17	GPG_ERR_NO_SECKEY		No secret key
+
+GPG_ERR_NO_SECKEY		No secret key
+
+   NTBTLS: - No private key or pre-shared key available.
+
 18	GPG_ERR_WRONG_SECKEY		Wrong secret key used
 
 GPG_ERR_BAD_KEY			Bad session key
@@ -146,14 +156,19 @@ GPG_ERR_VALUE_NOT_FOUND		Value not found
 
 29	GPG_ERR_SYNTAX			Syntax error
 30	GPG_ERR_BAD_MPI			Bad MPI value
-31	GPG_ERR_INV_PASSPHRASE		Invalid passphrase
+
+GPG_ERR_INV_PASSPHRASE		Invalid passphrase
+
+    GNUPG:  - Required constraints of the passphrase are not met.
+
 32	GPG_ERR_SIG_CLASS		Invalid signature class
 33	GPG_ERR_RESOURCE_LIMIT		Resources exhausted
 34	GPG_ERR_INV_KEYRING		Invalid keyring
 35	GPG_ERR_TRUSTDB			Trust DB error
 
 
-        GPG_ERR_BAD_CERT		Bad certificate
+GPG_ERR_BAD_CERT		Bad certificate
+
 
 GPG_ERR_INV_USER_ID		Invalid user ID
 
@@ -169,8 +184,10 @@ GPG_ERR_INV_USER_ID		Invalid user ID
 GPG_ERR_WRONG_PUBKEY_ALGO	Wrong public key algorithm
 
     GNUPG: - The algorithm is not expected.  For example a DSA
-              algorithm is used where a non-DSA algorithm is expected
-              or vice versa.  May indicate an internal error.
+             algorithm is used where a non-DSA algorithm is expected
+             or vice versa.  May indicate an internal error.
+    NTBTLS: - Public key type mismatch.  The peer presented a
+              different key type than requested.
 
 
 42	GPG_ERR_TRIBUTE_TO_D_A		Tribute to D. A.
@@ -207,6 +224,9 @@ GPG_ERR_INV_ARG			Invalid argument
 
 GPG_ERR_MISSING_CERT		Missing certificate
 
+    NTBTLS: - The server needs to send a certifciate but none has been
+              set.  See also GPG_ERR_MISSING_ISSUER_CERT and
+              GPG_ERR_MISSING_CLIENT_CERT.
 
 
 
@@ -230,7 +250,10 @@ GPG_ERR_MISSING_CERT		Missing certificate
 66	GPG_ERR_TOO_SHORT		Provided object is too short
 67	GPG_ERR_TOO_LARGE		Provided object is too large
 68	GPG_ERR_NO_OBJ			Missing item in object
-69	GPG_ERR_NOT_IMPLEMENTED		Not implemented
+
+GPG_ERR_NOT_IMPLEMENTED		Not implemented
+
+    NTBTLS: - The requested feature is not implemented.
 
 GPG_ERR_CONFLICT		Conflicting use
 
@@ -320,6 +343,7 @@ GPG_ERR_UNSUPPORTED_PROTOCOL	Unsupported protocol
     GPG_AGENT:  - Invalid shadow_info protocol (not "t1-v1")
     LIBKSBA:    - Unknown OID of the OCSP response bytes
     GPGME:      - GPGME_PROTOCOL_xxx not supported.
+    NTBTLS:     - Handshake protocol version not supported.
 
 122	GPG_ERR_BAD_PIN_METHOD		Bad PIN method
 
@@ -446,7 +470,14 @@ GPG_ERR_INV_CERT_OBJ		Invalid certificate object
 166	GPG_ERR_LOCALE_PROBLEM		A locale function failed
 167	GPG_ERR_NOT_LOCKED		Not locked
 168	GPG_ERR_PROTOCOL_VIOLATION	Protocol violation
-169	GPG_ERR_INV_MAC			Invalid MAC
+
+
+GPG_ERR_INV_MAC			Invalid MAC
+
+        The length, algo, or other properties of a MAC are not met.
+        See also GPG_ERR_BAD_MAC.
+
+
 170	GPG_ERR_INV_REQUEST		Invalid request
 171	GPG_ERR_UNKNOWN_EXTN		Unknown extension
 172	GPG_ERR_UNKNOWN_CRIT_EXTN	Unknown critical extension
@@ -555,6 +586,120 @@ GPG_ERR_MAC_ALGO
 199	GPG_ERR_UNFINISHED		Operation not yet finished
 200	GPG_ERR_BUFFER_TOO_SHORT	Buffer too short
 
+201	GPG_ERR_SEXP_INV_LEN_SPEC	Invalid length specifier in S-expression
+202	GPG_ERR_SEXP_STRING_TOO_LONG	String too long in S-expression
+203	GPG_ERR_SEXP_UNMATCHED_PAREN	Unmatched parentheses in S-expression
+204	GPG_ERR_SEXP_NOT_CANONICAL	S-expression not canonical
+205	GPG_ERR_SEXP_BAD_CHARACTER	Bad character in S-expression
+206	GPG_ERR_SEXP_BAD_QUOTATION	Bad quotation in S-expression
+207	GPG_ERR_SEXP_ZERO_PREFIX	Zero prefix in S-expression
+208	GPG_ERR_SEXP_NESTED_DH		Nested display hints in S-expression
+209	GPG_ERR_SEXP_UNMATCHED_DH	Unmatched display hints
+210	GPG_ERR_SEXP_UNEXPECTED_PUNC	Unexpected reserved punctuation in S-expression
+211	GPG_ERR_SEXP_BAD_HEX_CHAR	Bad hexadecimal character in S-expression
+212	GPG_ERR_SEXP_ODD_HEX_NUMBERS	Odd hexadecimal numbers in S-expression
+213	GPG_ERR_SEXP_BAD_OCT_CHAR	Bad octal character in S-expression
+
+
+
+GPG_ERR_NO_CERT_CHAIN		No certificate chain
+
+    NTBTLS: - A CA chain has not been set but is required.
+
+GPG_ERR_CERT_TOO_LARGE		Certificate is too large
+
+    NTBTLS: - A certificate is too large to be used by the protocol.
+
+GPG_ERR_INV_RECORD              Invalid record
+
+    NTBTLS: - An invalid record was received
+
+GPG_ERR_BAD_MAC			The MAC does not verify
+
+    NTBTLS: - MAC verification of the message failed.
+
+GPG_ERR_UNEXPECTED_MSG         Unexpected message
+
+    NTBTLS: - Unexpected message received.
+
+GPG_ERR_COMPR_FAILED           Compression or decompression failed
+
+    NTBTLS: - As the description says.
+
+GPG_ERR_WOULD_WRAP             A counter would wrap
+
+    NTBTLS: - Too many messages exchanged
+
+GPG_ERR_FATAL_ALERT            Fatal alert message received
+
+    NTBTLS: - Fatal alert message received from the peer.
+
+GPG_ERR_NO_CIPHER              No cipher algorithm
+
+    NTBTLS: - Server and client have no algo in common
+
+GPG_ERR_MISSING_CLIENT_CERT     Missing client certificate
+
+    NTBTLS: - No certificate received from client.
+
+GPG_ERR_CLOSE_NOTIFY            Close notification received
+
+    NTBTLS: - Alert with a close notification received
+
+GPG_ERR_TICKET_EXPIRED          Ticket expired
+
+    NTBTLS: - Session ticket has expired.
+
+GPG_ERR_BAD_TICKET              Bad ticket
+
+    NTBTLS: - Bad new session ticket message.
+
+GPG_ERR_UNKNOWN_IDENTITY        Unknown identity
+
+    NTBTLS: - Unknown PSK identify received
+
+GPG_ERR_BAD_HS_CERT             Bad certificate message in handshake
+
+    NTBTLS: - As the description says.
+
+GPG_ERR_BAD_HS_CERT_REQ         Bad certificate request message in handshake
+
+    NTBTLS: - As the description says.
+
+GPG_ERR_BAD_HS_CERT_VER         Bad certificate verify message in handshake
+
+    NTBTLS: - As the description says.
+
+GPG_ERR_BAD_HS_CHANGE_CIPHER    Bad change cipher messsage in handshake
+
+    NTBTLS: - As the description says.
+
+GPG_ERR_BAD_HS_CLIENT_HELLO     Bad client hello message in handshake
+
+    NTBTLS: - As the description says.
+
+GPG_ERR_BAD_HS_SERVER_HELLO     Bad server hello message in handshake
+
+    NTBTLS: - As the description says.
+
+GPG_ERR_BAD_HS_SERVER_HELLO_DONE  Bad server hello done message in handshake
+
+    NTBTLS: - As the description says.
+
+GPG_ERR_BAD_HS_FINISHED         Bad finished message in handshake
+
+    NTBTLS: - As the description says.
+
+GPG_ERR_BAD_HS_SERVER_KEX       Bad server key exchange message in handshake
+
+    NTBTLS: - As the description says.
+
+GPG_ERR_BAD_HS_CLIENT_KEX       Bad client key exchange message in handshake
+
+    NTBTLS: - As the description says.
+
+
+
 
 GPG_ERR_KEY_DISABLED            Key disabled
 
@@ -565,7 +710,7 @@ GPG_ERR_KEY_ON_CARD		Not possible with a card based key
     GNUPG: - The gpg-agent returns this if a DELETE_KEY commands is
              used for a smartcard based key.
 
-254	GPG_ERR_INV_LOCK_OBJ		Invalid lock object
+GPG_ERR_INV_LOCK_OBJ		Invalid lock object
 
     GPGRT: - The provided lock object is not valid.  This indicates an
              internal problem in libgpg-error or more likely a