arm64: QorIQ: gpio: Cleanup qoriq_gpio_* helpers

[ar_semihalf.com]

Summary

Replace various hw reg bit set/clear helpers with a universal
qoriq_gpio_set function.

sys/arm64/qoriq/ls1046_gpio.c

 <?xml version="1.0" encoding="iso-8859-1"?>
 <!--
      The FreeBSD Documentation Project
      The FreeBSD German Documentation Project
 
      $FreeBSD$
      $FreeBSDde: de-docproj/books/handbook/disks/chapter.xml,v 1.187 2012/04/26 19:32:48 bcr Exp $
-     basiert auf: r44638
+     basiert auf: r44642
 -->
 <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>
     <authorgroup>
       <author><personname><firstname>Bernd</firstname><surname>Warken</surname></personname><contrib>Übersetzt von </contrib></author>
       <author><personname><firstname>Martin</firstname><surname>Heinen</surname></personname></author>
     </authorgroup>
   </info>
cd0: Attempt to query device size failed: NOT READY, Medium not present - tray closed</screen>
         <package>sysutils/cdrecord</package>installiert.</para>
 
       <para>Obwohl <command>cdrecord</command> viele Optionen besitzt,
         ist die grundlegende Benutzung sehr einfach.  Geben Sie den
         Namen der zu brennenden ISO-Datei an.  Wenn das System über
         mehrere Brenner verfügt, müssen Sie auch den Namen des
         Gerätes angeben:</para>
 
-      <screen>&prompt.root; <userinput>cdrecord dev=<replaceable>device</replaceable> <replaceable>imagefile.iso</replaceable></userinput></screen>
+      <screen>&prompt.root; <userinput>cdrecord <replaceable>dev=device</replaceable> <replaceable>imagefile.iso</replaceable></userinput></screen>
 
-      <para>Der Knackpunkt in der Benutzung von
-        <command>cdrecord</command> besteht darin, das richtige
-        Argument zu <option>dev</option> zu finden.  Benutzen Sie
-        <option>-scanbus</option>, das eine ähnliche Ausgabe
-        wie die folgende produziert:</para>
+      <para>Benutzen Sie <option>-scanbus</option> um den Gerätenamen
+        des Brenners zu bestimmen.  Die Ausgabe könnte wie folgt
+        aussehen:</para>
 
       <indexterm>
         <primary><acronym>CD-ROM</acronym></primary>
         <secondary>brennen</secondary>
       </indexterm>
 
       <screen>&prompt.root; <userinput>cdrecord -scanbus</userinput>
-Cdrecord 1.9 (i386-unknown-freebsd7.0) Copyright (C) 1995-2004 Jörg Schilling
-Using libscg version 'schily-0.1'
+ProDVD-ProBD-Clone 3.00 (amd64-unknown-freebsd10.0) Copyright (C) 1995-2010 Jörg Schilling
+Using libscg version 'schily-0.9'
 scsibus0:
         0,0,0     0) 'SEAGATE ' 'ST39236LW       ' '0004' Disk
         0,1,0     1) 'SEAGATE ' 'ST39173W        ' '5958' Disk
         0,2,0     2) *
         0,3,0     3) 'iomega  ' 'jaz 1GB         ' 'J.86' Removable Disk
         0,4,0     4) 'NEC     ' 'CD-ROM DRIVE:466' '1.26' Removable CD-ROM
         0,5,0     5) *
         0,6,0     6) *
         0,7,0     7) *
 scsibus1:
         1,0,0   100) *
         1,1,0   101) *
         1,2,0   102) *
         1,3,0   103) *
         1,4,0   104) *
         1,5,0   105) 'YAMAHA  ' 'CRW4260         ' '1.0q' Removable CD-ROM
         1,6,0   106) 'ARTEC   ' 'AM12S           ' '1.06' Scanner
         1,7,0   107) *</screen>
 
-      <para>Für die aufgeführten Geräte in der Liste
-        wird das passende Argument zu <option>dev</option> gegeben.
-        Benutzen Sie die drei durch Kommas separierten Zahlen, die zum
-        <acronym>CD</acronym>-Brenner angegeben sind, als Argument für
-        <option>dev</option>.  Im Beispiel ist das CDRW-Gerät
-        1,5,0, so dass die passende Eingabe
-        <userinput>dev=1,5,0</userinput> ist.  Einfachere Wege das
+      <para>Benutzen Sie die drei durch Kommas separierten Zahlen, die
+        für den <acronym>CD</acronym>-Brenner angegeben sind, als
+        Argument für <option>dev</option>.  Im Beispiel ist das
+        Yamaha-Gerät <literal>1,5,0</literal>, so dass die passende
+        Eingabe <option>dev=1,5,0</option> ist.  Einfachere Wege das
         Argument anzugeben, sowie Informationen über Audiospuren und
-        das Einstellen der Geschwindigkeit, sind in &man.cdrecord.1;
-        beschrieben.</para>
+        das Einstellen der Geschwindigkeit, sind in der Manualpage von
+        <command>cdrecord</command> beschrieben.</para>
 
       <para>Alternativ können Sie den folgenden Befehl ausführen, um
         die Geräteadresse des Brenners zu ermitteln:</para>
 
       <screen>&prompt.root; <userinput>camcontrol devlist</userinput>
 &lt;MATSHITA CDRW/DVD UJDA740 1.00&gt;   at scbus1 target 0 lun 0 (cd0,pass0)</screen>
 
       <para>Verwenden Sie die numerischen Werte für
         <literal>scbus</literal>, <literal>target</literal> und
         <literal>lun</literal>.  Für dieses Beispiel wäre
         <literal>1,0,0</literal> als Gerätename zu verwenden.</para>
     </sect2>
 
     <sect2 xml:id="mkisofs">
-      <title>Ein <acronym>ISO</acronym>-Dateisystem erstellen</title>
+      <title>Daten auf <acronym>ISO</acronym>-Dateisystem
+        schreiben</title>
 
       <para>Die Datendateien müssen vorbereitet sein, bevor sie auf
         eine <acronym>CD</acronym> gebrannt werden.  In &os; wird
         <command>mkisofs</command> vom Paket oder Port
         <package>sysutils/cdrtools</package> installiert.  Dieses
         Programm kann aus einem &unix; Verzeichnisbaum ein
         <acronym>ISO</acronym> 9660-Dateisystem erzeugen.  Im
         einfachsten Fall müssen Sie lediglich den Namen der zu
         erzeugenden <acronym>ISO</acronym>-Datei und den Pfad zu den
         Dateien angeben, die auf dem <acronym>ISO</acronym>
         9660-Dateisystem platziert werden:</para>
 
       <screen>&prompt.root; <userinput>mkisofs -o <replaceable>imagefile.iso</replaceable> <replaceable>/path/to/tree</replaceable></userinput></screen>
-
       <indexterm>
         <primary>Dateisysteme</primary>
         <secondary>ISO 9660</secondary>
       </indexterm>
-      <para>Dieses Kommando erstellt
-        <replaceable>imagefile.iso</replaceable>, die ein ISO
-        9660-Dateisystem enthält, das eine Kopie des Baumes unter
-        <replaceable>/path/to/tree</replaceable> ist.  Dabei werden
-        die Dateinamen auf Namen abgebildet, die den Restriktionen des
-        ISO 9660-Dateisystems entsprechen.  Dateien mit Namen, die im
-        ISO 9660-Dateisystem nicht gültig sind, bleiben
-        unberücksichtigt.</para>
 
+      <para>Bei diesem Kommando werden die Dateinamen auf Namen
+        abgebildet, die den Restriktionen des <acronym>ISO</acronym>
+        9660-Dateisystem entsprechen.  Dateien, die diesem Standard
+        nicht entsprechen bleiben unberücksichtigt.</para>
+
       <indexterm>
         <primary>Dateisysteme</primary>
-        <secondary>HFS</secondary>
-      </indexterm>
-      <indexterm>
-        <primary>Dateisysteme</primary>
         <secondary>Joliet</secondary>
       </indexterm>
-      <para>Es einige Optionen, um diese Beschränkungen zu überwinden.
-        Die unter &unix; Systemen üblichen Rock-Ridge-Erweiterungen
-        werden durch <option>-R</option> aktiviert,
-        <option>-J</option> aktiviert die von Microsoft Systemen
-        benutzten Joliet-Erweiterungen und <option>-hfs</option> dient
-        dazu, um das von &macos; benutzte HFS zu erstellen.</para>
 
+      <para>Es gibt einige Optionen, um die Beschränkungen dieses
+        Standards zu überwinden.  Die unter &unix; Systemen üblichen
+        Rock-Ridge-Erweiterungen werden durch <option>-R</option>
+        aktiviert und <option>-J</option> aktiviert die von Microsoft
+        Systemen benutzten Joliet-Erweiterungen.</para>
+
       <para>Für <acronym>CD</acronym>s, die nur auf &os;-Systemen verwendet werden
         sollen, kann <option>-U</option> genutzt werden, um alle
         Beschränkungen für Dateinamen aufzuheben.  Zusammen mit
         <option>-R</option> wird ein Abbild des Dateisystems,
-        identisch zu angegebenen &os;-Dateibaum, erstellt, obwohl dies
-        den ISO 9660 Standard verletzen kann.</para>
+        identisch zu angegebenen &os;-Dateibaum erstellt, selbst wenn
+        dies den <acronym>ISO</acronym> 9660 Standard verletzt.</para>
 
       <indexterm>
         <primary><acronym>CD-ROM</acronym></primary>
         <secondary>bootbare erstellen</secondary>
       </indexterm>
+
       <para>Die letzte übliche Option ist <option>-b</option>.
         Sie wird benutzt, um den Ort eines Bootimages einer
         <quote>El Torito</quote> bootbaren <acronym>CD</acronym> anzugeben.  Das Argument
         zu dieser Option ist der Pfad zu einem Bootimage ausgehend
         von der Wurzel des Baumes, der auf die <acronym>CD</acronym> geschrieben werden
-        soll.  In der Voreinstellung erzeugt &man.mkisofs.8; ein
-        ISO-Image im <quote>Diskettenemulations</quote>-Modus.  Dabei
+        soll.  In der Voreinstellung erzeugt
+        <command>mkisofs</command> ein <acronym>ISO</acronym>-Image im
+        <quote>Diskettenemulations</quote>-Modus.  Dabei
         muss das Image genau 1200, 1440 oder 2880&nbsp;KB groß
-        sein.  Einige Bootloader, darunter der auf den &os;-Disks
-        verwendete, kennen keinen Emulationsmodus.  Daher sollten Sie
-        in diesen Fällen <option>-no-emul-boot</option> verwenden.
+        sein.  Einige Bootloader, darunter der auf den &os; Installationsmedien
+        verwendete, kennen keinen Emulationsmodus.  Daher sollte
+        in diesen Fällen <option>-no-emul-boot</option> verwendet werden.
         Wenn <filename>/tmp/myboot</filename> ein bootbares
         &os;-System enthält, dessen Bootimage sich in
-        <filename>/tmp/myboot/boot/cdboot</filename> befindet, können
-        Sie ein Abbild eines ISO 9660-Dateisystems in
+        <filename>/tmp/myboot/boot/cdboot</filename> befindet, dann
+        würde folgendes Kommando
         <filename>/tmp/bootable.iso</filename> erstellen:</para>
 
       <screen>&prompt.root; <userinput>mkisofs -R -no-emul-boot -b boot/cdboot -o /tmp/bootable.iso /tmp/myboot</userinput></screen>
 
-      <para>Wenn <filename>md</filename> im Kernel konfiguriert ist,
-        kann das Dateisystem als speicherbasiertes Laufwerk
-        eingehängt werden:</para>
+      <para>Das resultierende <acronym>ISO</acronym>-Abbild kann als
+        speicherbasiertes Laufwerk eingehängt werden:</para>
 
       <screen>&prompt.root; <userinput>mdconfig -a -t vnode -f /tmp/bootable.iso -u 0</userinput>
 &prompt.root; <userinput>mount -t cd9660 /dev/md0 /mnt</userinput></screen>
 
       <para>Jetzt können Sie überprüfen, dass
         <filename>/mnt</filename> und <filename>/tmp/myboot</filename>
         identisch sind.</para>
 
-      <para>Sie können das Verhalten von &man.mkisofs.8;
+      <para>Sie können das Verhalten von <command>mkisofs</command>
         mit einer Vielzahl von Optionen beeinflussen.  Details dazu
         entnehmen Sie bitte &man.mkisofs.8;.</para>
+
+      <note>
+        <para>Es ist möglich eine Daten-<acronym>CD</acronym> in eine
+          Datei zu kopieren, die einem Image entspricht, das mit
+          <command>mkisofs</command> erstellt wurde.  Verwenden Sie
+          dazu <command>dd</command> mit dem Gerätenamen als
+          Eingabedatei und den Namen der <acronym>ISO</acronym> als
+          Ausgabedatei:</para>
+
+        <screen>&prompt.root; <userinput>dd if=/dev/<replaceable>cd0</replaceable> of=<replaceable>file.iso</replaceable> bs=2048</userinput></screen>
+
+        <para>Das resultierende Abbild kann auf eine
+          <acronym>CD</acronym> gebrannt werden, wie in <xref
+            linkend="cdrecord"/> beschrieben.</para>
+      </note>
     </sect2>
 
     <sect2 xml:id="duplicating-audiocds">
       <title>Kopieren von Audio-<acronym>CD</acronym>s</title>
 
       <para>Um eine Kopie einer Audio-<acronym>CD</acronym> zu
         erstellen, kopieren Sie die Stücke der <acronym>CD</acronym>
         in einzelne Dateien und brennen diese Dateien dann auf eine
<para>Die kopierten Dateien können Sie dann mit
             sich um Audio-Daten handelt und dass <command>cdrecord</command>
             das Medium am Ende fixieren soll.</para>
           <!--
           Update example for cdrecord
           <screen>&prompt.root; <userinput>burncd -f <replaceable>/dev/acd0</replaceable> audio track1.cdr track2.cdr <replaceable>...</replaceable> fixate</userinput></screen>
           -->
         </step>
       </procedure>
-    </sect2>
-
-    <sect2 xml:id="imaging-cd">
-      <title>Kopieren von Daten-<acronym>CD</acronym>s</title>
-
-      <para>Es ist möglich eine Daten-<acronym>CD</acronym> in eine
-        Datei zu kopieren, die einem Image entspricht, das mit
-        &man.mkisofs.8; erstellt wurde.  Mit Hilfe dieses Images
-        können Sie jede Daten-<acronym>CD</acronym> kopieren.  Das
-        folgende Beispiel verwendet <filename>acd0</filename> für das
-        <acronym>CD-ROM</acronym>-Gerät.  Wird ein anderes Laufwerk
-        benutzt, muss der Name entsprechend ersetzt werden.</para>
-
-      <screen>&prompt.root; <userinput>dd if=/dev/acd0 of=file.iso bs=2048</userinput></screen>
-
-      <para>Danach existiert ein Image, das wie oben beschrieben, auf
-        <acronym>CD</acronym> gebrannt werden kann.</para>
     </sect2>
 
     <sect2 xml:id="mounting-cd">
       <title>Einhängen von Daten-<acronym>CD</acronym>s</title>
 
       <para>Über den Gerätenamen <filename>/dev/cd0</filename> kann
         nun auf das Laufwerk zugegriffen werden.  Um beispielsweise
         eine <acronym>CD-ROM</acronym> in <filename>/mnt</filename>