GNU Info

(slib.info)System Interface

---

Prev: Trace Up: Session Support

---

Enter node , (file) or (file)node

System Interface
----------------

If `(provided? 'getenv)':

 - Function: getenv name
     Looks up NAME, a string, in the program environment.  If NAME is
     found a string of its value is returned.  Otherwise, `#f' is
     returned.

If `(provided? 'system)':

 - Function: system command-string
     Executes the COMMAND-STRING on the computer and returns the
     integer status code.

If `system' is provided by the Scheme implementation, the "net-clients"
package provides interfaces to common network client programs like FTP,
mail, and Netscape.

  `(require 'net-clients)'

 - Function: call-with-tmpnam proc
 - Function: call-with-tmpnam proc k
     Calls PROC with K arguments, strings returned by successive calls
     to `tmpnam'.  If PROC returns, then any files named by the
     arguments to PROC are deleted automatically and the value(s)
     yielded by the PROC is(are) returned.  K may be ommited, in which
     case it defaults to `1'.

 - Function: user-email-address
     `user-email-address' returns a string of the form
     `username@hostname'.  If this e-mail address cannot be obtained,
     #f is returned.

 - Function: current-directory
     `current-directory' returns a string containing the absolute file
     name representing the current working directory.  If this string
     cannot be obtained, #f is returned.

     If `current-directory' cannot be supported by the platform, the
     value of `current-directory' is #f.

 - Function: make-directory name
     Creates a sub-directory NAME of the current-directory.  If
     successful, `make-directory' returns #t; otherwise #f.

 - Function: null-directory? file-name
     Returns #t if changing directory to FILE-NAME makes the current
     working directory the same as it is before changing directory;
     otherwise returns #f.

 - Function: absolute-path? file-name
     Returns #t if FILE-NAME is a fully specified pathname (does not
     depend on the current working directory); otherwise returns #f.

 - Function: glob-pattern? str
     Returns #t if the string STR contains characters used for
     specifying glob patterns, namely `*', `?', or `['.

 - Function: parse-ftp-address uri
     Returns a list of the decoded FTP URI; or #f if indecipherable.
     FTP "Uniform Resource Locator", "ange-ftp", and "getit" formats
     are handled.  The returned list has four elements which are
     strings or #f:

       0. username

       1. password

       2. remote-site

       3. remote-directory

 - Function: ftp-upload paths user password remote-site remote-dir
     PASSWORD must be a non-empty string or #f.  PATHS must be a
     non-empty list of pathnames or Glob patterns (Note: Filenames)
     matching files to transfer.

     `ftp-upload' puts the files specified by PATHS into the REMOTE-DIR
     directory of FTP REMOTE-SITE using name USER with (optional)
     PASSWORD.

     If PASSWORD is #f and USER is not `ftp' or `anonymous', then USER
     is ignored; FTP takes the username and password from the `.netrc'
     or equivalent file.

 - Function: path->uri path
     Returns a URI-string for PATH on the local host.

 - Function: browse-url-netscape url
     If a `netscape' browser is running, `browse-url-netscape' causes
     the browser to display the page specified by string URL and
     returns #t.

     If the browser is not running, `browse-url-netscape' runs
     `netscape' with the argument URL.  If the browser starts as a
     background job, `browse-url-netscape' returns #t immediately; if
     the browser starts as a foreground job, then `browse-url-netscape'
     returns #t when the browser exits; otherwise it returns #f.