1997-04-26 13:46:16 -04:00
|
|
|
We are pleased to release scsh version 0.5.1 to celebrate the
|
1997-04-21 16:55:48 -04:00
|
|
|
Patriot's Day holiday in the state of Massachusetts. The new release
|
|
|
|
has many bug fixes, improvements and new features.
|
1995-10-31 22:00:55 -05:00
|
|
|
|
|
|
|
The text below gives a general description of scsh, instructions for
|
|
|
|
obtaining it, pointers to discussion forums, and a description of the
|
1997-04-21 16:55:48 -04:00
|
|
|
new features in release 0.5. To read this document with emacs outline
|
1995-10-31 22:00:55 -05:00
|
|
|
mode, say M-x outline-mode.
|
|
|
|
|
|
|
|
* What is scsh
|
|
|
|
==============
|
|
|
|
Scsh is a broad-spectrum systems-programming environment for Unix embedded
|
|
|
|
in R4RS Scheme.
|
|
|
|
|
|
|
|
** Scsh as a scripting language
|
|
|
|
-------------------------------
|
|
|
|
Scsh has a high-level process notation for doing shell-script like tasks:
|
|
|
|
running programs, establishing pipelines and I/O redirection. For example, the
|
|
|
|
shell pipeline
|
|
|
|
|
|
|
|
gunzip < paper.tex.gz | detex | spell | lpr -Ppulp &
|
|
|
|
|
|
|
|
would be written in scsh as
|
|
|
|
|
|
|
|
(& (| (gunzip) (detex) (spell) (lpr -Ppulp)) ; Background a pipeline
|
|
|
|
(< paper.tex.gz)) ; with this redirection
|
|
|
|
|
|
|
|
Scsh embeds this process notation within a full Scheme implementation.
|
1995-11-01 18:27:31 -05:00
|
|
|
The process notation is realized as a set of macro definitions, and is
|
1995-10-31 22:00:55 -05:00
|
|
|
carefully designed to allow full integration with standard Scheme code.
|
|
|
|
Scsh isn't Scheme-like; it is Scheme.
|
|
|
|
|
|
|
|
At the scripting level, scsh also has an Awk design, also implemented
|
|
|
|
as a macro that can be embedded inside general Scheme code.
|
|
|
|
|
|
|
|
** Scsh as a systems-programming language
|
|
|
|
-----------------------------------------
|
|
|
|
Scsh additionally provides the low-level access to the operating system
|
1997-04-22 13:55:50 -04:00
|
|
|
normally associated with C. The current release provides full access to Posix,
|
|
|
|
plus important non-Posix extensions, such as complete sockets
|
|
|
|
support. "Complete Posix" means: fork, exec & wait, sockets, full read, write,
|
|
|
|
open & close, seek & tell, complete file-system access, including stat,
|
|
|
|
chmod/chgrp/chown, symlink, FIFO & directory access, tty & pty support, file
|
|
|
|
locking, pipes, select, file-name pattern-matching, time & date, environment
|
|
|
|
variables, signal handlers, and more.
|
1995-10-31 22:00:55 -05:00
|
|
|
|
|
|
|
In brief, you can now write Unix systems programs in Scheme instead of C.
|
|
|
|
For example, we have implemented an extensible HTTP server at MIT entirely
|
|
|
|
in scsh.
|
|
|
|
|
|
|
|
As important as full access to the OS is the manner in which it is provided.
|
|
|
|
Scsh integrates the OS support into Scheme in a manner which respects the
|
|
|
|
general structure of the language. The details of the design are discussed
|
|
|
|
in a joint MIT Lab for Computer Science/University of Hong Kong technical
|
|
|
|
report, "A Scheme Shell," also to appear in a revised format in the *Journal
|
|
|
|
of Lisp and Symbolic Computation." This paper is also available by ftp:
|
1995-11-01 15:49:33 -05:00
|
|
|
ftp://ftp-swiss.ai.mit.edu/pub/su/scsh/scsh-paper.ps
|
1995-10-31 22:00:55 -05:00
|
|
|
|
|
|
|
|
|
|
|
** Scsh is a portable programming environment
|
|
|
|
---------------------------------------------
|
|
|
|
Scsh is designed for portability. It is implemented on top of Scheme 48,
|
|
|
|
a byte-code-interpreter Scheme implementation. The Scheme 48 virtual machine
|
|
|
|
can be compiled on any system with a C compiler; the rest of Scheme 48 is
|
|
|
|
machine-independent across 32-bit processors. Scsh's OS interface is
|
|
|
|
also quite portable, providing a consistent interface across different
|
|
|
|
Unix platforms. We currently have scsh implementations for
|
1995-10-13 23:34:21 -04:00
|
|
|
AIX,
|
1996-11-10 15:51:15 -05:00
|
|
|
BSD/OS,
|
1995-10-13 23:34:21 -04:00
|
|
|
CXUX,
|
1995-11-01 18:27:31 -05:00
|
|
|
FreeBSD,
|
1995-10-13 23:34:21 -04:00
|
|
|
HP-UX,
|
|
|
|
IRIX,
|
|
|
|
Linux,
|
|
|
|
NetBSD,
|
1996-11-10 15:51:15 -05:00
|
|
|
NeXTStep,
|
1995-10-13 23:34:21 -04:00
|
|
|
Solaris,
|
|
|
|
SunOS,
|
|
|
|
Ultrix
|
1995-10-31 22:00:55 -05:00
|
|
|
Scsh code should run without change across these systems.
|
|
|
|
Porting to new platforms is usually not difficult.
|
|
|
|
|
1995-10-13 23:34:21 -04:00
|
|
|
|
1995-10-31 22:00:55 -05:00
|
|
|
* Obtaining and installing scsh
|
|
|
|
===============================
|
|
|
|
You can get a copy of scsh via anonymous ftp, from
|
1995-11-01 15:49:33 -05:00
|
|
|
ftp://ftp-swiss.ai.mit.edu/pub/su/scsh/scsh.tar.gz
|
1995-10-31 22:00:55 -05:00
|
|
|
The tar file includes a detailed manual and a paper describing
|
1995-10-13 23:34:21 -04:00
|
|
|
the design of the system.
|
|
|
|
|
|
|
|
For the lazily curious, we also have the manual separately available as
|
1995-11-01 15:49:33 -05:00
|
|
|
ftp://ftp-swiss.ai.mit.edu/pub/su/scsh/scsh-manual.ps
|
1995-10-13 23:34:21 -04:00
|
|
|
Just click 'n view.
|
|
|
|
|
1995-10-31 22:00:55 -05:00
|
|
|
You *should* be able to build scsh on the standard platforms with exactly five
|
|
|
|
commands: gunzip, tar, cd, ./configure, and make. The configure script figures
|
|
|
|
out the special flags and switches needed to make the build work (thanks to
|
|
|
|
the GNU project for the autoconfig tool that makes this possible).
|
|
|
|
|
1995-11-01 14:13:37 -05:00
|
|
|
After doing the make, you can start up a Scheme shell and try it out
|
|
|
|
by saying
|
1996-11-01 03:02:54 -05:00
|
|
|
./scshvm -o ./scshvm -i ./scsh/scsh.image
|
1995-11-01 14:13:37 -05:00
|
|
|
See the manual for full details on the command-line switches.
|
|
|
|
|
1995-10-31 22:00:55 -05:00
|
|
|
If it's harder than this, and your system is standard, we'd like to know
|
|
|
|
about it.
|
|
|
|
|
|
|
|
|
|
|
|
* Getting in touch
|
|
|
|
==================
|
|
|
|
There are two main ways to join in scsh-related discussion: the mailing-list
|
|
|
|
scsh@martigny.ai.mit.edu
|
|
|
|
and the netnews group
|
1996-11-01 03:02:54 -05:00
|
|
|
comp.lang.scheme.scsh
|
1995-10-31 22:00:55 -05:00
|
|
|
These two forums are exactly equivalent, being bi-directionally gatewayed
|
|
|
|
at MIT.
|
|
|
|
|
|
|
|
Bugs can be reported to
|
|
|
|
scsh-bugs@martigny.ai.mit.edu
|
|
|
|
|
|
|
|
If you do not receive the alt netnews hierarchy, or wish to join the mailing
|
|
|
|
list for other reasons, send mail to
|
|
|
|
scsh-request@martigny.ai.mit.edu
|
|
|
|
|
|
|
|
|
1995-11-01 15:52:51 -05:00
|
|
|
* The World-Wide What?
|
|
|
|
======================
|
|
|
|
|
|
|
|
We even have one of those URL things:
|
1996-11-01 03:02:54 -05:00
|
|
|
http://www-swiss.ai.mit.edu/scsh/
|
1995-11-01 15:52:51 -05:00
|
|
|
|
|
|
|
|
1995-10-31 22:00:55 -05:00
|
|
|
* New in this release
|
|
|
|
=====================
|
|
|
|
|
1996-11-01 03:02:54 -05:00
|
|
|
** Signal handlers
|
1996-11-10 08:56:13 -05:00
|
|
|
We finally have signal handlers. Go wild.
|
1995-10-31 22:00:55 -05:00
|
|
|
|
1996-11-01 03:02:54 -05:00
|
|
|
** Static heap linker
|
|
|
|
The static heap linker converts a Scheme 48 bytecode image as
|
|
|
|
embodied in a .image file to a C representation. This C
|
|
|
|
code is then compiled and linked in with a virtual machine. One
|
1996-11-10 08:56:13 -05:00
|
|
|
pleasant side effect of this is reduced startup times and heap sizes.
|
|
|
|
Another good thing is that immutable parts of the image can be shared
|
1996-11-01 03:02:54 -05:00
|
|
|
between processes. see the script scsh/static.scm
|
1995-10-13 23:34:21 -04:00
|
|
|
|
1996-11-07 11:16:34 -05:00
|
|
|
** Last few bits of Posix
|
|
|
|
Scheme bindings for isatty(), ttyname(), ctermid(), and fcntl().
|
|
|
|
|
|
|
|
** Regular expression compilation
|
|
|
|
- MAKE-REGEXP now actually does something useful.
|
|
|
|
- AWK has been modified to use it, precompiling all of its
|
|
|
|
patterns outside the main loop.
|
|
|
|
- Unfortunately, things are still pretty slow. We'll work on it.
|
|
|
|
|
|
|
|
** New meta-arg second-line syntax
|
|
|
|
Simpler grammar.
|
|
|
|
|
1996-11-11 14:21:25 -05:00
|
|
|
** New -sfd <fdes> command line switch
|
1996-11-07 11:16:34 -05:00
|
|
|
Scripts can be read from stdin or other open file descriptors.
|
|
|
|
|
1996-11-08 10:49:04 -05:00
|
|
|
** Starting up programs with the "-e <entry-point>" command-line
|
|
|
|
switch and with the (DUMP-SCSH-PROGRAM <file-name> <entry-point>)
|
|
|
|
are now equivalent in that both pass a list of command-line arguments
|
|
|
|
that includes the program name. The two start-up methods were not
|
1996-11-10 08:56:13 -05:00
|
|
|
the same in the previous release. NOTE: THIS IS A BACKWARDS-INCOMPATIBLE
|
|
|
|
CHANGE IN DUMP-SCSH-PROGRAM FROM THE PREVIOUS RELEASE.
|
1996-11-08 10:49:04 -05:00
|
|
|
|
1995-10-31 22:00:55 -05:00
|
|
|
** Etc.
|
1996-11-01 03:02:54 -05:00
|
|
|
Solaris 2 on i386 support, AIX 4 support, HP-UX now uses dld for
|
|
|
|
faster loading, a few small networking bug fixs, better error
|
1996-11-07 11:16:34 -05:00
|
|
|
reporting, bug fixes, more efficient handling of closing unrevealed
|
|
|
|
file descriptors at exec() with CLOEXEC, ...
|
1995-10-13 23:34:21 -04:00
|
|
|
|
|
|
|
|
1995-10-31 22:00:55 -05:00
|
|
|
* Thanks
|
|
|
|
========
|
1995-10-13 23:34:21 -04:00
|
|
|
|
1996-11-08 15:42:30 -05:00
|
|
|
We would like to thank Michael Becker, Glenn Barry, Travis Broughton,
|
|
|
|
Robert E. Brown, Charlie Conklin, Franklin Chen, Jin S. Choi, Douglas
|
|
|
|
S. J. De Couto, Brian F. Dennis, Sean Doran, Kevin Esler, Lutz Euler,
|
|
|
|
Lewis Girod, Dan Hagerty, Rolf-Thomas Happe, David Hull, Steven L.
|
1996-11-18 11:48:20 -05:00
|
|
|
Jenkins, Patrick May, Richard Kelsey, Jay Nietling, Tod Olson, Stephen
|
|
|
|
Pascoe, Jonathan Rees, Michel Schinz, Cotton Seed, Bill Sommerfeld,
|
|
|
|
Michael Sperber, Steven L. Tamm, Ed Tobin, Victor Zandy, and others
|
|
|
|
for bug reports, bug fixes, and comments that were incorporated into
|
|
|
|
this release. We really appreciate their help, particularly in the
|
|
|
|
task of porting scsh to new platforms.
|
1995-10-13 23:34:21 -04:00
|
|
|
|
1995-10-31 22:00:55 -05:00
|
|
|
We'd like to thank everyone else for their patience; this release seemed like
|
|
|
|
a long time coming.
|
1995-10-13 23:34:21 -04:00
|
|
|
|
1995-10-31 22:00:55 -05:00
|
|
|
Brought to you by the Scheme Underground scsh team. Go forth and write
|
|
|
|
elegant systems programs.
|
1995-10-31 04:18:15 -05:00
|
|
|
-Olin Shivers & Brian Carlstrom
|
1995-10-31 22:00:55 -05:00
|
|
|
Cambridge
|
1997-04-21 16:55:48 -04:00
|
|
|
21 April 1997
|