From owner-svn-doc-all@freebsd.org Sun Mar 12 11:21:02 2017 Return-Path: Delivered-To: svn-doc-all@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id D0A41CF9241; Sun, 12 Mar 2017 11:21:02 +0000 (UTC) (envelope-from bhd@FreeBSD.org) Received: from repo.freebsd.org (repo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id A8CA3157D; Sun, 12 Mar 2017 11:21:02 +0000 (UTC) (envelope-from bhd@FreeBSD.org) Received: from repo.freebsd.org ([127.0.1.37]) by repo.freebsd.org (8.15.2/8.15.2) with ESMTP id v2CBL1Ok012219; Sun, 12 Mar 2017 11:21:01 GMT (envelope-from bhd@FreeBSD.org) Received: (from bhd@localhost) by repo.freebsd.org (8.15.2/8.15.2/Submit) id v2CBL1LH012218; Sun, 12 Mar 2017 11:21:01 GMT (envelope-from bhd@FreeBSD.org) Message-Id: <201703121121.v2CBL1LH012218@repo.freebsd.org> X-Authentication-Warning: repo.freebsd.org: bhd set sender to bhd@FreeBSD.org using -f From: Bjoern Heidotting Date: Sun, 12 Mar 2017 11:21:01 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r50051 - head/de_DE.ISO8859-1/books/handbook/disks X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: "SVN commit messages for the entire doc trees \(except for " user" , " projects" , and " translations" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 12 Mar 2017 11:21:02 -0000 Author: bhd Date: Sun Mar 12 11:21:01 2017 New Revision: 50051 URL: https://svnweb.freebsd.org/changeset/doc/50051 Log: Update to r50030: Slightly revise the way we refer to FreeBSD 12 here. Update to r50019: Submit documentation from trasz for his Foundation-sponsored work on the USB Mass Storage CTL front end. Reviewed by: bcr Differential Revision: https://reviews.freebsd.org/D9966 Modified: head/de_DE.ISO8859-1/books/handbook/disks/chapter.xml Modified: head/de_DE.ISO8859-1/books/handbook/disks/chapter.xml ============================================================================== --- head/de_DE.ISO8859-1/books/handbook/disks/chapter.xml Sun Mar 12 02:35:00 2017 (r50050) +++ head/de_DE.ISO8859-1/books/handbook/disks/chapter.xml Sun Mar 12 11:21:01 2017 (r50051) @@ -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: r48568 + basiert auf: r50030 --> iSCSI-LUNs. + + + <acronym>USB</acronym>-Massenspeicher + + + Der &man.cfumass.4;-Treiber ist ein + USB Geräte-Modus-Treiber und steht mit + &os; 12.0 zur Verfügung. + + + Auf + USB-OTG-kompatibler + Hardware, wie in eingebetteten Systemen, kann der &os; + USB-Stack im Geräte-Modus laufen. Der + Geräte-Modus ermöglicht es dem Rechner, verschiedene Arten von + USB-Geräteklassen zu präsentieren, + einschließlich serieller Schnittstellen, Netzwerkadapter und + Massenspeicher. Ein USB-Host, + beispielsweise ein Laptop oder Desktop-Rechner, kann darauf + wie auf ein physikalisches USB-Gerät + zugreifen. + + Je nach angeschlossener Hardware, ermöglicht das + &man.usb.template.4; Kernelmodul es dem + USB-Stack, automatisch zwischen Host- und + Geräteseite umzuschalten. Das Anschließen eines + USB-Gerätes an den + USB-OTG-Port bewirkt, + dass &os; in den Geräte-Modus wechselt. + + Was &os; dem USB-Host präsentiert, + hängt von der sysctl-Variablen + hw.usb.template ab. Eine Liste der + verfügbaren Werte finden Sie in &man.usb.template.4;. Damit + der Host die geänderte Konfiguration erkennt, muss entweder + das Gerät getrennt und wieder angeschlossen, oder der + USB-Bus neu gescannt werden. Wenn auf dem + Host &os; läuft, können Sie &man.usbconfig.8; + reset benutzen. Dieser Befehl muss nach + dem Laden von usb_template.ko erfolgen, + falls der USB-Host bereits am + USB-OTG-Port + angeschlossen war. + + Die sysctl-Variable hw.usb.template ist + in der Voreinstellung auf 0 gesetzt, so dass &os; als + USB-Massenspeicher funktioniert. Dazu + müssen die beiden Kernelmodule &man.usb.template.4; und + &man.cfumass.4; geladen sein. &man.cfumass.4; ist die + Schnittstelle zum CTL-Subsystem, die auch für + iSCSI- und Fibre Channel-Targets + benutzt wird. Auf der Host-Seite können + USB-Massenspeicher nur auf eine einzelne + LUN (LUN 0) + zugreifen. + + USB-Massenspeicher benötigen keinen + aktiven &man.ctld.8;-Daemon, obwohl er bei Bedarf verwendet + werden kann. Dies unterscheidet sich von + iSCSI. So gibt es zwei Möglichkeiten, + ein Target zu konfigurieren: &man.ctladm.8; und &man.ctld.8;. + Beide erfordern, dass das cfumass.ko + Kernelmodul geladen ist. Das Modul kann wie folgt geladen + werden: + + &prompt.root; kldload cfumass + + Wenn cfumass.ko nicht im Kernel + enthalten ist, kann das Modul beim Booten über + /boot/loader.conf geladen werden: + + cfumass_load="YES" + + Eine LUN kann auch ohne den + &man.ctld.8;-Daemon erstellt werden: + + &prompt.root; ctladm create -b block -o file=/data/target0 + + Damit wird dem USB der Inhalt des + Abbilds /data/target0 als + LUN präsentiert. Die Datei muss vor dem + Ausführen des Befehls vorhanden sein. Um die + LUN beim Systemstart zu konfigurieren, + fügen Sie den Befehl in /etc/rc.local + hinzu. + + &man.ctld.8; kann ebenfalls verwendet werden, um + LUNs zu verwalten. Erstellen Sie + /etc/ctl.conf und fügen Sie eine Zeile in + /etc/rc.conf hinzu, um sicherzustellen, + dass &man.ctld.8; beim Booten automatisch gestartet wird. + Danach starten Sie den Daemon. + + Dies ist ein Beispiel für eine einfache + /etc/ctl.conf Konfigurationsdatei. + &man.ctl.conf.5; enthält eine ausführliche Beschreibung der + einzelnen Optionen. + + target naa.50015178f369f092 { + lun 0 { + path /data/target0 + size 4G + } +} + + Dieses Beispiel erstellt ein Target mit einer einzigen + LUN. + naa.50015178f369f092 ist eine Gerätekennung + aus 32 zufälligen, hexadezimalen Ziffern. Die + path-Zeile definiert den vollständigen Pfad + einer Datei oder eines zvols, welche als Backend für die + LUN benutzt wird. Die Konfigurationsdatei + muss vor dem Start von &man.ctld.8; existieren. Die zweite + Zeile ist optional und gibt die Größe der + LUN an. + + Fügen Sie folgende Zeile in + /etc/rc.conf hinzu, um den + &man.ctld.8;-Daemon beim Booten zu starten: + + ctld_enable="YES" + + Um &man.ctld.8; zu starten, führen Sie dieses Kommando + aus: + + &prompt.root; service ctld start + + Beim Start liest der &man.ctld.8;-Daemon + /etc/ctl.conf ein. Wenn diese Datei nach + dem Start des Daemons bearbeitet wird, können Sie sie erneut + einlesen, damit die Änderungen direkt wirksam sind: + + &prompt.root; service ctld reload +