X-Git-Url: http://repo.macrolet.net/gitweb/?a=blobdiff_plain;f=src%2Fcode%2Ftarget-misc.lisp;h=a64153827372e1c07a80eef19200e6370c7ebde5;hb=f12f2c5a8ae794dc414dd6a42e0b25740d576aa1;hp=e5680f59ff0b6e16a06f1abe58dd11c1d8b91341;hpb=416152f084604094445a758ff399871132dff2bd;p=sbcl.git diff --git a/src/code/target-misc.lisp b/src/code/target-misc.lisp index e5680f5..a641538 100644 --- a/src/code/target-misc.lisp +++ b/src/code/target-misc.lisp @@ -13,42 +13,134 @@ ;;;; files for more information. (in-package "SB!IMPL") + +;;;; function names and documentation + +;;;; the ANSI interface to function names (and to other stuff too) +(defun function-lambda-expression (fun) + "Return (VALUES DEFINING-LAMBDA-EXPRESSION CLOSURE-P NAME), where + DEFINING-LAMBDA-EXPRESSION is NIL if unknown, or a suitable argument + to COMPILE otherwise, CLOSURE-P is non-NIL if the function's definition + might have been enclosed in some non-null lexical environment, and + NAME is some name (for debugging only) or NIL if there is no name." + (declare (type function fun)) + (let* ((fun (%simple-fun-self fun)) + (name (%fun-name fun)) + (code (sb!di::fun-code-header fun)) + (info (sb!kernel:%code-debug-info code))) + (if info + (let ((source (sb!c::debug-info-source info))) + (cond ((and (eq (sb!c::debug-source-from source) :lisp) + (eq (sb!c::debug-source-function source) fun)) + (values (svref (sb!c::debug-source-name source) 0) + nil + name)) + ((legal-fun-name-p name) + (let ((exp (fun-name-inline-expansion name))) + (values exp (not exp) name))) + (t + (values nil t name)))) + (values nil t name)))) + +(defun closurep (object) + (= sb!vm:closure-header-widetag (widetag-of object))) + +(defun %fun-fun (function) + (declare (function function)) + (case (widetag-of function) + (#.sb!vm:simple-fun-header-widetag + function) + (#.sb!vm:closure-header-widetag + (%closure-fun function)) + (#.sb!vm:funcallable-instance-header-widetag + (%fun-fun (funcallable-instance-fun function))))) + +(defun %closure-values (object) + (declare (function object)) + (coerce (loop for index from 0 below (1- (get-closure-length object)) + collect (%closure-index-ref object index)) + 'simple-vector)) + +(defun %fun-lambda-list (object) + (%simple-fun-arglist (%fun-fun object))) -;;; cobbled from stuff in describe.lisp. -(defun function-doc (x) - (let ((name - (case (get-type x) - (#.sb!vm:closure-header-type - (%function-name (%closure-function x))) - ((#.sb!vm:function-header-type #.sb!vm:closure-function-header-type) - (%function-name x)) - (#.sb!vm:funcallable-instance-header-type - (typecase x - ;; FIXME: byte compiler to go away completely - #| - (byte-function - (sb!c::byte-function-name x)) - (byte-closure - (sb!c::byte-function-name (byte-closure-function x))) - |# - (t ;; funcallable-instance - (%function-name - (funcallable-instance-function x)))))))) +;;; a SETFable function to return the associated debug name for FUN +;;; (i.e., the third value returned from CL:FUNCTION-LAMBDA-EXPRESSION), +;;; or NIL if there's none +(defun %fun-name (function) + (%simple-fun-name (%fun-fun function))) + +(defun %fun-type (function) + (%simple-fun-type (%fun-fun function))) + +(defun (setf %fun-name) (new-name fun) + (aver nil) ; since this is unsafe 'til bug 137 is fixed + (let ((widetag (widetag-of fun))) + (case widetag + (#.sb!vm:simple-fun-header-widetag + ;; KLUDGE: The pun that %SIMPLE-FUN-NAME is used for closure + ;; functions is left over from CMU CL (modulo various renaming + ;; that's gone on since the fork). + (setf (%simple-fun-name fun) new-name)) + (#.sb!vm:closure-header-widetag + ;; FIXME: It'd be nice to be able to set %FUN-NAME here on + ;; per-closure basis. Instead, we are still using the CMU CL + ;; approach of closures being named after their closure + ;; function, which doesn't work right e.g. for structure + ;; accessors, and might not be quite right for DEFUN + ;; in a non-null lexical environment either. + ;; When/if weak hash tables become supported + ;; again, it'll become easy to fix this, but for now there + ;; seems to be no easy way (short of the ugly way of adding a + ;; slot to every single closure header), so we don't. + ;; + ;; Meanwhile, users might encounter this problem by doing DEFUN + ;; in a non-null lexical environment, so we try to give a + ;; reasonably meaningful user-level "error" message (but only + ;; as a warning because this is optional debugging + ;; functionality anyway, not some hard ANSI requirement). + (warn "can't set name for closure, leaving name unchanged")) + (t + ;; The other function subtype names are also un-settable + ;; but this problem seems less likely to be tickled by + ;; user-level code, so we can give a implementor-level + ;; "error" (warning) message. + (warn "can't set function name ((~S function)=~S), leaving it unchanged" + 'widetag-of widetag)))) + new-name) + +(defun %fun-doc (x) + ;; FIXME: This business of going through %FUN-NAME and then globaldb + ;; is the way CMU CL did it, but it doesn't really seem right. + ;; When/if weak hash tables become supported again, using a weak + ;; hash table to maintain the object/documentation association would + ;; probably be better. + (let ((name (%fun-name x))) (when (and name (typep name '(or symbol cons))) (values (info :function :documentation name))))) + +;;; various environment inquiries (defvar *features* '#.sb-cold:*shebang-features* #!+sb-doc "a list of symbols that describe features provided by the implementation") - -;;; various environment inquiries (defun machine-instance () #!+sb-doc "Return a string giving the name of the local machine." (sb!unix:unix-gethostname)) +(defvar *machine-version*) + +(defun machine-version () + #!+sb-doc + "Return a string describing the version of the computer hardware we +are running on, or NIL if we can't find any useful information." + (unless (boundp '*machine-version*) + (setf *machine-version* (get-machine-version))) + *machine-version*) + ;;; FIXME: Don't forget to set these in a sample site-init file. ;;; FIXME: Perhaps the functions could be SETFable instead of having the ;;; interface be through special variables? As far as I can tell @@ -62,13 +154,31 @@ #!+sb-doc "the value of LONG-SITE-NAME") (defun short-site-name () #!+sb-doc - "Returns a string with the abbreviated site name, or NIL if not known." + "Return a string with the abbreviated site name, or NIL if not known." *short-site-name*) (defun long-site-name () #!+sb-doc - "Returns a string with the long form of the site name, or NIL if not known." + "Return a string with the long form of the site name, or NIL if not known." *long-site-name*) +;;;; ED +(defvar *ed-functions* nil + "See function documentation for ED.") + +(defun ed (&optional x) + "Starts the editor (on a file or a function if named). Functions +from the list *ED-FUNCTIONS* are called in order with X as an argument +until one of them returns non-NIL; these functions are responsible for +signalling a FILE-ERROR to indicate failure to perform an operation on +the file system." + (dolist (fun *ed-functions* + (error 'extension-failure + :format-control "Don't know how to ~S ~A" + :format-arguments (list 'ed x) + :references (list '(:sbcl :variable *ed-functions*)))) + (when (funcall fun x) + (return t)))) + ;;;; dribble stuff ;;; Each time we start dribbling to a new stream, we put it in @@ -92,34 +202,47 @@ record of further I/O to that file. Without an argument, it closes the dribble file, and quits logging." (cond (pathname - (let* ((new-dribble-stream - (open pathname - :direction :output - :if-exists if-exists - :if-does-not-exist :create)) - (new-standard-output - (make-broadcast-stream *standard-output* new-dribble-stream)) - (new-error-output - (make-broadcast-stream *error-output* new-dribble-stream)) - (new-standard-input - (make-echo-stream *standard-input* new-dribble-stream))) - (push (list *dribble-stream* *standard-input* *standard-output* - *error-output*) - *previous-dribble-streams*) - (setf *dribble-stream* new-dribble-stream) - (setf *standard-input* new-standard-input) - (setf *standard-output* new-standard-output) - (setf *error-output* new-error-output))) - ((null *dribble-stream*) - (error "not currently dribbling")) - (t - (let ((old-streams (pop *previous-dribble-streams*))) - (close *dribble-stream*) - (setf *dribble-stream* (first old-streams)) - (setf *standard-input* (second old-streams)) - (setf *standard-output* (third old-streams)) - (setf *error-output* (fourth old-streams))))) + (let* ((new-dribble-stream + (open pathname + :direction :output + :if-exists if-exists + :if-does-not-exist :create)) + (new-standard-output + (make-broadcast-stream *standard-output* new-dribble-stream)) + (new-error-output + (make-broadcast-stream *error-output* new-dribble-stream)) + (new-standard-input + (make-echo-stream *standard-input* new-dribble-stream))) + (push (list *dribble-stream* *standard-input* *standard-output* + *error-output*) + *previous-dribble-streams*) + (setf *dribble-stream* new-dribble-stream) + (setf *standard-input* new-standard-input) + (setf *standard-output* new-standard-output) + (setf *error-output* new-error-output))) + ((null *dribble-stream*) + (error "not currently dribbling")) + (t + (let ((old-streams (pop *previous-dribble-streams*))) + (close *dribble-stream*) + (setf *dribble-stream* (first old-streams)) + (setf *standard-input* (second old-streams)) + (setf *standard-output* (third old-streams)) + (setf *error-output* (fourth old-streams))))) (values)) (defun %byte-blt (src src-start dst dst-start dst-end) (%byte-blt src src-start dst dst-start dst-end)) + +;;;; some *LOAD-FOO* variables + +(defvar *load-print* nil + #!+sb-doc + "the default for the :PRINT argument to LOAD") + +(defvar *load-verbose* nil + ;; Note that CMU CL's default for this was T, and ANSI says it's + ;; implementation-dependent. We choose NIL on the theory that it's + ;; a nicer default behavior for Unix programs. + #!+sb-doc + "the default for the :VERBOSE argument to LOAD")