source: branches/working-0709/ccl/lib/misc.lisp @ 7205

Last change on this file since 7205 was 7205, checked in by gb, 13 years ago

DOCUMENTATION (and (SETF DOCUMENTATION)) for SLOT-DEFINITION metaobjects.

  • Property svn:eol-style set to native
  • Property svn:keywords set to Author Date Id Revision
File size: 24.3 KB
Line 
1;;;-*-Mode: LISP; Package: CCL -*-
2;;;
3;;;   Copyright (C) 1994-2001 Digitool, Inc
4;;;   This file is part of OpenMCL. 
5;;;
6;;;   OpenMCL is licensed under the terms of the Lisp Lesser GNU Public
7;;;   License , known as the LLGPL and distributed with OpenMCL as the
8;;;   file "LICENSE".  The LLGPL consists of a preamble and the LGPL,
9;;;   which is distributed with OpenMCL as the file "LGPL".  Where these
10;;;   conflict, the preamble takes precedence. 
11;;;
12;;;   OpenMCL is referenced in the preamble as the "LIBRARY."
13;;;
14;;;   The LLGPL is also available online at
15;;;   http://opensource.franz.com/preamble.html
16
17(in-package "CCL")
18
19(eval-when (eval compile)
20  (require 'defstruct-macros))
21
22(defun short-site-name  ()
23  "Return a string with the abbreviated site name, or NIL if not known."
24  (or *short-site-name* "unspecified"))
25
26(defun long-site-name   ()
27  "Return a string with the long form of the site name, or NIL if not known."
28  (or *long-site-name* "unspecified"))
29
30(defun machine-instance ()
31  "Return a string giving the name of the local machine."
32  (%uname 1))
33
34
35(defun machine-type ()
36  "Returns a string describing the type of the local machine."
37  (%uname 4))
38
39
40
41(defloadvar *machine-version* nil)
42
43(defun machine-version ()
44  "Return a string describing the version of the computer hardware we
45are running on, or NIL if we can't find any useful information."
46  (or *machine-version*
47      (setq *machine-version*
48            #+darwin-target
49            (block darwin-machine-version
50              (%stack-block ((mib 8))
51                (setf (%get-long mib 0) #$CTL_HW
52                      (%get-long mib 4) #$HW_MODEL)
53                (%stack-block ((res 256)
54                               (reslen target::node-size))
55                  (setf (%get-byte res 0) 0
56                        (%get-natural reslen 0) 256)
57                  (if (zerop (#_sysctl mib 2 res reslen (%null-ptr) 0))
58                    (return-from darwin-machine-version (%get-cstring res))))))
59            #+linux-target
60            (with-open-file (f "/proc/cpuinfo" :if-does-not-exist nil)
61              (when f
62                (flet ((cpu-info-match (target line)
63                         (let* ((targetlen (length target))
64                                (linelen (length line)))
65                           (if (and (> linelen targetlen)
66                                    (string= target line
67                                             :end2 targetlen))
68                           (let* ((colonpos (position #\: line)))
69                             (when colonpos
70                               (string-trim " "
71                                            (subseq line (1+ colonpos)))))))))
72                  (do* ((line (read-line f nil nil)
73                              (read-line f nil nil))
74                        (target #+ppc-target "machine"
75                                #+x86-target "model name"))
76                       ((null line))
77                    (let* ((matched (cpu-info-match target line)))
78                      (when matched (return matched)))))))
79            #+freebsd-target
80            (%stack-block ((ret 512)
81                           (mib (* (record-length :uint))))
82              (setf (%get-unsigned-long mib 0)
83                    #$CTL_HW
84                    (%get-unsigned-long mib (record-length :uint))
85                    #$HW_MODEL)
86              (rlet ((oldsize :uint 512))
87                (if (eql 0 (#_sysctl mib 2 ret oldsize (%null-ptr) 0))
88                  (%get-cstring ret)
89                  1)))
90            )))
91
92
93(defun software-type ()
94  "Return a string describing the supporting software."
95  (%uname 0))
96
97
98(defun software-version ()
99  "Return a string describing version of the supporting software, or NIL
100   if not available."
101  (%uname 2))
102
103
104
105
106
107
108
109;;; Yawn.
110
111
112
113(defmethod documentation (thing doc-id)
114  (%get-documentation thing doc-id))
115
116(defun set-documentation (thing doc-id new)
117  (setf (documentation thing doc-id) new))
118
119(defmethod (setf documentation) (new thing doc-id)
120  (%put-documentation thing doc-id new))
121
122
123(defmethod documentation ((symbol symbol) (doc-type (eql 'function)))
124  (let* ((def (fboundp symbol)))        ; FBOUNDP returns info about definition
125    (when def
126      (%get-documentation def t))))
127
128(defmethod (setf documentation) ((new t)
129                                 (symbol symbol)
130                                 (doc-type (eql 'function)))
131  (let* ((def (fboundp symbol)))        ; FBOUNDP returns info about definition
132    (when def
133      (%put-documentation def
134                          t
135                          new))
136    new))
137
138(defmethod documentation ((symbol symbol) (doc-type (eql 'setf)))
139  (call-next-method))
140
141(defmethod (setf documentation) ((new t)
142                                 (symbol symbol)
143                                 (doc-type (eql 'setf)))
144  (call-next-method))
145
146
147(defmethod documentation ((symbol symbol) (doc-type (eql 'variable)))
148  (call-next-method))
149
150(defmethod (setf documentation) ((new t)
151                                 (symbol symbol)
152                                 (doc-type (eql 'variable)))
153  (call-next-method))
154
155(defmethod documentation ((symbol symbol) (doc-type (eql 'compiler-macro)))
156  (call-next-method))
157
158(defmethod (setf documentation) ((new t)
159                                 (symbol symbol)
160                                 (doc-type (eql 'compiler-macro)))
161  (call-next-method))
162
163(defmethod documentation ((symbol symbol) (doc-type (eql 'type)))
164  (let* ((class (find-class symbol nil)))
165    (if class
166      (documentation class doc-type)
167      (call-next-method))))
168
169(defmethod (setf documentation) (new (symbol symbol) (doc-type (eql 'type)))
170  (let* ((class (find-class symbol nil)))
171    (if class
172      (setf (documentation class doc-type) new)
173      (call-next-method))))
174
175(defmethod documentation ((symbol symbol) (doc-type (eql 'method-combination)))
176  (let* ((mci (method-combination-info symbol)))
177    (if mci
178      (documentation mci doc-type))))
179
180(defmethod (setf documentation) ((new t)
181                                 (symbol symbol)
182                                 (doc-type (eql 'method-combination)))
183  (let* ((mci (method-combination-info symbol)))
184    (if mci
185      (setf (documentation mci doc-type) new))))
186
187
188(defmethod documentation ((symbol symbol) (doc-type (eql 'structure)))
189  (let* ((class (find-class symbol nil)))
190    (if (typep class 'structure-class)
191      (documentation class 'type)
192      (call-next-method))))
193
194(defmethod (setf documentation) ((new t)
195                                 (symbol symbol)
196                                 (doc-type (eql 'structure)))
197  (let* ((class (find-class symbol nil)))
198    (if (typep class 'structure-class)
199      (setf (documentation class 'type) new)
200      (call-next-method))))
201
202(defmethod documentation ((p package) (doc-type (eql 't)))
203  (call-next-method))
204
205(defmethod (setf documentation) ((new t) (p package) (doc-type (eql 't)))
206  (call-next-method))
207
208(defmethod documentation ((f function) (doc-type (eql 't)))
209  (call-next-method))
210
211(defmethod (setf documentation) ((new t) (f function) (doc-type (eql 't)))
212  (call-next-method))
213
214(defmethod documentation ((f function) (doc-type (eql 'function)))
215  (documentation f t))
216
217(defmethod (setf documentation) ((new t)
218                                 (f function)
219                                 (doc-type (eql 'function)))
220  (setf (documentation f t) new))
221
222(defmethod documentation ((l cons) (doc-type (eql 'function)))
223  (let* ((name (setf-function-spec-name l)))
224    (if name
225      (documentation name doc-type)
226      (%get-documentation l doc-type))))
227
228(defmethod (setf documentation) ((new t) (l cons) (doc-type (eql 'function)))
229  (let* ((name  (setf-function-spec-name l)))
230    (if name
231      (setf (documentation name doc-type) new)
232      (%put-documentation l doc-type new))))
233
234
235(defmethod documentation ((l cons) (doc-type (eql 'compiler-macro)))
236  (let* ((name (setf-function-spec-name l)))
237    (if name
238      (documentation name doc-type)
239      (%get-documentation l doc-type))))
240
241(defmethod (setf documentation) ((new t) (l cons) (doc-type (eql 'compiler-macr0)))
242  (let* ((name (setf-function-spec-name l)))
243    (if name
244      (setf (documentation name doc-type) new)
245      (%put-documentation l doc-type new))))
246
247
248(defmethod documentation ((m method-combination)
249                          (doc-type (eql 'method-combination)))
250  (call-next-method))
251
252(defmethod (setf documentation) ((new t)
253                                 (m method-combination)
254                                 (doc-type (eql 'method-combination)))
255  (call-next-method))
256
257(defmethod documentation ((m method-combination)
258                          (doc-type (eql t)))
259  (documentation m 'method-combination))
260
261(defmethod (setf documentation) ((new t)
262                                 (m method-combination)
263                                 (doc-type (eql t)))
264  (setf (documentation m 'method-combination) new))
265
266(defmethod documentation ((m standard-method)
267                          (doc-type (eql t)))
268  (call-next-method))
269
270(defmethod (setf documentation) ((new t)
271                                 (m standard-method)
272                                 (doc-type (eql t)))
273  (call-next-method))
274
275(defmethod documentation ((c standard-class) (doc-type (eql 'type)))
276  (call-next-method))
277
278(defmethod (setf documentation) ((new t)
279                                 (c standard-class)
280                                 (doc-type (eql 'type)))
281  (call-next-method))
282
283(defmethod documentation ((c standard-class) (doc-type (eql 't)))
284  (documentation c 'type))
285
286(defmethod (setf documentation) ((new t)
287                                 (c standard-class)
288                                 (doc-type (eql 't)))
289  (setf (documentation c 'type) new))
290
291(defmethod documentation ((c structure-class) (doc-type (eql 'type)))
292  (call-next-method))
293
294(defmethod (setf documentation) ((new t)
295                                 (c structure-class)
296                                 (doc-type (eql 'type)))
297  (call-next-method))
298
299(defmethod documentation ((c structure-class) (doc-type (eql 't)))
300  (documentation c 'type))
301
302
303(defmethod (setf documentation) ((new t)
304                                 (c structure-class)
305                                 (doc-type (eql 't)))
306  (setf (documentation c 'type) new))
307
308(defmethod documentation ((slot slot-definition) (doc-type (eql 't)))
309  (standard-slot-definition.documentation slot))
310
311(defmethod (setf documentation) (new (slot slot-definition) (doc-type (eql 't)))
312  (setf (standard-slot-definition.documentation slot) new))
313
314
315
316;;; This is now deprecated; things which call it should stop doing so.
317(defun set-documentation (symbol doc-type string)
318  (setf (documentation symbol doc-type) string))
319
320(defun set-function-info (symbol info)
321  (let* ((doc-string (if (consp info) (car info) info)))
322    (if (and *save-doc-strings* (stringp doc-string))
323      (set-documentation  symbol 'function doc-string)))
324  (let* ((cons (assq symbol *nx-globally-inline*))
325         (lambda-expression (if (consp info) (cdr info))))
326    (if (and (proclaimed-inline-p symbol)
327             (not (compiler-special-form-p symbol))
328             (lambda-expression-p lambda-expression)
329             (let* ((lambda-list (cadr lambda-expression)))
330               (and (not (memq '&lap lambda-list))
331                    (not (memq '&method lambda-list))
332                    (not (memq '&lexpr lambda-list)))))
333      (if cons 
334        (%rplacd cons lambda-expression)
335        (push (cons symbol lambda-expression) *nx-globally-inline*))
336      (if cons (setq *nx-globally-inline* (delete cons *nx-globally-inline*)))))
337  symbol)
338
339
340(setf (documentation 'if 'function)
341      "If Predicate Then [Else]
342  If Predicate evaluates to non-null, evaluate Then and returns its values,
343  otherwise evaluate Else and return its values. Else defaults to NIL.")
344
345(setf (documentation 'progn 'function)
346      "progn form*
347  Evaluates each FORM and returns the value(s) of the last FORM.")
348
349(defmethod documentation ((thing character-encoding) (doc-type (eql t)))
350  (character-encoding-documentation thing))
351
352(defmethod (setf documentation) (new (thing character-encoding) (doc-type (eql t)))
353  (check-type new (or null string))
354  (setf (character-encoding-documentation thing) new))
355
356(defmethod documentation ((thing symbol) (doc-type (eql 'character-encoding)))
357  (let* ((encoding (lookup-character-encoding (intern (string thing) :keyword))))
358    (when encoding
359      (documentation encoding t))))
360
361                                 
362
363
364#|
365(setf (documentation 'car 'variable) "Preferred brand of automobile")
366(documentation 'car 'variable)
367(setf (documentation 'foo 'structure) "the structure is grand.")
368(documentation 'foo 'structure)
369(setf (documentation 'foo 'variable) "the metasyntactic remarker")
370(documentation 'foo 'variable)
371(setf (documentation 'foo 'obscure) "no one really knows what it means")
372(documentation 'foo 'obscure)
373(setf (documentation 'foo 'structure) "the structure is solid")
374(documentation 'foo 'function)
375||#
376
377;;
378
379(defparameter *report-time-function* nil
380  "If non-NULL, should be a function which accepts the following
381   keyword arguments:
382   :FORM              the form that was executed
383   :RESULTS           a list of all values returned by the execution of FORM
384   :ELAPSED-TIME      total elapsed (real) time, in milliseconds
385   :USER-TIME         elapsed user time, in milliseconds
386   :SYSTEM-TIME       elapsed system time, in milliseconds
387   :GC-TIME           total real time spent in the GC, in milliseconds
388   :BYTES-ALLOCATED   total bytes allocated
389   :MINOR-PAGE-FAULTS minor page faults
390   :MAJOR-PAGE-FAULTS major page faults
391   :SWAPS             swaps")
392
393
394(defun standard-report-time (&key form results elapsed-time user-time
395                                  system-time gc-time bytes-allocated
396                                  minor-page-faults major-page-faults
397                                  swaps)
398  (let* ((s *trace-output*)
399         (cpu-count (cpu-count)))
400    (format s "~&~S took ~:D milliseconds (~,3F seconds) to run ~%~20twith ~D available CPU core~P."
401            form elapsed-time (/ elapsed-time internal-time-units-per-second) cpu-count cpu-count)
402    (format s "~&During that period, ~:D milliseconds (~,3F seconds) were spent in user mode" user-time (/ user-time internal-time-units-per-second))
403    (format s "~&                    ~:D milliseconds (~,3F seconds) were spent in system mode" system-time (/ system-time internal-time-units-per-second))
404    (unless (eql gc-time 0)
405      (format s
406              "~%~:D milliseconds (~,3F seconds) was spent in GC."
407              gc-time (/ gc-time internal-time-units-per-second)))
408    (unless (eql 0 bytes-allocated)
409      (format s "~% ~:D bytes of memory allocated." bytes-allocated))
410    (when (or (> minor-page-faults 0)
411              (> major-page-faults 0)
412              (> swaps 0))
413      (format s
414              "~% ~:D minor page faults, ~:D major page faults, ~:D swaps."
415              minor-page-faults major-page-faults swaps))
416    (format s "~&")
417    (values-list results)))
418
419(defun report-time (form thunk)
420  (flet ((integer-size-in-bytes (i)
421           (if (typep i 'fixnum)
422             0
423             (* (logand (+ 2 (uvsize i)) (lognot 1)) 4))))
424    (rlet ((start :rusage)
425           (stop :rusage)
426           (timediff :timeval))
427      (let* ((initial-real-time (get-internal-real-time))
428             (initial-gc-time (gctime))
429             (initial-consed (total-bytes-allocated))           
430             (initial-overhead (integer-size-in-bytes initial-consed)))
431        (%%rusage start)
432        (let* ((results (multiple-value-list (funcall thunk))))
433          (declare (dynamic-extent results))
434          (%%rusage stop)         
435          (let* ((new-consed (total-bytes-allocated))               
436                 (bytes-consed
437                  (- new-consed (+ initial-overhead initial-consed)))
438                 (elapsed-real-time
439                  (- (get-internal-real-time) initial-real-time))
440                 (elapsed-gc-time (- (gctime) initial-gc-time))
441                 (elapsed-user-time
442                  (progn
443                    (%sub-timevals timediff
444                                   (pref stop :rusage.ru_utime)
445                                   (pref start :rusage.ru_utime))
446                    (timeval->milliseconds timediff)))
447                 (elapsed-system-time
448                  (progn
449                    (%sub-timevals timediff
450                                   (pref stop :rusage.ru_stime)
451                                   (pref start :rusage.ru_stime))
452                    (timeval->milliseconds timediff)))
453                 (elapsed-minor (- (pref stop :rusage.ru_minflt)
454                                   (pref start :rusage.ru_minflt)))
455                 (elapsed-major (- (pref stop :rusage.ru_majflt)
456                                   (pref start :rusage.ru_majflt)))
457                 (elapsed-swaps (- (pref stop :rusage.ru_nswap)
458                                   (pref start :rusage.ru_nswap))))
459            (funcall (or *report-time-function*
460                         #'standard-report-time)
461                     :form form
462                     :results results
463                     :elapsed-time elapsed-real-time
464                     :user-time elapsed-user-time
465                     :system-time elapsed-system-time
466                     :gc-time elapsed-gc-time
467                     :bytes-allocated bytes-consed
468                     :minor-page-faults elapsed-minor
469                     :major-page-faults elapsed-major
470                     :swaps elapsed-swaps)))))))
471
472
473
474
475;;; site names and machine-instance is in the init file.
476
477(defun add-feature (symbol)
478  "Not CL but should be."
479  (if (symbolp symbol)
480      (if (not (memq symbol *features*))
481          (setq *features* (cons symbol *features*)))))
482
483;;; (dotimes (i 5000) (declare (fixnum i)) (add-feature 'junk))
484
485
486
487
488;;; Misc string functions
489
490
491(defun string-left-trim (char-bag string &aux end)
492  "Given a set of characters (a list or string) and a string, returns
493  a copy of the string with the characters in the set removed from the
494  left end."
495  (setq string (string string))
496  (setq end (length string))
497  (do ((index 0 (%i+ index 1)))
498      ((or (eq index end) (not (find (aref string index) char-bag)))
499       (subseq string index end))))
500
501(defun string-right-trim (char-bag string &aux end)
502  "Given a set of characters (a list or string) and a string, returns
503  a copy of the string with the characters in the set removed from the
504  right end."
505  (setq string (string string))
506  (setq end (length string))
507  (do ((index (%i- end 1) (%i- index 1)))
508      ((or (%i< index 0) (not (find (aref string index) char-bag)))
509       (subseq string 0 (%i+ index 1)))))
510
511(defun string-trim (char-bag string &aux end)
512  "Given a set of characters (a list or string) and a string, returns a
513  copy of the string with the characters in the set removed from both
514  ends."
515  (setq string (string string))
516  (setq end (length string))
517  (let ((left-end) (right-end))
518     (do ((index 0 (%i+ index 1)))
519         ((or (eq index end) (not (find (aref string index) char-bag)))
520          (setq left-end index)))
521     (do ((index (%i- end 1) (%i- index 1)))
522         ((or (%i< index left-end) (not (find (aref string index) char-bag)))
523          (setq right-end index)))
524      (subseq string left-end (%i+ right-end 1))))
525
526
527
528(defun copy-symbol (symbol &optional (copy-props nil) &aux new-symbol def)
529  "Make and return a new uninterned symbol with the same print name
530  as SYMBOL. If COPY-PROPS is false, the new symbol is neither bound
531  nor fbound and has no properties, else it has a copy of SYMBOL's
532  function, value and property list."
533  (setq new-symbol (make-symbol (symbol-name symbol)))
534  (when copy-props
535      (when (boundp symbol)
536            (set new-symbol (symbol-value symbol)))
537      (when (setq def (fboundp symbol))
538            ;;;Shouldn't err out on macros/special forms.
539            (%fhave new-symbol def))
540      (set-symbol-plist new-symbol (copy-list (symbol-plist symbol))))
541  new-symbol)
542
543
544(defvar %gentemp-counter 0
545  "Counter for generating unique GENTEMP symbols.")
546
547(defun gentemp (&optional (prefix "T") (package *package*))
548  "Creates a new symbol interned in package PACKAGE with the given PREFIX."
549  (loop
550    (let* ((new-pname (%str-cat (ensure-simple-string prefix) 
551                                (%integer-to-string %gentemp-counter)))
552           (sym (find-symbol new-pname package)))
553      (if sym
554        (setq %gentemp-counter (%i+ %gentemp-counter 1))
555        (return (values (intern new-pname package))))))) ; 1 value.
556
557
558
559
560(defun add-gc-hook (hook-function &optional (which-hook :pre-gc))
561  (ecase which-hook
562    (:pre-gc
563     (pushnew hook-function *pre-gc-hook-list*)
564     (setq *pre-gc-hook* #'(lambda ()
565                             (dolist (hook *pre-gc-hook-list*)
566                               (funcall hook)))))
567    (:post-gc
568     (pushnew hook-function *post-gc-hook-list*)
569     (setq *post-gc-hook* #'(lambda ()
570                             (dolist (hook *post-gc-hook-list*)
571                               (funcall hook))))))
572  hook-function)
573
574(defun remove-gc-hook (hook-function &optional (which-hook :pre-gc))
575  (ecase which-hook
576    (:pre-gc
577     (unless (setq *pre-gc-hook-list* (delq hook-function *pre-gc-hook-list*))
578       (setq *pre-gc-hook* nil)))
579    (:post-gc
580     (unless (setq *post-gc-hook-list* (delq hook-function *post-gc-hook-list*))
581       (setq *post-gc-hook* nil)))))
582
583
584
585
586
587
588(defun find-method-by-names (name qualifiers specializers)
589  (let ((gf (fboundp name)))
590    (when gf
591      (if (not (standard-generic-function-p gf))
592        (error "~S is not a generic-function." gf)
593        (let ((methods (%gf-methods gf)))
594          (when methods
595            (let* ((spec-len (length (%method-specializers (car methods))))
596                   (new-specs (make-list spec-len :initial-element (find-class t))))
597              (declare (dynamic-extent new-specs))
598              (do ((specs specializers (cdr specs))
599                   (nspecs new-specs (cdr nspecs)))
600                  ((or (null specs) (null nspecs)))
601                (let ((s (car specs)))
602                  (rplaca nspecs (if (consp s) s (find-class s nil)))))
603              (find-method gf qualifiers new-specs nil))))))))
604
605
606
607(defun get-string-from-user (prompt)
608  (with-terminal-input
609      (format *query-io* "~&~a " prompt)
610    (force-output *query-io*)
611    (clear-input *query-io*)
612    (values (read-line *query-io*))))
613
614
615(defun select-item-from-list (list &key (window-title "Select one of the following")
616                                   (table-print-function #'prin1)
617                                   &allow-other-keys)
618  (block get-answer
619    (with-terminal-input
620      (format *query-io* "~a:~%" window-title)
621      (loop
622         (catch :redisplay
623           (do* ((l list (cdr l))
624                 (i 0 (1+ i))
625                 (item (car l) (car l)))
626                ((null l))
627             (declare (fixnum i))
628             (format *query-io* "~&  ~d: " i)
629             (funcall table-print-function item *query-io*))
630           (loop
631              (fresh-line *query-io*)
632              (let* ((string (get-string-from-user "Selection [number,q,r,?]:"))
633                     (value (ignore-errors
634                              (let* ((*package* *keyword-package*))
635                                (read-from-string string nil)))))
636                (cond ((eq value :q) (throw :cancel t))
637                      ((eq value :r) (throw :redisplay t))
638                      ((eq value :?) 
639                       (format *query-io* "~%Enter the number of the selection, ~%  r to redisplay, ~%  q to cancel or ~%  ? to show this message again."))
640                      ((and (typep value 'unsigned-byte)
641                            (< value (length list)))
642                       (return-from get-answer (list (nth value list))))))))))))
643
644;;; There should ideally be some way to override the UI (such as
645;;; it is ...) here.
646;;; More generally, this either
647;;;   a) shouldn't exist, or
648;;;   b) should do more sanity-checking
649(defun choose-file-dialog (&key file-types (prompt "File name:"))
650  (%choose-file-dialog t prompt file-types))
651
652(defun choose-new-file-dialog (&key prompt)
653  (%choose-file-dialog nil prompt nil))
654
655(defun %choose-file-dialog (must-exist prompt file-types)
656  (loop
657      (let* ((namestring (get-string-from-user prompt))
658             (pathname (ignore-errors (pathname namestring)))
659             (exists (and pathname (probe-file pathname))))
660        (when (and (if must-exist exists)
661                   (or (null file-types)
662                       (member (pathname-type pathname)
663                               file-types :test #'equal)))
664          (return pathname))
665        (if (not exists)
666          (format *query-io* "~&~s does not exist." namestring)
667          (format *query-io* "~&Type of ~s is not one of ~{~a~}"
668                  namestring file-types)))))
669
670(defparameter *overwrite-dialog-hook* nil)
671(defun overwrite-dialog (filename prompt)
672  (if *overwrite-dialog-hook*
673    (funcall *overwrite-dialog-hook* filename prompt)
674    t))
675
676;;; Might want to have some other entry for, e.g., the inspector
677;;; and to let it get its hands on the list header returned by
678;;; disassemble-ppc-function.  Maybe disassemble-ppc-function
679;;; should take care of "normalizing" the code-vector ?
680(defun disassemble (thing)
681  "Disassemble the compiled code associated with OBJECT, which can be a
682  function, a lambda expression, or a symbol with a function definition. If
683  it is not already compiled, the compiler is called to produce something to
684  disassemble."
685  (#+ppc-target ppc-xdisassemble
686   #+x8664-target x8664-xdisassemble
687   (require-type (function-for-disassembly thing) 'compiled-function)))
688
689(defun function-for-disassembly (thing)
690  (let* ((fun thing))
691    ;; CLHS says that DISASSEMBLE should signal a type error if its
692    ;; argument isn't a function designator.  Hard to imagine any
693    ;; code depending on that ...
694    ;;(when (typep fun 'standard-method) (setq fun (%method-function fun)))
695    (when (or (symbolp fun)
696              (and (consp fun) (neq (%car fun) 'lambda)))
697      (setq fun (fboundp thing))
698      (when (and (symbolp thing) (not (functionp fun)))
699        (setq fun (macro-function thing))))
700    (if (typep fun 'compiled-lexical-closure)
701        (setq fun (closure-function fun)))
702    (when (lambda-expression-p fun)
703      (setq fun (compile-named-function fun nil)))
704    fun))
705
706(%fhave 'df #'disassemble)
Note: See TracBrowser for help on using the repository browser.