We are still actively working on the spam issue.

Difference between revisions of "Plan 9"

From InstallGentoo Wiki
Jump to: navigation, search
m
(i cant be arsed anymore, i just wanted to purge the DOGSHIT)
(12 intermediate revisions by 5 users not shown)
Line 2: Line 2:
 
[[File:plan9.jpg|thumb|Glenda, the Plan 9 Mascot]]
 
[[File:plan9.jpg|thumb|Glenda, the Plan 9 Mascot]]
  
'''Plan 9 from Bell Labs''' is a research OS family, created at Bell Labs by many of the same people who created UNIX, like Ken Thompson, Dennis Ritchie and Rob Pike. It's distinguishing features include the use of files with the 9P protocol for most, if not all resources in the operating system (including graphics), and private namespaces, where each process can have a different view of the file system. Interest in Plan 9 stems out of curiosity, admiration and sometimes idealism.
+
'''Plan 9 from Bell Labs''' is a research OS family, created at Bell Labs by many of the same people who created Unix, like Ken Thompson, Dennis Ritchie and Rob Pike. Its distinguishing features include the use of files with the 9P protocol for most, if not all resources in the operating system (including graphics), and private namespaces, where each process can have a different view of the file system. Interest in Plan 9 stems out of curiosity, admiration and idealism.
 +
 
 +
== History and philosophy ==
 +
 
 +
Plan 9 is fundamentally an operating system created to address the practical use of the [[Unix]] system since it left Bell Labs, especially in the commercial setting. The world had changed since the days of Research Unix, and graphics and networking had become monumentally important in the computer space. Organisations outside Bell Labs shaped the development of Unix, with the adoption of sockets from BSD and the X Window System from MIT that bent and twisted the "Unix philosophy".
 +
 
 +
The developers of Plan 9, then, set out to develop a new operating system for research, exploring areas such as distributed computing, naturally graphics and networking, and heterogenous access to system resources. While Plan 9 is not Unix, it is to an extent Unix-like, and feels rather like the later versions of Research Unix after the flight of Unix outside of Bell Labs (and even has some of the features of those later Research Unix releases).
  
 
== Licensing ==
 
== Licensing ==
  
The First and Second Editions of Plan 9 were only available to universities and then for an exorbitant fee.
+
The first and second editions of Plan 9 were only available to universities, for an exorbitant fee in book and CD form. The third edition of Plan 9 was released under the Plan 9 Licence in 2000, which Richard Stallman considered [http://www.linuxtoday.com/developer/2000070200704OPLFSW non-free]. The fourth edition was released under the Lucent Public Licence in 2002 which the FSF does consider free but not GPL-compatible, along with the distribution becoming openly developed and updated daily. In 2014, Plan 9 was relicenced under GPLv2 for the University of California, Berkeley's Akaros operating system (to much distaste).
The Third Edition of Plan 9 was released under the Plan 9 Licence in 2000, which Richard Stallman considered [http://www.linuxtoday.com/developer/2000070200704OPLFSW non-free]. The Fourth Edition was released under the Lucent Public Licence in 2002 which the FSF does consider free but not GPL-compatible, along with the distribution becoming openly developed and updated daily. In 2014 Plan 9 was relicenced under GPLv2 for UCB's Akaros operating system (to much dislike).
+
 
 +
This author interprets the licence situation of Plan 9 to be dual licensing under both the Lucent Public License 1.02 and the GNU General Public License 2. You may be able to guess which license the community prefers.
 +
 
 +
There is a perception in the Plan 9 pommunity that it was due to the prohibitive cost and later licence confusion that Plan 9 made much ground commercially.
  
 
== Distributions ==
 
== Distributions ==
  
*[http://plan9.bell-labs.com/plan9/ Plan 9 from Bell Labs], the Fourth Edition, where development is almost dead, but the website is definitely dead.
+
*[http://plan9.bell-labs.com/plan9/ Plan 9 from Bell Labs], the fourth edition of Plan 9. Dead.
 +
 
 +
*[http://www.9legacy.org/ 9legacy], a distribution of several patches on top of the Bell Labs distribution.
 +
 
 +
*[http://www.9atom.org/ 9atom] is Erik Quanstrom's personal fork of Plan 9. It augments the Plan 9 distribution with the addition of a 386 PAE kernel, an amd64 CPU and terminal kernel, nupas, extra PC hardware support, IL and Ken's fs, most of which have been incorporated into or available for 9front.  
  
*[http://www.9legacy.org/ 9legacy], which is several patches on top of the Bell Labs distribution.
+
*[http://www.vitanuova.com/inferno/ Inferno] is a distributed operating system started at Bell Labs, but is now <s>developed and maintained</s> by Vita Nuova Holdings as free software.
  
*[http://www.9atom.org/ 9atom] is Erik Quanstrom's personal fork of Plan 9. It augments the Plan 9 distribution with the addition of a 386 PAE kernel, an amd64 cpu and terminal kernel, nupas, extra PC hardware support, IL and Ken's fs.  
+
*[[9front]] is an active, community-led fork of Plan 9 from the People's Front of Cat -V, after the front fell off.
  
*[http://www.vitanuova.com/inferno/ Inferno] is a distributed operating system started at Bell Labs, but is now developed and maintained by Vita Nuova Holdings as free software.
+
*[https://swtch.com/plan9port/ plan9port] is not an operating system, but a port of many Plan 9 applications, utilities and libraries to Unix-like operating systems such as GNU/Linux and BSD.
  
*[http://9front.org/ 9front] is an active, community-led fork of Plan 9, the life and breath of Plan 9 development, including new advancements such as better hardware support, audio, wireless networking and new programs like NES, SNES, Game Boy, GBA and Genesis emulators and a paint program. If you want to run Plan 9, this is probably the way to go.
+
9front is at the forefront of Plan 9 Ontologically-Oriented Technology, including new advancements such as better hardware support, audio, wireless networking and new programs like NES, SNES, Game Boy, GBA and Genesis emulators and a paint program. If you want to run Plan 9, this is probably the way to go. Most of this article assumes you are using 9front.
  
 
== Concepts ==
 
== Concepts ==
 +
 +
=== Graphics ===
 +
 +
Graphics is considered ubiquitous in Plan 9, and while Plan 9 features the ancient and revered Unix toolkit (awk, grep, cat), it is therefore not plausible to use without graphics.
 +
 +
Plan 9's graphical shell is called Rio. (How to use Rio follows shortly.) The way Plan 9 abstracts graphics hardware is through offering drawing surfaces as character files. Applications write to this file with drawing commands usually using libdraw. Rio uses the top-level surface to draw to the whole screen, and each new Rio window creates a new drawing surface, and using private namespaces, provides that surface to applications in the same way. You can test this by running a graphical program when Rio is not active, which draws to the entire screen, and by running Rio inside a Rio window.
 +
 +
=== Mouse chording ===
 +
 +
Mouse chording is common to Rio and Acme, the development environment.
  
 
=== The distributed Plan 9 environment ===
 
=== The distributed Plan 9 environment ===
Line 27: Line 50:
 
Plan 9 networks generally consist of three classes of machine:
 
Plan 9 networks generally consist of three classes of machine:
  
* CPU servers - These machines export the CPU resource and accept cpu(1) and drawterm connections.
+
* CPU servers - These machines export the CPU resource and accept remote connections from terminals.
 
* File servers - Machines with disks. A standalone 9front or Plan 9 installation is most likely one of these.
 
* File servers - Machines with disks. A standalone 9front or Plan 9 installation is most likely one of these.
* Auth servers (?) - Authentication with keyfs, factotum, blah blah.
 
 
* Terminals - Not necessarily running Plan 9, these machines connect to the CPU server.
 
* Terminals - Not necessarily running Plan 9, these machines connect to the CPU server.
 +
 +
''Note: 9front adds a fourth class, the auth server. This is where security keys and user account information (not files) are stored.''
 +
 +
The concept of network transparency was one of the most important factors in the design of Plan 9. You should be able to feel as if your terminal and the CPU server you have just logged into are the same machine and are accessing the exact same resources, instead of being completely abstract environments as happens in Unix-like operating systems with SSH. Usually however most single Plan 9 installations are a combination of file server and terminal.
 +
 +
If you wanted to use Plan 9 as a server (bearing in mind that performance will be a lot worse than Linux or BSD) the closest analogue would be a file server or CPU server backed by a file server.
  
 
=== Everything is a file ===
 
=== Everything is a file ===
  
The grand abstraction of Plan 9. Absolutely everything is a file. These files use the 9P protocol, which can also be used over the network as 9P shares. Even Rio programs write to files to do graphics. Network interfaces are also files (/net). Folders are probably files as well (which is why cat loves to output folders as if nothing is wrong).
+
The grand abstraction of Plan 9 is that everything is shown as a file. Files are written to using the 9P protocol that is network-transparent, meaning also that all file I/O is network-transparent. 9P is also the protocol for remote connections.
  
 
== Programs ==
 
== Programs ==
Line 41: Line 69:
  
 
=== Web browser ===
 
=== Web browser ===
Two really feasible options for web browsing exist on Plan 9:
+
Two feasible options for web browsing exist on Plan 9:
* mothra(1) - a very fast and simple web browser (or rather, a web document reader). Under the hood it uses the webfs interface. It supports only HTML and images.
+
* mothra - a very fast and simple web browser (or rather, a web document reader). Under the hood it uses the webfs interface. It supports only HTML and images. Included in 9front and available as a contrib package for other distributions.
* abaco(1) - a web browser that looks like acme. It does a bit of CSS, but still no JavaScript.
+
* abaco - no. People will make fun of you for using this. abaco is a web browser designed to run in the modual acme editor, with support for Javascript and css
  
 
=== Text editor ===
 
=== Text editor ===
* [http://sam.cat-v.org sam(1)] - a minimal text editor that makes use of Standard Regular Expressions.
+
* [http://sam.cat-v.org sam] - a minimal text editor that makes use of Standard Regular Expressions and an ed-like command syntax.
* [http://acme.cat-v.org acme(1)] - Emacs done right, a programming environment that makes heavy use of the mouse and that can be used as a mail client with upas.
+
* [http://acme.cat-v.org acme] - Emacs done right, a programming environment that makes heavy use of the mouse and that can be used as a mail client with upas.
* ed(1) - a venerable text editor.
+
* ed - a venerable text editor.
 +
Both sam and acme are available in plan9port. A port of Vim to Plan 9 and Rio may be found in the <tt>contrib</tt> tree.
 +
 
 +
=== E-mail ===
 +
* upas - the network mail file system.
 +
* nupas - the network mail file system. Instead of loading your entire mailbox into memory, nupas loads it into an index file on disk and does the operations on that file.
 +
Use nedmail or acme mail to read your e-mails from upas.
  
 
=== The rc shell ===
 
=== The rc shell ===
  
Plan 9's default shell is the ''rc'' shell, designed by Tom Duff. It's constructs are similar to UNIX's Bourne shell but are [http://doc.cat-v.org/plan_9/4th_edition/papers/rc somewhat] syntactically different.
+
Plan 9's default shell is the ''<tt>rc</tt>'' shell, designed by Tom Duff. It's constructs are similar to Unix's Bourne shell but are [http://doc.cat-v.org/plan_9/4th_edition/papers/rc somewhat] syntactically different.
The most important thing to get around in your head is how programs in subdirectories of /bin (where many different directories are actually bound) are executed. Acme will most likely be placed in /bin, so a simple
+
The most important thing to get around in your head is how programs in subdirectories of <tt>/bin</tt> (where many different directories are bound, making the use of a <tt>$PATH</tt> variable redundant) are executed. The programming environment Acme is placed directly in <tt>/bin</tt>, so a simple
 
  % acme
 
  % acme
 
will do. Now, this is a rather contrived example, but let's assume we have a new disk and we want to run fdisk(8) on it.
 
will do. Now, this is a rather contrived example, but let's assume we have a new disk and we want to run fdisk(8) on it.
 
  % fdisk
 
  % fdisk
won't work, because fdisk is actually in /bin/'''disk'''/fdisk (it's probably really in /386/bin/disk/fdisk). So you would need to run  
+
won't work, because fdisk is actually in <tt>/bin/'''disk'''/fdisk</tt> (it's probably really in <tt>/386/bin/disk/fdisk</tt>). So you would need to run  
 
  % disk/fdisk
 
  % disk/fdisk
A better example is if you cannot wrap your head around rc, and you really want your curmudgeonlike UNIX shell, you would run
+
A better example is if you cannot wrap your head around ''<tt>rc</tt>'', and you really want your curmudgeonly Unix-like shell, you should run
 
  % ape/sh
 
  % ape/sh
because sh is in the ape (ANSI POSIX Environment) folder.
+
because <tt>sh</tt> is in the ape (ANSI POSIX Environment) folder.
  
 
== rio ==
 
== rio ==
  
Rio is the Plan 9 windowing system. New users are often confused by Rio's spartan design, grey default background and sometimes the lack of window titles (although if they have used something like cwm or dwm before, they should be fine). Here is a quick list of things you should know so that you can survive in Rio.
+
Rio is the Plan 9 windowing system. New users are often confused by Rio's spartan design, grey default background and sometimes the lack of window titles (although if they have used something like cwm or dwm before, they should be fine). Here is a quick list of things you should know so that you can survive in Rio:
 +
 
 
* The mouse buttons are referred to in manual pages as 1, 2 and 3, 1 being left, 2 being middle and 3 being right. A 3 button mouse is '''strongly''' desired for using Plan 9, although if you have a laptop touchpad or a shitty Apple mouse, then you can substitute with the use of Shift + MB1.
 
* The mouse buttons are referred to in manual pages as 1, 2 and 3, 1 being left, 2 being middle and 3 being right. A 3 button mouse is '''strongly''' desired for using Plan 9, although if you have a laptop touchpad or a shitty Apple mouse, then you can substitute with the use of Shift + MB1.
 
* Right click the desktop to bring up Rio's menu. New creates a new terminal window and Del deletes windows. The right mouse button should be used again when clicking (or more specifically, the same mouse button used to bring up the menu.
 
* Right click the desktop to bring up Rio's menu. New creates a new terminal window and Del deletes windows. The right mouse button should be used again when clicking (or more specifically, the same mouse button used to bring up the menu.
Line 74: Line 109:
 
* Rio terminal windows don't scroll with the output by default and therefore block execution of the program. If you are compiling or in an IRC client, this will probably be a bad thing, so use the MB2 menu to select scroll. As well, you can edit your profile and pass Rio the -s option, so all new windows are in scroll mode.
 
* Rio terminal windows don't scroll with the output by default and therefore block execution of the program. If you are compiling or in an IRC client, this will probably be a bad thing, so use the MB2 menu to select scroll. As well, you can edit your profile and pass Rio the -s option, so all new windows are in scroll mode.
  
== Shutting down ==
+
Rio has been imitated by an X11 window manager of the same name, which is included in plan9port.
 +
 
 +
== How to ==
 +
=== Shut down ===
 +
Shut down the file server, which in practice should be the machine Plan 9 is running on, using the <tt>fshalt(8)</tt> command.
 +
After you have issued <tt>fshalt</tt>, turn off your computer's power some other way (hit the switch or hold down the power button), unless you have ACPI enabled as shown below, in which case the machine should shut down. Restarting does work on presumably all machines.
 +
% fshalt -r
 +
 
 +
=== Edit boot configuration ===
 +
On x86-like processors, the Plan 9 bootloader reads instructions on how to boot up from the 9fat partition at the start of the disk. In the 9fat partition is a file called <tt>plan9.ini</tt> which contains these instructions. An example <tt>plan9.ini</tt> could look like this:
 +
bootfile=/386/9pcf
 +
bootargs=/dev/sdE0/fscache -C
 +
monitor=vesa
 +
vgasize=1024x768x32
 +
mouseport=ps2
 +
These should be mostly self-descriptive. For more information, see <tt>plan9.ini(8)</tt>
 +
 
 +
To mount 9fat and edit <tt>plan9.ini</tt>, mount it using the <tt>9fs</tt> utility.
 +
% 9fs 9fat
 +
The 9fat partition will be mounted under <tt>/n/9fat/</tt> in the namespace of the shell you ran <tt>9fs</tt> in. Simply edit <tt>/n/9fat/plan9.ini
 +
</tt> with your preferred editor. Remember that it must end with a blank new line.
 +
 
 +
=== ACPI ===
 +
ACPI is supported only by 9front and is not enabled by default. To enable it, add <tt>*acpi=1</tt> to <tt>plan9.ini</tt> as shown above, and reboot. When <tt>fshalt</tt> is run, <tt>scram(8)</tt> should also be invoked and shut the machine down cleanly.
  
Simply running Plan 9 or 9front on your laptop means your system is a file server, which is where the shutdown command fshalt(8) derives it's name:
 
fshalt
 
After you have issued fshalt, turn off your computer's power some other way (hit the switch, hold down the power button). ACPI is only supported on 9front and is not enabled by default, probably because it sucks '''hard'''. Restarting works fine though:
 
fshalt -r
 
If you can get ACPI to work, scram s
 
 
== Further reading ==
 
== Further reading ==
*[https://en.wikipedia.org/wiki/Plan_9_from_Bell_Labs Plan 9's Wikipedia page] - The history of Plan 9 and a lot of the concepts used.
+
*[[Wikipedia:Plan_9_from_Bell_Labs]] - The history of Plan 9 and a lot of the concepts used.
 
*[http://fqa.9front.org/ 9front's Frequently Questioned Answers] - A document that somewhat copies the structure of the OpenBSD FAQ that explains how to do quite a lot of things with 9front and Plan 9. A lot of this page is <del>plagiarised</del> inspired by this document.
 
*[http://fqa.9front.org/ 9front's Frequently Questioned Answers] - A document that somewhat copies the structure of the OpenBSD FAQ that explains how to do quite a lot of things with 9front and Plan 9. A lot of this page is <del>plagiarised</del> inspired by this document.
 
*[http://cat-v.org cat-v.org] - A museum dedicated to technology, philosophy and politics, formerly curated by [[Uriel]].
 
*[http://cat-v.org cat-v.org] - A museum dedicated to technology, philosophy and politics, formerly curated by [[Uriel]].
 
*[http://http://9p.io/plan9/ Plan 9 from Bell Labs] - A mirror of the Plan 9 from Bell Labs site.
 
*[http://http://9p.io/plan9/ Plan 9 from Bell Labs] - A mirror of the Plan 9 from Bell Labs site.
 +
*[https://0x0.st/ehp.pdf ''Introduction to Operating System Abstractions using Plan 9 from Bell Labs'' by Fransisco J. Ballesteros'']
 
*Papers - /sys/doc. Read them with page(1).
 
*Papers - /sys/doc. Read them with page(1).
 +
 +
== External links ==
 +
 +
[https://www.youtube.com/watch?v=SoGLU1l7LwY A Narrated Short Demonstration of the Plan 9 system]
  
 
[[Category:Software]]
 
[[Category:Software]]
 
[[Category:Operating systems]]
 
[[Category:Operating systems]]

Revision as of 22:05, 19 May 2017

Glenda, the Plan 9 Mascot

Plan 9 from Bell Labs is a research OS family, created at Bell Labs by many of the same people who created Unix, like Ken Thompson, Dennis Ritchie and Rob Pike. Its distinguishing features include the use of files with the 9P protocol for most, if not all resources in the operating system (including graphics), and private namespaces, where each process can have a different view of the file system. Interest in Plan 9 stems out of curiosity, admiration and idealism.

History and philosophy

Plan 9 is fundamentally an operating system created to address the practical use of the Unix system since it left Bell Labs, especially in the commercial setting. The world had changed since the days of Research Unix, and graphics and networking had become monumentally important in the computer space. Organisations outside Bell Labs shaped the development of Unix, with the adoption of sockets from BSD and the X Window System from MIT that bent and twisted the "Unix philosophy".

The developers of Plan 9, then, set out to develop a new operating system for research, exploring areas such as distributed computing, naturally graphics and networking, and heterogenous access to system resources. While Plan 9 is not Unix, it is to an extent Unix-like, and feels rather like the later versions of Research Unix after the flight of Unix outside of Bell Labs (and even has some of the features of those later Research Unix releases).

Licensing

The first and second editions of Plan 9 were only available to universities, for an exorbitant fee in book and CD form. The third edition of Plan 9 was released under the Plan 9 Licence in 2000, which Richard Stallman considered non-free. The fourth edition was released under the Lucent Public Licence in 2002 which the FSF does consider free but not GPL-compatible, along with the distribution becoming openly developed and updated daily. In 2014, Plan 9 was relicenced under GPLv2 for the University of California, Berkeley's Akaros operating system (to much distaste).

This author interprets the licence situation of Plan 9 to be dual licensing under both the Lucent Public License 1.02 and the GNU General Public License 2. You may be able to guess which license the community prefers.

There is a perception in the Plan 9 pommunity that it was due to the prohibitive cost and later licence confusion that Plan 9 made much ground commercially.

Distributions

  • 9legacy, a distribution of several patches on top of the Bell Labs distribution.
  • 9atom is Erik Quanstrom's personal fork of Plan 9. It augments the Plan 9 distribution with the addition of a 386 PAE kernel, an amd64 CPU and terminal kernel, nupas, extra PC hardware support, IL and Ken's fs, most of which have been incorporated into or available for 9front.
  • Inferno is a distributed operating system started at Bell Labs, but is now developed and maintained by Vita Nuova Holdings as free software.
  • 9front is an active, community-led fork of Plan 9 from the People's Front of Cat -V, after the front fell off.
  • plan9port is not an operating system, but a port of many Plan 9 applications, utilities and libraries to Unix-like operating systems such as GNU/Linux and BSD.

9front is at the forefront of Plan 9 Ontologically-Oriented Technology, including new advancements such as better hardware support, audio, wireless networking and new programs like NES, SNES, Game Boy, GBA and Genesis emulators and a paint program. If you want to run Plan 9, this is probably the way to go. Most of this article assumes you are using 9front.

Concepts

Graphics

Graphics is considered ubiquitous in Plan 9, and while Plan 9 features the ancient and revered Unix toolkit (awk, grep, cat), it is therefore not plausible to use without graphics.

Plan 9's graphical shell is called Rio. (How to use Rio follows shortly.) The way Plan 9 abstracts graphics hardware is through offering drawing surfaces as character files. Applications write to this file with drawing commands usually using libdraw. Rio uses the top-level surface to draw to the whole screen, and each new Rio window creates a new drawing surface, and using private namespaces, provides that surface to applications in the same way. You can test this by running a graphical program when Rio is not active, which draws to the entire screen, and by running Rio inside a Rio window.

Mouse chording

Mouse chording is common to Rio and Acme, the development environment.

The distributed Plan 9 environment

Plan 9 networks generally consist of three classes of machine:

  • CPU servers - These machines export the CPU resource and accept remote connections from terminals.
  • File servers - Machines with disks. A standalone 9front or Plan 9 installation is most likely one of these.
  • Terminals - Not necessarily running Plan 9, these machines connect to the CPU server.

Note: 9front adds a fourth class, the auth server. This is where security keys and user account information (not files) are stored.

The concept of network transparency was one of the most important factors in the design of Plan 9. You should be able to feel as if your terminal and the CPU server you have just logged into are the same machine and are accessing the exact same resources, instead of being completely abstract environments as happens in Unix-like operating systems with SSH. Usually however most single Plan 9 installations are a combination of file server and terminal.

If you wanted to use Plan 9 as a server (bearing in mind that performance will be a lot worse than Linux or BSD) the closest analogue would be a file server or CPU server backed by a file server.

Everything is a file

The grand abstraction of Plan 9 is that everything is shown as a file. Files are written to using the 9P protocol that is network-transparent, meaning also that all file I/O is network-transparent. 9P is also the protocol for remote connections.

Programs

It should be noted there are few choices of software for Plan 9, maybe owing to lack of users but also to how good the software actually is.

Web browser

Two feasible options for web browsing exist on Plan 9:

  • mothra - a very fast and simple web browser (or rather, a web document reader). Under the hood it uses the webfs interface. It supports only HTML and images. Included in 9front and available as a contrib package for other distributions.
  • abaco - no. People will make fun of you for using this. abaco is a web browser designed to run in the modual acme editor, with support for Javascript and css

Text editor

  • sam - a minimal text editor that makes use of Standard Regular Expressions and an ed-like command syntax.
  • acme - Emacs done right, a programming environment that makes heavy use of the mouse and that can be used as a mail client with upas.
  • ed - a venerable text editor.

Both sam and acme are available in plan9port. A port of Vim to Plan 9 and Rio may be found in the contrib tree.

E-mail

  • upas - the network mail file system.
  • nupas - the network mail file system. Instead of loading your entire mailbox into memory, nupas loads it into an index file on disk and does the operations on that file.

Use nedmail or acme mail to read your e-mails from upas.

The rc shell

Plan 9's default shell is the rc shell, designed by Tom Duff. It's constructs are similar to Unix's Bourne shell but are somewhat syntactically different. The most important thing to get around in your head is how programs in subdirectories of /bin (where many different directories are bound, making the use of a $PATH variable redundant) are executed. The programming environment Acme is placed directly in /bin, so a simple

% acme

will do. Now, this is a rather contrived example, but let's assume we have a new disk and we want to run fdisk(8) on it.

% fdisk

won't work, because fdisk is actually in /bin/disk/fdisk (it's probably really in /386/bin/disk/fdisk). So you would need to run

% disk/fdisk

A better example is if you cannot wrap your head around rc, and you really want your curmudgeonly Unix-like shell, you should run

% ape/sh

because sh is in the ape (ANSI POSIX Environment) folder.

rio

Rio is the Plan 9 windowing system. New users are often confused by Rio's spartan design, grey default background and sometimes the lack of window titles (although if they have used something like cwm or dwm before, they should be fine). Here is a quick list of things you should know so that you can survive in Rio:

  • The mouse buttons are referred to in manual pages as 1, 2 and 3, 1 being left, 2 being middle and 3 being right. A 3 button mouse is strongly desired for using Plan 9, although if you have a laptop touchpad or a shitty Apple mouse, then you can substitute with the use of Shift + MB1.
  • Right click the desktop to bring up Rio's menu. New creates a new terminal window and Del deletes windows. The right mouse button should be used again when clicking (or more specifically, the same mouse button used to bring up the menu.
  • When you start a graphical program in a Rio window, it replaces the terminal window, unlike X11 and UNIX where a new window is spawned.
  • To resize windows, use MB1 and drag on the window borders.
  • To move windows, use MB3 and drag on the window borders.
  • Many programs, like the Rio terminal windows, have another menu shown by using MB2.
  • Rio terminal windows don't scroll with the output by default and therefore block execution of the program. If you are compiling or in an IRC client, this will probably be a bad thing, so use the MB2 menu to select scroll. As well, you can edit your profile and pass Rio the -s option, so all new windows are in scroll mode.

Rio has been imitated by an X11 window manager of the same name, which is included in plan9port.

How to

Shut down

Shut down the file server, which in practice should be the machine Plan 9 is running on, using the fshalt(8) command. After you have issued fshalt, turn off your computer's power some other way (hit the switch or hold down the power button), unless you have ACPI enabled as shown below, in which case the machine should shut down. Restarting does work on presumably all machines.

% fshalt -r

Edit boot configuration

On x86-like processors, the Plan 9 bootloader reads instructions on how to boot up from the 9fat partition at the start of the disk. In the 9fat partition is a file called plan9.ini which contains these instructions. An example plan9.ini could look like this:

bootfile=/386/9pcf
bootargs=/dev/sdE0/fscache -C
monitor=vesa
vgasize=1024x768x32
mouseport=ps2

These should be mostly self-descriptive. For more information, see plan9.ini(8)

To mount 9fat and edit plan9.ini, mount it using the 9fs utility.

% 9fs 9fat

The 9fat partition will be mounted under /n/9fat/ in the namespace of the shell you ran 9fs in. Simply edit /n/9fat/plan9.ini with your preferred editor. Remember that it must end with a blank new line.

ACPI

ACPI is supported only by 9front and is not enabled by default. To enable it, add *acpi=1 to plan9.ini as shown above, and reboot. When fshalt is run, scram(8) should also be invoked and shut the machine down cleanly.

Further reading

External links

A Narrated Short Demonstration of the Plan 9 system