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/6/24) 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/6/24) 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/6/24) 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/6/24)