This file is indexed.

/usr/share/acl2-6.5/books/misc/equal-by-g-help.lisp is in acl2-books-source 6.5-2.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below.

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
; equal-by-g.lisp -- theorem for pick-a-point proofs of record equality
;
; Contact:
;   Centaur Technology Formal Verification Group
;   7600-C N. Capital of Texas Highway, Suite 300, Austin, TX 78731, USA.
;   http://www.centtech.com/
;
; This program is free software; you can redistribute it and/or modify it under
; the terms of the GNU General Public License as published by the Free Software
; Foundation; either version 2 of the License, or (at your option) any later
; version.  This program is distributed in the hope that it will be useful but
; WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
; FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
; more details.  You should have received a copy of the GNU General Public
; License along with this program; if not, write to the Free Software
; Foundation, Inc., 51 Franklin Street, Suite 500, Boston, MA 02110-1335, USA.
;
; Original author: Jared Davis <jared@centtech.com>

(in-package "ACL2")
(include-book "records")

; This book should generally not be included; most of the time you should
; instead include the book equal-by-g, instead.  See equal-by-g.lisp for
; general notes and usage information.
;
; This book contains the supporting definitions and theorems.  We only locally
; include these in equal-by-g.lisp.
;
; You might occasionally want to include this file directly, to get at the
; G-WORSEGUY function and the properties about it.


; We begin with a constructive witness that can find a mismatch between two
; well-formed records (i.e., between two valid rcdp's).  Our badguy says what
; kind of mismatch it has found.

(local (defthm rcdp-of-cdr
         (implies (rcdp x)
                  (rcdp (cdr x)))))


(defun g-badguy (x y)
  (cond ((atom x)
         (if (atom y)
             nil
           (cons :extra-in-y (car y))))
        ((atom y)
         (cons :extra-in-x (car x)))
        ((equal (car x) (car y))
         (g-badguy (cdr x) (cdr y)))
        ((<< (caar x) (caar y))
         (cons :extra-in-x (car x)))
        ((equal (caar x) (caar y))
         (cons :mismatch (car x)))
        (t
         (cons :extra-in-y (car y)))))


; Now we just have a bunch of cases to deal with the different kinds of
; problems that the g-badguy might have reported.

(encapsulate
  ()
  (local (defthm l0
           (implies (and (<< (cadr (g-badguy x y)) a)
                         (equal (car (g-badguy x y)) :extra-in-x)
                         (rcdp x)
                         (<< b (caar x)))
                    (not (<< a b)))))

  (defthm g-badguy-lookup-in-x-when-extra-in-x
    (implies (and (equal (car (g-badguy x y)) :extra-in-x)
                  (rcdp x)
                  (rcdp y))
             (g-aux (cadr (g-badguy x y)) x))
    :hints(("Goal" :do-not '(generalize fertilize)))))

(encapsulate
  ()
  (local (defthm l0
           (implies (and (equal (car (g-badguy x y)) :extra-in-x)
                         (<< a (caar x))
                         (<< (cadr (g-badguy x y)) a)
                         (rcdp x))
                    (not (<< a (caar y))))))

  (defthm g-badguy-lookup-in-y-when-extra-in-x
    (implies (and (equal (car (g-badguy x y)) :extra-in-x)
                  (rcdp x)
                  (rcdp y))
             (and (not (g-aux (cadr (g-badguy x y)) y))))
    :hints(("Goal" :do-not '(generalize fertilize)))))

(encapsulate
  ()
  (local (defthm l0
           (implies (and (<< (cadr (g-badguy x y)) a)
                         (equal (car (g-badguy x y)) :extra-in-y)
                         (<< b (caar x))
                         (rcdp y)
                         (<< b (caar y)))
                    (not (<< a b)))))

  (defthm g-badguy-lookup-in-y-when-extra-in-y
    (implies (and (equal (car (g-badguy x y)) :extra-in-y)
                  (rcdp x)
                  (rcdp y))
             (g-aux (cadr (g-badguy x y)) y))
    :hints(("Goal" :do-not '(generalize fertilize)))))

(encapsulate
  ()
  (local (defthm l0
           (implies (and (equal (car (g-badguy x y)) :extra-in-y)
                         (<< a (caar x))
                         (<< (cadr (g-badguy x y)) a)
                         (rcdp y))
                    (not (<< a (caar y))))))

  (defthm g-badguy-lookup-in-x-when-extra-in-y
    (implies (and (equal (car (g-badguy x y)) :extra-in-y)
                  (rcdp x)
                  (rcdp y))
             (not (g-aux (cadr (g-badguy x y)) x)))
    :hints(("Goal" :do-not '(generalize fertilize)))))

(encapsulate
  ()
  (local (defthm l0
           (implies (and (<< (cadr (g-badguy x y)) a)
                         (equal (car (g-badguy x y)) :mismatch)
                         (rcdp x)
                         (rcdp y)
                         (<< b (caar x))
                         (<< b (caar y)))
                    (not (<< a b)))))

  (local (defthm l1
           (implies (and (equal (car (g-badguy x y)) :mismatch)
                         (rcdp x)
                         (rcdp y)
                         (<< a (caar x))
                         (<< (cadr (g-badguy x y)) a))
                    (not (<< a (caar y))))))

  (defthm g-badguy-mismatch-when-mismatch
    (implies (and (equal (car (g-badguy x y)) :mismatch)
                  (rcdp x)
                  (rcdp y))
             (equal (equal (g-aux (cadr (g-badguy x y)) x)
                           (g-aux (cadr (g-badguy x y)) y))
                    nil))
    :hints(("goal" :do-not '(generalize fertilize)))))


; It's easy to see that these are the only cases, and hence it is clear that
; the g-badguy works and if it reports a mismatch, it really is a mismatch.

(defthm g-badguy-cases
  (or (not (g-badguy x y))
      (equal (car (g-badguy x y)) :mismatch)
      (equal (car (g-badguy x y)) :extra-in-x)
      (equal (car (g-badguy x y)) :extra-in-y))
  :rule-classes nil)

(defthm g-aux-of-g-badguy
  (implies (and (g-badguy x y)
                (rcdp x)
                (rcdp y))
           (not (equal (g-aux (cadr (g-badguy x y)) x)
                       (g-aux (cadr (g-badguy x y)) y))))
  :hints(("Goal"
          :do-not-induct t
          :do-not '(eliminate-destructors generalize fertilize)
          :use ((:instance g-badguy-cases)))))


; The other critical fact is that the g-badguy always finds a mismatch between
; any non-equal records.  This follows from its definition.

(defthm g-badguy-unless-equal
  (implies (and (not (equal x y))
                (rcdp x)
                (rcdp y))
           (g-badguy x y)))



; The g-badguy itself isn't sufficient because we need to deal with ill-formed
; records and the whole invertible mapping trick.  So, the "g-worseguy" is like
; the g-badguy but carries out the mapping if necessary.

(defun g-worseguy (x y)
  (g-badguy (acl2->rcd x)
            (acl2->rcd y)))

(defthm acl2->rcd-returns-rcdp
  (rcdp (acl2->rcd x))
  :hints(("Goal" :in-theory (enable acl2->rcd))))


; From the main proof about the g-badguy, it follows that if the g-worseguy says
; there is a mismatch, it's a true mismatch for G.

(defthm g-worseguy-finds-counterexample
  (implies (g-worseguy x y)
           (not (equal (g (cadr (g-worseguy x y)) x)
                       (g (cadr (g-worseguy x y)) y))))
  :hints(("Goal" :in-theory (enable g))))


; All that remains is to show that the g-worseguy always finds a mismatch for
; any non-equal objects.  We can approach this by cases.
;
; 1. Suppose X and Y are well-formed records, i.e., (not (IFRP X)) and (not (IFRP
; Y)).  Then they are both RCDP's, and the ACL2->RCD conversions are the
; identity, and so (g-worseguy x y) is just (g-badguy x y) and we're since we know
; that g-badguy finds a mismatch when given non-equal RCDP's.
;
; 2. Suppose X and Y are both ill-formed records, i.e., (IFRP X) and (IFRP Y).
; Then, the ACL2->RCD conversions will turn them both into RCDP's, in
; particular ((NIL . X)) and ((NIL . Y)).  Obviously these disagree about the
; value of the key NIL when X != Y, so we're done.
;
; 3. WLOG, suppose X is a well-formed record but Y is not.  Then, the ACL2->RCD
; conversion will leave X alone, but will turn Y into ((NIL . Y)).  We need to
; show that G-BADGUY will find a mismatch on these RCDP's.  Well, above we proved
; that that g-badguy always finds a mismatch between two RCDP's unless they're
; equal, so it would suffice to show that X is not equal to ((NIL . Y)).  And
; this is trivial: since Y is ill-formed, ((NIL . Y)) is ill-formed, and since
; above we assumed X was well-formed, this cannot be.

(encapsulate
  ()
  (local (defthm rcdp-unless-ifrp
           (implies (not (ifrp x))
                    (rcdp x))))

  (local (defthm main-lemma-for-case-3
           (implies (and (not (ifrp x)) ;; it therefore must be an rcdp.
                         (ifrp y))
                    (not (equal x (list (cons nil y)))))))

  (local (defthm corollary-for-case-3
           (implies (and (not (ifrp x)) ;; it therefore must be an rcdp.
                         (ifrp y))
                    (g-badguy x (list (cons nil y))))
           :hints(("Goal"
                   :in-theory (disable g-badguy-unless-equal)
                   :use ((:instance g-badguy-unless-equal
                                    (x x)
                                    (y (list (cons nil y)))))))))

  (defthm g-worseguy-unless-equal
    (implies (not (equal x y))
             (g-worseguy x y))
    :hints(("Goal"
            :in-theory (enable acl2->rcd ifrp)
            :do-not-induct t
            :do-not '(generalize fertilize)))))