Browse Source

Plan 9 from Bell Labs 2008-03-31

David du Colombier 13 years ago
parent
commit
fcccad1c42
7 changed files with 190 additions and 27 deletions
  1. 4 3
      dist/replica/_plan9.db
  2. 4 3
      dist/replica/plan9.db
  3. 4 0
      dist/replica/plan9.log
  4. 2 2
      sys/man/1/doc2txt
  5. 18 18
      sys/man/2/control
  6. 157 0
      sys/man/3/sdahci
  7. 1 1
      sys/man/4/u9fs

+ 4 - 3
dist/replica/_plan9.db

@@ -7397,7 +7397,7 @@ sys/man/1/dd - 664 sys sys 1196638931 3346
 sys/man/1/delkey - 664 sys sys 1196638931 779
 sys/man/1/deroff - 664 sys sys 1196638931 1826
 sys/man/1/diff - 664 sys sys 1196638935 3089
-sys/man/1/doc2txt - 664 sys sys 1205815382 2628
+sys/man/1/doc2txt - 664 sys sys 1206913741 2624
 sys/man/1/doctype - 664 sys sys 1196638931 860
 sys/man/1/du - 664 sys sys 1196638931 2281
 sys/man/1/echo - 664 sys sys 1196638932 430
@@ -7553,7 +7553,7 @@ sys/man/2/chdir - 664 sys sys 1196638937 552
 sys/man/2/cleanname - 664 sys sys 1196638940 709
 sys/man/2/color - 664 sys sys 1196638940 1335
 sys/man/2/complete - 664 sys sys 1196638940 2396
-sys/man/2/control - 664 sys sys 1205791980 43639
+sys/man/2/control - 664 sys sys 1206913705 43603
 sys/man/2/cputime - 664 sys sys 1196638937 713
 sys/man/2/ctime - 664 sys sys 1196638937 2547
 sys/man/2/ctype - 664 sys sys 1196638937 2610
@@ -7712,6 +7712,7 @@ sys/man/3/proc - 664 sys sys 1196638942 12062
 sys/man/3/root - 664 sys sys 1196638942 632
 sys/man/3/rtc - 664 sys sys 1196638942 667
 sys/man/3/sd - 664 sys sys 1196638942 5659
+sys/man/3/sdahci - 664 sys sys 1206923648 3212
 sys/man/3/sdaoe - 664 sys sys 1196638942 1320
 sys/man/3/segment - 664 sys sys 1196638942 2378
 sys/man/3/srv - 664 sys sys 1196638942 1470
@@ -7759,7 +7760,7 @@ sys/man/4/snap - 664 sys sys 1196638944 1908
 sys/man/4/srv - 664 sys sys 1196638944 4970
 sys/man/4/tapefs - 664 sys sys 1196638944 1861
 sys/man/4/telco - 664 sys sys 1196638944 4359
-sys/man/4/u9fs - 664 sys sys 1205964618 5225
+sys/man/4/u9fs - 664 sys sys 1206913743 5223
 sys/man/4/upasfs - 664 sys sys 1196638944 6212
 sys/man/4/usb - 664 sys sys 1206739773 5725
 sys/man/4/usbd - 664 sys sys 1202846392 1035

+ 4 - 3
dist/replica/plan9.db

@@ -7397,7 +7397,7 @@ sys/man/1/dd - 664 sys sys 1196638931 3346
 sys/man/1/delkey - 664 sys sys 1196638931 779
 sys/man/1/deroff - 664 sys sys 1196638931 1826
 sys/man/1/diff - 664 sys sys 1196638935 3089
-sys/man/1/doc2txt - 664 sys sys 1205815382 2628
+sys/man/1/doc2txt - 664 sys sys 1206913741 2624
 sys/man/1/doctype - 664 sys sys 1196638931 860
 sys/man/1/du - 664 sys sys 1196638931 2281
 sys/man/1/echo - 664 sys sys 1196638932 430
@@ -7553,7 +7553,7 @@ sys/man/2/chdir - 664 sys sys 1196638937 552
 sys/man/2/cleanname - 664 sys sys 1196638940 709
 sys/man/2/color - 664 sys sys 1196638940 1335
 sys/man/2/complete - 664 sys sys 1196638940 2396
-sys/man/2/control - 664 sys sys 1205791980 43639
+sys/man/2/control - 664 sys sys 1206913705 43603
 sys/man/2/cputime - 664 sys sys 1196638937 713
 sys/man/2/ctime - 664 sys sys 1196638937 2547
 sys/man/2/ctype - 664 sys sys 1196638937 2610
@@ -7712,6 +7712,7 @@ sys/man/3/proc - 664 sys sys 1196638942 12062
 sys/man/3/root - 664 sys sys 1196638942 632
 sys/man/3/rtc - 664 sys sys 1196638942 667
 sys/man/3/sd - 664 sys sys 1196638942 5659
+sys/man/3/sdahci - 664 sys sys 1206923648 3212
 sys/man/3/sdaoe - 664 sys sys 1196638942 1320
 sys/man/3/segment - 664 sys sys 1196638942 2378
 sys/man/3/srv - 664 sys sys 1196638942 1470
@@ -7759,7 +7760,7 @@ sys/man/4/snap - 664 sys sys 1196638944 1908
 sys/man/4/srv - 664 sys sys 1196638944 4970
 sys/man/4/tapefs - 664 sys sys 1196638944 1861
 sys/man/4/telco - 664 sys sys 1196638944 4359
-sys/man/4/u9fs - 664 sys sys 1205964618 5225
+sys/man/4/u9fs - 664 sys sys 1206913743 5223
 sys/man/4/upasfs - 664 sys sys 1196638944 6212
 sys/man/4/usb - 664 sys sys 1206739773 5725
 sys/man/4/usbd - 664 sys sys 1202846392 1035

+ 4 - 0
dist/replica/plan9.log

@@ -18917,3 +18917,7 @@
 1206739804 4 c sys/src/cmd/usb/audio/usbaudioctl.c - 664 sys sys 1206739741 18993
 1206741603 0 c sys/src/9/pc/devusb.c - 664 sys sys 1206740166 21073
 1206761403 0 c 386/bin/usb/usbaudio - 775 sys sys 1206760689 189891
+1206914405 0 c sys/man/1/doc2txt - 664 sys sys 1206913741 2624
+1206914405 1 c sys/man/2/control - 664 sys sys 1206913705 43603
+1206914405 2 c sys/man/4/u9fs - 664 sys sys 1206913743 5223
+1206925204 0 a sys/man/3/sdahci - 664 sys sys 1206923648 3212

+ 2 - 2
sys/man/1/doc2txt

@@ -82,7 +82,7 @@ may then be used to parse the files inside, extracting
 a text stream.
 .I Msexceltables
 may be given options to control the formatting of its output.
-.TF "\f(CW-d \fIdelim"
+.TF "\fL-d \fIdelim"
 .TP
 .B -a
 Attempt conversion of non-tabular sheets in the workbook (charts).
@@ -119,7 +119,7 @@ unmount /mnt/doc
 .EE
 .PD
 .SH SOURCE
-.TF "\f(CW/sys/src/cmd/aux   "
+.TF "\fL/sys/src/cmd/aux   "
 .TP
 .B /rc/bin
 .BR doc2txt ,

+ 18 - 18
sys/man/2/control

@@ -593,7 +593,7 @@ by mouse or keyboard action; messages to the
 file do not cause events to be generated.
 .PP
 All controls accept the following messages:
-.TF \f(CWreveal
+.TF \fLreveal
 .TP
 .BI rect " minx miny maxx maxy
 Set the bounding rectangle for the control on the display.
@@ -666,7 +666,7 @@ Many messages are common between multiple
 .BR Control s.
 Such messages are described in detail here to avoid repetition.
 In the individual descriptions, only the syntax is presented.
-.TF "\f(CWformat fmt"
+.TF "\fLformat fmt"
 .TP
 .BI align " n
 Specify the alignment of (some part of) the
@@ -829,7 +829,7 @@ is 0 if the box has lost focus, 1 if it has acquired it.
 The box displays within its rectangle
 an image, under mask, with specified alignment.
 The control messages it accepts are:
-.TF "\f(CWalign a"
+.TF "\fLalign a"
 .TP
 .BI align " a
 Controls the placement of the image in the rectangle (unimplemented).
@@ -865,7 +865,7 @@ allows all
 .BR Control s
 to be displayed.  This aggregator works well for collections
 of buttons, labels, or textbuttons that all have a fixed height.
-.TF "\f(CWadd name ..."
+.TF "\fLadd name ..."
 .TP
 .BI add " name ...
 adds the named control to the box of controls.  The display order
@@ -927,7 +927,7 @@ encodes the mouse buttons used to make the selection.
 The button displays an image (which may of course be a simple color)
 and illuminates in the standard way when it is `on'.
 The control messages it accepts are:
-.TF "\f(CWborder b"
+.TF "\fLborder b"
 .TP
 .BI align " a
 Controls the placement of the image in the rectangle (unimplemented).
@@ -968,7 +968,7 @@ A column is a grouping control which lays out its members vertically,
 from top to bottom.  Currently, columns ignore mouse and keyboard
 events, but there are plans to allow dragging the borders (when they
 have non-zero width) between constituent members.
-.TF "\f(CWadd name .."
+.TF "\fLadd name .."
 .TP
 .BI add " name ...
 adds the named control to the column of controls.  The vertical order
@@ -1058,7 +1058,7 @@ The file
 defines such a font.
 .PP
 The control messages the entry control accepts are:
-.TF "\f(CWborder b"
+.TF "\fLborder b"
 .TP
 .BI align " a
 Controls the placement of the text in the rectangle.
@@ -1128,7 +1128,7 @@ but to aid clumsy fingers the keystroke is not generated until the key is releas
 so it is possible to slide the pointer to a different key to correct for bad aim.
 .PP
 The control messages the keyboard accepts are:
-.TF "\f(CWfont"
+.TF "\fLfont"
 .TP
 .BI border " b
 .TP
@@ -1171,7 +1171,7 @@ A label is like a textbutton
 .RI ( q.v. )
 that does not react, but whose value is the text it displays.
 The control messages it accepts are:
-.TF "\f(CWvalue s"
+.TF "\fLvalue s"
 .TP
 .BI align " a
 Controls the placement of the image in the rectangle.
@@ -1230,7 +1230,7 @@ most programs use
 .BR Refnone .
 .PP
 The control messages accepted by a menu are:
-.TF "\f(CWwindow n"
+.TF "\fLwindow n"
 .TP
 .BI add " text
 Add a line of
@@ -1305,7 +1305,7 @@ buttons.
 In other words, the geometry is not maintained automatically.
 .PP
 The control messages the radiobutton accepts are:
-.TF "\f(CWadd name"
+.TF "\fLadd name"
 .TP
 .BI add " name
 Add the control with the specified
@@ -1337,7 +1337,7 @@ and
 interchanged.
 .PP
 The control messages it accepts are:
-.TF "\f(CWfont"
+.TF "\fLfont"
 .TP
 .BI add " name ...
 .TP
@@ -1369,7 +1369,7 @@ In most respects, including the format of its event messages, it is equivalent
 to a keyboard control.
 .PP
 The control messages it accepts are:
-.TF "\f(CWlinecolor \fIname\f(CW "
+.TF "\fLlinecolor \fIname\f(CW "
 .TP
 .BI align " a
 Controls the placement of the image in the rectangle (unimplemented).
@@ -1403,7 +1403,7 @@ A stack groups a number of member controls in the same shared rectangle.
 Only one of these controls will be visible (revealed), the others are hidden.
 .PP
 The control messages it accepts are:
-.TF "\f(CWreveal [\f2n\fP]"
+.TF "\fLreveal [\f2n\fP]"
 .TP
 .BI hide
 .TP
@@ -1470,7 +1470,7 @@ is the visual representation of the
 portion of the controlled object.
 .PP
 The control messages the slider accepts are:
-.TF "\f(CWabsolute n"
+.TF "\fLabsolute n"
 .TP
 .BI absolute " n
 If
@@ -1548,7 +1548,7 @@ top of the stack.  The radiobutton consists of textbuttons, the stack
 can be composed of any type of control.
 .PP
 Control messages are
-.TF "\f(CWformat fmt"
+.TF "\fLformat fmt"
 .TP
 .BI add " button control button control ...
 Adds a button to the radiobutton, and an associated control to the stack.
@@ -1609,7 +1609,7 @@ The non-zero value encodes the mouse buttons that were down
 when the selection occurred.
 .PP
 The control messages the text control accepts are:
-.TF "\f(CWselectmode \fIs\fP "
+.TF "\fLselectmode \fIs\fP "
 .TP
 .BI accumulate " s
 .TP
@@ -1731,7 +1731,7 @@ is the string that appears in the button.
 It uses the image, light, mask method of indicating its state;
 moreover, the color of the text can be set to change when the button is pressed.
 The control messages it accepts are:
-.TF "\f(CWalign a"
+.TF "\fLalign a"
 .TP
 .BI align " a
 Controls the placement of the text in the rectangle.

+ 157 - 0
sys/man/3/sdahci

@@ -0,0 +1,157 @@
+.TH SDAHCI 3
+.SH NAME
+sdahci \- AHCI (Advanced Host Controller Interface) SATA (Serial ATA) storage device drivers
+.SH SYNOPSIS
+.nf
+.B bind -a #S /dev
+.sp 0.3v
+.BI /dev/sdctl
+.sp 0.3v
+.BI /dev/sd E 0/ctl
+.BI /dev/sd E 0/raw
+.BI /dev/sd E 0/data
+\&...
+.fi
+.SH DESCRIPTION
+The
+.I sdahci
+drivers provide access to AHCI devices via the
+.IR sd (3)
+interface.
+The AHCI programming interface supports up to 32
+hot-swappable ATAPI or hard disk-like devices per controller.
+The legacy IDE interface provided by
+.B sdata.c
+supports up to four drives which are not hot-swappable.
+.PP
+AHCI controllers are detected automatically.
+Currently Intel and AMD controllers are detected.
+Intel controllers need to have AHCI enabled in the BIOS.
+For
+.L ich
+parts this typically means enabling
+enhanced mode and AHCI.
+For ESB (Enterprise South Bridge) -based
+parts, only enhanced mode needs to be enabled.
+Intel
+.BR ich9 -based
+AHCI does not support hot swapping and
+drives must be connected to the lowest-numbered free port.
+.PP
+The top level control file,
+.BR /dev/sdctl ,
+supports the following control messages for
+.IR sdahci :
+.TF "\fLahci idprint "
+.TP
+.B ahci debug
+Toggle debug messages.  Default is off.
+.TP
+.B ahci idprint
+Toggle printing of drive identification messages.  Default is on.
+Prints short messages when a drive is identified or removed.
+.TP
+.B ahci aprint
+Print verbose ATAPI debugging messages.  Default is off.
+.PD
+.PP
+The device-level
+.B ctl
+file supports:
+.TF "\fLsmartdisable"
+.TP
+.B flushcache
+Send the ATA/ATAPI
+.B FLUSH CACHE
+command
+.RB ( 0xe7
+or
+.BR 0xea ).
+This command may take up to 60 seconds to complete.
+.TP
+.B identify
+Send the ATA/ATAPI
+.B IDENTIFY DEVICE
+command
+.RB ( 0xec ).
+If device information has changed, the new size,
+features and serial will be noted.
+If changed, I/O on existing file
+descriptors will result in the error string
+.LR "media or partition has changed" .
+.TP
+.BI "mode " speed
+Change the connection
+.I speed
+to one of
+.BR auto ,
+.BR satai or
+.BR sataii .
+.TP
+.B nop
+Send the ATA
+.B NOP
+command
+.RB ( 0 )
+if the device supports it. Per standard, the result is always an error.
+.TP
+.B smart
+Send the ATA/ATAPI
+.B SMART RETURN STATUS
+command
+.RB ( 0xda ).
+This will fail unless SMART is enabled on the drive.
+.TP
+.B smartdisable
+Disable SMART on the drive.  SMART is a persistent property of the drive.
+.TP
+.B smartenable
+Enable SMART on the drive.
+.TP
+.BI "state " state
+Force a transition to the named
+.IR state .
+The states are:
+.RS
+.TF portreset
+.TP
+.B null
+ignored (may only be reached manually);
+.TP
+.B missing
+not detected;
+.TP
+.B new
+powered down or newly discovered;
+.TP
+.B ready
+ready for commands;
+.TP
+.B reset
+being reset gently;
+.TP
+.B portreset
+being fully reset;
+.TP
+.B offline
+device failed
+.B portreset
+(a port reset will be attempted periodically).
+.RE
+.PD
+.PP
+For devices present at boot, the transition is from state
+.B new
+to state
+.BR ready .
+.SH SOURCE
+.B /sys/src/9/pc/sdiahci.c
+.SH SEE ALSO
+.IR sd (3),
+.IR 9load (8)
+.br
+.BR http://download.intel.com/technology/serialata/pdf/rev1_2.pdf .
+.SH BUGS
+None of enclosure management, LED control and port multipliers are supported.
+.PP
+ATAPI devices may not be reset when they have outstanding commands.

+ 1 - 1
sys/man/4/u9fs

@@ -53,7 +53,7 @@ serves both 9P1 (the 9P protocol as used by
 the second and third editions of Plan 9) and 9P2000.
 .PP
 The options are:
-.TF "\f(CW-A \fIautharg"
+.TF "\fL-A \fIautharg"
 .PD
 .TP
 .B -D