minor nits from sources - tr(1), bio(2) update to 21-bit rune stuff - stat(2), mention a few more bits - utf(6) take sources formatting - bio(2), cons(2) juke(7), formatting nits - booting(8) add rb - fshalt(8) mention booting new kernels Reference: /n/atom/patch/applied2013/man20130801 Date: Thu Aug 1 18:37:02 CES 2013 Signed-off-by: quanstro@quanstro.net --- /sys/man/1/ascii Thu Aug 1 18:33:50 2013 +++ /sys/man/1/ascii Thu Aug 1 18:33:51 2013 @@ -140,7 +140,7 @@ .B "unicode 2200-22f1" Print a table of miscellaneous mathematical symbols. .TP -.B "look 039 /lib/unicode" +.B "look 000039 /lib/unicode" See the start of the Greek alphabet's encoding in the Unicode Standard. .SH FILES .TF \fL/lib/unicode --- /sys/man/1/tr Thu Aug 1 18:33:51 2013 +++ /sys/man/1/tr Thu Aug 1 18:33:52 2013 @@ -62,9 +62,9 @@ value is given by those digits. The character sequence .L \ex -followed by 1, 2, 3, or 4 hexadecimal digits stands +followed by 1 to 6 hexadecimal digits stands for the character whose -16-bit value is given by those digits. +21-bit value is given by those digits. A .L \e followed by any other character stands --- /sys/man/2/bio Thu Aug 1 18:33:53 2013 +++ /sys/man/2/bio Thu Aug 1 18:33:53 2013 @@ -257,7 +257,7 @@ calls .I Bputc to output the low order -16 bits of +21 bits of .I c as a rune in --- /sys/man/2/cputime Thu Aug 1 18:33:54 2013 +++ /sys/man/2/cputime Thu Aug 1 18:33:54 2013 @@ -8,7 +8,7 @@ .PP .ta \w'\fLdouble 'u .B -int times(long t[4]) +long times(long t[4]) .PP .B double cputime(void) --- /sys/man/2/stat Thu Aug 1 18:33:55 2013 +++ /sys/man/2/stat Thu Aug 1 18:33:56 2013 @@ -170,7 +170,10 @@ \fL 0x80000000\fP directory \fL 0x40000000\fP append only \fL 0x20000000\fP exclusive use (locked) - +.\" \fL 0x10000000\fP mounted channel +.\" \fL 0x08000000\fP authentication file +\fL 0x04000000\fP non-backed-up files +.sp 0.3v \fL 0400\fP read permission by owner \fL 0200\fP write permission by owner \fL 0100\fP execute permission (search on directory) by owner @@ -183,9 +186,12 @@ for these bits: .BR DMDIR , .BR DMAPPEND , +.BR DMEXCL , +.\" .BR DMMOUNT , +.\" .BR DMAUTH , and -.B DMEXCL -for the first three; and +.BR DMTMP +for the first four; and .BR DMREAD , .BR DMWRITE , and --- /sys/man/3/cons Thu Aug 1 18:33:57 2013 +++ /sys/man/3/cons Thu Aug 1 18:33:57 2013 @@ -215,6 +215,12 @@ .IR kernelpath . Only the host owner has the ability to open this file. +The named kernel may be a Plan 9 executable or +a 32-bit or 64-bit ELF executable. +On some architectures +(e.g., +.BR mips ), +it may also be a Plan 9 boot image. .PP .B Bintime is a binary interface that provides --- /sys/man/5/stat Thu Aug 1 18:33:58 2013 +++ /sys/man/5/stat Thu Aug 1 18:33:59 2013 @@ -34,6 +34,8 @@ .IR entry , .IR stat , laid out as follows: +.TF \fIqid.path[8] +.PD .TP .I size\f1[2]\fP total byte count of the following data --- /sys/man/6/utf Thu Aug 1 18:34:00 2013 +++ /sys/man/6/utf Thu Aug 1 18:34:00 2013 @@ -7,7 +7,7 @@ .SM UTF-8 encoding (Universal Character Set Transformation Format, 8 bits wide). -The Unicode Standard represents its characters in 20 +The Unicode Standard represents its characters in 21 bits; .SM UTF-8 represents such @@ -19,7 +19,7 @@ .PP In Plan 9, a .I rune -is a 32-bit quantity representing a Unicode character. +is a 21-bit quantity representing a Unicode character. Internally, programs may store characters as runes. However, any external manifestation of textual information, in files or at the interface between programs, uses a @@ -65,20 +65,21 @@ sequence as follows: .PP -001. x in [00000000.00000000.0bbbbbbb] → 0bbbbbbb +01. x in [000000.00000000.0bbbbbbb] → 0bbbbbbb .br -010. x in [00000000.00000bbb.bbbbbbbb] → 110bbbbb, 10bbbbbb +10. x in [000000.00000bbb.bbbbbbbb] → 110bbbbb, 10bbbbbb .br -011. x in [00000000.bbbbbbbb.bbbbbbbb] → 1110bbbb, 10bbbbbb, 10bbbbbb +11. x in [000000.bbbbbbbb.bbbbbbbb] → 1110bbbb, 10bbbbbb, 10bbbbbb .br -100. x in [0000bbbb.bbbbbbbb.bbbbbbbb] → 11110bbb, 10bbbbbb, 10bbbbbb 10bbbbbb +100. x in [bbbbbb.bbbbbbbb.bbbbbbbb] → 1110bbbb, 10bbbbbb, 10bbbbbb, 10bbbbbb .br .PP -Conversion 001 provides a one-byte sequence that spans the +Conversion 01 provides a one-byte sequence that spans the .SM ASCII character set in a compatible way. -Conversions 010, 011 and 100 represent higher-valued characters -as sequences of two to four bytes with the high bit set. +Conversions 10, 11 and 100 represent higher-valued characters +as sequences of two, three or four bytes with the high bit set. +Plan 9 does not support the 5 and 6 byte sequences proposed by X-Open. When there are multiple ways to encode a value, for example rune 0, the shortest encoding is used. .PP --- /sys/man/7/juke Thu Aug 1 18:34:01 2013 +++ /sys/man/7/juke Thu Aug 1 18:34:02 2013 @@ -356,6 +356,7 @@ .TP .B type is the type of the object +.LP .SH FILES .TF /sys/lib/music/map .TP --- /sys/man/8/booting Thu Aug 1 18:34:03 2013 +++ /sys/man/8/booting Thu Aug 1 18:34:03 2013 @@ -24,6 +24,8 @@ other methods of rebooting are mentioned for some machines. .SS PCs To boot a PC, it is necessary to get +.BI /386/ipl "fat, iso, pxe" +or .B /386/9load loaded into memory. There are many ways to do this. A Plan 9 boot floppy prepared by @@ -34,10 +36,13 @@ .B 9load when the PC is reset or powered on. Other methods are described in -.IR 9load (8). -.B 9load +.IR pcipl (8) +or +.IR 9load (8) then locates and loads a Plan 9 kernel, using configuration information -from the file +from the matching file in +.B /cfg/pxe +or the file .B plan9.ini stored in the .B 9fat @@ -137,7 +142,14 @@ it prompts for the Ethernet protocol to use to reach the root file server; request the default. . -.SS ARM CPU Servers +.SS MIPS Routerboard CPU Server +Configure RouterBOOT via the serial port (115200 baud) +to always boot from Ethernet, and arrange to load the ELF executable +.B /mips/9rb +in +.IR ndb (6). +. +.SS ARM Systems All ARM systems are started by .I U-boot using similar commands. @@ -293,6 +305,8 @@ Boot the PC file server like a regular PC, loading the appropriate file system kernel. .. .SH "SEE ALSO" +.IR ndb (6), +.IR pcipl (8), .IR 9load (8), .IR boot (8), .IR fs (8), --- /sys/man/8/fshalt Thu Aug 1 18:34:04 2013 +++ /sys/man/8/fshalt Thu Aug 1 18:34:04 2013 @@ -5,6 +5,8 @@ .B fshalt [ .B -r +] [ +.I new-kernel ] .br .B reboot @@ -25,6 +27,10 @@ .BR -r , .I fshalt will then reboot the machine. +If +.I new-kernel +is given, it will be loaded as the new kernel rather than +the currently-loaded kernel. The halting and rebooting is done by copying all necessary commands into a .IR ramfs (4) @@ -37,6 +43,8 @@ restarts the machine it is invoked on. .SH SOURCE .B /rc/bin/fshalt +.br +.B /rc/bin/reboot .SH SEE ALSO .IR cons (3), .IR reboot (8) --- /sys/man/8/mk9660 Thu Aug 1 18:34:05 2013 +++ /sys/man/8/mk9660 Thu Aug 1 18:34:06 2013 @@ -255,3 +255,5 @@ .IR dossrv (4)), .IR cdfs (4), .IR mkfs (8) +.br +.B http://www.ecma-international.org/publications/files/ECMA-ST/Ecma-119.pdf