INTRO(1) INTRO(1)
NAME
intro - introduction to Inferno
DESCRIPTION
Inferno is a virtualised operating system that can run
natively across a wide range of processor architectures or
hosted on a wide range of operating systems. The principal
components of the system are:
• The Inferno kernel which can run both native and
`hosted' on a range of platforms and which presents the
same interface to programs in both cases.
• The Dis virtual machine.
• Styx - the tiny broad-spectrum file service protocol.
• Limbo - a new simple, modular, concurrent programming
language.
• Tk and Prefab - graphical user interface (`GUI')
primitives without a lot of goo.
• The portable cross-development suites that allow any
native Inferno platform to be cross-compiled on any
hosted system.
Manual conventions
Throughout this volume, manual entries are cross referenced
by a notation of the form entry(n), where entry is the name
of the page (in italics) and n is the manual section holding
the page. The same name may be found in more than one sec-
tion. For example, the environment variable inspection com-
mand documented in env(1), is quite distinct from the module
interface to environment variables which is documented in
env(2), which in turn is distinct from the component docu-
mented by env(3), which describes the underlying device that
implements environment variables.
Pathnames are understood to exist in the file system space
visible from Inferno. The root of this space when viewed
from the host operating system is the Inferno installation
directory, sometimes called the Inferno root directory.
Unless otherwise enabled, the result of changes made by
Inferno programs to files in the file system space is gener-
ally restricted to this portion of the host file system.
Name spaces
One of the great strengths of Inferno is the name space
interface to the resources available to a process, a
Page 1 Plan 9 (printed 10/24/25)
INTRO(1) INTRO(1)
hierarchical structure which looks very similar to a conven-
tional file system. Resources look like files and directo-
ries that can be read and written, created and deleted in a
way familiar to most programmers.
While this interface is used to provide programs with access
to conventional disk-based filestore, it is also used to
control devices and user level programs mounted in a
process's name space. Once a program or a device has been
attached to a process's name space, the program or device
interprets any access to the attachment point; it can syn-
thesise on demand the names of new files or directories,
create their contents on the fly as the process reads from
them, and interpret written data as commands or data as
appropriate (See bind(1) and sys-bind(2)).
Each new Inferno process inherits its parent's name space,
but it can divorce its own name space from that of its par-
ent (see sys-pctl(2)), giving programs the capability to
attach resources to their own name space without making them
globally visible. This per-process name space is potent but
potentially confusing, so, to help programs that might be
confused, namespace(4) gives some conventions that should be
adhered to if programs are to work properly. (That page also
gives a general overview of the Inferno source tree.)
Start up
See ``Installation of the Inferno Software'' in Volume 2 for
details of how to start up Inferno.
Window/development environment
Inferno provides a powerful development environment in which
to write, compile, execute and debug programs written in the
Limbo language. It gives the developer a clean platform
from which he can utilise an operating system which contains
many new and innovative ideas and some, carefully chosen,
older concepts that have survived the test of time and are
likely to be familiar to most Plan 9 or Unix users.
Superficially, the Inferno shell sh(1) looks and behaves
much like its Plan 9 or Unix contemporaries but, at heart,
it is quite different. The shell takes advantage of the
dynamic module loading services that Inferno provides to
allow it to be dynamically extended in appropriate and
interesting ways. For example, by loading the sh-tk(1) buil-
tin module, a shell script can provide all the programming
logic required to manage a Tk window with full Tk function-
ality in, surprisingly, few lines of code; by loading the
sh-file2chan(1) builtin module, a shell script can create a
file in the name space whose properties are completely under
the control of the script.
Page 2 Plan 9 (printed 10/24/25)
INTRO(1) INTRO(1)
The Inferno window manager wm(1) allows the user to manage
the order and position of a dynamic collection of applica-
tion windows in which to perform various tasks. Acme(1) is
targeted at programmers. It is an editor, a shell and window
system all rolled into one, which through thoughtful and
consistent application of simple principles results in a
rich and productive programming environment with a user
interface that feels right. Acme requires a three-button
mouse and attaches distinct functions to the three mouse
buttons and, indeed, to chords of buttons to maximise the
productivity of the programmer's mouse. For more details of
the Acme user interface see the paper "Acme: A User Inter-
face for Programmers" in Volume 2.
Limbo programs are compiled with limbo(1). This compiles
Limbo source into a machine-independent format (Dis) for
execution by the Inferno Dis virtual machine. The virtual
machine is designed to provide safe execution of programs
even on machines without memory protection. Debugging is
made straightforward by use of either stack(1) , to display
the execution stack of a process or, if a finer inspection
is required, deb(1), a novel window based debugger that
allows the user to identify the exact location of problems,
set break points and walk the data structures of any module
loaded by the program. See "Program Development in Inferno"
in Volume 2 for details on how to use the development tools
that Inferno provides.
SEE ALSO
Section (1) (this section) for the commonly-used commands.
Section (2) for Limbo modules, including Inferno's system calls.
Section (3) for kernel devices (accessed by `bind').
Section (4) for file services (accessed by `mount').
Section (5) for the Styx file service protocol.
Section (6) for file formats and system conventions.
Section (7) for databases and database access modules.
Section (8) for administrative modules and system services.
Section (9) for the reference for Inferno's Tk variant, Limbo/Tk.
Section (10) for the build environment and device driver implementation.
Volume 2 contains papers and other documentation about Inferno.
The back of this volume contains a permuted index.
DIAGNOSTICS
On successful execution, a process can simply exit. Pro-
grams (modules) that wish to return error status to the com-
mand interpreters sh(1) and mash(1) do so by raising a spe-
cial exception (eg, using the raise statement in Limbo).
The exception's value is a string beginning with the text
`fail:'.
Page 3 Plan 9 (printed 10/24/25)
INTRO(1) INTRO(1)
SEE ALSO
intro(2), intro(3), intro(4), intro(5), intro(6), intro(7),
intro(8), intro(9), intro(10)
Page 4 Plan 9 (printed 10/24/25)