Update to r44635:

Editorial review of USB Storage Devices chapter.
Update examples.
Add note for xhci.
Incorporate resources into context.

Reviewed by:	bcr
Differential Revision:	https://reviews.freebsd.org/D5857
This commit is contained in:
Bjoern Heidotting 2016-04-08 17:27:52 +00:00
parent 3094b62169
commit 7f0f93c959
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/head/; revision=48551

View file

@ -5,7 +5,7 @@
$FreeBSD$
$FreeBSDde: de-docproj/books/handbook/disks/chapter.xml,v 1.187 2012/04/26 19:32:48 bcr Exp $
basiert auf: r44533
basiert auf: r44635
-->
<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" xml:id="disks">
<info><title>Speichermedien</title>
@ -438,73 +438,74 @@ super-block backups (for fsck -b #) at:
</indexterm>
<para>Der Universal Serial Bus (<acronym>USB</acronym>) wird
heutzutage von vielen externen Speichern benutzt: Festplatten,
<acronym>USB</acronym>-Thumbdrives oder
<acronym>CD</acronym>-Brennern. &os; bietet Unterstützung für
diese Geräte.</para>
von vielen externen Speichern benutzt: Festplatten,
<acronym>USB</acronym>-Thumbdrives sowie von
<acronym>CD</acronym>- und <acronym>DVD</acronym>-Brennern.
&os; bietet Unterstützung für Geräte mit <acronym>USB</acronym>
1.x, 2.0 und 3.0.</para>
<sect2>
<title>Konfiguration</title>
<note>
<para>Die Unterstützung für<acronym>USB</acronym> 3.0 ist mit
einiger Hardware, einschließlich Haswell (Lynx Point)
Chipsätzen, nicht kompatibel. Wenn &os; beim Booten mit dem
Fehler <errorname>failed with error 19</errorname> abbricht,
müssen Sie xHCI/USB3 im <acronym>BIOS</acronym>
deaktivieren.</para>
</note>
<para>Der Treiber für <acronym>USB</acronym>-Massenspeicher,
&man.umass.4;, ist im <filename>GENERIC</filename>-Kernel
enthalten und bietet Unterstützung für
<acronym>USB</acronym>-Speichermedien. Für einen angepassten
Kernel müssen die nachstehenden Zeilen in der
Kernelkonfigurationsdatei enthalten sein:</para>
<para>Unterstützung für <acronym>USB</acronym>-Massenspeicher ist
im <filename>GENERIC</filename>-Kernel enthalten. Für einen
angepassten Kernel müssen die nachstehenden Zeilen in der
Kernelkonfigurationsdatei enthalten sein:</para>
<programlisting>device scbus
device da
device pass
device uhci
device ohci
device ehci
device usb
device umass</programlisting>
<programlisting>device scbus>>>>>>>># SCSI bus (required for ATA/SCSI)
device da>>>>>>># Direct Access (disks)
device pass>>>>># Passthrough device (direct ATA/SCSI access)
device uhci>>>>># provides USB 1.x support
device ohci>>>>># provides USB 1.x support
device ehci>>>>># provides USB 2.0 support
device xhci>>>>># provides USB 3.0 support
device usb>>>>>># USB Bus (required)
device umass>>>># Disks/Mass storage - Requires scbus and da
device cd>>>>>>># needed for CD and DVD burners</programlisting>
<para>Da der &man.umass.4;-Treiber das
<acronym>SCSI</acronym>-Subsystem benutzt um auf
<acronym>USB</acronym>-Geräte zuzugreifen, werden alle
<para>&os; benutzt den &man.umass.4;-Treiber, der das
<acronym>SCSI</acronym>-Subsystem verwendet um auf
<acronym>USB</acronym>-Geräte zuzugreifen. Da alle
<acronym>USB</acronym>-Geräte vom System als
<acronym>SCSI</acronym>-Geräte erkannt. Abhängig vom Chipsatz
der Systemplatine wird <literal>device uhci</literal> oder
<literal>device ohci</literal> für die Unterstützung von
<acronym>USB</acronym> 1.X benutzt. Unterstützung für
<acronym>USB</acronym> 2.0 Controller wird durch
<literal>device ehci</literal> bereitgestellt.</para>
<acronym>SCSI</acronym>-Geräte erkannt werden, dürfen Sie
<emphasis>nicht</emphasis> <option>device atapicam</option>
in die Kernelkonfigurationsdatei aufnehmen, wenn es sich bei
dem Gerät um einen <acronym>CD</acronym>- oder
<acronym>DVD</acronym>-Brenner handelt.</para>
<note>
<para>Wenn es sich bei dem <acronym>USB</acronym>-Gerät um
einen <acronym>CD</acronym>- oder
<acronym>DVD</acronym>-Brenner handelt, muss &man.cd.4; in
den Kernel aufgenommen werden:</para>
<programlisting>device cd</programlisting>
<para>Da der Brenner als <acronym>SCSI</acronym>-Laufwerk
erkannt wird, sollte der Treiber &man.atapicam.4; nicht
benutzt werden.</para>
</note>
</sect2>
<para>Der übrige Abschnitt beschreibt, wie Sie überprüfen können
ob ein <acronym>USB</acronym>-Gerät von &os; erkannt wird und
wie Sie das Gerät so konfigurieren, dass es verwendet werden
kann.</para>
<sect2>
<title>Die Konfiguration testen</title>
<title>Konfiguration von Geräten</title>
<para>Um die <acronym>USB</acronym>-Konfiguration zu testen,
schließen Sie das <acronym>USB</acronym>-Gerät an. In den
Systemmeldungen, &man.dmesg.8;, sollte das Gerät wie folgt
angezeigt werden:</para>
schließen Sie das <acronym>USB</acronym>-Gerät an. Verwenden
Sie <command>dmesg</command> um zu überprüfen, ob das Gerät in
den Systemmeldungen erscheint. Dies sollte in etwa so
aussehen:</para>
<screen>umass0: USB Solid state disk, rev 1.10/1.00, addr 2
GEOM: create disk da0 dp=0xc2d74850
da0 at umass-sim0 bus 0 target 0 lun 0
da0: &lt;Generic Traveling Disk 1.11&gt; Removable Direct Access SCSI-2 device
da0: 1.000MB/s transfers
da0: 126MB (258048 512 byte sectors: 64H 32S/T 126C)</screen>
<screen>umass0: &lt;STECH Simple Drive, class 0/0, rev 2.00/1.04, addr 3&gt; on usbus0
umass0: SCSI over Bulk-Only; quirks = 0x0100
umass0:4:0:-1: Attached to scbus4
da0 at umass-sim0 bus 0 scbus4 target 0 lun 0
da0: &lt;STECH Simple Drive 1.04&gt; Fixed Direct Access SCSI-4 device
da0: Serial Number WD-WXE508CAN263
da0: 40.000MB/s transfers
da0: 152627MB (312581808 512 byte sectors: 255H 63S/T 19457C)
da0: quirks=0x2&lt;NO_6_BYTE&gt;</screen>
<para>Fabrikat, Gerätedatei (<filename>da0</filename>) und
andere Details werden je nach Gerät unterschiedlich
sein.</para>
<para>Fabrikat, Gerätedatei (<filename>da0</filename>),
Geschwindigkeit und Kapazität werden je nach Gerät
unterschiedlich sein.</para>
<para>Da ein <acronym>USB</acronym>-Gerät als
<acronym>SCSI</acronym>-Gerät erkannt wird, kann
@ -513,19 +514,28 @@ da0: 126MB (258048 512 byte sectors: 64H 32S/T 126C)</screen>
anzuzeigen:</para>
<screen>&prompt.root; <userinput>camcontrol devlist</userinput>
&lt;Generic Traveling Disk 1.11&gt; at scbus0 target 0 lun 0 (da0,pass0)</screen>
&lt;STECH Simple Drive 1.04&gt; at scbus4 target 0 lun 0 (pass3,da0)</screen>
<para>Wenn auf dem Laufwerk ein Dateisystem eingerichtet
ist, kann es gemountet werden.
<xref linkend="disks-adding"/> beschreibt, wie Sie
<para>Alternativ kann <command>usbconfig</command> benutzt
werden, um die Geräte aufzulisten. Weitere Informationen zu
diesem Kommando finden Sie in &man.usbconfig.8;.</para>
<screen>&prompt.root; <userinput>usbconfig</userinput>
ugen0.3: &lt;Simple Drive STECH&gt; at usbus0, cfg=0 md=HOST spd=HIGH (480Mbps) pwr=ON (2mA)</screen>
<para>Wenn das Gerät noch nicht formatiert ist, finden Sie in
<xref linkend="disks-adding"/> Informationen, wie Sie
<acronym>USB</acronym>-Laufwerke formatieren und Partitionen
einrichten.</para>
einrichten. Wenn das Laufwerk bereits ein Dateisystem
enthält, kann es von <systemitem
class="username">root</systemitem> nach den Anweisungen in
<xref linkend="mount-unmount"/> eingehängt werden.</para>
<warning>
<para>Aus Sicherheitsgründen sollten Sie Benutzern, denen Sie
nicht vertrauen, das Einhängen (z.B. durch die unten
beschriebene Aktivierung von <literal>vfs.usermount</literal>)
beliebiger Medien verbieten. Die meisten Dateisysteme in &os;
beliebiger Medien verbieten. Die meisten Dateisysteme
wurden nicht entwickelt, um sich vor böswilligen Geräten
zu schützen.</para>
</warning>
@ -534,8 +544,8 @@ da0: 126MB (258048 512 byte sectors: 64H 32S/T 126C)</screen>
gestatten, könnten Sie beispielsweise mit &man.pw.8; alle
potentiellen Benutzer dieser Gerätedateien in die Gruppe
<systemitem class="groupname">operator</systemitem> aufnehmen.
Außerdem muss sichergestellt werden, dass Mitglieder der
Gruppe <systemitem class="groupname">operator</systemitem>
Außerdem muss sichergestellt werden, dass <systemitem
class="groupname">operator</systemitem>
Schreib- und Lesezugriff auf diese Gerätedateien haben.
Hierfür werden die folgenden Zeilen in
<filename>/etc/devfs.rules</filename> hinzugefügt:</para>
@ -544,34 +554,40 @@ da0: 126MB (258048 512 byte sectors: 64H 32S/T 126C)</screen>
add path 'da*' mode 0660 group operator</programlisting>
<note>
<para>Verfügt das System über
<para>Verfügt das System über interne
<acronym>SCSI</acronym>-Laufwerke, so verändern Sie die
zweite Zeile wie folgt:</para>
<programlisting>add path 'da[3-9]*' mode 0660 group operator</programlisting>
<programlisting>add path 'da[<replaceable>3</replaceable>-9]*' mode 0660 group operator</programlisting>
<para>Dies wird die ersten drei
<acronym>SCSI-Laufwerke</acronym> (<filename>da0</filename> bis
<filename>da2</filename>) davon ausschließen, in die
<acronym>SCSI</acronym>-Laufwerke (<filename>da0</filename>
bis <filename>da2</filename>) davon ausschließen, in die
Gruppe <systemitem class="groupname">operator</systemitem>
aufgenommen zu werden.</para>
aufgenommen zu werden. Ersetzen Sie <literal>3</literal>
durch die Anzahl der <acronym>SCSI</acronym>-Laufwerke.
Weitere Informationen zu dieser Datei finden Sie in
&man.devfs.rules.5;.</para>
</note>
<para>Aktivieren Sie nun die &man.devfs.rules.5;-Regeln
<para>Aktivieren Sie nun die Regeln
in <filename>/etc/rc.conf</filename>:</para>
<programlisting>devfs_system_ruleset="localrules"</programlisting>
<para>Als nächstes müssen Sie Ihren Kernel anweisen, auch
normalen Benutzern das mounten von Dateisystemen zu erlauben.
Am einfachsten geht dies, indem die folgende Zeile in
<filename>/etc/sysctl.conf</filename> hinzugefügt wird:</para>
<para>Als nächstes müssen Sie das System anweisen, auch
normalen Benutzern das mounten von Dateisystemen zu erlauben,
indem Sie die folgende Zeile in
<filename>/etc/sysctl.conf</filename> hinzufügen:</para>
<programlisting>vfs.usermount=1</programlisting>
<para>Da diese Einstellung erst nach einem Neustart wirksam
wird, können Sie diese Variable mit &man.sysctl.8; auch direkt
setzen.</para>
wird, können Sie diese Variable mit <command>sysctl</command>
auch direkt setzen:</para>
<screen>&prompt.root; <userinput>sysctl vfs.usermount=1</userinput>
vfs.usermount: 0 -&gt; 1</screen>
<para>Zuletzt müssen Sie noch ein Verzeichnis anlegen, in
das das <acronym>USB</acronym>-Laufwerk eingehängt werden
@ -594,32 +610,24 @@ add path 'da*' mode 0660 group operator</programlisting>
<acronym>USB</acronym>-Stick
anschließen, wird automatisch die Gerätedatei
<filename>/dev/da0s1</filename> erzeugt. Ist das Gerät mit
einem FAT-Dateisystem formatiert, können Sie es mit dem
folgenden Befehl in den Verzeichnisbaum einhängen:</para>
einem <acronym>FAT</acronym>-Dateisystem formatiert, kann es
der Benutzer mit dem folgenden Befehl in den Verzeichnisbaum
einhängen:</para>
<screen>&prompt.user; <userinput>mount -t msdosfs -o -m=644,-M=755 /dev/da0s1 /mnt/<replaceable>username</replaceable></userinput></screen>
<para>Bevor das Gerät entfernt werden kann,
<emphasis>muss</emphasis> es abgehängt werden. Nach
Entfernen des Geräts zeigen sich in den Systemmeldungen
<emphasis>muss</emphasis> es abgehängt werden:</para>
<screen>&prompt.root; <userinput>umount /mnt/<replaceable>username</replaceable></userinput></screen>
<para>Nach Entfernen des Geräts stehen in den Systemmeldungen
Einträge, ähnlich der folgenden:</para>
<screen>umass0: at uhub0 port 1 (addr 2) disconnected
(da0:umass-sim0:0:0:0): lost device
(da0:umass-sim0:0:0:0): removing device entry
GEOM: destroy disk da0 dp=0xc2d74850
umass0: detached</screen>
</sect2>
<sect2>
<title>Weiteres zu USB</title>
<para>Neben den Abschnitten
<link linkend="disks-adding">Hinzufügen von Laufwerken</link>
und <link linkend="mount-unmount">Anhängen und
Abhängen von Dateisystemen</link> lesen Sie bitte
die Hilfeseiten &man.umass.4;, &man.camcontrol.8; für
&os;&nbsp;8.X oder &man.usbdevs.8; bei vorherigen Versionen.</para>
<screen>umass0: at uhub3, port 2, addr 3 (disconnected)
da0 at umass-sim0 bus 0 scbus4 target 0 lun 0
da0: &lt;STECH Simple Drive 1.04&gt; s/n WD-WXE508CAN263 detached
(da0:umass-sim0:0:0:0): Periph destroyed</screen>
</sect2>
</sect1>