annotate lisp/gnus/rfc2104.el @ 96215:ad9760e68890

(Todo): Update.
author Dan Nicolaescu <dann@ics.uci.edu>
date Tue, 24 Jun 2008 03:24:38 +0000
parents c8f2d1ecfcc5
children 89f46e95065e
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
31717
6b20b7e85e3c *** empty log message ***
Gerd Moellmann <gerd@gnu.org>
parents:
diff changeset
1 ;;; rfc2104.el --- RFC2104 Hashed Message Authentication Codes
64754
fafd692d1e40 Update years in copyright notice; nfc.
Thien-Thi Nguyen <ttn@gnuvola.org>
parents: 64085
diff changeset
2
74548
ce127a46b1ca Update copyright years.
Glenn Morris <rgm@gnu.org>
parents: 68633
diff changeset
3 ;; Copyright (C) 1998, 1999, 2000, 2001, 2002, 2003, 2004,
79708
1cb31606209f Add 2008 to copyright years.
Glenn Morris <rgm@gnu.org>
parents: 78224
diff changeset
4 ;; 2005, 2006, 2007, 2008 Free Software Foundation, Inc.
31717
6b20b7e85e3c *** empty log message ***
Gerd Moellmann <gerd@gnu.org>
parents:
diff changeset
5
6b20b7e85e3c *** empty log message ***
Gerd Moellmann <gerd@gnu.org>
parents:
diff changeset
6 ;; Author: Simon Josefsson <jas@pdc.kth.se>
6b20b7e85e3c *** empty log message ***
Gerd Moellmann <gerd@gnu.org>
parents:
diff changeset
7 ;; Keywords: mail
6b20b7e85e3c *** empty log message ***
Gerd Moellmann <gerd@gnu.org>
parents:
diff changeset
8
6b20b7e85e3c *** empty log message ***
Gerd Moellmann <gerd@gnu.org>
parents:
diff changeset
9 ;; This file is part of GNU Emacs.
6b20b7e85e3c *** empty log message ***
Gerd Moellmann <gerd@gnu.org>
parents:
diff changeset
10
94662
f42ef85caf91 Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents: 93975
diff changeset
11 ;; GNU Emacs is free software: you can redistribute it and/or modify
31717
6b20b7e85e3c *** empty log message ***
Gerd Moellmann <gerd@gnu.org>
parents:
diff changeset
12 ;; it under the terms of the GNU General Public License as published by
94662
f42ef85caf91 Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents: 93975
diff changeset
13 ;; the Free Software Foundation, either version 3 of the License, or
f42ef85caf91 Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents: 93975
diff changeset
14 ;; (at your option) any later version.
31717
6b20b7e85e3c *** empty log message ***
Gerd Moellmann <gerd@gnu.org>
parents:
diff changeset
15
6b20b7e85e3c *** empty log message ***
Gerd Moellmann <gerd@gnu.org>
parents:
diff changeset
16 ;; GNU Emacs is distributed in the hope that it will be useful,
6b20b7e85e3c *** empty log message ***
Gerd Moellmann <gerd@gnu.org>
parents:
diff changeset
17 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
94662
f42ef85caf91 Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents: 93975
diff changeset
18 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
31717
6b20b7e85e3c *** empty log message ***
Gerd Moellmann <gerd@gnu.org>
parents:
diff changeset
19 ;; GNU General Public License for more details.
6b20b7e85e3c *** empty log message ***
Gerd Moellmann <gerd@gnu.org>
parents:
diff changeset
20
6b20b7e85e3c *** empty log message ***
Gerd Moellmann <gerd@gnu.org>
parents:
diff changeset
21 ;; You should have received a copy of the GNU General Public License
94662
f42ef85caf91 Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents: 93975
diff changeset
22 ;; along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>.
31717
6b20b7e85e3c *** empty log message ***
Gerd Moellmann <gerd@gnu.org>
parents:
diff changeset
23
6b20b7e85e3c *** empty log message ***
Gerd Moellmann <gerd@gnu.org>
parents:
diff changeset
24 ;;; Commentary:
6b20b7e85e3c *** empty log message ***
Gerd Moellmann <gerd@gnu.org>
parents:
diff changeset
25
94761
c8f2d1ecfcc5 (rfc2104-hexstring-to-bitstring): Rename it back from
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 94662
diff changeset
26 ;; This is a quick'n'dirty, low performance, implementation of RFC2104.
c8f2d1ecfcc5 (rfc2104-hexstring-to-bitstring): Rename it back from
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 94662
diff changeset
27 ;;
c8f2d1ecfcc5 (rfc2104-hexstring-to-bitstring): Rename it back from
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 94662
diff changeset
28 ;; Example:
c8f2d1ecfcc5 (rfc2104-hexstring-to-bitstring): Rename it back from
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 94662
diff changeset
29 ;;
c8f2d1ecfcc5 (rfc2104-hexstring-to-bitstring): Rename it back from
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 94662
diff changeset
30 ;; (require 'md5)
c8f2d1ecfcc5 (rfc2104-hexstring-to-bitstring): Rename it back from
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 94662
diff changeset
31 ;; (rfc2104-hash 'md5 64 16 "Jefe" "what do ya want for nothing?")
c8f2d1ecfcc5 (rfc2104-hexstring-to-bitstring): Rename it back from
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 94662
diff changeset
32 ;; "750c783e6ab0b503eaa86e310a5db738"
c8f2d1ecfcc5 (rfc2104-hexstring-to-bitstring): Rename it back from
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 94662
diff changeset
33 ;;
c8f2d1ecfcc5 (rfc2104-hexstring-to-bitstring): Rename it back from
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 94662
diff changeset
34 ;; (require 'sha-1)
c8f2d1ecfcc5 (rfc2104-hexstring-to-bitstring): Rename it back from
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 94662
diff changeset
35 ;; (rfc2104-hash 'sha1-encode 64 20 "Jefe" "what do ya want for nothing?")
c8f2d1ecfcc5 (rfc2104-hexstring-to-bitstring): Rename it back from
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 94662
diff changeset
36 ;; "effcdf6ae5eb2fa2d27416d5f184df9c259a7c79"
c8f2d1ecfcc5 (rfc2104-hexstring-to-bitstring): Rename it back from
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 94662
diff changeset
37 ;;
c8f2d1ecfcc5 (rfc2104-hexstring-to-bitstring): Rename it back from
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 94662
diff changeset
38 ;; 64 is block length of hash function (64 for MD5 and SHA), 16 is
c8f2d1ecfcc5 (rfc2104-hexstring-to-bitstring): Rename it back from
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 94662
diff changeset
39 ;; resulting hash length (16 for MD5, 20 for SHA).
c8f2d1ecfcc5 (rfc2104-hexstring-to-bitstring): Rename it back from
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 94662
diff changeset
40 ;;
c8f2d1ecfcc5 (rfc2104-hexstring-to-bitstring): Rename it back from
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 94662
diff changeset
41 ;; Tested with Emacs 20.2 and XEmacs 20.3.
c8f2d1ecfcc5 (rfc2104-hexstring-to-bitstring): Rename it back from
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 94662
diff changeset
42 ;;
c8f2d1ecfcc5 (rfc2104-hexstring-to-bitstring): Rename it back from
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 94662
diff changeset
43 ;; Test case reference: RFC 2202.
31717
6b20b7e85e3c *** empty log message ***
Gerd Moellmann <gerd@gnu.org>
parents:
diff changeset
44
94761
c8f2d1ecfcc5 (rfc2104-hexstring-to-bitstring): Rename it back from
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 94662
diff changeset
45 ;;; History:
c8f2d1ecfcc5 (rfc2104-hexstring-to-bitstring): Rename it back from
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 94662
diff changeset
46
c8f2d1ecfcc5 (rfc2104-hexstring-to-bitstring): Rename it back from
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 94662
diff changeset
47 ;; 1998-08-16 initial release posted to gnu.emacs.sources
c8f2d1ecfcc5 (rfc2104-hexstring-to-bitstring): Rename it back from
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 94662
diff changeset
48 ;; 1998-08-17 use append instead of char-list-to-string
c8f2d1ecfcc5 (rfc2104-hexstring-to-bitstring): Rename it back from
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 94662
diff changeset
49 ;; 1998-08-26 don't require hexl
c8f2d1ecfcc5 (rfc2104-hexstring-to-bitstring): Rename it back from
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 94662
diff changeset
50 ;; 1998-09-25 renamed from hmac.el to rfc2104.el, also renamed functions
c8f2d1ecfcc5 (rfc2104-hexstring-to-bitstring): Rename it back from
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 94662
diff changeset
51 ;; 1999-10-23 included in pgnus
c8f2d1ecfcc5 (rfc2104-hexstring-to-bitstring): Rename it back from
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 94662
diff changeset
52 ;; 2000-08-15 `rfc2104-hexstring-to-bitstring'
c8f2d1ecfcc5 (rfc2104-hexstring-to-bitstring): Rename it back from
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 94662
diff changeset
53 ;; 2000-05-12 added sha-1 example, added test case reference
c8f2d1ecfcc5 (rfc2104-hexstring-to-bitstring): Rename it back from
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 94662
diff changeset
54 ;; 2003-11-13 change rfc2104-hexstring-to-bitstring to ...-byte-list
38413
a26d9b55abb6 Some fixes to follow coding conventions in files from Gnus.
Pavel Janík <Pavel@Janik.cz>
parents: 33321
diff changeset
55
a26d9b55abb6 Some fixes to follow coding conventions in files from Gnus.
Pavel Janík <Pavel@Janik.cz>
parents: 33321
diff changeset
56 ;;; Code:
49598
0d8b17d428b5 Trailing whitepace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents: 38413
diff changeset
57
31717
6b20b7e85e3c *** empty log message ***
Gerd Moellmann <gerd@gnu.org>
parents:
diff changeset
58 (eval-when-compile (require 'cl))
6b20b7e85e3c *** empty log message ***
Gerd Moellmann <gerd@gnu.org>
parents:
diff changeset
59
6b20b7e85e3c *** empty log message ***
Gerd Moellmann <gerd@gnu.org>
parents:
diff changeset
60 ;; Magic character for inner HMAC round. 0x36 == 54 == '6'
6b20b7e85e3c *** empty log message ***
Gerd Moellmann <gerd@gnu.org>
parents:
diff changeset
61 (defconst rfc2104-ipad ?\x36)
6b20b7e85e3c *** empty log message ***
Gerd Moellmann <gerd@gnu.org>
parents:
diff changeset
62
6b20b7e85e3c *** empty log message ***
Gerd Moellmann <gerd@gnu.org>
parents:
diff changeset
63 ;; Magic character for outer HMAC round. 0x5C == 92 == '\'
6b20b7e85e3c *** empty log message ***
Gerd Moellmann <gerd@gnu.org>
parents:
diff changeset
64 (defconst rfc2104-opad ?\x5C)
6b20b7e85e3c *** empty log message ***
Gerd Moellmann <gerd@gnu.org>
parents:
diff changeset
65
6b20b7e85e3c *** empty log message ***
Gerd Moellmann <gerd@gnu.org>
parents:
diff changeset
66 ;; Not so magic character for padding the key. 0x00
6b20b7e85e3c *** empty log message ***
Gerd Moellmann <gerd@gnu.org>
parents:
diff changeset
67 (defconst rfc2104-zero ?\x00)
6b20b7e85e3c *** empty log message ***
Gerd Moellmann <gerd@gnu.org>
parents:
diff changeset
68
6b20b7e85e3c *** empty log message ***
Gerd Moellmann <gerd@gnu.org>
parents:
diff changeset
69 ;; Alist for converting hex to decimal.
49598
0d8b17d428b5 Trailing whitepace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents: 38413
diff changeset
70 (defconst rfc2104-hex-alist
31717
6b20b7e85e3c *** empty log message ***
Gerd Moellmann <gerd@gnu.org>
parents:
diff changeset
71 '((?0 . 0) (?a . 10) (?A . 10)
6b20b7e85e3c *** empty log message ***
Gerd Moellmann <gerd@gnu.org>
parents:
diff changeset
72 (?1 . 1) (?b . 11) (?B . 11)
6b20b7e85e3c *** empty log message ***
Gerd Moellmann <gerd@gnu.org>
parents:
diff changeset
73 (?2 . 2) (?c . 12) (?C . 12)
6b20b7e85e3c *** empty log message ***
Gerd Moellmann <gerd@gnu.org>
parents:
diff changeset
74 (?3 . 3) (?d . 13) (?D . 13)
6b20b7e85e3c *** empty log message ***
Gerd Moellmann <gerd@gnu.org>
parents:
diff changeset
75 (?4 . 4) (?e . 14) (?E . 14)
6b20b7e85e3c *** empty log message ***
Gerd Moellmann <gerd@gnu.org>
parents:
diff changeset
76 (?5 . 5) (?f . 15) (?F . 15)
6b20b7e85e3c *** empty log message ***
Gerd Moellmann <gerd@gnu.org>
parents:
diff changeset
77 (?6 . 6)
6b20b7e85e3c *** empty log message ***
Gerd Moellmann <gerd@gnu.org>
parents:
diff changeset
78 (?7 . 7)
6b20b7e85e3c *** empty log message ***
Gerd Moellmann <gerd@gnu.org>
parents:
diff changeset
79 (?8 . 8)
6b20b7e85e3c *** empty log message ***
Gerd Moellmann <gerd@gnu.org>
parents:
diff changeset
80 (?9 . 9)))
6b20b7e85e3c *** empty log message ***
Gerd Moellmann <gerd@gnu.org>
parents:
diff changeset
81
6b20b7e85e3c *** empty log message ***
Gerd Moellmann <gerd@gnu.org>
parents:
diff changeset
82 (defun rfc2104-hex-to-int (str)
6b20b7e85e3c *** empty log message ***
Gerd Moellmann <gerd@gnu.org>
parents:
diff changeset
83 (if str
6b20b7e85e3c *** empty log message ***
Gerd Moellmann <gerd@gnu.org>
parents:
diff changeset
84 (if (listp str)
6b20b7e85e3c *** empty log message ***
Gerd Moellmann <gerd@gnu.org>
parents:
diff changeset
85 (+ (* 16 (rfc2104-hex-to-int (cdr str)))
6b20b7e85e3c *** empty log message ***
Gerd Moellmann <gerd@gnu.org>
parents:
diff changeset
86 (cdr (assoc (car str) rfc2104-hex-alist)))
6b20b7e85e3c *** empty log message ***
Gerd Moellmann <gerd@gnu.org>
parents:
diff changeset
87 (rfc2104-hex-to-int (reverse (append str nil))))
6b20b7e85e3c *** empty log message ***
Gerd Moellmann <gerd@gnu.org>
parents:
diff changeset
88 0))
6b20b7e85e3c *** empty log message ***
Gerd Moellmann <gerd@gnu.org>
parents:
diff changeset
89
94761
c8f2d1ecfcc5 (rfc2104-hexstring-to-bitstring): Rename it back from
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 94662
diff changeset
90 (defun rfc2104-hexstring-to-bitstring (str)
33321
2f030bbc6aa8 2000-11-09 Simon Josefsson <simon@josefsson.org>
Dave Love <fx@gnu.org>
parents: 31717
diff changeset
91 (let (out)
2f030bbc6aa8 2000-11-09 Simon Josefsson <simon@josefsson.org>
Dave Love <fx@gnu.org>
parents: 31717
diff changeset
92 (while (< 0 (length str))
2f030bbc6aa8 2000-11-09 Simon Josefsson <simon@josefsson.org>
Dave Love <fx@gnu.org>
parents: 31717
diff changeset
93 (push (rfc2104-hex-to-int (substring str -2)) out)
2f030bbc6aa8 2000-11-09 Simon Josefsson <simon@josefsson.org>
Dave Love <fx@gnu.org>
parents: 31717
diff changeset
94 (setq str (substring str 0 -2)))
94761
c8f2d1ecfcc5 (rfc2104-hexstring-to-bitstring): Rename it back from
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 94662
diff changeset
95 (apply (if (fboundp 'unibyte-string) 'unibyte-string 'string) out)))
33321
2f030bbc6aa8 2000-11-09 Simon Josefsson <simon@josefsson.org>
Dave Love <fx@gnu.org>
parents: 31717
diff changeset
96
31717
6b20b7e85e3c *** empty log message ***
Gerd Moellmann <gerd@gnu.org>
parents:
diff changeset
97 (defun rfc2104-hash (hash block-length hash-length key text)
6b20b7e85e3c *** empty log message ***
Gerd Moellmann <gerd@gnu.org>
parents:
diff changeset
98 (let* (;; if key is longer than B, reset it to HASH(key)
49598
0d8b17d428b5 Trailing whitepace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents: 38413
diff changeset
99 (key (if (> (length key) block-length)
31717
6b20b7e85e3c *** empty log message ***
Gerd Moellmann <gerd@gnu.org>
parents:
diff changeset
100 (funcall hash key) key))
6b20b7e85e3c *** empty log message ***
Gerd Moellmann <gerd@gnu.org>
parents:
diff changeset
101 (k_ipad (append key nil))
6b20b7e85e3c *** empty log message ***
Gerd Moellmann <gerd@gnu.org>
parents:
diff changeset
102 (k_opad (append key nil)))
6b20b7e85e3c *** empty log message ***
Gerd Moellmann <gerd@gnu.org>
parents:
diff changeset
103 ;; zero pad k_ipad/k_opad
6b20b7e85e3c *** empty log message ***
Gerd Moellmann <gerd@gnu.org>
parents:
diff changeset
104 (while (< (length k_ipad) block-length)
6b20b7e85e3c *** empty log message ***
Gerd Moellmann <gerd@gnu.org>
parents:
diff changeset
105 (setq k_ipad (append k_ipad (list rfc2104-zero))))
6b20b7e85e3c *** empty log message ***
Gerd Moellmann <gerd@gnu.org>
parents:
diff changeset
106 (while (< (length k_opad) block-length)
6b20b7e85e3c *** empty log message ***
Gerd Moellmann <gerd@gnu.org>
parents:
diff changeset
107 (setq k_opad (append k_opad (list rfc2104-zero))))
6b20b7e85e3c *** empty log message ***
Gerd Moellmann <gerd@gnu.org>
parents:
diff changeset
108 ;; XOR key with ipad/opad into k_ipad/k_opad
6b20b7e85e3c *** empty log message ***
Gerd Moellmann <gerd@gnu.org>
parents:
diff changeset
109 (setq k_ipad (mapcar (lambda (c) (logxor c rfc2104-ipad)) k_ipad))
6b20b7e85e3c *** empty log message ***
Gerd Moellmann <gerd@gnu.org>
parents:
diff changeset
110 (setq k_opad (mapcar (lambda (c) (logxor c rfc2104-opad)) k_opad))
33321
2f030bbc6aa8 2000-11-09 Simon Josefsson <simon@josefsson.org>
Dave Love <fx@gnu.org>
parents: 31717
diff changeset
111 ;; perform outer hash
94761
c8f2d1ecfcc5 (rfc2104-hexstring-to-bitstring): Rename it back from
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 94662
diff changeset
112 (funcall hash (concat k_opad (rfc2104-hexstring-to-bitstring
89617
f7f76c4ee683 * rfc2104.el (rfc2104-hexstring-to-byte-list): Renamed from
Kenichi Handa <handa@m17n.org>
parents: 88123
diff changeset
113 ;; perform inner hash
94761
c8f2d1ecfcc5 (rfc2104-hexstring-to-bitstring): Rename it back from
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 94662
diff changeset
114 (funcall hash (concat k_ipad text)))))))
31717
6b20b7e85e3c *** empty log message ***
Gerd Moellmann <gerd@gnu.org>
parents:
diff changeset
115
6b20b7e85e3c *** empty log message ***
Gerd Moellmann <gerd@gnu.org>
parents:
diff changeset
116 (provide 'rfc2104)
6b20b7e85e3c *** empty log message ***
Gerd Moellmann <gerd@gnu.org>
parents:
diff changeset
117
93975
1e3a407766b9 Fix up comment convention on the arch-tag lines.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 91327
diff changeset
118 ;; arch-tag: cf671d5c-a45f-4a09-815e-704e59e43950
31717
6b20b7e85e3c *** empty log message ***
Gerd Moellmann <gerd@gnu.org>
parents:
diff changeset
119 ;;; rfc2104.el ends here