The official websites for the 9front project are located at:
• http://9front.org — main website
• http://bugs.9front.org — bug tracker
• http://fqa.9front.org — official documentation, frequently questioned answers
• http://lists.9front.org — mailing lists
• http://man.9front.org — man pages
• http://wiki.9front.org — informal documentation, developer scratchpad
Somewhat outdated, and not entirely applicable to 9front is the Bell Labs Plan 9 wiki: http://www.plan9.bell-labs.com/wiki/plan9/plan_9_wiki
Some users have set up their own sites and pages with 9front specific information. As always, do not blindly enter commands you do not understand into your computer.
That said, much valuable information can be found at http://cat-v.org regarding various aspects of UNIX, Plan 9, and software in general.
The 9front project maintains several mailing lists which users should subscribe to and follow. To subscribe to a mailing list, send an e-mail message to firstname.lastname@example.org, where list is the name of the mailing list. That address is an automated subscription service. In the body of your message, on a single line, you should include the subscribe command. For example:
After subscribing, list messages are received from and sent to email@example.com, where list is the name of the mailing list.
The lists are as follows:
To unsubscribe from a list, you will again send an e-mail message to firstname.lastname@example.org. It should look like this:
Before posting a question on the 9front mailing list, please check the rest of this FQA. If asking a question possibly related to hardware, always include the output of sysinfo(1)!
Mailing list archives are available via 9p:
% 9fs 9front
% ls /n/lists
Each of these directories contains messages sent to the respective mailing list in mdir format, one message per file. Erik Quanstrom’s nupas upas/fs (now merged with 9front upas) can mount these directories as mailboxes, for reading directly with a mail client. Note: Opening large mailboxes over a slow 9p link will be very slow.
9front comes with extensive documentation in the form of manual pages. Considerable effort is made to make sure the man pages are up-to-date and accurate. In all cases, 1.) the source, followed by 2.) the man pages, are considered the authoritative source of information for 9front.
You can find all the 9front man pages on the web at the following sites:
as well as on your 9front computer.
In general, if you know the name of a command or a manual page, you can read it by executing man command. For example: man vi to read about the MIPS binary emulator. If you don’t know the name of the command, or if man command doesn’t find the manual page, you can search the manual page database by executing lookman something, where something is a likely word that might appear in the title of the manual page you’re looking for. For example:
% lookman vesa
man 3 vga # vga(3)
man 8 realemu # realemu(8)
man 8 vga # vga(8)
The resulting list is presented in the form of commands that can be highlighted and sent using rio’s mouse button 2 menu.
For many, having a hardcopy of the man page can be useful. To make a printable copy of a man page:
man -t vga realemu | lp -dstdout > vga.ps
man -t vga realemu | lp -dstdout | ps2pdf > vga.pdf
The command man -w prints the location of the man page’s source file:
% man -w vga realemu
As was mentioned in FQA 0.3.2 - Man pages, Plan 9 man pages are divided into sections based upon the features they describe. For example, the troff source of the io(1) man page is located in section 1, in the file /sys/man/1/io. You can examine this troff source for a simple example of how to format and construct a typical man page.
For additional information, read: How to Write a Plan 9 Manual Page, man(6), troff(1)
"I have with Plan 9 Is there a way to"
Remember: 9front developers cannot read your mind. Very detailed information is required to diagnose most serious bugs.
Also remember: It is possible you simply don’t know what you’re doing. If you do not understand how something is done in 9front or how it works, and can’t figure out how to resolve the problem using the manual pages, FQA 8 - Using 9front, or FQA 9 - Troubleshooting, join #9front on irc.freenode.net or use the mailing list (email@example.com) to request help.
On the other hand, it’s possible you really found a bug. If so, please file a bug report by sending an e-mail to firstname.lastname@example.org. The subject line of your e-mail will be used to open an issue on the bug tracker, and your message will be forwarded to the 9front-bugs mailing list.
A minimum useful bug report contains the following:
The following sub-sections offer some useful tips.
Under some circumstances, you may not be able to recover text directly from a crashed system. In this situation, snap a photo of the screen, including as much of the screen in good focus as possible, and upload the image somewhere where it can be retrieved by developers.
% hget http://www.jwz.org/blog/feed | rssread
panic: D2B called on non-block c580 (double-free?)
rssread 882285: suicide: sys: trap: fault read addr=0x0 pc=0x000038ef
% acid 882285
/proc/882285/text:386 plan 9 executable
To collect even more information than a stacktrace, you can also make a full process snapshot, which includes all the memory of the program. The snapshot file can later be analyzed (even on a different machine [even on a different machine of a different architecture]).
% snap 882285 > rssread.snap