diff options
author | scottl <scottl@FreeBSD.org> | 2004-06-24 04:05:08 +0000 |
---|---|---|
committer | scottl <scottl@FreeBSD.org> | 2004-06-24 04:05:08 +0000 |
commit | 821a93fb4803bc2935c393adf426de94bef16e8c (patch) | |
tree | df959ef9f0be2655ce82672c7dce4df129d57161 /share | |
parent | bff787dba34a46b67b689f5a420297b4bd0c2b86 (diff) | |
download | FreeBSD-src-821a93fb4803bc2935c393adf426de94bef16e8c.zip FreeBSD-src-821a93fb4803bc2935c393adf426de94bef16e8c.tar.gz |
Update the section on device wiring to match how things are done in 5.x.
Diffstat (limited to 'share')
-rw-r--r-- | share/man/man4/scsi.4 | 55 |
1 files changed, 39 insertions, 16 deletions
diff --git a/share/man/man4/scsi.4 b/share/man/man4/scsi.4 index c8e125d..c274bb4 100644 --- a/share/man/man4/scsi.4 +++ b/share/man/man4/scsi.4 @@ -159,23 +159,46 @@ so they appear as a particular device unit or .Em counted so that they appear as the next available unused unit. .Pp -To configure a driver in the kernel without wiring down the device use a -config line similar to -.Cd "device ch0" -to include the changer driver. +Units are wired down by setting kernel environment hints. +This is usually done either interactively from the loader, or automatically via the +.Pa /boot/device.hints +file. The basic syntax is: +.Bd -literal -offset indent +hint.device.unit.property="value" +.Ed .Pp -To wire down a unit use a config line similar to -.Cd "device ch1 at scbus0 target 4 unit 0" -to assign changer 1 as the changer with SCSI ID 4, -SCSI logical unit 0 on SCSI bus 0. -Individual scbuses can be wired down to specific controllers with -a config line similar to -.Cd "device scbus0 at ahc0" -which assigns scsi bus 0 to the first unit using the ahc driver. -For controllers supporting more than one bus, -the particular bus can be specified as in -.Cd "device scbus3 at ahc1 bus 1" -which assigns scbus 1 to the second bus probed on the ahc1 device. +Individual scsi bus numbers can be wired down to specific controllers with +a config line similar to the following: +.Bd -literal -offset indent +hint.scbus.0.at="ahd1" +.Ed +.Pp +This assigns scsi bus number 0 to the +.Em ahd1 +driver instance. +For controllers supporting more than one bus, a particular bus can be assigned +as follows: +.Bd -literal -offset indent +hint.scbus.0.at="ahc1" +hint.scbus.0.bus="1" +.Ed +.Pp +This assigns scsi bus 0 to the bus 1 instance on +.Em ahc0 . +Peripheral drivers can be wired to a specific bus, target, and lun as so: +.Bd -literal -offset indent +hint.da.0.at="scbus0" +hint.da.0.target="0" +hint.da.0.unit="0" +.Ed +.Pp +This assigns +.Em da0 +to target 0, unit (lun) 0 of scbus 0. +Omitting the target or unit hints will instruct CAM to treat them as wildcards +and use the first respective counted instances. +These examples can be combined together to allow a peripheral device to be +wired to any particular controller, bus, target, and/or unit instance. .Pp When you have a mixture of wired down and counted devices then the counting begins with the first non-wired down unit for a particular |