### 9.2 Operating System Definitions ¶

Function: GET-DECODED-TIME () ¶

  Package:LISP

  Returns the current time in decoded time format. Returns nine values: second, minute, hour, date, month, year, day-of-week, daylight-saving-time-p, and time-zone.

Function: HOST-NAMESTRING (pathname) ¶

  Package:LISP

  Returns the host part of PATHNAME as a string.

Function: RENAME-FILE (file new-name) ¶

  Package:LISP

  Renames the file FILE to NEW-NAME. FILE may be a string, a pathname, or a stream.

Function: FILE-AUTHOR (file) ¶

  Package:LISP

  Returns the author name of the specified file, as a string. FILE may be a string or a stream

Function: PATHNAME-HOST (pathname) ¶

  Package:LISP

  Returns the host slot of PATHNAME.

Function: FILE-POSITION (file-stream &optional position) ¶

  Package:LISP

  Sets the file pointer of the specified file to POSITION, if POSITION is given. Otherwise, returns the current file position of the specified file.

Function: DECODE-UNIVERSAL-TIME (universal-time &optional (timezone -9)) ¶

  Package:LISP

  Converts UNIVERSAL-TIME into a decoded time at the TIMEZONE. Returns nine values: second, minute, hour, date, month (1 - 12), year, day-of-week (0 - 6), daylight-saving-time-p, and time-zone. TIMEZONE in GCL defaults to 6, the time zone of Austin, Texas.

Function: USER-HOMEDIR-PATHNAME (&optional host) ¶

  Package:LISP

  Returns the home directory of the logged in user as a pathname. HOST is ignored.

Variable: *MODULES* ¶

  Package:LISP A list of names of the modules that have been loaded into GCL.

Function: SHORT-SITE-NAME () ¶

  Package:LISP

  Returns a string that identifies the physical location of the current GCL.

Function: DIRECTORY (name) ¶

  Package:LISP

  Returns a list of files that match NAME. NAME may be a string, a pathname, or a file stream.

Function: SOFTWARE-VERSION () ¶

  Package:LISP

  Returns a string that identifies the software version of the software under which GCL is currently running.

Constant: INTERNAL-TIME-UNITS-PER-SECOND ¶

  Package:LISP The number of internal time units that fit into a second.

Function: ENOUGH-NAMESTRING (pathname &optional (defaults *default-pathname-defaults*)) ¶

  Package:LISP

  Returns a string which uniquely identifies PATHNAME with respect to DEFAULTS.

Function: REQUIRE (module-name &optional (pathname)) ¶

  Package:LISP

  If the specified module is not present, then loads the appropriate file(s). PATHNAME may be a single pathname or it may be a list of pathnames.

Function: ENCODE-UNIVERSAL-TIME (second minute hour date month year &optional (timezone )) ¶

  Package:LISP

  Does the inverse operation of DECODE-UNIVERSAL-TIME.

Function: LISP-IMPLEMENTATION-VERSION () ¶

  Package:LISP

  Returns a string that tells you when the current GCL implementation is brought up.

Function: MACHINE-INSTANCE () ¶

  Package:LISP

  Returns a string that identifies the machine instance of the machine on which GCL is currently running.

Function: ROOM (&optional (x t)) ¶

  Package:LISP

  Displays information about storage allocation in the following format.

  - for each type class
    - the number of pages so-far allocated for the type class
    - the maximum number of pages for the type class
    - the percentage of used cells to cells so-far allocated
    - the number of times the garbage collector has been called to collect cells of the type class
    - the implementation types that belongs to the type class
  - the number of pages actually allocated for contiguous blocks
  - the maximum number of pages for contiguous blocks
  - the number of times the garbage collector has been called to collect contiguous blocks
  - the number of pages in the hole
  - the maximum number of pages for relocatable blocks
  - the number of times the garbage collector has been called to collect relocatable blocks
  - the total number of pages allocated for cells
  - the total number of pages allocated
  - the number of available pages
  - the number of pages GCL can use.

    The number of times the garbage collector has been called is not shown, if the number is zero. The optional X is ignored.

Function: GET-UNIVERSAL-TIME () ¶

  Package:LISP

  Returns the current time as a single integer in universal time format.

Function: GET-INTERNAL-RUN-TIME () ¶

  Package:LISP

  Returns the run time in the internal time format. This is useful for finding CPU usage. If the operating system allows, a second value containing CPU usage of child processes is returned.

Variable: *DEFAULT-PATHNAME-DEFAULTS* ¶

  Package:LISP The default pathname-defaults pathname.

Function: LONG-SITE-NAME () ¶

  Package:LISP

  Returns a string that identifies the physical location of the current GCL.

Function: DELETE-FILE (file) ¶

  Package:LISP Deletes FILE.

Function: GET-INTERNAL-REAL-TIME () ¶

  Package:LISP

  Returns the real time in the internal time format. This is useful for finding elapsed time.

Function: MACHINE-TYPE () ¶

  Package:LISP

  Returns a string that identifies the machine type of the machine on which GCL is currently running.

Macro: TIME ¶

  Package:LISP

  Syntax:

      (time form)

  Evaluates FORM and outputs timing statistics on *TRACE-OUTPUT*.

Function: SOFTWARE-TYPE () ¶

  Package:LISP

  Returns a string that identifies the software type of the software under which GCL is currently running.

Function: LISP-IMPLEMENTATION-TYPE () ¶

  Package:LISP

  Returns a string that tells you that you are using a version of GCL.

Function: SLEEP (n) ¶

  Package:LISP

  This function causes execution to be suspended for N seconds. N may be any non-negative, non-complex number.