Add GCM, CTR, and CTS modes to AES.

nss/mozilla/security/nss/lib/freebl/gcm.h

+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/. */
+
+#ifndef GCM_H
+#define GCM_H 1
+
+#include "blapii.h"
+
+typedef struct GCMContextStr GCMContext;
+
+/*
+ * The context and cipher arguments are used by the CTRContext embedded in the
+ * GCMContext. See the comments for CTR_CreateContext in ctr.h for more info
+ * on context and cipher.
+ */

[Ryan Sleevi, 2012/09/17 22:57:26]

I actually find this comment confusing, in that it's not clear from reading
whether |context| and |cipher| should contain an initialized CTRContext (to be
embedded) or if it should contain ECB context & pointer.

I think it would be good to add a comment here that didn't have to refer to
another header.

[wtc, 2012/09/18 01:03:40]

Done.

+GCMContext * GCM_CreateContext(void *context, freeblCipherFunc cipher,
+                        const unsigned char *params, unsigned int blocksize);
+void GCM_DestroyContext(GCMContext *gcm, PRBool freeit);
+SECStatus GCM_EncryptUpdate(GCMContext  *gcm, unsigned char *outbuf,
+                        unsigned int *outlen, unsigned int maxout,
+                        const unsigned char *inbuf, unsigned int inlen,
+                        unsigned int blocksize);
+SECStatus GCM_DecryptUpdate(GCMContext *gcm, unsigned char *outbuf,
+                        unsigned int *outlen, unsigned int maxout,
+                        const unsigned char *inbuf, unsigned int inlen,
+                        unsigned int blocksize);
+
+#endif