davfs2 1.4.0 - en to de translation catalogue (3168 entries)

note: type: Plain text
en: B<@CONFIGFILE@> - Configuration file for B<@PROGRAM_NAME@>
de: B<@CONFIGFILE@> - Konfigurationsdatei für B<@PROGRAM_NAME@>

note: type: Plain text
en: There is a system wide configuration file I<@SYS_CONF_DIR@/@CONFIGFILE@> and user configuration files I<~/.@PACKAGE@/@CONFIGFILE@>. When B<@PROGRAM_NAME@> is invoked by root, only the system wide configuration file is read. When invoked by an ordinary user, the user configuration file is read in addition. Settings from the user configuration file will take precedence over the system wide configuration.
de: Es gibt die systemweite Konfigurationsdatei I<@SYS_CONF_DIR@/@CONFIGFILE@> und die Benutzer-Konfigurationsdateien I<~/.@PACKAGE@/@CONFIGFILE@>. Wenn root B<@PROGRAM_NAME@> startet, wird nur die systemweite Konfigurationsdatei gelesen. Bei einem normalen Benutzer wird zusätzlich seine Benutzer-Konfigurationsdatei gelesen. Einstellungen in der Benutzer-Konfigurationsdatei haben Vorrang vor denen in der systemweiten Konfigurationsdatei.

note: type: Plain text
en: The configuration file consists of lines where each line contains a keyword value pair. Keyword and value are seperated by spaces and/or tabs.
de: Jede Zeile der Konfigurationsdatei enthält ein Schlüsselwort und einen Wert, die durch Leerzeichen und/oder Tabulatoren von einander getrennt sind.

note: type: Plain text
en: The file may contain sections that are for one specific mount point only.  Such a section starts with a line, that contains the full path of the mount point enclosed in square brackets. The section ends at the start of the next section or the end of file. Options that shall apply to all mounted file system must come before the first sections. Options given in a mount specific section will have precedence.
de: Die Konfigurationsdatei kann Abschnitte enthalten, die nur für ein bestimmtes Dateisystem gelten. Diese Abschnitte beginnen mit einer Zeile, die nur den vollständigen Pfad des Einhängepunktes, eingeschlossen in eckige Klammern, enthält. Ein solcher Abschnitt endet mit dem Beginn eines neuen Abschnittes oder dem Ende der Datei. Optionen, die für alle Dateisysteme gelten sollen, müssen vor dem ersten solchen Abschnitt stehen.  Optionen in einem Abschnitt für ein bestimmtes Dateisystem haben Vorrang.

note: type: Plain text
en: proxy	foo.bar:8080
de: proxy foo.bar:8080

note: type: Plain text
en: All mounted @PACKAGE@ file systems will use the coda kernel file system and the proxy foo.bar. All @PACKAGE@ file systems expect /media/dav will disable the use of the locks. /home/otto/mywebspace will use the gui_optimize option.
de: Alle @PACKAGE@-Dateisysteme benutzen das Kerneldateisystem fuse und den Proxy foo.bar. Nur in /media/dav werden Sperren benutzt. Für das Dateisystem /home/otto/mywebspace wird die Option gui_optimize eingeschaltet.

note: type: SH
en: GENERAL SYNTAX RULES
de: ALLGEMEINE SYNTAX-REGELN

note: type: Plain text
en: Lines that only contain spaces and tabs (empty lines) are ignored.
de: Leerzeilen werden ignoriert.

note: type: Plain text
en: # indicates a comment. The rest of the line is ignored.
de: # kennzeichnet einen Kommentar. Der Rest der Zeile wird ignoriert.

note: type: Plain text
en: \(rs is the escape character.
de: \(rs ist das Escape-Zeichen und hebt die Sonderfunktion des folgenden Zeichens auf.

note: type: Plain text
en: "" is used for quotation.
de: " wird als Anführungszeichen benutzt.

note: type: Plain text
en: If a value contains one of the special characters space, tab, #, \(rs, or ", this character must be escaped by a preceding \(rs. Use \(cq\(rs\ \(cq instead of \(cq\ \(cq, \(cq\(rs#\(cq instead of \(cq#\(cq, \(cq\(rs\(rs\(cq instead of \(cq\(rs\(cq and \(cq\(rs"\(cq instead of \(cq"\(cq.
de: Wenn ein Wert eines der Sonderzeichen Leerzeichen, Tabulator, #, \(rs oder " enthält, muss diesem Zeichen ein Escape-Zeichen \(rs vorangestellt werden. Also \(cq\(rs\ \(cq statt \(cq\ \(cq, \(cq\(rs#\(cq statt \(cq#\(cq, \(cq\(rs\(rs\(cq statt \(cq\(rs\(cq und \(cq\(rs"\(cq statt \(cq"\(cq.

note: type: Plain text
en: Values containing spaces, tabs or # may instead be enclosed in double quotes.  But " and \(cq must be escaped even within double quotes. If the starting line of a section is enclosed in double quotes, the square brakets must be within the quotes (like "[/home/otto/with space]").
de: Werte, die Lerrzeichen, Tabulatoren oder # enthalten, können stattdessen auch in doppelte Anführungszeichen gesetzt werden. \(rs und " brauchen auch innerhalb eines Ausdrucks in Anführungszeichen ein vorangestelltes Escape-Zeichen. Wenn die Kopfzeile eines Abschnittes in Anführungszeichen gesetzt wird, dann müssen die eckigen Klammern innerhalb der Anführungszeichen stehen (z.B.  "[/home/otto/with space]").

note: type: Plain text
en: Boolean option values (yes/no) must be given as numerical value.  0 for no, 1 for yes.
de: Bei ja/nein-Optionen muss der Wert numerisch angegeben werden. 0 für nein, 1 für ja.

note: type: SH
en: AVAILABLE CONFIGURATION OPTIONS
de: KONFIGURATIONS-OPTIONEN

note: type: SH
en: General Options
de: Allgemeine Optionen

note: type: Plain text
en: When invoked by root the B<@PROGRAM_NAME@> daemon will run as this user.  Value must be given as I<name>, B<not> as numerical id.
de: Wird B<@PROGRAM_NAME@> von root gestartet, läuft der Hintergrundprozess als dieser Benutzer. Es muss der Benutzer-I<Name> angeben werden, nicht die Benutzernummer.

note: type: Plain text
en: Default: @USER@
de: Voreingestellt: @USER@

note: type: Plain text
en: B<Only allowed in the system wide configuration file.>
de: B<Diese Option ist nur in der systemweiten Konfigurationsdatei erlaubt.>

note: type: Plain text
en: The group of the running B<@PROGRAM_NAME@> daemon. Ordinary users must be member of this group in order to mount a @PACKAGE@ file system.  Value must be given as I<name>, B<not> as numerical id.
de: Die Gruppe des B<@PROGRAM_NAME@>-Hintergrundprozesses. Normale Benutzer müssen Mitglieder dieser Gruppe sein, damit sie ein @PACKAGE@-Dateisystem einhängen dürfen. Es muss der Gruppen-I<Name> angeben werden, nicht die Gruppennummer.

note: type: Plain text
en: Default: @GROUP@
de: Voreingestellt: @GROUP@

note: type: Plain text
en: Which kernel file system to use, to integrate into the virtual file system.  Possible values are I<fuse> and I<coda>.
de: Welches Kernel-Dateisystem zur Integration in das virtuelle Dateisystem benutzt wird. Möglich sind I<fuse> und I<coda>.

note: type: Plain text
en: Default: fuse
de: Voreingestellt: fuse

note: type: Plain text
en: Size in KiByte of the buffer used to communicate with the kernel file system.  Only usefull with I<fuse>, where read and write operations may profit from a larger buffer.
de: Größe des Puffers zur Kommunikation mit dem Kernel-Dateisystem in KiByte.  Hat nur einen Effekt, wenn I<fuse> benutzt wird; Schreib- und Leseoperationen können durch einen großen Puffer beschleunigt werden.

note: type: Plain text
en: Default: 16
de: Voreingestellt: 16

note: type: SH
en: WebDAV Related Options
de: WebDAV-Optionen

note: type: Plain text
en: Whether to use a proxy to connect to the WebDAV server. 0 = no, 1 = yes.  If no proxy is defined in the configration file or the environment variables B<https_proxy>, B<http_proxy> and B<all_proxy>, this option has no effect.
de: Ob ein Proxy benutzt werden soll. 0 = nein, 1 = ja. Wenn weder in der Konfigurationsdatei noch in den Umgebungsvariablen B<https_proxy>, B<http_proxy> und B<all_proxy> ein Proxy angegeben ist, hat diese Option keinen Effekt.

note: type: Plain text
en: Default: 1
de: Voreingestellt: 1

note: type: Plain text
en: Name of the proxy. The name must be the fully qualified domain name (no scheme). If the proxy port differs from the default of 8080, it must be appended, seperated by a colon. Examples: I<foo.bar:1704> or I<foo.bar>
de: Der vollständige Domain-Name des Proxy (aber ohne Schema). Wenn der Proxy eine andere Port-Nummer als 8080 benutzt, muss diese, durch einen Doppelpunkt getrennt, angehängt werden. Beispiele: I<foo.bar:1704> oder I<foo.bar>

note: type: Plain text
en: Name of a certificate file in PEM format. The name of the file may be given as absolute path or as file name only. In the latter case the directories I<~/.@PACKAGE@/@CERTS_DIR@> and I<@SYS_CONF_DIR@/@CERTS_DIR@> will be searched.
de: Name einer Datei mit einem Zertifikat im PEM-Format. Der Dateiname kann als absoluter Pfad angegeben werden oder als reiner Dateiname. Im letzteren Fall wird die Datei in den Verzeichnissen I<~/.@PACKAGE@/@CERTS_DIR@> und I<@SYS_CONF_DIR@/@CERTS_DIR@> gesucht.

note: type: Plain text
en: This option is intended for self-signed server certificates. Self-signed means issuer and subject are the same. Common name (CN) must be the domain name of the server.
de: This Option ist für selbstsignierte Server-Zertifikate gedacht. Selbstsigniert bedeutet: der Name des Ausstellers (issuer) und des Eigentümers (subject) sind gleich. Der Common name (CN) muss der Domainname des Servers sein.

note: type: Plain text
en: In case the server certificate is not self-singed, this file must contain the certificate of the certificate authority (CA) that signed the server certificate, not the the server certificate itself. If an hirarchy of CA's is involved (the CA that signed the server certificate is not the root CA), the file must contain all the certificates from the chain of CAs involved, beginning with the CA that signed the server certificate, up to the self-signed certificate of the root CA. (The option name B<servertcert> is a misnomer in this case. Sorry.) You can create the file by concatenating all the CA-certificates involved.
de: Falls das Zertifikat nicht selbstsigniert ist, muss die Datei das Zertifikat der Zertifizierungsstelle (CA) enthalten, die das Zertifikat signiert hat. Falls eine Zertifizierungshierarchie im Spiel ist (der Herausgeber des Zertifikats ist nicht die Root-CA) muss die Datei die Zertifikate aller beteiligten CAs enthalten; beginnend mit der CA, die das Serverzertifikat signiert hat bis hoch zum selbstsignierten Zertifikat der Root-CA. (Die Bezeichnung der Option als B<servertcert> ist in diesem Fall leider irreführend.) Du kannst die Datei erzeugen, indem du alle CA-Zertifikate nacheinander in eine Datei kopierst.

note: type: Plain text
en: B<Note:> Even if the certificate is trusted, that does not mean it is accepted. There is the additional constraint, that the certificate presented by the server must belong to the server. The CN in the server certificate must be the domain name of the server. There is currently no way to automatically accept certificates that don't belong to the server.
de: B<Hinweis:> Auch wenn dem Zertifikat nun vertraut wird, heißt das noch nicht, dass es auch akzeptiert wird. Die zusätzliche Bedingung: das Zertifikat, das der Server vorlegt, muss ihm auch gehören. D.h. der CN im Serverzertifikat muss der Domainname des Servers sein. Im Moment gibt es keine Möglichkeit, Zertifikate automatisch zu akzeptieren, die nicht dem Server gehören.

note: type: Plain text
en: Name of a certificate in PKCS#12 format that will be used to authenticate with the server. The name of the file may be given as absolute path or as file name only. In the latter case the directories I<~/.@PACKAGE@/@CERTS_DIR@/@CLICERTS_DIR@> and I<@SYS_CONF_DIR@/@CERTS_DIR@/@CLICERTS_DIR@> will be searched.
de: Name einer Datei mit einem Zertifikat im PKCS#12-Format, mit dem sich der Benutzer beim Server ausweisen kann. Der Name muss entweder als absoluter Pfad oder als reiner Dateiname angegeben werden. Im letzteren Fall wird in den Verzeichnissen I<~/.@PACKAGE@/@CERTS_DIR@/@CLICERTS_DIR@> und I<@SYS_CONF_DIR@/@CERTS_DIR@/@CLICERTS_DIR@> nach ihr gesucht.

note: type: Plain text
en: Name of a file that holds the credentials for servers and the proxy, and passwords to decrypt the client certificate. The name must be an absolute path. The file must be read and writable by the owner only (mode 600).
de: Name der Datei, die die vertraulichen Zugangsdaten für Server und Proxy enthält, sowie Passwörter zur Entschlüsselung von Client-Zertifikaten.  Der Name muss ein absoluter Pfad sein. Die Datei darf nur für den Eigentümer schreib- und lesbar sein (Dateimodus 600).

note: type: Plain text
en: Default: ~/.@PACKAGE@/@SECRETSFILE@
de: Voreingestellt: ~/.@PACKAGE@/@SECRETSFILE@

note: type: Plain text
en: B<Only allowed in the user configuration file.> The system wide secrets file is allways I<@SYS_CONF_DIR@/@SECRETSFILE@>.
de: B<Diese Option ist nur in den Benutzer-Konfigurationsdateien erlaubt.> Die systemweite Datei für diese Daten ist immer I<@SYS_CONF_DIR@/@SECRETSFILE@>.

note: type: Plain text
en: Ask the user interactively for credentials and passwords if not found in the secretsfile. Ask the user if a servercert cannot be verified. 0 = no, 1 = yes.
de: Frage den Benutzer nach den vertraulichen Zugangsdaten, wenn diese nicht in der secrets-Datei gefunden werden. Frage den Benutzer wenn ein Zertifikat des Servers nicht verifiziert werden kann. 0 = nein, 1 = ja.

note: type: Plain text
en: Whether to lock files on the server when they are opened for writing.  0 = no, 1 = yes.
de: Sperre Dateien auf dem Server, wenn sie zum Schreiben geöffnet werden.  0 = nein, 1 = ja.

note: type: Plain text
en: A string send to the server to identify the owner of a lock. If a WebDAV resource is used at the same time by different clients using the same credentials, different values for lock_owner should be choosen.
de: Dieser Text wird an den Server gesandt, um den Eigentümer einer Sperre zu kennzeichnen. Wenn eine WebDAV-Resource gleichzeitig von mehreren Benutzern mit den gleichen Zugangsdaten benutzt wird, sollten unterschiedliche Werte für lock_owner gewählt werden.

note: type: Plain text
en: Default: the username from the credentials
de: Voreingestellt: der Benutzername aus den Zugangsdaten

note: type: Plain text
en: How long in seconds locks should be valid, before the server removes them.  The server may ignore this and set its own timeout value.
de: Nach dieser Zeit in Sekunden sollte der Server Sperren wieder entfernen.  Der Server hält sich nicht unbedingt daran.

note: type: Plain text
en: Default: 1800
de: Voreingestellt: 1800

note: type: Plain text
en: That many seconds before the lock times out, B<@PROGRAM_NAME@> will try to refresh the lock. The value should be substantially greater than B<delay_upload>.
de: Soviele Sekunden bevor eine Sperre abläuft versucht B<@PROGRAM_NAME@> sie zu erneuern. Der Wert sollte deutlich größer sein als die B<delay_upload>.

note: type: Plain text
en: Default: 60
de: Voreingestellt: 60

note: type: Plain text
en: To avoid uploading big files that will be refused by the server, B<@PROGRAM_NAME@> uses the header I<expect: 100-continue> to get the o.k.  from the server before uploading. Not all servers understand this.  0 = no, 1 = yes.
de: Um nicht große Dateien hochzuladen, die vom Server sowieso abgelehnt werden, benutzt B<@PROGRAM_NAME@> den Header I<expect: 100-continue> um vom Server das o.k. im voraus zu erhalten. Aber nicht alle Server verstehen das. 0 = nein, 1 = ja.

note: type: Plain text
en: Default: 0
de: Voreingestellt: 0

note: type: Plain text
en: Some servers do not handle If-Match and If-None-Match-headers correctly.  This otion tells B<@PROGRAM_NAME@> to use HEAD instead of thes headers.  0 = no, 1 = yes.
de: Manche Server verarbeiten If-Match- und If-None-Match-Header nicht richtig. Dies Option veranlasst B<@PROGRAM_NAME@>, stattdessen HEAD zu benutzen. 0 = nein, 1 = ja.

note: type: Plain text
en: Popular servers send a weak etag whenever they are not able to calculate a strong one. This weak etag will never be valid, but after one second it is silently turned into a strong, valid etag. With this flag set to 1, B<@PROGRAM_NAME@> will never use this weak etags. If the flag is 0, the weakness indicator will be removed and the etag is assumed to be strong. There is some danger of the Lost-Update-Problem with this. But it is minimized when using locks.
de: Weit verbreitete Server senden ein schwaches Etag, wenn sie kein starkes erzeugen können. Dieses schwache Etag ist immer ungültig, wird aber nach einer Sekunde stillschweigend in ein starkes, gültiges Etag verwandelt. Wenn diese Option auf 1 gesetzt ist, wird B<@PROGRAM_NAME@> diese Etags nicht verwenden. Ist diese Option 0, dann wird die Kennzeichnung als schwach entfernt und das Etag wie ein starkes Etag benutzt. Dies beinhaltet  die Gefahr, versehentlich die Änderungen anderer Leute zu überschreiben. Doch diese Gefahr kann durchdie Verwendung von Sperren minimiert werden.

note: type: Plain text
en: You should turn this on, when you can't use locks and there is the danger of concurrent access to the same resource. In this case the etag is not used at all and the resource cannot be cached.
de: Wenn keine Sperren verwendet werden können, und die Gefahr besteht, dass zwei Clients gleichzeitig auf die selbe Resource zugreifen, solltest du diese Option aktivieren. In diesem Fall wird das Etag nicht benutzt und die Resource kann nicht im Cache gespeichert werden.

note: type: Plain text
en: 0 = no, 1 = yes.
de: 0 = nein, 1 = ja.

note: type: Plain text
en: Some servers will only work when they are allowed to set a cookie and this cookie is returned in subsequent requests. This option adds very simple cookie support. It supports just one cookie which should usually be a session ID.  0 = no, 1 = yes.
de: Manche Server verweigern den Dienst, wenn ihnen nicht erlaubt is ein Cookie zu setzen. Diese Option fügt sehr einfche Unterstützung für Cookies hinzu. Es wird nur ein Cookie unterstützt, welches normalerweise eine Session-ID sein sollte. 0 = nein, 1 = ja.

note: type: Plain text
en: If option B<if_match_bug> is set: use HEAD-requests to check for existence or modification of a file to avoid unintended overwriting what somebody else changed. Has no effect if option B<if_match_bug> is 0. You should only set it 0, if there is no concurrent access to the server.  0 = no, 1 = yes.
de: Falls die Option B<if_match_bug> gesetzt ist: teste mit Hilfe von HEAD-Anfragen, ob eine Datei existiert oder geändert wurde, um versehentliches Überschreiben der Änderungen anderer Leute zu vermeiden. Hat keie Wirkung wenn B<if_match_bug> 0 ist. Du solltest die Option nur auf 0 setzen, wenn kein konkurrierender Zugriff auf den Server erfolgt. 0 = nein, 1 = ja.

note: type: Plain text
en: Some servers send wrong information about their capabilities in the DAV-header.  In this case the header should be ignored.
de: Manche Server senden im DAV-Header Fehlinformationen über ihre Fähigkeiten. In diesem Fall sollte man den Header ignorieren.

note: type: Plain text
en: When extracting file names from the path component of the URL, B<@PROGRAM_NAME@> will assume they are encoded using this character set and translate file names to the local character set. This is B<not> about encoding of file contents and B<not> about HTTP escaping rules.
de: Wenn B<@PROGRAM_NAME@> aus der Pfad-Komponente der URL die Dateinamen erzeugt, geht es davon aus, das diese entsprechend diesem Zeichensatz kodiert sind und übersetzt sie in die lokal benutzte Kodierung.  Dies hat B<nichts> zu tun mit der Kodierung des Dateiinhalts und auch B<nichts> mit den HTTP-Escape-Regeln.

note: type: Plain text
en: There is no means in HTTP to know the character encoding of the path component. There may be even different encodings within the same path, as the encoding of file names is often defined by the clients that created them.  Nowadays it is best to use only UTF-8 encoding and to do no conversion. If you are not sure that all clients understand UTF-8, restrict file names to pure us-ascii. Never use characters in file names, that may have a special function on some operating systems (like /, : and \(rs).
de: Es gibt in HTTP keine Möglichekit die Kodierung der Pfad-Komponente zu erfahren. Da die Kodierung von Namen im Pfad meistens von den Clients festgelegt wird, die diese Dateien und Verzeichnisse erzeugen, kann es durchaus vorkommen, dass auch innerhalb eines Pfades unterschiedliche Kodierungen verwendet werden. Heutzutage ist es am besten, ausschließlich die UTF-8-Kodierung zu benutzen und keine Konvertierung vorzunehmen. Wenn du nicht sicher bist, dass alle Clients das verstehen, solltest du Dateinamen auf reines US-ASCII beschränken. Benutze niemals Zeichen, die im Dateisystem eines anderen Betriebssystems eine spezielle Funktion haben (wie z.B. /, : und \(rs).

note: type: Plain text
en: Default: no character set conversion
de: Voreingestellt: die Kodierung wird nicht umgewandelt

note: type: Plain text
en: When creating a TCP connection to the server B<@PROGRAM_NAME@> will wait that many seconds for an answer before assuming an error. If a value of '0' is used then no explicit timeout handling is set and the connect call will only timeout as dictated by the TCP stack.
de: Beim Öffnen einer TCP-Verbindung zum Server wartet B<@PROGRAM_NAME@> so viele Sekunden bevor es einen Fehler annimmt. Bei einem Wert von "0" wird die Feststellung einer Zeitüberschreitung dem TCP-Stack überlassen.

note: type: Plain text
en: This parameter only takes effect if the version of neon in use (neon version E<gt> 0.26) and the OS support non-blocking I/O.
de: Dieser Parameter zeigt nur Wirkung, wenn die verwendete Neon-Version (Version E<gt> 0.26) und das Betriebssystem nicht-blockierende Ein-Ausgabe-Operationen unterstützen.

note: type: Plain text
en: Default: 10
de: Voreingestellt: 10

note: type: Plain text
en: How long in seconds B<@PROGRAM_NAME@> will wait for an answer from the server before assuming an error.
de: B<@PROGRAM_NAME@> wird so viele Sekunden auf die Antwort des Servers warten, bevor es einen Fehler annimmt.

note: type: Plain text
en: Default: 30
de: Voreingestellt: 30

note: type: Plain text
en: When B<@PROGRAM_NAME@> can not reach the server it will try again after B<retry> seconds. For subsequent retries the interval will be increased up to B<max_retry> seconds.
de: Wenn B<@PROGRAM_NAME@> den Server nicht erreichen kann, wird es es nach B<retry> Sekunden nochmal versuchen. Bei weiteren Versuchen wird es diese Zeit schrittweise bis auf B<max_retry> Sekunden erhöhen.

note: type: Plain text
en: Maximum value of the retry interval.
de: Maximales retry-Intervall.

note: type: Plain text
en: Default: 300
de: Voreingestellt: 300

note: type: Plain text
en: When uploading a changed file fails temporarily B<@PROGRAM_NAME@> will retry with increasing intervals, but not more often than this.
de: Schlägt das Speichern einer geänderten Datei wegen eines nicht dauerhaften Problems fehl, versucht es B<@PROGRAM_NAME@> mit größer werdenden Intervallen immer wieder, aber höchsten so oft.

note: type: Plain text
en: With a bad connection this will cause additional traffic. To reduce traffic caused by unsuccessful attempts option B<use_expect100> can be set. But please test it. Most proxies and some servers don't support this header.
de: Bei einer schlechten Verbindung verursacht dies zusätzlichen Datenverkehr. Durch die Option B<use_expect100> kann das Datenaufkommen durch fehlgeschlagene Versuche reduziert werden. Aber bitte erst testen. Die meisten Proxies und manche Server unterstützen diesen Header nicht.

note: type: Plain text
en: Default: 15
de: Voreingestellt: 15

note: type: Plain text
en: Your server might expect special headers to do what you want. Different from other options, this one takes two values: the name of the header and its value.  Some ASP-backends to IIS seem to require the Microsoft specific header "Translate: F". You can add it like this:
de: Unter Umständen benötigt dein Server spezielle Header um zu tun was er soll. Diese Option benötigt, anders als andere Optionen, zwei Werte: den Namen des Headers und seinen Wert. Einige ASP-Backends des IIS scheinen den Microsoft spezifischen Header "Translate: F" zu benötigen. Du kannst in folgendermaßen hinzu fügen:

note: type: Plain text
en: B<@PROGRAM_NAME@> will add header "Translate: F" on all requests.
de: B<@PROGRAM_NAME@> sendet nun den Header "Translate: F" bei allen Anfragen mit.

note: type: Plain text
en: This option is cumulative. You can enter more than one add_header option and all of them will be added. Also add_header options from @SYS_CONF_DIR@/@CONFIGFILE@ and ~/.@PACKAGE@/@CONFIGFILE@ are merged.
de: Diese Option kann mehrmals angegeben werden. Alle angegebenen Header werden bei Anfragen mitgesandt. Sowohl die add_header Optionen aus @SYS_CONF_DIR@/@CONFIGFILE@, als auch die aus ~/.@PACKAGE@/@CONFIGFILE@ werden angewandt.

note: type: SH
en: Cache Related Options
de: Cache-Optionen

note: type: Plain text
en: Each mounted @PACKAGE@ file system has a directory to store backups of files that could not be stored back to the server. This sets the name of this directory. You should regularly check this directory.
de: Jedes @PACKAGE@-Dateisystem hat ein Verzeichnis mit diesem Namen. In ihm werden Dateien gespeichert, die nicht auf den Server zurück gesichert werden konnten. Du solltest dieses Verzeichnis öfter mal überprüfen.

note: type: Plain text
en: Default: lost+found
de: Voreingestellt: lost+found

note: type: Plain text
en: The directory where B<@PROGRAM_NAME@> will store cached files. For every mount point a subdirectory will be created.
de: In diesem Verzeichnis speichert B<@PROGRAM_NAME@> die Dateien zwischen.  Für jedes Dateisystem wird darin ein Unterverzeichnis angelegt.

note: type: Plain text
en: In the systemwide configuration file this will set the system wide cache, used by root. In a users configuration file it will set the cache used by this user.
de: In der systemweiten Konfigurationsdatei wird das Verzeichnis festgelegt, das von root benutzt wird. In einer Benutzer-Konfigurationsdatei das Verzeichnis, das von diesem Benutzer benutzt wird

note: type: Plain text
en: Defaults: @SYS_CACHE_DIR@ and ~/.@PACKAGE@/cache
de: Voreingestellt: @SYS_CACHE_DIR@ und ~/.@PACKAGE@/cache

note: type: Plain text
en: The amount of disk space in MiByte that may be used. B<@PROGRAM_NAME@> will always take enough space to cache open files, ignoring this value if necessary.
de: Der Platz auf der Festplatte in MiByte, der für den Cache zur Verfügung steht. B<@PROGRAM_NAME@> nimmt sich immer genug Platz für alle offenen Dateien auch wenn dieser Wert überschritten wird.

note: type: Plain text
en: Default: 50
de: Voreingestellt: 50

note: type: Plain text
en: B<@PROGRAM_NAME@> maintains a hash table with an entry for each known file or directory. This gives the number of entries in this table. For large file systems (more than some hundreds of files) increasing this number may speed up file operations. The value should be a power of 2.
de: Die Anzahl der Plätze in einer Hash-Tabelle, die B<@PROGRAM_NAME@> für alle bekannten Dateien und Verzeichnisse führt.  Bei großen Dateisystemen (mehr als einige Hundert Dateien) kann ein größerer Wert die Dateioperationen beschleunigen. Der Wert sollte eine Zweierpotenz sein.

note: type: Plain text
en: Default: 1024
de: Voreingestellt: 1024

note: type: Plain text
en: After B<@PROGRAM_NAME@> has got information about files in a directory it considers it valid for this time in seconds. Note: This does not affect opening of files and reading a directory by an application.
de: B<@PROGRAM_NAME@> betrachtet Informationen über Dateien in einem Verzeichnis so viele Sekunden als gültig. Hinweis: Dies gilt nicht beim Öffnen einer Datei oder wenn eine Anwendung den Inhalt eines Verzeichnisses liest.

note: type: Plain text
en: When a file or directory is opened by an application, B<@PROGRAM_NAME@> will first check the server for a newer version. But some applications do open calls on the same file in short sequence. To avoid unecessary traffic B<@PROGRAM_NAME@> will wait that many seconds before it send a new request for the same information.
de: Wenn eine Anwendung eine Datei oder ein Verzeichnis öffnet, wird B<@PROGRAM_NAME@> zuerst auf dem Server nachfragen, ob eine neuere Version vorliegt. Manche Anwendungen öffnen dieselbe Dateien in schneller Folge.  Um unnötigen Netzwerkverkehr zu vermeiden, wird B<@PROGRAM_NAME@> erst nach dieser Zeit in Sekunden dieselbe Information erneut anfragen.

note: type: Plain text
en: When a file that has been changed is closed, B<@PROGRAM_NAME@> will wait that many seconds before it will upload it to the server. This will avoid uploading of temporary files that will be removed immediately after closing.  If you need the files to appear on the server immediately after closing, set this option to 0.
de: Wenn eine geänderte Datei geschlossen wird, wartet B<@PROGRAM_NAME@> so viele Sekunden, bevor es die Datei auf den Server hochlädt. Dies verhindert, dass temporäre Dateien zum Server übertragen werden, nur um sofort danach gelöscht zu werden. Wenn es nötig ist, dass die Dateien sofort nach dem Schließen auf dem Server erscheinen, kann diese Option auf 0 gesetzt werden.

note: type: Plain text
en: When a file is opened, B<@PROGRAM_NAME@> will have to check the server whether there is a newer version. Graphical User Interfaces tend to open just any file, slowing down things dramatically for large directories.  With this option B<@PROGRAM_NAME@> will try to get this information from all files in a directory with one PROPFIND request. 0 = no, 1 = yes.
de: Immer wenn eine Datei geöffnet wird, muss B<@PROGRAM_NAME@> beim Server nachfragen, ob eine neuere Version vorliegt. Grafische Benutzeroberflächen neigen dazu, alle Dateien zu öffnen, was bei großen Verzeichnissen die Reaktionszeit des Dateisystem gewaltig erhöht. Mit dieser Option versucht B<@PROGRAM_NAME@> diese Abfrage für alle Dateien eines Verzeichnisses mit einem PROPFIND-Request zu erledigen. 0 = nein, 1 = ja.

note: type: SH
en: Debugging Options
de: Debugging Optionen

note: type: Plain text
en: Send debug messages to the syslog daemon. The value tells what kind of information shall be logged. The messages are send with facility LOG_DAEMON and priority LOG_DEBUG. It depends from the configuration of the syslog daemon where the messages will go (propably /var/log/messages, /var/log/syslog or /var/log/daemon.log). Whether HTTP related debug messages are available depends on your neon library.
de: Schickt Debug-Meldungen and den Syslog-Dämon. Der Wert legt die Art der Informationen fest. Die Meldungen werden mit facility LOD_DAEMON und Priorität LOG_DEBUG gesandt. In welche Log-Datei sie gehen, hängt von der Konfiguration des Syslog-Dämons ab (vermutlich /var/log/messages, /var/log/syslog oder /var/log/daemon.log). Ob Debug-Meldungen zu HTTP möglich sind, hängt von der Neon-Bibliothek ab.

note: type: Plain text
en: Unlike other options, this option is cumulative. If there are several debug entries with different values, all of them will be applied. Also debug options from @SYS_CONF_DIR@/@CONFIGFILE@ and ~/.@PACKAGE@/@CONFIGFILE@ are merged.
de: Diese Option kann mehrmals angegeben werden, und die angegebenen Werte ergänzen sich und sind alle wirksam. Es werden sowohl die debug-Optionen aus @SYS_CONF_DIR@/@CONFIGFILE@, als auch die aus ~/.@PACKAGE@/@CONFIGFILE@ angewandt.

note: type: Plain text
en: B<Note:> Debug messages let the log-files grow quickly. Never use this option in normal operation of mount.davfs.
de: B<Hinweis:> Debug-Meldungen lassen die Log-Dateien sehr schnell anwachsen. Verwende die Option niemals im normalen Betrieb.

note: type: Plain text
en: Default: no debugging messages
de: Voreinstellung: keine Debug-Meldungen.

note: type: TP
en: B<Recognized values:>
de: B<Mögliche Werte>

note: type: Plain text
en: Command line and configuration options.
de: Kommando-Zeile und Kofigurationsoptionen.

note: type: Plain text
en: Upcalls from the kernel file system.
de: Anfragen vom Kernel-Dateisystem.

note: type: Plain text
en: Cache operations like adding and removing nodes.
de: Cache-Operationen wie das Erzeugen und Löschen von Dateien und Verzeichnissen.

note: type: Plain text
en: HTTP headers.
de: HTTP-Header.

note: type: Plain text
en: Parsing of the XML-body of WebDAV-requests.
de: Analysieren von XML-Daten in WebDAV-Anfragen.

note: type: Plain text
en: Negotiation of authentication.
de: Aushandeln der Authentifizierung.

note: type: Plain text
en: Information about locks.
de: Informationen über Sperren.

note: type: Plain text
en: TLS/SSL related stuff like certificates.
de: TLS/SSL-Informatinen, z.B. Zertifikate.

note: type: Plain text
en: Complete body of HTTP-responses.
de: Der komplette Datenteil von HTTP-Antworten.

note: type: Plain text
en: Also print confidential information, which is usually omitted or obscured.
de: Gib auch vertrauliche Daten aus, die normalerweise weg gelassen werden.

note: type: Plain text
en: Includes config, kernel, cache and http.
de: Beinhaltet config, kernel, cache und http.

note: type: Plain text
en: This man page was written by by Werner Baumann E<lt>werner.baumann@onlinehome.deE<gt>.
de: Dieses Handbuch hat Werner Baumann E<lt>werner.baumann@onlinehome.deE<gt> geschrieben.

note: type: Plain text
en: @PROGRAM_NAME@ - Mount a WebDAV resource in a directory
de: @PROGRAM_NAME@ - Hängt eine WebDAV-Resource ins Dateisystem ein

note: type: SH
en: SYNOPSIS (root only)
de: ÜBERSICHT (nur für root)

note: type: Plain text
en: B<@PROGRAM_NAME@> allows you to mount the WebDAV resource identified by I<webdavserver> into the local filesystem at I<dir.> WebDAV is an extension to HTTP that allows remote, collaborative authoring of Web resources, defined in RFC 4918.  B<@PROGRAM_NAME@> is part of B<@PACKAGE@>.
de: B<@PROGRAM_NAME@> hängt die WebDAV-Resource I<webdavserver> in das Verzeichnis I<dir> des lokalen Dateisystems ein.  WebDAV (RFC 4918) ist eine HTTP-Erweiterung, die die gemeinsame Bearbeitung von Web-Resourcen aus der Ferne erlaubt.  B<@PROGRAM_NAME@> ist Teil des B<@PACKAGE@>-Packets.

note: type: Plain text
en: B<@PACKAGE@> allows documents on a remote Web server to be edited using standard applications. For example, a remote Web site could be updated in-place using the same development tools that initially created the site.  Or you may use a WebDAV resource for documents you want to access and edited from different locations.
de: B<@PACKAGE@> erlaubt es, Dokumente auf einem Webserver mit Standardanwendungen zu bearbeiten, die dafür keine WebDAV-Erweiterungen benötigen. Z.B. könnte eine Web-Site auf einem entfernten Webserver mit den gleichen Werkzeugen bearbeitet werden, mit denen sie erstellt wurde.  Oder man kann auf einem WebDAV-Server Dokumente speichern, die man von verschiedenen Orten aus bearbeiten will.

note: type: Plain text
en: B<@PACKAGE@> supports B<TLS/SSL> (if the neon library supports it) and proxies. B<@PROGRAM_NAME@> runs as a daemon in userspace. It integrates into the virtual file system by either the coda or the fuse kernel files system.  Currently CODA_KERNEL_VERSION 3 and FUSE_KERNEL_VERSION 7 are supported.
de: B<@PACKAGE@> unterstützt B<TLS/SSL> (falls die Neon-Bibliothek es unterstützt) und Verbindungen über einen Proxy. Es wird über das coda oder das fuse Kernel-Dateisystem in das virtuelle Dateisystem eingebunden.  Derzeit werden CODA_KERNEL_VERSION 3 und FUSE_KERNEL_VERSION 7 unterstützt.

note: type: Plain text
en: B<@PROGRAM_NAME@> is usually invoked by the B<mount>(8) command when using the I<-t davfs> option. After mounting it runs as a daemon. To unmount the B<umount>(8) command is used.
de: B<@PROGRAM_NAME@> wird normalerweise durch das B<mount>(8)-Programm aufgerufen, wenn der Parameter I<-t davfs> angegeben ist. Nach dem Einhängen läuft es als Hintergrundprozess. Zum Aushängen wird das B<umount>(8)-Programm benutzt.

note: type: Plain text
en: I<webdavserver> is the URL of the server. It must at least contain the host name. It may additionally contain the scheme, the port and the path.  Missing components are set to sensible default values. The path component must B<not> be %-encoded, but when entering the URL at the command line or in /etc/fstab the escaping rules of the shell or fstab must be obeyed.
de: I<webdavserver> ist die URL des Servers. Sie muss mindestens den Host-Namen enthalten. Zusätzlich können das Schema, die Portnummer und der Pfad enthalten sein. Für fehlende Komponenten werden sinnvolle Standardwerte eingesetzt. Die Pfad-Komponente darf B<nicht> in %-kodierter Form sein. Wird die URL jedoch an der Kommandozeile oder in die fstab eingegeben, müssen die Escape-Regeln der Shell bzw. der fstab beachtet werden.

note: type: Plain text
en: I<dir> is the mountpoint where the WebDAV resource is mounted on.  It may be an absolute or relative path.
de: I<dir> ist der Einhängepunkt. Es kann eine absolute oder relative Pfadangabe sein.

note: type: Plain text
en: I<fstab> may be used to define mounts and mount options as usual. In place of the device the url of the WebDAV server must be given. There must not be more than one entry in I<fstab> for every mountpoint.
de: I<fstab> kann wie gewohnt benutzt werden, um Dateisysteme anzugeben. Im ersten Feld muss anstelle des Gerätes die URL des WebDAV-Servers angegeben werden. Für jeden Einhängepunkt darf es nur einen Eintrag in I<fstab> geben.

note: type: Plain text
en: Output version.
de: Zeige die Version an.

note: type: Plain text
en: Print a help message.
de: Zeige einen Hilfe-Text an.

note: type: Plain text
en: A comma-separated list defines mount options to be used. Available options are:
de: Eine durch Kommas unterteilte Liste von Optionen. Mögliche Optionen sind:

note: type: Plain text
en: Can (not) be mounted with B<mount -a>.
de: Kann (nicht) mit B<mount -a> eingehängt werden.

note: type: Plain text
en: Default: B<auto>.
de: Voreinstellung: B<auto>.

note: type: TP
en: B<conf=>I<absolute path>
de: B<conf=>I<absoluter Pfad>

note: type: Plain text
en: An alternative user configuration file. This option is intended for cases where the default user configuration file in the users home directory can not be used.
de: Eine alternative Benutzer-Konfigurationsdatei für den Fall, dass die Standard-Konfigurationsdatei im Home-Verzeichnis des Benutzers nicht verwendet werden kann.

note: type: Plain text
en: Default: I<~/.@PACKAGE@/@CONFIGFILE@>
de: Voreinstellung: I<~/.@PACKAGE@/@CONFIGFILE@>

note: type: Plain text
en: (Do not) interpret character or block special devices on the file system.  This option is only included for compatibility with the B<mount>(8)  program. It will allways be set to B<nodev>
de: In einem davfs2-Dateisystem sind grundsätzlich keine Gerätedateien (device special files) möglich. Diese Option ist nur wegen der Kompatibilität mit B<mount>(8) vorhanden und wird immer auf B<nodev> gesetzt.

note: type: Plain text
en: The default mode bits for directories in the mounted file system. Value given in octal. s-bits for user and group are allways silently ignored.
de: Standardwert für die Dateirechte von Verzeichnissen in oktaler Schreibweise. s-Bits für den Eigentümer und die Gruppen werden stillschweigend ignoriert.

note: type: Plain text
en: Default: calculated from the umask of the mounting user; an x-bit is associated to every r-bit in u-g-o.
de: Voreinstellung: wird aus der umask des Benutzers abgeleitet.  Wenn ein r-Bit gesetzt ist, wird auch das entsprechende x-Bit gesetzt.

note: type: Plain text
en: (Do not) allow execution of any binaries on the mounted file system.
de: Die Ausführung von Programm-Dateien ist (nicht) erlaubt

note: type: Plain text
en: Default: B<exec>. (When mounting as an ordinary user, the B<mount>(8)  program will set the default to B<noexec>.)
de: Voreinstellung: B<exec>. (Bei einem normalen Benutzer gibt B<mount>(8) als Voreinstellung B<noexec> vor.)

note: type: Plain text
en: The default mode bits for files in the mounted file system. Value given in octal. s-bits for user and group are allways silently ignored.
de: Standardwert für die Dateirechte von normalen Dateien in oktaler Schreibweise. s-Bits für den Eigentümer und die Gruppen werden stillschweigend ignoriert.

note: type: Plain text
en: Default: calculated from the umask of the mounting user; no x-bits are set for files.
de: Voreinstellung: wird aus der umask des Benutzers abgeleitet; es werden keine x-Bits gesetzt.

note: type: Plain text
en: The group the mounted file system belongs to. It may be a numeric ID or a group name. The mounting user, if not root, must be member of this group.
de: Das Dateisystem gehört zu dieser Gruppe. Es kann die Nummer der Gruppe oder der Name angegeben werden. Der Benutzer, der das Dateisystem einhängt, muss Mitglied dieser Gruppe sein, es sei denn er ist root.

note: type: Plain text
en: Default: the primary group of the mounting user.
de: Voreinstellung: die primäre Gruppe des Benutzers.

note: type: Plain text
en: The file system needs a (no) network connection for operation. This information allows the operating system to handle the file system properly at system start and when the network is shut down.
de: Das Dateisystem benötigt (k)eine Netzwerkverbindung. Diese Information erlaubt es dem Betriebssystem, das Dateisystem beim Systemstart und beim Herunterfahren des Netzwerks angemessen zu behandeln.

note: type: Plain text
en: Default: B<_netdev>
de: Voreinstellung: B<_netdev>

note: type: Plain text
en: Mount the file system read-only.
de: Das Dateisystem erlaubt nur Lese-Zugriffe.

note: type: Plain text
en: Default: B<rw>.
de: Voreinstellung: B<rw>.

note: type: Plain text
en: Mount the file system read-write.
de: Auf das Dateisystem kann lesend und schreibend zugegriffen werden.

note: type: Plain text
en: Do not allow set-user-identifier or set-group-identifier bits to take effect.  This option is only included for compatibility with the mount program. It will allways be set to B<nosuid>.
de: In @PACKAGE@-Dateisystemen sind grundsätzlich keine s-Bits für den Besitzer und die Gruppe erlaubt. Die Option ist nur zwecks Kompatibilität mit B<mount>(8) vorhanden und wird immer auf B<nosuid> gesetzt.

note: type: Plain text
en: (Do not) allow an ordinary user to mount the file system. The name of the mounting user is written to I<mtab> so that he can unmount the file system again. Option B<user> implies the options B<noexec>, B<nosuid> and B<nodev> (unless overridden by subsequent options). This option makes only sense when set in I<fstab>.
de: Erlaube einem normalen Benutzer (nicht) das Dateisystem einzuhängen. Der Name des Benutzers wird in die I<mtab> geschrieben, damit er das Dateisystem wieder aushängen kann. Die Option B<user> zieht die Optionen B<noexec>, B<nosuid> und B<nodev> nach sich, falls diese nicht explizit anders gesetzt werden. Diese Option hat nur in der I<fstab> einen Sinn.

note: type: Plain text
en: Default: ordinary users are not allowed to mount.
de: Voreinstellung: normale Benutzer dürfen nicht mounten.

note: type: Plain text
en: Like B<user>, but B<any> user is allowed to unmount the file system, not only the mounting user. This is generally not recomended.  On systems with no I<mtab> file with the B<user> option unmounting by the mounting user will fail. In this case the B<users> may be an appropriate work around.
de: Wie B<user>, aber B<jeder> Benutzer darf das Dateisystem wieder aushängen. Dies wird im Allgemeinen nicht empfohlen. Auf Systemen ohne I<mtab>-Datei kann der Benutzer bei Verwendung der B<user>-Option das Dateisystem nicht mehr aushängen. In diesem Fall kann die B<users>-Option sinnvoll sein.

note: type: Plain text
en: Default: only the mounting user is allowed to unmount the file system.
de: Voreinstellung: nur der Benutzer, der das Dateisystem einghängt hat, darf es wieder aushängen.

note: type: Plain text
en: The owner of the mounted file system. It may be a numeric ID or a user name.  Only when mounted by root, this may be different from the mounting user.
de: Der Beseitzer des Dateisystems. Kann als numerische Benutzerkennung oder als Name angegeben werden. Nur wenn root das Dateisystem einhängt, darf sie von der Benutzerkennung des Benutzers abweichen, der das Dateisystem einhängt.

note: type: Plain text
en: Default: ID of the mounting user.
de: Voreinstellung: Kennung des Benutzers.

note: type: Plain text
en: Use this name to authenticate with the WebDAV server. This option is intended for use with pam_mount only. When this option is set the credentials in the secrets files will be ignored. The password will always be read from stdin, even when option I<askauth> is set to 0.  Do not use it in I<fstab>. The username will be visible for everyone in the output of I<ps>.
de: Dieser Name wird zur Anmeldung beim WebDAV-Server benutzt. Die Option ist nur für den Gebrauch mit pam_mount gedacht. Wenn sie gesetzt ist, werden die Anmaldedaten in der secrets-Datei ignoriert. Das Passwort wird immer von stdin eingelesen, auch wenn die Option I<askauth> auf 0 gesetzt ist. Benutze die Option nicht in der I<fstab>. Der Benutzername ist in der Ausgabe von I<ps> für jedermann sichtbar.

note: type: Plain text
en: Default: no username.
de: Voreingestellt: kein username

note: type: Plain text
en: B<Experimental:> This option is experimental and might be removed. If you think it useful and successfully use it please send a short report.
de: B<Experimentell:> Diese Option ist experimentell und wird möglicherweise wieder entfernt. Falls du sie erfolgreich verwendest und behalten möchtest, sende bitte einen kurzen Bericht.

note: type: SH
en: SECURITY POLICY
de: SICHERHEITSREGELN

note: type: Plain text
en: B<@PROGRAM_NAME@> needs root privileges for mounting. But running a daemon, that is connected to the internet, with root privileges is a security risk. So B<@PROGRAM_NAME@> will change its uid and gid when entering daemon mode.
de: Um ein Dateisystem einzuhängen, braucht B<@PROGRAM_NAME@> root-Rechte. Aber es ist ein Sicherheitsrisiko, einen Hintergrundprozess, der mit dem Internet verbunden ist, mit root-Rechten laufen zu lassen. Deshalb ändert B<@PROGRAM_NAME@> seine Benutzer- und Gruppenkennung, wenn es in den Hinterdrund wechselt.

note: type: Plain text
en: When invoked by root B<@PROGRAM_NAME@> will run as user B<@USER@> and group B<@GROUP@>. This may be changed in I<@SYS_CONF_DIR@/@CONFIGFILE@>.
de: Wenn B<@PROGRAM_NAME@> von root gestartet wird, läuft es als Benutzer B<@USER@> und Gruppe B<@GROUP@>. Dies kann in I<@SYS_CONF_DIR@/@CONFIGFILE@> geändert werden.

note: type: Plain text
en: When invoked by an ordinary user it will run with the id of this user and with group B<@GROUP@>.
de: Wenn es von einem normalen Benutzer gestartet wird, läuft es mit dessen Benutzerkennung und Gruppe B<@GROUP@>.

note: type: Plain text
en: As the file system may be mounted over an insecure internet connection, this increases the risk that malicious content may be included in the file system. So B<@PROGRAM_NAME@> is slightly more restrictive than B<mount>(8).
de: Da das Dateisystem über eine unsichere Internet-Verbindung angebunden sein kann, ist das Risiko erhöht, dass darin Dateien mit schädlichem Inhalt sind.  Deshalb hat B<@PROGRAM_NAME@> etwas stärkere Einschränkungen als B<mount>(8).

note: type: Plain text
en: Options B<nosuid> and B<nodev> will always be set; even root can not change this.
de: Die Optionen B<nosuid> und B<nodev> werden immer gesetzt; das kann auch root nicht ändern.

note: type: Plain text
en: For ordinary users to be able to mount, they must be member of group B<@GROUP@> and there must be an entry in I<fstab>.
de: Damit normale Benutzer ein Dateisystem einhängen können, müssen sie der Gruppe B<@GROUP@> angehören und es muss durch einen Eintrag in der I<fstab> erlaubt werden.

note: type: Plain text
en: When the mount point given in I<fstab> is a relative file name and the file system is mounted by an unprivileged user, the mount point must lie within the home directory of the mounting user.
de: Wenn in 
    Ifstab
    P ein relativer Dateiname als Einhängepunkt angegeben ist und ein normaler Benutzer ein Dateisystem einhängt, muss der Einhängepunkt innerhalb des Home-Verzeichnisses dieses Benutzers liegen.

note: type: Plain text
en: If in I<fstab> option B<uid> and/or B<gid> are given, an ordinary user can only mount, if her uid is the one given in option B<uid> and he belongs to the group given in option B<gid>.
de: Wenn in der I<fstab> die Optionen B<uid> und/oder B<gid> angegeben sind, kann ein normaler Benutzer das Dateisystem nur einhängen, wenn es seine Benutzerkennung ist und wenn er zur angegebenen Gruppe gehört.

note: type: Plain text
en: B<WARNING:> If root allows an ordinary user to mount a file system (using I<fstab>) this includes the permission to read the associated B<credentials> from I<@SYS_CONF_DIR@/@SECRETSFILE@> as well as the B<private key> of the associated B<client certificate> and the mounting user may get access to this information. You should only do this, if you might as well give this information to the user directly.
de: B<WARNHINWEIS:> Wenn root durch einen Eintrag in der I<fstab> einem normalen Benutzer erlaubt, ein Dateisystem einzuhängen, dann erlaubt er ihm damit auch, die dazu gehörigen B<vertraulichen Zugangsdaten> aus der Datei I<@SYS_CONF_DIR@/@SECRETSFILE@> zu lesen, sowie den nötigen B<privaten Schlüssel> des dazu gehörigen B<Client-Zertifikats>.  Das sollte man nur tun, wenn man diese Informationen dem Benutzer auch direkt geben würde.

note: type: SH
en: URLS AND MOUNT POINTS WITH SPACES
de: URLS UND EINHÄNGEPUNKTE MIT LEERZEICHEN

note: type: Plain text
en: Special characters like spaces in pathnames are a mess. They are interpreted differently by different programs and protocols, and there are different rules for escaping.
de: Zeichen mit Sonderfunktion, wie z.B. das Leerzeichen, in Pfadangaben sind Mist. Unterschiedliche Programme und Protokolle interpretieren sie unterschiedlich und haben unterschiedliche Escape-Regeln.

note: type: Plain text
en: In I<fstab> spaces must be replaced by a three digit octal escape sequence. Write I<http://foo.bar/path\(rs040with\(rs040spaces> instead of I<http://foo.bar/path with spaces>. It might also be necessary to replace the '#'-character by \(rs043.
de: In der I<fstab> müssen Leerzeichen durch den dreistelligen oktalen Zeichencode mit vorangestelltem Escape-Zeichen ersetzt werden. Also z.B.  I<http://foo.bar/path\(rs040with\(rs040spaces> anstelle von I<http://foo.bar/path with spaces>. Möglicherweise muss auch das #-Zeichen durch \(rs043 ersetzt werden.

note: type: Plain text
en: For the I<@CONFIGFILE@> and the I<@SECRETSFILE@> files please see the escape and quotation rules described in the B<@CONFIGFILE@>(5) man page.
de: Für die Dateien I<@CONFIGFILE@> und I<@SECRETSFILE@> sind die Regeln im B<@CONFIGFILE@>(5)-Handbuch beschrieben.

note: type: Plain text
en: On I<command line> you must obey the escaping rules of the shell.
de: Auf der Kommandozeile müssen die Regeln der Shell beachtet werden.

note: type: SH
en: CACHING
de: CACHE

note: type: Plain text
en: B<@PROGRAM_NAME@> tries to reduce HTTP-trafic by caching and reusing data.  Information about directories and files are held in memory, while downloaded files are cached on disk.
de: B<@PROGRAM_NAME@> versucht den Netzwerkverkehr durch Verwendung eines Cache zu verringern. Informationen über Verzeichnisse werden im Hauptspeicher gehalten und heruntergeladene Dateien werden auf der Festplatte gespeichert.

note: type: Plain text
en: B<@PROGRAM_NAME@> will consider cached information about directories and file attributes valid for a configurable time and look up this information on the server only after this time has expired (or there is other evidence that this information is stale). So if somebody else creates or deletes files on the server it may take some time before the local file system reflects this.
de: B<@PROGRAM_NAME@> betrachtet Informationen über Verzeichnisse und Dateiattribute für eine (konfigurierbare) Zeit als gültig. Es holt diese Informationen nur dann erneut vom Server, wenn diese Zeit abgelaufen ist oder es andere Hinweise hat, dass die Informationen sich geändert haben. Wenn jemand anderes auf dem Server eine Datei neu anlegt oder löscht, kann es deshalb etwas dauern, bis dies im lokalen Dateisystem sichtbar wird.

note: type: Plain text
en: This will not affect the content of files and directory listings. Whenever a file is opened, the server is looked up for a newer version of the file.  Please consult the manual B<@CONFIGFILE@>(5) to see how can you configure this according your needs.
de: Dies betrifft nicht den Inhalt von Dateien und die Auflistung von Verzeichnisinhalten. Wenn eine Datei geöffnet wird, wird immer der Server nach einer evtl. neuen Version gefragt. Im B<@CONFIGFILE@>(5)-Handbuch finden sich Hinweise, wie dies angepasst werden kann.

note: type: SH
en: LOCKS, LOST UPDATE PROBLEM AND BACKUP FILES
de: SPERREN, VERLORENGEGANGENE ÄNDERUNGEN UND BACKUP-DATEIEN

note: type: Plain text
en: WebDAV introduced locks and B<@PROGRAM_NAME@> uses them by default. This will in most cases prevent two people from changing the same file in parallel. But not allways:
de: Mit WebDAV wurden Sperren eingefürht und B<@PROGRAM_NAME@> benutzt diese standardmäßig. Normalerweise verhindern diese, dass zwei Leute gleichzeitig die selbe Datei ändern. Aber nicht immer:

note: type: Plain text
en: You might have disabled locks in I<@SYS_CONF_DIR@/@CONFIGFILE@> or I<~/.@PACKAGE@/@CONFIGFILE@>.
de: In I<@SYS_CONF_DIR@/@CONFIGFILE@> oder I<~/.@PACKAGE@/@CONFIGFILE@> könnten die Sperren deaktiviert sein.

note: type: Plain text
en: The server might not support locks (they are not mandatory).
de: Möglicherweise unterstützt der Server keine Sperren (sie sind in WevDAV nicht zwingend vorgeschrieben).

note: type: Plain text
en: A bad connection might prevent B<@PROGRAM_NAME@> from refreshing the lock in time.
de: Durch eine schlechte Netzwerkverbindung könnte das rechtzeitige Erneuern einer Sperre verhindert werden.

note: type: Plain text
en: Another WebDAV-client might use your lock (that is not too difficult and might even happen without intention).
de: Ein anderer WebDAV-Client könnte deine Sperre benutzen (das ist nicht schwierig und könnte auch aus Versehen geschehen).

note: type: Plain text
en: B<@PROGRAM_NAME@> will therefore check if the file has been changed on the the server before it uploads a new version. If it finds it impossible to upload the locally changed file, it will store it in the local backup direcotry I<lost+found>. You should check this directory from time to time and decide what to do with this files.
de: B<@PROGRAM_NAME@> prüft deshalb, ob sich eine Datei auf dem Server geändert hat, bevor es eine neue Version hochlädt. Wenn es nicht möglich ist, eine lokal geänderte Datei auf den Server hochzuladen, wird sie im Backup-Verzeichnis I<lost+found> gespeichert. Du solltest dieses Verzeichnis ab und zu überprüfen und entscheiden, was mit diesen Dateien zu tun ist.

note: type: Plain text
en: Sometimes locks held by some client on the server will not be released. Maybe the client crashes or the network connection fails. When B<@PROGRAM_NAME@> finds a file locked on the server, it will check whether the lock is held by B<@PROGRAM_NAME@> and the current user, and if so tries to reuse and release it. But this will not allways succeed. So servers should automatically release locks after some time, when they are not refreshed by the client.
de: Manchmal gibt ein Client eine Sperre nicht wieder frei. Möglicherweise ist er abgestürzt oder die Netzwerkverbindung ist zusammengebrochen. Wenn B<@PROGRAM_NAME@> feststellt, dass eine Datei auf dem Server gesperrt ist, prüft es, ob die Sperre vom Benutzer mit Hilfe von B<@PROGRAM_NAME@> angelegt wurde. In diesem Fall versucht es, die vorhandene Sperre zu verwenden. Dies gelingt aber nicht immer. Deshalb sollten Server Sperren automatisch entfernen, wenn sie vom Client nicht innerhalb einer vorgegebenen Zeit erneuert werden.

note: type: Plain text
en: WebDAV allows to lock files that don't exist (to protect the name when a client intends to create a new file). This locks will be displayed as files with size 0 and last modified date of 1970-01-01. If this locks are not released properly B<@PROGRAM_NAME@> may not be able to access this files. You can use B<cadaver>(1) E<lt>I<http://www.webdav.org/cadaver/>E<gt> to remove this locks.
de: WebDAV erlaubt es auch, Dateien zu sperren, die gar nicht existieren (damit niemand anderes den Namen benutzt, wenn ein Client eine neue Datei anlegen will). Solche gesperrten, nicht existierenden Dateien erscheinen im Dateisystem mit der Größe 0 und dem Änderungsdatum 1970-01-01. Wenn Sperren nicht ordnungsgemäß wieder frei gegeben werden, kann u.U. nicht mehr auf die Datei zugegriffen werden. Mit Hilfe von B<cadaver>(1) E<lt>I<http://www.webdav.org/cadaver/>E<gt> können solche Sperren entfernt werden.

note: type: SH
en: FILE OWNER AND PERMISSIONS
de: EIGENTÜMER UND DATEIRECHTE

note: type: Plain text
en: B<@PACKAGE@> implements Unix permissions for access control. But changing owner and permissions of a file is only B<local>. It is intended as a means for the owner of the file system, to controll whether other local users may acces this file system.
de: B<@PACKAGE@> regelt die Zugriffskontrolle durch Unix-Dateirechte.  Aber das Änderen des Eigentümers und der Dateirechte ist nur B<lokal> wirksam. Damit kann der Besitzer eines Dateisystems festlegen, welche anderen lokalen Benutzer auf sein Dateisystem zugreifen dürfen.

note: type: Plain text
en: The server does not know about this. From the servers point of view there is just one user (identified by the credentials) connected. Another WebDAV-client, connected to the same server, is not affected by this local changes.
de: Der Server weiß davon nichts. Für ihn gibt es nur den einen Benutzer (ausgewiesen durch die vertraulichen Zugangsdaten). Ein anderer WebDAV-Client, der mit dem gleichen Server verbunden ist, bekommt von diesen lokalen Änderungen an Eigentümer und Dateirechten nichts mit.

note: type: Plain text
en: There is one exeption: The B<execute bit> on files is stored as a property on the sever. You may think of this property as an information about the type of file rather than a permission. Whether the file is executable on the local system is still controlled by mount options and local permissions.
de: Es gibt eine Ausnahme: Das B<Execute-Bit> für Dateien wird auf dem Server als WebDAV-Eigenschaft gespeichert. Mann sollte dies eher als eine Information über den Dateityp betrachten, denn als ein Dateirecht. Ob die Datei lokal ausführbar ist, wird weiterhin durch die Mount-Optionen und die lokalen Rechte festgelegt.

note: type: Plain text
en: When the file system is unmounted, attributes of cached files (including owner and permissions) are stored in cache, as well as the attributs of the direcotries they are in. But there is no information stored about directories that do not contain cached files.
de: Wenn das Dateisystem ausgehängt wird, werden die Attribute der Dateien im Cache gespeichert, ebenso die der übergeordneten Verzeichnisse. Es werden aber keine Attribute von Verzeichnissen gespeichert, die keine Dateien enthalten, die im Cache sind.

note: type: Plain text
en: Configuration file in the users home directory.The user configuration takes precedence over the system wide configuration. If it does not exist, B<@PROGRAM_NAME@> will will create a template file.
de: Konfigurationsdatei im Home-Verzeichnis des Benutzers. Sie hat Vorrang vor der systemweiten Konfigurationsdatei. Wenn sie nicht existiert, legt B<@PROGRAM_NAME@> eine Vorlage an.

note: type: Plain text
en: Holds the credentials for WebDAV servers and the proxy, as well as decryption passwords for client certificates. The file must be read-writable by root only.
de: Enthält vertrauliche Zugangsdaten für den WebDAV-Server und den Proxy, sowie Passwörter zur Entschlüsselung von Client-Zertifikaten. Die Datei darf nur Schreib- und Leserechte für root haben.

note: type: Plain text
en: Holds credentials for WebDAV servers and proxy, as well as decryption passwords for client certificates. The file must be read-writable by the owner only. Credentials are first looked up in the home directory of the mounting user. If not found there the system wide secrets file is consulted. If no creditentials and passwords are found they are asked from the user interactively (if not disabled). If the file does not exist, B<@PROGRAM_NAME@> will will create a template file.
de: Enthält vertrauliche Zugangsdaten für den WebDAV-Server und den Proxy, sowie Passwörter zu Entschlüsselung von Client-Zertifikaten. Die Datei darf nur Schreib- und Leserechte für den Besitzer haben.  Zugangsdaten und Passwörter werden vorrangig dieser Datei entnommen.  Wenn keine gefunden werden, wird die systemweite Datei durchsucht.  Wenn die Zugangsdaten und Passörter nicht gefunden werden, wird der Benutzer danach gefragt (falls nicht anders konfiguriert). Wenn die Datei nicht existiert, legt B<@PROGRAM_NAME@> eine Vorlage an.

note: type: Plain text
en: You may store trusted server certificates here, that can not be verified by use of the system wide CA-Certificates. This is useful when your server uses a selfmade certificate. You must configure the B<servercert> option in I<@SYS_CONF_DIR@/@CONFIGFILE@> or I<~/.@PACKAGE@/@CONFIGFILE@> to use it. Certificates must be in PEM format.
de: Hier können vertrauenswürdige Server-Zertifikate gespeichert werden, die nicht auf normale Weise mit Hilfe der CA-Zertifikate des Systems überprüft werden können. Das ist dann sinnvoll, wenn der Server ein selbst gemachtes Zertifikat benutzt. Um ein solches Zertifikat zu benutzen, muss dies in I<@SYS_CONF_DIR@/@CONFIGFILE@> oder I<~/.@PACKAGE@/@CONFIGFILE@> konfiguriert werden. Die Zertifikate müssen im PEM-Format vorliegen.

note: type: Plain text
en: Be sure to verify the certificate.
de: Vergiss nicht, das Zertifikat selbst zu prüfen.

note: type: Plain text
en: You may store trusted server certificates here, that can not be verified by use of the system wide CA-Certificates. This is useful when your server uses a selfmade certificate. You must configure the B<servercert> option in I<~/.@PACKAGE@/@CONFIGFILE@> to use it. Certificates must be in PEM format.
de: Hier können vertrauenswürdige Server-Zertifikate gespeichert werden, die nicht auf normale Weise mit Hilfe der CA-Zertifikate des Systems überprüft werden können. Das ist dann sinnvoll, wenn der Server ein selbst gemachtes Zertifikat benutzt. Um ein solches Zertifikat zu benutzen, muss dies in I<~/.@PACKAGE@/@CONFIGFILE@> konfiguriert werden. Die Zertifikate müssen im PEM-Format vorliegen.

note: type: Plain text
en: To store client certificates. Certificates must be in PKCS#12 format. You must configure the B<clientcert> option in I<@SYS_CONF_DIR@/@CONFIGFILE@> or I<~/.@PACKAGE@/@CONFIGFILE@> to use it. This directory must be rwx by root only.
de: Hier können Client-Zertifikate im PKCS#12-Format gespeichert werden. Die Benutzung muss in I<@SYS_CONF_DIR@/@CONFIGFILE@> oder I<~/.@PACKAGE@/@CONFIGFILE@> konfiguriert werden. Das Verzeichnis darf nur Schreib-, Lese- und Ausführungsrecht für root haben.

note: type: Plain text
en: To store client certificates. Certificates must be in PKCS#12 format. You must configure the B<clientcert> option in I<~/.@PACKAGE@/@CONFIGFILE@> to use it. This directory must be rwx by the owner only.
de: Hier können Client-Zertifikate im PKCS#12-Format gespeichert werden. Die Benutzung muss in I<~/.@PACKAGE@/@CONFIGFILE@> konfiguriert werden.  Das Verzeichnis darf nur Schreib-, Lese- und Ausführungsrecht für den Besitzer haben.

note: type: Plain text
en: PID-files of running mount.davfs processes are stored there. This directory must belong to group B<@USER@> with write permissions for the group and the sticky-bit set (mode 1775). The PID-files are named after the mount point of the file system.
de: Hier speichert der Hintergrundprozess eine PID-Datei. Das Verzeichnis muss zur Gruppe B<@USER@> gehören; die Gruppe muss Schreibrecht haben und das Sticky-Bit muss gesetzt sein (Dateimodus 1775). Der Name der PID-Datei wird vom Einhängepunkt abgeleitet.

note: type: Plain text
en: System wide directory for cached files. Used when the file system is mounted by root. It must belong do group B<@USER@> and read, write and execute bits for group must be set. There is a subdirectory for every mounted file system. The names of this subdirectories are created from url, mount point and user name.
de: Dieses systemweite Cache-Verzeichnis wird benutzt, wenn root das Dateisystem einhängt. Es muss zur Gruppe B<@USER@> gehören und die Gruppe muss Lese-, Schreib- und Ausfürungsrecht haben. Für jedes Dateisystem wird ein Unterverzeichnis angelegt. Der Name des Unterverzeichnisses wird aus der URL, dem Einhängepunkt und dem Benutzernamen gebildet.

note: type: Plain text
en: Cache directory in the mounting users home directory. For every mounted WebDAV resource a subdirectory is created.
de: Cache-Verzeichnis im Home-Verzeichnis des Benutzers. Für jedes Dateisystem wird ein Unterverzeichnis angelegt.

note: type: Plain text
en: B<@PROGRAM_NAME@> will try to create missing directories, but it will B<not> touch I<@SYS_CONF_DIR@>.
de: B<@PROGRAM_NAME@> versucht fehlende Verzeichnisse zu erstellen. Aber es lässt die Pfoten von I<@SYS_CONF_DIR@>.

note: type: Plain text
en: If no proxy is defined in the configuration file the value is taken from this environment variables. The proxy may be given with or without scheme and with or without port
de: Wenn kein Proxy konfiguriert ist, wird der Wert dieser Umgebungsvariablen benutzt. Der Proxy kann mit und ohne Schema, sowie mit und ohne Port angegeben werden.

note: type: Plain text
en: Only used when the mounting user is root.
de: Wird nur benutzt, wenn der Benutzer root das Dateisystem einhängt.

note: type: Plain text
en: A comma separated list of domain names that shall be accessed directly.  B<*> matches any domain name. A domain name starting with B<.> (period) matches all subdomains.
de: Eine durch Kommas getrennte Liste von Domainnamen, auf die direkt zugegriffen werden soll. B<*> passt auf alle Domainnamen. Ein Domainname, der mit einem Punkt B<.> beginnt, umfasst auch alle Subdomains.

note: type: Plain text
en: Not applied when the proxy is defined in I<@SYS_CONF_DIR@>.
de: Wird nicht benutzt, wenn der Proxy in I<@SYS_CONF_DIR@> festgelegt wird.

note: type: Plain text
en: B<Non root user (e.g. filomena):>
de: B<Normaler Benutzer (z.B filomena):>

note: type: Plain text
en: To allow an ordinary user to mount there must be an entry in I<fstab>
de: Damit ein normaler Benutzer ein Dateisystem einhängen kann, ist ein Eintrag in I<fstab> nötig.

note: type: Plain text
en: If a proxy must be used this should be configured in I<@SYS_CONF_DIR@/@CONFIGFILE@>
de: Falls ein Proxy benutzt werden soll, sollte dies in I<@SYS_CONF_DIR@/@CONFIGFILE@> konfiguriert werden.

note: type: Plain text
en: Credentials are stored in I</home/filomena/.@PACKAGE@/@SECRETSFILE@>
de: Die vertraulichen Zugangsdaten für den Server werden in I</home/filomena/.@PACKAGE@/@SECRETSFILE@> gespeichert.

note: type: Plain text
en: Now the WebDAV resource may be mounted by user filomena invoking
de: Jetzt kann Benutzerin filomena das Dateisystem einhängen durch

note: type: Plain text
en: and unmounted by user filomena invoking
de: und dieselbe Benutzerin filomena kann es aushängen durch

note: type: Plain text
en: B<Root user only:>
de: B<Nur Benutzer root:>

note: type: Plain text
en: Mounts the resource I<https://asciigirl.com/webdav> at mount point I</mount/site>, encrypting all traffic with SSL. Credentials for I<http://webdav.org/dav> will be looked up in I<@SYS_CONF_DIR@/@SECRETSFILE@>, if not found there the user will be asked.
de: Die WebDAV-Resource I<https://asciigirl.com/webdav> wird im Verzeichnis I</mount/site> eingehängt. Der Netzwerkverkehr wird verschlüsselt. Die vertraulichen Zugangsdatenen für I<http://webdav.org/dav> werden I<@SYS_CONF_DIR@/@SECRETSFILE@> entnommen. Falls sie da nicht gefunden werden, wird der Benutzer gefragt.

note: type: Plain text
en: Mounts the resource I<http://linux.org.ar/repos> at I</dav>.
de: Die WebDAV-Resource I<http://linux.org.ar/repos> wird auf I</dav> eingehängt.

note: type: Plain text
en: B<@PACKAGE@> does not support links.
de: B<@PACKAGE@> unterstützt keine Links.

note: type: Plain text
en: A B<@PACKAGE@> file system cannot be moved with I<mount --move>.
de: Ein B<@PACKAGE@>-Dateisystem kann nicht mit I<mount --move> verschoben werden.

note: type: Plain text
en: This man page was written by Luciano Bello E<lt>luciano@linux.org.arE<gt> for Debian, for version 0.2.3 of davfs2.
de: Dieses Handbuch wurde von Luciano Bello E<lt>luciano@linux.org.arE<gt> für die Version 0.2.3 von @PACKAGE@ in Debian geschrieben.

note: type: Plain text
en: It has been updated for this version by Werner Baumann E<lt>werner.baumann@onlinhome.deE<gt>.
de: Für spätere Versionen wurde es von Werner Baumann E<lt>werner.baumann@onlinehome.deE<gt> angepasst.

note: type: Plain text
en: @PACKAGE@ is developed by Sung Kim E<lt>hunkim@gmail.comE<gt>.
de: @PACKAGE@ wurde von Sung Kim E<lt>hunkim@gmail.comE<gt> entwickelt.

note: type: Plain text
en: Version 1.0.0 (and later) of @PACKAGE@ is a complete rewrite by Werner Baumann.
de: Version 1.0.0 (und spätere) von @PACKAGE@ sind eine vollständige Neufassung von Werner Baumann.

note: type: Plain text
en: u@PROGRAM_NAME@ - Umount-helper to unmount a @PACKAGE@ file system
de: u@PROGRAM_NAME@ - Umount-Hilfsprogramm für @PACKAGE@ Dateisysteme

note: type: Plain text
en: B<u@PROGRAM_NAME@> is a umount helper program. It is called by the B<umount>(8) command. Its purpose is to prevent the umount command from returning unless B<@PROGRAM_NAME@> has synchronized all its cached files with the webdav server.
de: B<u@PROGRAM_NAME@> ist ein Hilfsprogramm, das von B<umount>(8)  aufgerufen wird. Es soll verhindern, dass das umount-Kommando zurück kehrt, bevor B<@PROGRAM_NAME@> alle geänderten Dateien aus dem Cache auf den WebDAV-Server zurück sichern konnte.

note: type: Plain text
en: While for local file systems B<umount>(8) will only return when all cached data have been written to disk, this is not automatically true for a mounted B<@PACKAGE@> file system. With this umount helper the user can rely on the familiar behaviour of B<umount>(8). To inform the operating system that the file system uses a network connection, you should always use the B<_netdev> option, when mounting as B<@PACKAGE@> file system.
de: Bei lokalen Dateisystemen kehrt B<umount>(8) erst zurück, wenn alle Daten aus dem Cache auf die Festplatte geschrieben sind. Dies funkioniert bei einem B<@PACKAGE@>-Dateisystem nicht automatisch. Mit diesem Hilfsprogramm kann sich der Benutzer auf das bekannte Verhalten von B<umount>(8) verlassen. Es sollte auch immer mit der Option B<_netdev> eingehängt werden, damit das Betriebssystem darüber informiert wird, dass das B<@PACKAGE@>-Dateisystem eine Netzwerkverbindung braucht.

note: type: Plain text
en: Depending on the amount of data and the quality of the connection, unmounting a B<@PACKAGE@> file system may take some seconds up to some hours.
de: Abhängig von der Datenmenge und der Qualität der Netzwerkverbindung kann das Aushängen ein paar Sekunden, aber auch einige Stunden dauern.

note: type: Plain text
en: If the B<@PROGRAM_NAME@> daemon encountered serious errors, B<u@PROGRAM_NAME@> may return an error instead of unmounting the file system. In this case try B<umount -i>. The B<-i> option will prevent B<umount>(8) from calling B<u@PROGRAM_NAME@>.
de: Wenn der B<@PROGRAM_NAME@>-Hintergrundprozess ernste Probleme hat, kann B<u@PROGRAM_NAME@> möglicherweise das Dateisystem nicht aushängen, sondern meldet einen Fehler. Versuche es in diesem Fall mit B<umount -i>. Die Option B<-i> hindert B<umount>(8) daran, B<u@PROGRAM_NAME@> aufzurufen.

note: type: Plain text
en: This options are B<ignored>. They are only recognized for compatibility with B<umount>(8).
de: Dies Optionen dienen nur der Kompatibilität mit B<umount>(8) und werden ignoriert.

note: type: Plain text
en: PID-files of running B<u@PROGRAM_NAME@> processes are looked up here.
de: Die PID-Dateien der laufenden B<@PROGRAM_NAME@>-Hintergrundprozesse werden in diesem Verzeichnis gesucht.

note: type: Plain text
en: No known bugs.
de: Derzeit keine bekannten.

note: type: Plain text
en: This man page was written by Werner Baumann E<lt>werner.baumann@onlinehome.deE<gt>.
de: Diese Handbuch hat Werner Baumann E<lt>werner.baumann@onlinehome.deE<gt> geschrieben.

note: type: TH
en: Debian Project
de: Debian-Projekt

note: type: Plain text
en: deb - Debian binary package format
de: deb - Debian-Binärpaketformat

note: type: Plain text
en: I<filename>B<.deb>
de: I<Dateiname>B<.deb>

note: type: Plain text
en: The B<.deb> format is the Debian binary package file format. It is understood by dpkg 0.93.76 and later, and is generated by default by all versions of dpkg since 1.2.0 and all i386/ELF versions since 1.1.1elf.
de: Das B<.deb>-Format ist das Debian-Binärpaketdateiformat. Es wird von dpkg 0.93.76 und neuer verstanden, und wird standardmäßig von allen dpkg-Versionen seit 1.2.0 und allen i386/ELF-Versionen seit 1.1.1elf erzeugt.

note: type: Plain text
en: The format described here is used since Debian 0.93; details of the old format are described in B<deb-old>(5).
de: Das hier beschriebene Format wird seit Debian 0.93 verwendet; Details über das alte Format sind in B<deb-old>(5) beschrieben.

note: type: Plain text
en: The file is an B<ar> archive with a magic value of B<!E<lt>archE<gt>>.  Only the common B<ar> archive format is supported, with no long file name extensions, but with file names containing an optional trailing slash, which limits their length to 15 characters (from the 16 allowed).  File sizes are limited to 10 ASCII decimal digits, allowing for up to approximately 9536.74 MiB member files.
de: Die Datei ist ein B<ar>-Archiv mit dem magischen Wert B<!E<lt>archE<gt>>. Nur das allgemeine B<ar>-Archivformat wird unterstützt, ohne Unterstützung von Dateinamenerweiterungen, aber mit Dateinamen, die einen optionalen abschließenden Schrägstrich enthalten dürfen, deren Länge damit auf 15 Zeichen (von den erlaubten 16) begrenzt ist. Dateigrößen sind auf 10 dezimale ASCII-Ziffern begrenzt, wodurch bis zu ungefähr 9536,74 MiB-Mitgliedsdateien erlaubt sind.

note: type: Plain text
en: The B<tar> archives currently allowed are, the old-style (v7) format, the pre-POSIX ustar format, a subset of the GNU format (only the new style long pathnames and long linknames, supported since dpkg 1.4.1.17), and the POSIX ustar format (long names supported since dpkg 1.15.0).  Unrecognized tar typeflags are considered an error.
de: Derzeit werden die folgenden B<tar>-Archive erlaubt: alter Stil (V7-)Format, pre-POSIX-ustar-Format, eine Teilmenge des GNU-Formats (nur der neue Stil mit langen Pfadnamen und langen Linknamen, unterstützt seit Dpkg 1.4.1.17) und das POSIX-ustar-Format (lange Namen seit Dpkg 1.15.0 unterstützt). Unbekannte Tar-Typeinstellungen werden als Fehler betrachtet.

note: type: Plain text
en: The first member is named B<debian-binary> and contains a series of lines, separated by newlines. Currently only one line is present, the format version number, B<2.0> at the time this manual page was written.  Programs which read new-format archives should be prepared for the minor number to be increased and new lines to be present, and should ignore these if this is the case.
de: Das erste Mitglied heißt B<debian-binary> und enthält eine Reihe von Zeilen, die durch Zeilenumbrüche getrennt sind. Derzeit ist nur eine Zeile vorhanden, die Versionsnummer, B<2.0> zum Zeitpunkt zu dem diese Handbuchseite geschrieben wurde. Programme, die Archive im neuen Format lesen, sollten darauf vorbereitet sein, dass sich die Nachkommazahl erhöht und neue Zeilen vorhanden sein können, und sollten diese ignorieren, falls dies der Fall ist.

note: type: Plain text
en: If the major number has changed, an incompatible change has been made and the program should stop. If it has not, then the program should be able to safely continue, unless it encounters an unexpected member in the archive (except at the end), as described below.
de: Falls sich die Vorkommazahl geändert hat, wurde eine inkompatible Änderung durchgeführt und das Programm sollte sich beenden. Falls dies nicht der Fall ist, dann sollte das Programm sicher fortfahren können, es sei denn, ein unerwartetes Mitglied ist im Archiv (abgesehen vom Ende) gefunden worden, wie unten beschrieben.

note: type: Plain text
en: The second required member is named B<control.tar.gz>.  It is a gzipped tar archive containing the package control information, as a series of plain files, of which the file B<control> is mandatory and contains the core control information. The control tarball may optionally contain an entry for `B<.>', the current directory.
de: Das zweite erforderliche Mitglied heißt B<control.tar.gz>. Es ist ein gezipptes Tar-Archiv, das die Steuerinformationen als eine Reihe von normalen Dateien enthält, von denen die Datei B<control> zwingend erforderlich ist und die Kern-Steuerinformationen enthält. Der Steuer-Tarball kann optional einen Eintrag für »B<.>«, das aktuelle Verzeichnis, enthalten.

note: type: Plain text
en: The third, last required member is named B<data.tar>.  It contains the filesystem as a tar archive, either not compressed (supported since dpkg 1.10.24), or compressed with gzip (with B<.gz> extension), xz (with B<.xz> extension, supported since dpkg 1.15.6), bzip2 (with B<.bz2> extension, supported since dpkg 1.10.24) or lzma (with B<.lzma> extension, supported since dpkg 1.13.25).
de: Das dritte, letzte zwingend benötigte Mitglied heißt B<data.tar>. Es enthält das Dateisystem als Tar-Archiv, entweder unkomprimiert (seit Dpkg 1.10.24 unterstützt) oder mit gzip (Dateiendung B<.gz>), xz (Dateiendung B<.xz> seit Dpkg 1.15.6 unterstützt),bzip2 (Dateiendung B<.bz2>, seit Dpkg 1.10.24 unterstützt) oder lzma (Dateiendung B<.lzma>, seit Dpkg 1.13.25 unterstützt) komprimiert.

note: type: Plain text
en: These members must occur in this exact order. Current implementations should ignore any additional members after B<data.tar>.  Further members may be defined in the future, and (if possible) will be placed after these three. Any additional members that may need to be inserted before B<data.tar> and which should be safely ignored by older programs, will have names starting with an underscore, `B<_>'.
de: Diese Mitglieder müssen in genau dieser Reihenfolge auftauchen. Aktuelle Implementationen sollten zusätzliche Mitglieder nach B<data.tar> ignorieren. Weitere Mitglieder könnten in der Zukunft definiert werden und werden (falls möglich) nach diesen drei platziert. Alle zusätzlichen Mitglieder, die vor B<data.tar> eingefügt werden könnten und die problemlos von älteren Programmen ignoriert werden sollten, werden Namen haben, die mit einem Unterstrich »B<_>« anfangen.

note: type: Plain text
en: Those new members which won't be able to be safely ignored will be inserted before B<data.tar> with names starting with something other than underscores, or will (more likely) cause the major version number to be increased.
de: Solche neuen Mitglieder, die nicht problemlos ignoriert werden können, werden vor B<data.tar> mit Namen, die nicht mit einem Unterstrich anfangen, eingefügt oder werden (wahrscheinlicher) dazu führen, dass die Hauptversionsnummer erhöht wird.

note: type: Plain text
en: deb-control - Debian packages' master control file format
de: deb-control - Dateiformat der Hauptsteuerdatei von Debian-Paketen

note: type: Plain text
en: Each Debian package contains the master `control' file, which contains a number of fields, or comments when the line starts with B<'#'>. Each field begins with a tag, such as B<Package> or B<Version> (case insensitive), followed by a colon, and the body of the field.  Fields are delimited only by field tags. In other words, field text may be multiple lines in length, but the installation tools will generally join lines when processing the body of the field (except in the case of the B<Description> field, see below).
de: Jedes Debian-Paket enthält die Hauptsteuerdatei »control«, die eine Reihe von Feldern oder Kommentaren (wenn die Zeile mit B<»#«> beginnt) enthält. Jedes Feld beginnt mit einer Markierung, wie B<Package> oder B<Version> (Groß-/Kleinschreibung egal), gefolgt von einem Doppelpunkt und dem Körper des Feldes. Felder werden nur durch die Feldmarkierungen abgegrenzt. Mit anderen Worten, Feldtexte können mehrere Zeilen überspannen, aber die Installationswerkzeuge werden im Allgemeinen die Zeilen bei der Verarbeitung des Feldkörpers zusammenfassen (mit Ausnahme des B<Description>-Feldes, sehen Sie dazu unten).

note: type: SH
en: REQUIRED FIELDS
de: NOTWENDIGE FELDER

note: type: TP
en: B<Package:>I< package-name>
de: B<Package:>I< Paketname>

note: type: Plain text
en: The value of this field determines the package name, and is used to generate file names by most installation tools.
de: Der Wert dieses Feldes bestimmt den Paketnamen und wird von den meisten Installationswerkzeugen verwendet, um Dateinamen zu erstellen.

note: type: TP
en: B<Version:>I< version-string>
de: B<Version:>I< Versions-Zeichenkette>

note: type: Plain text
en: Typically, this is the original package's version number in whatever form the program's author uses. It may also include a Debian revision number (for non-native packages). The exact format and sorting algorithm are described in B<deb-version>(5).
de: Typischerweise ist das die Original-Paketversionsnummer, in der Form, die der Programmautor verwendet. Es kann auch eine Debian-Revisionsnummer enthalten (für nicht aus Debian stammende Pakete). Das genaue Format und der Sortieralgorithmus sind in B<deb-version>(5) beschrieben.

note: type: TP
en: B<Maintainer:>I< fullname-email>
de: B<Maintainer:>I< Vollständiger-Name-und-E-Mail>

note: type: Plain text
en: Should be in the format `Joe Bloggs E<lt>jbloggs@foo.comE<gt>', and is typically the person who created the package, as opposed to the author of the software that was packaged.
de: Sollte in dem Format »Joe Bloggs E<lt>jbloggs@foo.comE<gt>« sein und ist typischerweise die Person, die das Paket erstellt hat, im Gegensatz zum Autor der Software, die paketiert wurde.

note: type: TP
en: B<Description:>I< short-description>
de: B<Description:>I< Kurzbeschreibung>

note: type: Plain text
en: B< >I<long-description>
de: B< >I<Langbeschreibung>

note: type: Plain text
en: The format for the package description is a short brief summary on the first line (after the "Description" field). The following lines should be used as a longer, more detailed description. Each line of the long description must be preceded by a space, and blank lines in the long description must contain a single '.' following the preceding space.
de: Das Format der Paketbeschreibung ist eine kurze knappe Zusammenfassung auf der ersten Zeile (nach dem »Description«-Feld). Die folgenden Zeilen sollten als längere, detailliertere Beschreibung verwendet werden. Jede Zeile der Langbeschreibung muss von einem Leerzeichen begonnen werden, und Leerzeilen in der Langbeschreibung müssen einen einzelnen ».« hinter dem einleitenden Leerzeichen enthalten.

note: type: SH
en: OPTIONAL FIELDS
de: OPTIONALE FELDER

note: type: TP
en: B<Section:>I< section>
de: B<Section:>I< Bereich>

note: type: Plain text
en: This is a general field that gives the package a category based on the software that it installs. Some common sections are `utils', `net', `mail', `text', `x11' etc.
de: Dies ist ein allgemeines Feld, das dem Paket eine Kategorie gibt, basierend auf der Software, die es installiert. Einige übliche Bereiche sind »utils«, »net«, »mail«, »text«, »x11« usw.

note: type: TP
en: B<Priority:>I< priority>
de: B<Priority:>I< Priorität>

note: type: Plain text
en: Sets the importance of this package in relation to the system as a whole.  Common priorities are `required', `standard', `optional', `extra' etc.
de: Setzt die Bedeutung dieses Pakets in Bezug zu dem Gesamtsystem. Übliche Prioritäten sind »required«, »standard«, »optional«, »extra« usw.

note: type: Plain text
en: In Debian, the B<Section> and B<Priority> fields have a defined set of accepted values based on the Policy Manual.  A list of these values can be obtained from the latest version of the B<debian-policy> package.
de: In Debian haben die B<Section>- und B<Priority>-Felder einen definierten Satz an akzeptierten Werten, basierend auf dem Richtlinien-Handbuch. Eine Liste dieser Werte kann aus der neusten Version des Pakets B<debian-policy> erhalten werden.

note: type: Plain text
en: This field is usually only needed when the answer is B<yes>. It denotes a package that is required for proper operation of the system. Dpkg or any other installation tool will not allow an B<Essential> package to be removed (at least not without using one of the force options).
de: Dieses Feld wird normalerweise nur benötigt, wenn die Antwort B<yes> lautet. Es bezeichnet ein Paket, das für den ordnungsgemäßen Betrieb des Systems benötigt wird. Dpkg oder jedes andere Installationswerkzeug wird es nicht erlauben, ein B<Essential>-Paket zu entfernen (zumindestens nicht ohne die Verwendung einer der »force«-Optionen).

note: type: Plain text
en: The architecture specifies which type of hardware this package was compiled for. Common architectures are `i386', `m68k', `sparc', `alpha', `powerpc' etc. Note that the B<all> option is meant for packages that are architecture independent. Some examples of this are shell and Perl scripts, and documentation.
de: Die Architektur spezifiziert den Hardwaretyp für den dieses Paket kompiliert wurde. Geläufige Architekturen sind »i386«, »m68k«, »sparc«, »alpha«, »powerpc« usw. Beachten Sie, dass die Option B<all> für Pakete gedacht ist, die Architektur-unabhängig sind. Einige Beispiele hierfür sind Shell- und Perl-Skripte und Dokumentation.

note: type: TP
en: B<Origin:>I< name>
de: B<Origin:>I< Name>

note: type: Plain text
en: The name of the distribution this package is originating from.
de: Der Name der Distribution, aus der dieses Paket ursprünglich stammt.

note: type: TP
en: B<Bugs:>I< url>
de: B<Bugs:>I< URL>

note: type: Plain text
en: The I<url> of the bug tracking system for this package. The current used format is I<bts-type>B<://>I<bts-address>, like B<debbugs://bugs.debian.org>.
de: Die I<URL> der Fehlerdatenbank für dieses Paket. Das derzeit verwendete Format ist I<BTS-Art>B<://>I<BTS-Adresse> wie in B<debbugs://bugs.debian.org>.

note: type: TP
en: B<Homepage:>I< url>
de: B<Homepage:>I< URL>

note: type: Plain text
en: The upstream project home page I<url>.
de: Die I<URL> des Original- (Upstream-)Projekts.

note: type: TP
en: B<Tag:>I< tag-list>
de: B<Tag:> I< Liste-von-Markierungen>

note: type: Plain text
en: List of tags describing the qualities of the package. The description and list of supported tags can be found in the B<debtags> package.
de: Liste der unterstützten Markierungen (»Tags«), die die Eigenschaften des Pakets beschreiben. Die Beschreibung und die Liste der unterstützten Markierungen kann in dem Paket B<debtags> gefunden werden.

note: type: Plain text
en: This field is used to indicate how this package should behave on a multi-arch installations. The value B<same> means that the package is co-installable with itself, but it must not be used to satisfy the dependency of any package of a different architecture from itself. The value B<foreign> means that the package is not co-installable with itself, but should be allowed to satisfy the dependency of a package of a different arch from itself. The value B<allowed> allows reverse-dependencies to indicate in their Depends field that they accept a package from a foreign architecture, but has no effect otherwise.
de: Das Feld wird dazu verwandt, anzugeben, wie sich dieses Paket in einer Multi-Arch-Installation verhalten soll. Der Wert B<same> bedeutet, dass das Paket mit sich selbst koinstallierbar ist, aber nicht dazu verwandt werden darf, die Abhängigkeit eines Pakets von einer anderen Architektur mit ihm selbst zu erfüllen. Der Wert B<foreign> bedeutet, dass das Paket nicht mit sich selbst koinstallierbar ist, aber es erlaubt sein soll, die Abhängigkeit eines Pakets von einer anderen Architektur mit ihm selbst zu erfüllen. Der Wert B<allowed> erlaubt es invers Abhängigen in ihrem Feld »Depends« anzuzeigen, dass sie ein Paket von einer fremden Architektur akzeptieren, hat aber ansonsten keinen Effekt.

note: type: TP
en: B<Source:>I< source-name>
de: B<Source:> I< Quell-Name>

note: type: Plain text
en: The name of the source package that this binary package came from, if different than the name of the package itself.
de: Der Name des Quellpakets, aus dem dieses Binärpaket abstammt, falls es sich vom Namen dieses Paketes unterscheidet.

note: type: TP
en: B<Subarchitecture:>I< value>
de: B<Subarchitecture:> I< Wert>

note: type: TP
en: B<Kernel-Version:>I< value>
de: B<Kernel-Version:> I< Wert>

note: type: TP
en: B<Installer-Menu-Item:>I< value>
de: B<Installer-Menu-Item:> I< Wert>

note: type: Plain text
en: These fields are used by the debian-installer and are usually not needed.  See /usr/share/doc/debian-installer/devel/modules.txt from the B<debian-installer> package for more details about them.
de: Diese Felder werden im Debian-Installer verwandt und werden normalerweise nicht benötigt. Lesen Sie /usr/share/doc/debian-installer/devel/modules.txt aus dem Paket B<debian-installer> für weitere Informationen über sie.

note: type: TP
en: B<Depends:>I< package-list>
de: B<Depends:> I< Paketliste>

note: type: Plain text
en: List of packages that are required for this package to provide a non-trivial amount of functionality. The package maintenance software will not allow a package to be installed if the packages listed in its B<Depends> field aren't installed (at least not without using the force options).  In an installation, the postinst scripts of packages listed in Depends: fields are run before those of the packages which depend on them. On the opposite, in a removal, the prerm script of a package is run before those of the packages listed in its Depends: field.
de: Liste von Paketen, die benötigt werden, damit dieses Paket eine nicht-triviale Menge an Funktionen anbieten kann. Die Paketverwaltungssoftware wird es nicht erlauben, dass ein Paket installiert wird, falls die in seinem B<Depends>-Feld aufgeführten Pakete nicht installiert sind (zumindestens nicht ohne Verwendung der »Force«-Optionen). Bei einer Installation werden Postinst-Skripte von Paketen, die im Feld »Depends:« aufgeführt sind, vor den Postinst-Skripten der eigentlichen Pakete ausgeführt. Bei der gegenteiligen Operation, der Paket-Entfernung, wird das Prerm-Skript eines Paketes vor den Prerm-Skripten der Pakete ausgeführt, die im Feld »Depends:« aufgeführt sind.

note: type: TP
en: B<Pre-Depends:>I< package-list>
de: B<Pre-Depends:> I< Paketliste>

note: type: Plain text
en: List of packages that must be installed B<and> configured before this one can be installed. This is usually used in the case where this package requires another package for running its preinst script.
de: Liste an Paketen die installiert B<und> konfiguriert sein müssen, bevor dieses Paket installiert werden kann. Dies wird normalerweise in dem Fall verwendet, wo dieses Paket ein anderes Paket zum Ausführen seines preinst-Skriptes benötigt.

note: type: TP
en: B<Recommends:>I< package-list>
de: B<Recommends:> I< Paketliste>

note: type: Plain text
en: Lists packages that would be found together with this one in all but unusual installations. The package maintenance software will warn the user if they install a package without those listed in its B<Recommends> field.
de: Liste an Paketen, die in allen, abgesehen von ungewöhnlichen, Installationen zusammen angefunden würden. Die Paketverwaltungssoftware wird den Benutzer warnen, falls er ein Paket ohne die im B<Recommends>-Feld aufgeführten Pakete installiert.

note: type: TP
en: B<Suggests:>I< package-list>
de: B<Suggests:> I< Paketliste>

note: type: Plain text
en: Lists packages that are related to this one and can perhaps enhance its usefulness, but without which installing this package is perfectly reasonable.
de: Liste an Paketen die einen Bezug zu diesem haben und vielleicht seine Nützlichkeit erweitern könnten, aber ohne die das zu installierende Paket perfekt sinnvoll ist.

note: type: Plain text
en: The syntax of B<Depends>, B<Pre-Depends>, B<Recommends> and B<Suggests> fields is a list of groups of alternative packages. Each group is a list of packages separated by vertical bar (or `pipe') symbols, `|'. The groups are separated by commas. Commas are to be read as `AND', and pipes as `OR', with pipes binding more tightly. Each package name is optionally followed by a version number specification in parentheses.
de: Die Syntax der B<Depends>, B<Pre-Depends>, B<Recommends> und B<Suggests>-Felder ist eine Liste von Gruppen von alternativen Paketen. Jede Gruppe ist eine Liste von durch vertikale Striche (oder »Pipe«-Symbole) »|« getrennte Pakete. Die Gruppen werden durch Kommata getrennt. Kommata müssen als »UND«, vertikale Striche als »ODER« gelesen werden, wobei die vertikalen Striche stärker binden. Jeder Paketname wird optional gefolgt von einer Versionsnummer-Spezifikation in Klammern.

note: type: Plain text
en: A version number may start with a `E<gt>E<gt>', in which case any later version will match, and may specify or omit the Debian packaging revision (separated by a hyphen). Accepted version relationships are "E<gt>E<gt>" for greater than, "E<lt>E<lt>" for less than, "E<gt>=" for greater than or equal to, "E<lt>=" for less than or equal to, and "=" for equal to.
de: Eine Versionsnummer kann mit »E<gt>E<gt>« beginnen, in diesem Falle passen alle neueren Versionen, und kann die Debian-Paketrevision (getrennt durch einen Bindestrich) enthalten oder auch nicht. Akzeptierte Versionsbeziehungen sind »E<gt>E<gt>« für größer als, »E<lt>E<lt>« für kleiner als, »E<gt>=« für größer als oder identisch zu, »E<lt>=« für kleiner als oder identisch zu und »=« für identisch zu.

note: type: TP
en: B<Breaks:>I< package-list>
de: B<Breaks:> I< Paketliste>

note: type: Plain text
en: Lists packages that this one breaks, for example by exposing bugs when the named packages rely on this one. The package maintenance software will not allow broken packages to be configured; generally the resolution is to upgrade the packages named in a B<Breaks> field.
de: Liste Paketen auf, die von diesem Paket beschädigt werden, zum Beispiel in dem sie Fehler zugänglich machen, wenn sich das andere Paket auf dieses Paket verlässt. Die Paketverwaltungssoftware wird es beschädigten Paketen nicht erlauben, sich zu konfigurieren; im Allgemeinen wird das Problem behoben, indem ein Upgrade des im B<Breaks>-Feld aufgeführten Pakets durchgeführt wird.

note: type: TP
en: B<Conflicts:>I< package-list>
de: B<Conflicts:> I< Paketliste>

note: type: Plain text
en: Lists packages that conflict with this one, for example by containing files with the same names. The package maintenance software will not allow conflicting packages to be installed at the same time. Two conflicting packages should each include a B<Conflicts> line mentioning the other.
de: Liste an Paketen, die mit diesem in Konflikt stehen, beispielsweise indem beide Dateien den gleichen Namen enthalten. Die Paketverwaltungssoftware wird es nicht erlauben, Pakete, die in Konflikt stehen, gleichzeitig zu installieren. Zwei in Konflikt stehende Pakete sollten jeweils eine B<Conflicts>-Zeile enthalten, die das andere Paket erwähnen.

note: type: TP
en: B<Replaces:>I< package-list>
de: B<Replaces:> I<Paketliste>

note: type: Plain text
en: List of packages files from which this one replaces. This is used for allowing this package to overwrite the files of another package and is usually used with the B<Conflicts> field to force removal of the other package, if this one also has the same files as the conflicted package.
de: Liste an Paketen, von denen dieses Dateien ersetzt. Dies wird dazu verwendet, um diesem Paket zu erlauben, Dateien von einem anderen Paket zu ersetzen und wird gewöhnlich mit dem B<Conflicts>-Feld verwendet, um die Entfernung des anderen Paketes zu erlauben, falls dieses auch die gleichen Dateien wie das im Konflikt stehende Paket hat.

note: type: TP
en: B<Provides:>I< package-list>
de: B<Provides:> I< Paketliste>

note: type: Plain text
en: This is a list of virtual packages that this one provides. Usually this is used in the case of several packages all providing the same service.  For example, sendmail and exim can serve as a mail server, so they provide a common package (`mail-transport-agent') on which other packages can depend. This will allow sendmail or exim to serve as a valid option to satisfy the dependency. This prevents the packages that depend on a mail server from having to know the package names for all of them, and using `|' to separate the list.
de: Dies ist eine Liste von virtuellen Paketen, die dieses Paket bereitstellt. Gewöhnlich wird dies verwendet, wenn mehrere Pakete alle den gleichen Dienst bereitstellen. Beispielsweise können Sendmail und Exim als Mailserver dienen, daher stellen sie ein gemeinsames Paket (»mail-transport-agent«) bereit, von dem andere Pakete abhängen können. Dies erlaubt es Sendmail oder Exim als gültige Optionen zur Erfüllung der Abhängigkeit zu dienen. Dies verhindert, dass Pakete, die von einem E-Mail-Server abhängen, alle Paketnamen für alle E-Mail-Server wissen und »|« zur Unterteilung der Liste verwenden müssen.

note: type: Plain text
en: The syntax of B<Breaks>, B<Conflicts>, B<Replaces> and B<Provides> is a list of package names, separated by commas (and optional whitespace).  In the B<Breaks> and B<Conflicts> fields, the comma should be read as `OR'. An optional version can also be given with the same syntax as above for the B<Breaks>, B<Conflicts> and B<Replaces> fields.
de: Die Syntax von B<Breaks>, B<Conflicts>, B<Replaces> und B<Provides> ist eine Liste von Paketnamen, getrennt durch Kommata (und optionalen Leerzeichen). Im B<Breaks>- und B<Conflicts>-Feld sollte das Komma als »ODER« gelesen werden. Eine optionale Version kann auch mit der gleichen Syntax wie oben für die B<Breaks>-, B<Conflicts>- und B<Replaces>-Felder angegeben werden.

note: type: TP
en: B<Built-Using:>I< package-list>
de: B<Built-Using:> I< Paketliste>

note: type: Plain text
en: This field lists extra source packages that were used during the build of this binary package.  This is an indication to the archive maintenance software that these extra source packages must be kept whilst this binary package is maintained.  This field must be a list of source package names with strict (=)  version relationships.  Note that the archive maintenance software is likely to refuse to accept an upload which declares a B<Built-Using> relationship which cannot be satisfied within the archive.
de: Dieses Feld führt zusätzliche Quellpakete auf, die während des Baus des Binärpakets verwandt wurden. Dies dient als Hinweis für die Archivverwaltungssoftware, dass zusätzliche Quellpakete vorhanden bleiben müssen, während dieses Binärpaket betreut wird. Dieses Feld muss eine Liste von Quellpaketnamen enthalten, bei denen eine strenge Versionsbeziehung (=) angegeben ist. Beachten Sie, dass die Archivverwaltungssoftware wahrscheinlich einen Upload ablehnen wird, bei dem eine B<Built-Using>-Beziehung angegeben wurde, die innerhalb des Archivs nicht erfüllt werden kann.

note: type: Plain text
en: # Comment
    Package: grep
    Essential: yes
    Priority: required
    Section: base
    Maintainer: Wichert Akkerman E<lt>wakkerma@debian.orgE<gt>
    Architecture: sparc
    Version: 2.4-1
    Pre-Depends: libc6 (E<gt>= 2.0.105)
    Provides: rgrep
    Conflicts: rgrep
    Description: GNU grep, egrep and fgrep.
     The GNU family of grep utilities may be the "fastest grep in the west".
     GNU grep is based on a fast lazy-state deterministic matcher (about
     twice as fast as stock Unix egrep) hybridized with a Boyer-Moore-Gosper
     search for a fixed string that eliminates impossible text from being
     considered by the full regexp matcher without necessarily having to
     look at every character. The result is typically many times faster
     than Unix grep or egrep. (Regular expressions containing backreferencing
     will run more slowly, however).
de: # Comment
    Package: grep
    Essential: yes
    Priority: required
    Section: base
    Maintainer: Wichert Akkerman E<lt>wakkerma@debian.orgE<gt>
    Architecture: sparc
    Version: 2.4-1
    Pre-Depends: libc6 (E<gt>= 2.0.105)
    Provides: rgrep
    Conflicts: rgrep
    Description: GNU grep, egrep und fgrep.
     Die GNU-Familie der Grep-Werkzeuge könnte die »schnellste im Westen« sein.
     GNU Grep basiert auf einem schellen »lazy-state deterministic matcher«
     (rund zweimal so schnell wie der standardmäßige Unix-Egrep) hybridisiert 
     mit einer Boyer-Moore-Gosper-Suche für eine feste Zeichenkette, die
     unmöglichen Text von der Betrachtung durch den vollen »Matcher« verhindert
     ohne notwendigerweise jedes Zeichen anzuschauen. Das Ergebnis ist
     typischerweise um ein mehrfaches Schneller als Unix Grep oder Egrep.
     (Reguläre Ausdrücke, die Rückreferenzierungen enthalten, werden allerdings
     langsamer laufen.)

note: type: Plain text
en: deb-src-control - Debian source packages' master control file format
de: deb-src-control - Dateiformat der Hauptsteuerdatei von Debian-Quellpaketen

note: type: Plain text
en: Each Debian source package contains the master "control" file, which contains at least 2 paragraphs, separated by a blank line. The first paragraph lists all information about the source package in general, while each following paragraph describes exactly one binary package. Each paragraph consists of at least one field. A field starts with a fieldname, such as B<Package> or B<Section> (case insensitive), followed by a colon, the body of the field and a newline.  Multi-line fields are also allowed, but each supplementary line, without a fieldname, should start with at least one space. The content of the multi-line fields is generally joined to a single line by the tools (except in the case of the B<Description> field, see below). To insert empty lines into a multi-line field, insert a dot after the space. Lines starting with a B<'#'> are treated as comments.
de: Jedes Debian-Quellpaket enhält die Hauptsteuerdatei »control«, die mindestens zwei Absätze enthält, die durch eine Leerzeile getrennt werden. Der erste Absatz führt alle allgemeinen Informationen über das Quellpaket auf, während jeder folgende Absatz genau ein Binärpaket beschreibt. Jeder Absatz besteht aus mindestens einem Feld. Ein Feld beginnt mit einem Feldnamen, wie B<Package> oder B<Section> (Groß-/Kleinschreibung egal), gefolgt von einem Doppelpunkt, dem Inhalt des Feldes und einem Zeilenumbruch. Mehrzeilige Felder sind auch erlaubt, aber jede ergänzende Zeile ohne Feldnamen sollte mit mindestens einem Leerzeichen beginnen. Der Inhalt des mehrzeiligen Feldes wird durch die Werkzeuge im Allgemeinen zu einer Zeile zusammengeführt (das Feld B<Description> ist eine Ausnahme, siehe unten). Um Leerzeilen in ein mehrzeiliges Feld einzufügen, verwenden Sie einen Satzpunkt nach dem Leerzeichen. Zeilen, die mit B<»#«> beginnen, werden als Kommentare betrachtet.

note: type: SH
en: SOURCE FIELDS
de: QUELLPAKET-FELDER

note: type: TP
en: B<Source:> I<source-package-name> (required)
de: B<Source:> I<Quellpaketname> (verpflichtend)

note: type: Plain text
en: The value of this field is the name of the source package, and should match the name of the source package in the debian/changelog file. A package name must consist only of lower case letters (a-z), digits (0-9), plus (+) and minus (-) signs, and periods (.). Package names must be at least two characters long and must start with an alphanumeric character.
de: Der Wert dieses Feldes ist der Name des Quellpakets und sollte mit dem Namen des Quellpakets in der Datei debian/changelog übereinstimmen. Ein Paketname darf nur aus Kleinbuchstaben (a-z), Ziffern (0-9), Plus- (+) und Minuszeichen (-) und Satzpunkten (.) bestehen. Paketnamen müssen mindestens zwei Zeichen lang sein und mit einem alphanumerischen Zeichen beginnen.

note: type: TP
en: B<Maintainer:> I<fullname-email> (required)
de: B<Maintainer:> I<Vollständiger-Name-und-E-Mail> (verpflichtend)

note: type: Plain text
en: Should be in the format "Joe Bloggs E<lt>jbloggs@foo.comE<gt>", and references the person who currently maintains the package, as opposed to the author of the software or the original packager.
de: Sollte in dem Format »Joe Bloggs E<lt>jbloggs@foo.comE<gt>« sein und verweist auf die Person, die derzeit das Paket betreut, im Gegensatz zum Autor der Software, die paketiert wurde, oder dem ursprünglichen Paketierer.

note: type: TP
en: B<Uploaders:>I< fullname-email>
de: B<Uploaders:>I< Vollständiger-Name-und-E-Mail>

note: type: Plain text
en: Lists all the names and email addresses of co-maintainers of the package, in the same format as the Maintainer field. Multiple co-maintainers should be separated by a comma.
de: Listet die Namen und E-Mail-Adressen der Ko-Betreuer des Pakets auf, im gleichen Format wie das Feld »Maintainer«. Mehrere Ko-Betreuer sollten durch Kommata getrennt werden.

note: type: TP
en: B<Standards-Version:>I< version-string>
de: B<Standards-Version:> I< Versionszeichenkette>

note: type: Plain text
en: This documents the most recent version of the standards (which consists of the Debian Policy Manual and referenced texts from the B<debian-policy> package) this package complies to.
de: Dies dokumentiert die neuste Version der Standards (die aus dem Debian-Richtlinienhandbuch und den aus dem Paket B<debian-policy> referenzierten Texten besteht), an den sich das Paket hält.

note: type: Plain text
en: This field indicates whether the package can be uploaded by Debian Maintainers appearing in the Maintainer or Uploaders field. The default value is "no".
de: Dieses Feld gibt an, ob das Paket von einem Debian-Betreuer, der im Feld »Maintainer« oder »Uploader« auftaucht, hochgeladen werden kann. Der Standardwert ist »no« (nein).

note: type: Plain text
en: The upstream project home page URL.
de: Die URL des Original- (Upstream-)Projekts.

note: type: Plain text
en: The I<url> of the bug tracking system for this package. The current used format is I<bts-type>B<://>I<bts-address>, like B<debbugs://bugs.debian.org>. This field is usually not needed.
de: Die I<URL> der Fehlerdatenbank für dieses Paket. Das derzeit verwendete Format ist I<BTS-Art>B<://>I<BTS-Adresse> wie in B<debbugs://bugs.debian.org>. Dieses Feld wird normalerweise nicht benötigt.

note: type: TP
en: B<Vcs-*:>I< url>
de: B<Vcs-*:> I< URL>

note: type: Plain text
en: The I<url> of the Version Control System repository used to maintain this package. Currently supported are B<Arch>, B<Bzr> (Bazaar), B<Cvs>, B<Darcs>, B<Git>, B<Hg> (Mercurial), B<Mtn> (Monotone) and B<Svn> (Subversion). Usually this field points to the latest version of the package, such as the main branch or the trunk.
de: Die I<URL> des Versionskontrollsystem-Depots, das für die Betreuung des Pakets verwandt wird. Derzeit werden B<Arch>, B<Bzr> (Bazaar), B<Cvs>, B<Darcs>, B<Git>, B<Hg> (Mercurial), B<Mtn> (Monotone) und B<Svn> (Subversion) unterstützt. Normalerweise zeigt dieses Feld auf die neuste Version des Pakets, wie den Hauptzweig oder den Trunk.

note: type: TP
en: B<Vcs-Browser:>I< url>
de: B<Vcs-Browser:> I< URL>

note: type: Plain text
en: The I<url> of a webinterface to browse the Version Control System repository.
de: Die I<URL> der Webschnittstelle, um das Versionskontrollsystem-Depot anzuschauen.

note: type: Plain text
en: The name of the distribution this package is originating from. This field is usually not needed.
de: Der Name der Distribution, aus der dieses Paket ursprünglich stammt. Dieses Feld wird normalerweise nicht benötigt.

note: type: Plain text
en: This is a general field that gives the package a category based on the software that it installs. Some common sections are "utils", "net", "mail", "text", "x11", etc.
de: Dies ist ein allgemeines Feld, das dem Paket eine Kategorie gibt, basierend auf der Software, die es installiert. Einige übliche Bereiche sind »utils«, »net«, »mail«, »text«, »x11« usw.

note: type: Plain text
en: Sets the importance of this package in relation to the system as a whole.  Common priorities are "required", "standard", "optional", "extra", etc.
de: Setzt die Bedeutung dieses Pakets in Bezug zu dem Gesamtsystem. Übliche Prioritäten sind »required«, »standard«, »optional«, »extra« usw.

note: type: TP
en: B<Build-Depends:>I< package-list>
de: B<Build-Depends:>I< Paketliste>

note: type: Plain text
en: A list of packages that need to be installed and configured to be able to build the source package. Including a dependency in this list has the same effect as including it in both B<Build-Depends-Arch> and B<Build-Depends-Indep>, with the additional effect of being used for source-only builds.
de: Eine Liste der Pakete, die installiert und konfiguriert sein müssen, um das Quellpaket zu bauen. Die Aufnahme einer Abhängigkeit in diese Liste hat den gleichen Effekt wie die Aufnahme in B<Build-Depends-Arch> und B<Build-Depends-Indep> mit dem zusätzlichen Effekt, dass es für reine Quellen-Bauten verwandt wird.

note: type: TP
en: B<Build-Depends-Arch:>I< package list>
de: B<Build-Depends-Arch:>I< Paketliste>

note: type: Plain text
en: Same as B<Build-Depends>, but they are only needed when building the architecture dependent packages. The B<Build-Depends> are also installed in this case. This field was introduced in dpkg version 1.16.4; in order to build with older dpkg versions, B<Build-Depends> should be used instead.
de: Identisch zu B<Build-Depends>, wird aber nur zum Bau der architekturabhängigen Pakete benötigt. In diesem Fall sind die B<Build-Depends> auch installiert. Dieses Feld wurde in Dpkg Version 1.16.4 eingeführt; um mit älteren Dpkg-Versionen zu bauen, sollte stattdessen B<Build-Depends> verwandt werden.

note: type: TP
en: B<Build-Depends-Indep:>I< package-list>
de: B<Build-Depends-Indep:>I< Paketliste>

note: type: Plain text
en: Same as B<Build-Depends>, but they are only needed when building the architecture independent packages. The B<Build-Depends> are also installed in this case.
de: Identisch zu B<Build-Depends>, wird aber nur zum Bau der architekturunabhängigen Pakete benötigt. In diesem Fall sind die B<Build-Depends> auch installiert.

note: type: TP
en: B<Build-Conflicts:>I< package list>
de: B<Build-Conflicts:>I< Paketliste>

note: type: Plain text
en: A list of packages that should not be installed when the package is built, for example because they interfere with the build system used.  Including a dependency in this list has the same effect as including it in both B<Build-Conflicts-Arch> and B<Build-Conflicts-Indep>, with the additional effect of being used for source-only builds.
de: Eine Liste von Paketen, die beim Bau des Pakets nicht installiert sein sollten, beispielsweise da sie mit dem verwandten Bausystem in Konflikt geraten. Die Aufnahme einer Abhängigkeit in diese Liste hat den gleichen Effekt wie die Aufnahme in B<Build-Conflicts-Arch> und B<Build-Conflicts-Indep> mit dem zusätzlichen Effekt, dass es für reine Quellen-Bauten verwandt wird.

note: type: TP
en: B<Build-Conflicts-Arch:>I< package list>
de: B<Build-Conflicts-Arch:>I< Paketliste>

note: type: Plain text
en: Same as B<Build-Conflicts>, but only when building the architecture dependent packages. This field was introduced in dpkg version 1.16.4; in order to build with older dpkg versions, B<Build-Conflicts> should be used instead.
de: Identisch zu B<Build-Conflicts>, aber nur beim Bau der architekturabhängigen Pakete. Dieses Feld wurde in Dpkg Version 1.16.4 eingeführt; um mit älteren Dpkg-Versionen zu bauen, sollte stattdessen B<Build-Conflicts> verwandt werden.

note: type: TP
en: B<Build-Conflicts-Indep:>I< package-list>
de: B<Build-Conflicts-Indep:>I< Paketliste>

note: type: Plain text
en: Same as B<Build-Conflicts>, but only when building the architecture independent packages.
de: Identisch zu B<Build-Conflicts>, wird aber nur zum Bau der architekturunabhängigen Pakete benötigt.

note: type: Plain text
en: The syntax of the B<Build-Depends>, B<Build-Depends-Arch> and B<Build-Depends-Indep> fields is a list of groups of alternative packages. Each group is a list of packages separated by vertical bar (or "pipe") symbols, "|". The groups are separated by commas. Commas are to be read as "AND", and pipes as "OR", with pipes binding more tightly. Each package name is optionally followed by a version number specification in parentheses and an architecture specification in square brackets.
de: Die Syntax der Felder B<Build-Depends>, B<Build-Depends-Arch> und B<Build-Depends-Indep> ist eine Liste von Gruppen von alternativen Paketen. Jede Gruppe ist eine Liste von durch vertikale Striche (oder »Pipe«-Symbole) »|« getrennten Paketen. Die Gruppen werden durch Kommata getrennt. Kommata müssen als »UND«, vertikale Striche als »ODER« gelesen werden, wobei die vertikalen Striche stärker binden. Jeder Paketname wird optional gefolgt von einer Versionsnummer-Spezifikation in Klammern und einer Architekturspezifikation in eckigen Klammern.

note: type: Plain text
en: The syntax of the B<Build-Conflicts>, B<Build-Conflicts-Arch> and B<Build-Conflicts-Indep> fields is a list of comma-separated package names, where the comma is read as an "AND". Specifying alternative packages using a "pipe" is not supported.  Each package name is optionally followed by a version number specification in parentheses and an architecture specification in square brackets.
de: Syntaxtisch werden die Felder B<Build-Conflicts>, B<Build-Conflicts-Arch> und B<Build-Conflicts-Indep> durch eine Komma-separierte Liste von Paketnamen dargestellt, wobei das Komma als »UND« verstanden wird. Die Angabe alternativer Pakete mit dem »Pipe«-Symbol wird nicht unterstützt. Jedem Paketnamen folgt optional eine Versionnummerangabe in Klammern und eine Architekturspezifikation in eckigen Klammern.

note: type: Plain text
en: A version number may start with a "E<gt>E<gt>", in which case any later version will match, and may specify or omit the Debian packaging revision (separated by a hyphen). Accepted version relationships are "E<gt>E<gt>" for greater than, "E<lt>E<lt>" for less than, "E<gt>=" for greater than or equal to, "E<lt>=" for less than or equal to, and "=" for equal to.
de: Eine Versionsnummer kann mit »E<gt>E<gt>« beginnen, in diesem Falle passen alle neueren Versionen, und kann die Debian-Paketrevision (getrennt durch einen Bindestrich) enthalten oder auch nicht. Akzeptierte Versionsbeziehungen sind »E<gt>E<gt>« für größer als, »E<lt>E<lt>« für kleiner als, »E<gt>=« für größer als oder identisch zu, »E<lt>=« für kleiner als oder identisch zu und »=« für identisch zu.

note: type: Plain text
en: A architecture specification consists of one or more architecture names, separated by whitespace. Exclamation marks may be prepended to each of the names, meaning "NOT".
de: Eine Architekturspezifikation besteht aus einer oder mehreren durch Leerzeichen getrennten Architekturnamen. Jedem Namen darf ein Ausrufezeichen vorangestellt werden, das »NICHT« bedeutet.

note: type: Plain text
en: Note that dependencies on packages in the B<build-essential> set can be omitted and that declaring build conflicts against them is impossible. A list of these packages is in the build-essential package.
de: Beachten Sie, dass die Abhängigkeiten von Paketen aus der Menge der B<build-essential> entfallen kann und die Angabe von Baukonflikten gegen sie nicht möglich ist. Eine Liste dieser Pakete befindet sich im Paket build-essential.

note: type: SH
en: BINARY FIELDS
de: BINÄRPAKET-FELDER

note: type: Plain text
en: Note that the B<Priority>, B<Section> and B<Homepage> fields can also be in a binary paragraph to override the global value from the source package.
de: Beachten Sie, dass die Felder B<Priority>, B<Section> und B<Homepage> sich auch im Binärprogrammabsatz befinden können, um die globalen Werte des Quellpakets zu überschreiben.

note: type: TP
en: B<Package:> I<binary-package-name> (required)
de: B<Package:> I<Binärpaketname> (verpflichtend)

note: type: Plain text
en: This field is used to name the binary package name. The same restrictions as to a source package name apply.
de: Dieses Feld wird zur Angabe des Binärpaketnamens verwandt. Es gelten die gleichen Einschränkungen wie beim Quellpaketnamen.

note: type: TP
en: B<Architecture:> I<arch>|B<all>|B<any> (required)
de: B<Architecture:> I<arch>|B<all>|B<any> (verpflichtend)

note: type: Plain text
en: The architecture specifies on which type of hardware this package runs. For packages that run on all architectures, use the B<any> value. For packages that are architecture independent, such as shell and Perl scripts or documentation, use the B<all> value. To restrict the packages to a certain set of architectures, specify the architecture names, separated by a space. It's also possible to put architecture wildcards in that list (see B<dpkg-architecture>(1)  for more information about them).
de: Die Architektur gibt an, auf welcher Art von Hardware dieses Paket läuft. Bei Paketen, die auf allen Architekturen laufen, verwenden Sie den Wert B<any>. Für Pakete, die architekturunabhängig sind, wie Shell- und Perl-Skripte oder Dokumentation, verwenden Sie den Wert B<all>. Um das Paket für einen bestimmten Satz von Architekturen zu begrenzen, geben Sie die durch Leerzeichen getrennten Namen der Architekturen an. Es ist auch möglich, Platzhalter für Architekturen in dieser Liste anzugeben (lesen Sie B<dpkg-architecture>(1) für weitere Informationen dazu).

note: type: Plain text
en: This field defines the type of the package. "udeb" is for size-constrained packages used by the debian installer. "deb" is the default value, it's assumed if the field is absent. More types might be added in the future.
de: Dieses Feld definiert die Art des Pakets. »udeb« ist für größenbegrenzte Pakete, wie sie vom Debian-Installer verwandt werden. »deb« ist der Standardwert, er wird angenommen, falls das Feld fehlt. Weitere Typen könnten in der Zukunft hinzugefügt werden.

note: type: TP
en: B<Description:> I<short-description> (required)
de: B<Description:> I<Kurzbeschreibung> (verpflichtend)

note: type: Plain text
en: These fields are described in the B<deb-control>(5)  manual page, as they are copied literally to the control file of the binary package.
de: Diese Felder sind in der Handbuchseite B<deb-control>(5) beschrieben, da sie wörtlich in die Steuerdatei des Binärpakets kopiert werden.

note: type: TP
en: B<Enhances:>I< package-list>
de: B<Enhances:> I< Paketliste>

note: type: Plain text
en: These fields declare relationships between packages. They are discussed in the B<deb-control>(5)  manpage and in the B<debian-policy> package.
de: Diese Felder deklarieren die Beziehungen zwischen Paketen. Sie werden in der Handbuchseite B<deb-control>(5) und im Paket B<debian-policy> beschrieben.

note: type: SH
en: USER-DEFINED FIELDS
de: BENUTZERDEFINIERTE FELDER

note: type: Plain text
en: It is allowed to add additional user-defined fields to the control file. The tools will ignore these fields. If you want the fields to be copied over to the output files, such as the binary packages, you need to use a custom naming scheme: the fields should start with a X, followed by one or more of the letters BCS and a hypen. If the letter B is used, the field will appear in the control file in the binary package, see B<deb-control>(5), for the letter S in the source package control file as constructed by B<dpkg-source>(1)  and for the letter C in the upload control (.changes) file. Note that the X[BCS]- prefixes are stripped when the fields are copied over to the output files. A field B<XC-Approved-By> will appear as B<Approved-By> in the changes file and will not appear in the binary or source package control files.
de: Es ist erlaubt, zusätzliche benutzerdefinierte Felder zu der Steuerdatei hinzuzufügen. Die Werkzeuge werden diese Felder ignorieren. Falls Sie möchten, dass die Felder in die Ausgabedateien, wie z.B. die Binärpakete, kopiert werden, müssen Sie ein angepasstes Namensschema verwenden: Die Felder sollten mit einem X, gefolgt von einem oder mehr der Buchstaben BCS und einem Gedankenstrich beginnen. Falls der Buchstabe B benutzt wird, wird das Feld in der Steuerdatei des Binärpakets auftauchen, siehe B<deb-control>(5), beim Buchstaben S in der Quellpaketsteuerdatei wie sie von B<dpkg-source>(1) erstellt wird und beim Buchstaben C in der hochgeladenen Datei control (.changes). Beachten Sie, dass die X[BCS]-Vorsilben beim Kopieren in die Ausgabedateien entfernt werden. Ein Feld B<XC-Approved-By> wird als B<Approved-By> in der Datei changes, aber nicht in den Steuerdateien des Quell- und Binärpakets auftauchen.

note: type: Plain text
en: Take into account that these user-defined fields will be using the global namespace, which might at some point in the future collide with officially recognized fields. To avoid such potential situation you can prefix those fields with B<Private->, such as B<XB-Private-New-Field>, which as a side effect will make B<dpkg-deb> not warn on them as unknown fields.
de: Beachten Sie, dass diese Benutzer-definierten Felder den globalen Namensraum nutzen werden und somit in der Zukunft mit offiziell erkannten Feldern kollidieren könnten. Um solche möglichen Situationen zu vermeiden, können Sie den Feldern B<Private->, wie in B<XB-Private-Neues-Feld>, voranstellen. Als Seiteneffekt wird in diesem Fall B<dpkg-deb> sie nicht mit der Warnung eines unbekannten Feldes ausgeben.

note: type: Plain text
en: # Comment
    Source: dpkg
    Section: admin
    Priority: required
    Maintainer: Dpkg Developers E<lt>debian-dpkg@lists.debian.orgE<gt>
    # this field is copied to the binary and source packages
    XBS-Upstream-Release-Status: stable
    Homepage: http://wiki.debian.org/Teams/Dpkg
    Vcs-Browser: http://git.debian.org/?p=dpkg/dpkg.git
    Vcs-Git: git://git.debian.org/git/dpkg/dpkg.git
    Standards-Version: 3.7.3
    Build-Depends: pkg-config, debhelper (E<gt>= 4.1.81),
     libselinux1-dev (E<gt>= 1.28-4) [!linux-any]
de: # Kommentar
    Source: dpkg
    Section: admin
    Priority: required
    Maintainer: Dpkg Developers E<lt>debian-dpkg@lists.debian.orgE<gt>
    # dieses Feld wird in das Binär- und Quellpaket kopiert
    XBS-Upstream-Release-Status: stable
    Homepage: http://wiki.debian.org/Teams/Dpkg
    Vcs-Browser: http://git.debian.org/?p=dpkg/dpkg.git
    Vcs-Git: git://git.debian.org/git/dpkg/dpkg.git
    Standards-Version: 3.7.3
    Build-Depends: pkg-config, debhelper (E<gt>= 4.1.81),
     libselinux1-dev (E<gt>= 1.28-4) [!linux-any]

note: type: Plain text
en: Package: dpkg-dev
    Section: utils
    Priority: optional
    Architecture: all
    # this is a custom field in the binary package
    XB-Mentoring-Contact: Raphael Hertzog E<lt>hertzog@debian.orgE<gt>
    Depends: dpkg (E<gt>= 1.14.6), perl5, perl-modules, cpio (E<gt>= 2.4.2-2),
     bzip2, lzma, patch (E<gt>= 2.2-1), make, binutils, libtimedate-perl
    Recommends: gcc | c-compiler, build-essential
    Suggests: gnupg, debian-keyring
    Conflicts: dpkg-cross (E<lt>E<lt> 2.0.0), devscripts (E<lt>E<lt> 2.10.26)
    Replaces: manpages-pl (E<lt>= 20051117-1)
    Description: Debian package development tools
     This package provides the development tools (including dpkg-source)
     required to unpack, build and upload Debian source packages.
     .
     Most Debian source packages will require additional tools to build;
     for example, most packages need make and the C compiler gcc.
de: Package: dpkg-dev
    Section: utils
    Priority: optional
    Architecture: all
    # dies ist ein spezielles Feld im Binärpaket
    XB-Mentoring-Contact: Raphael Hertzog E<lt>hertzog@debian.orgE<gt>
    Depends: dpkg (E<gt>= 1.14.6), perl5, perl-modules, cpio (E<gt>= 2.4.2-2),
     bzip2, lzma, patch (E<gt>= 2.2-1), make, binutils, libtimedate-perl
    Recommends: gcc | c-compiler, build-essential
    Suggests: gnupg, debian-keyring
    Conflicts: dpkg-cross (E<lt>E<lt> 2.0.0), devscripts (E<lt>E<lt> 2.10.26)
    Replaces: manpages-pl (E<lt>= 20051117-1)
    Description: Debian package development tools
     This package provides the development tools (including dpkg-source)
     required to unpack, build and upload Debian source packages.
     .
     Most Debian source packages will require additional tools to build;
     for example, most packages need make and the C compiler gcc.

note: type: Plain text
en: deb-split - Debian multi-part binary package format
de: deb-split - mehrteiliges Debian-Binärpaketformat

note: type: Plain text
en: The multi-part B<.deb> format is used to split big packages into smaller pieces to ease transport in small media.
de: Das mehrteilige B<.deb>-Format wird zum Aufteilen von großen Paketen in kleinere Stücke zur Erleichterung des Transports auf kleinen Medien verwandt.

note: type: Plain text
en: The file is an B<ar> archive with a magic value of B<!E<lt>archE<gt>>.  The file names might contain a trailing slash (since dpkg 1.15.6).
de: Die Datei ist ein B<ar>-Archiv mit einer magischen Zahl von B<!E<lt>archE<gt>>. Der Dateiname kann (seit Dpkg 1.15.6) mit einem Schrägstrich abschließen.

note: type: Plain text
en: The first member is named B<debian-split> and contains a series of lines, separated by newlines. Currently eight lines are present:
de: Das erste Mitglied heißt B<debian-split> und enthält eine Reihe von Zeilen, getrennt durch Leerzeilen. Derzeit sind acht Zeilen vorhanden:

note: type: Plain text
en: The format version number, B<2.1> at the time this manual page was written.
de: Die Formatversionsnummer, zum Zeitpunkt der Erstellung dieser Handbuchseite lautet sie B<2.1>.

note: type: Plain text
en: The package name.
de: Der Paketname.

note: type: Plain text
en: The package version.
de: Die Paketversion.

note: type: Plain text
en: The md5sum of the package.
de: Die Md5sum des Pakets.

note: type: Plain text
en: The total size of the package.
de: Die Gesamtgröße des Pakets.

note: type: Plain text
en: The maximum part size.
de: Die maximale Teilegröße

note: type: Plain text
en: The current part number, followed by a slash and the total amount of parts (as in \(oq1/10\(cq).
de: Die aktuelle Teilenummer, gefolgt von einem Schrägstrich und der Gesamtanzahl an Teilen (wie in \(oq1/10\(cq).

note: type: Plain text
en: The package architecture (since dpkg 1.16.1).
de: Die Paketarchitektur (seit Dpkg 1.16.1).

note: type: Plain text
en: Programs which read multi-part archives should be prepared for the minor format version number to be increased and additional lines to be present, and should ignore these if this is the case.
de: Programme, die mehrteilige Archive lesen, sollten darauf vorbereitet sein, dass sich die Unterversionsnummer erhöht und dass zusätzliche Zeilen vorhanden sein können, und sollten diese ignorieren, falls dies der Fall ist.

note: type: Plain text
en: If the major format version number has changed, an incompatible change has been made and the program should stop. If it has not, then the program should be able to safely continue, unless it encounters an unexpected member in the archive (except at the end), as described below.
de: Falls sich die Hauptversionsnummer geändert hat, wurde eine inkompatible Änderung durchgeführt und das Programm sollte sich beenden. Falls dies nicht der Fall ist, dann sollte das Programm sicher fortfahren können, es sei denn, ein unerwartetes Mitglied ist im Archiv (abgesehen vom Ende) gefunden worden, wie unten beschrieben.

note: type: Plain text
en: The second, last required member is named B<data.>I<N>, where I<N> denotes the part number. It contains the raw part data.
de: Das zweite, letzte benötigte Mitglied heißt B<data.>I<N>, wobei I<N> die Teilnummer angibt. Es enthält die rohen Daten des Teils.

note: type: Plain text
en: These members must occur in this exact order. Current implementations should ignore any additional members after B<data.>I<N>.  Further members may be defined in the future, and (if possible) will be placed after these two.
de: Diese Mitglieder müssen in genau dieser Reihenfolge auftauchen. Aktuelle Implementationen sollten zusätzliche Mitglieder nach B<data.>I<N> ignorieren. Weitere Mitglieder könnten in der Zukunft definiert werden und werden (falls möglich) nach diesen drei platziert.

note: type: Plain text
en: deb-version - Debian package version number format
de: deb-version - Versionsnummer-Format von Debian-Paketen

note: type: Plain text
en: [I<epoch>B<:>]I<upstream-version>[B<->I<debian-revision>]
de: [ I<Epoche>B<:>]I<Upstream-Version>[B<->I<Debian-Revision>]

note: type: Plain text
en: Version numbers as used for Debian binary and source packages consist of three components. These are:
de: Die für Debian Binär- und Quellpakete verwendete Versionsnummer besteht aus drei Komponenten. Diese sind:

note: type: TP
en: I<epoch>
de: I<Epoche>

note: type: Plain text
en: This is a single (generally small) unsigned integer.  It may be omitted, in which case zero is assumed.  If it is omitted then the I<upstream-version> may not contain any colons.
de: Dies ist eine einzelne (typischerweise kleine) vorzeichenlose ganze Zahl. Sie darf entfallen, wobei dann Null angenommen wird. Falls sie entfällt, darf die I<Upstream-Version> keine Doppelpunkte enthalten.

note: type: Plain text
en: It is provided to allow mistakes in the version numbers of older versions of a package, and also a package's previous version numbering schemes, to be left behind.
de: Sie existiert, um Fehler in den Versionsnummern älterer Versionen des Pakets zu erlauben und auch, um das bisherige Nummerierungsschema eines Paketes aufzugeben.

note: type: TP
en: I<upstream-version>
de: I<Upstream-Version>

note: type: Plain text
en: This is the main part of the version number.  It is usually the version number of the original ("upstream")  package from which the I<.deb> file has been made, if this is applicable.  Usually this will be in the same format as that specified by the upstream author(s); however, it may need to be reformatted to fit into the package management system's format and comparison scheme.
de: Dies ist der Hauptteil der Versionsnummer. Normalerweise ist dies die Versionsnummer des Originalpakets (»Upstream«), aus dem die I<.deb>-Datei erstellt wurde, falls dies zutrifft. Normalerweise wird diese im gleichen Format vorliegen, wie sie von den Originalautoren angegeben wurde; allerdings mag es notwendig sein, sie umzuformatieren, damit sie in das Format des Paketverwaltungssystems und des Vergleichsschemas passt.

note: type: Plain text
en: The comparison behavior of the package management system with respect to the I<upstream-version> is described below. The I<upstream-version> portion of the version number is mandatory.
de: Das Vergleichsverhalten des Paketverwaltungssystems in Hinblick auf die I<Upstream-Version> wird unten beschrieben. Der I<Upstream-Version>-Anteil der Versionnummer muss angegeben werden.

note: type: Plain text
en: The I<upstream-version> may contain only alphanumerics ("A-Za-z0-9") and the characters B<.> B<+> B<-> B<:> B<~> (full stop, plus, hyphen, colon, tilde) and should start with a digit.  If there is no I<debian-revision> then hyphens are not allowed; if there is no I<epoch> then colons are not allowed.
de: I<Upstream-Version> darf nur alphanumerische Zeichen (»A-Za-z0-9«) und B<.> B<+> B<-> B<:> B<~> (Satzpunkt, Plus, Bindestrich, Doppelpunkt, Tilde) enthalten und sollte mit einer Zahl beginnen. Falls es keine I<Debian-Revision> gibt, sind Bindestriche nicht erlaubt; falls es keine I<Epoche> gibt, sind Doppelpunkte nicht erlaubt.

note: type: TP
en: I<debian-revision>
de: I<Debian-Revision>

note: type: Plain text
en: This part of the version number specifies the version of the Debian package based on the upstream version.  It may contain only alphanumerics and the characters B<+> B<.> B<~> (plus, full stop, tilde) and is compared in the same way as the I<upstream-version> is.
de: Dieser Teil der Versionsnummer spezifiziert die Version des Debian-Paketes, basierend auf der Version der Originalautoren. Er kann nur alphanumerische Zeichen und B<+> B<.> B<~> (Plus, Satzpunkt, Tilde) enthalten und wird genauso wie die I<Upstream-Version> verglichen.

note: type: Plain text
en: It is optional; if it isn't present then the I<upstream-version> may not contain a hyphen.  This format represents the case where a piece of software was written specifically to be turned into a Debian package, and so there is only one "debianisation" of it and therefore no revision indication is required.
de: Dieser Teil ist optional; falls er nicht vorhanden ist, darf I<Upstream-Version> keinen Bindestrich enthalten. Dieses Format ist für den Fall, dass ein Stück Software speziell dafür geschrieben wurde, ein Debian-Paket zu werden und es daher nur eine »Debianisierung« gibt und somit keine Revisionsanzeige notwendig ist.

note: type: Plain text
en: It is conventional to restart the I<debian-revision> at '1' each time time the I<upstream-version> is increased.
de: Es ist üblich, die I<Debian-Revision> jedesmal bei »1« neu zu starten, wenn die I<Upstream-Version> erhöht wird.

note: type: Plain text
en: Dpkg will break the version number apart at the last hyphen in the string (if there is one) to determine the I<upstream-version> and I<debian-revision>. The absence of a I<debian-revision> compares earlier than the presence of one (but note that the I<debian-revision> is the least significant part of the version number).
de: Dpkg wird die Versionsnummer beim letzten Bindestrich in der Zeichenkette auftrennen (falls dieser existiert) um die I<Upstream-Version> und die I<Debian-Revision> zu bestimmen. Im Vergleich befindet sich eine fehlende I<Debian-Revision> vor einer vorhandenen (beachten Sie aber, dass es sich bei der I<Debian-Revision> um den Teil der Versionsnummer mit der geringsten Signifikanz handelt).

note: type: SS
en: Sorting Algorithm
de: Sortieralgorithmus

note: type: Plain text
en: The I<upstream-version> and I<debian-revision> parts are compared by the package management system using the same algorithm:
de: Die I<Upstream-Version>- und I<Debian-Revision>-Teile werden von der Paketverwaltung nach dem gleichen Algorithmus verglichen:

note: type: Plain text
en: The strings are compared from left to right.
de: Die Zeichenketten werden von links nach rechts verglichen.

note: type: Plain text
en: First the initial part of each string consisting entirely of non-digit characters is determined.  These two parts (one of which may be empty) are compared lexically.  If a difference is found it is returned.  The lexical comparison is a comparison of ASCII values modified so that all the letters sort earlier than all the non-letters and so that a tilde sorts before anything, even the end of a part.  For example, the following parts are in sorted order: '~~', '~~a', '~', the empty part, 'a'.
de: Zuerst wird der Anfangsteil jeder Zeichenkette bestimmt, der komplett aus nicht-Ziffern-Zeichen besteht. Diese zwei Teile (von denen einer leer sein kann) werden lexikalisch verglichen. Wird ein Unterschied gefunden, wird dieser zurückgeliefert. Der lexikalische Vergleich ist ein veränderter Vergleich von ASCII-Werten, bei denen Buchstaben vor allen nicht-Buchstaben sortiert werden und die Tilde vor allem sortiert wird, sogar vor dem Ende eines Teiles. So sind zum Beispiel die folgenden Teile in sortierter Reihenfolge: »~~«, »~~a«, »~«, der leere Teil, »a«.

note: type: Plain text
en: Then the initial part of the remainder of each string which consists entirely of digit characters is determined.  The numerical values of these two parts are compared, and any difference found is returned as the result of the comparison.  For these purposes an empty string (which can only occur at the end of one or both version strings being compared) counts as zero.
de: Dann wird der Anfangsteil des Restes jeder Zeichenkette bestimmt, der komplett aus Ziffern besteht. Der numerische Wert dieser zwei Teile wird verglichen, und jeder gefundene Unterschied wird als Ergebnis des Vergleichs zurückgeliefert. Für diesen Zweck zählt die leere Zeichenkette (die nur am Ende einer oder beider der zu vergleichenden Versionszeichenketten auftauchen kann) als Null.

note: type: Plain text
en: These two steps (comparing and removing initial non-digit strings and initial digit strings) are repeated until a difference is found or both strings are exhausted.
de: Diese zwei Schritte (Vergleichen und Entfernen von nicht-Ziffern-Zeichenketten und Ziffern-Zeichenketten am Anfang) werden wiederholt, bis ein Unterschied gefunden wird oder beide Zeichenketten erschöpft wurden.

note: type: Plain text
en: Note that the purpose of epochs is to allow us to leave behind mistakes in version numbering, and to cope with situations where the version numbering scheme changes.  It is B<not> intended to cope with version numbers containing strings of letters which the package management system cannot interpret (such as 'ALPHA' or 'pre-'), or with silly orderings.
de: Beachten Sie, dass Epochen uns erlauben, Fehler in der Versionsnummerierung zurückzulassen, und mit Situationen umzugehen, in denen sich das Schema der Versionsnummerierung ändert. Sie sind B<nicht> dazu gedacht, mit Versionsnummern umzugehen, die Zeichenketten aus Buchstaben enthalten, die das Paketverwaltungssystem nicht interpretieren kann (wie »ALPHA« oder »pre«) oder mit unklugen Reihenfolgen.

note: type: SH
en: CAVEATS
de: WARNUNG

note: type: Plain text
en: The tilde character and its special sorting properties were introduced in dpkg, version 1.10 and some parts of dpkg-dev only gained support for it later in the 1.10.x series.
de: Das Tilde-Zeichen uns seine speziellen Sortiereigenschaften wurden in Version 1.10 von dpkg eingeführt und einige Teile von dpkg-dev haben erst später in der 1.10.x-Serie Unterstützung dafür erhalten.

note: type: Plain text
en: deb-old - old style Debian binary package format
de: deb-old - Debian Binärpaketformat in alter Ausführung

note: type: Plain text
en: The B<.deb> format is the Debian binary package file format. This manual page describes the B<old> format, used before Debian 0.93. Please see B<deb>(5)  for details of the new format.
de: Das B<.deb>-Format ist das Debian Binärpaketdateiformat. Diese Handbuchseite beschreibt das B<alte> Format, das vor Debian 0.93 verwendet wurde. Bitte lesen Sie B<deb>(5) für Details über das neue Format.

note: type: Plain text
en: The file is two lines of format information as ASCII text, followed by two concatenated gzipped ustar files.
de: Die Datei besteht aus zwei Zeilen an Formatinformationen als ASCII-Text, gefolgt von zwei aneinandergehängten ustar-Dateien.

note: type: Plain text
en: The first line is the format version number padded to 8 digits, and is B<0.939000> for all old-format archives.
de: Die erste Zeile ist die Formatversionsnummer, aufgefüllt auf 8 Stellen, und ist B<0.939000> für alle Archive im alten Format.

note: type: Plain text
en: The second line is a decimal string (without leading zeroes) giving the length of the first gzipped tarfile.
de: Die zweite Zeile ist eine dezimale Zeichenkette (ohne führende Nullen), die die Länge der ersten gzippten Tar-Datei angibt.

note: type: Plain text
en: Each of these lines is terminated with a single newline character.
de: Jede dieser Zeilen wird durch ein einzelnes Zeilenvorschubzeichen abgeschlossen.

note: type: Plain text
en: The first tarfile contains the control information, as a series of ordinary files. The file B<control> must be present, as it contains the core control information.
de: Die erste Tar-Datei enthält die Steuerinformationen als eine Serie von normalen Dateien. Die Datei B<control> muss vorhanden sein, da sie die Kern-Steuerinformationen enthält.

note: type: Plain text
en: In some very old archives, the files in the control tarfile may optionally be in a B<DEBIAN> subdirectory. In that case, the B<DEBIAN> subdirectory will be in the control tarfile too, and the control tarfile will have only files in that directory. Optionally the control tarfile may contain an entry for `B<.>', that is, the current directory.
de: In einigen sehr alten Archiven können die Dateien in der Steuer-Tar-Datei optional in einem B<DEBIAN>-Unterverzeichnis sein. In diesem Fall ist das B<DEBIAN>-Unterverzeichnis auch in der Steuer-Tar-Datei, und die Steuer-Tar-Datei hat nur Dateien in diesem Verzeichnis. Optional kann die Steuer-Tar-Datei einen Eintrag für »B<.>« enthalten, d.h. für das aktuelle Verzeichnis.

note: type: Plain text
en: The second gzipped tarfile is the filesystem archive, containing pathnames relative to the root directory of the system to be installed on. The pathnames do not have leading slashes.
de: Die zweite gzippte Tar-Datei ist das Dateisystemarchiv, das Pfadnamen relativ zum Wurzelverzeichnis des System, auf dem installiert werden soll, enthält. Die Pfadnamen haben keine führenden Schrägstriche.

note: type: Plain text
en: deb-origin - Vendor-specific information files
de: deb-origin - Lieferanten-spezifische Informationsdateien

note: type: Plain text
en: B</etc/dpkg/origins/>I<filename>
de: B</etc/dpkg/origins/>I<Dateiname>

note: type: Plain text
en: The files in B</etc/dpkg/origins> can provide information about various vendors who are providing Debian packages. They contain a number of fields, or comments when the line starts with B<'#'>.  Each field begins with a tag, such as B<Vendor> or B<Parent>, followed by a colon and the body of the field. Fields are delimited only by field tags. In other words, field text may be multiple lines in length, but the tools will join lines when processing the body of the field.
de: Die Dateien in B</etc/dpkg/origins> können Informationen über verschiedene Lieferanten enthalten, die Debian-Pakete bereitstellen. Sie enthalten eine Reihe von Feldern oder Kommentaren (wenn die Zeile mit B<»#«> beginnt). Jedes Feld beginnt mit einer Markierung, wie B<Vendor> oder B<Parent> (Groß-/Kleinschreibung egal), gefolgt von einem Doppelpunkt und dem Körper des Feldes. Felder werden nur durch die Feldmarkierungen abgegrenzt. Mit anderen Worten, Feldtexte können mehrere Zeilen überspannen, aber die Werkzeuge werden im Allgemeinen die Zeilen bei der Verarbeitung des Feldkörpers zusammenfassen.

note: type: TP
en: B<Vendor:>I< vendor-name>
de: B<Vendor:>I< Lieferantenname>

note: type: Plain text
en: The value of this field determines the vendor name.
de: Der Wert dieses Feldes bestimmt den Lieferantennamen.

note: type: TP
en: B<Vendor-URL:>I< vendor-url>
de: B<Vendor-URL:>I< Lieferanten-URL>

note: type: Plain text
en: The value of this field determines the vendor URL.
de: Der Wert dieses Feldes bestimmt die Lieferanten-URL.

note: type: TP
en: B<Bugs:>I< bug-url>
de: B<Bugs:>I< Fehler-URL>

note: type: Plain text
en: The value of this field determines the type and address of the bug tracking system used by this vendor. It can be a mailto URL or a debbugs URL (e.g., debbugs://bugs.debian.org/).
de: Der Wert dieses Feldes bestimmt den Typ und die Adresse der Fehlerdatenbank, die von diesem Lieferanten benutzt wird. Es kann eine »mailto«-URL oder eine Debbugs-URL sein (z.B. debbugs://bugs.debian.org/).

note: type: TP
en: B<Parent:>I< vendor-name>
de: B<Parent:>I< Lieferantenname>

note: type: Plain text
en: The value of this field determines the vendor name of the vendor that this vendor derives from.
de: Der Wert dieses Feldes bestimmt den Lieferantennamen des Lieferanten, von dem dieser Lieferant sich abgeleitet hat.

note: type: TH
en: dpkg utilities
de: dpkg-Hilfsprogramme

note: type: Plain text
en: deb-override - Debian archive override file
de: deb-override - Debian-Archive override-Datei

note: type: Plain text
en: While most information about a package can be found in the control file, some is managed centrally by the distribution czars rather than by the maintainer in order to offer some global consistency.  This information is found in the override file.
de: Während der Großteil der Informationen über ein Paket in der Steuerdatei gefunden werden kann, wird ein Teil von den Distributionszaren zentral statt von den Betreuern verwaltet, um eine gewisse globael Konsistenz zu bieten. Diese Informationen finden sich in der override-Datei.

note: type: Plain text
en: The override file has a simple whitespace-delimited format. Comments are allowed (denoted with a B<#>).
de: Die override-Datei hat ein einfaches, durch Leerzeichen getrenntes Format. Kommentare sind erlaubt (angezeigt durch ein B<#>).

note: type: Plain text
en: I<package> I<priority> I<section> [I<maintainerinfo>]
de: I<Paket> I<Priorität> I<Bereich> [I<Betreuerinformation>]

note: type: Plain text
en: I<package> is the name of the package. Entries in the override file for packages not found in the tree of binary packages are ignored.
de: I<Paket> ist der Name des Pakets. Einträge in der override-Datei für Pakete, die nicht im Baum von Binärpaketen gefunden werden können, werden ignoriert.

note: type: Plain text
en: I<priority> and I<section> correspond to the respective control fields available in the .deb. The allowed values are listed in the Debian policy.
de: I<Priorität> und I<Bereich> entsprechen den Feldern I<priority> und I<section> der Steuerdatei in dem .deb. Die erlaubten Werte werden in den Debian-Richtlinien (I<Debian policy>) aufgeführt.

note: type: Plain text
en: I<maintainerinfo>, if present, can be either the name of a maintainer for an unconditional override, or else I<oldmaintainer> B<=E<gt>> I<newmaintainer> to perform a substitution.
de: I<Betreuerinformation> kann, falls vorhanden, entweder der Name des Betreuers für ein bedingungsloses Überschreiben, oder ansonsten I<AlterBetreuer> B<=E<gt>> I<NeuerBetreuer> um eine Ersetzung durchzuführen, sein.

note: type: Plain text
en: The override files used to make the official Packages lists may be found in the I<indices> directory on any Debian mirror.
de: Die override-Dateien, die für die Erstellung der offiziellen Paketliste verwendet werden, können im I<indices>-Verzeichnis auf jedem Debian-Spiegel gefunden werden.

note: type: Plain text
en: deb-extra-override - Debian archive extra override file
de: deb-extra-override - Debian-Archive Zusatz-override-Datei

note: type: Plain text
en: While most information about a binary/source package can be found in the control/.dsc file, all of it can be overridden when it's exported to Packages/Sources files. The extra override file contains those overrides.
de: Während der Großteil der Informationen über ein binäres oder Quellpaket in der Datei control/.dsc gefunden werden kann, kann alles davon überschrieben werden, wenn es in die Dateien Packages/Sources exportiert wird. Die Zusatz-override-Datei enthält diese »Überschreibungen« (engl. overrides).

note: type: Plain text
en: The extra override file has a simple whitespace-delimited format. Comments are allowed (denoted with a B<#>).
de: Die Zusatz-override-Datei hat ein einfaches, durch Leerzeichen getrenntes Format. Kommentare sind erlaubt (angezeigt durch ein B<#>).

note: type: Plain text
en: I<package> I<field-name> I<value>
de: I<Paket> I<Feldname> I<Wert>

note: type: Plain text
en: I<package> is the name of the binary/source package.
de: I<Paket> ist der Name des Binär-/Quellpakets.

note: type: Plain text
en: I<field-name> is the name of the field that is overridden.  I<value> is the value to put in the field. It can contain spaces as the line is split in no more than 3 columns when it's parsed.
de: I<Feldname> ist der Name des Feldes, das überschrieben wird. I<Wert> ist der in das Feld zu setzende Wert. Er kann Leerzeichen enthalten, da die Zeile in nicht mehr als drei Spalten aufgeteilt wird, wenn sie ausgewertet wird.

note: type: Plain text
en: The extra override files used to make the official Packages lists may be found in the I<indices> directory on any Debian mirror.
de: Die Zusatz-override-Dateien, die für die Erstellung der offiziellen Paketliste verwendet werden, können im I<indices>-Verzeichnis auf jedem Debian-Spiegel gefunden werden.

note: type: Plain text
en: deb-shlibs - Debian shared library information file
de: deb-shlibs - Debians Informationsdatei für Laufzeitbibliotheken

note: type: Plain text
en: B<shlibs> files map shared library names and versions (I<sonames>)  to dependencies suitable for a package control file.  There is one entry per line. Blank lines are B<not> allowed.  Lines beginning with an B<#> character are considered commentary, and are ignored.  All other lines must have the format
de: B<shlibs>-Dateien bilden Laufzeitbibliotheknamen und -versionen (I<sonames>) auf Abhängigkeiten ab, die für eine Paketsteuerdatei geeignet sind. Es gibt einen Eintrag pro Zeile. Leerzeilen sind B<nicht> erlaubt. Zeilen, die mit B<#> beginnen, werden als Kommentarzeilen betrachtet und ignoriert. Alle anderen Zeilen müssen dem nachfolgenden Format folgen:

note: type: Plain text
en: [I<type>B<:>] I<library> I<version> I<dependencies>
de: [I<Typ>B<:>] I<Bibliothek> I<Version> I<Abhängigkeiten>

note: type: Plain text
en: The I<library> and I<version> fields are whitespace-delimited, but the I<dependencies> field extends to the end of the line.  The I<type> field is optional and normally not needed.
de: Die Felder I<Bibliothek> und I<Version> werden durch Leerzeichen begrenzt, das Feld I<Abhängigkeiten> geht aber bis zum Ende der Zeile. Das Feld I<Typ> ist optional und wird normalerweise nicht benötigt.

note: type: Plain text
en: The I<dependencies> field has the same syntax as the B<Depends> field in a binary control file, see B<deb-control>(5).  See also the Debian Policy Manual for further details.
de: Das Feld I<dependencies> hat die gleiche Syntax wie das Feld B<Depends> in einer binären Steuerdatei, siehe B<deb-control>(5). Lesen Sie auch die Debian-Richtlinien für weitere Details.

note: type: Plain text
en: The B<shlibs> file for a typical library package, named I<libcrunch1>, that provides one library whose soname is I<libcrunch.so.1>, might read
de: Die B<shlibs>-Datei für ein typisches Bibliothekspaket namens I<libcrunch1>, das eine Bibliothek mit dem Sonamen I<libcrunch.so.1> bereitstellt, könnte wie folgt lauten:

note: type: Plain text
en: The I<dependencies> must mention the most recent version of the package that added new symbols to the library: in the above example, new symbols were added to version 1.2 of I<libcrunch>.  This is not the only reason the dependencies might need to be tightened; again, see the Debian Policy Manual for details.
de: I<Abhängigkeiten> muss die neuste Version des Pakets erwähnen, das neuen Symbole zu der Bibliothek hinzugefügt hat: im obigen Beispiel wurden neue Symbole zu Version 1.2 von I<libcrunch> hinzugefügt. Dies ist nicht der einzige Grund, dass Abhängigkeiten enger gefasst werden müssen; auch hier gilt: Lesen Sie das Debian-Richtlinienhandbuch für Details.

note: type: Plain text
en: deb-substvars - Debian source substitution variables
de: deb-substvars - Substitutionsvariablen in Debian-Quellen

note: type: Plain text
en: Before B<dpkg-source>, B<dpkg-gencontrol> and B<dpkg-genchanges> write their control information (to the source control file B<.dsc> for B<dpkg-source> and to standard output for B<dpkg-gencontrol> and B<dpkg-genchanges>)  they perform some variable substitutions on the output file.
de: Bevor B<dpkg-source>, B<dpkg-gencontrol> und B<dpkg-genchanges> ihre Steuerinformationen (zu der Quellsteuer-Datei B<.dsc> für B<dpkg-source> und zu der Standardausgabe für B<dpkg-gencontrol> und B<dpkg-genchanges>) schreiben, führen sie einige Variablensubstitutionen in der Ausgabedatei durch.

note: type: Plain text
en: A variable substitution has the form B<${>I<variable-name>B<}>.  Variable names consist of alphanumerics, hyphens and colons and start with an alphanumeric. Variable substitutions are performed repeatedly until none are left; the full text of the field after the substitution is rescanned to look for more substitutions.
de: Eine Variablensubstitution hat die Form B<${>I<Variablenname>B<}>. Variablennamen bestehen aus alphanumerischen Zeichen (womit sie auch beginnen), Gedankenstrichen und Doppelpunkten. Variablensubstitutionen werden wiederholt durchgeführt, bis keine übrig geblieben sind; der komplette Text des Feldes nach der Substitution wird erneut auf weitere Substitutionen geprüft.

note: type: Plain text
en: After all the substitutions have been done each occurrence of the string B<${}> (which is not a legal substitution) is replaced with a B<$> sign.
de: Nachdem alle Substitutionen erfolgt sind, wird jedes Auftreten der Zeichenkette B<${}> (die keine erlaubte Substitution ist) durch das B<$>-Zeichen ersetzt.

note: type: Plain text
en: While variable substitution is done on all control fields, some of those fields are used and needed during the build when the substitution did not yet occur. That's why you can't use variables in the B<Package>, B<Source> and B<Architecture> fields.
de: Obwohl die Variablensubstitution bei allen Feldern der Steuerdatei vorgenommen wird, werden einige dieser Felder während des Bauens benötigt und verwendet, wenn die Substitution noch nicht erfolgt ist. Daher können Sie Variablen nicht in den Feldern B<Package>, B<Source> und B<Architecture> verwenden.

note: type: Plain text
en: Variable substitution happens on the content of the fields after they have been parsed, thus if you want a variable to expand over multiple lines you do not have to include a space after the newline. This is done implicitly when the field is output. For example, if the variable B<${Description}> is set to "foo is bar.${Newline}foo is great." and if you have the following field:
de: Variablenersetzung erfolgt am Inhalt der Felder, nachdem sie geparst (ausgewertet) wurden. Falls Sie eine Variable über mehrere Zeilen expandieren möchten, müssen Sie nach dem Zeilenumbruch daher kein Leerzeichen einfügen. Dies passiert bei der Ausgabe des Feldes implizit. Ist beispielsweise die Variable B<${Description}> auf »foo ist bar.${Newline}foo ist super.« gesetzt und Sie haben das folgende Feld:

note: type: Plain text
en:  Description: foo application
      ${Description}
      .
      More text.
de:  Description: foo application
      ${Description}
      .
      Weiterer Text.

note: type: Plain text
en: It will result in:
de: Dann wird dies zu Folgenden führen:

note: type: Plain text
en:  Description: foo application
      foo is bar.
      foo is great.
      .
      More text.
de:  Description: foo application
      foo ist bar.
      foo ist super.
      .
      Weiterer Text.

note: type: Plain text
en: Variables can be set using the B<-V> common option. They can be also specified in the file B<debian/substvars> (or whatever other file is specified using the B<-T> option). This file consists of lines of the form I<name>B<=>I<value>.  Trailing whitespace on each line, blank lines, and lines starting with a B<#> symbol (comments) are ignored.
de: Variablen können über die allgemeine B<-V>-Option gesetzt werden. Sie können auch in der B<debian/substvars> (bzw. in der über die Option B<-T> gesetzten Datei) angegeben werden. Diese Datei besteht auch Zeilen der Form I<Name>B<=>I<Wert>. Leerzeichen am Zeilenende, leere Zeilen und Zeilen, die mit dem B<#>-Symbol starten (Kommentare) werden ignoriert.

note: type: Plain text
en: Additionally, the following standard variables are available:
de: Zusätzlich sind die folgenden Standardvariablen verfügbar:

note: type: Plain text
en: The current build architecture (from B<dpkg --print-architecture>).
de: Die aktuelle Bau-Architektur (von B<dpkg --print-architecture>).

note: type: Plain text
en: The source package version.
de: Die Quellpaket-Version.

note: type: Plain text
en: The upstream source package version, including the Debian version epoch if any.
de: Die Paketversion der Originalautoren, einschließlich der Epoche der Debian-Version, falls vorhanden.

note: type: Plain text
en: The binary package version (which may differ from source:Version in a binNMU for example).
de: Die Binärpaketversion (die z.B. in einem binNMU von source:Version abweichen kann).

note: type: Plain text
en: The source package version (from the changelog file). This variable is now B<deprecated> as its meaning is different from its function, please use the B<source:Version> or B<binary:Version> as appropriate.
de: Die Quellpaketversion (aus der changelog-Datei). Diese Variable ist jetzt B<veraltet>, da ihre Bedeutung von ihrer Funktion abweicht, bitte verwenden Sie B<source:Version> oder B<binary:Version> wo zutreffend.

note: type: Plain text
en: The total size of the package's installed files. This value is copied into the corresponding control file field; setting it will modify the value of that field. If this variable isn't set B<dpkg-gencontrol> will use B<du -k debian/tmp> to find the default value.
de: Die Gesamtgröße der vom Paket installierten Dateien. Dieser Wert wird in das entsprechende Feld der »control«-Datei kopiert; wird es gesetzt, verändert es den Wert dieses Feldes. Falls diese Variable nicht gesetzt ist, wird B<dpkg-gencontrol> »B<du -k debian/tmp>« verwenden, um den Standardwert zu ermitteln.

note: type: Plain text
en: Additional disk space used when the package is installed. If this variable is set its value is added to that of the B<Installed-Size> variable (whether set explicitly or using the default value) before it is copied into the B<Installed-Size> control file field.
de: Zusätzlicher Plattenplatz, der verwendet wird, wenn das Paket installiert ist. Falls diese Variable gesetzt ist, wird dieser Wert zu der B<Installed-Size>-Variablen hinzuaddiert (egal ob sie explizit gesetzt oder der Standardwert verwendet wird), bevor sie in das Feld B<Installed-Size> der »control«-Datei kopiert wird.

note: type: TP
en: B<F:>I<fieldname>
de: B<F:>I<Feldname>

note: type: Plain text
en: The value of the output field I<fieldname> (which must be given in the canonical capitalisation). Setting these variables has no effect other than on places where they are expanded explicitly.
de: Der Wert des Ausgabefeldes I<Feldname> (der in der kanonischen Groß-/Kleinschreibung angegeben werden muss). Das Setzen dieser Variablen hat nur einen Effekt an den Stellen, wo diese explizit expandiert werden.

note: type: Plain text
en: The B<.changes> file format version generated by this version of the source packaging scripts. If you set this variable the contents of the B<Format> field in the B<.changes> file will change too.
de: Die Formatversion der B<.changes>-Datei, die von dieser Version der Quellpaketierskripte erstellt wird. Falls Sie diese Variable setzen, werden die Inhalte des B<Format>-Feldes in der B<.changes>-Datei auch geändert.

note: type: Plain text
en: These variables each hold the corresponding character.
de: Diese Variablen enthalten das jeweils korrespondieren Zeichen (B<Zeilenumbruch>, B<Leerzeichen> und B<Tabulator> in dieser Reihenfolge).

note: type: Plain text
en: Variable settings with names of this form are generated by B<dpkg-shlibdeps>.
de: Variableneinstellungen mit Namen dieser Form werden von B<dpkg-shlibdeps> erstellt.

note: type: Plain text
en: The upstream version of dpkg.
de: Die Original- (Upstream-)Version von Dpkg.

note: type: Plain text
en: The full version of dpkg.
de: Die komplette Version von Dpkg.

note: type: Plain text
en: If a variable is referred to but not defined it generates a warning and an empty value is assumed.
de: Falls auf eine Variable Bezug genommen wird, diese aber nicht definiert ist, wird es eine Warnung erstellen und ein leerer Wert wird angenommen.

note: type: Plain text
en: List of substitution variables and values.
de: Liste von Substitutionsvariablen und -werten.

note: type: Plain text
en: The point at which field overriding occurs compared to certain standard output field settings is rather confused.
de: Die Stelle, an der das Überschreiben von Feldern passiert, verglichen mit bestimmten Standard-Ausgabe-Feldeinstellungen, ist eher konfus.

note: type: Plain text
en: deb-symbols - Debian's extended shared library information file
de: deb-symbols - Debians erweiterte Informationsdatei von Laufzeitbibliotheken

note: type: Plain text
en: The format for an extended shared library dependency information entry in these files is:
de: Das Format eines Eintrags für eine erweiterte Abhängigkeitsinformation einer Laufzeitbibliothek (»shared library«) lautet:

note: type: Plain text
en: I<library-soname main-dependency-template>
de: I<Bibliotheks-Soname Hauptabhängigkeitsvorlage>

note: type: Plain text
en: [| I<alternative-dependency-template>]
de: [| I<alternative-Abhängigkeitsvorlage>]

note: type: Plain text
en: [...]
de: […]

note: type: Plain text
en: [* I<field-name>: I<field-value>]
de: [* I<Feldname>: I<Feldwert>]

note: type: Plain text
en: [...]
     I<symbol> I<minimal-version> [I<id-of-dependency-template>]
de: […]
     I<Symbol> I<Minimalversion> [I<Kennung-der-Abhängigkeitsvorlage>]

note: type: Plain text
en: The I<library-soname> is exactly the value of the SONAME field as exported by B<objdump>(1). A I<dependency-template> is a dependency where I<#MINVER#> is dynamically replaced either by a version check like "(E<gt>= I<minimal-version>)" or by nothing (if an unversioned dependency is deemed sufficient).
de: Der I<Bibliotheks-Soname> ist genau der Wert des SONAME-Feldes, wie er von B<objdump>(1) exportiert wird. Eine I<Abhängigkeitsvorlage> ist eine Abhängigkeit, in der I<#MINVER#> dynamisch entweder von einer Versionsprüfung der Art »(E<gt>= I<Minimalversion>)« oder durch nichts ersetzt wird, falls eine nicht-versionierte Abhängigkeit als ausreichend erachtet wird.

note: type: Plain text
en: Each exported I<symbol> (listed as I<name>@I<version>, with I<version> being "Base" if the library is not versioned) is associated to a I<minimal-version> of its dependency template (the main dependency template is used if I<id-of-dependency-template> is not present). The first alternative dependency template is numbered 1, the second one 2, etc.
de: Jedem exportierten I<Symbol> (aufgeführt als I<Name>@I<Version>, mit I<Version> als »Base«, falls die Bibliothek nicht versioniert ist) wird eine I<Minimalversion> seiner Abhängigkeitsvorlage zugeordnet (die Hauptabhängigkeitsvorlage wird verwandt, falls die I<Kennung-der-Abhängigkeitsvorlage> nicht vorhanden ist). Die erste alternative Abhängigkeitsvorlage wird mit 1 nummeriert, die zweite mit 2 usw.

note: type: Plain text
en: Each entry for a library can also have some fields of meta-information.  Those fields are stored on lines starting with an asterisk. Currently, the only valid field is I<Build-Depends-Package>, it indicates the name of the "-dev" package associated to the library and is used by B<dpkg-shlibdeps> to make sure that the dependency generated is at least as strict as the corresponding build dependency.
de: Jeder Eintrag für eine Bibliothek kann auch einige Felder mit Metainformationen enthalten. Diese Felder werden in Zeilen gespeichert, die mit einem Stern beginnen. Derzeit ist I<Build-Depends-Package> das einzige gültige Feld, es gibt den Namen des »-dev«-Pakets an, das der Bibliothek zugeordnet ist, und wird von B<dpkg-shlibdeps> verwandt, um sicherzustellen, dass die erstellte Abhängigkeit mindestens genauso strikt ist wie die zugehörige Bau-Abhängigkeit.

note: type: SS
en: Simple symbols file
de: Einfache Symboldatei

note: type: Plain text
en: libftp.so.3 libftp3 #MINVER#
     DefaultNetbuf@Base 3.1-1-6
     FtpAccess@Base 3.1-1-6
     [...]
de: libftp.so.3 libftp3 #MINVER#
     DefaultNetbuf@Base 3.1-1-6
     FtpAccess@Base 3.1-1-6
     […]

note: type: SS
en: Advanced symbols file
de: Fortgeschrittene Symboldatei

note: type: Plain text
en: * Build-Depends-Package: libgl1-mesa-dev
     publicGlSymbol@Base 6.3-1
     [...]
     implementationSpecificSymbol@Base 6.5.2-7 1
     [...]
de: * Build-Depends-Package: libgl1-mesa-dev
     publicGlSymbol@Base 6.3-1
     […]
     implementationSpecificSymbol@Base 6.5.2-7 1
     […]

note: type: Plain text
en: deb-triggers - package triggers
de: deb-triggers - Paket-Trigger

note: type: Plain text
en: A package declares its relationship to some trigger(s) by including a I<triggers> file in its control archive (i.e. I<DEBIAN/triggers> during package creation).
de: Ein Paket erklärt seine Beziehung zu einigen Trigger(n) (deutsch: Auslösern) indem es eine Datei I<triggers> in seinem Steuerarchiv (d.h. I<DEBIAN/triggers> während der Paketerstellung) hinzunimmt.

note: type: Plain text
en: This file contains directives, one per line. Leading and trailing whitespace and everything after the first B<#> on any line will be trimmed, and empty lines will be ignored.
de: Diese Datei enthält Direktiven, eine pro Zeile. Leerzeichen am Anfang und Ende sowie alles nach dem ersten B<#> werden in jeder Zeile entfernt und leere Zeilen werden ignoriert.

note: type: Plain text
en: The trigger control directives currently supported are:
de: Die derzeit unterstützten Steuerdirektiven für Trigger sind:

note: type: Plain text
en: B<interest> I<trigger-name>
de: B<interest> I<Trigger-Name>

note: type: Plain text
en: B<interest-noawait> I<trigger-name>
de: B<interest-noawait> I<Trigger-Name>

note: type: Plain text
en: Specifies that the package is interested in the named trigger. All triggers in which a package is interested must be listed using this directive in the triggers control file. The "noawait" variant does not put the triggering packages in triggers-awaited state. This should be used when the functionality provided by the trigger is not crucial.
de: Gibt an, dass das Paket an dem benannten Trigger interessiert ist. Alle Trigger, an denen ein Paket interessiert ist, müssen mit dieser Direktive in der Trigger-Steuerdatei aufgeführt werden. Die Variante »noawait« setzt die triggernden Pakete nicht in den Zustand »triggers-awaited«. Dies sollte verwandt werden, wenn die von den Triggern bereitgestellte Funktionalität nicht äußerst wichtig ist.

note: type: Plain text
en: B<activate> I<trigger-name>
de: B<activate> I<Trigger-Name>

note: type: Plain text
en: B<activate-noawait> I<trigger-name>
de: B<activate-noawait> I<Trigger-Name>

note: type: Plain text
en: Arranges that changes to this package's state will activate the specified trigger. The trigger will be activated at the start of the following operations: unpack, configure, remove (including for the benefit of a conflicting package), purge and deconfigure.  The "noawait" variant does not put the triggering packages in triggers-awaited state. This should be used when the functionality provided by the trigger is not crucial.
de: Sorgt dafür, dass Änderungen an dem Zustand dieses Pakets einen spezifizierten Trigger aktiviert. Der Trigger wird am Beginn folgender Operationen aktiviert: unpack, configure, remove (hinzugefügt zum Nutzen von Paketen, die im Konflikt zueinander stehen), purge und deconfigure. Die Variante »noawait« setzt die triggernden Pakete nicht in den Zustand »triggers-awaited«. Dies sollte verwandt werden, wenn die von den Triggern bereitgestellte Funktionalität nicht äußerst wichtig ist.

note: type: Plain text
en: If this package disappears during the unpacking of another package the trigger will be activated when the disappearance is noted towards the end of the unpack. Trigger processing, and transition from triggers-awaited to installed, does not cause activations.  In the case of unpack, triggers mentioned in both the old and new versions of the package will be activated.
de: Falls dieses Paket während des Entpackens eines anderen Pakets verschwindet, wird der Trigger aktiviert, wenn das Verschwinden während des Endes der unpack-Operation bemerkt wird. Triggerverarbeitung und Übergänge von Trigger-erwartend auf installiert führen nicht zu Aktivierungen. Im Falle von unpack werden sowohl die in der alten als auch die in der neuen Version des Pakets angegebenen Trigger aktiviert.

note: type: Plain text
en: Unknown directives are an error which will prevent installation of the package.
de: Unbekannte Direktiven sind ein Fehler, der die Installation eines Pakets verhindert.

note: type: Plain text
en: The "-noawait" variants are only supported by dpkg 1.16.1 or newer, and will lead to errors if used with an older dpkg. It is thus recommended to add a "Pre-Depends: dpkg (E<gt>= 1.16.1)" to any package that wish to use those directives.
de: Die Varianten »-noawait« werden nur von Dpkg 1.16.1 oder neuer unterstützt und werden bei älteren Dpkg zu Fehlern führen. Es wird daher empfohlen, ein »Pre-Depends: dpkg (E<gt>= 1.16.1)« zu jedem Paket hinzuzufügen, dass diese Direktiven nutzen möchte.

note: type: TH
en: dpkg suite
de: dpkg-Programmsammlung

note: type: Plain text
en: dpkg - package manager for Debian
de: dpkg - Paketverwalter für Debian

note: type: Plain text
en: B<dpkg> [I<option>...] I<action>
de: B<dpkg> [I<Option> …] I<Aktionen>

note: type: SH
en: WARNING
de: WARNUNG

note: type: Plain text
en: This manual is intended for users wishing to understand B<dpkg>'s command line options and package states in more detail than that provided by B<dpkg --help>.
de: Dieses Handbuch ist für Benutzer gedacht, die die Kommandozeilenoptionen und Paketzustände von B<dpkg> detaillierter verstehen wollen, als durch B<dpkg --help> beschrieben ist.

note: type: Plain text
en: It should I<not> be used by package maintainers wishing to understand how B<dpkg> will install their packages. The descriptions of what B<dpkg> does when installing and removing packages are particularly inadequate.
de: Es sollte I<nicht> von Paketbetreuern verwendet werden, die verstehen wollen, wie B<dpkg> ihr Paket installieren wird. Die Beschreibung von den Tätigkeiten von B<dpkg> beim Installieren und Entfernen von Paketen ist besonders unzulänglich.

note: type: Plain text
en: B<dpkg> is a tool to install, build, remove and manage Debian packages. The primary and more user-friendly front-end for B<dpkg> is B<aptitude>(1). B<dpkg> itself is controlled entirely via command line parameters, which consist of exactly one action and zero or more options. The action-parameter tells B<dpkg> what to do and options control the behavior of the action in some way.
de: B<dpkg> ist ein Werkzeug, um Debian-Pakete zu installieren, zu bauen und zu verwalten. Die primäre und benutzerfreundlichere Oberfläche für B<dpkg> ist B<aptitude>(1). B<dpkg> selbst wird komplett über Kommandozeilenoptionen gesteuert, die aus genau einer Aktion und Null oder mehreren Optionen bestehen. Der Aktionsparameter teilt B<dpkg> mit, was zu tun ist, und die Optionen steuern die Aktionen in irgendeiner Weise.

note: type: Plain text
en: B<dpkg> can also be used as a front-end to B<dpkg-deb>(1) and B<dpkg-query>(1). The list of supported actions can be found later on in the B<ACTIONS> section. If any such action is encountered B<dpkg> just runs B<dpkg-deb> or B<dpkg-query> with the parameters given to it, but no specific options are currently passed to them, to use any such option the back-ends need to be called directly.
de: B<dpkg> kann auch als Oberfläche für B<dpkg-deb>(1) und B<dpkg-query>(1) verwendet werden. Die Liste der unterstützen Aktionen kann im Abschnitt B<AKTIONEN> gefunden werden. Falls so eine Aktion angetroffen wird, führt B<dpkg> einfach B<dpkg-deb> oder B<dpkg-query> mit den übergebenen Parametern aus, allerdings werden derzeit keine spezifischen Optionen an diese übergeben. Um solche Optionen zu verwenden, müssen die Backends direkt aufgerufen werden.

note: type: SH
en: INFORMATION ABOUT PACKAGES
de: INFORMATIONEN ÜBER PAKETE

note: type: Plain text
en: B<dpkg> maintains some usable information about available packages. The information is divided in three classes: B<states>, B<selection states> and B<flags>. These values are intended to be changed mainly with B<dselect>.
de: B<dpkg> verwaltet einige nützliche Informationen über verfügbare Pakete. Die Informationen sind in drei Klassen unterteilt: B<Status>, B<Auswahlstatus> und B<Schalter>. Diese Werte sind hauptsächlich zur Änderung durch B<dselect> gedacht.

note: type: SS
en: PACKAGE STATES
de: PAKETZUSTÄNDE

note: type: TP
en: B<not-installed>
de: B<not-installed> (nicht-installiert)

note: type: Plain text
en: The package is not installed on your system.
de: Das Paket ist nicht auf Ihrem System installiert.

note: type: TP
en: B<config-files>
de: B<config-files> (Config-Dateien)

note: type: Plain text
en: Only the configuration files of the package exist on the system.
de: Nur die Konfigurationsdateien des Pakets existieren auf dem System.

note: type: TP
en: B<half-installed>
de: B<half-installed> (halb-installiert)

note: type: Plain text
en: The installation of the package has been started, but not completed for some reason.
de: Die Installation des Paketes wurde begonnen, aber aus irgendeinem Grund nicht abgeschlossen.

note: type: TP
en: B<unpacked>
de: B<unpacked> (entpackt)

note: type: Plain text
en: The package is unpacked, but not configured.
de: Das Paket ist entpackt, aber nicht konfiguriert.

note: type: TP
en: B<half-configured>
de: B<half-configured> (halb-konfiguriert)

note: type: Plain text
en: The package is unpacked and configuration has been started, but not yet completed for some reason.
de: Das Paket ist entpackt und die Konfiguration wurde begonnen, aber aus irgendeinem Grund nicht abgeschlossen.

note: type: TP
en: B<triggers-awaited>
de: B<triggers-awaited> (triggers-awaited)

note: type: Plain text
en: The package awaits trigger processing by another package.
de: Das Paket erwartet Trigger-Verarbeitung durch ein anderes Paket.

note: type: TP
en: B<triggers-pending>
de: B<triggers-pending> (triggers-pending)

note: type: Plain text
en: The package has been triggered.
de: Das Paket wurde getriggert.

note: type: TP
en: B<installed>
de: B<installed> (installiert)

note: type: Plain text
en: The package is unpacked and configured OK.
de: Das Paket ist entpackt und konfigurierte korrekt.

note: type: SS
en: PACKAGE SELECTION STATES
de: PAKETAUSWAHL-STATUS

note: type: TP
en: B<install>
de: B<installiere>

note: type: Plain text
en: The package is selected for installation.
de: Das Paket ist zur Installation ausgewählt.

note: type: TP
en: B<hold>
de: B<halten>

note: type: Plain text
en: A package marked to be on B<hold> is not handled by B<dpkg>, unless forced to do that with option B<--force-hold>.
de: Ein Paket, das mit B<halten> markiert ist, wird von B<dpkg> nicht behandelt, es sei denn Sie erzwingen dies mit der Option B<--force-hold>.

note: type: TP
en: B<deinstall>
de: B<deinstalliere>

note: type: Plain text
en: The package is selected for deinstallation (i.e. we want to remove all files, except configuration files).
de: Das Paket ist zur Deinstallation ausgewählt (d.h. wir wollen alle Dateien außer den Konfigurationsdateien entfernen).

note: type: TP
en: B<purge>
de: B<vollständig löschen>

note: type: Plain text
en: The package is selected to be purged (i.e. we want to remove everything from system directories, even configuration files).
de: Das Paket ist zum vollständigen Löschen (»purge«) ausgewählt (d.h. wir wollen alle Dateien aus den Systemverzeichnissen inklusive der Konfigurationsdateien entfernen).

note: type: SS
en: PACKAGE FLAGS
de: PAKET-SCHALTER

note: type: TP
en: B<reinst-required>
de: B<Neuinst. notw>

note: type: Plain text
en: A package marked B<reinst-required> is broken and requires reinstallation. These packages cannot be removed, unless forced with option B<--force-remove-reinstreq>.
de: Ein mit B<Neuinst. notw> markiertes Paket ist defekt und muss erneut installiert werden. Diese Pakete können nicht entfernt werden, es sei denn, Sie erzwingen dies mit der Option B<--force-remove-reinstreq>.

note: type: SH
en: ACTIONS
de: AKTIONEN

note: type: TP
en: B<-i>, B<--install> I<package-file>...
de: B<-i>, B<--install> I<Paketdatei> …

note: type: Plain text
en: Install the package. If B<--recursive> or B<-R> option is specified, I<package-file> must refer to a directory instead.
de: Installiere das Paket. Falls die B<--recursive> oder B<-R>-Option angegeben ist, muss sich I<Paketdatei> stattdessen auf ein Verzeichnis beziehen.

note: type: Plain text
en: Installation consists of the following steps:
de: Die Installation besteht aus folgenden Schritten:

note: type: Plain text
en: B<1.> Extract the control files of the new package.
de: B<1.> Extrahiere die Steuerdateien aus dem neuen Paket.

note: type: Plain text
en: B<2.> If another version of the same package was installed before the new installation, execute I<prerm> script of the old package.
de: B<2.> Falls eine andere Version des gleichen Pakets vor der der neuen Installation installiert war, dann führe das I<prerm>-Skript des alten Paketes aus.

note: type: Plain text
en: B<3.> Run I<preinst> script, if provided by the package.
de: B<3.> Führe das I<preinst>-Skript aus, falls dies vom Paket bereitgestellt wird.

note: type: Plain text
en: B<4.> Unpack the new files, and at the same time back up the old files, so that if something goes wrong, they can be restored.
de: B<4.> Entpacke die neuen Dateien und sichere gleichzeitig die alten Dateien, so dass diese, falls etwas schief geht, wiederhergestellt werden können.

note: type: Plain text
en: B<5.> If another version of the same package was installed before the new installation, execute the I<postrm> script of the old package. Note that this script is executed after the I<preinst> script of the new package, because new files are written at the same time old files are removed.
de: B<5.> Falls eine andere Version des gleichen Pakets vor der der neuen Installation installiert war, dann führe das I<postrm>-Skript des alten Paketes aus. Beachten Sie, dass dieses Skript nach dem I<preinst>-Skript des neuen Pakets ausgeführt wird, da neue Dateien zeitgleich zu der Entfernung alter Dateien geschrieben werden.

note: type: Plain text
en: B<6.> Configure the package. See B<--configure> for detailed information about how this is done.
de: B<6.> Konfiguriere das Paket. Lesen Sie B<--configure> für detaillierte Informationen wie dies geschieht.

note: type: TP
en: B<--unpack >I<package-file>...
de: B<--unpack >I<Paketdatei> …

note: type: Plain text
en: Unpack the package, but don't configure it. If B<--recursive> or B<-R> option is specified, I<package-file> must refer to a directory instead.
de: Entpacke das Paket, aber konfiguriere es nicht. Falls die B<--recursive> oder B<-R>-Option angegeben ist, muss sich I<Paketdatei> stattdessen auf ein Verzeichnis beziehen.

note: type: TP
en: B<--configure >I<package>...|B<-a>|B<--pending>
de: B<--configure >I<Paket> …|B<-a>|B<--pending>

note: type: Plain text
en: Configure a package which has been unpacked but not yet configured.  If B<-a> or B<--pending> is given instead of I<package>, all unpacked but unconfigured packages are configured.
de: Konfiguriert ein entpacktes aber noch nicht konfiguriertes Paket. Falls B<-a> oder B<--pending> anstelle von I<Paket> angegeben ist, werden alle entpackten aber nicht konfigurierten Pakete konfiguriert.

note: type: Plain text
en: To reconfigure a package which has already been configured, try the B<dpkg-reconfigure>(8)  command instead.
de: Um ein Paket zu rekonfigurieren, dass bereits konfiguriert wurde, verwenden Sie stattdessen den Befehl B<dpkg-reconfigure>(8).

note: type: Plain text
en: Configuring consists of the following steps:
de: Die Konfiguration besteht aus folgenden Schritten:

note: type: Plain text
en: B<1.> Unpack the conffiles, and at the same time back up the old conffiles, so that they can be restored if something goes wrong.
de: B<1.> Entpacke die Conffiles und sichere gleichzeitig die alten Conffiles, so dass diese, falls etwas schief geht, wiederhergestellt werden können.

note: type: Plain text
en: B<2.> Run I<postinst> script, if provided by the package.
de: B<2.> Führe das I<postinst>-Skript aus, falls dies vom Paket bereitgestellt wird.

note: type: TP
en: B<--triggers-only> I<package>...|B<-a>|B<--pending>
de: B<--triggers-only> I<Paket> …|B<-a>|B<--pending>

note: type: Plain text
en: Processes only triggers. All pending triggers will be processed. If package names are supplied only those packages' triggers will be processed, exactly once each where necessary. Use of this option may leave packages in the improper B<triggers-awaited> and B<triggers-pending> states. This can be fixed later by running: B<dpkg --configure --pending>.
de: Verarbeite nur Trigger. Alle ausstehenden Trigger werden verarbeitet. Falls Paketnamen übergeben werden, werden nur die Trigger dieser Pakete verarbeitet, jedes genau einmal wo notwendig. Die Verwendung dieser Option kann Pakete in die unzulässigen Stati B<triggers-awaited> und B<triggers-pending> bringen. Durch die Ausführung von »B<dpkg --configure --pending>« kann dies später behoben werden.

note: type: TP
en: B<-r>, B<--remove>, B<-P>, B<--purge >I<package>...|B<-a>|B<--pending>
de: B<-r>, B<--remove>, B<-P>, B<--purge >I<Paket> …|B<-a>|B<--pending>

note: type: Plain text
en: Remove an installed package. B<-r> or B<--remove> remove everything except conffiles. This may avoid having to reconfigure the package if it is reinstalled later. (Conffiles are configuration files that are listed in the I<DEBIAN/conffiles> control file). B<-P> or B<--purge> removes everything, including conffiles. If B<-a> or B<--pending> is given instead of a package name, then all packages unpacked, but marked to be removed or purged in file I</var/lib/dpkg/status>, are removed or purged, respectively. Note: some configuration files might be unknown to B<dpkg> because they are created and handled separately through the configuration scripts. In that case, B<dpkg> won't remove them by itself, but the package's I<postrm> script (which is called by B<dpkg>), has to take care of their removal during purge. Of course, this only applies to files in system directories, not configuration files written to individual users' home directories.
de: Entferne ein installiertes Paket. B<-r> oder B<--remove> entfernen alles außer Conffiles. Dies könnte die Rekonfiguration vermeiden, falls das Paket später wieder reinstalliert wird. (Conffiles sind die Konfigurationsdateien, die in der I<debian/conffiles>-Steuerdatei aufgeführt sind). B<-P> oder B<--purge> entfernt alles, auch Conffiles. Falls B<-a> oder B<--pending> anstatt eines Paketnamens angegeben werden, dann werden alle Pakete, die entpackt aber zur Entfernung oder vollständigen Löschung in der Datei I</var/lib/dpkg/status> markiert sind, entfernt beziehungsweise vollständig gelöscht. Hinweis: Einige Konfigurationsdateien können B<dpkg> nicht bekannt sein, da sie separat durch die Konfigurationsskripte angelegt und verwaltet werden. In diesem Fall wird B<dpkg> sie nicht selbst entfernen sondern das Skript I<postrm> (das von B<dpkg> aufgerufen wird) des Pakets muss sich während des vollständigen Löschens um das Entfernen kümmern. Natürlich betrifft dies nur Dateien in den Systemverzeichnissen, nicht Konfigurationsdateien, die in die Home-Verzeichnisse der individuellen Benutzer geschrieben werden.

note: type: Plain text
en: Removing of a package consists of the following steps:
de: Entfernung eines Paketes besteht aus den folgenden Schritte:

note: type: Plain text
en: B<1.> Run I<prerm> script
de: B<1.> Führe das I<prerm>-Skript aus

note: type: Plain text
en: B<2.> Remove the installed files
de: B<2.> Entferne die installierten Dateien

note: type: Plain text
en: B<3.> Run I<postrm> script
de: B<3.> Führe das I<postrm>-Skript aus

note: type: TP
en: B<--update-avail>, B<--merge-avail> I<Packages-file>
de: B<--update-avail>, B<--merge-avail> I<Packages-Datei>

note: type: Plain text
en: Update B<dpkg>'s and B<dselect>'s idea of which packages are available. With action B<--merge-avail>, old information is combined with information from I<Packages-file>. With action B<--update-avail>, old information is replaced with the information in the I<Packages-file>. The I<Packages-file> distributed with Debian is simply named I<Packages>. B<dpkg> keeps its record of available packages in I</var/lib/dpkg/available>.
de: Aktualisiere B<dpkg>s und B<dselect>s Verständnis darüber, welche Pakete verfügbar sind. Mit der Aktion B<--merge-avail> wird alte Information mit der Information aus der I<Packages-Datei> zusammengeführt. Mit der Aktion B<--update-avail> wird die alte Information durch die Information aus der I<Packages-Datei> ersetzt. Die mit Debian vertriebene I<Packages-Datei> heißt einfach I<Packages>. B<dpkg> hält seine Aufzeichnungen über die verfügbaren Pakete in I</var/lib/dpkg/available>.

note: type: Plain text
en: A simpler one-shot command to retrieve and update the I<available> file is B<dselect update>. Note that this file is mostly useless if you don't use B<dselect> but an APT-based frontend: APT has its own system to keep track of available packages.
de: Ein einfacher Befehl, um die Datei I<available> in einem Rutsch zu holen und zu aktualisieren ist B<dselect update>. Beachten Sie, dass diese Datei nahezu nutzlos ist, falls Sie nicht B<dselect> sondern eine APT-basierte Oberfläche verwenden: APT verfügt über sein eigenes System, die verfügbaren Pakete zu überwachen.

note: type: TP
en: B<-A>, B<--record-avail> I<package-file>...
de: B<-A>, B<--record-avail> I<Paketdatei> …

note: type: Plain text
en: Update B<dpkg> and B<dselect>'s idea of which packages are available with information from the package I<package-file>. If B<--recursive> or B<-R> option is specified, I<package-file> must refer to a directory instead.
de: Aktualisiere mit den Informationen aus dem Paket I<Paketdatei> B<dpkg>s und B<dselect>s Verständnis darüber, welche Pakete verfügbar sind. Falls die B<--recursive> oder B<-R>-Option angegeben ist, muss sich I<Paketdatei> stattdessen auf ein Verzeichnis beziehen.

note: type: Plain text
en: Now B<obsolete> and a no-op as B<dpkg> will automatically forget uninstalled unavailable packages.
de: Jetzt B<veraltet> und ohne Funktion, da B<dpkg> automatisch nicht installierte nicht verfügbare Pakete vergisst.

note: type: Plain text
en: Erase the existing information about what packages are available.
de: Lösche die existierenden Informationen darüber, welche Pakete verfügbar sind.

note: type: Plain text
en: Searches for packages that have been installed only partially on your system. B<dpkg> will suggest what to do with them to get them working.
de: Suche nach Pakete, die in Ihrem System nur teilweise installiert wurden. B<dpkg> wird Vorschläge machen, was mit ihnen geschehen soll, um sie in Funktion zu bringen.

note: type: TP
en: B<--get-selections> [I<package-name-pattern>...]
de: B<--get-selections> [I<Paket-Name-Muster> …]

note: type: Plain text
en: Get list of package selections, and write it to stdout. Without a pattern, non-installed packages (i.e. those which have been previously purged)  will not be shown.
de: Hole Liste von Paketauswahlen und schreibe sie auf die Standardausgabe. Ohne Muster werden nicht-installierte Pakete (d.h. solche, die vorher »vollständig gelöscht« wurden) nicht angezeigt.

note: type: Plain text
en: Set package selections using file read from stdin. This file should be in the format 'I<package> I<state>', where state is one of B<install>, B<hold>, B<deinstall> or B<purge>. Blank lines and comment lines beginning with '#' are also permitted.
de: Setze die Paketauswahl durch Einlesen einer Datei von der Standardeingabe. Diese Datei sollte im Format »I<Paket> I<Zustand>« sein, wobei Zustand einer aus B<install>, B<hold>, B<deinstall> oder B<purge> ist. Leerzeilen und Kommentarzeilen (beginnend mit »#«) sind auch erlaubt.

note: type: Plain text
en: Set the requested state of every non-essential package to deinstall.  This is intended to be used immediately before --set-selections, to deinstall any packages not in list given to --set-selections.
de: Setze den erbetenen Zustand von jedem nicht-essenziellen Paket auf »Deinstallation«. Dies ist dazu gedacht, direkt vor --set-selections verwendet zu werden, um jedes Paket, dass nicht in der Liste von --set-selections vorkommt, zu deinstallieren.

note: type: Plain text
en: Searches for packages selected for installation, but which for some reason still haven't been installed.
de: Sucht nach Paketen, die zur Installation ausgewählt wurden, die aber aus irgendeinem Grund noch nicht installiert wurden.

note: type: TP
en: B<--add-architecture >I<architecture>
de: B<--add-architecture >I<Architektur>

note: type: Plain text
en: Add I<architecture> to the list of architectures for which packages can be installed without using B<--force-architecture>. The architecture B<dpkg> is built for (i.e. the output of B<--print-architecture>)  is always part of that list.
de: Fügt I<Architektur> zu der Liste von Architekturen hinzu, für die Pakete ohne die Verwendung von B<--force-architecture> installiert werden können. Die Architektur, für die B<dpkg> gebaut wurde (d.h. der Ausgabe von B<--print-architecture>), ist immer Teil der Liste.

note: type: TP
en: B<--remove-architecture >I<architecture>
de: B<--remove-architecture >I<Architektur>

note: type: Plain text
en: Remove I<architecture> from the list of architectures for which packages can be installed without using B<--force-architecture>. If the architecture is currently in use in the database then the operation will be refused, except if B<--force-architecture> is specified. The architecture B<dpkg> is built for (i.e. the output of B<--print-architecture>) can never be removed from that list.
de: Entfernt I<Architektur> von der Liste von Architekturen, für die Pakete ohne die Verwendung von B<--force-architecture> installiert werden können. Falls die Architektur derzeit in der Datenbank benutzt wird, dann wird die Durchführung verweigert, falls nicht B<--force-architecture> verwandt wird. Die Architektur, für die B<dpkg> gebaut wurde (d.h. der Ausgabe von B<--print-architecture>), kann niemals von der Liste entfernt werden.

note: type: Plain text
en: Print architecture of packages B<dpkg> installs (for example, "i386").
de: Gebe die Architektur der Pakete aus, die B<dpkg> installiert (beispielsweise »i386«).

note: type: Plain text
en: Print a newline-separated list of the extra architectures B<dpkg> is configured to allow packages to be installed for.
de: Gibt eine durch Zeilenumbrüche getrennte Liste von zusätzlichen Architekturen aus, für die B<dpkg> konfiguriert ist, Paketinstallationen für zu erlauben.

note: type: TP
en: B<--compare-versions >I<ver1 op ver2>
de: B<--compare-versions >I<Ver1 Op Ver2>

note: .TP .B \-\-command\-fd \fIn\fP Accept a series of commands on input file descriptor \fIn\fP. Note: additional options set on the command line, and through this file descriptor, are not reset for subsequent commands executed during the same run. type: Plain text
en: Compare version numbers, where I<op> is a binary operator. B<dpkg> returns success (zero result) if the specified condition is satisfied, and failure (nonzero result) otherwise. There are two groups of operators, which differ in how they treat an empty I<ver1> or I<ver2>. These treat an empty version as earlier than any version: B<lt le eq ne ge gt>. These treat an empty version as later than any version: B<lt-nl le-nl ge-nl gt-nl>. These are provided only for compatibility with control file syntax: B<E<lt> E<lt>E<lt> E<lt>= = E<gt>= E<gt>E<gt> E<gt>>.
de: Vergleiche Versionsnummern, wobei I<Op> ein binärer Operator ist. B<dpkg> liefert Erfolg (Nullergebnis) falls die angegebene Bedingung erfüllt ist und einen Fehler (nicht-Null-Ergebnis) andernfalls. Es gibt zwei Gruppen von Operatoren, die sich in der Behandlung von leeren I<Ver1> oder I<Ver2> unterscheiden. Die folgenden behandeln leere Versionen als jünger als jede andere Version: B<lt le eq ne ge gt>. Die folgenden behandeln eine leere Version als älter als jede Version: B<lt-nl le-nl ge-nl gt-nl>. Die folgenden sind nur aus Kompatibilität mit der Steuerdateisyntax bereitgestellt: B<E<lt> E<lt>E<lt> E<lt>= = E<gt>= E<gt>E<gt> E<gt>>.

note: type: Plain text
en: Display a brief help message.
de: Zeige eine kurze Hilfenachricht an.

note: type: Plain text
en: Give help about the B<--force->I<thing> options.
de: Gebe Hilfe über die B<--force->I<Sache>-Optionen aus.

note: type: Plain text
en: Give help about debugging options.
de: Gebe Hilfe über Debugging-Optionen aus.

note: type: Plain text
en: Display B<dpkg> version information.
de: Zeige B<dpkg> Versionsinformationen an.

note: type: TP
en: B<dpkg-deb actions>
de: B<dpkg-deb-Aktionen>

note: type: Plain text
en: See B<dpkg-deb>(1) for more information about the following actions.
de: Lesen Sie B<dpkg-deb>(1) für weitere Informationen über die folgenden Aktionen.

note: type: Plain text
en: B<-b>, B<--build> I<directory> [I<archive>|I<directory>]
        Build a deb package.
    B<-c>, B<--contents> I<archive>
        List contents of a deb package.
    B<-e>, B<--control> I<filename> [I<directory>]
        Extract control-information from a package.
    B<-x>, B<--extract> I<archive directory>
        Extract the files contained by package.
    B<-X>, B<--vextract> I<archive directory>
        Extract and display the filenames contained by a
        package.
    B<-f>, B<--field>  I<archive> [I<control-field>...]
        Display control field(s) of a package.
    B<--fsys-tarfile> I<archive>
        Display the filesystem tar-file contained by a
        Debian package.
    B<-I>, B<--info> I<archive> [I<control-file>...]
        Show information about a package.
de: B<-b>, B<--build> I<Verzeichnis> [I<Archiv>|I<Verzeichnis>]
        Baue ein deb-Paket.
    B<-c>, B<--contents> I<Archiv>
        Liste den Inhalt eines deb-Paketes auf.
    B<-e>, B<--control> I<Dateiname> [I<Verzeichnis>]
        Extrahiere Steuerinformationen von einem Paket.
    B<-x>, B<--extract> I<Archiv Verzeichnis>
        Extrahiere die vom Paket enthaltenen Dateien.
    B<-f>, B<--field> I<Archiv> [I<Steuerfeld>] …
        Zeige das/die Steuerfeld(er) eines Paketes an.
    B<--fsys-tarfile> I<Archiv>
        Zeige die von einem Debian-Paket enthaltene Dateisystem-Tardatei an.
    B<-I>, B<--info> I<Archiv> [I<Steuerdatei> …]
        Zeige Informationen über ein Paket.

note: type: TP
en: B<dpkg-query actions>
de: B<dpkg-query-Aktionen>

note: type: Plain text
en: See B<dpkg-query>(1) for more information about the following actions.
de: Lesen Sie B<dpkg-query>(1) für weitere Informationen über die folgenden Aktionen.

note: type: Plain text
en: B<-l>, B<--list> I<package-name-pattern>...
        List packages matching given pattern.
    B<-s>, B<--status> I<package-name>...
        Report status of specified package.
    B<-L>, B<--listfiles> I<package-name>...
        List files installed to your system from I<package-name>.
    B<-S>, B<--search> I<filename-search-pattern>...
        Search for a filename from installed packages.
    B<-p>, B<--print-avail> I<package-name>...
        Display details about I<package-name>, as found in
        I</var/lib/dpkg/available>. Users of APT-based frontends
        should use B<apt-cache show> I<package-name> instead.
de: B<-l>, B<--list> I<Paketnamen-Muster> …
        Liste auf das übergebene Suchmuster passende Pakete auf.
    B<-s>, B<--status> I<Paketname> …
        Berichte den Status des spezifizierten Pakets.
    B<-L>, B<--listfiles> I<Paketname> …
        Liste die aus B<Paketname> auf Ihrem System installierten Dateien auf.
    B<-S>, B<--search> I<Dateinamen-Suchmuster> …
        Suche nach einem Dateinamen in installierten Paketen.
    B<-p>, B<--print-avail> I<Paketname>
        Zeige Details über I<Paketname>, wie in I</var/lib/dpkg/available>
        gefunden. Benutzer von APT-basierten Oberflächen sollten stattdessen
        B<apt-cache show> I<Paketname> verwenden.

note: type: Plain text
en: All options can be specified both on the command line and in the B<dpkg> configuration file I</etc/dpkg/dpkg.cfg> or fragment files (with names matching this shell pattern \(aq[0-9a-zA-Z_-]*\(aq) on the configuration directory I</etc/dpkg/dpkg.cfg.d/>. Each line in the configuration file is either an option (exactly the same as the command line option but without leading dashes) or a comment (if it starts with a B<#>).
de: Alle Optionen können auf der Kommandozeile, in der B<dpkg>-Konfigurationsdatei I</etc/dpkg/dpkg.cfg> oder Fragementdateien (mit Namen, die auf das Shell-Muster \(aq[0-9a-zA-Z_-]*\(aq passen) in den Dateien im Konfigurationsverzeichnis I</etc/dpkg/dpkg.cfg.d/> angegeben werden. Jede Zeile in der Konfigurationsdatei ist entweder eine Option (exakt die gleiche wie die Befehlszeilenoption nur ohne führende Gedankenstriche) oder ein Kommentar (falls sie mit B<#> beginnt).

note: type: TP
en: B<--abort-after=>I<number>
de: B<--abort-after=>I<Zahl>

note: type: Plain text
en: Change after how many errors B<dpkg> will abort. The default is 50.
de: Ändere nach wie vielen Fehlern B<dpkg> abbrechen wird. Der Standardwert ist 50.

note: type: Plain text
en: When a package is removed, there is a possibility that another installed package depended on the removed package. Specifying this option will cause automatic deconfiguration of the package which depended on the removed package.
de: Wenn ein Paket entfernt wird besteht die Möglichkeit, dass ein anderes installiertes Paket von dem entfernten Paket abhängt. Die Angabe dieser Option führt zur automatischen Dekonfiguration des Paketes, das von dem entfernten Paket abhängt.

note: type: TP
en: B<-D>I<octal>B<, --debug=>I<octal>
de: B<-D>I<Oktal>B<, --debug=>I<Oktal>

note: type: Plain text
en: Switch debugging on. I<octal> is formed by bitwise-orring desired values together from the list below (note that these values may change in future releases). B<-Dh> or B<--debug=help> display these debugging values.
de: Schalte Debugging ein. I<Oktal> wird durch bitweise Oder-Verknüpfung der gewünschten Werte von der nachfolgenden Liste gebildet (beachten Sie, dass sich diese Werte in zukünftigen Veröffentlichungen verändern können). B<-Dh> oder B<--debug=help> zeigen diese Debugging-Werte an.

note: type: Plain text
en:     Number   Description
             1   Generally helpful progress information
             2   Invocation and status of maintainer scripts
            10   Output for each file processed
           100   Lots of output for each file processed
            20   Output for each configuration file
           200   Lots of output for each configuration file
            40   Dependencies and conflicts
           400   Lots of dependencies/conflicts output
         10000   Trigger activation and processing
         20000   Lots of output regarding triggers
         40000   Silly amounts of output regarding triggers
          1000   Lots of drivel about e.g. the dpkg/info dir
          2000   Insane amounts of drivel
de:   Nummer  Beschreibung
          1   Allgemein hilfreiche Fortschrittsinformationen
          2   Aufruf und Status der Betreuerskripte
         10   Ausgabe für jede verarbeitete Datei
        100   Umfangreiche Ausgabe für jede verarbeitete Datei
         20   Ausgabe für jede Konfigurationsdatei
        200   Umfangreiche Ausgabe für jede Konfigurationsdatei
         40   Abhängigkeiten und Konflikte
        400   Umfangreiche Abhängigkeiten/Konflikte-Ausgabe
      10000   Trigger-Aktivierung und -Verarbeitung
      20000   Umfangreiche Ausgabe bezüglich Trigger
      40000   Alberne Menge an Ausgabe bezüglich Trigger
       1000   Umfangreiches Gelaber beispielsweise über das dpkg/info-Verzeichnis
       2000   Verrückte Mengen an Gelaber

note: type: TP
en: B<--force->I<things>, B<--no-force->I<things>, B<--refuse->I<things>
de: B<--force->I<Sachen>, B<--no-force->I<Sachen>, B<--refuse->I<Sachen>

note: type: Plain text
en: Force or refuse (B<no-force> and B<refuse> mean the same thing)  to do some things. I<things> is a comma separated list of things specified below. B<--force-help> displays a message describing them.  Things marked with (*) are forced by default.
de: Erzwinge oder verweigere (B<no-force> und B<refuse> bedeuten das gleiche) bestimmte Sachen. I<Sachen> ist eine Komma-separierte Liste von Dingen, die im folgenden beschrieben sind. B<--force-help> zeigt eine Nachricht an, die diese beschreibt. Mit (*) markierte Dinge werden standardmäßig erzwungen.

note: type: Plain text
en: I<Warning: These options are mostly intended to be used by experts only. Using them without fully understanding their effects may break your whole system.>
de: I<Warnung. Diese Optionen sind hauptsächlich für den Einsatz durch Experten gedacht. Der Einsatz ohne komplettes Verständnis der Effekte kann Ihr gesamtes System zerstören.>

note: type: Plain text
en: B<all>: Turns on (or off) all force options.
de: B<all>: Schaltet alle »force«-Optionen ein (oder aus).

note: type: Plain text
en: B<downgrade>(*): Install a package, even if newer version of it is already installed.
de: B<downgrade>(*): Installiere ein Paket, selbst wenn eine neuere Version davon bereits installiert ist.

note: type: Plain text
en: I<Warning: At present dpkg does not do any dependency checking on downgrades and therefore will not warn you if the downgrade breaks the dependency of some other package. This can have serious side effects, downgrading essential system components can even make your whole system unusable. Use with care.>
de: I<Warnung: Derzeit führt Dpkg keine Abhängigkeitsüberprüfung bei der Installation älterer Versionen (als bereits installiert) durch (sog. Downgrade) und wird Sie daher nicht warnen, falls dadurch die Abhängigkeit eines anderen Pakets nicht mehr erfüllt ist. Dies kann ernsthafte Seiteneffekte haben, ein Downgrade einer essenziellen Systemkomponente kann Ihr gesamtes System unbrauchbar machen. Verwenden Sie diese Option mit Vorsicht.>

note: type: Plain text
en: B<configure-any>: Configure also any unpacked but unconfigured packages on which the current package depends.
de: B<configure-any>: Konfiguriere auch jedes entpackte, aber unkonfigurierte Paket von dem das aktuelle Paket abhängt.

note: type: Plain text
en: B<hold>: Process packages even when marked "hold".
de: B<hold>: Verarbeite auch Pakete, die mit »halten« markiert sind.

note: type: Plain text
en: B<remove-reinstreq>: Remove a package, even if it's broken and marked to require reinstallation. This may, for example, cause parts of the package to remain on the system, which will then be forgotten by B<dpkg>.
de: B<remove-reinstreq>: Entferne ein Paket, selbst falls es defekt ist und zur Neuinstallation markiert ist. Dies kann beispielsweise dazu führen, dass Teile des Pakets auf dem System bleiben und von B<dpkg> vergessen werden.

note: type: Plain text
en: B<remove-essential>: Remove, even if the package is considered essential. Essential packages contain mostly very basic Unix commands. Removing them might cause the whole system to stop working, so use with caution.
de: B<remove-essential>: Entferne, selbst falls das Paket als essenziell betrachtet wird. Essenzielle Pakete enthalten hauptsächlich sehr grundlegende Unix-Befehle. Diese zu entfernen kann dazu führen, dass das gesamte System nicht mehr arbeitet - verwenden Sie diese Option daher mit Vorsicht.

note: type: Plain text
en: B<depends>: Turn all dependency problems into warnings.
de: B<depends>: Verwandle alle Abhängigkeitsprobleme in Warnungen.

note: type: Plain text
en: B<depends-version>: Don't care about versions when checking dependencies.
de: B<depends-version>: Ignoriere Versionen bei der Prüfung von Abhängigkeiten.

note: type: Plain text
en: B<breaks>: Install, even if this would break another package.
de: B<breaks>: Installiere, selbst falls dies ein anderes Paket beschädigt.

note: type: Plain text
en: B<conflicts>: Install, even if it conflicts with another package. This is dangerous, for it will usually cause overwriting of some files.
de: B<conflicts>: Installiere, selbst wenn es mit einem anderen Paket in Konflikt steht. Dies ist gefährlich, da dies gewöhnlich dazu führt, dass einige Dateien überschrieben werden.

note: type: Plain text
en: B<confmiss>: If a conffile is missing and the version in the package did change, always install the missing conffile without prompting. This is dangerous, since it means not preserving a change (removing) made to the file.
de: B<confmiss>: Falls ein Conffile fehlt und sich die Version im Paket geändert hat, installiere das fehlende Conffile ohne Rückfrage. Dies ist gefährlich, da es bedeutet, dass eine Änderung (die Entfernung) an der Datei nicht erhalten wird.

note: type: Plain text
en: B<confnew>: If a conffile has been modified and the version in the package did change, always install the new version without prompting, unless the B<--force-confdef> is also specified, in which case the default action is preferred.
de: B<confnew>: Falls eine Conffile modifiziert wurde und sich die Version im Paket geändert hat, installiere immer die neue Version ohne Rückfrage, es sei denn, B<--force-confdef> ist ebenfalls angegeben, in welchem Falle die Standardaktion bevorzugt wird.

note: type: Plain text
en: B<confold>: If a conffile has been modified and the version in the package did change, always keep the old version without prompting, unless the B<--force-confdef> is also specified, in which case the default action is preferred.
de: B<confold>: Falls eine Conffile modifiziert wurde und sich die Version im Paket geändert hat, behalte immer die alte Version ohne Rückfrage, es sei denn, B<--force-confdef> ist ebenfalls angegeben, in welchem Falle die Standardaktion bevorzugt wird.

note: type: Plain text
en: B<confdef>: If a conffile has been modified and the version in the package did change, always choose the default action without prompting. If there is no default action it will stop to ask the user unless B<--force-confnew> or B<--force-confold> is also been given, in which case it will use that to decide the final action.
de: B<confdef>: Falls eine Conffile verändert wurde und sich die Version im Paket geändert hat, wähle immer die Standardaktion ohne Rückfrage. Falls es keine Standardaktion gibt, halte an, um den Benutzer zu fragen, es sei denn, B<--force-confnew> oder B<--force-confold> sind ebenfalls angegeben, in welchem Falle dies verwendet wird, um die letztendliche Aktion zu bestimmen.

note: type: Plain text
en: B<confask>: If a conffile has been modified always offer to replace it with the version in the package, even if the version in the package did not change. If any of B<--force-confmiss>, B<--force-confnew>, B<--force-confold>, or B<--force-confdef> is also given, it will be used to decide the final action.
de: B<confask>: Falls eine Conffile verändert wurde, biete immer an, sie durch die Version aus dem Paket zu ersetzen, selbst falls sich die Version in dem Paket nicht geändert hat. Falls auch einer von B<--force-confmiss>, B<--force-confnew>, B<--force-confold> oder B<--force-confdef> angegeben wird, wird sie dazu verwandt, die letztendliche Aktion zu ermitteln.

note: type: Plain text
en: B<overwrite>: Overwrite one package's file with another's file.
de: B<overwrite>: Überschreibe die Datei aus einem Paket mit einer Datei aus einem anderen Paket.

note: type: Plain text
en: B<overwrite-dir> Overwrite one package's directory with another's file.
de: B<overwrite-dir> Überschreibe das Verzeichnis aus einem Paket mit einer Datei aus einem anderen Paket.

note: type: Plain text
en: B<overwrite-diverted>: Overwrite a diverted file with an undiverted version.
de: B<overwrite-diverted>: Überschreibe eine umgeleitete (»diverted«) Datei mit einer nicht umgeleiteten.

note: type: Plain text
en: B<unsafe-io>: Do not perform safe I/O operations when unpacking. Currently this implies not performing file system syncs before file renames, which is known to cause substantial performance degradation on some file systems, unfortunately the ones that require the safe I/O on the first place due to their unreliable behaviour causing zero-length files on abrupt system crashes.
de: B<unsafe-io>: Beim Entpacken keine sicheren E/A-Operationen durchführen. Derzeit impliziert dies, dass vor Dateiumbenennungen kein Systemsync durchgeführt wird. Dieser Sync führt bei einigen Dateisystemen zu erheblichen Leistungseinbußen, unglücklicherweise bei solchen, die überhaupt sichere E/A aufgrund ihres unzuverlässigen Verhaltens benötigen, auf denen bei abrupten Systemabstürzen Dateien der Länge Null entstehen können.

note: type: Plain text
en: I<Note>: For ext4, the main offender, consider using instead the mount option B<nodelalloc>, which will fix both the performance degradation and the data safety issues, the latter by making the file system not produce zero-length files on abrupt system crashes with any software not doing syncs before atomic renames.
de: I<Hinweis:> Für den Hauptmisstäter Ext4 sollten Sie stattdessen die Einhängeoption B<nodelalloc> verwenden, die sowohl die Leistungseinbuße verhindert als auch Datensicherheitsprobleme vermeidet. Letzteres bedeutet, dass bei abrupten Systemabstürzen bei jeder Software, die keine Syncs vor atomaren Umbenennungen durchführt, keine Dateien der Länge Null generiert werden.

note: type: Plain text
en: I<Warning: Using this option might improve performance at the cost of losing data, use with care.>
de: I<Warnung: Die Verwendung dieser Option kann die Leistung erhöhen, allerdings können dabei Daten verloren gehen. Verwenden Sie die Option vorsichtig.>

note: type: Plain text
en: B<architecture>: Process even packages with wrong or no architecture.
de: B<architecture>: Verarbeite sogar Pakete mit der falschen oder keiner Architektur.

note: type: Plain text
en: B<bad-version>: Process even packages with wrong versions.
de: B<bad-version>: Verarbeite sogar Pakete mit falschen Versionen.

note: type: Plain text
en: B<bad-path>: B<PATH> is missing important programs, so problems are likely.
de: B<bad-path>: Im B<PATH> fehlen wichtige Programme, daher sind Probleme wahrscheinlich.

note: type: Plain text
en: B<not-root>: Try to (de)install things even when not root.
de: B<not-root>: Versuche Sachen zu (de)installieren, selbst falls nicht root.

note: type: Plain text
en: B<bad-verify>: Install a package even if it fails authenticity check.
de: B<bad-verify>: Installiere ein Paket selbst wenn die Authentizitätsprüfung fehlschlägt.

note: type: TP
en: B<--ignore-depends>=I<package>,...
de: B<--ignore-depends>=I<Paket>, …

note: type: Plain text
en: Ignore dependency-checking for specified packages (actually, checking is performed, but only warnings about conflicts are given, nothing else).
de: Ignoriere Abhängigkeitsüberprüfungen für bestimmte Pakete (tatsächlich wird die Überprüfung durchgeführt, aber nur Warnungen über Konflikte werden angezeigt, sonst nichts).

note: type: Plain text
en: Do everything which is supposed to be done, but don't write any changes. This is used to see what would happen with the specified action, without actually modifying anything.
de: Erledige alles, was gemacht werden soll, aber schreibe keine Änderungen. Dies wird verwendet um zu sehen, was mit der spezifizierten Änderung passieren würde ohne tatsächlich etwas zu modifizieren.

note: type: Plain text
en: Be sure to give B<--no-act> before the action-parameter, or you might end up with undesirable results. (e.g. B<dpkg --purge foo --no-act> will first purge package foo and then try to purge package --no-act, even though you probably expected it to actually do nothing)
de: Stellen Sie sicher, dass B<--no-act> vor dem Aktions-Parameter steht, oder Sie könnten mit unerwünschten Ergebnissen enden. (Beispielsweise wird B<dpkg --purge foo --no-act> zuerst das Paket foo bereinigen und dann versuchen, das Paket --no-act zu bereinigen, obwohl Sie wahrscheinlich davon ausgingen, dass tatsächlich gar nichts passieren sollte)

note: type: Plain text
en: Recursively handle all regular files matching pattern B<*.deb> found at specified directories and all of its subdirectories. This can be used with B<-i>, B<-A>, B<--install>, B<--unpack> and B<--avail> actions.
de: Behandle rekursiv alle regulären Dateien, die auf das Muster B<*.deb> passen und im angegeben Verzeichnis sowie allen Unterverzeichnis liegen. Dies kann mit den Aktionen B<-i>, B<-A>, B<--install>, B<--unpack> und B<--avail> verwendet werden.

note: type: Plain text
en: Don't install a package if a newer version of the same package is already installed. This is an alias of B<--refuse-downgrade>.
de: Installiere ein Paket nicht, falls bereits eine neuere Version des gleichen Paketes installiert ist. Dies ist ein Alias für B<--refuse-downgrade>.

note: type: TP
en: B<--admindir=>I<dir>
de: B<--admindir=>I<Verz>

note: type: Plain text
en: Change default administrative directory, which contains many files that give information about status of installed or uninstalled packages, etc.  (Defaults to I</var/lib/dpkg>)
de: Ändere das voreingestellte administrative Verzeichnis (standardmäßig I</var/lib/dpkg>), in dem viele Dateien liegen, die Informationen über den Status von installierten und deinstallierten Pakete usw. liegen.

note: type: TP
en: B<--instdir=>I<dir>
de: B<--instdir=>I<Verz>

note: type: Plain text
en: Change default installation directory which refers to the directory where packages are to be installed. B<instdir> is also the directory passed to B<chroot>(2) before running package's installation scripts, which means that the scripts see B<instdir> as a root directory.  (Defaults to I</>)
de: Ändere das voreingestellte Installationsverzeichnis. Dieses Verzeichnis gibt an, wo Pakete installiert werden. B<instdir> (standardmäßig I</>) ist auch das Verzeichnis, das an B<chroot>(2) vor dem Aufruf der Installationsskripte des Paketes übergeben wird, was bedeutet, dass die Skripte B<instdir> als ein Wurzelverzeichnis sehen.

note: type: TP
en: B<--root=>I<dir>
de: B<-root=>I<Verz>

note: type: Plain text
en: Changing B<root> changes B<instdir> to I<dir> and B<admindir> to I<dir>B</var/lib/dpkg>.
de: Durch Ändern von B<root> wird B<instdir> auf I<Verz> und B<admindir> auf I<Verz>B</var/lib/dpkg> geändert.

note: type: Plain text
en: Only process the packages that are selected for installation. The actual marking is done with B<dselect> or by B<dpkg>, when it handles packages. For example, when a package is removed, it will be marked selected for deinstallation.
de: Bearbeite nur die Pakete, die zur Installation ausgewählt sind. Die eigentliche Markierung erfolgt mit B<dselect> oder durch B<dpkg>, wenn es Pakete bearbeitet. Beispielsweise wird ein Paket bei der Entfernung als »zur Deinstallation ausgewählt« markiert.

note: type: Plain text
en: Don't install the package if the same version of the package is already installed.
de: Installiere das Paket nicht, falls die gleiche Version des Pakets bereits installiert ist.

note: type: Plain text
en: B<--pre-invoke=>I<command>
de: B<--pre-invoke=>I<Befehl>

note: type: Plain text
en: B<--post-invoke=>I<command>
de: B<--post-invoke=>I<Befehl>

note: type: Plain text
en: Set an invoke hook I<command> to be run via ``sh -c'' before or after the dpkg run for the I<unpack>, I<configure>, I<install>, I<triggers-only>, I<remove> and I<purge> dpkg actions. This option can be specified multiple times. The order the options are specified is preserved, with the ones from the configuration files taking precedence.  The environment variable B<DPKG_HOOK_ACTION> is set for the hooks to the current dpkg action. Note: front-ends might call dpkg several times per invocation, which might run the hooks more times than expected.
de: Setzt einen Aufruf-Hook I<Befehl>, der via »sh -c« vor oder nach dem Dpkg-Aufruf der Dpkg-Aktionen I<unpack>, I<configure>, I<install>, I<triggers-only>, I<remove> und I<purge> ausgeführt wird. Diese Option kann mehrfach angegeben werden. Die Reihenfolge der Optionen wird erhalten, wobei Einträge aus den Konfigurationsdateien Vorrang einnehmen. Die Umgebungsvariable B<DPKG_HOOK_ACTION> wird für die Hooks auf die aktuelle Dpkg-Aktion gesetzt. Hinweis: Oberflächen könnten Dpkg mehrere Male pro Ausführung aufrufen, wodurch die Hooks öfter als erwartet ausgeführt werden könnten.

note: type: Plain text
en: B<--path-exclude=>I<glob-pattern>
de: B<--path-exclude=>I<Glob-Muster>

note: type: Plain text
en: B<--path-include=>I<glob-pattern>
de: B<--path-include=>I<Glob-Muster>

note: type: Plain text
en: Set I<glob-pattern> as a path filter, either by excluding or re-including previously excluded paths matching the specified patterns during install.
de: Setzt I<Glob-Muster> als Pfadfilter, entweder durch Ausschluss oder durch Wiedereinschluss vorher ausgeschlossener Pfade, die während der Installation auf bestimmte Muster passen.

note: type: Plain text
en: I<Warning: take into account that depending on the excluded paths you might completely break your system, use with caution.>
de: I<Warnung: Beachten Sie, dass abhängig von den ausgeschlossenen Pfaden Sie Ihr System komplett beschädigen könnten. Verwenden Sie dies daher vorsichtig.>

note: type: Plain text
en: The glob patterns use the same wildcards used in the shell, were '*' matches any sequence of characters, including the empty string and also '/'. For example, I<'/usr/*/READ*'> matches I<'/usr/share/doc/package/README'>.  As usual, '?' matches any single character (again, including '/'). And '[' starts a character class, which can contain a list of characters, ranges and complementations. See B<glob>(7) for detailed information about globbing. Note: the current implementation might re-include more directories and symlinks than needed, to be on the safe side and avoid possible unpack failures, future work might fix this.
de: Das Glob-Muster kann die gleichen Platzhalter wie in der Shell verwenden, wobei »*« auf eine beliebige Folge von Zeichen, auch dem Leerzeichen und »/«, passt. Beispielsweise passt I<»/usr/*/READ*«> auf I<»/usr/share/doc/package/README«>. Wie gewöhnlich passt »?« auf ein einzelnes Zeichen (wieder auch auf »/«). Und »[« beginnt eine Zeichenklasse, die eine Liste von Zeichen, Bereiche und Komplemente enthalten kann. Lesen Sie B<glob>(7) für detaillierte Informationen über das Globben. Hinweis: Aktuelle Implementierungen könnten mehr Verzeichnisse und symbolische Links als benötigt wieder einschließen. Um auf der sicheren Seite zu sein und in der Zukunft mögliche Entpackfehler zu vermeiden, könnte dies durch zukünftige Arbeiten behoben werden.

note: type: Plain text
en: This can be used to remove all paths except some particular ones; a typical case is:
de: Dies kann dazu verwandt werden, alle Pfade außer bestimmten zu entferen, ein typischer Fall lautet:

note: type: Plain text
en: to remove all documentation files except the copyright files.
de: Hiermit werden alle Dokumentationsdateien (außer den Copyright-Dateien) entfernt.

note: type: Plain text
en: These two options can be specified multiple times, and interleaved with each other. Both are processed in the given order, with the last rule that matches a file name making the decision.
de: Diese zwei Optionen können mehrfach angegeben und miteinander verschachtelt werden. Beide werden in der angegebenen Reihenfolge ausgewertet, wobei die letzte Regel, die auf eine Datei passt, die Entscheidung fällt.

note: type: Plain text
en: Send machine-readable package status and progress information to file descriptor I<n>. This option can be specified multiple times. The information is generally one record per line, in one of the following forms:
de: Schicke maschinenlesbare Paketstatus- und Fortschrittsinformationen an den Dateideskriptor I<n>. Diese Option kann mehrfach angegeben werden. Die Information besteht typischerweise aus einem Datensatz pro Zeile in folgendem Format:

note: type: TP
en: B<status: >I<package>B<: >I<status>
de: B<status: >I<Paket>B<: >I<Status>

note: type: Plain text
en: Package status changed; I<status> is as in the status file.
de: Paketstatus geändert; I<Status> entsprechend der Statusdatei.

note: type: TP
en: B<status: >I<package>B< : error : >I<extended-error-message>
de: B<status: >I<Paket>B< : error : >I<ausführliche-Fehlermeldung>

note: type: Plain text
en: An error occurred. Any possible newlines in I<extended-error-message> will be converted to spaces before output.
de: Ein Fehler ist aufgetreten. Alle möglichen Zeilenumbrüche in I<ausführliche-Fehlermeldung> werden vor der Ausgabe in Leerzeichen gewandelt.

note: type: TP
en: B<status: >I<file>B< : conffile-prompt : '>I<real-old>B<' '>I<real-new>B<' >I<useredited>B< >I<distedited>
de: B<status: >I<Datei>B< : conffile-prompt : »>I<echt-alt>B<« »>I<echt-neu>B<« >I<benutzer-edit>B< >I<dist-edit>

note: type: Plain text
en: User is being asked a conffile question.
de: Dem Benutzer wird eine Conffile-Frage gestellt.

note: type: TP
en: B<processing: >I<stage>B<: >I<package>
de: B<processing: >I<Stufe>B<: >I<Paket>

note: type: Plain text
en: Sent just before a processing stage starts. I<stage> is one of B<upgrade>, B<install> (both sent before unpacking), B<configure>, B<trigproc>, B<disappear>, B<remove>, B<purge>.
de: Versandt genau bevor eine Verarbeitungsstufe beginnt. I<Stufe> ist eine der folgenden: B<upgrade>, B<install> (beide werden vor dem Entpacken versandt), B<configure>, B<trigproc>, B<disappear>, B<remove>, B<purge>.

note: type: TP
en: B<--status-logger>=I<command>
de: B<--status-logger>=I<Befehl>

note: type: Plain text
en: Send machine-readable package status and progress information to the shell I<command>'s standard input. This option can be specified multiple times. The output format used is the same as in B<--status-fd.>
de: Schicke maschinenlesbare Paketstatus- und Fortschrittsinformationen an die Standardeingabe des I<Befehl>s der Shell. Diese Option kann mehrfach angegeben werden. Das verwandte Ausgabeformat ist identisch zu dem in B<--status-fd.>

note: type: TP
en: B<--log=>I<filename>
de: B<--log=>I<Dateiname>

note: type: Plain text
en: Log status change updates and actions to I<filename>, instead of the default I</var/log/dpkg.log>. If this option is given multiple times, the last filename is used. Log messages are of the form `YYYY-MM-DD HH:MM:SS status I<state> I<pkg> I<installed-version>' for status change updates; `YYYY-MM-DD HH:MM:SS I<action> I<pkg> I<installed-version> I<available-version>' for actions where I<action> is one of B<install>, B<upgrade>, B<remove>, B<purge>; and `YYYY-MM-DD HH:MM:SS conffile I<filename> I<decision>' for conffile changes where I<decision> is either B<install> or B<keep>.
de: Protokolliere Statusänderungsaktualisierungen und -Aktionen in I<Dateiname> anstatt in die Standard-Datei I</var/log/dpkg.log>. Falls diese Option mehrfach übergeben wird, wird der letzte Dateiname verwendet. Protokollnachrichten sind von der Form »JJJJ-MM-TT HH:MM:SS status I<Zustand> I<Pkt> I<installierte-Version>« für Statusänderungsaktualisierungen; »JJJJ-MM-TT HH:MM:SS I<Aktion> I<Pkt> I<installierte-Version> I<verfügbare-Version>« für Aktionen, wobei I<Aktion> entweder B<install>, B<upgrade>, B<remove> oder B<purge> ist; und »YYYY-MM-DD HH:MM:SS conffile I<Dateiname> I<Entscheidung>« für Conffile-Änderungen ist, wobei I<Entscheidung> entweder B<install> oder B<keep> ist.

note: type: Plain text
en: Do not try to verify package signatures.
de: Versuche nicht, Paketsignaturen zu überprüfen.

note: type: Plain text
en: Do not run any triggers in this run (activations will still be recorded).  If used with B<--configure> I<package> or B<--triggers-only> I<package> then the named package postinst will still be run even if only a triggers run is needed. Use of this option may leave packages in the improper B<triggers-awaited> and B<triggers-pending> states. This can be fixed later by running: B<dpkg --configure --pending>.
de: Führe keine Trigger in diesem Durchlauf aus (Aktivierungen werden dennoch aufgezeichnet). Falls dies mit B<--configure> I<Paket> oder B<--triggers-only> I<Paket> verwandt wird, wird das Postinst des benannten Pakets dennoch ausgeführt, selbst falls nur ein Trigger-Lauf notwendig ist. Die Verwendung dieser Option kann Pakete in die unzulässigen Stati B<triggers-awaited> und B<triggers-pending> bringen. Durch die Ausführung von »B<dpkg --configure --pending>« kann dies später behoben werden.

note: type: Plain text
en: Cancels a previous B<--no-triggers>.
de: Annulliert ein vorheriges B<--no-triggers>.

note: type: Plain text
en: Configuration fragment files.
de: Konfigurationsfragmentdateien.

note: type: Plain text
en: Configuration file with default options.
de: Konfigurationsdatei mit Standardeinstellungen der Optionen.

note: type: Plain text
en: Default log file (see I</etc/dpkg/dpkg.cfg>(5) and option B<--log>).
de: Standard-Protokolldatei (lesen Sie I</etc/dpkg/dpkg.cfg>(5) und die Option B<--log>).

note: type: Plain text
en: The other files listed below are in their default directories, see option B<--admindir> to see how to change locations of these files.
de: Die anderen unten aufgeführten Dateien sind in ihrem Standardverzeichnis, lesen Sie den Text zur Option B<--admindir> um zu sehen, wie sie den Ort dieser Dateien ändern können.

note: type: Plain text
en: List of available packages.
de: Liste der verfügbaren Pakete.

note: type: Plain text
en: Statuses of available packages. This file contains information about whether a package is marked for removing or not, whether it is installed or not, etc. See section B<INFORMATION ABOUT PACKAGES> for more info.
de: Statusse der verfügbaren Pakete. Diese Datei enthält Informationen darüber, ob ein Paket zur Entfernung markiert ist oder nicht, ob es installiert ist oder nicht usw. Lesen Sie den Abschnitt B<INFORMATIONEN ÜBER PAKETE> für weitere Informationen.

note: type: Plain text
en: The status file is backed up daily in I</var/backups>. It can be useful if it's lost or corrupted due to filesystems troubles.
de: Die Statusdatei wird täglich nach I</var/backups> gesichert. Dies kann hilfreich sein, falls sie aufgrund von Problemen mit dem Dateisystem verloren gegangen oder beschädigt worden ist.

note: type: Plain text
en: The following files are components of a binary package. See B<deb>(5)  for more information about them:
de: Die folgenden Dateien sind Komponenten von Binärpaketen. Lesen Sie B<deb>(5) für weitere Informationen über sie:

note: type: Plain text
en: If set, B<dpkg> will use it as the directory from which to read the user specific configuration file.
de: Falls gesetzt wird B<dpkg> es als das Verzeichnis verwenden, aus dem die benutzerspezifische Konfigurationsdatei gelesen wird.

note: type: Plain text
en: If set, B<dpkg> will use it as the directory in which to create temporary files and directories.
de: Falls gesetzt wird B<dpkg> es als das Verzeichnis verwenden, in dem temporäre Dateien und Verzeichnisse erstellt werden.

note: type: Plain text
en: The program B<dpkg> will execute when displaying the conffiles.
de: Das Programm, das B<dpkg> ausführen wird, wenn es die Conffiles anzeigt.

note: type: Plain text
en: The program B<dpkg> will execute when starting a new shell.
de: Das Programm, das B<dpkg> ausführen wird, wenn es eine neue Shell startet.

note: type: Plain text
en: Sets the number of columns B<dpkg> should use when displaying formatted text. Currently only used by -l.
de: Setzt die Anzahl von Spalten die B<dpkg> verwenden soll, wenn es formatierten Text anzeigt. Derzeit nur von -l verwendet.

note: type: Plain text
en: Defined by B<dpkg> on the shell spawned on the conffile prompt to examine the situation. Current valid value: B<conffile-prompt>.
de: Wird von B<dpkg> auf der Shell, die von der Conffile-Eingabeaufforderung gestartet wird, um die Situation zu analysieren, gesetzt. Derzeit gültiger Wert: B<conffile-prompt>.

note: type: Plain text
en: Defined by B<dpkg> on the shell spawned on the conffile prompt to examine the situation. Contains the path to the old conffile.
de: Wird von B<dpkg> auf der Shell, die von der Conffile-Eingabeaufforderung gestartet wird, um die Situation zu analysieren, gesetzt. Enthält den Pfad zu der alten Conffile.

note: type: Plain text
en: Defined by B<dpkg> on the shell spawned on the conffile prompt to examine the situation. Contains the path to the new conffile.
de: Wird von B<dpkg> auf der Shell, die von der Conffile-Eingabeaufforderung gestartet wird, um die Situation zu analysieren, gesetzt. Enthält den Pfad zu der neuen Conffile.

note: type: Plain text
en: Defined by B<dpkg> on the maintainer script environment to the version of the currently running B<dpkg> instance.
de: Wird von B<dpkg> für die Betreuer-Skript-Umgebung auf die Version der aktuell laufenden Instanz von B<dpkg> gesetzt.

note: type: Plain text
en: Defined by B<dpkg> on the maintainer script environment to the package name being handled.
de: Wird von B<dpkg> für die Betreuer-Skript-Umgebung auf den in Arbeit befindlichen Paketnamen gesetzt.

note: type: Plain text
en: Defined by B<dpkg> on the maintainer script environment to the architecture the package got built for.
de: Wird von B<dpkg> für die Betreuer-Skript-Umgebung auf die Architektur gesetzt, für die das Paket gebaut wurde.

note: type: Plain text
en: Defined by B<dpkg> on the maintainer script environment to the name of the script running (preinst, postinst, prerm, postrm).
de: Wird von B<dpkg> für die Betreuer-Skript-Umgebung auf den Namen des laufenden Skripts (preinst, postinst, prerm, postrm) gesetzt.

note: type: Plain text
en: To list installed packages related to the editor B<vi>(1) (note that B<dpkg-query> does not load the available file anymore by default, and the B<dpkg-query> B<--load-avail> option should be used instead for that):
de: Um die installierten Pakete mit Bezug zum Editor B<vi>(1) aufzulisten (beachten Sie, dass B<dpkg-query> nicht mehr standardmäßig die Datei »available« lädt und stattdessen dafür die Option B<dpkg-query> B<--load-avail> verwandt werden sollte):

note: type: Plain text
en: To see the entries in I</var/lib/dpkg/available> of two packages:
de: Um die Einträge von zwei Paketen in I</var/lib/dpkg/available> zu sehen:

note: type: Plain text
en: To search the listing of packages yourself:
de: Wenn Sie die Liste der Pakete selbst durchsuchen wollen:

note: type: Plain text
en: To remove an installed elvis package:
de: Um ein installiertes Elvis-Paket zu entfernen:

note: type: Plain text
en: To install a package, you first need to find it in an archive or CDROM. The "available" file shows that the vim package is in section "editors":
de: Um ein Paket zu installieren, müssen Sie es erst in einem Archiv oder auf einer CD-ROM finden. Die »available«-Datei zeigt, dass das vim-Paket im Bereich »editors« ist:

note: type: Plain text
en: To make a local copy of the package selection states:
de: Um eine lokale Kopie der Paketauswahl-Zustände zu erstellen:

note: type: Plain text
en:      B<dpkg --get-selections E<gt>myselections>
de:      B<dpkg --get-selections E<gt>meine_auswahl>

note: type: Plain text
en: You might transfer this file to another computer, and install it there with:
de: Sie können diese Datei zu einem anderen Computer bringen und sie dort mit folgenden Befehlen installieren:

note: type: Plain text
en:      B<dpkg --clear-selections>
         B<dpkg --set-selections E<lt>myselections>
de:      B<dpkg --clear-selections>
         B<dpkg --set-selections E<lt>meine_auswahl>

note: type: Plain text
en: Note that this will not actually install or remove anything, but just set the selection state on the requested packages. You will need some other application to actually download and install the requested packages. For example, run B<apt-get dselect-upgrade>.
de: Beachten Sie, dass dies nichts wirklich installiert oder entfernt, sondern lediglich den Auswahlzustand der angeforderten Pakete setzt. Sie werden eine andere Anwendung benötigen, um die angeforderten Pakete tatsächlich herunterzuladen und zu installieren. Führen Sie beispielsweise B<apt-get dselect-upgrade> aus.

note: type: Plain text
en: Ordinarily, you will find that B<dselect>(1) provides a more convenient way to modify the package selection states.
de: Gewöhnlich werden Sie feststellen, dass B<dselect>(1) eine bequemere Art ist, den Paketauswahlzustand zu ändern.

note: type: SH
en: ADDITIONAL FUNCTIONALITY
de: ZUSÄTZLICHE FUNKTIONALITÄT

note: type: Plain text
en: Additional functionality can be gained by installing any of the following packages: B<apt>, B<aptitude> and B<debsums>.
de: Zusätzliche Funktionalität kann durch die Installation jedes der folgenden Pakete erhalten werden: B<apt>, B<aptitude> und B<debsums>.

note: type: Plain text
en: B<aptitude>(1), B<apt>(1), B<dselect>(1), B<dpkg-deb>(1), B<dpkg-query>(1), B<deb>(5), B<deb-control>(5), B<dpkg.cfg>(5), and B<dpkg-reconfigure>(8).
de: B<aptitude>(1), B<apt>(1), B<dselect>(1), B<dpkg-deb>(1), B<dpkg-query>(1), B<deb>(5), B<deb-control>(5), B<dpkg.cfg>(5) und B<dpkg-reconfigure>(8).

note: type: Plain text
en: B<--no-act> usually gives less information than might be helpful.
de: B<--no-act> gibt gewöhnlich weniger Informationen als hilfreich sein könnten.

note: type: Plain text
en: See I</usr/share/doc/dpkg/THANKS> for the list of people who have contributed to B<dpkg>.
de: Lesen Sie I</usr/share/doc/dpkg/THANKS> für die Liste der Leute, die zu B<dpkg> beigetragen haben.

note: type: Plain text
en: dpkg-architecture - set and determine the architecture for package building
de: dpkg-architecture - Architektur zum Paketbau setzen und bestimmen

note: type: Plain text
en: B<dpkg-architecture> [I<option>...] [I<command>]
de: B<dpkg-architecture> [I<Option> …] [I<Befehl>]

note: type: Plain text
en: dpkg-architecture does provide a facility to determine and set the build and host architecture for package building.
de: dpkg-architecture stellt eine Möglichkeit bereit, die Rechner-Architektur für den Paketbau zu bestimmen und zu setzen.

note: type: Plain text
en: The build architecture is always determined by an external call to B<dpkg>(1), and can not be set at the command line.
de: Die Bau-Architektur wird immer über einen externen Aufruf an B<dpkg>(1) bestimmt und kann nicht auf der Kommandozeile gesetzt werden.

note: type: Plain text
en: You can specify the host architecture by providing one or both of the options B<-a> and B<-t>. The default is determined by an external call to B<gcc>(1), or the same as the build architecture if \s-1CC\s0 or gcc are both not available. One out of B<-a> and B<-t> is sufficient, the value of the other will be set to a usable default. Indeed, it is often better to only specify one, because B<dpkg-architecture> will warn you if your choice does not match the default.
de: Sie können die Host-Architektur (Wirt-Architektur) spezifizieren, indem Sie eine oder beide der Optionen B<-a> oder B<-t> verwenden. Der Standardwert wird über einen externen Aufruf an B<gcc>(1) ermittelt oder ist identisch mit der Bauarchitektur, falls sowohl \s-1CC\s0 als auch Gcc nicht verfügbar sind. Einer von B<-a> oder B<-t> ist ausreichend, der Wert des anderen wird auf einen brauchbaren Wert gesetzt. Tatsächlich ist es oft besser, nur einen der beiden anzugeben, da B<dpkg-architecture> Sie warnen wird, falls Ihre Wahl nicht mit dem Standardwert übereinstimmt.

note: type: SH
en: COMMANDS
de: BEFEHLE

note: type: Plain text
en: Print the environment variables, one each line, in the format I<VARIABLE=value>. This is the default action.
de: Zeige die Umgebungsvariablen, eine pro Zeile, in dem Format I<VARIABLE=Wert>. Dies ist die Standardaktion.

note: type: TP
en: B<-e>I<debian-architecture>
de: B<-e>I<Debian-Architektur>

note: type: Plain text
en: Check for equality of architecture. By default I<debian-architecture> is compared against the current Debian architecture, being the host.  This action will not expand the architecture wildcards. Command finishes with an exit status of 0 if matched, 1 if not matched.
de: Überprüfe auf Gleichheit der Architekturen. Standardmäßig wird I<Debian-Architektur> gegen die aktuelle Debian-Architektur auf dem Host geprüft. Diese Aktion expandiert nicht die Architektur-Platzhalter (Wildcards). Der Befehl beendet sich mit einem Exit-Status von 0, falls eine Übereinstimmung besteht, andernfalls mit 1.

note: type: TP
en: B<-i>I<architecture-wildcard>
de: B<-i>I<Architektur-Platzhalter>

note: type: Plain text
en: Check for identity of architecture by expanding I<architecture-wildcard> as an architecture wildcard and comparing against the current Debian architecture. Command finishes with an exit status of 0 if matched, 1 if not matched.
de: Überprüfe die Identität einer Architektur, indem I<Architektur-Platzhalter> als ein Architektur-Platzhalter expandiert und mit der aktuellen Debian-Architektur verglichen wird. Der Befehl endet mit einem Exit-Status von 0, falls eine Übereinstimmung gefunden wurde, ansonsten mit 1.

note: type: TP
en: B<-q>I<variable-name>
de: B<-q>I<Variablenname>

note: type: Plain text
en: Print the value of a single variable.
de: Zeige den Wert einer einzelnen Variablen an.

note: type: Plain text
en: Print an export command. This can be used to set the environment variables using eval.
de: Zeige einen Export-Befehl. Dies kann dazu verwendet werden, um Umgebungsvariablen mittels eval zu setzen.

note: type: Plain text
en: Print a similar command to B<-s> but to unset all variables.
de: Ähnlich wie B<-s>, gebe einen Export-Befehl aus, der alle Variablen löscht.

note: type: TP
en: B<-c>I< command>
de: B<-c>I< Befehl>

note: type: Plain text
en: Execute a I<command> in an environment which has all variables set to the determined value.
de: Führe einen I<Befehl> in einer Umgebung aus, in der alle Variablen auf die festgelegten Werte gesetzt sind.

note: type: Plain text
en: Print a list of valid architecture names.
de: Zeige eine Liste von gültigen Architekturnamen.

note: type: Plain text
en: Show the usage message and exit.
de: Zeige den Bedienungshinweis und beende.

note: type: Plain text
en: Show the version and exit.
de: Gebe die Version aus und beende sich.

note: type: TP
en: B<-a>I<debian-architecture>
de: B<-a>I<Debian-Architektur>

note: type: Plain text
en: Set the Debian architecture.
de: Setze die Debian-Architektur.

note: type: TP
en: B<-t>I<gnu-system-type>
de: B<-t>I<GNU-Systemtyp>

note: type: Plain text
en: Set the GNU system type.
de: Setze den GNU-Systemtyp.

note: type: Plain text
en: Values set by existing environment variables with the same name as used by the scripts are honored (i.e. used by B<dpkg-architecture>), except if this force flag is present. This allows the user to override a value even when the call to B<dpkg-architecture> is buried in some other script (for example B<dpkg-buildpackage>(1)).
de: Existierende Umgebungsvariablen mit dem gleichen Namen wie vom Skript verwendet werden nicht überschrieben (d.h. sie werden von B<dpkg-architecture> verwendet), es sei denn, die »force«-Markierung ist gesetzt. Dies erlaubt es dem Benutzer einen Wert zu überschreiben, selbst wenn der Aufruf von B<dpkg-architecture> tief in einem anderen Skript versteckt ist (beispielsweise B<dpkg-buildpackage>(1)).

note: type: SH
en: TERMS
de: AUSDRÜCKE

note: type: IP
en: build machine
de: Baumaschine

note: type: Plain text
en: The machine the package is built on.
de: Die Maschine, auf der das Paket gebaut wird.

note: type: IP
en: host machine
de: Host-Maschine

note: type: Plain text
en: The machine the package is built for.
de: Die Maschine, für die das Paket gebaut ist.

note: type: IP
en: Debian architecture
de: Debian-Architektur

note: type: Plain text
en: The Debian architecture string, which specifies the binary tree in the \s-1FTP\s0 archive. Examples: i386, sparc, hurd-i386.
de: Die Debian-Architektur-Zeichenkette, die den binären Baum im \s-1FTP\s0-Archiv spezifiziert. Beispiele: i386, sparc, hurd-i386.

note: type: IP
en: architecture wildcard
de: Architektur-Platzhalter

note: type: Plain text
en: An architecture wildcard is a special architecture string that will match any real architecture being part of it. The general form is E<lt>kernelE<gt>-E<lt>cpuE<gt>.  Examples: linux-any, any-i386, hurd-any.
de: Ein Architektur-Platzhalter ist eine spezielle Architektur-Zeichenkette, die auf jede reale Architektur, die ein Teil davon ist, passt. Die allgemeine Form ist E<lt>KernE<gt>-E<lt>CPUE<gt>. Beispiele: linux-any, any-i386, hurd-any.

note: type: IP
en: \s-1GNU\s0 system type
de: \s-1GNU\s0-Systemtyp

note: type: Plain text
en: An architecture specification string consisting of two parts separated by a dash: cpu and system. Examples: i386-linux-gnu, sparc-linux-gnu, i386-gnu, x86_64-netbsd.
de: Eine Architektur-Spezifikations-Zeichenkette besteht aus zwei, durch einen Bindestrich getrennten Teilen: CPU und System. Beispiele: i386-linux-gnu, sparc-linux-gnu, i386-gnu, x86_64-netbsd.

note: type: Plain text
en: The following variables are set by B<dpkg-architecture>:
de: Die folgenden Variablen werden von B<dpkg-architecture> gesetzt:

note: type: Plain text
en: The Debian architecture of the build machine.
de: Die Debian-Architektur der Baumaschine.

note: type: Plain text
en: The Debian system name of the build machine.
de: Der Debian-Systemname der Baumaschine.

note: type: Plain text
en: The Debian cpu name of the build machine.
de: Der Debian-CPU-Name der Baumaschine.

note: type: Plain text
en: The pointer size of the build machine (in bits).
de: Die Zeigergröße der Baumaschine in Bits.

note: type: Plain text
en: The endianness of the build machine (little / big).
de: Die Endianness der Baumaschine (little/big).

note: type: Plain text
en: The \s-1CPU\s0 part of \s-1DEB_BUILD_GNU_TYPE\s0.
de: Der \s-1CPU\s0-Teil von \s-1DEB_BUILD_GNU_TYPE\s0.

note: type: Plain text
en: The System part of \s-1DEB_BUILD_GNU_TYPE\s0.
de: Der System-Teil von \s-1DEB_BUILD_GNU_TYPE\s0.

note: type: Plain text
en: The \s-1GNU\s0 system type of the build machine.
de: Der \s-1GNU\s0-Systemtyp der Baumaschine.

note: type: Plain text
en: The clarified \s-1GNU\s0 system type of the build machine, used for filesystem paths.
de: Der klargestellte \s-1GNU\s0-Systemtyp der Baumaschine, wird für Dateisystempfade benutzt.

note: type: Plain text
en: The Debian architecture of the host machine.
de: Die Debian-Architektur der Host-Maschine.

note: type: Plain text
en: The Debian system name of the host machine.
de: Der Debian-Systemname der Host-Maschine.

note: type: Plain text
en: The Debian cpu name of the host machine.
de: Der Debian-CPU-Name der Host-Maschine.

note: type: Plain text
en: The pointer size of the host machine (in bits).
de: Die Zeigergröße der Host-Maschine in Bits.

note: type: Plain text
en: The endianness of the host machine (little / big).
de: Die Endianness der Host-Maschine (little/big).

note: type: Plain text
en: The \s-1CPU\s0 part of \s-1DEB_HOST_GNU_TYPE\s0.
de: Der \s-1CPU\s0-Teil von \s-1DEB_HOST_GNU_TYPE\s0.

note: type: Plain text
en: The System part of \s-1DEB_HOST_GNU_TYPE\s0.
de: Der System-Teil von \s-1DEB_HOST_GNU_TYPE\s0.

note: type: Plain text
en: The \s-1GNU\s0 system type of the host machine.
de: Der \s-1GNU\s0-Systemtyp der Host-Maschine.

note: type: Plain text
en: The clarified \s-1GNU\s0 system type of the host machine, used for filesystem paths.
de: Der klargestellte \s-1GNU\s0-Systemtyp der Host-Maschine, wird für Dateisystempfade benutzt.

note: type: Plain text
en: The environment variables set by B<dpkg-architecture> are passed to I<debian/rules> as make variables (see make documentation). However, you should not rely on them, as this breaks manual invocation of the script. Instead, you should always initialize them using B<dpkg-architecture> with the -q option. Here are some examples, which also show how you can improve the cross compilation support in your package:
de: Die Umgebungsvariablen, die von B<dpkg-architecture> gesetzt werden, werden an I<debian/rules> als Make-Variablen weitergegeben (lesen Sie hierzu die Make-Dokumentation). Allerdings sollten Sie sich nicht auf diese verlassen, da damit der manuelle Aufruf des Skripts verhindert wird. Stattdessen sollten Sie sie immer mit B<dpkg-architecture> mit der -q-Option initialisieren. Hier sind einige Beispiele, die auch zeigen, wie sie die Cross-Kompilierungs-Unterstützung in Ihrem Paket verbessern können:

note: type: Plain text
en: Retrieving the GNU system type and forwarding it to ./configure:
de: Ermitteln des GNU-Systemtyps und dessen Weiterleitung an ./configure:

note: type: Plain text
en: \&\s-1DEB_BUILD_GNU_TYPE\s0 := $(shell dpkg-architecture -qDEB_BUILD_GNU_TYPE)
    \&\s-1DEB_HOST_GNU_TYPE\s0 := $(shell dpkg-architecture -qDEB_HOST_GNU_TYPE)
    [...]
    configure --build=$(\s-1DEB_BUILD_GNU_TYPE\s0) --host=$(\s-1DEB_HOST_GNU_TYPE\s0)
de: \&\s-1DEB_BUILD_GNU_TYPE\s0 := $(shell dpkg-architecture -qDEB_BUILD_GNU_TYPE)
    \&\s-1DEB_HOST_GNU_TYPE\s0 := $(shell dpkg-architecture -qDEB_HOST_GNU_TYPE)
    […]
    configure --build=$(\s-1DEB_BUILD_GNU_TYPE\s0) --host=$(\s-1DEB_HOST_GNU_TYPE\s0)

note: type: Plain text
en: Doing something only for a specific architecture:
de: Etwas nur für eine bestimmte Architektur erledigen:

note: type: Plain text
en: ifeq ($(\s-1DEB_HOST_ARCH\s0),alpha)
      [...]
    endif
de: ifeq ($(\s-1DEB_HOST_ARCH\s0),alpha)
      […]
    endif

note: type: Plain text
en: or if you only need to check the CPU or OS type, use the DEB_HOST_ARCH_CPU or DEB_HOST_ARCH_OS variables.
de: oder, falls Sie nur den CPU- oder OS-Typ überprüfen müssen, verwenden Sie die DEB_HOST_ARCH_CPU- oder DEB_HOST_ARCH_OS-Variablen.

note: type: Plain text
en: Note that you can also rely on an external Makefile snippet to properly set all the variables that B<dpkg-architecture> can provide:
de: Beachten Sie, dass Sie sich auch auf ein externes Makefile-Schnipsel abstützen können, um alle Variablen, die B<dpkg-architecture> bereitstellen kann, korrekt zu setzen:

note: type: Plain text
en: In any case, you should never use B<dpkg --print-architecture> to get architecture information during a package build.
de: Auf jeden Fall sollten Sie niemals B<dpkg --print-architecture> verwenden, um die Architekturinformationen während eines Paketbaus zu erhalten.

note: type: SH
en: BACKWARD COMPATIBILITY
de: RÜCKWÄRTSKOMPATIBILITÄT

note: type: Plain text
en: The /usr/share/dpkg/architecture.mk Makefile snippet is provided by dpkg-dev since version 1.16.1.
de: Das Makefile-Schnipsel /usr/share/dpkg/architecture.mk wird von dpkg-dev seit Version 1.16.1 bereitgestellt.

note: type: Plain text
en: The DEB_*_ARCH_BITS and DEB_*_ARCH_ENDIAN variables were introduced in dpkg-dev 1.15.4. Using them in I<debian/rules> thus requires a build-dependency on dpkg-dev (E<gt>= 1.15.4).
de: Die Variablen DEB_*_ARCH_BITS und DEB_*_ARCH_ENDIAN wurden in dpkg-dev 1.15.4 eingeführt. Werden sie in I<debian/rules> verwandt, benötigen sie daher eine Bauabhängigkeit von dpkg-dev (E<gt>= 1.15.4).

note: type: Plain text
en: The DEB_HOST_ARCH_CPU and DEB_HOST_ARCH_OS variables were introduced in dpkg-dev 1.13.2.
de: Die Variablen DEB_HOST_ARCH_CPU und DEB_HOST_ARCH_OS wurden in dpkg-dev 1.13.2 eingeführt.

note: type: Plain text
en: The B<-e> and B<-i> options were only introduced in relatively recent versions of B<dpkg-architecture> (since dpkg 1.13.13).
de: Die B<-e>- und B<-i>-Optionen wurden erst in relativ neuen Versionen von B<dpkg-architecture> eingeführt (seit Dpkg 1.13.13).

note: type: Plain text
en: B<dpkg-buildpackage> accepts the B<-a> option and passes it to B<dpkg-architecture>. Other examples:
de: B<dpkg-buildpackage> akzeptiert die B<-a>-Option und gibt dies an B<dpkg-architecture> weiter. Weitere Beispiele:

note: type: Plain text
en: Check if an architecture is equal to the current architecture or a given one:
de: Überprüfe, ob eine Architektur identisch zu der aktuellen Architektur oder einer übergebenen ist:

note: type: Plain text
en: Check if the current architecture or an architecture provided with -a are Linux systems:
de: Überprüfe, ob die aktuelle oder eine mit -a übergebene Architektur Linux-Systeme sind:

note: type: Plain text
en: All these files have to be present for B<dpkg-architecture> to work. Their location can be overridden at runtime with the environment variable B<DPKG_DATADIR>.
de: Alle diese Dateien müssen vorhanden sein, damit B<dpkg-architecture> funktioniert. Ihr Ort kann zur Laufzeit mit der Umgebungsvariable B<DPKG_DATADIR> überschrieben werden.

note: type: Plain text
en: Table of known CPU names and mapping to their GNU name.
de: Tabelle der bekannten CPU-Namen und Abbildungen auf ihre GNU-Namen.

note: type: Plain text
en: Table of known operating system names and mapping to their GNU name.
de: Tabelle der bekannten Betriebssystemnamen und Abbildungen auf ihre GNU-Namen.

note: type: Plain text
en: Mapping between Debian architecture triplets and Debian architecture names.
de: Abbildung zwischen den Debian-Architektur-Tripletts und den Debian-Architekturnamen.

note: type: Plain text
en: dpkg.cfg - dpkg configuration file
de: dpkg.cfg - dpkg Konfigurationsdatei

note: type: Plain text
en: This file contains default options for dpkg. Each line contains a single option which is exactly the same as a normal command line option for dpkg except for the leading dashes which are not used here. Quotes surrounding option values are stripped. Comments are allowed by starting a line with a hash sign ("B<#>").
de: Diese Datei enthält Standardoptionen für dpkg. Jede Zeile enthält eine einzelne Option, die exakt die gleiche wie für die normalen Kommandozeilen-Option von dpkg sind, abgesehen von den einleitenden Gedankenstrichen, die hier nicht verwendet werden. Anführungszeichen (»Quotes«) um Optionswerte werden entfernt. Kommentare sind durch Einleiten einer Zeile mit einem Rautenzeichen ("B<#>") erlaubt.

note: type: Plain text
en: dpkg-buildflags - returns build flags to use during package build
de: dpkg-buildflags - liefert Bauschalter zum Einsatz beim Paketbau

note: type: Plain text
en: B<dpkg-buildflags> [I<option>...] [I<command>]
de: B<dpkg-buildflags> [I<Option> …] [I<Befehl>]

note: type: Plain text
en: B<dpkg-buildflags> is a tool to retrieve compilation flags to use during build of Debian packages.
de: B<dpkg-buildflags> ist ein Werkzeug, das zum Abfragen der zu verwendenden Kompilierungsschalter für den Bau von Debian-Paketen eingesetzt wird.

note: type: Plain text
en: The default flags are defined by the vendor but they can be extended/overriden in several ways:
de: Die Standardschalter werden vom Lieferanten definiert, sie können auf mehrere Arten erweitert/überschrieben werden:

note: type: Plain text
en: system-wide with B</etc/dpkg/buildflags.conf>;
de: systemweit mit B</etc/dpkg/buildflags.conf>

note: type: Plain text
en: for the current user with B<$XDG_CONFIG_HOME/dpkg/buildflags.conf> where B<$XDG_CONFIG_HOME> defaults to B<$HOME/.config>;
de: für den aktuellen Benutzer mit B<$XDG_CONFIG_HOME/dpkg/buildflags.conf>, wobei B<$XDG_CONFIG_HOME> standardmäßig auf B<$HOME/.config> gesetzt ist

note: type: Plain text
en: temporarily by the user with environment variables (see section B<ENVIRONMENT>);
de: temporär durch den Benutzer mittels Umgebungsvariablen (siehe Abschnitt B<UMGEBUNG>)

note: type: Plain text
en: dynamically by the package maintainer with environment variables set via B<debian/rules> (see section B<ENVIRONMENT>).
de: dynamisch durch den Paketverwalter mittels Umgebungsvariablen, die über B<debian/rules> gesetzt wurden (siehe Abschnitt B<UMGEBUNG>)

note: type: Plain text
en: The configuration files can contain two types of directives:
de: Die Konfigurationsdateien können zwei Arten von Direktiven enthalten:

note: type: TP
en: B<SET>I< flag value>
de: B<SET>I< Schalter Wert>

note: type: Plain text
en: Override the flag named I<flag> to have the value I<value>.
de: Überschreibt den Schalter namens I<Schalter>, um den Wert I<Wert> zu erhalten.

note: type: TP
en: B<STRIP>I< flag value>
de: B<STRIP>I< Schalter Wert>

note: type: Plain text
en: Strip from the flag named I<flag> all the build flags listed in I<value>.
de: Aus dem Schalter namens I<Schalter> alle in I<Wert> aufgeführten Bauschalter entfernen

note: type: TP
en: B<APPEND>I< flag value>
de: B<APPEND>I< Schalter Wert>

note: type: Plain text
en: Extend the flag named I<flag> by appending the options given in I<value>.  A space is prepended to the appended value if the flag's current value is non-empty.
de: Erweitert den Schalter namens I<Schalter> durch Anhängen der in I<Wert> angegebenen Optionen. Ein Leerzeichen wird vor den angehängten Wert vorangestellt, falls der derzeitige Wert nicht leer ist.

note: type: TP
en: B<PREPEND>I< flag value>
de: B<PREPEND>I< Schalter Wert>

note: type: Plain text
en: Extend the flag named I<flag> by prepending the options given in I<value>.  A space is appended to the prepended value if the flag's current value is non-empty.
de: Erweitert den Schalter namens I<Schalter> durch Voranstellen der in I<Wert> angegebenen Optionen. Ein Leerzeichen wird hinter den vorangestellten Wert angehängt, falls der derzeitige Wert nicht leer ist.

note: type: Plain text
en: The configuration files can contain comments on lines starting with a hash (#). Empty lines are also ignored.
de: Die Konfigurationsdateien können Kommentare auf Zeilen enthalten, die mit einer Raute (#) beginnen. Leere Zeilen werden auch ignoriert.

note: type: Plain text
en: Print to standard output all compilation flags and their values. It prints one flag per line separated from its value by an equal sign ("I<flag>=I<value>"). This is the default action.
de: Auf der Standardausgabe alle Kompilierschalter und ihre Werte ausgeben. Es wird ein Schalter pro Zeile ausgegeben, wobei der Werte durch ein Gleichheitszeichen (»I<Schalter>=I<Wert>«) abgetrennt wird. Dies ist die Standardaktion.

note: type: Plain text
en: Print the list of flags supported by the current vendor (one per line). See the B<SUPPORTED FLAGS> section for more information about them.
de: Gibt die Liste der vom aktuellen Lieferanten unterstützen Schalter (eine pro Zeile) aus. Lesen Sie den Abschnitt B<UNTERSTÜTZTE SCHALTER> für weitere Informationen über sie.

note: type: Plain text
en: Display any information that can be useful to explain the behaviour of B<dpkg-buildflags>: relevant environment variables, current vendor, state of all feature flags. Also print the resulting compiler flags with their origin.
de: Alle Informationen anzeigen, die zum Verständnis des Verhaltens von B<dpkg-buildflags> nützlich sein können: relevante Umgebungsvariablen, aktueller Lieferant, Zustand der Funktionsschalter. Auch die entstehenden Compiler-Schalter mit ihrem Ursprung werden ausgeben.

note: type: Plain text
en: This is intended to be run from B<debian/rules>, so that the build log keeps a clear trace of the build flags used. This can be useful to diagnose problems related to them.
de: Dies ist zur Ausführung in B<debian/rules> gedacht, so dass das Bauprotokoll einen klaren Nachweis der verwandten Bauschalter enthält. Dies kann zur Diagnose von Problemen in Zusammenhang mit diesen nützlich sein.

note: type: TP
en: B<--export=>I<format>
de: B<--export=>I<Format>

note: type: Plain text
en: Print to standard output shell (if I<format> is B<sh>) or make (if I<format> is B<make>) commands that can be used to export all the compilation flags in the environment. If I<format> is B<configure> then the output can be used on a B<./configure> command-line. If the I<format> value is not given, B<sh> is assumed. Only compilation flags starting with an upper case character are included, others are assumed to not be suitable for the environment.
de: Auf der Standardausgabe Shell- (falls I<Format> B<sh> ist) oder Make- (falls I<Format> B<make> ist) Befehle ausgeben, die dazu verwandt werden können, alle Kompilierschalter in die Umgebung zu exportieren. Falls I<Format> B<configure> lautet, kann die Ausgabe für eine Kommandozeile von B<./configure> verwandt werden. Falls der Wert von I<Format> nicht angegeben wird, wird B<sh> angenommen. Nur Kompilierschalter, die mit einem Großbuchstaben beginnen, werden aufgenommen. Bei allen anderen wird angenommen, dass sie für die Umgebung nicht geeignet sind.

note: type: TP
en: B<--get>I< flag>
de: B<--get>I< Schalter>

note: type: Plain text
en: Print the value of the flag on standard output. Exits with 0 if the flag is known otherwise exits with 1.
de: Gibt den Wert des Schalters auf der Standardausgabe aus. Beendet sich mit 0, falls der Schalter bekannt ist, andernfalls mit 1.

note: type: TP
en: B<--origin>I< flag>
de: B<--origin>I< Schalter>

note: type: Plain text
en: Print the origin of the value that is returned by B<--get>. Exits with 0 if the flag is known otherwise exits with 1. The origin can be one of the following values:
de: Gibt den Ursprung des von B<--get> gelieferten Werts aus. Beendet sich mit 0, falls der Schalter bekannt ist, andernfalls mit 1. Der Ursprung kann einer der folgenden Werte sein:

note: type: Plain text
en: the original flag set by the vendor is returned;
de: der ursprünglich vom Lieferanten gesetzte Schalter wird zurückgeliefert

note: type: Plain text
en: the flag is set/modified by a system-wide configuration;
de: der Schalter wurde durch eine systemweite Konfiguration gesetzt/verändert

note: type: Plain text
en: the flag is set/modified by a user-specific configuration;
de: der Schalter wurde durch eine benutzerspezifische Konfiguration gesetzt/verändert

note: type: Plain text
en: the flag is set/modified by an environment-specific configuration.
de: der Schalter wurde durch eine umgebungsspezifische Konfiguration gesetzt/verändert

note: type: TP
en: B<--query-features>I< area>
de: B<--query-features>I< Bereich>

note: type: Plain text
en: Print the features enabled for a given area. The only currently recognized area is B<hardening>. Exits with 0 if the area is known otherwise exits with 1.
de: Gibt die Funktionalitäten, die für den übergebenen Bereich aktiviert sind, aus. Der einzige derzeit erkannte Bereich ist B<hardening>. Beendet sich mit 0, falls der Bereich bekannt ist, andernfalls mit 1.

note: type: Plain text
en: The output format is RFC822 header-style, with one section per feature.  For example:
de: Das Ausgabeformat ist im Kopfzeilen-Stil von RFC822, mit einem Abschnitt pro Funktionalität. Beispiel:

note: type: SH
en: SUPPORTED FLAGS
de: UNTERSTÜTZTE SCHALTER

note: type: Plain text
en: Options for the C compiler. The default value set by the vendor includes I<-g> and the default optimization level (I<-O2> usually, or I<-O0> if the B<DEB_BUILD_OPTIONS> environment variable defines I<noopt>).
de: Optionen für den C-Compiler. Der vom Lieferanten gesetzte Standardwert enthält I<-g> und die Standard Optimierungsstufe (normalerweise I<-O2> oder I<-O0>, falls die Umgebungsvariable B<DEB_BUILD_OPTIONS> I<noopt> definiert.

note: type: Plain text
en: Options for the C preprocessor. Default value: empty.
de: Optionen für den C-Präprozessor. Standardwert: leer

note: type: Plain text
en: Options for the C++ compiler. Same as B<CFLAGS>.
de: Optionen für den C++-Compiler. Identisch zu B<CFLAGS>.

note: type: Plain text
en: Options for the Fortran compiler. Same as B<CFLAGS>.
de: Optionen für den Fortran-Compiler. Identisch zu B<CFLAGS>.

note: type: Plain text
en: Options passed to the compiler when linking executables or shared objects (if the linker is called directly, then B<-Wl> and B<,> have to be stripped from these options). Default value: empty.
de: Optionen die beim Linken von Programmen oder Laufzeitbibliotheken an den Compiler weitergegeben werden (falls der Linker direkt aufgerufen wird, müssen B<-Wl> und B<,> aus diesen Optionen entfernt werden). Standardmäßig leer.

note: type: TP
en: B<$XDG_CONFIG_HOME/dpkg/buildflags.conf> or B<$HOME/.config/dpkg/buildflags.conf>
de: B<$XDG_CONFIG_HOME/dpkg/buildflags.conf> oder B<$HOME/.config/dpkg/buildflags.conf>

note: type: Plain text
en: User configuration file.
de: Benutzer-Konfigurationsdatei

note: type: Plain text
en: There are 2 sets of environment variables doing the same operations, the first one (DEB_I<flag>_I<op>) should never be used within B<debian/rules>. It's meant for any user that wants to rebuild the source package with different build flags. The second set (DEB_I<flag>_MAINT_I<op>) should only be used in B<debian/rules> by package maintainers to change the resulting build flags.
de: Es gibt einen Satz von zwei Umgebungsvariablen, die den gleichen Vorgang durchführen. Der erste (DEB_I<Schalter>_I<Vorg>) sollte niemals innerhalb von B<debian/rules> verwandt werden. Er ist für Benutzer gedacht, die das Quellpaket mit anderen Bauschaltern erneut bauen möchten. Der zweite Satz (DEB_I<Schalter>_MAINT_I<Vorg>) sollte nur durch Paketbetreuer in B<debian/rules> verwandt werden, um die entstehenden Bauschalter zu ändern.

note: type: TP
en: B<DEB_>I<flag>B<_SET>
de: B<DEB_>I<Schalter>B<_SET>

note: type: TQ
en: B<DEB_>I<flag>B<_MAINT_SET>
de: B<DEB_>I<Schalter>B<_MAINT_SET>

note: type: Plain text
en: This variable can be used to force the value returned for the given I<flag>.
de: Diese Variable kann zum Erzwingen des für I<Schalter> zurückgegebenen Werts verwandt werden.

note: type: TP
en: B<DEB_>I<flag>B<_STRIP>
de: B<DEB_>I<Schalter>B<_STRIP>

note: type: TQ
en: B<DEB_>I<flag>B<_MAINT_STRIP>
de: B<DEB_>I<Schalter>B<_MAINT_STRIP>

note: type: Plain text
en: This variable can be used to provide a space separated list of options that will be stripped from the set of flags returned for the given I<flag>.
de: Diese Variable kann zum Bereitstellen einer durch Leerzeichen getrennten Liste von Optionen verwandt werden, die aus dem Satz von I<Schalter> zurückgelieferten Schaltern entfernt werden.

note: type: TP
en: B<DEB_>I<flag>B<_APPEND>
de: B<DEB_>I<Schalter>B<_APPEND>

note: type: TQ
en: B<DEB_>I<flag>B<_MAINT_APPEND>
de: B<DEB_>I<Schalter>B<_MAINT_APPEND>

note: type: Plain text
en: This variable can be used to append supplementary options to the value returned for the given I<flag>.
de: Diese Variable kann zum Anhängen ergänzender Optionen zum Wert, der von I<Schalter> zurückgegeben wird, verwandt werden.

note: type: TP
en: B<DEB_>I<flag>B<_PREPEND>
de: B<DEB_>I<Schalter>B<_PREPEND>

note: type: TQ
en: B<DEB_>I<flag>B<_MAINT_PREPEND>
de: B<DEB_>I<Schalter>B<_MAINT_PREPEND>

note: type: Plain text
en: This variable can be used to prepend supplementary options to the value returned for the given I<flag>.
de: Diese Variable kann zum Voranstellen ergänzender Optionen zum Wert, der von I<Schalter> zurückgegeben wird, verwandt werden.

note: type: Plain text
en: This variable can be used to disable/enable various hardening build flags through the B<hardening> option. See the B<HARDENING> section for details.
de: Diese Variable kann zum Deaktivieren oder Aktivieren verschiedener Härtungsbauschalter durch die Option B<hardening> verwandt werden. Lesen Sie den Abschnitt B<HÄRTUNG> für weitere Details.

note: type: SH
en: HARDENING
de: HÄRTUNG

note: type: Plain text
en: Several compile-time options (detailed below) can be used to help harden a resulting binary against memory corruption attacks, or provide additional warning messages during compilation. Except as noted below, these are enabled by default for architectures that support them.
de: Mehrere Kompilierzeit-Optionen (weiter unten beschrieben) können dazu verwandt werden, ein erstelltes Programm gegen Speicherverfälschungsangriffe zu härten, oder zusätzliche Warnungsmeldungen während der Übersetzung auszugeben. Sie werden für Architekturen, die diese unterstützen, standardmäßig aktiviert; die Ausnahmen sind unten angegeben.

note: type: Plain text
en: Each hardening feature can be enabled and disabled in the B<DEB_BUILD_MAINT_OPTIONS> environment variable's B<hardening> value with the "+" and "-" modifier. For example, to enable the "pie" feature and disable the "fortify" feature you can do this in B<debian/rules>:
de: Jede Härtungsfunktionalität kann durch den entsprechenden B<Härtungs->-Wert in der Umgebungsvariablen B<DEB_BUILD_MAINT_OPTIONS> mit den »+«- und »-«-Schaltern aktiviert und deaktiviert werden. Soll beispielsweise die »pie«-Funktionalität aktiviert und die »fortify«-Funktionalität deaktiviert werden, können Sie Folgendes in B<debian/rules> verwenden:

note: type: Plain text
en: The special feature B<all> can be used to enable or disable all hardening features at the same time. Thus disabling everything and enabling only "format" and "fortify" can be achieved with:
de: Die spezielle Funktionalität B<all> kann dazu verwandt werden, alle Härtungsfunktionalitäten auf einmal zu aktivieren oder zu deaktiveren. Um daher alles zu deaktiveren und nur »format« und »fortify« zu aktiveren, kann Folgendes eingesetzt werden:

note: type: Plain text
en: This setting (enabled by default) adds B<-Wformat -Werror=format-security> to B<CFLAGS> and B<CXXFLAGS>. This will warn about improper format string uses, and will fail when format functions are used in a way that represent possible security problems. At present, this warns about calls to B<printf> and B<scanf> functions where the format string is not a string literal and there are no format arguments, as in B<printf(foo);> instead of B<printf("%s", foo);> This may be a security hole if the format string came from untrusted input and contains "%n".
de: Diese Einstellung (standardmäßig aktiviert) fügt B<-Wformat -Werror=format-security> zu B<CFLAGS> und B<CXXFLAGS> hinzu. Damit wird über inkorrekte Formatzeichenkettenverwendungen gewarnt und zu einem Fehler führen, wenn Formatfunktionen deart verwandt werden, dass daraus ein mögliches Sicherheitsproblem werden könnte. Derzeit warnt dies über Aufrufe auf B<printf>- und B<scanf>-Funktionen, bei denen die Formatzeichenkette nicht eine reine Zeichenkette ist und es keine Formatargumente gibt, wie in B<printf(foo);> statt B<printf("%s", foo);>. Dies könnte ein Sicherheitsproblem sein, falls die Formatzeichenkette aus einer unvertrauenswürdigen Eingabe stammt und »%n« enthält.

note: type: Plain text
en: This setting (enabled by default) adds B<-D_FORTIFY_SOURCE=2> to B<CPPFLAGS>. During code generation the compiler knows a great deal of information about buffer sizes (where possible), and attempts to replace insecure unlimited length buffer function calls with length-limited ones. This is especially useful for old, crufty code.  Additionally, format strings in writable memory that contain '%n' are blocked. If an application depends on such a format string, it will need to be worked around.
de: Diese Einstellung (standardmäßig aktiviert) fügt B<-D_FORTIFY_SOURCE=2> zu B<CPPFLAGS> hinzu. Während der Code-Erstellung hat der Compiler umfangreiche Informationen über Puffergrößen (wo möglich) und versucht, unsichere unbegrenzte Pufferfunktionsaufrufe durch längenbegrenzte zu ersetzen. Das ist besonders für alten, verkramten Code nützlich. Zusätzlich werden Formatzeichenketten in schreibbarem Speicher, die »%n« enthalten, blockiert. Falls eine Anwendung von solchen Formatzeichenketten abhängt, müssen dafür andere Lösungsmöglichkeiten gefunden werden.

note: type: Plain text
en: Note that for this option to have any effect, the source must also be compiled with B<-O1> or higher.
de: Beachten Sie, dass die Quellen auch mit B<-O1> oder höher kompiliert werden müssen, damit diese Option einen Effekt hat.

note: type: Plain text
en: This setting (enabled by default) adds B<-fstack-protector --param=ssp-buffer-size=4> to B<CFLAGS> and B<CXXFLAGS>. This adds safety checks against stack overwrites. This renders many potential code injection attacks into aborting situations. In the best case this turns code injection vulnerabilities into denial of service or into non-issues (depending on the application).
de: Diese Einstellung (standardmäßig aktiviert) fügt B<-fstack-protector --param=ssp-buffer-size=4> zu B<CFLAGS> und B<CXXFLAGS> hinzu. Dies fügt Sicherheitsprüfungen gegen die Überschreibung des Stapelspeichers (Stacks) hinzu. Damit werden viele mögliche Code-Einfügeangriffe zu Abbruchsituationen. Im besten Fall werden damit Code-Einfügungsangriffe zu Diensteverweigerungsangriffen oder zu keinen Problemen (abhängig von der Anwendung).

note: type: Plain text
en: This feature requires linking against glibc (or another provider of B<__stack_chk_fail>), so needs to be disabled when building with B<-nostdlib> or B<-ffreestanding> or similar.
de: Diese Funktionalität benötigt das Linken mit Glibc (oder einem anderen Anbieter von B<__stack_chk_fail>). Sie muss daher deaktiviert werden, wenn mit B<-nostdlib> oder B<-ffreestanding> oder Ähnlichem gebaut wird.

note: type: Plain text
en: This setting (enabled by default) adds B<-Wl,-z,relro> to B<LDFLAGS>.  During program load, several ELF memory sections need to be written to by the linker. This flags the loader to turn these sections read-only before turning over control to the program. Most notably this prevents GOT overwrite attacks. If this option is disabled, B<bindnow> will become disabled as well.
de: Diese Einstellung (standardmäßig aktiviert) fügt B<-Wl,-z,relro> zu B<LDFLAGS> hinzu. Während des Ladens des Programms müssen mehrere ELF-Speicherabschnitte vom Binder (Linker) geschrieben werden. Diese Einstellung signalisiert dem Ladeprogramm, diese Abschnitte in nur-Lese-Zugriff zu ändern, bevor die Steuerung an das Programm übergeben wird. Insbesondere verhindert dies GOT-Überschreibeangriffe. Falls diese Option deaktiviert ist, wird auch B<bindnow> deaktiviert.

note: type: Plain text
en: This setting (disabled by default) adds B<-Wl,-z,now> to B<LDFLAGS>. During program load, all dynamic symbols are resolved, allowing for the entire PLT to be marked read-only (due to B<relro> above). The option cannot become enabled if B<relro> is not enabled.
de: Diese Einstellung (standardmäßig deaktiviert) fügt B<-Wl,-z,now> zu B<LDFLAGS> hinzu. Während des Ladens des Programms werden alle dynamischen Symbole aufgelöst, womit das gesamte PLT nur-lesend markiert werden kann (aufgrund von B<relro> oben). Diese Option kann nicht aktiviert werden, falls B<relro> nicht aktiviert ist.

note: type: Plain text
en: This setting (disabled by default) adds B<-fPIE> to B<CFLAGS> and B<CXXFLAGS>, and B<-fPIE -pie> to B<LDFLAGS>. Position Independent Executable are needed to take advantage of Address Space Layout Randomization, supported by some kernel versions. While ASLR can already be enforced for data areas in the stack and heap (brk and mmap), the code areas must be compiled as position-independent. Shared libraries already do this (-fPIC), so they gain ASLR automatically, but binary .text regions need to be build PIE to gain ASLR. When this happens, ROP (Return Oriented Programming) attacks are much harder since there are no static locations to bounce off of during a memory corruption attack.
de: Diese Einstellung (standardmäßig deaktiviert) fügt B<-fPIE> zu B<CFLAGS> und B<CXXFLAGS> sowie B<-fPIE -pie> zu B<LDFLAGS> hinzu. »Position Independent Executable« (positionsunabhängige Programme) werden benötigt, um »Address Space Layout Randomization« (Bereitstellung eines zufälligen Adressbereichlayouts) auszunutzen, der von einigen Kernelversionen bereitgestellt wird. Während ASLR bereits für Datenbereiche auf dem Stapel (Stack) und Heap erzwungen werden kann (brk und mmap), müssen die Codebereiche positionsunabhängig übersetzt werden. Laufzeitbibliotheken machen dies bereits (-fPIC), so dass sie ASLR automatisch erhalten, aber Programm-.text-Regionen müssen mit PIE gebaut werden, um ASLR zu erhalten. Wenn dies passiert, sind ROP- (Return Oriented Programming) Angriffe sehr viel schwerer durchzuführen, da es keine statischen Orte mehr gibt, zu denen während eines Speicherverfälschungsangriffs hingesprungen werden könnte.

note: type: Plain text
en: This is not compatible with B<-fPIC> so care must be taken when building shared objects.
de: Dies ist nicht mit B<-fPIC> kompatibel, daher muss beim Erstellen von Laufzeitbibliotheken Vorsicht angewandt werden.

note: type: Plain text
en: Additionally, since PIE is implemented via a general register, some architectures (most notably i386) can see performance losses of up to 15% in very text-segment-heavy application workloads; most workloads see less than 1%. Architectures with more general registers (e.g. amd64)  do not see as high a worst-case penalty.
de: Zusätzlich können auf einigen Architekturen (am deutlichsten auf i368) Leistungsverluste von bis zu 15% in sehr text-Segment-lastigen Anwendungsfällen auftreten, da PIE über allgemeine Register implementiert ist; in den meisten Anwendungsfällen sind dies weniger als 1%. Architekturen mit mehr allgemeinen Registern (z.B. Amd64) erfahren nicht diese Schlimmstfall-Strafe.

note: type: Plain text
en: dpkg-buildpackage - build binary or source packages from sources
de: dpkg-buildpackage - baue Binär- oder Quellpakete aus Quellen

note: type: Plain text
en: B<dpkg-buildpackage> [I<option>...]
de: B<dpkg-buildpackage> [I<Option> …]

note: type: Plain text
en: B<dpkg-buildpackage> is a program that automates the process of building a Debian package. It consists of the following steps:
de: B<dpkg-buildpackage> ist ein Programm, das den Prozess des Bauens eines Debian-Paketes automatisiert. Es besteht aus den folgenden Schritten:

note: type: Plain text
en: It prepares the build environment by setting various environment variables (see B<ENVIRONMENT>) and calls B<dpkg-source --before-build> (unless B<-T> or B<--target> has been used).
de: Es bereitet die Bauumgebung vor, indem verschiedene Umgebungsvariablen gesetzt werden (siehe B<UMGEBUNG>) und ruft B<dpkg-source --before-build> auf (es sei denn, B<-T> oder B<--target> wurde verwandt).

note: type: Plain text
en: It checks that the build-dependencies and build-conflicts are satisfied (unless B<-d> is specified).
de: Es prüft, dass Bauabhängigkeiten und -konflikte erfüllt sind (falls B<-d> nicht angegeben ist).

note: type: Plain text
en: If a specific target has been selected with the B<-T> or B<--target> option, it calls that target and stops here. Otherwise it calls B<fakeroot debian/rules clean> to clean the build-tree (unless B<-nc> is specified).
de: Falls ein spezielles Ziel mit der Option B<-T> oder B<--target> ausgewählt wurde, ruft es diese Ziel auf und endet hier. Andernfalls ruft es B<fakeroot debian/ rules clean> auf, um den Bau-Baum zu bereinigen (falls B<-nc> nicht angegeben ist).

note: type: Plain text
en: It calls B<dpkg-source -b> to generate the source package (unless a binary-only build has been requested with B<-b>, B<-B> or B<-A>).
de: Es ruft B<dpkg-source -b> auf, um das Quellpaket zu erstellen (falls nicht mit B<-b>, B<-B> oder B<-A> ein rein-binärer Bau erbeten wurde).

note: type: Plain text
en: It calls B<debian/rules> I<build-target> followed by B<fakeroot debian/rules> I<binary-target> (unless a source-only build has been requested with B<-S>). Note that I<build-target> and I<binary-target> are either B<build> and B<binary> (default case, or if B<-b> is specified), or B<build-arch> and B<binary-arch> (if B<-B> is specified), or B<build-indep> and B<binary-indep> (if B<-A> is specified).
de: Es ruft B<debian/rules> I<Bauziel>, gefolgt von B<fakeroot debian/rules> I<Binärziel> auf (falls nicht ein reiner Quellbau mit B<-S> erbeten wurde). Beachten Sie, dass I<Bauziel> und I<Binärziel> entweder B<build> und B<binary> (Standardfall, oder falls B<-b> angegeben ist) oder B<build-arch> und B<binary-arch> (falls B<-B> angegeben ist) oder B<build-indep> und B<binary-indep> (falls B<-A> angegeben ist) lauten.

note: type: Plain text
en: It calls B<gpg> to sign the B<.dsc> file (if any, unless B<-us> is specified).
de: Es ruft B<gpg> auf, um die B<.dsc>-Datei zu signieren (falls vorhanden und B<-us> nicht angegeben wurde).

note: type: Plain text
en: It calls B<dpkg-genchanges> to generate a B<.changes> file.  Many B<dpkg-buildpackage> options are forwarded to B<dpkg-genchanges>.
de: Es ruft B<dpkg-genchanges> auf, um eine B<.changes>-Datei zu erstellen. Viele Optionen von B<dpkg-buildpackage> werden an B<dpkg-genchanges> weitergeleitet.

note: type: Plain text
en: It calls B<gpg> to sign the B<.changes> file (unless B<-uc> is specified).
de: Es ruft B<gpg> auf, um die B<.changes>-Datei zu signieren (falls B<-uc> nicht angegeben wurde).

note: type: Plain text
en: If B<-tc> is specified, it will call B<fakeroot debian/rules clean> again. Finally it calls B<dpkg-source --after-build>.
de: Falls B<-tc> angegeben ist, wird B<fakeroot debian/rules clean> erneut aufgerufen. Schließlich ruft es B<dpkg-source --after-build> auf.

note: type: Plain text
en: Specifies a binary-only build, no source files are to be built and/or distributed. Passed to B<dpkg-genchanges>.
de: Spezifiziert einen rein binären Bau, keine Quelldateien sollen gebaut und/oder vertrieben (im Sinne von verteilen) werden. Wird an B<dpkg-genchanges> weitergegeben.

note: type: Plain text
en: Specifies a binary-only build, limited to architecture dependent packages.  Passed to B<dpkg-genchanges>.
de: Spezifiziert einen rein binären Bau, beschränkt auf architekturabhängige Pakete. Wird an B<dpkg-genchanges> weitergegeben.

note: type: Plain text
en: Specifies a binary-only build, limited to architecture independent packages. Passed to B<dpkg-genchanges>.
de: Spezifiziert einen rein binären Bau, beschränkt auf architekturunabhängige Pakete. Wird an B<dpkg-genchanges> weitergegeben.

note: type: Plain text
en: Specifies a source-only build, no binary packages need to be made.  Passed to B<dpkg-genchanges>.
de: Spezifiziert einen reinen Bau der Quellen, keine Binärpakete müssen erstellt werden. Wird an B<dpkg-genchanges> weitergegeben.

note: type: Plain text
en: Specifies a normal full build, binary and source packages will be built.  This is the same as the default case when no build option is specified.
de: Spezifiziert einen normalen kompletten Bau, Binär- und Quellpakete werden gebaut. Dies ist identisch zum Standardfall, wenn keine Bauoption spezifiziert wird.

note: type: Plain text
en: B<--target=>I<target>
de: B<--target=>I<Ziel>

note: type: Plain text
en: B<--target >I<target>
de: B<--target >I<Ziel>

note: type: Plain text
en: B<-T>I<target>
de: B<-T>I<Ziel>

note: type: Plain text
en: Calls B<debian/rules> I<target> after having setup the build environment and stops the package build process here. If B<--as-root> is also given, then the command is executed as root (see B<-r>). Note that official targets that are required to be run as root by the Debian policy do not need this option.
de: Ruft B<debian/rules> I<Ziel> auf, nachdem die Bauumgebung eingerichtet wurde und beendet den Paketbauprozess hier. Falls auch B<--as-root> angegeben wurde, wird der Befehl mit root-Rechten ausgeführt (siehe B<-r>). Beachten Sie, dass offizielle Ziele, bei denen die Debian-Richtlinien verlangen, dass Sie mit root-Rechten ausgeführt werden, diese Option nicht benötigen.

note: type: Plain text
en: Only meaningful together with B<--target>. Requires that the target be run with root rights.
de: Ergibt nur mit B<--target> einen Sinn. Erfordert, dass das Ziel mit Root-Rechten ausgeführt wird.

note: type: TP
en: B<-v>I<version>
de: B<-v>I<Version>

note: type: TP
en: B<-C>I<changes-description>
de: B<-C>I<Änderungsbeschreibung>

note: type: TP
en: B<-m>I<maintainer-address>
de: B<-m>I<Betreueradresse>

note: type: TP
en: B<-e>I<maintainer-address>
de: B<-e>I<Betreueradresse>

note: type: Plain text
en: Passed unchanged to B<dpkg-genchanges>. See its manual page.
de: Wird unverändert an B<dpkg-genchanges> weitergegeben. Lesen Sie dessen Handbuchseite.

note: type: TP
en: B<-a>I<architecture>
de: B<-a>I<Architektur>

note: type: Plain text
en: Specify the Debian architecture we build for. The architecture of the machine we build on is determined automatically, and is also the default for the host machine.
de: Spezifiziert die Debian-Architektur, für die gebaut wird. Die Architektur der Maschine, auf der gebaut wird, wird automatisch bestimmt, und ist auch die Voreinstellung für die Gastgebermaschine (»host machine«).

note: type: Plain text
en: Specify the GNU system type we build for. It can be used in place of -a or as a complement to override the default GNU system type of the target Debian architecture.
de: Spezifiziere den GNU-Systemtyp, für den wir bauen. Er kann anstelle von -a oder als Ergänzung verwandt werden, um den Standard GNU-Systemtyp der Ziel-Debian-Architektur zu überschreiben.

note: type: TP
en: B<-j>I<jobs>
de: B<-j>I<Aufträge>

note: type: Plain text
en: Number of jobs allowed to be run simultaneously, equivalent to the B<make>(1)  option of the same name. Will add itself to the MAKEFLAGS environment variable, which should cause all subsequent make invocations to inherit the option. Also adds B<parallel=>I<jobs> to the DEB_BUILD_OPTIONS environment variable which allows debian/rules files to use this information for their own purposes.  The B<parallel=>I<jobs> in DEB_BUILD_OPTIONS environment variable will override the B<-j> value if this option is given.
de: Anzahl an Aufträgen, die simultan laufen dürfen, äquivalent zu der Option von B<make>(1) mit dem gleichen Namen. Fügt sich selbst zu der Umgebungsvariablen MAKEFLAGS hinzu, was dazu führen sollte, dass alle folgenden Aufrufe von make diese Option erben werden. Fügt auch B<parallel=>I<Aufträge> zu der Umgebungsvariablen DEB_BUILD_OPTIONS hinzu, was es debian/rules-Dateien erlaubt, diese Information für eigene Zwecke zu verwenden. Der Eintrag B<parallel=>I<Aufträge> in der Umgebungsvariablen DEB_BUILD_OPTIONS überschreibt den Wert von B<-j>, falls diese Option angegeben ist.

note: type: Plain text
en: Check build dependencies and conflicts; abort if unsatisfied. This is the default behavior.
de: Prüfe Bauabhängigkeiten und -konflikte; Abbruch falls diese nicht erfüllt sind. Dies ist das Standardverhalten.

note: type: Plain text
en: Do not check build dependencies and conflicts.
de: Überprüfe Bauabhängigkeiten und -konflikte nicht.

note: type: Plain text
en: Do not clean the source tree (implies B<-b> if nothing else has been selected among B<-B>, B<-A> or B<-S>).
de: Bereinige den Quellbaum nicht (impliziert B<-b>, falls ansonsten nichts aus B<-B>, B<-A> oder B<-S> gewählt wurde).

note: type: Plain text
en: Clean the source tree (using I<gain-root-command> B<debian/rules clean>)  after the package has been built.
de: Den Quellbaum säubern (verwendet I<root-werde-Befehl> B<debian/rules clean>) nachdem das Paket gebaut wurde.

note: type: TP
en: B<-r>I<gain-root-command>
de: B<-r>I<root-werde-Befehl>

note: type: Plain text
en: When B<dpkg-buildpackage> needs to execute part of the build process as root, it prefixes the command it executes with I<gain-root-command> if one has been specified. Otherwise, if none has been specified, B<fakeroot> will be used by default, if the command is present.  I<gain-root-command> should start with the name of a program on the B<PATH> and will get as arguments the name of the real command to run and the arguments it should take.  I<gain-root-command> can include parameters (they must be space-separated) but no shell metacharacters.  I<gain-root-command> might typically be B<fakeroot>, B<sudo>, B<super> or B<really>.  B<su> is not suitable, since it can only invoke the user's shell with B<-c> instead of passing arguments individually to the command to be run.
de: Wenn B<dpkg-buildpackage> einen Teil des Bauprozesses als Root ausführen muss, stellt es dem auszführenden Befehl den I<root-werde-Befehl> voran, falls dieser angegeben wurde. Andernfalls wird standardmäßig B<fakeroot> verwendet, falls es vorhanden ist. Der I<root-werde-Befehl> sollte der Name des Programmes im B<PATH> sein und wird als Argumente den Namen des wirklich auszuführenden Befehles und dessen Argumente erhalten. I<root-werde-Befehl> kann Parameter enthalten (die durch Leerzeichen voneinander getrennt sein müssen), aber keine Shell-Metazeichen. Typischerweise ist der I<root-werde-Befehl> B<fakeroot>, B<sudo>, B<super> oder B<really>. B<su> ist nicht geeignet, da es nur die Shell des Benutzers mit B<-c> aufrufen kann, anstatt Argumente individuell zur Ausführung des Programms zu übergeben.

note: type: TP
en: B<-R>I<rules-file>
de: B<-R>I<rules-Datei>

note: type: Plain text
en: Building a Debian package usually involves invoking B<debian/rules> as a command with several standard parameters. With this option it's possible to use another program invocation to build the package (it can include space separated parameters).  Alternatively it can be used to execute the standard rules file with another make program (for example by using B</usr/local/bin/make -f debian/rules> as I<rules-file>).
de: Der Bau eines Debian-Pakets erfolgt gewöhnlich durch Aufruf von B<debian/rules> als ein Befehl mit mehreren Standardparametern. Mit dieser Option ist es möglich, einen anderen Programmaufruf zum Bau des Paketes zu verwenden (es können durch Leerzeichen getrennte Parameter angegeben werden). Alternativ kann die Standard-debian/rules-Datei mit einem anderen Make-Programm ausgeführt werden (zum Beispiel durch die Verwendung von B</usr/local/bin/make -f debian/rules> als I<rules-Datei>).

note: type: TP
en: B<-p>I<sign-command>
de: B<-p>I<signier-Befehl>

note: type: Plain text
en: When B<dpkg-buildpackage> needs to execute GPG to sign a source control (B<.dsc>) file or a B<.changes> file it will run I<sign-command> (searching the B<PATH> if necessary) instead of B<gpg>. I<sign-command> will get all the arguments that B<gpg> would have gotten. I<sign-command> should not contain spaces or any other shell metacharacters.
de: Wenn B<dpkg-buildpackage> GPG zum Signieren einer Quellsteuerdatei (B<.dsc>) oder einer B<.changes>-Datei benötigt, wird es statt B<gpg> den I<signier-Befehl> ausführen (und dabei falls notwendig den B<PATH> durchsuchen). I<signier-Befehl> wird alle Argumente erhalten, die B<gpg> erhalten hätte. I<signier-Befehl> sollte keine Leerzeichen oder andere Metazeichen der Shell enthalten.

note: type: TP
en: B<-k>I<key-id>
de: B<-k>I<Schlüssel-id>

note: type: Plain text
en: Specify a key-ID to use when signing packages.
de: Geben Sie die Schlüssel-ID zur Signatur von Paketen an.

note: type: Plain text
en: Do not sign the source package.
de: Das Quellpaket nicht signieren.

note: type: Plain text
en: Do not sign the B<.changes> file.
de: Die B<.changes>-Datei nicht signieren.

note: type: Plain text
en: B<-i>[I<regexp>]
de: B<-i>[I<Regexp>]

note: type: Plain text
en: B<-I>I<[pattern]>
de: B<-I>I<[Muster]>

note: type: Plain text
en: Passed unchanged to B<dpkg-source>. See its manual page.
de: Wird unverändert an B<dpkg-source> weitergegeben. Lesen Sie dessen Handbuchseite.

note: type: TP
en: B<--source-option=>I<opt>
de: B<--source-option=>I<Opt>

note: type: Plain text
en: Pass option I<opt> to B<dpkg-source>.
de: Option I<Opt> an B<dpkg-source> weitergeben.

note: type: TP
en: B<--changes-option=>I<opt>
de: B<--changes-option=>I<Opt>

note: type: Plain text
en: Pass option I<opt> to B<dpkg-genchanges>.
de: Option I<Opt> an B<dpkg-genchanges> weitergeben.

note: type: Plain text
en: B<--admindir >I<dir>
de: B<--admindir >I<Verz>

note: type: Plain text
en: Change the location of the B<dpkg> database. The default location is I</var/lib/dpkg>.
de: Ändert den Ablageort der B<dpkg>-Datenbank. Der Standardort ist I</var/lib/dpkg>.

note: type: Plain text
en: Even if B<dpkg-buildpackage> exports some variables, B<debian/rules> should not rely on their presence and should instead use the respective interface to retrieve the needed values.
de: Selbst falls B<dpkg-buildpackage> einige Variablen exportiert, sollte B<debian/rules> sich nicht auf ihre Gegenwart verlassen, sondern stattdessen die entsprechende Schnittstelle verwenden, um die benötigten Werte zu abzufragen.

note: type: SS
en: Variables set by dpkg-architecture
de: Von dpkg-architecture gesetzte Variablen

note: type: Plain text
en: B<dpkg-architecture> is called with the B<-a> and B<-t> parameters forwarded. Any variable that is output by its B<-s> option is integrated in the build environment.
de: Beim Aufruf von B<dpkg-architecture> werden die Parameter von B<-a> und B<-t> durchgereicht. Jede Variable, die von seiner Option B<-s> ausgegeben wird, wird in die Bauumgebung integriert.

note: type: SS
en: Compiler flags are no longer exported
de: Kompilierschalter werden nicht mehr exportiert

note: type: Plain text
en: Between versions 1.14.17 and 1.16.1, B<dpkg-buildpackage> exported compiler flags (B<CFLAGS>, B<CXXFLAGS>, B<FFLAGS>, B<CPPFLAGS> and B<LDFLAGS>) with values as returned by B<dpkg-buildflags>. This is no longer the case.
de: Zwischen den Versionen 1.14.17 and 1.16.1 exportierte B<dpkg-buildpackage> Kompilierschalter (B<CFLAGS>, B<CXXFLAGS>, B<FFLAGS>, B<CPPFLAGS> und B<LDFLAGS>) mit Werten, die von B<dpkg-buildflags> geliefert wurden. Dies ist nicht mehr der Fall.

note: type: Plain text
en: B<dpkg-buildpackage> is using the B<build-arch> and B<build-indep> targets since version 1.16.2. Those targets are thus mandatory. But to avoid breakages of existing packages, and ease the transition, it will fallback to using the B<build> target if B<make -f debian/rules -qn> I<build-target> returns 2 as exit code.
de: B<dpkg-buildpackage> verwendet seit Version 1.16.2 die Ziele B<build-arch> und B<build-indep>. Diese Ziele sind daher verpflichtend. Um aber Baufehler bei existierenden Paketen zu vermeiden und um den Übergang zu erleichtern, wird es auf das Ziel B<build> zurückfallen, falls B<make -f debian/rules -qn> I<Bauziel> den Rückgabewert 2 liefert.

note: type: Plain text
en: It should be possible to specify spaces and shell metacharacters in and initial arguments for I<gain-root-command> and I<sign-command>.
de: Es sollte möglich sein, Leerzeichen und Metazeichen der Shell in und Anfangsargumente für I<root-werde-Befehl> und I<signier-Befehl> anzugeben.

note: type: Plain text
en: dpkg-checkbuilddeps - check build dependencies and conflicts
de: dpkg-checkbuilddeps - überprüfe Bauabhängigkeiten und -konflikte

note: type: Plain text
en: B<dpkg-checkbuilddeps> [I<option>...] [I<control-file>]
de: B<dpkg-checkbuilddeps> [I<Option> …] [I<Befehlsdatei>]

note: type: Plain text
en: This program checks the installed packages in the system against the build dependencies and build conflicts listed in the control file. If any are not met, it displays them and exits with a nonzero return code.
de: Dieses Programm überprüft die im System installierten Pakete gegen die Bauabhängigkeiten und Baukonflikte, die in der Steuerdatei aufgeführt sind. Falls welche davon nicht erfüllt sind, zeigt es diese an und beendet sich mit einem von Null verschiedenen Rückgabewert.

note: type: Plain text
en: By default, B<debian/control> is read, but an alternate control filename may be specified on the command line.
de: Standardmäßig wird B<debian/control> gelesen, aber ein alternativer Steuerdateiname kann auf der Kommandozeile angegeben werden.

note: type: Plain text
en: Ignore I<Build-Depends-Arch> and I<Build-Conflicts-Arch> lines. Use when only arch-indep packages will be built, or combine with B<-B> when only a source package is to be built.
de: Ignoriere I<Build-Depends-Indep> und I<Build-Conflicts-Arch>-Zeilen. Verwenden Sie dies, wenn nur arch-indep-Pakete gebaut werden oder kombinieren Sie es mit B<-B>, wenn nur ein Quellpaket gebaut werden soll.

note: type: Plain text
en: Ignore I<Build-Depends-Indep> and I<Build-Conflicts-Indep> lines. Use when only arch-dep packages will be built, or combine with B<-A> when only a source package is to be built.
de: Ignoriere I<Build-Depends-Indep> und I<Build-Conflicts-Indep>-Zeilen. Verwenden Sie dies, wenn nur arch-dep-Pakete gebaut werden oder kombinieren Sie es mit B<-A>, wenn nur ein Quellpaket gebaut werden soll.

note: type: TP
en: B<-d >I<build-depends-string>
de: B<-d >I<Zeichenkette-für-Bauabhängigkeiten>

note: type: TP
en: B<-c >I<build-conflicts-string>
de: B<-c >I<Zeichenkette-für-Baukonflikte>

note: type: Plain text
en: Use the given build dependencies/conflicts instead of those contained in the I<debian/control> file.
de: Verwende die angegebenen Bauabhängigkeiten/-konflikte statt denen der Datei I<debian/control>.

note: type: TP
en: B<-a >I<arch>
de: B<-a >I<Architektur>

note: type: Plain text
en: Check build dependencies/conflicts assuming that the package described in the control file is to be built for the given host architecture instead of the architecture of the current system.
de: Überprüfe Bauabhängigkeiten/-konflikte unter der Annahme, dass das Paket in der Datei »control« für die angegebene Host-Architektur statt für die Architektur des aktuellen Systems gebaut werden soll.

note: type: Plain text
en: dpkg-distaddfile - add entries to debian/files
de: dpkg-distaddfile - Einträge zu debian/files hinzufügen

note: type: Plain text
en: B<dpkg-distaddfile> [I<option>...]I< filename section priority>
de: B<dpkg-distaddfile> [I<Option> …]I< Dateiname Bereich Priorität>

note: type: Plain text
en: B<dpkg-distaddfile> adds an entry for a named file to B<debian/files>.
de: B<dpkg-distaddfile> fügt einen Eintrag für eine benannte Datei in B<debian/files> hinzu.

note: type: Plain text
en: It takes three non-option arguments, the filename and the section and priority for the B<.changes> file.
de: Es erwartet drei nicht-Options-Argumente, den Dateinamen, den Bereich und die Priorität für die B<.changes>-Datei.

note: type: Plain text
en: The filename should be specified relative to the directory where B<dpkg-genchanges> will expect to find the files, usually B<..>, rather than being a pathname relative to the current directory when B<dpkg-distaddfile> is run.
de: Der Dateiname sollte relativ zum Verzeichnis angegeben werden, in dem B<dpkg-genchanges> die Dateien erwartet, normalerweise B<..>, statt ein relativer Pfadname zu dem aktuellen Verzeichnis zu sein, wenn B<dpkg-distaddfile> ausgeführt wird.

note: type: TP
en: B<-f>I<files-list-file>
de: B<-f>I<Dateienlist-Datei>

note: type: Plain text
en: Read or write the list of files to be uploaded here, rather than using B<debian/files>.
de: Lese oder schreibe die Liste der hochzuladenen Dateien hierher, statt B<debian/files> zu verwenden.

note: type: Plain text
en: The list of generated files which are part of the upload being prepared.  B<dpkg-distaddfile> can be used to add additional files.
de: Die Liste der erzeugten Dateien, die Teil des vorbereiteten Uploads sind. B<dpkg-distaddfile> kann dazu verwendet werden, zusätzliche Dateien hinzuzufügen.

note: type: Plain text
en: dpkg-deb - Debian package archive (.deb) manipulation tool
de: dpkg-deb - Debian-Paketarchiv (.deb) Manipulationswerkzeug

note: type: Plain text
en: B<dpkg-deb> [I<option>...] I<command>
de: B<dpkg-deb> [I<Option> …] I<Befehl>

note: type: Plain text
en: B<dpkg-deb> packs, unpacks and provides information about Debian archives.
de: B<dpkg-deb> packt und entpackt Debian-Archive und stellt Informationen über sie breit.

note: type: Plain text
en: Use B<dpkg> to install and remove packages from your system.
de: Verwenden Sie B<dpkg>, um Pakete auf Ihrem System hinzuzufügen oder zu entfernen

note: type: Plain text
en: You can also invoke B<dpkg-deb> by calling B<dpkg> with whatever options you want to pass to B<dpkg-deb>. B<dpkg> will spot that you wanted B<dpkg-deb> and run it for you.
de: Sie können B<dpkg-deb> durch Aufruf von B<dpkg> mit beliebigen Optionen, die Sie an B<dpkg-deb> übergeben wollen, aufrufen. B<dpkg> erkennt, dass Sie B<dpkg-deb> wollten und wird es für Sie ausführen.

note: type: TP
en: B<-b>, B<--build> I<directory> [I<archive>|I<directory>]
de: B<-b>, B<--build> I<Verzeichnis> [I<Archiv>|I<Verzeichnis>]

note: type: Plain text
en: Creates a debian archive from the filesystem tree stored in I<directory>. I<directory> must have a B<DEBIAN> subdirectory, which contains the control information files such as the control file itself. This directory will I<not> appear in the binary package's filesystem archive, but instead the files in it will be put in the binary package's control information area.
de: Legt ein Debian-Archiv aus dem Dateisystembaum, der in I<Verzeichnis> gespeichert ist, an. I<Verzeichnis> muss ein B<DEBIAN>-Unterverzeichnis aufweisen, das die Dateien mit Steuerinformation wie die control-Datei selbst enthält. Dieses Verzeichnis wird I<nicht> in dem Dateisystemarchiv des Binärpakets auftauchen, sondern die Dateien selbst werden in den Steuer-Informationsbereich des Binärpakets gepackt.

note: type: Plain text
en: Unless you specify B<--nocheck>, B<dpkg-deb> will read B<DEBIAN/control> and parse it. It will check it for syntax errors and other problems, and display the name of the binary package being built.  B<dpkg-deb> will also check the permissions of the maintainer scripts and other files found in the B<DEBIAN> control information directory.
de: Falls Sie nicht B<--nocheck> angeben, wird B<dpkg-deb> B<DEBIAN/control> lesen und es parsen. Es prüft sie auf Syntax-Fehler und andere Probleme und zeigt den Namen des zu bauenden Binärpakets an. B<dpkg-deb> wird auch die Rechte der Betreuer-Skripte und anderer Dateien im B<DEBIAN>-Steuer-Informationsverzeichnis prüfen.

note: type: Plain text
en: If no I<archive> is specified then B<dpkg-deb> will write the package into the file I<directory>B<.deb>.
de: Falls kein I<Archiv> angegeben ist, wird B<dpkg-deb> das Paket in die Datei I<Verzeichnis>B<.deb> schreiben.

note: type: Plain text
en: If the archive to be created already exists it will be overwritten.
de: Falls das anzulegende Archiv bereits existiert, wird es überschrieben.

note: type: Plain text
en: If the second argument is a directory then B<dpkg-deb> will write to the file I<package>B<_>I<version>B<_>I<arch>B<.deb>, or I<package>B<_>I<version>B<.deb> if no B<Architecture> field is present in the package control file. When a target directory is specified, rather than a file, the B<--nocheck> option may not be used (since B<dpkg-deb> needs to read and parse the package control file to determine which filename to use).
de: Falls das zweite Argument ein Verzeichnis ist, wird B<dpkg-deb> in die Datei I<Paket>B<_>I<Version>B<_>I<arch>B<.deb> oder I<Paket>B<_>I<Version>B<.deb>, falls kein B<Architecture>-Feld in der Paket-Steuerdatei vorhanden ist, schreiben. Wenn ein Zielverzeichnis statt einer Datei angegeben ist, darf die Option B<--nocheck> nicht verwendet werden (da B<dpkg-deb> die Paketsteuerdatei lesen und parsen muss, um den zu verwendenden Dateinamen zu bestimmen).

note: type: TP
en: B<-I>, B<--info> I<archive> [I<control-file-name>...]
de: B<-I>, B<--info> I<Archiv> [I<Steuer-Dateiname> …]

note: type: Plain text
en: Provides information about a binary package archive.
de: Stellt Informationen über ein Binärpaketarchiv bereit.

note: type: Plain text
en: If no I<control-file-name>s are specified then it will print a summary of the contents of the package as well as its control file.
de: Falls keine I<Steuer-Dateiname>n angegeben sind, wird es eine Zusammenfassung des Inhalts des Pakets sowie dessen Steuerdatei ausgeben.

note: type: Plain text
en: If any I<control-file-name>s are specified then B<dpkg-deb> will print them in the order they were specified; if any of the components weren't present it will print an error message to stderr about each one and exit with status 2.
de: Falls I<Steuer-Dateiname>n angegeben sind, wird B<dpkg-deb> diese in der angegebenen Reihenfolge ausgeben; falls einige der Komponenten nicht vorhanden sind, wird es eine Fehlernachricht nach Stderr über jede ausgeben und sich mit dem Status 2 beenden.

note: type: TP
en: B<-W>, B<--show> I<archive>
de: B<-W>, B<--show> I<Archiv>

note: type: Plain text
en: Provides information about a binary package archive in the format specified by the B<--showformat> argument. The default format displays the package's name and version on one line, separated by a tabulator.
de: Stellt Informationen über Binärpaketarchive im Format dar, das mit dem Argument B<--showformat> angegeben wurde. Das Standardformat zeigt den Paketnamen und die Paketversion in einer Zeile, getrennt durch einen Tabulator.

note: type: TP
en: B<-f>, B<--field> I<archive> [I<control-field-name>...]
de: B<-f>, B<--field> I<Archiv> [I<Steuer-Feldname> …]

note: type: Plain text
en: Extracts control file information from a binary package archive.
de: Extrahiert die Informationen der control-Datei aus einem Binärpaketarchiv.

note: type: Plain text
en: If no B<control-file-field>s are specified then it will print the whole control file.
de: Falls keine B<Steuerdatei-Feld>er angegeben sind, gibt es die gesamte control-Datei aus.

note: type: Plain text
en: If any are specified then B<dpkg-deb> will print their contents, in the order in which they appear in the control file. If more than one B<control-file-field> is specified then B<dpkg-deb> will precede each with its field name (and a colon and space).
de: Falls welche angegeben sind, gibt B<dpkg-deb> ihren Inhalt in der Reihenfolge aus, in der sie in der control-Datei angegeben sind. Falls mehr als ein B<Steuerdatei-Feld> angegeben ist, stellt B<dpkg-deb> jedem Inhalt seinen Feldnamen (und einen Doppelpunkt mit Leerzeichen) voran.

note: type: Plain text
en: No errors are reported for fields requested but not found.
de: Falls angeforderte Felder nicht gefunden werden wird kein Fehler gemeldet.

note: type: TP
en: B<-c>, B<--contents> I<archive>
de: B<-c>, B<--contents> I<Archiv>

note: type: Plain text
en: Lists the contents of the filesystem tree archive portion of the package archive. It is currently produced in the format generated by B<tar>'s verbose listing.
de: Listet den Inhalt des Dateisystem-Archivanteils des Paketarchivs auf. Die Ausgabe erfolgt derzeit in dem Format, das von B<tar> in der ausführlichen Auflistung erstellt wird.

note: type: TP
en: B<-x>, B<--extract> I<archive directory>
de: B<-x>, B<--extract> I<Archiv-Verzeichnis>

note: type: Plain text
en: Extracts the filesystem tree from a package archive into the specified directory.
de: Extrahiert den Dateisystembaum aus einem Paketarchiv in das angegebene Verzeichnis.

note: type: Plain text
en: Note that extracting a package to the root directory will I<not> result in a correct installation! Use B<dpkg> to install packages.
de: Beachten Sie, dass das Extrahieren eines Pakets in das Wurzelverzeichnis I<nicht> zu einer korrekten Installation führt! Verwenden Sie B<dpkg> zur Paketinstallation.

note: type: Plain text
en: I<directory> (but not its parents) will be created if necessary, and its permissions modified to match the contents of the package.
de: I<Verzeichnis> (aber nicht die übergeordneten) wird falls notwendig angelegt. Seine Rechte werden angepasst, um mit dem Inhalt des Pakets übereinzustimmen.

note: type: TP
en: B<-X>, B<--vextract> I<archive directory>
de: B<-X>, B<--vextract> I<Archiv-Verzeichnis>

note: type: Plain text
en: Is like B<--extract> (B<-x>)  with B<--verbose> (B<-v>)  which prints a listing of the files extracted as it goes.
de: Ist wie B<--extract> (B<-x>) mit B<--verbose> (B<-v>), das beim Arbeiten eine Liste von extrahierten Dateien ausgibt.

note: type: TP
en: B<-R>, B<--raw-extract> I<archive directory>
de: B<-R>, B<--raw-extract> I<Archiv-Verzeichnis>

note: type: Plain text
en: Extracts the filesystem tree from a package archive into a specified directory, and the control information files into a DEBIAN subdirectory of the specified directory.
de: Extrahiert den Dateisystembaum aus einem Paketarchiv in ein angegebenes Verzeichnis und die Steuerinformationensdateien in das DEBIAN-Unterverzeichnis des angegebenen Verzeichnisses.

note: type: Plain text
en: The target directory (but not its parents) will be created if necessary.
de: Das Zielverzeichnis (aber nicht übergeordnete) wird, falls notwendig, angelegt.

note: type: TP
en: B<--fsys-tarfile> I<archive>
de: B<--fsys-tarfile> I<Archiv>

note: type: Plain text
en: Extracts the filesystem tree data from a binary package and sends it to standard output in B<tar> format. Together with B<tar>(1)  this can be used to extract a particular file from a package archive.  The input archive will always be processed sequentially.
de: Extrahiert die Dateisystembaum-Daten aus einem Binärpaket und schickt sie zur Standardausgabe im B<tar>-Format. Dies kann zusammen mit B<tar>(1) verwendet werden, um eine bestimmte Datei aus einem Paketarchiv zu extrahieren. Das Eingabearchiv wird immer sequenziell verarbeitet.

note: type: TP
en: B<-e>, B<--control> I<archive> [I<directory>]
de: B<-e>, B<--control> I<Archiv> [I<Verzeichnis>]

note: type: Plain text
en: Extracts the control information files from a package archive into the specified directory.
de: Extrahiert die Steuer-Informationsdateien aus einem Paketarchiv in das angegebene Verzeichnis.

note: type: Plain text
en: If no directory is specified then a subdirectory B<DEBIAN> in the current directory is used.
de: Falls kein Verzeichnis angegeben ist, wird das Unterverzeichnis B<DEBIAN> im aktuellen Verzeichnis verwendet.

note: type: TP
en: B<--showformat=>I<format>
de: B<--showformat=>I<Format>

note: type: Plain text
en: This option is used to specify the format of the output B<--show> will produce. The format is a string that will be output for each package listed.
de: Diese Option wird dazu verwendet, das Format der Ausgabe anzugeben, das B<--show> verwenden wird. Das Format ist eine Zeichenkette, die für jedes aufgeführte Paket ausgegeben wird.

note: type: Plain text
en: The string may reference any status field using the "${I<field-name>}" form, a list of the valid fields can be easily produced using B<-I> on the same package. A complete explanation of the formatting options (including escape sequences and field tabbing) can be found in the explanation of the B<--showformat> option in B<dpkg-query>(1).
de: Die Zeichenkette darf jedes Statusfeld in der Form »${I<Feldname>}« referenzieren, eine Liste der möglichen Felder kann leicht mittels B<-I> für das gleiche Paket ermittelt werden. Eine komplette Erläuterung der Formatieroptionen (darunter die Escape-Sequenzen und Feld-Tabulatoren) kann in der Erklärung der Option B<--showformat> von B<dpkg-query>(1) gefunden werden.

note: type: Plain text
en: The default for this field is "${Package}\et${Version}\en".
de: Die Voreinstellung für dieses Feld ist "${Package}\et${Version}\en".

note: type: TP
en: B<-z>I<compress-level>
de: B<-z>I<Komprimierstufe>

note: type: Plain text
en: Specify which compression level to use on the compressor backend, when building a package (default is 9 for gzip and bzip2, 6 for xz and lzma).  The accepted values are 0-9 with: 0 being mapped to compressor none for gzip and 0 mapped to 1 for bzip2. Before dpkg 1.16.2 level 0 was equivalent to compressor none for all compressors.
de: Gibt die Komprimierstufe an, die im Komprimier-Backendprogramm beim Bau eines Pakets verwendet werden soll. Standardmäßig ist dies 9 für Gzip und Bzip2, 6 für Xz und Lzma. Die akzeptierten Werte innerhalb von 0-9 sind: 0 wird auf den Komprimierer »none« für Gzip einstellen und für Bzip2 ist 0 identisch zu 1. Vor Dpkg 1.16.2 war die Stufe 0 äquivalent zu den Komprimierer »none« für alle Komprimierer.

note: type: TP
en: B<-S>I<compress-strategy>
de: B<-S>I<Komprimierstrategie>

note: type: Plain text
en: Specify which compression strategy to use on the compressor backend, when building a package (since dpkg 1.16.2). Allowed values are I<none> (since dpkg 1.16.4) and I<extreme> for xz.
de: Gibt die zu verwendende Komprimierstrategie an, die für den Komprimierer-Backend beim Bau eines Pakets verwandt werden soll (seit Dpkg 1.16.2). Erlaubte Werte sind I<none> (seit Dpkg 1.16.4) und I<extreme> für Xz.

note: type: TP
en: B<-Z>I<compress-type>
de: B<-Z>I<Komprimierart>

note: type: Plain text
en: Specify which compression type to use when building a package. Allowed values are I<gzip>, I<xz>, I<bzip2>, I<lzma>, and I<none> (default is I<gzip>).
de: Gibt die Art der Komprimierung beim Bau eines Pakets an. Erlaubte Werte sind I<gzip>, I<xz>, I<bzip2>, I<lzma> und I<none> (voreingestellt ist I<gzip>).

note: type: Plain text
en: Ensures that B<dpkg-deb> builds a `new' format archive. This is the default.
de: Stellt sicher, dass B<dpkg-deb> ein Archiv im »neuen« Format baut. Dies ist die Voreinstellung.

note: type: Plain text
en: Forces B<dpkg-deb> to build an `old' format archive. This old archive format is less easily parsed by non-Debian tools and is now obsolete; its only use is when building packages to be parsed by versions of dpkg older than 0.93.76 (September 1995), which was released as i386 a.out only.
de: Zwingt B<dpkg-deb> dazu, ein Archiv im »alten« Format zu bauen. Dieses alte Format wird nicht so leicht von nicht-Debian-Werkzeugen eingelesen und ist jetzt veraltet; der einzige Zweck ist zum Bau von Paketen, die von Dpkg-Versionen kleiner 0.93.76 (September 1995) eingelesen werden sollen. Diese Dpkg-Version wurde nur als i386 a.out-Programm veröffentlicht.

note: type: Plain text
en: Inhibits B<dpkg-deb --build>'s usual checks on the proposed contents of an archive. You can build any archive you want, no matter how broken, this way.
de: Unterdrückt die normalen Überprüfungen von B<dpkg-deb --build> über die vorgeschlagenen Inhalte eines Archivs. Damit können Sie jedes Archiv bauen, das Sie möchten, egal wie defekt es ist.

note: type: Plain text
en: Enables verbose output. This currently only affects B<--extract> making it behave like B<--vextract>.
de: Aktiviert ausführliche Ausgabe. Dies betrifft derzeit nur B<--extract>, wodurch dieses sich wie B<--vextract> verhält.

note: type: Plain text
en: Enables debugging output. This is not very interesting.
de: Aktiviert Fehlersuch-Ausgaben (»debugging«). Dies ist nicht sehr interessant.

note: type: Plain text
en: If set, B<dpkg-deb> will use it as the directory in which to create temporary files and directories.
de: Falls gesetzt wird B<dpkg-deb> es als das Verzeichnis verwenden, in dem temporäre Dateien und Verzeichnisse erstellt werden.

note: type: Plain text
en: B<dpkg-deb -I> I<package1>B<.deb> I<package2>B<.deb> does the wrong thing.
de: B<dpkg-deb -I> I<Paket1>B<.deb> I<Paket2>B<.deb> macht das Falsche.

note: type: Plain text
en: There is no authentication on B<.deb> files; in fact, there isn't even a straightforward checksum.  (Higher level tools like APT support authenticating B<.deb> packages retrieved from a given repository, and most packages nowadays provide an md5sum control file generated by debian/rules. Though this is not directly supported by the lower level tools.)
de: B<.deb>-Dateien werden nicht authentifiziert; in der Tat gibt es noch nicht mal eine klare Prüfsumme. (Abstraktere Werkzeuge wie APT unterstützten die Authentifizierung von B<.deb>-Paketen, die von einem vorgegebenen Depot geholt wurden und die meisten Pakete stellen heutzutage eine md5sum-Steuerdatei bereit, die mittels debian/rules erstellt wurde. Allerdings wird dies von den Werkzeugen auf niedrigerer Ebene nicht direkt unterstützt.)

note: type: Plain text
en: Do not attempt to use just B<dpkg-deb> to install software! You must use B<dpkg> proper to ensure that all the files are correctly placed and the package's scripts run and its status and contents recorded.
de: Versuchen Sie nicht, nur mit B<dpkg-deb> Software zu installieren! Sie müssen B<dpkg> selber verwenden, um sicherzustellen, dass alle Dateien an den richtigen Ort platziert werden, die Paketskripte ausgeführt werden und sein Status und Inhalt aufgezeichnet wird.

note: type: Plain text
en: dpkg-divert - override a package's version of a file
de: dpkg-divert - Hinwegsetzen über die Paketversion einer Datei

note: type: Plain text
en: B<dpkg-divert> [I<option>...] I<command>
de: B<dpkg-divert> [I<Option> …] I<Befehl>

note: type: Plain text
en: B<dpkg-divert> is the utility used to set up and update the list of diversions.
de: B<dpkg-divert> ist ein Hilfswerkzeug, um die Liste der Umleitungen einzurichten und zu aktualisieren.

note: type: Plain text
en: File I<diversions> are a way of forcing B<dpkg>(1)  not to install a file into its location, but to a I<diverted> location. Diversions can be used through the Debian package scripts to move a file away when it causes a conflict. System administrators can also use it to override some package's configuration file, or whenever some files (which aren't marked as 'conffiles') need to be preserved by dpkg, when installing a newer version of a package which contains those files.
de: Datei-I<Diversionen> (Umleitungen) sind eine Möglichkeit, B<dpkg>(1) dazu zu zwingen, eine Datei nicht an ihren Standardplatz, sondern an einem I<umgeleiteten> Ort zu installieren. Umleitungen können innerhalb der Debian-Paketskripte verwendet werden, um eine Datei beiseitezuschieben, wenn sie einen Konflikt auslöst. Systemadministratoren können sie auch verwenden, um sich über die Konfigurationsdateien einiger Pakete hinwegzusetzen, oder wann immer einige Dateien (die nicht als »Conffiles« markiert sind) von Dpkg erhalten werden müssen, wenn eine neuere Version eines Paketes, die diese Dateien enthält, installiert wird.

note: type: TP
en: [B<--add>] I<file>
de: [B<--add>] I<Datei>

note: type: Plain text
en: Add a diversion for I<file>.
de: Fügt eine Umleitung für I<Datei> hinzu.

note: type: TP
en: B<--remove>I< file>
de: B<--remove>I< Datei>

note: type: Plain text
en: Remove a diversion for I<file>.
de: Entferne eine Umleitung für I<Datei>.

note: type: TP
en: B<--list>I< glob-pattern>
de: B<--list>I< Glob-Muster>

note: type: Plain text
en: List diversions matching I<glob-pattern>.
de: Liste Umleitungen auf, die auf I<Glob-Muster> passen.

note: type: TP
en: B<--listpackage>I< file>
de: B<--listpackage>I< Datei>

note: type: Plain text
en: Print the name of the package that diverts I<file>.  Prints LOCAL if I<file> is locally diverted and nothing if I<file> is not diverted.
de: Gibt den Namen des Pakets aus, die I<Datei> umleitet. Gibt LOCAL aus, falls die Datei lokal umgeleitet wurde und nichts, falls I<Datei> nicht umgeleitet wurde.

note: type: TP
en: B<--truename>I< file>
de: B<--truename>I< Datei>

note: type: Plain text
en: Print the real name for a diverted file.
de: Zeige den echten Namen für eine umgeleitete Datei an.

note: type: TP
en: B<--admindir>I< directory>
de: B<--admindir>I< Verzeichnis>

note: type: Plain text
en: Set the dpkg data directory to I<directory> (default: I</var/lib/dpkg>).
de: Setze das Dpkg-Datenverzeichnis auf I<Verzeichnis> (Standard: I</var/lib/dpkg>).

note: type: TP
en: B<--divert>I< divert-to>
de: B<--divert>I< Umleitziel>

note: type: Plain text
en: I<divert-to> is the location where the versions of I<file>, as provided by other packages, will be diverted.
de: I<Umleitziel> ist der Zielort, wo die Versionen der I<Datei>, wie sie von anderen Paketen bereitgestellt wird, hin umgeleitet werden.

note: type: Plain text
en: Specifies that all packages' versions of this file are diverted.  This means, that there are no exceptions, and whatever package is installed, the file is diverted. This can be used by an admin to install a locally modified version.
de: Gibt an, dass alle Versionen dieser Datei umgeleitet sind. Dies bedeutet, dass es keine Ausnahmen gibt, und egal was für ein Paket auch installiert ist, die Datei ist umgeleitet. Dies kann vom Administrator verwendet werden, um eine lokal geänderte Version zu installieren.

note: type: TP
en: B<--package>I< package>
de: B<--package>I< Paket>

note: type: Plain text
en: I<package> is the name of a package whose copy of I<file> will not be diverted. i.e. I<file> will be diverted for all packages except I<package>.
de: I<Paket> ist der Name des Pakets, dessen Kopie von I<Datei> nicht umgeleitet wird, d.h. I<Datei> wird für alle Pakete außer I<Paket> umgeleitet.

note: type: Plain text
en: Quiet mode, i.e. no verbose output.
de: Ruhiger Modus, d.h. keine langatmige Ausgabe.

note: type: Plain text
en: Actually move the file aside (or back). B<dpkg-divert> will abort operation in case the destination file already exists.
de: Schiebe die Dateien tatsächlich beiseite (oder zurück). B<dpkg-divert> wird den Arbeitsvorgang abbrechen, falls die Zieldatei bereits existiert.

note: type: Plain text
en: Test mode, i.e. don't actually perform any changes, just demonstrate.
de: Testmodus, d.h. führe keine Änderungen durch, sondern zeige sie lediglich.

note: type: SH
en: NOTES
de: BEMERKUNGEN

note: type: Plain text
en: When adding, default is B<--local> and B<--divert> I<original>B<.distrib>. When removing, B<--package> or B<--local> and B<--divert> must match if specified.
de: Beim Hinzufügen ist die Standardeinstellung B<--local> und B<--divert> I<Originalname>.B<distrib>. Beim Entfernen müssen, falls angegeben, B<--package> oder B<--local> und B<--divert> übereinstimmen.

note: type: Plain text
en: Directories can't be diverted with B<dpkg-divert>.
de: Verzeichnisse können mit B<dpkg-divert> nicht umgeleitet werden.

note: type: Plain text
en: Care should be taken when diverting shared libraries, B<ldconfig>(8)  creates a symbolic link based on the DT_SONAME field embedded in the library.  Because ldconfig doesn't honour diverts (only dpkg does), the symlink may end up pointing at the diverted library, if a diverted library has the same SONAME as the undiverted one.
de: Vorsicht sollte beim Umleiten von Laufzeit-Bibliotheken walten gelassen werden, da B<ldconfig>(8) einen symbolischen Link, basierend auf dem in der Bibliothek eingebetteten DT_SONAME-Feld, anlegt. Da ldconfig keine Umleitungen anerkennt (nur Dpkg tut dies), kann der Symlink am Ende auf die umgeleitete Bibliothek zeigen, falls die umgeleitete Bibliothek den gleichen SONAME wie die nicht umgeleitete hat.

note: type: Plain text
en: To divert all copies of a I</usr/bin/example> to I</usr/bin/example.foo>, i.e. directs all packages providing I</usr/bin/example> to install it as I</usr/bin/example.foo>, performing the rename if required:
de: Um alle Kopien von I</usr/bin/example> auf I</usr/bin/example.foo> umzuleiten, d.h. alle Pakete, die I</usr/bin/example> zur Verfügung stellen, dazu anzuleiten, diese Datei stattdessen als I</usr/bin/example.foo> zu installieren und die Umbenennung, falls notwendig, durchzuführen:

note: type: Plain text
en: To remove that diversion:
de: Um diese Umleitung zu entfernen:

note: type: Plain text
en: To divert any package trying to install I</usr/bin/example> to I</usr/bin/example.foo>, except your own I<wibble> package:
de: Um für jedes Paket - außer Ihrem eigenen I<wibble>-Paket -, das versucht, I</usr/bin/example> zu installieren, dieses auf I</usr/bin/example.foo> umzuleiten:

note: type: Plain text
en: If set and the B<--admindir> option has not been specified, it will be used as the dpkg data directory.
de: Falls gesetzt und die Option B<--admindir> nicht verwandt wurde, wird dies als Datenverzeichnis von Dpkg verwandt.

note: type: Plain text
en: If set and the B<--local> and B<--package> options have not been specified, B<dpkg-divert> will use it as the package name.
de: Falls gesetzt und die Optionen B<--local> und B<--package> nicht verwandt wurden, wird B<dpkg-divert> dies als Paketnamen verwenden.

note: type: Plain text
en: File which contains the current list of diversions of the system. It is located in the dpkg administration directory, along with other files important to dpkg, such as I<status> or I<available>.
de: Datei, die die aktuelle Liste von Umleitungen des Systems enthält. Sie befindet sich im Dpkg-Administrationsverzeichnis, zusammen mit anderen für Dpkg wichtigen Dateien, wie I<status> oder I<available>.

note: type: Plain text
en: Note: B<dpkg-divert> preserves the old copy of this file, with extension I<-old>, before replacing it with the new one.
de: Hinweis: B<dpkg-divert> erhält die alte Kopie dieser Datei, mit der Endung I<-old>, bevor es sie mit der neuen ersetzt.

note: type: Plain text
en: dpkg-genchanges - generate Debian .changes files
de: dpkg-genchanges - erstelle Debian .changes-Dateien

note: type: Plain text
en: B<dpkg-genchanges> [I<option>...]
de: B<dpkg-genchanges> [I<Option> …]

note: type: Plain text
en: B<dpkg-genchanges> reads information from an unpacked and built Debian source tree and from the files it has generated and generates a Debian upload control file (B<.changes> file).
de: B<dpkg-genchanges> liest Informationen aus einem entpackten und gebauten Debian-Quellcodebaum und aus den darin erzeugten Dateien und erzeugt eine Debian-Steuerdatei für das Hochladen (die B<.changes>-Datei).

note: type: Plain text
en: Specifies that a binary-only build is taking place (no source files are to be included). There's no distinction between B<-b>, B<-B> and B<-A>, the produced B<.changes> file will include whatever files were created by the B<binary-*> target(s) of the package being built.
de: Gibt an, das ein rein-binärer Bau stattfindet (keine Quelldateien sollen eingeschlossen werden). Es gibt zwischen B<-b>, B<-B> und B<-A> keinen Unterschied, die erstellte Datei B<.changes> beinhaltet alle Dateien, die von den B<binary-*>-Zielen der zu bauenden Pakete erstellt werden.

note: type: Plain text
en: Specifies that only the source should be uploaded (no binary packages will be included).
de: Gibt an, dass nur die Quellen hochgeladen werden sollen (keine Binärpakete werden enthalten sein).

note: type: Plain text
en: The B<-s>I<x> options control whether the original source archive is included in the upload if any source is being generated (i.e.  B<-b> or B<-B> haven't been used).
de: Die B<-s>I<x> Optionen steuern, ob das Original-Quellarchiv dem Upload hinzugefügt wird, falls die Quellen erzeugt werden (d.h. B<-b> oder B<-B> nicht verwendet wurden).

note: type: Plain text
en: By default, or if specified, the original source will be included only if the upstream version number (the version without epoch and without Debian revision) differs from the upstream version number of the previous changelog entry.
de: Standardmäßig, oder falls angegeben, werden die Originalquellen nur hinzugefügt, falls sich die Versionsnummer der Originalautoren (die Version ohne Epoche und ohne die Debian-Revision) von der Versionsnummer der Originalautoren in dem letzten Changlog-Eintrag unterscheidet.

note: type: Plain text
en: Forces the inclusion of the original source.
de: Erzwingt die Hinzunahme der Originalquellen.

note: type: Plain text
en: Forces the exclusion of the original source and includes only the diff.
de: Erzwingt den Ausschluss der Originalquellen und fügt nur den Diff hinzu.

note: type: Plain text
en: Causes changelog information from all versions strictly later than I<version> to be used.
de: Dies führt dazu, dass »changelog«-Informationen von allen Versionen, die strikt neuer als I<Version> sind, verwendet werden.

note: type: Plain text
en: Read the description of the changes from the file I<changes-description> rather than using the information from the source tree's changelog file.
de: Lese die Beschreibung der Änderungen aus der Datei I<Änderungsbeschreibung> anstatt die Informationen aus dem changelog-Datei des Quellbaums zu verwenden.

note: type: Plain text
en: Use I<maintainer-address> as the name and email address of the maintainer for this package, rather than using the information from the source tree's control file.
de: Verwende I<Betreueradresse> als Namen und E-Mail-Adresse des Betreuers dieses Paketes, anstatt die Informationen aus der »control«-Datei des Quellbaums zu verwenden.

note: type: Plain text
en: Use I<maintainer-address> as the name and email address of the maintainer for this upload, rather than using the information from the source tree's changelog.
de: Verwende I<Betreueradresse> als Namen und E-Mail-Adresse des Betreuers für diesen Upload, anstatt die Informationen aus dem »changelog« des Quellbaums zu verwenden.

note: type: TP
en: B<-V>I<name>B<=>I<value>
de: B<-V>I<Name>B<=>I<Wert>

note: type: Plain text
en: Set an output substitution variable.  See B<deb-substvars>(5) for a discussion of output substitution.
de: Setzt eine Ausgabesubstitutionsvariable. Lesen Sie B<deb-substvars>(5) für eine Besprechung des Ausgabesubstitution.

note: type: TP
en: B<-T>I<substvars-file>
de: B<-T>I<Substvars-Datei>

note: type: Plain text
en: Read substitution variables in I<substvars-file>; the default is B<debian/substvars>.  No variable substitution is done on any of the fields that are output, however the special variable I<Format> will override the field of the same name. This option can be used multiple times to read substitution variables from multiple files.
de: Lese die Substitutionsvariablen aus I<Substvars-Datei>; standardmäßig B<debian/substvars>. Bei den ausgegeben Feldern erfolgt keine Variablensubstitution, die besondere Variable I<Format> wird allerdings das Feld mit dem gleichen Namen überschreiben. Diese Option kann mehrfach verwandt werden, um Substitutionsvariablen aus mehreren Dateien einzulesen.

note: type: TP
en: B<-D>I<field>B<=>I<value>
de: B<-D>I<Feld>B<=>I<Wert>

note: type: Plain text
en: Override or add an output control file field.
de: Überschreibe oder ergänze ein Ausgabe-Steuerdatei-Feld.

note: type: Plain text
en: Remove an output control file field.
de: Entferne ein Ausgabe-Steuerdatei-Feld.

note: type: TP
en: B<-c>I<controlfile>
de: B<-c>I<Steuerdatei>

note: type: Plain text
en: Specifies the main source control file to read information from. The default is B<debian/control>.
de: Gibt die Haupt-Steuerdatei an, aus der Informationen gelesen werden sollen. Standardmäßig B<debian/control>.

note: type: TP
en: B<-l>I<changelog-file>
de: B<-l>I<Changelog-Datei>

note: type: Plain text
en: Specifies the changelog file to read information from. The default is B<debian/changelog>.
de: Gibt die Änderungsprotokolldatei an, aus der Informationen gelesen werden sollen. Standardmäßig B<debian/changelog>.

note: type: Plain text
en: Read the list of files to be uploaded here, rather than using B<debian/files>.
de: Lese die Liste der hochzuladenen Dateien von hier, statt B<debian/files> zu verwenden.

note: type: TP
en: B<-F>I<changelog-format>
de: B<-F>I<Changelog-Format>

note: type: Plain text
en: Specifies the format of the changelog. See B<dpkg-parsechangelog>(1)  for information about alternative formats.
de: Spezifiziert das Format des Changelogs. Lesen Sie B<dpkg-parsechangelog>(1) für Informationen über alternative Formate.

note: type: TP
en: B<-u>I<upload-files-dir>
de: B<-u>I<Hochladedateiverzeichnis>

note: type: Plain text
en: Look for the files to be uploaded in I<upload-files-dir> rather than B<..> (B<dpkg-genchanges> needs to find these files so that it can include their sizes and checksums in the B<.changes> file).
de: Suche nach Dateien, die hochgeladen werden sollen, in I<Hochladedateiverzeichnis> statt in B<..> (B<dpkg-genchanges> muss diese Dateien finden, so dass es ihre Größen und Prüfsummen in die B<.changes>-Datei aufnehmen kann.

note: type: Plain text
en: Usually B<dpkg-genchanges> will produce informative messages on standard error, for example about how many of the package's source files are being uploaded.  B<-q> suppresses these messages.
de: Normalerweise schreibt B<dpkg-genchanges> informative Meldungen auf die Standard-Fehlerausgabe, beispielsweise wie viele Quelldateien des Pakets hochgeladen werden. B<-q> unterdrückt diese Meldungen.

note: type: Plain text
en: The list of generated files which are part of the upload being prepared.  B<dpkg-genchanges> reads the data here when producing a B<.changes> file.
de: Die Liste der erstellten Dateien, die Teil der zum Hochladen vorbereiteten Dateien sind. B<dpkg-genchanges> liest hier die Daten, wenn es die Datei B<.changes> erstellt.

note: type: Plain text
en: dpkg-gencontrol - generate Debian control files
de: dpkg-gencontrol - erstelle Debian control-Dateien

note: type: Plain text
en: B<dpkg-gencontrol> [I<option>...]
de: B<dpkg-gencontrol> [I<Option> …]

note: type: Plain text
en: B<dpkg-gencontrol> reads information from an unpacked Debian source tree and generates a binary package control file (which defaults to debian/tmp/DEBIAN/control); during this process it will simplify the relation fields.
de: B<dpkg-gencontrol> liest Informationen aus einem entpackten Debian-Quellcodebaum und erzeugt eine binäre Paketsteuerdatei (standardmäßig debian/tmp/DEBIAN/control); dabei vereinfacht es die Felder mit Paketbeziehungen.

note: type: Plain text
en: Thus I<Pre-Depends>, I<Depends>, I<Recommends> and I<Suggests> are simplified in this order by removing dependencies which are known to be true according to the stronger dependencies already parsed. It will also remove any self-dependency (in fact it will remove any dependency which evaluates to true given the current version of the package as installed). Logically it keeps the intersection of multiple dependencies on the same package. The order of dependencies is preserved as best as possible: if any dependency must be discarded due to another dependency appearing further in the field, the superseding dependency will take the place of the discarded one.
de: Daher werden I<Pre-Depends>, I<Depends>, I<Recommends> und I<Suggests> in dieser Reihenfolge vereinfacht, indem Abhängigkeiten, die aufgrund der jeweils ermittelten stärkeren Abhängigkeit bereits erfüllt sind, entfernt werden. Es wird auch alle Selbstabhängigkeiten entfernen (tatsächlich werden alle Abhängigkeiten entfernt, die aufgrund der installierten Version des aktuellen Pakets automatisch erfüllt werden). Logisch betrachtet behält es den Durchschnitt von mehrfachen Abhängigkeiten auf das gleiche Paket. Die Reihenfolge der Abhängigkeiten wird so gut wie möglich beibehalten: falls eine Abhängigkeit aufgrund einer weiter hinten im Feld auftauchenden weiteren Abhängigkeit gestrichen werden muss, so übernimmt die letztere Abhängigkeit den Platz der gestrichenen.

note: type: Plain text
en: The other relation fields (I<Enhances>, I<Conflicts>, I<Breaks>, I<Replaces> and I<Provides>)  are also simplified individually by computing the union of the various dependencies when a package is listed multiple times in the field.
de: Die anderen Paketbeziehungsfelder (I<Enhances>, I<Conflicts>, I<Breaks>, I<Replaces> und I<Provides>) werden auch individuell vereinfacht, indem die Vereinigung der verschiedenen Abhängigkeiten berechnet wird, wenn ein Paket mehrfach in dem Feld aufgeführt ist.

note: type: Plain text
en: B<dpkg-gencontrol> also adds an entry for the binary package to B<debian/files>.
de: B<dpkg-gencontrol> fügt auch einen Eintrag für das Binärpaket in B<debian/files> hinzu.

note: type: Plain text
en: Sets the version number of the binary package which will be generated.
de: Setzt die Versionsnummer des zu erstellenden Binärpaketes.

note: type: Plain text
en: Set an output substitution variable. See B<deb-substvars>(5) for discussion of output substitution.
de: Setzt eine Ausgabesubstitutionsvariable. Lesen Sie B<deb-substvars>(5) für eine Besprechung der Ausgabesubstitution.

note: type: Plain text
en: Read substitution variables in I<substvars-file>; the default is B<debian/substvars>.  This option can be used multiple times to read substitution variables from multiple files.
de: Lese die Substitutionsvariablen aus I<Substvars-Datei>; standardmäßig B<debian/substvars>. Diese Option kann mehrfach verwandt werden, um Substitutionsvariablen aus mehreren Dateien einzulesen.

note: type: TP
en: B<-c>I<control-file>
de: B<-c>I<Steuerdatei>

note: type: TP
en: B<-p>I<package>
de: B<-p>I<Paket>

note: type: Plain text
en: Generate information for the binary package I<package>.  If the source control file lists only one binary package then this option may be omitted; otherwise it is essential to select which binary package's information to generate.
de: Erstellt Informationen für das Binärpaket I<Paket>. Falls die Steuerdatei der Quellen nur ein Binärpakete aufführt, kann diese Option weggelassen werden; andernfalls ist sie notwendig, um festzulegen, von welchen Binärpaketen die Informationen erstellt werden sollen.

note: type: TP
en: B<-n>I<filename>
de: B<-n>I<Dateiname>

note: type: Plain text
en: Assume the filename of the package will be I<filename> instead of the normal package_version_arch.deb filename.
de: Gehe davon aus, das der Dateiname des Pakets I<Dateiname> sein wird, statt des normalen Dateinamens Paket_Version_Architektur.deb.

note: type: Plain text
en: These options are ignored for compatibility with older versions of dpkg-dev but are now deprecated. Previously they were used to tell dpkg-gencontrol to include the Section and Priority fields in the control file. This is now the default behaviour. If you want to get the old behaviour you can use the B<-U> option to delete the fields from the control file.
de: Diese Optionen werden aufgrund der Kompatibilität mit älteren Versionen von dpkg-dev ignoriert, sind aber jetzt veraltet. Bisher wurden sie verwendet, um dpkg-gencontrol mitzuteilen, die Felder »Section« und »Priority« in die Steuerdatei mit aufzunehmen. Dies passiert jetzt standardmäßig. Falls Sie das alte Verhalten erreichen möchten, können Sie die Option B<-U> verwenden, um Felder aus der Steuerdatei zu entfernen.

note: type: TP
en: B<-P>I<package-build-dir>
de: B<-P>I<Paketbauverzeichnis>

note: type: Plain text
en: Tells B<dpkg-source> that the package is being built in I<package-build-dir> instead of B<debian/tmp>.  This value is used to find the default value of the B<Installed-Size> substitution variable and control file field (using B<du>), and for the default location of the output file.
de: Teilt B<dpkg-source> mit, dass das Paket in I<Paketbauverzeichnis> statt in B<debian/tmp> gebaut wird. Dieser Wert wird dazu verwendet, den Standardwert der Substitutionsvariablen B<Installed-Size> und des Feldes der Steuerdatei (mittels B<du>) zu finden, und für den Standard-Ablageplatz der Ausgabedatei.

note: type: Plain text
en: Print the control file to standard output, rather than to B<debian/tmp/DEBIAN/control> (or I<package-build-dir>B</DEBIAN/control> if B<-P> was used).
de: Gebe die Steuerdatei in die Standardausgabe statt nach B<debian/tmp/DEBIAN/control> (oder I<Paketbauverzeichnis>B</DEBIAN/control> falls B<-P> verwendet worden ist) aus.

note: type: Plain text
en: The main source control information file, giving version-independent information about the source package and the binary packages it can produce.
de: Die Haupt-Steuer-Informationsdatei für die Quellen. Sie gibt versionsunabhängige Informationen über das Quellpaket und die Binärpakete, die sie erstellen kann, an.

note: type: Plain text
en: The list of generated files which are part of the upload being prepared.  B<dpkg-gencontrol> adds the presumed filenames of binary packages whose control files it generates here.
de: Die Liste der erstellten Dateien, die Teil des Uploads sind, der vorbereitet wird. B<dpkg-gencontrol> fügt die vermuteten Dateinamen von Binärpaketen hinzu, deren Steuerdateien es hier generiert.

note: type: Plain text
en: dpkg-gensymbols - generate symbols files (shared library dependency information)
de: dpkg-gensymbols - erstelle Symboldateien (Abhängigkeitsinformationen für Laufzeitbibliotheken)

note: type: Plain text
en: B<dpkg-gensymbols> [I<option>...]
de: B<dpkg-gensymbols> [I<Option> …]

note: type: Plain text
en: B<dpkg-gensymbols> scans a temporary build tree (debian/tmp by default) looking for libraries and generates a I<symbols> file describing them. This file, if non-empty, is then installed in the DEBIAN subdirectory of the build tree so that it ends up included in the control information of the package.
de: B<dpkg-gensymbols> durchsucht einen temporären Baubaum (standardmäßig debian/tmp), sucht nach Bibliotheken und erstellt eine Datei I<symbols>, die diese beschreibt. Diese Datei wird, falls sie nicht leer ist, in das Unterverzeichnis DEBIAN des Baubaums installiert, so dass sie schlussendlich in der Steuerinformation des Pakets auftaucht.

note: type: Plain text
en: When generating those files, it uses as input some symbols files provided by the maintainer. It looks for the following files (and uses the first that is found):
de: Beim Erstellen dieser Dateien verwendet es als Eingabe einige vom Betreuer bereitgestellte Symboldateien. Es sucht nach den folgenden Dateien (und verwendet die erste, die gefunden wird):

note: type: Plain text
en: debian/I<package>.symbols.I<arch>
de: debian/I<Paket>.symbols.I<Architektur>

note: type: Plain text
en: debian/symbols.I<arch>
de: debian/symbols.I<Architektur>

note: type: Plain text
en: debian/I<package>.symbols
de: debian/I<Paket>.symbols

note: type: Plain text
en: The main interest of those files is to provide the minimal version associated to each symbol provided by the libraries. Usually it corresponds to the first version of that package that provided the symbol, but it can be manually incremented by the maintainer if the ABI of the symbol is extended without breaking backwards compatibility. It's the responsibility of the maintainer to keep those files up-to-date and accurate, but B<dpkg-gensymbols> helps him.
de: Der Hauptzweck dieser Dateien besteht darin, die minimale Version bereitzustellen, die mit jedem von der Bibliothek bereitgestellten Symbol verknüpft ist. Normalerweise entspricht dies der ersten Version des Pakets, die dieses Symbol bereitgestellt hat, kann aber vom Betreuer erhöht werden, falls die ABI des Symbols ohne Brechen der Rückwärtskompatibilität erweitert wurde. Es liegt in der Verwantwortung des Betreuers, diese Dateien aktuell zu halten, aber B<dpkg-gensymbols> hilft ihm.

note: type: Plain text
en: When the generated symbols files differ from the maintainer supplied one, B<dpkg-gensymbols> will print a diff between the two versions.  Furthermore if the difference is too significant, it will even fail (you can customize how much difference you can tolerate, see the B<-c> option).
de: Wenn die erstellten Symboldateien sich von denen, die der Betreuer bereitgestellt hat, unterscheiden, wird B<dpkg-gensymbols> ein Diff zwischen den zwei Versionen anzeigen. Falls die Unterschiede desweiteren zu gravierend sind, wird es sogar fehlschlagen (Sie können einstellen, wie große Unterschiede Sie tolerieren können, sehen Sie hierzu die Option B<-c>).

note: type: SH
en: MAINTAINING SYMBOLS FILES
de: SYMBOLDATEIEN PFLEGEN

note: type: Plain text
en: The symbols files are really useful only if they reflect the evolution of the package through several releases. Thus the maintainer has to update them every time that a new symbol is added so that its associated minimal version matches reality. To do this properly he can use the diffs contained in the build logs. In most cases, the diff applies directly to his debian/I<package>.symbols file. That said, further tweaks are usually needed: it's recommended for example to drop the Debian revision from the minimal version so that backports with a lower version number but the same upstream version still satisfy the generated dependencies.  If the Debian revision can't be dropped because the symbol really got added by the Debian specific change, then one should suffix the version with "~".
de: Die Symboldateien sind nur wirklich nützlich, falls sie die Entwicklung eines Paketes über mehrere Veröffentlichungen hinweg wiedergeben. Daher muss der Betreuer sie immer aktualisieren, wenn eine neues Symbol hinzugefügt wird, so dass die zugeordnete minimale Version der Realität entspricht. Um dies vernünftig durchzuführen, kann er Diffs aus den Bauprotokolle verwenden. Meistens kann der Diff direkt auf die Datei debian/I<Paket>.symbols angewandt werden. Allerdings werden normalerweise weitere Anpassungen notwendig: es wird beispielsweise empfohlen, die Debian-Revision von der minimalen Version zu entfernen, so dass Backports mit einer niedrigeren Versionsnummer aber der gleichen Version der Originalautoren immer noch die erstellten Abhängigkeiten erfüllen. Falls die Debian-Revision nicht entfernt werden kann, da das Symbol wirklich von der Debian-spezifischen Änderung hinzugefügt wurde, dann sollte der Version »~« angehängt werden.

note: type: Plain text
en: Before applying any patch to the symbols file, the maintainer should double-check that it's sane. Public symbols are not supposed to disappear, so the patch should ideally only add new lines.
de: Bevor irgendein Patch auf die Symboldatei angewendet wird, sollte der Betreuer zweimal prüfen, dass der Patch vernünftig ist. Öffentliche Symbole sollten nicht verschwinden, daher sollte der Patch idealerweise nur neue Zeilen hinzufügen.

note: type: Plain text
en: Note that you can put comments in symbols files: any line with '#' as the first character is a comment except if it starts with '#include' (see section B<Using includes>). Lines starting with '#MISSING:' are special comments documenting symbols that have disappeared.
de: Beachten Sie, dass Sie in Symboldateien Kommentare einfügen können: jede Zeile, die mit »#« als ersten Zeichen beginnt, ist ein Kommentare, falls sie nicht mit »#include« beginnt (siehe Abschnitt B<Includes verwenden>). Zeilen, die mit »#MISSING:« anfangen, sind besondere Kommentare, die verschwundene Symbole dokumentieren.

note: type: SS
en: Using #PACKAGE# substitution
de: Verwendung der #PACKAGE#-Ersetzung

note: type: Plain text
en: In some rare cases, the name of the library varies between architectures.  To avoid hardcoding the name of the package in the symbols file, you can use the marker I<#PACKAGE#>. It will be replaced by the real package name during installation of the symbols files. Contrary to the I<#MINVER#> marker, I<#PACKAGE#> will never appear in a symbols file inside a binary package.
de: In einigen seltenen Fällen unterscheidet sich der Name der Bibliothek auf verschiedenen Architekturen. Um zu vermeiden, dass der Paketname in der Symboldatei fest kodiert wird, können Sie die Markierung I<#PACKAGE#> verwenden. Während der Installation der Symboldatei wird sie durch den echten Paketnamen ersetzt. Anders als die Markierung I<#MINVER#> wird I<#PACKAGE#> nie in der Symboldatei innerhalb eines Binärpakets auftauchen.

note: type: SS
en: Using symbol tags
de: Verwendung von Symbolkennzeichnungen

note: type: Plain text
en: Symbol tagging is useful for marking symbols that are special in some way.  Any symbol can have an arbitrary number of tags associated with it. While all tags are parsed and stored, only a some of them are understood by B<dpkg-gensymbols> and trigger special handling of the symbols. See subsection B<Standard symbol tags> for reference of these tags.
de: Symbolkennzeichnungen sind nützlich, um Symbole zu markieren, die in irgendeiner Weise besonders sind. Jedes Symbol kann eine beliebige Anzahl zugeordneter Kennzeichnungen besitzen. Während alle Kennzeichnungen ausgewertet und gespeichert werden, werden nur einige von B<dpkg-gensymbols> verstanden und lösen eine Spezialbehandlung der Symbole aus. Lesen Sie den Unterabschnit B<Standardsymbolkennzeichnungen> für eine Referenz dieser Kennzeichnungen.

note: type: Plain text
en: Tag specification comes right before the symbol name (no whitespace is allowed in between). It always starts with an opening bracket B<(>, ends with a closing bracket B<)> and must contain at least one tag. Multiple tags are separated by the B<|> character. Each tag can optionally have a value which is separated form the tag name by the B<=> character. Tag names and values can be arbitrary strings except they cannot contain any of the special B<)> B<|> B<=> characters. Symbol names following a tag specification can optionally be quoted with either B<'> or B<"> characters to allow whitespaces in them. However, if there are no tags specified for the symbol, quotes are treated as part of the symbol name which continues up until the first space.
de: Kennzeichnungsspezifikationen kommen direkt vor dem Symbolnamen (dazwischen sind keine Leerzeichen erlaubt). Sie beginnen immer mit einer öffnenden Klammer B<(>, enden mit einer schließenden Klammer B<)> und müssen mindestens eine Kennzeichnung enthalten. Mehrere Kennzeichnungen werden durch das Zeichen B<|> getrennt. Jede Kennzeichnungen kann optional einen Wert enthalten, der von der Kennzeichnung durch das Zeichen B<=> getrennt wird. Kennzeichennamen und -werte können beliebige Zeichenketten sein, sie dürfen allerdings keine der der besonderen Zeichen B<)> B<|> B<=> enthalten. Symbolnamen, die einer Kennzeichnungsspezifikation folgen, können optional mit den Zeichen B<'> oder B<"> zitiert werden, um Leerzeichen darin zu erlauben. Falls keine Kennzeichnungen für das Symbol spezifiziert sind, werden Zitatzeichen als Teil des Symbolnamens behandelt, der bis zum ersten Leerzeichen geht.

note: type: Plain text
en:  (tag1=i am marked|tag name with space)"tagged quoted symbol"@Base 1.0
     (optional)tagged_unquoted_symbol@Base 1.0 1
     untagged_symbol@Base 1.0
de:  (Kennz1=bin markiert|Name mit Leerraum)"zitiertes gekennz Symbol"@Base 1.0
     (optional)gekennzeichnet_unzitiertes_Symbol@Base 1.0 1
     ungekennzeichnetes_Symbol@Base 1.0

note: type: Plain text
en: The first symbol in the example is named I<tagged quoted symbol> and has two tags: I<tag1> with value I<i am marked> and I<tag name with space> that has no value. The second symbol named I<tagged_unquoted_symbol> is only tagged with the tag named I<optional>. The last symbol is an example of the normal untagged symbol.
de: Das erste Symbol im Beispiel heißt I<zitiertes gekennz Symbol> und hat zwei Kennzeichnungen: I<Kennz1> mit dem Wert I<bin markiert> und I<Name mit Leerraum> ohne Wert. Das zweite Symbol heißt I<gekennzeichnet_unzitiertes_Symbol> und ist nur mit dem Kennzeichen namens I<optional> gekennzeichnet. Das letzte Symbol ist ein Beispiel eines normalen, nicht gekennzeichneten Symbols.

note: type: Plain text
en: Since symbol tags are an extension of the I<deb-symbols(5)> format, they can only be part of the symbols files used in source packages (those files should then be seen as templates used to build the symbols files that are embedded in binary packages). When B<dpkg-gensymbols> is called without the I<-t> option, it will output symbols files compatible to the I<deb-symbols(5)> format: it fully processes symbols according to the requirements of their standard tags and strips all tags from the output. On the contrary, in template mode (I<-t>) all symbols and their tags (both standard and unknown ones)  are kept in the output and are written in their original form as they were loaded.
de: Da Symbolkennzeichnungen eine Erweiterung des Formats I<deb-symbols(5)> sind, können sie nur Teil der in Quellpaketen verwandten Symboldateien sein (diese Dateien sollten dann als Vorlagen zum Bau der Symboldateien, die in Binärpakete eingebettet werden, gesehen werden). Wenn B<dpkg-gensymbols> ohne die Option I<-t> aufgerufen wird, wird es alle Symbole ausgeben, die zum Format I<deb-symbols(5)> kompatibel sind: Es verarbeitet die Symbole entsprechend der Anforderungen ihrer Standardkennzeichnungen und entfernt alle Kennzeichnungen aus der Ausgabe. Im Gegensatz dazu werden alle Symbole und ihre Kennzeichnungen (sowohl die Standardkennzeichnungen als auch die unbekannten) im Vorlagenmodus (I<-t>) in der Ausgabe beibehalten und in ihrer Originalform wie sie geladen wurden auch geschrieben.

note: type: SS
en: Standard symbol tags
de: Standard-Symbolkennzeichnungen

note: type: Plain text
en: A symbol marked as optional can disappear from the library at any time and that will never cause B<dpkg-gensymbols> to fail. However, disappeared optional symbols will continuously appear as MISSING in the diff in each new package revision.  This behaviour serves as a reminder for the maintainer that such a symbol needs to be removed from the symbol file or readded to the library. When the optional symbol, which was previously declared as MISSING, suddenly reappears in the next revision, it will be upgraded back to the "existing" status with its minimum version unchanged.
de: Ein als »optional« gekennzeichnetes Symbol kann jederzeit von der Bibliothek verschwinden und wird nie zum Fehlschlag von B<dpkg-gensymbols> führen. Verschwundene optionale Symbole werden kontinuierlich als MISSING (Fehlend) in dem Diff in jeder neuen Paketversion auftauchen. Dieses Verhalten dient als Erinnerung für den Betreuer, dass so ein Symbol aus der Symboldatei entfernt oder wieder der Bibliothek hinzugefügt werden muss. Wenn das optionale Symbol, dass bisher als MISSING bezeichnet gewesen war, plötzlich in der nächsten Version wieder auftaucht, wird es wieder auf den Status »existing« (existierend) gebracht, wobei die minimale Version unverändert bleibt.

note: type: Plain text
en: This tag is useful for symbols which are private where their disappearance do not cause ABI breakage. For example, most of C++ template instantiations fall into this category. Like any other tag, this one may also have an arbitrary value: it could be used to indicate why the symbol is considered optional.
de: Diese Markierung ist für private Symbole nützlich, deren Verschwinden keinen ABI-Bruch auslöst. Beispielsweise fallen die meisten C++-Template-Instanziierungen in diese Kategorie. Wie jede andere Markierung kann auch diese einen beliebigen Wert haben: sie könnte angeben, warum dieses Symbol als optional betrachtet wird.

note: type: TP
en: B<arch=>I<architecture list>
de: B<arch=>I<Architekturliste>

note: type: Plain text
en: This tag allows one to restrict the set of architectures where the symbol is supposed to exist. When the symbols list is updated with the symbols discovered in the library, all arch-specific symbols which do not concern the current host architecture are treated as if they did not exist. If an arch-specific symbol matching the current host architecture does not exist in the library, normal procedures for missing symbols apply and it may cause B<dpkg-gensymbols> to fail. On the other hand, if the arch-specific symbol is found when it was not supposed to exist (because the current host architecture is not listed in the tag), it is made arch neutral (i.e. the arch tag is dropped and the symbol will appear in the diff due to this change), but it is not considered as new.
de: Die Markierung erlaubt es, den Satz an Architekturen einzugrenzen, auf denen das Symbol existieren sollte. Wenn die Symbolliste mit den in der Bibliothek entdeckten Symbolen aktualisiert wird, werden alle architekturspezifischen Symbole, die nicht auf die aktuelle Host-Architektur passen, so behandelt, als ob sie nicht existierten. Falls ein architekturspezifisches Symbol, das auf die aktuelle Host-Architektur passt, in der Bibliothek nicht existiert, werden die normalen Regeln für fehlende Symbole angewandt und B<dpkg-gensymbols> könnte dadurch fehlschlagen. Auf der anderen Seite, falls das architekturspezifische Symbol gefunden wurde, wenn es nicht existieren sollte (da die aktuelle Host-Architektur nicht in der Markierung aufgeführt ist), wird sie architekturneutral gemacht (d.h. die Architekturmarkierung wird entfernt und das Symbol wird im Diff aufgrund dieser Änderung auftauchen), aber es wird nicht als neu betrachtet.

note: type: Plain text
en: When operating in the default non-template mode, among arch-specific symbols only those that match the current host architecture are written to the symbols file. On the contrary, all arch-specific symbols (including those from foreign arches) are always written to the symbol file when operating in template mode.
de: Beim Betrieb im standardmäßigen nicht-Vorlagen-Modus werden unter den architekturspezifischen Symbolen nur die in die Symboldatei geschrieben, die auf die aktuelle Host-Architektur passen. Auf der anderen Seite werden beim Betrieb im Vorlagenmodus alle architekturspezifischen Symbole (darunter auch die von fremden Architekturen) immer in die Symboldatei geschrieben.

note: type: Plain text
en: The format of I<architecture list> is the same as the one used in the I<Build-Depends> field of I<debian/control> (except the enclosing square brackets []). For example, the first symbol from the list below will be considered only on alpha, any-amd64 and ia64 architectures, the second only on linux architectures, while the third one anywhere except on armel.
de: Das Format der I<Architekturliste> ist das gleiche wie das des Feldes I<Build-Depends> in I<debian/control> (außer den einschließenden eckigen Klammern []). Beispielsweise wird das erste Symbol aus der folgenden Liste nur auf den Architekturen Alpha, Any-amd64 und Ia64 betrachtet, das zweite nur Linux-Architekturen, während das dritte überall außer auf Armel betrachtet wird.

note: type: Plain text
en: dpkg-gensymbols has an internal blacklist of symbols that should not appear in symbols files as they are usually only side-effects of implementation details of the toolchain. If for some reason, you really want one of those symbols to be included in the symbols file, you should tag the symbol with B<ignore-blacklist>. It can be necessary for some low level toolchain libraries like libgcc.
de: dpkg-gensymbols verfügt über eine interne Ausschußliste (»blacklist«) von Symbolen, die nicht in Symboldateien auftauchen sollten, da sie normalerweise nur Seiteneffekte von Implementierungsdetails in der Werkzeugkette darstellen. Falls Sie aus irgendeinem Grund wollen, dass diese Symbole in der Symboldatei aufgenommen werden, sollten Sie das Symbol mit B<ignore-blacklist> kennzeichnen. Dies kann für einige grundlegende Bibliotheken der Werkzeugkette wie libgcc notwendig sein.

note: type: Plain text
en: Denotes I<c++> symbol pattern. See B<Using symbol patterns> subsection below.
de: Gibt I<c++>-Symbolmuster an. Lesen Sie den Unterabschnitt B<Verwendung von Symbolmuster> unten.

note: type: Plain text
en: Denotes I<symver> (symbol version) symbol pattern. See B<Using symbol patterns> subsection below.
de: Gibt I<symver> (Symbolversion)-Symbolmuster an. Lesen Sie den Unterabschnitt B<Verwendung von Symbolmuster> unten.

note: type: Plain text
en: Denotes I<regex> symbol pattern. See B<Using symbol patterns> subsection below.
de: Gibt I<regex>-Symbolmuster an. Lesen Sie den Unterabschnitt B<Verwendung von Symbolmuster> unten.

note: type: SS
en: Using symbol patterns
de: Verwendung von Symbolmustern

note: type: Plain text
en: Unlike a standard symbol specification, a pattern may cover multiple real symbols from the library. B<dpkg-gensymbols> will attempt to match each pattern against each real symbol that does I<not> have a specific symbol counterpart defined in the symbol file. Whenever the first matching pattern is found, all its tags and properties will be used as a basis specification of the symbol. If none of the patterns matches, the symbol will be considered as new.
de: Anders als die Standardsymbolspezifikation kann ein Muster mehrere reale Symbole aus der Bibliothek abdecken. B<dpkg-gensymbols> wird versuchen, jedes Muster auf jedes reale Symbol, für das I<kein> spezifisches Symbolgegenstück in der Symboldatei definiert ist, zu passen. Wann immer das erste passende Muster gefunden wurde, werden alle Kennzeichnungen und Eigenschaften als Basisspezifikation des Symbols verwandt. Falls keines der Muster passt, wird das Symbol als neu betrachtet.

note: type: Plain text
en: A pattern is considered lost if it does not match any symbol in the library. By default this will trigger a B<dpkg-gensymbols> failure under I<-c1> or higher level. However, if the failure is undesired, the pattern may be marked with the I<optional> tag. Then if the pattern does not match anything, it will only appear in the diff as MISSING. Moreover, like any symbol, the pattern may be limited to the specific architectures with the I<arch> tag. Please refer to B<Standard symbol tags> subsection above for more information.
de: Ein Muster wird als verloren betrachtet, falls es auf kein Symbol in der Bibliothek passt. Standardmäßig wird dies ein Versagen von B<dpkg-gensymbols> in der Stufe I<-c1> oder höher auslösen. Falls der Fehlschlag allerdings unerwünscht ist, kann das Muster mit der Kennzeichnung I<optional> markiert werden. Falls das Muster dann auf nichts passt wird es im Diff nur als MISSING (fehlend) auftauchen. Desweiteren kann das Muster wie jedes Symbol auf die spezielle Architektur mit der Kennzeichnung I<arch> beschränkt werden. Bitte lesen Sie den Unterabschnitt B<Standard Symbolkennzeichnungen> oben für weitere Informationen.

note: type: Plain text
en: Patterns are an extension of the I<deb-symbols(5)> format hence they are only valid in symbol file templates. Pattern specification syntax is not any different from the one of a specific symbol. However, symbol name part of the specification serves as an expression to be matched against I<name@version> of the real symbol. In order to distinguish among different pattern types, a pattern will typically be tagged with a special tag.
de: Muster sind eine Erweiterung des Formats I<deb-symbols(5)>; sie sind daher nur in Symboldatei-Vorlagen gültig. Die Musterspezifikationssyntax unterscheidet sich nicht von der eines spezifischen Symbols. Allerdings dient der Symbolnamenteil der Spezifikation als Ausdruck, der gegen I<Name@Version> eines realen Symbols gepasst wird. Um zwischen den verschiedenen Mustertypen zu unterscheiden, wird es typischerweise mit einer speziellen Kennzeichnung gekennzeichnet.

note: type: Plain text
en: At the moment, B<dpkg-gensymbols> supports three basic pattern types:
de: Derzeit unterstützt B<dpkg-gensymbols> drei grundlegene Mustertypen:

note: type: Plain text
en: This pattern is denoted by the I<c++> tag. It matches only C++ symbols by their demangled symbol name (as emitted by B<c++filt>(1) utility). This pattern is very handy for matching symbols which mangled names might vary across different architectures while their demangled names remain the same. One group of such symbols is I<non-virtual thunks> which have architecture specific offsets embedded in their mangled names. A common instance of this case is a virtual destructor which under diamond inheritance needs a non-virtual thunk symbol. For example, even if _ZThn8_N3NSB6ClassDD1Ev@Base on 32bit architectures will probably be _ZThn16_N3NSB6ClassDD1Ev@Base on 64bit ones, it can be matched with a single I<c++> pattern:
de: Dieses Muster wird durch die Kennzeichnung I<c++> verzeichnet. Es passt nur auf die entworrenen (»demangled«) Symbolnamen (wie sie vom Hilfswerkzeug B<c++filt>(1) ausgegeben werden). Dieses Muster ist sehr hilfreich um auf Symbole zu passen, bei dem die verworrenen (»mangled«) Namen sich auf verschiedenen Architekturen unterscheiden während die entworrenen die gleichen bleiben. Eine Gruppe solcher Symbole ist I<non-virtual thunks>, die einen architekturspezifischen Versatz in ihren verworrenen Namen eingebettet haben. Eine häufige Instanz dieses Falles ist ein virtueller Destruktur, der unter rautenförmiger Vererbung ein nicht-virtuelles Thunk-Symbol benötigt. Selbst wenn beispielsweise _ZThn8_N3NSB6ClassDD1Ev@Base auf 32 Bit-Architekturen _ZThn16_N3NSB6ClassDD1Ev@Base auf 64 Bit-Architekturen ist, kann es mit einem einzigen I<c++>-Muster gepasst werden:

note: type: Plain text
en: libdummy.so.1 libdummy1 #MINVER#
     [...]
     (c++)"non-virtual thunk to NSB::ClassD::~ClassD()@Base" 1.0
     [...]
de: libdummy.so.1 libdummy1 #MINVER#
     […]
     (c++)"non-virtual thunk to NSB::ClassD::~ClassD()@Base" 1.0
     […]

note: type: Plain text
en: The demangled name above can be obtained by executing the following command:
de: Der entworrene Name oben kann durch Ausführung folgenden Befehls erhalten werden:

note: type: Plain text
en: Please note that while mangled name is unique in the library by definition, this is not necessarily true for demangled names. A couple of distinct real symbols may have the same demangled name. For example, that's the case with non-virtual thunk symbols in complex inheritance configurations or with most constructors and destructors (since g++ typically generates two real symbols for them). However, as these collisions happen on the ABI level, they should not degrade quality of the symbol file.
de: Bitte beachten Sie, dass per Definition zwar der verworrene Name in der Bibliothek eindeutig ist, die aber nicht notwendigerweise für die entworrenen Namen zutrifft. Ein Satz von unterschiedlichen realen Symbolen können den gleichen entworrenen Namen haben. Beispielsweise ist das der Fall bei nicht-virtuellen Thunk-Symbolen in komplexen Vererbungskonfigurationen oder bei den meisten Konstruktoren und Destruktoren (da g++ typischerweise zwei reale Symbole für sie generiert). Da diese Kollisionen aber auf dem ABI-Niveau passieren, sollten sie nicht die Qualität der Symboldatei reduzieren.

note: type: Plain text
en: This pattern is denoted by the I<symver> tag. Well maintained libraries have versioned symbols where each version corresponds to the upstream version where the symbol got added. If that's the case, you can use a I<symver> pattern to match any symbol associated to the specific version. For example:
de: Dieses Muster wird durch die Kennzeichnung I<symver> verzeichnet. Gut betreute Bibliotheken verfügen über versionierte Symbole, wobei jede Version zu der Version der Originalautoren passt, in der dieses Symbol hinzugefügt wurde. Falls das der Fall ist, können SIe ein I<symver>-Muster verwenden, um auf jedes zu einer spezifizierten Version zugeordnete Symbol zu passen. Beispiel:

note: type: Plain text
en: libc.so.6 libc6 #MINVER#
     (symver)GLIBC_2.0 2.0
     [...]
     (symver)GLIBC_2.7 2.7
     access@GLIBC_2.0 2.2
de: libc.so.6 libc6 #MINVER#
     (symver)GLIBC_2.0 2.0
     […]
     (symver)GLIBC_2.7 2.7
     access@GLIBC_2.0 2.2

note: type: Plain text
en: All symbols associated with versions GLIBC_2.0 and GLIBC_2.7 will lead to minimal version of 2.0 and 2.7 respectively with the exception of the symbol access@GLIBC_2.0. The latter will lead to a minimal dependency on libc6 version 2.2 despite being in the scope of the "(symver)GLIBC_2.0" pattern because specific symbols take precedence over patterns.
de: Alle Version GLIBC_2.0 und GLIBC_2.7 zugeordneten Symbole werden zu einer minimalen Version 2.0 bzw. 2.7 führen, wobei das Symbol access@GLIBC_2.0 die Ausnahme darstellt. Es wird zu einer minimalen Abhängigkeit auf libc6 Version 2.2 führen, obwohl es im Geltungsbereich des Musters »(symver)GLIBC_2.0« passt, da spezielle Symbole vor Mustern Vorrang haben.

note: type: Plain text
en: Please note that while old style wildcard patterns (denoted by "*@version" in the symbol name field) are still supported, they have been deprecated by new style syntax "(symver|optional)version". For example, "*@GLIBC_2.0 2.0" should be written as "(symver|optional)GLIBC_2.0 2.0" if the same behaviour is needed.
de: Bitte beachten Sie, dass Platzhaltermuster im alten Format (angezeigt durch »*@version« im Symbolnamenfeld) zwar noch unterstützt werden, sie aber durch die Syntax im neuen Format »(symver|optional)version« abgelöst wurden. Beispielsweise sollte »*@GLIBC_2.0 2.0« als »(symver|optional)GLIBC_2.0 2.0« geschrieben werden, falls das gleiche Verhalten benötigt wird.

note: type: Plain text
en: Regular expression patterns are denoted by the I<regex> tag. They match by the perl regular expression specified in the symbol name field. A regular expression is matched as it is, therefore do not forget to start it with the I<^> character or it may match any part of the real symbol I<name@version> string. For example:
de: Muster mit regulären Ausdrücken werden durch die Kennzeichnung I<regex> verzeichnet. Sie passen auf den regulären Ausdruck von Perl, der im Symbolnamenfeld angegeben ist. Ein regulärer Ausdruck wird wie er ist gepasst. Denken Sie daher daran, ihn mit dem Zeichen I<^> zu beginnen, da er ansonsten auf jeden Teil der Zeichenkette des realen Symbols I<name@version> passt. Beispiel:

note: type: Plain text
en: Symbols like "mystack_new@Base", "mystack_push@Base", "mystack_pop@Base" etc.  will be matched by the first pattern while e.g. "ng_mystack_new@Base" won't.  The second pattern will match all symbols having the string "private" in their names and matches will inherit I<optional> tag from the pattern.
de: Symbole wie »mystack_new@Base«, »mystack_push@Base«, »mystack_pop@Base« usw. werden vom ersten Muster gepasst, während dies z.B. für »ng_mystack_new@Base« nicht der Fall ist. Das zweite Muster wird auf alle Symbole, die die Zeichenkette »private« in ihren Namen enthalten, passen und die gepassten Symbole erben die Kennzeichnung I<optional> vom Muster.

note: type: Plain text
en: Basic patterns listed above can be combined where it makes sense. In that case, they are processed in the order in which the tags are specified. For example, both
de: Die oben aufgeführten grundlegenden Muster können - wo es Sinn ergibt - kombiniert werden. In diesem Fall werden sie in der Reihenfolge verarbeitet, in der die Kennzeichnungen angegeben sind. Im Beispiel

note: type: Plain text
en: will match symbols "_ZN3NSA6ClassA7Private11privmethod1Ei@Base" and "_ZN3NSA6ClassA7Private11privmethod2Ei@Base". When matching the first pattern, the raw symbol is first demangled as C++ symbol, then the demangled name is matched against the regular expression. On the other hand, when matching the second pattern, regular expression is matched against the raw symbol name, then the symbol is tested if it is C++ one by attempting to demangle it. A failure of any basic pattern will result in the failure of the whole pattern.  Therefore, for example, "__N3NSA6ClassA7Private11privmethod\edEi@Base" will not match either of the patterns because it is not a valid C++ symbol.
de: werden die Symbole »_ZN3NSA6ClassA7Private11privmethod1Ei@Base« und »_ZN3NSA6ClassA7Private11privmethod2Ei@Base« gepasst. Beim Passen der ersten Musters wird das rohe Symbol erst als C++-Symbol entworren, dann wird der entworrende Name gegen den regulären Ausdruck gepasst. Auf der anderen Seite wird beim Passen des zweiten Musters der reguläre Ausdruck gegen den rohen Symbolnamen gepasst, dann wird das Symbol überprüft, ob es ein C++-Symbol ist, indem das Entwirren versucht wird. Ein Fehlschlag eines einfachen Musters wird zum Fehlschlag des gesamten Musters führen. Daher wird beispielsweise »__N3NSA6ClassA7Private11privmethod\edEi@Base« keines der Muster passen, da es kein gültiges C++-Symbol ist.

note: type: Plain text
en: In general, all patterns are divided into two groups: aliases (basic I<c++> and I<symver>) and generic patterns (I<regex>, all combinations of multiple basic patterns). Matching of basic alias-based patterns is fast (O(1))  while generic patterns are O(N) (N - generic pattern count) for each symbol.  Therefore, it is recommended not to overuse generic patterns.
de: Im Allgemeinen werden die Muster in zwei Kategorien eingeteilt: Aliase (grundlegende I<c++>- und I<symver>-Muster) und generische Muster (I<regex> und alle Kombinationen grundlegender Muster). Passen von grundlegenden alias-basierenden Mustern ist schnell (O(1)), während generische Muster O(N) (wobei N die Anzahl der generischen Muster ist) für jedes Symbol ist. Daher wird empfohlen, generische Muster nicht zu viel zu verwenden.

note: type: Plain text
en: When multiple patterns match the same real symbol, aliases (first I<c++>, then I<symver>) are preferred over generic patterns. Generic patterns are matched in the order they are found in the symbol file template until the first success.  Please note, however, that manual reordering of template file entries is not recommended because B<dpkg-gensymbols> generates diffs based on the alphanumerical order of their names.
de: Wenn mehrere Muster auf das gleiche Symbol passen, werden Aliase (zuerst I<c++>, dann I<symver>) gegenüber den generischen Mustern bevorzugt. Generische Muster werden in der Reihenfolge, in der sie in der Symboldateivorlage gefunden werden, gepasst, bis zum ersten Erfolg. Beachten Sie aber, dass das manuelle Anordnen der Vorlagendateieinträge nicht empfohlen wird, da B<dpkg-gensymbols> Diffs basierend auf der alphanumerischen Reihenfolge ihrer Namen erstellt.

note: type: SS
en: Using includes
de: Includes verwenden

note: type: Plain text
en: When the set of exported symbols differ between architectures, it may become inefficient to use a single symbol file. In those cases, an include directive may prove to be useful in a couple of ways:
de: Wenn der Satz der exportierten Symbolen sich zwischen Architekturen unterscheidet, kann es ineffizient werden, eine einzige Symboldatei zu verwenden. In diesen Fällen kann sich eine Include-Direktive in einer Reihe von Arten als nützlich erweisen:

note: type: Plain text
en: You can factorize the common part in some external file and include that file in your I<package>.symbols.I<arch> file by using an include directive like this:
de: Sie können den gemeinsamen Teil in eine externe Datei auslagern und diese Datei dann in Ihre I<Paket>.symbols.I<Arch>-Datei mit einer include-Direktive wie folgt einbinden:

note: type: Plain text
en: #include "I<packages>.symbols.common"
de: #include "I<Pakete>.symbols.common"

note: type: Plain text
en: The include directive may also be tagged like any symbol:
de: Die Include-Direktive kann auch wie jedes Symbol gekennzeichnet werden:

note: type: Plain text
en: (tag|...|tagN)#include "file-to-include"
de: (Kennzeichen|…|KennzeichenN)#include "einzubindende-Datei"

note: type: Plain text
en: As a result, all symbols included from I<file-to-include> will be considered to be tagged with I<tag> ... I<tagN> by default. You can use this feature to create a common I<package>.symbols file which includes architecture specific symbol files:
de: Als Ergebnis werden alle Symbole aus I<einzubindende-Datei> standardmäßig als mit I<Kennzeichen> … I<KennzeichenN> gekennzeichnet betrachtet. Sie können diese Funktionalität benutzen, um eine gemeinsame Datei I<Paket>.symbols zu erstellen, die architekturspezifische Symboldateien einbindet:

note: type: Plain text
en:   common_symbol1@Base 1.0
     (arch=amd64 ia64 alpha)#include "package.symbols.64bit"
     (arch=!amd64 !ia64 !alpha)#include "package.symbols.32bit"
      common_symbol2@Base 1.0
de:   common_symbol1@Base 1.0
     (arch=amd64 ia64 alpha)#include "Paket.symbols.64bit"
     (arch=!amd64 !ia64 !alpha)#include "Paket.symbols.32bit"
      common_symbol2@Base 1.0

note: type: Plain text
en: The symbols files are read line by line, and include directives are processed as soon as they are encountered. This means that the content of the included file can override any content that appeared before the include directive and that any content after the directive can override anything contained in the included file. Any symbol (or even another #include directive) in the included file can specify additional tags or override values of the inherited tags in its tag specification. However, there is no way for the symbol to remove any of the inherited tags.
de: Die Symboldateien werden Zeile für Zeile gelesen und include-Direktiven werden bearbeitet, sobald sie erkannt werden. Das bedeutet, dass der Inhalt der Include-Datei jeden Inhalt überschreiben kann, der vor der Include-Direktive aufgetaucht ist und Inhalt nach der Direktive alles aus der Include-Datei überschreiben kann. Jedes Symbol (oder sogar weitere #include-Direktiven) in der Include-Datei kann zusätzliche Kennzeichnungen spezifizieren oder Werte der vererbtgen Kennzeichnungen in ihrer Kennzeichnungsspezifikation überschreiben. Allerdings gibt es keine Möglichkeit für ein Symbol, die ererbten Kennzeichnungen zu überschreiben.

note: type: Plain text
en: An included file can repeat the header line containing the SONAME of the library. In that case, it overrides any header line previously read.  However, in general it's best to avoid duplicating header lines. One way to do it is the following:
de: Eine eingebundene Datei kann die Kopfzeile wiederholen, die den SONAME der Bibliothek enthält. In diesem Fall überschreibt sie jede vorher gelesene Kopfzeile. Allerdings ist es im Allgemeinen am Besten, die Wiederholung von Kopfzeilen zu vermeiden. Ein Weg dies zu erreichen, ist wie folgt:

note: type: Plain text
en: #include "libsomething1.symbols.common"
     arch_specific_symbol@Base 1.0
de: #include "libirgendwas1.symbols.common"
     arch_spezifisches_Symbol@Base 1.0

note: type: SS
en: Good library management
de: Gute Bibliotheksverwaltung

note: type: Plain text
en: A well-maintained library has the following features:
de: Eine gut verwaltete Bibliothek hat die folgenden Eigenschaften:

note: type: Plain text
en: its API is stable (public symbols are never dropped, only new public symbols are added) and changes in incompatible ways only when the SONAME changes;
de: seine API ist stabil (öffentliche Symbole entfallen nie, nur neue öffentliche Symbole werden hinzugefügt) und inkompatible Änderungen erfolgen nur, wenn sich der SONAME ändert,

note: type: Plain text
en: ideally, it uses symbol versioning to achieve ABI stability despite internal changes and API extension;
de: idealerweise verwendet sie Symbolversionierung, um ABI-Stabilität trotz interner Änderungen und API-Erweiterungen zu erreichen,

note: type: Plain text
en: it doesn't export private symbols (such symbols can be tagged optional as workaround).
de: sie exportiert nie private Symbole (als Hilfslösung können diese als optional gekennzeichnet werden).

note: type: Plain text
en: While maintaining the symbols file, it's easy to notice appearance and disappearance of symbols. But it's more difficult to catch incompatible API and ABI change. Thus the maintainer should read thoroughly the upstream changelog looking for cases where the rules of good library management have been broken. If potential problems are discovered, the upstream author should be notified as an upstream fix is always better than a Debian specific work-around.
de: Bei der Verwaltung der Symboldatei kann das Auftauchen und Verschwinden von Symbolen leicht bemerkt werden. Es ist aber schwieriger, inkompatbile API- und ABI-Änderungen zu bemerken. Daher sollte der Betreuer intensiv die Changelog-Einträge durchschauen und nach Fällen suchen, in denen die Regeln der guten Bibliotheksverwaltung gebrochen wurden. Falls mögliche Probleme entdeckt wurden, sollten der Originalautor informiert werden, da eine Korrektur vom Originalautor immer besser als eine Debian-spezifische Hilfslösung ist.

note: type: Plain text
en: Scan I<package-build-dir> instead of debian/tmp.
de: Suche nach I<Paketbauverzeichnis> statt nach debian/tmp.

note: type: Plain text
en: Define the package name. Required if more than one binary package is listed in debian/control (or if there's no debian/control file).
de: Definiert den Paketnamen. Benötigt, falls mehr als ein binäres Paket in debian/control aufgeführt ist (oder falls es keine Datei debian/control gibt).

note: type: Plain text
en: Define the package version. Defaults to the version extracted from debian/changelog. Required if called outside of a source package tree.
de: Definiert die Paketversion. Standardmäßig wird eie Version aus debian/changelog ausgelesen. Benötigt, falls der Aufruf außerhalb des Quellpaketbaums erfolgt.

note: type: TP
en: B<-e>I<library-file>
de: B<-e>I<Bibliotheksdatei>

note: type: Plain text
en: Only analyze libraries explicitly listed instead of finding all public libraries. You can use shell patterns used for pathname expansions (see the File::Glob manual page for details) in I<library-file> to match multiple libraries with a single argument (otherwise you need multiple B<-e>).
de: Nur die explizit aufgeführten Bibliotheken untersuchen statt alle öffentlichen Bibliotheken zu finden. Sie können Shell-Muster, die zur Expansion von Pfadnamen verwandt werden (siehe die Handbuchseite File::Glob für weitere Details) in I<Bibliotheksdatei> verwenden, um mehrere Bibliotheken mit einem einzelnen Argument zu passen (andernfalls benötigen Sie mehrere B<-e>).

note: type: TP
en: B<-I>I<filename>
de: B<-I>I<Dateiname>

note: type: Plain text
en: Use I<filename> as reference file to generate the symbols file that is integrated in the package itself.
de: Verwende I<Dateiname> als Referenzdatei, um die Symboldatei zu erstellen, die dann im Paket selbst integriert wird.

note: type: Plain text
en: Print the generated symbols file to standard output, rather than being stored in the package build tree.
de: Gebe die erstellte Symboldatei in die Standardausgabe aus statt sie im Paketbaubaum zu speichern.

note: type: TP
en: B<-O>I<filename>
de: B<-O>I<Dateiname>

note: type: Plain text
en: Store the generated symbols file as I<filename>. If I<filename> is pre-existing, its content is used as basis for the generated symbols file.  You can use this feature to update a symbols file so that it matches a newer upstream version of your library.
de: Speichere die erstellte Symboldatei unter I<Dateiname>. Falls I<Dateiname> bereits existiert, wird deren Inhalt als Grundlage für die erstellte Symboldatei verwandt. Sie können diese Funktionalität benutzen, um eine Symboldatei zu aktualisieren, so dass sie zu einer neueren Version der Originalautoren Ihrer Bibliothek passt.

note: type: Plain text
en: Write the symbol file in template mode rather than the format compatible with I<deb-symbols(5)>. The main difference is that in the template mode symbol names and tags are written in their original form contrary to the post-processed symbol names with tags stripped in the compatibility mode.  Moreover, some symbols might be omitted when writing a standard I<deb-symbols(5)> file (according to the tag processing rules) while all symbols are always written to the symbol file template.
de: Schreibe die Symboldatei im Vorlagenmodus statt im zu I<deb-symbols(5)> kompatiblen Format. Der Hauptunterschied besteht darin, dass im Vorlagenmodus die Symbolnamen und Kennzeichnungen in ihrer Originalform geschrieben werden, im Gegensatz zu den verarbeiteten Symbolnamen mit entfernen Kennzeichnungen im Kompatibilitätsmodus. Desweiteren könnten einige Symbole beim Schreiben einer Standard I<deb-symbols(5)>-Datei entfernt werden (gemäß der Verarbeitungsregeln für Kennzeichen), während in der Symboldateivorlage immer alle Symbole geschrieben werden.

note: type: Plain text
en: Define the checks to do when comparing the generated symbols file with the template file used as starting point. By default the level is 1. Increasing levels do more checks and include all checks of lower levels. Level 0 never fails. Level 1 fails if some symbols have disappeared. Level 2 fails if some new symbols have been introduced. Level 3 fails if some libraries have disappeared. Level 4 fails if some libraries have been introduced.
de: Definiert die Prüfungen, die beim Vergleich der erstellten Symboldatei mit der Vorlagendatei als Startpunkt erfolgen sollen. Standardardstufe ist 1. Zunehmende Stufen führen mehr Prüfungen durch und enthalten alle Prüfungen der niedrigeren Stufen. Stufe 0 schlägt nie fehl. Stufe 1 schlägt fehl, wenn einige Symbole verschwunden sind. Stufe 2 schlägt fehlt, falls einige neue Symbole eingeführt wurden. Stufe 3 schlägt fehl, falls einige Bibliotheken verschwunden sind. Stufe 4 schlägt fehl, falls einige Bibliotheken hinzugekommen sind.

note: type: Plain text
en: This value can be overridden by the environment variable DPKG_GENSYMBOLS_CHECK_LEVEL.
de: Dieser Wert kann von der Umgebungsvariablen DPKG_GENSYMBOLS_CHECK_LEVEL überschrieben werden.

note: type: Plain text
en: Keep quiet and never generate a diff between generated symbols file and the template file used as starting point or show any warnings about new/lost libraries or new/lost symbols. This option only disables informational output but not the checks themselves (see I<-c> option).
de: Ruhig verhalten und nie einen Diff zwischen der erstellten Symboldatei und der als Startpunkt verwandten Vorlagendatei erstellen oder keine Warnungen bezüglich neuer/verlorender Bibliotheken oder neuer/verlorender Symbole ausgeben. Diese Option deaktiviert nur die informative Ausgabe aber nicht die Prüfungen selbst (sehen Sie hierzu die Option I<-c>).

note: type: TP
en: B<-a>I<arch>
de: B<-a>I<Architektur>

note: type: Plain text
en: Assume I<arch> as host architecture when processing symbol files. Use this option to generate a symbol file or diff for any architecture provided its binaries are already available.
de: Nehme I<Arch> als Host-Architektur beim Verarbeiten der Symboldateien an. Verwenden Sie diese Option, um Symboldateien oder Diffs für beliebige Architekturen zu erstellen, vorausgesetzt, die Binärprogramme sind bereits verfügbar.

note: type: Plain text
en: Enable debug mode. Numerous messages are displayed to explain what B<dpkg-gensymbols> does.
de: Debug-Modus aktivieren. Eine Vielzahl von Nachrichten wird angezeigt, um zu erklären, was B<dpkg-gensymbols> durchführt.

note: type: Plain text
en: Enable verbose mode. The generated symbols file contains deprecated symbols as comments. Furthermore in template mode, pattern symbols are followed by comments listing real symbols that have matched the pattern.
de: Ausführlichen Modus aktivieren. Die erstellte Symboldatei enthält veraltete Symbole als Kommentare. Im Vorlagenmodus werden Mustersymbole desweiteren von Kommentaren gefolgt, die die echten Symbole aufführen, die auf dieses Muster passen.

note: type: Plain text
en: dpkg-maintscript-helper - works around known dpkg limitations in maintainer scripts
de: dpkg-maintscript-helper - Bekannte Einschränkungen in Dpkg in Betreuerskripten umgehen

note: type: Plain text
en: B<dpkg-maintscript-helper> I<command> [I<parameter>...] B<--> I<maint-script-parameter>...
de: B<dpkg-maintscript-helper> I<Befehl> [I<Parameter> …] B<--> I<Betr-Skript-Parameter> …

note: type: SH
en: COMMANDS AND PARAMETERS
de: BEFEHLE UND PARAMETER

note: type: Plain text
en: B<rm_conffile> I<conffile> [I<prior-version> [I<package>]]
de: B<rm_conffile> I<Conffile> [I<vorhergehende_Version> [I<Paket>]]

note: type: Plain text
en: B<mv_conffile> I<old-conffile> I<new-conffile> [I<prior-version> [I<package>]]
de: B<mv_conffile> I<alte_Conffile> I<neue_Conffile> [I<vorhergehende_Version> [I<Paket>]]

note: type: Plain text
en: This program is designed to be run within maintainer scripts to achieve some tasks that dpkg can't (yet) handle natively either because of design decisions or due to current limitations.
de: Dieses Programm wurde so entworfen, dass es in Betreuerskripten ausgeführt werden kann, um einige Aufgaben zu erledigen, die Dpkg (noch) nicht selbst erledigen kann, entweder aufgrund von Design-Entscheidungen oder aufgrund aktueller Einschränkungen.

note: type: Plain text
en: Many of those tasks require coordinated actions from several maintainer scripts (B<preinst>, B<postinst>, B<prerm>, B<postrm>). To avoid mistakes the same call simply needs to be put in all scripts and the program will automatically adapt its behaviour based on the environment variable B<DPKG_MAINTSCRIPT_NAME> and on the maintainer scripts arguments that you have to forward after a double dash.
de: Viele dieser Aufgaben benötigen koordinierte Aktionen aus mehreren Betreuerskripten (B<preinst>, B<postinst>, B<prerm>, B<postrm>). Um Fehler zu vermeiden, wird der gleiche Aufruf einfach in alle Skripte eingefügt und das Programm wird sein Verhalten automatisch abhängig von der Variable B<DPKG_MAINTSCRIPT_NAME> und den Argumenten im Betreuerskript, die Sie nach einem doppelten Schrägstrich übergeben müssen, anpassen.

note: type: SH
en: CONFFILE RELATED TASKS
de: CONFFILE-BEZOGENE AUFGABEN

note: type: Plain text
en: When upgrading a package, dpkg will not automatically remove a conffile (a configuration file for which dpkg should preserve user changes) if it is not present in the newer version. There are two principal reasons for this; the first is that the conffile could've been dropped by accident and the next version could restore it, users wouldn't want their changes thrown away. The second is to allow packages to transition files from a dpkg-maintained conffile to a file maintained by the package's maintainer scripts, usually with a tool like debconf or ucf.
de: Beim Upgrade eines Pakets wird Dpkg ein Conffile (eine Konfigurationsdatei, bei der Dpkg die Änderungen des Benutzers erhalten soll) nicht automatischen entfernen, falls sie nicht in der neueren Version enthalten ist. Es gibt zwei Hauptgründe dafür; der erste ist, dass die Conffile versehentlich entfallen sein und die nächste Version sie wieder herstellen könnte und die Benutzer die Änderung nicht weggeworfen sehen wollen. Der zweite besteht darin, dass Paketen erlaubt werden soll, von einer Dpkg-betreuten Conffile auf eine Datei, die von den Betreuerskripten des Pakets, normalerweise mit einem Werkzeug wie Debconf oder Ucf, verwaltet wird, umzustellen.

note: type: Plain text
en: This means that if a package is intended to rename or remove a conffile, it must explicitly do so and B<dpkg-maintscript-helper> can be used to implement graceful deletion and moving of conffiles within maintainer scripts.
de: Das bedeutet, falls ein Paket eine Conffile umbenennen oder entfernen soll, muss es dies explizit durchführen und B<dpkg-maintscript-helper> kann dazu verwandt werden, eine sanfte Löschung und Verschiebung von Conffiles innerhalb von Betreuerskripten durchzuführen.

note: type: SS
en: REMOVING A CONFFILE
de: EINE CONFFILE ENTFERNEN

note: type: Plain text
en: If a conffile is completely removed, it should be removed from disk, unless the user has modified it. If there are local modifications, they should be preserved. If the package upgrades aborts, the newly obsolete conffile should not disappear.
de: Falls eine Conffile komplett entfernt wird, sollte sie von der Platte entfernt werden, falls der Benutzer sie nicht verändert hat. Falls es lokale Anpassungen gibt, sollten diese erhalten werden. Falls das Upgrade des Pakets abgebrochen wird, sollte die neuerdings veraltete Conffile nicht verschwinden.

note: type: Plain text
en: All of this is implemented by putting the following shell snippet in the B<preinst>, B<postinst> and B<postrm> maintainer scripts:
de: All dies wird durch Einsetzen der folgenden Shell-Schnipsel in die Betreuerskripte B<preinst>, B<postinst> und B<postrm> implementiert:

note: type: Plain text
en:     dpkg-maintscript-helper rm_conffile \e
            I<conffile> I<prior-version> I<package> -- "$@"
de:     dpkg-maintscript-helper rm_conffile \e
            I<Conffile> I<vorhergehende_Version> I<Paket> -- "$@"

note: type: Plain text
en: I<conffile> is the filename of the conffile to remove.
de: I<Conffile> ist der Dateiname der zu entfernenden Conffile.

note: type: Plain text
en: I<prior-version> defines the latest version of the package whose upgrade should trigger the removal. It is important to calculate I<prior-version> correctly so that conffiles are correctly removed even if the user rebuilt the package with a local version. For example, for a conffile removed in version B<2.0-1> of a package, I<prior-version> should be set to B<2.0-1~>. This will cause the conffile to be removed even if the user rebuilt the previous version B<1.0-1> as B<1.0-1local1>.
de: I<vorhergehende_Version> definiert die letzte Version des Pakets, dessen Upgrade die Entfernung auslösen soll. Es ist wichtig, dass I<vorhergehende_Version> korrekt berechnet wird, so dass Conffiles korrekt entfernt werden, selbst falls der Benutzer das Paket mit einer lokalen Version neu gebaut hat. Wird beispielsweise eine Conffile in Version B<2.0-1> eines Pakets entfernt, sollte I<vorhergehende_Version> auf B<2.0-1~> gesetzt werden. Dies führt dazu, dass das Conffile entfernt wird, selbst falls der Benutzer die vorhergehende Version B<1.0-1> als B<1.0-1local1> neu gebaut hat.

note: type: Plain text
en: If the conffile has not been shipped for several versions, and you are now modifying the maintainer scripts to clean up the obsolete file, I<prior-version> should be based on the version of the package that you are now preparing, not the first version of the package that lacked the conffile.
de: Falls das Conffile in mehreren Versionen nicht ausgeliefert wurde und Sie jetzt die Betreuerskripte anpassen, um die überflüssige Datei zu entfernen, sollte I<vorhergehende_Version> auf die Version des Pakets gesetzt werden, die Sie jetzt zusammenstellen, nicht auf die erste Version des Pakets, bei dem das Conffile fehlte.

note: type: Plain text
en: I<package> is the package name. If empty or omitted, the DPKG_MAINTSCRIPT_PACKAGE environment variable (as set by dpkg) will be used.
de: I<Paket> ist der Paketname. Falls leer oder nicht angegeben wird die (von Dpkg gesetzte) Umgebungsvariable DPKG_MAINTSCRIPT_PACKAGE verwandt.

note: type: Plain text
en: All the parameters of the maintainer scripts have to be forwarded to the program after "--".
de: Alle Parameter der Betreuerskripte müssen nach »--« an das Programm weitergeleitet werden.

note: type: Plain text
en: Current implementation: in the B<preinst>, it checks if the conffile was modified and renames it either to I<conffile>B<.dpkg-remove> (if not modified) or to I<conffile>B<.dpkg-backup> (if modified). In the B<postinst>, the latter file is renamed to I<conffile>B<.dpkg-bak> and kept for reference as it contains user modifications but the former will be removed. If the package upgrade aborts, the B<postrm> reinstalls the original conffile. During purge, the B<postrm> will also delete the B<.dpkg-bak> file kept up to now.
de: Aktuelle Implementierung: im B<preinst> wird geprüft, ob die Conffile geändert wurde. Dann wird sie entweder in I<Conffile>B<.dpkg-remove> (falls sie nicht geändert wurde) oder in I<Conffile>B<.dpkg-backup> (falls sie geändert wurde) umbenannt. Im B<postinst> wird letztere in I<Conffile>B<.dpkg-bak> umbenannt und als Referenz behalten, da sie Benutzeränderungen enthält, während erstere entfernt wird. Falls das Upgrade des Pakets abgebrochen wird, reinstalliert B<postrm> die ursprüngliche Conffile. Während des vollständigen Löschens wird B<postrm> auch die bisher behaltene Datei B<.dpkg-bak> entfernen.

note: type: SS
en: RENAMING A CONFFILE
de: EINE CONFFILE UMBENENNEN

note: type: Plain text
en: If a conffile is moved from one location to another, you need to make sure you move across any changes the user has made. This may seem a simple change to the B<preinst> script at first, however that will result in the user being prompted by dpkg to approve the conffile edits even though they are not responsible of them.
de: Falls eine Conffile von einem Ort zu einem anderen verschoben wird, müssen Sie sicherstellen, dass Sie auch alle Änderungen des Benutzers mit übernehmen. Anfänglich erscheint dies als einfache Änderung am Skript B<preinst>, allerdings wird dies dazu führen, dass der Benutzer von Dpkg aufgefordert wird, die Bearbeitung der Conffile zu bestätigen, obwohl sie für diese gar nicht verantwortlich sind.

note: type: Plain text
en: Graceful renaming can be implemented by putting the following shell snippet in the B<preinst>, B<postinst> and B<postrm> maintainer scripts:
de: Sanfte Umbenennung kann durch Einsetzen der folgenden Shell-Schnipsel in die Betreuerskripte B<preinst>, B<postinst> und B<postrm> implementiert werden:

note: type: Plain text
en:     dpkg-maintscript-helper mv_conffile \e
            I<old-conffile> I<new-conffile> I<prior-version> I<package> -- "$@"
de:     dpkg-maintscript-helper mv_conffile \e
            I<alte_Conffile> I<neue_Conffile> I<vorhergehende_Version> I<Paket> -- "$@"

note: type: Plain text
en: I<old-conffile> and I<new-conffile> are the old and new name of the conffile to rename.
de: I<alte_Conffile> und I<neue_Conffile> sind der alte und der neue Name der umzubenennenden Conffile.

note: type: Plain text
en: I<prior-version> defines the latest version of the package whose upgrade should trigger the rename of the conffile (see the notes for B<rm_conffile> above concerning the correct value). If I<prior-version> is empty or omitted, then the operation is tried on every upgrade (note: it's safer to give the version and have the operation tried only once).
de: I<vorhergehende_Version> definiert die letzte Version des Pakets, dessen Upgrade die Umbenennung der Conffile auslösen soll (siehe die Anmerkungen für B<rm_conffile> weiter oben in Bezug auf die korrekte Version). Falls I<vorhergehende_Version> leer ist oder weggelassen wurde wird die Umbenennung bei jedem Upgrade versucht (Hinweis: Es ist sicherer, die Version anzugeben und damit nur einmal versuchen zu lassen, die Datei umzubenennen).

note: type: Plain text
en: Current implementation: the B<preinst> checks if the conffile has been modified, if yes it's left on place otherwise it's renamed to I<old-conffile>B<.dpkg-remove>. On configuration, the B<postinst> removes I<old-conffile>B<.dpkg-remove> and renames I<old-conffile> to I<new-conffile> if I<old-conffile> is still available. On abort-upgrade/abort-install, the B<postrm> renames I<old-conffile>B<.dpkg-remove> back to I<old-conffile> if required.
de: Aktuelle Implementierung: das B<preinst> überprüft, ob die Conffile verändert wurde, falls ja, verbleibt sie am Platz, andernfalls wird sie in I<alte_Conffile>B<.dpkg-remove> umbenannt. Bei der Konfiguration entfernt das B<postinst> I<alte_Conffile>B<.dpkg-remove> und bennent I<alte_Conffile> in I<neue_Conffile> um, falls I<alte_Conffile> noch existiert. Falls abort-upgrade/abort-install eintritt, benennt das B<postrm> wieder I<alte_Conffile>B<.dpkg-remove> in I<alte_Conffile> zurück, falls notwendig.

note: type: SH
en: INTEGRATION IN PACKAGES
de: INTEGRATION IN PAKETE

note: type: Plain text
en: Given that B<dpkg-maintscript-helper> is used in the B<preinst>, using it unconditionally requires a pre-dependency to ensure that the required version of dpkg has been unpacked before. The required version depends on the command used, for B<rm_conffile> and B<mv_conffile> it is 1.15.7.2:
de: Da B<dpkg-maintscript-helper> im B<preinst> verwandt wird, benötigt der bedingungslose Einsatz eine pre-Abhängigkeit (I<pre-dependency>), um sicherzustellen, dass die Mindestversion von Dpkg breits entpackt wurde. Die benötigte Version hängt vom verwandten Befehl ab, für B<rm_conffile> und B<mv_conffile> lautet sie 1.15.7.2:

note: type: Plain text
en: But in many cases the operation done by the program is not critical for the package, and instead of using a pre-dependency we can call the program only if we know that the required command is supported by the currently installed dpkg:
de: In vielen Fällen sind aber die Ausführungen des Programms für das Paket nicht kritisch und statt einer pre-Abhängigkeit soll das Programm nur aufgerufen werden, falls bekannt ist, dass der benötigte Befehl vom derzeit installierten Dpkg unterstützt wird:

note: type: Plain text
en:     if dpkg-maintscript-helper supports I<command>; then
            dpkg-maintscript-helper I<command> ...
        fi
de:     if dpkg-maintscript-helper supports I<command>; then
            dpkg-maintscript-helper I<command> …
        fi

note: type: Plain text
en: dpkg-mergechangelogs - 3-way merge of debian/changelog files
de: dpkg-mergechangelogs - 3-Wege-Zusammenführung von debian/changelog-Dateien

note: type: Plain text
en: B<dpkg-mergechangelogs> [I<option>...] I<old> I<new-a> I<new-b> [I<out>]
de: B<dpkg-mergechangelogs> [I<Option> …] I<alt> I<neu-a> I<neu-b> [I<Ausgabe>]

note: type: Plain text
en: This program will use the 3 provided versions of the Debian changelog to generate a merged changelog file. The resulting changelog is stored in the file I<out> or output to the standard output if that parameter is not given.
de: Dieses Programm wird die drei bereitgestellten Versionen des Debian-Changelogs verwenden, um eine zusammengeführte Changelog-Datei zu erstellen. Das resultierende Changelog wird in der Datei I<Ausgabe> gespeichert oder an die Standardausgabe ausgegeben, falls dieser Parameter fehlt.

note: type: Plain text
en: Each entry is identified by its version number and they are assumed to be not conflicting, they are simply merged in the right order (by decreasing version number). When B<--merge-prereleases> is used, the part of the version number after the last tilde is dropped so that 1.0-1~exp1 and 1.0-1~exp5 are considered to be the same entry. When the same version is available in both I<new-a> and I<new-b>, a standard line-based 3-way merge is attempted (provided that the module Algorithm::Merge is available \[em] it's part of the package libalgorithm-merge-perl \[em] otherwise you get a global conflict on the content of the entry).
de: Jeder Eintrag wird durch seine Versionsnummer identifiziert und es wird angenommen, dass sie nicht im Konflikt stehen, sie werden einfach in der richtigen Reihenfolge eingemischt (in absteigender Reihenfolge). Wenn B<--merge-prereleases> verwandt wird, wird der Anteil der Versionsnummer nach der letzten Tilde entfernt, so dass 1.0-1~exp1 und 1.0-1~exp5 als gleicher Eintrag angenommen werden. Wenn die gleiche Version sowohl in I<neu-a> als auch in I<neu-b> verfügbar ist, wird eine normale, zeilenbasierte 3-Wege-Zusammenführung versucht (vorausgesetzt, dass das Modul Algorithm::Merge verfügbar ist \[em] es ist Teil des Pakets libalgorithm-merge-perl \[em] andernfalls erhalten Sie einen globalen Konflikt im Inhalt des Eintrags).

note: type: Plain text
en: Drop the part after the last tilde in the version number when doing version comparison to identify if two entries are supposed to be the same or not.
de: Entfernt den Teil nach der letzten Tilde in der Versionsnummer beim Versionsvergleich, um festzustellen, ob zwei Einträge identisch sein sollen oder nicht.

note: type: Plain text
en: This is useful when you keep using the same changelog entry but you increase its version number regularly. For instance, you might have 2.3-1~exp1, 2.3-1~exp2, ... until the official release 2.3-1 and they are all the same changelog entry that has evolved over time.
de: Dies ist nützlich, wenn Sie den gleichen Changelog-Eintrag beibehalten, aber regelmäßig die Versionsnummer erhöhen. Beispielsweise könnten Sie 2.3-1~exp1, 2.3-1~exp2, … bis zur offiziellen Veröffentlichung 2.3-1 verwenden und alle enthalten den gleichen Changelog-Eintrag, der sich im Laufe der Zeit entwickelt hat.

note: type: SH
en: LIMITATIONS
de: EINSCHRÄNKUNGEN

note: type: Plain text
en: Anything that is not parsed by Dpkg::Changelog is lost during the merge.  This might include stuff like vim modelines, comments which were not supposed to be there, etc.
de: Alles, was nicht von Dpkg::Changelog ausgewertet werden kann, geht beim Zusammenführen verloren. Dies betrifft Zeug wie Modelines von Vim, Kommentare, die eigentlich nicht da sein sollten, usw.

note: type: SH
en: INTEGRATION WITH GIT
de: INTEGRATION MIT GIT

note: type: Plain text
en: If you want to use this program to merge Debian changelog files in a git repository, you have first to register a new merge driver in B<.git/config> or B<~/.gitconfig>:
de: Falls Sie dieses Programm dazu verwenden möchten, Debian-Changelog-Dateien in einem Git-Depot zusammenzuführen, müssen Sie zuerst einen neuen Merge-Driver in B<.git/config> oder in B<~/.gitconfig> registrieren:

note: type: Plain text
en: Then you have to setup the merge attribute for the debian/changelog file either in B<.gitattributes> in the repository itself, or in B<.git/info/attributes>:
de: Dann müssen Sie entweder in B<.gitattributes> im Depot selbst oder in B<.git/info/attributes> das Merge-Attribut für die Datei debian/changelog einrichten:

note: type: Plain text
en: dpkg-name - rename Debian packages to full package names
de: dpkg-name - Debian-Pakete zu vollen Paketnamen umbenennen

note: type: Plain text
en: B<dpkg-name> [I<option>...] [B<-->] I<file>...
de: B<dpkg-name> [I<Option> …] [B<-->] I<Datei> …

note: type: Plain text
en: This manual page documents the B<dpkg-name> program which provides an easy way to rename B<Debian> packages into their full package names. A full package name consists of I<package>B<_>I<version>B<_>I<architecture>B<.>I<package-type> as specified in the control file of the package. The I<version> part of the filename consists of the upstream version information optionally followed by a hyphen and the revision information. The I<package-type> part comes from that field if present or fallbacks to B<deb>.
de: Diese Handbuchseite dokumentiert das B<dpkg-name>-Programm, das eine einfache Möglichkeit bereitstellt, B<Debian>-Pakete in ihren vollen Paketnamen umzubenennen. Ein voller Paketname besteht aus I<Paket>B<_>I<Version>B<_>I<Architektur>B<.>I<Pakettyp> wie in der Steuerdatei des Pakets spezifiziert. Der I<Version>-Teil des Dateinamens besteht aus der Versionsinformation der Originalautoren optional gefolgt von einem Gedankenstrich und der Revisionsinformation. Der I<Pakettyp>-Teil entstammt dem Feld I<package_type> (falls vorhanden) oder wird auf B<deb> gesetzt.

note: type: Plain text
en: The destination filename will not have the architecture information.
de: Der Zieldateiname wird keine Architekturinformation enthalten.

note: type: Plain text
en: Create a symlink, instead of moving.
de: Lege einen Symlink an, anstatt zu verschieben.

note: type: Plain text
en: Existing files will be overwritten if they have the same name as the destination filename.
de: Existierende Dateien werden überschrieben, falls sie den gleichen Namen wie der Zieldateiname haben.

note: type: TP
en: B<-s>, B<--subdir> [I<dir>]
de: B<-s>, B<--subdir> [I<Verzeichnis>]

note: type: Plain text
en: Files will be moved into a subdirectory. If the directory given as argument exists the files will be moved into that directory otherwise the name of the target directory is extracted from the section field in the control part of the package. The target directory will be `unstable/binary-I<architecture>/I<section>'. If the section is not found in the control, then `no-section' is assumed, and in this case, as well as for sections `non-free' and `contrib' the target directory is `I<section>/binary-I<architecture>'. The section field isn't required so a lot of packages will find their way to the `no-section' area. Use this option with care, it's messy.
de: Dateien werden in ein Unterverzeichnis verschoben. Falls das als Argument existierende Verzeichnis existiert, dann werden die Dateien in das Verzeichnis verschoben, andernfalls wird das Zielverzeichnis aus dem »section«-Feld des Steuerteils des Pakets extrahiert. Das Zielverzeichnis wird »unstable/binary-I<Architektur>/I<Bereich>« sein. Falls der Bereich nicht in der Steuerdatei gefunden werden kann, dann wird »no-section« angenommen, und in diesem Fall, wie auch für die Bereiche »non-free« und »contrib« ist das Zielverzeichnis »I<Bereich>/binary-I<Architektur>«. Das Bereichsfeld muss nicht angegeben werden, daher werden viele Pakete ihren Weg in das »no-section«-Gebiet finden. Verwenden Sie diese Option mit Vorsicht, sie ist unordentlich.

note: type: Plain text
en: This option can used together with the -s option. If a target directory isn't found it will be created automatically.  B<Use this option with care.>
de: Diese Option kann zusammen mit der Option -s verwendet werden. Falls das Zielverzeichnis nicht gefunden werden kann, wird es automatisch angelegt. B<Verwenden Sie diese Option mit Vorsicht.>

note: type: Plain text
en: The file `bar-foo.deb' will be renamed to bar-foo_1.0-2_i386.deb or something similar (depending on whatever information is in the control part of `bar-foo.deb').
de: Die Datei »bar-foo.deb« wird in bar-foo_1.0-2_i386.deb oder etwas ähnliches (abhängig von der Information, die in dem Steuerteil von »bar-foo.deb« ist) umbenannt.

note: type: Plain text
en: All files with the extension `deb' in the directory /root/debian and its subdirectory's will be renamed by dpkg-name if required into names with no architecture information.
de: Alle Dateien mit der Endung »deb« im Verzeichnis /root/debian und seiner Unterverzeichnisse werden von dpkg-name - falls notwendig - ohne Architekturinformation umbenannt.

note: type: Plain text
en: B<Don't do this.> Your archive will be messed up completely because a lot of packages don't come with section information.  B<Don't do this.>
de: B<Machen Sie dies nicht.> Ihr Archiv wird eine komplette Schweinerei werden, da viele Pakete nicht mit Bereichsinformationen kommen. B<Machen Sie dies nicht.>

note: type: Plain text
en: This can be used when building new packages.
de: Dies kann beim Bau neuer Pakete verwendet werden.

note: type: Plain text
en: Some packages don't follow the name structure I<package>B<_>I<version>B<_>I<architecture>B<.deb>.  Packages renamed by dpkg-name will follow this structure. Generally this will have no impact on how packages are installed by B<dselect>(1)/B<dpkg>(1), but other installation tools might depend on this naming structure.
de: Einige Pakete folgen nicht der Namensstruktur I<Paket>B<_>I<Version>B<_>I<Architektur>B<.deb>. Pakete, die von dpkg-name umbenannt wurden, folgen dieser Struktur. Im Allgemeinen hat diese keinen Einfluss darauf, wie Pakete von B<dselect>(1)/B<dpkg>(1) installiert werden, aber andere Installationswerkzeuge können von dieser Benennungsstruktur abhängen.

note: type: Plain text
en: dpkg-parsechangelog - parse Debian changelog files
de: dpkg-parsechangelog - auswerten von Debian changelog-Dateien

note: type: Plain text
en: B<dpkg-parsechangelog> [I<option>...]
de: B<dpkg-parsechangelog> [I<Option> …]

note: type: Plain text
en: B<dpkg-parsechangelog> reads and parses the changelog of an unpacked Debian source tree and outputs the information in it to standard output in a machine-readable form.
de: B<dpkg-parsechangelog> liest das Änderungsprotokoll (»changelog«) eines entpackten Debian-Quellcodebaums ein, wertet diese aus und gibt die Informationen in der Standard-Ausgabe in maschinenlesbarer Form aus.

note: type: Plain text
en: Specifies the format of the changelog. By default the format is read from a special line near the bottom of the changelog or failing that defaults to the I<debian> standard format. See also B<CHANGELOG FORMATS>.
de: Gibt das Format der Änderungsprotokolldatei an. Standardmäßig wird das Format aus einer speziellen Zeile in der Nähe des Endes der Änderungsprotokolldatei gelesen oder, falls dies fehlschlägt, wird das Debian-Standardformat angenommen. Siehe auch B<CHANGELOG-FORMATE>.

note: type: TP
en: B<-L>I<libdir>
de: B<-L>I<libverzeichnis>

note: type: Plain text
en: Specify an additional directory to search for parser scripts.  This directory is searched before the default directories which are currently B</usr/local/lib/dpkg/parsechangelog> and B</usr/lib/dpkg/parsechangelog>.
de: Spezifiziere ein zusätzliches Verzeichnis, dass nach Parser-Skripten durchsucht werden soll. Diese Verzeichnis wird vor den Standardverzeichnissen (derzeit B</usr/local/lib/dpkg/parsechangelog> und B</usr/lib/dpkg/parsechangelog>) durchsucht.

note: type: SS
en: Parser Options
de: Parser-Optionen:

note: type: Plain text
en: The following options can be used to influence the output of the changelog parser, e.g. the range of entries or the format of the output. They need to be supported by the parser script in question. See also B<CAVEATS>.
de: Die folgenden Optionen können verwendet werden, um die Ausgabe des Changelog-Parsers zu beinflussen, z.B. den Bereich der Einträge oder das Format der Ausgabe. Sie müssen vom in Frage kommenden Parser-Skript unterstützt werden. Lesen Sie auch B<WARNUNGEN>.

note: type: TP
en: B<--format>I< output-format>
de: B<--format>I< Ausgabeformat>

note: type: Plain text
en: Set the output format. Currently supported values are I<dpkg> and I<rfc822>.  I<dpkg> is the classic output format (from before this option existed) and the default. It consists of one paragraph in Debian control format (see B<deb-control>(5)). If more than one entry is requested, then most fields are taken from the most recent entry, except otherwise stated:
de: Setze das Ausgabeformat. Derzeit werden die Werte I<dpkg> und I<rfc822> unterstützt. I<dpkg> ist das klassische Ausgabeformat (es existiert länger als diese Option), das voreingestellt ist. Es besteht aus einem Absatz im Debian-Steuerformat (lesen Sie B<deb-control>(5)). Falls mehr als ein Eintrag angefordert wird, dann werden die meisten Felder aus dem neusten Eintrag verwendet, falls dies nicht anders angegeben wird:

note: type: TP
en: B<Source:>I< pkg-name>
de: B<Source:>I< Paketname>

note: type: TP
en: B<Version:>I< version>
de: B<Version:>I< Version>

note: type: TP
en: B<Distribution:>I< target-distribution>
de: B<Distribution:>I< Ziel-Distribution>

note: type: TP
en: B<Urgency:>I< urgency>
de: B<Urgency:>I< Dringlichkeit>

note: type: Plain text
en: The highest urgency of all included entries is used, followed by the concatenated (space-separated) comments from all the versions requested.
de: Die höchste Dringlichkeit aller enthaltenen Einträge wird verwandt, gefolgt von den zusammengefügten (durch Leerzeichen getrennten) Kommentaren von allen angeforderten Versionen.

note: type: TP
en: B<Maintainer:>I< author>
de: B<Maintainer:>I< Autor>

note: type: TP
en: B<Date:>I< date>
de: B<Date:>I< Datum>

note: type: TP
en: B<Closes:>I< bug-number>
de: B<Closes:>I< Fehlernummer>

note: type: Plain text
en: The Closes fields of all included entries are merged.
de: Die Felder »Closes« aller enthaltenen Einträge werden zusammengefasst.

note: type: TP
en: B<Changes:>I< changelog-entries>
de: B<Changes:>I< Changelog-Einträge>

note: type: Plain text
en: The text of all changelog entries is concatenated. To make this field a valid Debian control format multiline field empty lines are replaced with a single full stop and all lines is intended by one space character. The exact content depends on the changelog format.
de: Der Text aller Changelog-Einträge wird aneinandergehängt. Um aus diesem Feld ein gültiges mehrzeiliges Feld im Debian Steuer-Format zu bekomen, werden leere Zeilen mit einem einzelnen Satzpunkt ersetzt und alle Zeilen durch ein Leerzeichen eingerückt. Der genaue Inhalt hängt vom Changelog-Format ab.

note: type: Plain text
en: The B<Version>, B<Distribution>, B<Urgency>, B<Maintainer> and B<Changes> fields are mandatory.
de: Die Felder B<Version>, B<Distribution>, B<Urgency>, B<Maintainer> und B<Changes> sind verpflichtend.

note: type: Plain text
en: There might be additional user-defined fields present.
de: Es können zusätzliche benutzerdefinierte Felder vorhanden sein.

note: type: Plain text
en: The B<rfc822> format uses the same fields but outputs a separate paragraph for each changelog entry so that all metadata for each entry is preserved.
de: Das B<rfc822>-Format verwendet die gleichen Felder, gibt aber einzelne Absätze für jeden Changelog-Eintrag aus, so dass alle Metadaten für jeden Eintrag erhalten bleiben.

note: type: TP
en: B<--since> I<version>, B<-s>I<version>,B< -v>I<version>
de: B<--since> I<Version>, B<-s>I<Version>,B< -v>I<Version>

note: type: Plain text
en: include all changes later than I<version>.
de: füge alle Änderungen neuer als aus I<Version> hinzu.

note: type: TP
en: B<--until> I<version>, B<-u>I<version>
de: B<--until> I<Version>, B<-u>I<Version>

note: type: Plain text
en: include all changes earlier than I<version>.
de: füge alle Änderungen älter als aus I<Version> hinzu.

note: type: TP
en: B<--from> I<version>, B<-f>I<version>
de: B<--from> I<Version>, B<-f>I<Version>

note: type: Plain text
en: include all changes equal or later than I<version>.
de: füge alle Änderungen aus oder neuer als aus I<Version> hinzu.

note: type: TP
en: B<--to> I<version>, B<-t>I<version>
de: B<--to> I<Version>, B<-t>I<Version>

note: type: Plain text
en: include all changes up to or equal than I<version>.
de: füge alle Änderungen aus oder älter als aus I<Version> hinzu.

note: type: TP
en: B<--count> I<number>, B<-c>I<number>, B<-n>I<number>
de: B<--count> I<Anzahl>, B<-c>I<Anzahl>, B<-n>I<Anzahl>

note: type: Plain text
en: include I<number> entries from the top (or the tail if I<number> is lower than 0).
de: füge I<Anzahl> Einträge vom Kopf (oder vom Fuß, falls I<Anzahl> negativ ist) hinzu.

note: type: TP
en: B<--offset> I<number>, B<-o>I<number>
de: B<--offset> I<Zahl>, B<-o>I<Zahl>

note: type: Plain text
en: change the starting point for --count, counted from the top (or the tail if I<number> is lower than 0).
de: ändere den Startpunkt für --count, gezählt vom Kopf (oder Fuß falls, falls I<Zahl> negativ ist).

note: type: Plain text
en: include all changes. Note: other options have no effect when this is in use.
de: alle Änderungen aufnehmen. Hinweis: Andere Optionen haben keine Wirkung, wenn diese verwandt wird.

note: type: SH
en: CHANGELOG FORMATS
de: CHANGELOG-FORMATE

note: type: Plain text
en: It is possible to use a different format to the standard one, by providing a parser for that alternative format.
de: Es ist möglich, ein anderes als das Standardformat zu verwenden, indem ein Parser für dieses alternative Format bereitgestellt wird.

note: type: Plain text
en: In order to have B<dpkg-parsechangelog> run the new parser, a line must be included within the last 40 lines of the changelog file, matching the Perl regular expression: \(lqB<\eschangelog-format:\es+([0-9a-z]+)\eW>\(rq.  The part in parentheses should be the name of the format. For example:
de: Damit B<dpkg-parsechangelog> den neuen Parser ausführen kann, muss eine Zeile innerhalb der letzten 40 Zeilen der Changelog-Datei enthalten sein, die auf den folgenden regulären Perl-Ausdruck passt: \(lqB<\eschangelog-format:\es+([0-9a-z]+)\eW>\(rq. Der Anteil in Klammern sollte der Name des Formats sein, beispielsweise:

note: type: Plain text
en:        @@@ changelog-format: I<otherformat> @@@
de:        @@@ changelog-format: I<Anderesformat> @@@

note: type: Plain text
en: Changelog format names are non-empty strings of alphanumerics.
de: Changelog-Formatnamen sind nichtleere alphanumerische Zeichenketten.

note: type: Plain text
en: If such a line exists then B<dpkg-parsechangelog> will look for the parser as B</usr/lib/dpkg/parsechangelog/>I<otherformat> or B</usr/local/lib/dpkg/parsechangelog/>I<otherformat>; it is an error for it not being present or not being an executable program.  The default changelog format is B<debian>, and a parser for it is provided by default.
de: Falls eine solche Zeile existiert, wird B<dpkg-parsechangelog> nach dem Parser als B</usr/lib/dpkg/parsechangelog/>I<Anderesformat> oder B</usr/local/lib/dpkg/parsechangelog/>I<Anderesformat> suchen. Es ist ein Fehler, wenn dieser nicht vorhanden oder kein ausführbares Programm ist. Das Standard-Änderungsprotokollformat ist B<debian>, hierfür wird standardmäßig ein Parser bereitgestellt.

note: type: Plain text
en: The parser will be invoked with the changelog open on standard input at the start of the file. It should read the file (it may seek if it wishes)  to determine the information required and return the parsed information to standard output in the format specified by the B<--format> option.  It should accept all B<Parser Options>.
de: Der Parser wird mit dem Änderungsprotokoll auf der Standardeingabe am Anfang der Datei aufgerufen. Er sollte die Datei lesen (er darf dafür suchen, falls gewünscht), um die benötigten Informationen zu ermitteln und die ausgewerteten Informationen auf der Standardausgabe in dem durch die Option B<--format> angegebenen Format auszugeben. Er sollte alle B<Parser-Optionen> akzeptieren.

note: type: Plain text
en: If the changelog format which is being parsed always or almost always leaves a blank line between individual change notes, these blank lines should be stripped out, so as to make the resulting output compact.
de: Falls das geparste Changelog-Format immer oder fast immer eine Leerzeile zwischen einzelnen Änderungsnotizen lässt, sollten diese Leerzeilen herausgefiltert werden, so dass die entstehende Ausgabe kompakt wird.

note: type: Plain text
en: If the changelog format does not contain date or package name information this information should be omitted from the output. The parser should not attempt to synthesize it or find it from other sources.
de: Falls das Changelog-Format kein Datum oder keine Paketnamensinformationen enthält, sollte diese Information in der Ausgabe unterbleiben. Der Parser soll nicht versuchen, diese Daten künstlich zu ermitteln oder sie in anderen Quellen zu finden.

note: type: Plain text
en: If the changelog does not have the expected format the parser should exit with a nonzero exit status, rather than trying to muddle through and possibly generating incorrect output.
de: Falls das Änderungsprotokoll nicht das erwartete Format hat, sollte sich der Parser mit einem von Null verschiedenen Exit-Status beenden, statt zu versuchen, sich irgendwie durchzuwurschteln und möglicherweise eine falsche Ausgabe zu erzeugen.

note: type: Plain text
en: A changelog parser may not interact with the user at all.
de: Ein Changelog-Parser darf nicht mit dem Nutzer interagieren.

note: type: Plain text
en: All B<Parser Options> except for -v are only supported in B<dpkg>, version 1.14.16 and later. Third party parsers for changelog formats other than I<debian> might not support all options.
de: Alle B<Parser-Optionen> außer -v werden nur von B<dpkg> Version 1.14.16 oder neuer unterstützt. Parser von Dritten für Changelog-Formate außer I<debian> könnten nicht alle Optionen unterstützen.

note: type: Plain text
en: The changelog file, used to obtain version-dependent information about the source package, such as the urgency and distribution of an upload, the changes made since a particular release, and the source version number itself.
de: Die changelog-Datei wird verwendet, um versionsabhängige Informationen über das Quellpaket, wie beispielsweise die Dringlichkeit (»urgency«) und die Distribution des Uploads, die Änderungen seit einer bestimmten Veröffentlichung und die Quellversionsnummer selbst zu erhalten.

note: type: Plain text
en: dpkg-query - a tool to query the dpkg database
de: dpkg-query - ein Werkzeug, um die dpkg-Datenbank abzufragen

note: type: Plain text
en: B<dpkg-query> [I<option>...] I<command>
de: B<dpkg-query> [I<Option> …] I<Befehl>

note: type: Plain text
en: B<dpkg-query> is a tool to show information about packages listed in the B<dpkg> database.
de: B<dpkg-query> ist ein Werkzeug, um Informationen über Pakete zu zeigen, die in der B<dpkg>-Datenbank aufgeführt sind.

note: type: TP
en: B<-l>, B<--list> [I<package-name-pattern>...]
de: B<-l>, B<--list> [I<Paketname-Muster> …]

note: type: Plain text
en: List packages matching given pattern. If no I<package-name-pattern> is given, list all packages in I</var/lib/dpkg/status>, excluding the ones marked as not-installed (i.e. those which have been previously purged). Normal shell wildchars are allowed in I<package-name-pattern>. Please note you will probably have to quote I<package-name-pattern> to prevent the shell from performing filename expansion. For example this will list all package names starting with ``libc6'':
de: Liste Pakete auf, deren Namen auf ein bestimmtes Muster passt. Falls kein I<Paketname-Muster> angegeben ist, liste alle Pakete in I</var/lib/dpkg/status> auf. Dabei werden alle Pakete ausgeschlossen, die als »nicht-installiert markiert sind (d.h. früher endgültig entfernt wurden). Beachten Sie, dass Sie wahrscheinlich I<Paketname-Muster> durch Anführungszeichen schützen müssen, um die Shell an der Dateinamen-Expansion zu hindern. Folgender Befehl listet beispielsweise alle Paketnamen, die mit »libc6« beginnen, auf:

note: type: Plain text
en: The first three columns of the output show the desired action, the package status, and errors, in that order.
de: Die ersten drei Spalten der Ausgabe zeigen die gewünschte Aktion, den Paketstatus und Fehler, in dieser Reihenfolge.

note: type: Plain text
en: Desired action:
de: Gewünschte Aktion:

note: type: Plain text
en:   u = Unknown
      i = Install
      h = Hold
      r = Remove
      p = Purge
de:   u = Unbekannt
      i = Installieren
      h = Halten
      r = Entfernen
      p = Vollständig Löschen

note: type: Plain text
en: Package status:
de: Paketstatus:

note: type: Plain text
en:   n = Not-installed
      c = Config-files
      H = Half-installed
      U = Unpacked
      F = Half-configured
      W = Triggers-awaiting
      t = Triggers-pending
      i = Installed
de:   n = Nicht installiert
      c = Config-Datei
      H = Halb installiert
      U = Entpackt
      F = Fehlgeschl. Konfiguration
      W = Trigger erWartet
      t = Trigger anhängig
      i = Installiert

note: type: Plain text
en: Error flags:
de: Fehler-Schalter:

note: type: Plain text
en:   E<lt>emptyE<gt> = (none)
      R = Reinst-required
de:   E<lt>leerE<gt> = (kein)
      R = Neuinstallation notwendig

note: type: Plain text
en: An uppercase status or error letter indicates the package is likely to cause severe problems. Please refer to B<dpkg>(1) for information about the above states and flags.
de: Ein Großbuchstabe als Status oder Fehler zeigt an, dass das Paket wahrscheinlich schwere Fehler verursachen wird. Bitte lesen Sie B<dpkg>(1) über die oben genannten Zustände und Schalter.

note: type: Plain text
en: The output format of this option is not configurable, but varies automatically to fit the terminal width. It is intended for human readers, and is not easily machine-readable. See B<-W> (B<--show>)  and B<--showformat> for a way to configure the output format.
de: Das Ausgabeformat dieser Option kann nicht konfiguriert werden, variiert aber automatisch mit der Terminalbreite. Die Ausgabe ist für menschliche Leser gedacht und nicht leicht maschinenlesbar. Lesen Sie über die Optionen B<-W> (B<--show>) und B<--showformat>, um das Ausgabeformat zu konfigurieren.

note: type: TP
en: B<-W>, B<--show> [I<package-name-pattern>...]
de: B<-W>, B<--show> [I<Paketname-Muster> …]

note: type: Plain text
en: Just like the B<--list> option this will list all packages matching the given pattern. However the output can be customized using the B<--showformat> option.  The default output format gives one line per matching package, each line having the name (extended with the architecture qualifier for I<Multi-Arch> B<same> packages) and installed version of the package, separated by a tab.
de: Genau wie die B<--list>-Option wird dies alle Pakete, die auf das angegebene Muster passen, aufführen. Allerdings kann die Ausgabe mit der B<--showformat>-Option angepasst werden. Im Standardausgabeformat wird eine Zeile pro passendem Paket ausgegeben, wobei in jeder Zeile Name (erweitert mit dem Architektur-Kennzeichner für I<Multi-Arch>-B<same>-Pakete) und installierte Version des Pakets getrennt durch einen Tabulator enthalten sind.

note: type: TP
en: B<-s>, B<--status> I<package-name>...
de: B<-s>, B<--status> I<Paketname> …

note: type: Plain text
en: Report status of specified package. This just displays the entry in the installed package status database. When multiple I<package-name> are listed, the requested status entries are separated by an empty line, with the same order as specified on the argument list.
de: Berichte Zustand des angegebenen Paketes. Dies zeigt nur den Eintrag in der Datenbank der Zustände der installierten Pakete. Wenn mehrere I<Paketname> aufgeführt sind, werden die angeforderten Statuseinträge durch Leerzeilen getrennt, wobei die Reihenfolge identisch zu der in der Argumentenliste ist.

note: type: TP
en: B<-L>, B<--listfiles> I<package-name>...
de: B<-L>, B<--listfiles> I<Paketname> …

note: type: Plain text
en: List files installed to your system from I<package-name>. When multiple I<package-name> are listed, the requested lists of files are separated by an empty line, with the same order as specified on the argument list.  However, note that files created by package-specific installation-scripts are not listed.
de: Aufführen von Dateien, die durch I<Paketname> installiert wurden. Wenn mehrere I<Paketname> aufgeführt sind, werden die angeforderten Dateilisten durch Leerzeilen getrennt, wobei die Reihenfolge identisch zu der in der Argumentenliste ist. Beachten Sie aber, dass Dateien, die durch Paket-spezifische Installationsskripte angelegt wurden, nicht aufgeführt werden.

note: type: TP
en: B<--control-list> I<package-name>
de: B<--control-list> I<Paketname>

note: type: Plain text
en: List control files installed to your system from I<package-name>.  These can be used as input arguments to B<--control-show>.
de: Aufführen von Steuerdateien, die auf Ihrem System von I<Paketname> installiert wurden. Diese können als Eingabeargumente für B<--control-show> verwandt werden.

note: type: TP
en: B<--control-show> I<package-name> I<control-file>
de: B<--control-show> I<Paketname> I<Steuerdatei>

note: type: Plain text
en: Print the I<control-file> installed to your system from I<package-name> to the standard output.
de: Die I<Steuerdatei>, die auf Ihrem System von I<Paketname> installiert wurde, auf der Standardausgabe ausgeben.

note: type: TP
en: B<-c>, B<--control-path> I<package-name> [I<control-file>]
de: B<-c>, B<--control-path> I<Paketname> [I<Steuerdatei>]

note: type: Plain text
en: List paths for control files installed to your system from I<package-name>.  If I<control-file> is specified then only list the path for that control file if it is present. B<Warning>: this command is deprecated, please switch to use B<--control-list> and B<--control-show> instead.
de: Listet die Pfade für Steuerdateien auf, die von I<Paketname> auf Ihrem System installiert wurden. Falls I<Steuerdatei> angegeben wurde, liste nur den Pfad für diese Steuerdatei auf, falls sie existiert. B<Warnung:>: Dieser Befehl ist veraltet, bitte verwenden Sie stattdessen B<--control-list> und B<--control-show>.

note: type: TP
en: B<-S>, B<--search> I<filename-search-pattern>...
de: B<-S>, B<--search> I<Dateiname-Suchmuster> …

note: type: Plain text
en: Search for packages that own files corresponding to the given pattern.  Standard shell wildchars can be used in the pattern.  This command will not list extra files created by maintainer scripts, nor will it list alternatives.
de: Suche nach Paketen, denen Paketen, die auf ein bestimmtes Muster passen, gehören. Die normalen Jokerzeichen (»wildcards«) der Shell können in diesem Muster verwandt werden. Dieser Befehl wird weder die zusätzlichen Dateien, die durch Betreuer-Skripte angelegt wurden, noch Alternativen aufführen.

note: type: TP
en: B<-p>, B<--print-avail> I<package-name>...
de: B<-p>, B<--print-avail> I<Paketname> …

note: type: Plain text
en: Display details about I<package-name>, as found in I</var/lib/dpkg/available>. When multiple I<package-name> are listed, the requested I<available> entries are separated by an empty line, with the same order as specified on the argument list.
de: Zeige Details über I<Paketname> an, wie diese in I</var/lib/dpkg/available> vorliegen. Wenn mehrere I<Paketname> aufgeführt sind, werden die angeforderten I<available>-Einträge durch Leerzeilen getrennt, wobei die Reihenfolge identisch zu der in der Argumentenliste ist.

note: type: Plain text
en: Users of APT-based frontends should use B<apt-cache show> I<package-name> instead as the I<available> file is only kept up-to-date when using B<dselect>.
de: Benutzer APT-basierter Oberflächen sollten B<apt-cache show> I<Paketname> verwenden, da die Datei I<available> nur bei der Benutzung von B<dselect> aktuell bleibt.

note: type: Plain text
en: Also load the available file when using the B<--show> and B<--list> commands, which now default to only querying the status file.
de: Auch die »available«-Datei laden, wenn die Befehle B<--show> und B<--list> verwandt werden, die jetzt standardmnäßig nur die Statusdatei laden.

note: type: TP
en: B<-f>, B<--showformat=>I<format>
de: B<-f>, B<--showformat=>I<Format>

note: type: Plain text
en: In the format string, \(lqB<\e>\(rq introduces escapes:
de: In der Formatzeichenkette leitet \(lqB<\e>\(rq Escape-Sequenzen ein:

note: type: Plain text
en:     B<\en>  newline
        B<\er>  carriage return
        B<\et>  tab
de:     B<\en>  Zeilenumbruch
        B<\er>  Wagenrücklauf
        B<\et>  Tabulator

note: type: Plain text
en: \(lqB<\e>\(rq before any other character suppresses any special meaning of the following character, which is useful for \(lqB<\e>\(rq and \(lqB<$>\(rq.
de: \(lqB<\e>\(rq vor einem anderen Zeichen unterdrückt jede spezielle Bedeutung des folgenden Zeichens. Dies ist für \(lqB<\e>\(rq und \(lqB<$>\(rq nützlich.

note: type: Plain text
en: Package information can be included by inserting variable references to package fields using the syntax \(lqB<${>I<field>[B<;>I<width>]B<}>\(rq. Fields are printed right-aligned unless the width is negative in which case left alignment will be used. The following I<field>s are recognized but they are not necessarily available in the status file (only internal fields or fields stored in the binary package end up in it):
de: Paketinformationen können einbezogen werden, indem Variablenreferenzen auf Paketfelder eingefügt werden. Hierbei wird folgende Syntax verwendet: \(lqB<${>I<Feld>[B<;>I<Breite>]B<}>\(rq. Felder werden rechtsbündig ausgegeben, falls die Breite nicht negativ ist und somit linksbündige Ausgabe erfolgt. Die folgenden I<Feld>er werden verstanden, sind aber nicht notwendigerweise in der Status-Datei verfügbar (nur interne Felder oder Felder, die im Binärpaket abgespeichert sind, landen dort):

note: type: Plain text
en:     B<Architecture>
        B<Bugs>
        B<Conffiles> (internal)
        B<Config-Version> (internal)
        B<Conflicts>
        B<Breaks>
        B<Depends>
        B<Description>
        B<Enhances>
        B<Essential>
        B<Filename> (internal, front-end related)
        B<Homepage>
        B<Installed-Size>
        B<MD5sum> (internal, front-end related)
        B<MSDOS-Filename> (internal, front-end related)
        B<Maintainer>
        B<Origin>
        B<Package>
        B<Pre-Depends>
        B<Priority>
        B<Provides>
        B<Recommends>
        B<Replaces>
        B<Revision> (obsolete)
        B<Section>
        B<Size> (internal, front-end related)
        B<Source>
        B<Status> (internal)
        B<Suggests>
        B<Tag> (usually not in .deb but in repository Packages files)
        B<Triggers-Awaited> (internal)
        B<Triggers-Pending> (internal)
        B<Version>
de:     B<Architecture>
        B<Bugs>
        B<Conffiles> (intern)
        B<Config-Version> (intern)
        B<Conflicts>
        B<Breaks>
        B<Depends>
        B<Description>
        B<Enhances>
        B<Essential>
        B<Filename> (intern, Oberflächen-bezogen)
        B<Homepage>
        B<Installed-Size>
        B<MD5sum> (intern, Oberflächen-bezogen)
        B<MSDOS-Filename> (intern, Oberflächen-bezogen)
        B<Maintainer>
        B<Origin>
        B<Package>
        B<Pre-Depends>
        B<Priority>
        B<Provides>
        B<Recommends>
        B<Replaces>
        B<Revision> (veraltet)
        B<Section>
        B<Size> (intern, Oberflächen-bezogen)
        B<Source>
        B<Status> (intern)
        B<Suggests>
        B<Tag> (normalerweise nicht im .deb sondern in Packages-Dateien des Depots)
        B<Triggers-Awaited> (intern)
        B<Triggers-Pending> (intern)
        B<Version>
        B<show:Summary> (virtuell)
        B<show:Status-Abbrev> (virtuell)

note: type: Plain text
en: The following are virtual fields, generated by B<dpkg-query> from values from other fields (note that these do not use valid names for fields in control files):
de: Die folgenden Felder sind virtuell, sie werden von B<dpkg-query> aus Werten aus anderen Feldern erstellt (beachten Sie, dass diese keine gültigen Namen für Felder in Steuerdateien benutzen):

note: type: Plain text
en: The default format string is \(lqB<${binary:Package}\et${Version}\en>\(rq.  Actually, all other fields found in the status file (i.e. user defined fields) can be requested, too. They will be printed as-is, though, no conversion nor error checking is done on them. B<binary:Package> is a special field that will print the package name with an architecture qualifier (like "libc6:amd64") if the package has a I<Multi-Arch> field with a value of B<same>, and as such its name could be ambiguous.  To get the name of the dpkg maintainer and the installed version, you could run:
de: Die Standard-Formatzeichenkette ist \(lqB<${binary:Package}\et${Version}\en>\(rq. Tatsächlich können auch alle anderen Felder, die in der Statusdatei gefunden werden können (d.h. benutzerdefinierte Felder), abgefragt werden. Sie werden so dargestellt, wie sie gefunden werden, es erfolgt keine Umwandlung oder Fehlerüberprüfung. B<binary:Package> ist ein besonderes Feld, das den Paketnamen mit einem Architektur-Kennzeichner (wie »libc6:amd64«) ausgibt, falls das Paket ein Feld I<Multi-Arch> mit dem Wert B<same> trägt und daher der Name mehrdeutig sein könnte. Um den Namen des Dpkg-Betreuers und die installierte Version zu erhalten, könnten Sie folgendes ausführen:

note: type: SH
en: EXIT STATUS
de: RÜCKGABEWERT

note: type: Plain text
en: The requested query was successfully performed.
de: Die angeforderte Abfrage wurde erfolgreich ausgeführt.

note: type: Plain text
en: Problems were encountered while parsing the command line or performing the query, including no file or package being found (except for --control-path).
de: Beim Lesen der Kommandozeile oder beim Ausführen der Abfrage traten Probleme auf. Dazu gehören auch keine Datei oder Paket gefunden (außer für --control-path).

note: type: Plain text
en: This setting influences the output of the B<--list> option by changing the width of its output.
de: Diese Einstellung beeinflusst die Ausgabe der B<--list>-Option durch Verändern der Breite ihrer Ausgabe.

note: type: Plain text
en: dpkg-scanpackages - create Packages index files
de: dpkg-scanpackages - erstelle Packages-Index-Dateien

note: type: Plain text
en: B<dpkg-scanpackages> [I<option>...] I<binary-dir> [I<override-file> [I<path-prefix>]] B<E<gt>> I<Packages>
de: B<dpkg-scanpackages> [I<Option> …] I<Binär-Verz> [I<override-Datei> [I<Pfad-Präfix>]] B<E<gt>> I<Pakete>

note: type: Plain text
en: B<dpkg-scanpackages> sorts through a tree of Debian binary packages and creates a Packages file, used by B<apt>(8), B<dselect>(1), etc, to tell the user what packages are available for installation. These Packages files are the same as those found on Debian archive sites and CD-ROMs. You might use B<dpkg-scanpackages> yourself if making a directory of local packages to install on a cluster of machines.
de: B<dpkg-scanpackages> schaut durch einen Baum von Debian-Binärpaketen und erstellt eine Packages-Datei, die von B<apt>(8), B<dselect>(1) usw. verwendet wird, um dem Benutzer zu erzählen, welche Pakete zur Installation verfügbar sind. Diese Packages-Dateien sind die gleichen, die auch auf den Debian-Archiv-Sites und CD-ROMs vorliegen. Sie können selbst B<dpkg-scanpackages> verwenden, falls Sie ein Verzeichnis von lokalen Paketen zur Installation auf einem Cluster von Maschinen anlegen.

note: type: Plain text
en: B<Note:> If you want to access the generated Packages file with B<apt> you will probably need to compress the file with B<bzip2>(1)  (generating a Packages.bz2 file) or B<gzip>(1)  (generating a Packages.gz file). apt ignores uncompressed Packages files except on local access (i.e.  B<file://> sources).
de: B<Hinweis:> Falls Sie auf die erzeugte Packages-Datei mit B<apt> zugreifen wollen, werden Sie wahrscheinlich die Datei mit B<bzip2>(1) komprimieren müssen (und damit ein Packages.bz2-Datei erstellen). Apt ignoriert - abgesehen von lokalem Zugriff (d.h. über B<file://>-Quellen) - unkomprimierte Packages-Dateien.

note: type: Plain text
en: I<binary-dir> is the name of the tree of the binary packages to process (for example, B<contrib/binary-i386>).  It is best to make this relative to the root of the Debian archive, because every Filename field in the new Packages file will start with this string.
de: I<Binär-Verz> ist der Name des zu verarbeitenden Baums von Binärpaketen (beispielsweise B<contrib/binary-i386>). Am besten wird dies relativ zur Wurzel des Debian-Archivs erstellt, da jedes Filename-Feld in der neuen Packages-Datei mit dieser Zeichenkette beginnen wird.

note: type: Plain text
en: I<override-file> is the name of a file to read which contains information about how the package fits into the distribution (it can be a compressed file); see B<deb-override>(5).
de: I<override-Datei> ist der Name einer einzulesenden Datei, die Informationen darüber enthält, wie das Paket in die Distribution passt (sie kann eine komprimierte Datei sein); siehe B<deb-override>(5).

note: type: Plain text
en: I<path-prefix> is an optional string to be prepended to the Filename fields.
de: I<Pfad-Präfix> ist eine optionale Zeichenkette, die vor das Dateinamenfeld gehängt werden soll.

note: type: Plain text
en: If more than one version of a package is found only the newest one is included in the output. If they have the same version and only differ in architecture only the first one found is used.
de: Falls mehr als eine Version eines Paketes gefunden wird, wird nur das neuste in die Ausgabe aufgenommen. Falls sie die gleiche Version haben und sich nur in der Architektur unterscheiden, wird das zuerst gefundene verwendet.

note: type: TP
en: B<-t>, B<--type> I<type>
de: B<-t>, B<--type> I<Typ>

note: type: Plain text
en: Scan for *.I<type> packages, instead of *.deb.
de: Suche nach *.I<Typ> statt *.deb-Paketen.

note: type: IP
en: B<-e>, B<--extra-override> I<file>
de: B<-e>, B<--extra-override> I<Datei>

note: type: Plain text
en: Scan I<file> to find supplementary overrides (the file can be compressed). See B<deb-extra-override>(5)  for more information on its format.
de: Durchsuche I<Datei>, um zusätzliche Overrides zu finden (die Datei kann komprimiert sein). Lesen Sie B<deb-extra-override>(5) für weitere Informationen über deren Format.

note: type: Plain text
en: Use a pattern consisting of I<*_all.deb> and I<*_arch.deb> instead of scanning for all debs.
de: Verwende ein Muster, das aus I<*_all.deb> und I<*_arch.deb> besteht, statt nach allen Debs zu suchen.

note: type: Plain text
en: Include all found packages in the output.
de: Nimm alle gefundenen Pakete in der Ausgabe auf.

note: type: TP
en: B<-M>, B<--medium> I<id-string>
de: B<-M>, B<--medium> I<ID-Zeichenkette>

note: type: Plain text
en: Add an X-Medium field containing the value I<id-string>. This field is required if you want to generate B<Packages.cd> files for use by the multicd access method of dselect.
de: Füge ein Feld X-Medium hinzu, das den Wert von I<ID-Zeichenkette> enthält. Dieses Feld wird benötigt, falls Sie die Dateien B<Packages.cd> für den Einsatz mit der Multicd-Zugriffsmethode von Dselect erstellen wollen.

note: type: SH
en: DIAGNOSTICS
de: DIAGNOSE

note: type: Plain text
en: B<dpkg-scanpackages> outputs the usual self-explanatory errors. It also warns about packages that are in the wrong subdirectory, are duplicated, have a Filename field in their control file, are missing from the override file, or have maintainer substitutions which do not take effect.
de: B<dpkg-scanpackages> gibt die gewöhnlichen selbsterklärenden Fehler aus. Es warnt auch über Pakete, die im falschen Unterverzeichnis sind, doppelt vorkommen, ein Filename-Feld in ihrer Steuerdatei haben, in der Override-Datei fehlen oder für die Betreuer-Substitutionen vorliegen, die keinen Effekt haben.

note: type: Plain text
en: dpkg-scansources - create Sources index files
de: dpkg-scanpackages - erstelle Quell-Index-Dateien

note: type: Plain text
en: B<dpkg-scansources> [I<option>...] I<binary-dir> [I<override-file> [I<path-prefix>]] B<E<gt>> I<Sources>
de: B<dpkg-scansources> [I<Option> …] I<Binär-Verz> [I<override-Datei> [I<Pfad-Prefix>]] B<E<gt>> I<Sources>

note: type: Plain text
en: B<dpkg-scansources> scans the given I<binary-dir> for I<.dsc> files.  These are used to create a Debian source index, which is output to stdout.
de: B<dpkg-scansources> durchsucht das übergebene I<Binär-Verz> nach I<.dsc>-Dateien. Diese werden verwendet, um einen Debian-Quell-Index zu erstellen, der auf der Standardausgabe ausgegeben wird.

note: type: Plain text
en: The I<override-file>, if given, is used to set priorities in the resulting index records and to override the maintainer field given in the I<.dsc> files. The file can be compressed. See B<deb-override>(5)  for the format of this file. \s-1NB:\s0 Since the override file is indexed by binary, not source, packages, there's a bit of a problem here. The current implementation uses the highest priority of all the binary packages produced by a I<.dsc> file for the priority of the source package, and the override entry for the first binary package listed in the I<.dsc> file to modify maintainer information. This might change.
de: Die I<override-Datei> wird, falls angegeben, verwendet, um die Prioritäten in den ergebenen Index-Datensätzen zu setzen und sich über das Betreuer-Feld in den I<.dsc>-Dateien hinwegzusetzen. Diese Datei kann komprimiert sein. Lesen Sie B<dpkg-scanpackages>(1) für das Format dieser Datei. \s-1Beachten Sie\s0: Da die override-Datei nach Binär- und nicht Quellpaketen indiziert wird, gibt es hier ein kleines Problem. Die aktuelle Implementierung verwendet die höchste Priorität aller von einer I<.dsc>-Datei erzeugten Binärpakete für die Priorität des Quellpakets, und den Inhalt für das Hinwegsetzen über die Betreuer-Information aus dem Eintrag für das erste in der I<.dsc>-Datei aufgeführte Binärpaket. Dies könnte sich ändern.

note: type: Plain text
en: The I<path-prefix>, if given, is prepended to the directory field in the generated source index. You generally use this to make the directory fields contain the path from the top of the Debian archive hierarchy.
de: Der I<Pfad-Präfix> wird, falls angegeben, vor das Directory-Feld in dem erzeugten Quell-Index vorangestellt. Sie verwenden dies im Allgemeinen, damit das Directory-Feld den Pfad von der Spitze der Debian-Hierarchie enthält.

note: type: Plain text
en: B<Note:> If you want to access the generated Sources file with B<apt>(8)  you will probably need to compress the file with B<gzip>(1)  (generating a Sources.gz file). apt ignores uncompressed Sources files except on local access (i.e.  B<file://> sources).
de: B<Hinweis:> Falls Sie auf die erzeugte Sources-Datei mit B<apt>(8) zugreifen wollen, werden Sie wahrscheinlich die Datei mit B<gzip>(1) komprimieren müssen (und damit ein Sources.gz-Datei erstellen). Apt ignoriert - abgesehen von lokalem Zugriff (d.h. über B<file://>-Quellen) - unkomprimierte Sources-Dateien.

note: type: Plain text
en: Don't sort the index records. Normally they are sorted by source package name.
de: Sortiere die Index-Datensätze nicht. Normalerweise werden sie nach Quellpaketnamen sortiert.

note: type: IP
en: B<-s>, B<--source-override> I<file>
de: B<-s>, B<--source-override> I<Datei>

note: type: Plain text
en: Use I<file> as the source override file (the file can be compressed).  The default is the name of the override file you specified with I<.src> appended.
de: Verwenden Sie I<Datei> als Quell-override-Datei (die Datei kann komprimiert sein). Die Standardeinstellung ist der Name der override-Datei, die Sie angegeben haben, um I<.src> ergänzt.

note: type: Plain text
en: The source override file is in a different format from the binary override file. It contains only two whitespace separated fields, the first is the source package name and the second is the section. Blank lines and comment lines are ignored in the normal manner. If a package appears in both files the source override takes precedence for setting the section.
de: Die Quell-override-Datei hat ein anderes Format als die Binär-override-Datei.Sie enthält nur zwei, durch Leerzeichen separierte Felder, der erste ist der Quellpaketname und der zweite der Bereich. Leerzeilen und Kommentarzeilen werden in normaler Art und Weise ignoriert. Falls ein Paket in beiden Dateien auftaucht, dann nimmt die Quell-override Vorrang für die Einstellung des Bereichs.

note: type: Plain text
en: Turn debugging on.
de: Schalte Debugging ein.

note: type: Plain text
en: dpkg-shlibdeps - generate shared library substvar dependencies
de: dpkg-shlibdeps - erstelle Substvar-Abhängigkeiten für Laufzeitbibliotheken

note: type: Plain text
en: B<dpkg-shlibdeps> [I<option>...] [B<-e>]I<executable> [I<option>...]
de: B<dpkg-shlibdeps> [I<Option> …] [B<-e>]I<Programm> [I<Option> …]

note: type: Plain text
en: B<dpkg-shlibdeps> calculates shared library dependencies for executables named in its arguments. The dependencies are added to the substitution variables file B<debian/substvars> as variable names B<shlibs:>I<dependency-field> where I<dependency-field> is a dependency field name. Any other variables starting with B<shlibs:> are removed from the file.
de: B<dpkg-shlibdeps> berechnet Abhängigkeiten von Laufzeitbibliotheken für Programme, deren Name als Argument übergeben werden. Die Abhängigkeiten werden zu der Datei der Substitutionsvariablen B<debian/substvars> als Variablennamen B<shlibs:>I<Abhängigkeitsfeld> hinzugefügt, wobei I<Abhängigkeitsfeld> der Feldname einer Abhängigkeit ist. Alle anderen Variablen, die mit B<shlibs:> beginnen, werden aus der Datei entfernt.

note: type: Plain text
en: B<dpkg-shlibdeps> has two possible sources of information to generate dependency information. Either I<symbols> files or I<shlibs> files. For each binary that B<dpkg-shlibdeps> analyzes, it finds out the list of libraries that it's linked with.  Then, for each library, it looks up either the I<symbols> file, or the I<shlibs> file (if the former doesn't exist or if debian/shlibs.local contains the relevant dependency). Both files are supposed to be provided by the library package and should thus be available as /var/lib/dpkg/info/I<package>.I<symbols> or /var/lib/dpkg/info/I<package>.I<shlibs>. The package name is identified in two steps: find the library file on the system (looking in the same directories that B<ld.so> would use), then use B<dpkg -S >I<library-file> to lookup the package providing the library.
de: B<dpkg-shlibdeps> hat zwei mögliche Informationsquellen zur Erstellung der Abhängigkeitsinformationen. Entweder I<Symbol>- oder I<Shlibs>-Dateien. B<dpkg-shlibdeps> findet für jedes Programm, das es analysiert, die Bibliotheken heraus, gegen die es gelinkt ist. Bei jeder Bibliothek schaut es entweder in die I<Symbol>- oder in in I<Shlibs>-Datei (falls erstere nicht existiert odr falls debian/shlibs.local die relevanten Abhängigkeiten enthält). Beide Dateien sollten von dem Bibliothekspaket bereitgestellt werden und sollten daher als /var/lib/dpkg/info/I<Paket>.I<Symbol> oder /var/lib/dpkg/info/I<Paket>.I<Shlibs> verfügbar sein. Der Paketname wird in zwei Schritten identifiziert: zuerst wird die Bibliotheksdatei auf dem System gefunden (durch Prüfung der gleichen Verzeichnisse wie bei B<ld.so>), dann wird B<dpkg -S >I<Bibliotheksdatei> verwendet, um das Paket, das die Bibliothek bereitstellt, zu ermitteln.

note: type: SS
en: Symbols files
de: Symboldateien

note: type: Plain text
en: Symbols files contain finer-grained dependency information by providing the minimum dependency for each symbol that the library exports. The script tries to find a symbols file associated to a library package in the following places (first match is used):
de: Symboldateien enthalten feiner-granulare Abhängigkeitsinformationen, indem sie die Minimalabhängigkeit für jedes von der Bibliothek exportierte Symbol beschreiben. Das Skript versucht, eine Symboldatei die zu dem Bibliothekspaket gehört, an den folgenden Orten zuzuordnen (der erste Treffer wird verwendet):

note: type: Plain text
en: Shared library information generated by the current build process that also invoked B<dpkg-shlibdeps>.  They are generated by B<dpkg-gensymbols>(1).  They are only used if the library is found in a package's build tree. The symbols file in that build tree takes precedence over symbols files from other binary packages.
de: Informationen über Laufzeitbibliotheken, die vom aktuellen Bauprozess erstellt werden, der auch B<dpkg-shlibdeps> aufruft. Sie werden von B<dpkg-gensymbols>(1) erstellt. Sie werden nur verwendet, falls die Bibliothek im Bau-Baum des Pakets gefunden wird. Die Symboldatei im Bau-Baum hat Vorrang gegenüber Symboldateien aus anderen Binärpaketen.

note: type: IP
en: /etc/dpkg/symbols/I<package>.symbols.I<arch>
de: /etc/dpkg/symbols/I<Paket>.symbols.I<Architektur>

note: type: IP
en: /etc/dpkg/symbols/I<package>.symbols
de: /etc/dpkg/symbols/I<Paket>.symbols

note: type: Plain text
en: Per-system overriding shared library dependency information.  I<arch> is the architecture of the current system (obtained by B<dpkg-architecture -qDEB_HOST_ARCH>).
de: Systemabhängige Überschreibung der Abhängigkeitsinformationen von Laufzeitbibliotheken. I<Architektur> ist die Architektur des aktuellen Systems (ermittelt durch B<dpkg-architecture -qDEB_HOST_ARCH>).

note: type: IP
en: Output from \(lqB<dpkg-query --control-path> I<package> symbols\(rq
de: Ausgabe von \(lqB<dpkg-query --control-path> I<Paket> symbols\(rq

note: type: Plain text
en: Package-provided shared library dependency information.  Unless overridden by --admindir, those files are located in /var/lib/dpkg.
de: Vom Paket bereitgestellte Abhängigkeitsinformationen für Laufzeitbibliotheken. Falls nicht durch --admindir überschrieben, befinden sich solche Dateien unter /var/lib/dpkg.

note: type: Plain text
en: While scanning the symbols used by all binaries, B<dpkg-shlibdeps> remembers the (biggest) minimal version needed for each library. At the end of the process, it is able to write out the minimal dependency for every library used (provided that the information of the I<symbols> files are accurate).
de: Während des Durchsuchens aller vom Programm verwendeten Symbole erinnert sich B<dpkg-shlibdeps> an die größte Minimalversion, die von jeder Bibliothek benötigt wird. Am Ende des Prozesses ist es in der Lage, die minimale Abhängigkeit für jede eingesetzte Bibliothek zu schreiben (vorausgesetzt, die Informationen in den I<Symbol>-Dateien sind korrekt).

note: type: Plain text
en: As a safe-guard measure, a symbols file can provide a I<Build-Depends-Package> meta-information field and B<dpkg-shlibdeps> will extract the minimal version required by the corresponding package in the Build-Depends field and use this version if it's higher than the minimal version computed by scanning symbols.
de: Als Sicherheitsmaßnahme kann eine Symbols-Datei ein Meta-Informationsfeld I<Build-Depends-Package> enthalten. B<dpkg-shlibdeps> extrahiert dann die minimale Version, die von dem korrespondierenden Paket im Feld Build-Depends benötigt wird, und verwendet diese Version, falls sie höher ist als die minimale Version, die beim Durchsuchen der Symbole ermittelt wurde.

note: type: SS
en: Shlibs files
de: Shlibs-Dateien

note: type: Plain text
en: Shlibs files associate directly a library to a dependency (without looking at the symbols). It's thus often stronger than really needed but very safe and easy to handle.
de: Shlibs-Dateien ordnen Bibliotheken direkt Abhängigkeiten zu (ohne auf die Symbole zu schauen). Daher ist dies oft stärker als benötigt, aber dafür sicher und leicht zu handhaben.

note: type: Plain text
en: The dependencies for a library are looked up in several places. The first file providing information for the library of interest is used:
de: Die Abhängigkeiten für eine Bibliothek wird an verschiedenen Stellen nachgeschlagen. Die erste Datei, die Informationen für die betrachtete Bibliothek bereitstellt, wird verwendet:

note: type: Plain text
en: Package-local overriding shared library dependency information.
de: Paket-beschränkte Überschreibung der Abhängigkeitsinformationen von Laufzeitbibliotheken.

note: type: Plain text
en: Per-system overriding shared library dependency information.
de: Systemabhängige Überschreibung der Abhängigkeitsinformationen von Laufzeitbibliotheken.

note: type: Plain text
en: Shared library information generated by the current build process that also invoked B<dpkg-shlibdeps>.  They are only used if the library is found in a package's build tree. The shlibs file in that build tree takes precedence over shlibs files from other binary packages.
de: Informationen über Laufzeitbibliotheken, die vom aktuellen Bauprozess erstellt werden, der auch B<dpkg-shlibdeps> aufruft. Sie werden nur verwendet, falls die Bibliothek im Bau-Verzeichnis eines Pakets gefunden wird. Die Shlibs-Datei in diesem Bau-Verzeichnis hat gegenüber Shlibs-Dateien von anderen Binärpaketen Vorrang.

note: type: IP
en: Output from \(lqB<dpkg-query --control-path> I<package> shlibs\(rq
de: Ausgabe von \(lqB<dpkg-query --control-path> I<Paket> shlibs\(rq

note: type: Plain text
en: Per-system default shared library dependency information.
de: Systemabhängige Vorgaben für Abhängigkeitsinformationen von Laufzeitbibliotheken.

note: type: Plain text
en: The extracted dependencies are then directly used (except if they are filtered out because they have been identified as duplicate, or as weaker than another dependency).
de: Die extrahierten Abhängigkeiten werden direkt verwendet (es sei den, sie werden als Dubletten herausgefiltert oder sie sind schwächer als eine andere Abhängigkeit).

note: type: Plain text
en: B<dpkg-shlibdeps> interprets non-option arguments as executable names, just as if they'd been supplied as B<-e>I<executable>.
de: B<dpkg-shlibdeps> interpretiert nicht-Options-Argumente als Namen von ausführbaren Programmen, als ob diese mit B<-e>I<Programm> übergeben worden wären.

note: type: TP
en: B<-e>I<executable>
de: B<-e>I<Programm>

note: type: Plain text
en: Include dependencies appropriate for the shared libraries required by I<executable>.
de: Abhängigkeiten aufnehmen, die für von I<Programm> benötigte Laufzeitbibliotheken angemessen sind.

note: type: TP
en: B<-d>I<dependency-field>
de: B<-d>I<Abhängigkeitsfeld>

note: type: Plain text
en: Add dependencies to be added to the control file dependency field I<dependency-field>.  (The dependencies for this field are placed in the variable B<shlibs:>I<dependency-field>.)
de: Füge Abhängigkeiten hinzu, die zum Abhängigkeitsfeld I<Abhängigkeitsfeld> der Steuerdatei hinzugefügt werden sollen. (Die Abhängigkeiten für dieses Feld werden in die Variable B<shlibs:>I<Abhängigkeitsfeld> geschrieben.)

note: type: Plain text
en: The B<-d>I<dependency-field> option takes effect for all executables after the option, until the next B<-d>I<dependency-field>.  The default I<dependency-field> is B<Depends>.
de: Die Option B<-d>I<Abhängigkeitsfeld> betrifft alle Programme, die danach angegeben werden, bis zum nächsten B<-d>I<Abhängigkeitsfeld>. Der Standardwert für I<Abhängigkeitsfeld> ist B<Depends>.

note: type: Plain text
en: If the same dependency entry (or set of alternatives) appears in more than one of the recognized dependency field names B<Pre-Depends>, B<Depends>, B<Recommends>, B<Enhances> or B<Suggests> then B<dpkg-shlibdeps> will automatically remove the dependency from all fields except the one representing the most important dependencies.
de: Falls der gleiche Abhängigkeitseintrag (oder ein Satz von Alternativen) mehr als einmal in den erkannten Abhängigkeitsfeldnamen B<Pre-Depends>, B<Depends>, B<Recommends>, B<Enhances> oder B<Suggests> auftaucht, wird B<dpkg-shlibdeps> die Abhängigkeit von allen Feldern außer dem, das die wichtigsten Abhängigkeiten repräsentiert, entfernen.

note: type: TP
en: B<-p>I<varname-prefix>
de: B<-p>I<Variablennamepräfix>

note: type: Plain text
en: Start substitution variables with I<varname-prefix>B<:> instead of B<shlibs:>.  Likewise, any existing substitution variables starting with I<varname-prefix>B<:> (rather than B<shlibs:>)  are removed from the the substitution variables file.
de: Beginn die Substitutionsvariablen mit I<Variablennamepräfix>B<:> statt mit B<shlibs:>. Entsprechend werden alle Substitutionsvariablen, die mit I<Variablennamepräfix>B<:> (statt mit B<shlibs:>) beginnen, aus den Substitutionsvariablen entfernt.

note: type: Plain text
en: Print substitution variable settings to standard output, rather than being added to the substitution variables file (B<debian/substvars> by default).
de: Gebe die Variableneinstellung in die Standardausgabe aus, statt sie zu der Substitutionsvariablendatei (standardmäßig (B<debian/substvars>) hinzuzufügen.

note: type: TP
en: B<-t>I<type>
de: B<-t>I<Typ>

note: type: Plain text
en: Prefer shared library dependency information tagged for the given package type. If no tagged information is available, falls back to untagged information. The default package type is "deb". Shared library dependency information is tagged for a given type by prefixing it with the name of the type, a colon, and whitespace.
de: Bevorzuge Abhängigkeitsinformationen für Laufzeitbibliotheken, die für ein vorgegebenes Paket markiert sind. Falls keine Markierungsinformation verfügbar ist, fällt dies auf unmarkierte Informationen zurück. Der Standard-Pakettyp ist »deb«. Abhängigkeitsinformationen für Laufzeitbibliotheken werden für einen vorgegebenen Typ markiert, indem vor sie der Namen des Typs, ein Doppelpunkt und ein Leerzeichen gesetzt wird.

note: type: TP
en: B<-L>I<local-shlibs-file>
de: B<-L>I<lokale_shlibs-Datei>

note: type: Plain text
en: Read overriding shared library dependency information from I<local-shlibs-file> instead of B<debian/shlibs.local>.
de: Lese die Hinwegsetz-Abhängigkeiten von Laufzeitbibliotheken aus I<lokale_shlibs-Datei> statt aus B<debian/shlibs.local>.

note: type: Plain text
en: Write substitution variables in I<substvars-file>; the default is B<debian/substvars>.
de: Schreibe Substitutionsvariablen in I<Substvars-Datei>; standardmäßig B<debian/substvars>.

note: type: Plain text
en: Enable verbose mode. Numerous messages are displayed to explain what B<dpkg-shlibdeps> does.
de: Aktiviere ausführlichen Modus. Eine Vielzahl von Nachrichten wird angezeigt, um zu erklären, was B<dpkg-shlibdeps> durchführt.

note: type: TP
en: B<-x>I<package>
de: B<-x>I<Paket>

note: type: Plain text
en: Exclude the package from the generated dependencies. This is useful to avoid self-dependencies for packages which provide ELF binaries (executables or library plugins) using a library contained in the same package. This option can be used multiple times to exclude several packages.
de: Schließe das Paket von den generierten Abhängigkeiten aus. Dies ist für Pakete nützlich, die ELF-Programmdateien (Programme oder Bibliothekserweiterungen) bereitstellen, die eine Bibliothek im gleichen Paket verwenden, um selbst-Abhängigkeiten zu vermeiden. Diese Option kann mehrfach verwendet werden, um mehrere Pakete auszuschließen.

note: type: TP
en: B<-S>I<package-build-dir>
de: B<-S>I<Paketbauverzeichnis>

note: type: Plain text
en: Look into I<package-build-dir> first when trying to find a library. This is useful when the source package builds multiple flavors of the same library and you want to ensure that you get the dependency from a given binary package. You can use this option multiple times: directories will be tried in the same order before directories of other binary packages.
de: Schaue beim Versuch, eine Bibliothek zu finden, zuerst in I<Paketbauverzeichnis>. Dies ist nützlich, wenn das Quellpaket mehrere Spielarten der gleichen Bibliothek baut und Sie sicherstellen wollen, dass Sie die Abhängigkeit aus einem bestimmten Binärpaket erhalten. Sie können diese Option mehrfach verwenden: Verzeichnisse werden in der gleichen Reihenfolge vor Verzeichnissen anderer Binärpakete probiert.

note: type: Plain text
en: Do not fail if dependency information can't be found for a shared library.  Usage of this option is discouraged, all libraries should provide dependency information (either with shlibs files, or with symbols files)  even if they are not yet used by other packages.
de: Falls keine Abhängigkeitsinformationen für die Laufzeitbibliothek gefunden werden kann, erfolgt kein Fehlschlag. Von der Verwendung dieser Option wird abgearten, da alle Bibliotheken Abhängigkeitsinformationen bereitstellen sollten (entweder über shlibs-Dateien oder über symbols-Dateien), selbst falls diese noch nicht von anderen Paketen verwendet werden.

note: type: TP
en: B<--warnings=>I<value>
de: B<--warnings=>I<Wert>

note: type: Plain text
en: I<value> is a bit field defining the set of warnings that can be emitted by B<dpkg-shlibdeps>.  Bit 0 (value=1) enables the warning "symbol I<sym> used by I<binary> found in none of the libraries", bit 1 (value=2) enables the warning "package could avoid a useless dependency" and bit 2 (value=4)  enables the warning "I<binary> should not be linked against I<library>".  The default I<value> is 3: the first two warnings are active by default, the last one is not. Set I<value> to 7 if you want all warnings to be active.
de: I<Wert> ist ein Bitfeld, das den Satz an Warnungen definiert, die von B<dpkg-shlibdeps> ausgegeben werden können. Bit 0 (Wert=1) aktiviert die Warnung »Symbol I<Sym>, verwendet von I<Programm>, in keiner der Bibliotheken gefunden.«, Bit 1 (Wert=2) aktiviert die Warnung »Das Paket könnte eine nutzlose Abhängigkeit vermeiden« und Bit 2 (Wert=4) aktiviert die Warnung »I<Programm> sollte nicht gegen I<Bibliothek> gelinkt werden«. Standardmäßig ist I<Wert> 3: die ersten zwei Warnungen sind standardmäßig aktiv, die letzte nicht. Setzten Sie I<Wert> auf 7, falls Sie möchten, dass alle Warnungen aktiv sein sollen.

note: type: SH
en: WARNINGS
de: WARNUNGEN

note: type: Plain text
en: Since B<dpkg-shlibdeps> analyzes the set of symbols used by each binary of the generated package, it is able to emit warnings in several cases. They inform you of things that can be improved in the package. In most cases, those improvements concern the upstream sources directly. By order of decreasing importance, here are the various warnings that you can encounter:
de: Da B<dpkg-shlibdeps> den Symbolsatz, der von jedem Programm des erstellten Pakets verwendet wird, analysiert, ist es in mehreren Fällen in der Lage, Warnungen auszugeben. Sie informieren Sie über Dinge, die im Paket verbessert werden können. Meistens betreffen diese Verbesserungen direkt die Quellen der Originalautoren. In der Reihenfolge abnehmender Wichtigkeit folgen hier die relevanten Warnungen, die auftauchen könnten:

note: type: TP
en: B<symbol>I< sym>B< used by >I<binary>B< found in none of the libraries.>
de: B<Symbol> I< Symbol>B<, verwendet von >I<Programm>B<, in keiner der Bibliotheken gefunden.>

note: type: Plain text
en: The indicated symbol has not been found in the libraries linked with the binary. The I<binary> is most likely a library and it needs to be linked with an additional library during the build process (option B<-l>I<library> of the linker).
de: Das angegebene Symbol wurde nicht in den Bibliotheken gefunden, gegen die das Programm gelinkt wurde. I<Programm> ist höchstwahrscheinlich eine Bibliothek und muss mit zusätzlichen Bibliotheken während des Bau-Prozesses gelinkt werden (Option B<-l>I<Bibliothek> des Linkers).

note: type: TP
en: I<binary>B< contains an unresolvable reference to symbol >I<sym>B<: it's probably a plugin>
de: I<Programm>B< enthält eine nicht-auflösbare Referenz auf Symbol >I<Sym>B<: wahrscheinlich eine Erweiterung>.

note: type: Plain text
en: The indicated symbol has not been found in the libraries linked with the binary. The I<binary> is most likely a plugin and the symbol is probably provided by the program that loads this plugin. In theory a plugin doesn't have any SONAME but this binary does have one and as such it could not be clearly identified as such. However the fact that the binary is stored in a non-public directory is a strong indication that's it's not a normal shared library. If the binary is really a plugin, then disregard this warning. But there's always the possibility that it's a real library and that programs linking to it are using an RPATH so that the dynamic loader finds it. In that case, the library is broken and needs to be fixed.
de: Das angegebene Symbol wurde nicht in den Bibliotheken gefunden, die mit diesem Programm verlinkt sind. Das I<Progamm> ist höchstwahrscheinlich eine Erweiterung und das Symbol wird von dem Programm bereitgestellt, das diese Erweiterung lädt. Theoretisch verfügt eine Erweiterung nicht über einen SONAMEn, allerdings ist dies bei diesem Programm der Fall und daher konnte es nicht eindeutig als Erweiterung erkannt werden. Die Tatsache, dass dieses Programm in einem nicht-öffentlichen Verzeichnis gespeichert wird ist allerdings ein starkes Anzeichen dafür, dass es keine normale gemeinsam benutzte Bibliothek ist. Falls dieses Programm tatsächlich eine Erweiterung ist, ignorieren Sie die Warnung. Allerdings besteht immer die Möglichkeit, dass es eine echte Bibliothek ist und dass Programme, die damit verlinken, einen RPATH verwenden, so dass der dynamische Lader sie findet. In diesem Fall ist die Bibliothek beschädigt und muss repariert werden.

note: type: TP
en: B<package could avoid a useless dependency if >I<binary>B< was not linked against >I<library>B< (it uses none of the library's symbols)>
de: B<Das Paket könnte eine nutzlose Abhängigkeit vermeiden, falls >I<Programm>B< nicht gegen >I<Bibliothek>B< gelinkt wäre (es verwendet keines der Symbole der Bibliothek).>

note: type: Plain text
en: None of the I<binaries> that are linked with I<library> use any of the symbols provided by the library. By fixing all the binaries, you would avoid the dependency associated to this library (unless the same dependency is also generated by another library that is really used).
de: Keines der I<Programme> die gegen I<Bibliothek> gelinkt sind verwendet eines der von der Bibliothek bereitgestellten Symbole. Indem Sie die Programme korrigierten, vermieden Sie die Abhängigkeit, die mit dieser Bibliothek verbunden ist (es sei denn, die Abhängigkeit wird auch durch eine andere Bibliothek generiert, die diese Bibliothek wirklich verwendet).

note: type: TP
en: B<package could avoid a useless dependency if >I<binaries>B< were not linked against >I<library>B< (they uses none of the library's symbols)>
de: B<Das Paket könnte eine nutzlose Abhängigkeit vermeiden, falls >I<Programme>B< nicht gegen >I<Bibliothek>B< gelinkt wären (sie verwenden keines der Symbole der Bibliothek).>

note: type: Plain text
en: Exactly the same as the above warning, but for multiple binaries.
de: Exakt das gleiche wie die obige Warnung, aber für mehrere Programme.

note: type: TP
en: I<binary>B< should not be linked against >I<library>B< (it uses none of the library's symbols)>
de: I<Programm>B< sollte nicht gegen >I<Bibliothek>B< gelinkt werden (es verwendet keines der Bibliotheks-Symbole).>

note: type: Plain text
en: The I<binary> is linked to a library that it doesn't need. It's not a problem but some small performance improvements in binary load time can be obtained by not linking this library to this binary. This warning checks the same information than the previous one but does it for each binary instead of doing the check globally on all binaries analyzed.
de: Das I<Programm> ist gegen eine Bibliothek gelinkt, die es nicht benötigt. Das ist kein Problem, aber bei der Ladezeit können kleine Leistungsverbesserungen erreicht werden, indem diese Bibliothek nicht in das Programm gelinkt wird. Diese Warnung überprüft die gleichen Informationen wie die vorhergehende, allerdings für jedes Programm statt global für alle überprüften Programme.

note: type: SH
en: ERRORS
de: FEHLER

note: type: Plain text
en: B<dpkg-shlibdeps> will fail if it can't find a public library used by a binary or if this library has no associated dependency information (either shlibs file or symbols file). A public library has a SONAME and is versioned (libsomething.so.I<X>). A private library (like a plugin) should not have a SONAME and doesn't need to be versioned.
de: B<dpkg-shlibdeps> wird fehlschlagen, falls es eine vom Programm verwendete öffentliche Bibliothek nicht finden kann oder falls diese Bibliothek keine zugeordneten Abhängigkeitsinformationen hat (entweder eine Shlibs- oder Symbols-Datei). Eine öffentliche Bibliothek hat einen SONAME und ist versioniert (libirgendwas.so.I<X>). Eine private Bibliothek (wie z.B. ein Erweiterung) sollte keinen SONAME haben und braucht nicht versioniert zu sein.

note: type: TP
en: B<couldn't find library >I<library-soname>B< needed by >I<binary>B< (its RPATH is '>I<rpath>B<')>
de: B<konnte Bibliothek >I<SONAME-der-Bibliothek>B< benötigt von >I<Programm>B< nicht finden (ihr RPATH ist »>I<rpath>B<«).>

note: type: Plain text
en: The I<binary> uses a library called I<library-soname> but B<dpkg-shlibdeps> has been unable to find the library.  B<dpkg-shlibdeps> creates a list of directories to check as following: directories listed in the RPATH of the binary, directories listed in /etc/ld.so.conf, directories listed in the LD_LIBRARY_PATH environment variable, and standard public directories (/lib, /usr/lib, /lib32, /usr/lib32, /lib64, /usr/lib64). Then it checks those directories in the package's build tree of the binary being analyzed, in the packages' build trees indicated with the -S command-line option, in other packages' build trees that contains a DEBIAN/shlibs or DEBIAN/symbols file and finally in the root directory.  If the library is not found in any of those directories, then you get this error.
de: Das I<Programm> verwendet eine Bibliothek mit Namen I<SONAME-der-Bibliothek>, aber B<dpkg-shlibdeps> konnte diese Bibliothek nicht finden. B<dpkg-shlibdeps> erstellt folgendermaßen eine Liste der zu prüfenden Verzeichnisse: im RPATH des Programms aufgeführte Verzeichnisse, in /etc/ld.so.conf aufgeführte Verzeichnisse, in der Umgebungsvariable LD_LIBRARY_PATH aufgeführte Verzeichnisse und standardmäßige öffentliche Verzeichnisse (/lib, /usr/lib, /lib32, /usr/lib32, /lib64, /usr/lib64). Dann prüft es diese Verzeichnisse im Bau-Baum des analysierten Pakets, in den mit der Kommandozeilenoption -S angegebenen Paketbauverzeichnisse, in anderen Paketbau-Bäumen, die eine DEBIAN/shlibs- oder DEBIAN/symbols-Datei enthalten und schließlich im Wurzelverzeichnis. Falls die Bibliothek nicht in einem dieser Verzeichnisse gefunden wird, erhalten Sie diesen Fehler.

note: type: Plain text
en: If the library not found is in a private directory of the same package, then you want to add the directory to LD_LIBRARY_PATH. If it's in another binary package being built, you want to make sure that the shlibs/symbols file of this package is already created and that LD_LIBRARY_PATH contains the appropriate directory if it also is in a private directory.
de: Falls sich die nicht gefundene Bibliothek in einem privaten Verzeichnis des gleichen Pakets befindet, müssen Sie das Verzeichnis zu LD_LIBRARY_PATH hinzufügen. Falls sie sich in einem anderen gerade zu bauenden Paket befindet, müssen Sie sicherstellen, dass die »shlibs/symbols«-Datei dieses Pakets bereits angelegt ist und dass LD_LIBRARY_PATH das geeignete Verzeichnis enthält, falls die Bibliothek zudem in einem privaten Verzeichnis liegt.

note: type: TP
en: B<no dependency information found for >I<library-file>B< (used by >I<binary>B<).>
de: B<Keine Abhängigkeitsinformationen für >I<Bibliotheksdatei>B< (verwendet von >I<Programm>B<) gefunden.>

note: type: Plain text
en: The library needed by I<binary> has been found by B<dpkg-shlibdeps> in I<library-file> but B<dpkg-shlibdeps> has been unable to find any dependency information for that library. To find out the dependency, it has tried to map the library to a Debian package with the help of B<dpkg -S >I<library-file>.  Then it checked the corresponding shlibs and symbols files in /var/lib/dpkg/info/, and in the various package's build trees (debian/*/DEBIAN/).
de: Die von I<Programm> benötigte Bibliothek wurde von B<dpkg-shlibdeps> in I<Bibliotheksdatei> gefunden, allerdings konnte B<dpkg-shlibdeps> keine Abhängigkeitsinformationen für diese Bibliothek ermitteln. Um die Abhängigkeit herauszufinden, hat es versucht, die Bibliothek mittels B<dpkg -S >I<Bibliotheksdatei> auf ein Debian-Paket abzubilden. Dann überprüfte es die zugehörigen Shlibs- und Symboldateien in /var/lib/dpkg/info/ und die verschiedenen Paketbaubäume ((debian/*/DEBIAN/).

note: type: Plain text
en: This failure can be caused by a bad or missing shlibs or symbols file in the package of the library. It might also happen if the library is built within the same source package and if the shlibs files has not yet been created (in which case you must fix debian/rules to create the shlibs before calling B<dpkg-shlibdeps>). Bad RPATH can also lead to the library being found under a non-canonical name (example: /usr/lib/openoffice.org/../lib/libssl.so.0.9.8 instead of /usr/lib/libssl.so.0.9.8) that's not associated to any package, B<dpkg-shlibdeps> tries to work around this by trying to fallback on a canonical name (using B<realpath>(3))  but it might not always work. It's always best to clean up the RPATH of the binary to avoid problems.
de: Dieser Fehlschlag kann durch defekte oder fehlende Shlibs- oder Symboldateien im Paket der Bibliothek ausgelöst werden. Er könnte auch auftreten, falls die Bibliothek im gleichen Quellpaket gebaut wird und die Shlibs-Datei noch nicht angelegt wurde (wobei Sie in diesem Fall debian/rules korrigieren müssen, damit die Shlibs-Datei erstellt wird bevor B<dpkg-shlibdeps> aufgerufen wird). Defekte RPATH können auch dazu führen, dass die Bibliothek unter nicht-kanonischen Namen gefunden wird (beispielsweise /usr/lib/openoffice.org/../lib/libssl.so.0.9.8 statt /usr/lib/libssl.so.0.9.8), so dass dann diese keinem Paket zugeordnet ist; B<dpkg-shlibdeps> versucht dies zu umgehen, indem es auf einen kanonischen Namen (mittels B<realpath>(3)) zurückfällt, allerdings könnte dies manchmal nicht funktionieren. Es ist immer am besten, den RPATH zu bereinigen, um Probleme zu vermeiden.

note: type: Plain text
en: Calling B<dpkg-shlibdeps> in verbose mode (-v) will provide much more information about where it tried to find the dependency information. This might be useful if you don't understand why it's giving you this error.
de: Viele weitere Informationen darüber, wo nach Abhängigkeitsinformationen gesucht wird, können durch einen Aufruf von B<dpkg-shlibdeps> im geschwätzigen Modus (-v) erhalten werden. Dies kann nützlich sein, falls Sie nicht verstehen, warum es Ihnen diesen Fehler meldet.

note: type: Plain text
en: dpkg-source - Debian source package (.dsc) manipulation tool
de: dpkg-source - Debian Quellpaket- (.dsc) Manipulations-Werkzeuge

note: type: Plain text
en: B<dpkg-source> [I<option>...] I<command>
de: B<dpkg-source> [I<Option> …] I<Befehl>

note: type: Plain text
en: B<dpkg-source> packs and unpacks Debian source archives.
de: B<dpkg-source> packt und entpackt Debian Quellarchive.

note: type: Plain text
en: None of these commands allow multiple options to be combined into one, and they do not allow the value for an option to be specified in a separate argument.
de: Keiner dieser Befehle erlaubt es, mehrere Optionen zu einer zu kombinieren, und sie erlauben es nicht, den Wert einer Option in einem separaten Argument zu speichern.

note: type: TP
en: B<-x >I<filename>B<.dsc >[I<output-directory>]
de: B<-x >I<Dateiname>B<.dsc> [I<Ausgabe-Verzeichnis>]

note: type: Plain text
en: Extract a source package. One non-option argument must be supplied, the name of the Debian source control file (B<.dsc>).  An optional second non-option argument may be supplied to specify the directory to extract the source package to, this must not exist. If no output directory is specified, the source package is extracted into a directory named I<source>-I<version> under the current working directory.
de: Extrahiere ein Quellpaket. Ein nicht-Options-Argument muss angegeben werden, der Name der Debian Quell-Steuer-Datei (B<.dsc>). Optional kann ein zweites nicht-Options-Argument angegeben werden, um das Verzeichnis anzugeben, in das das Quellpaket extrahiert werden soll. Dieses Verzeichis darf dann nicht existieren. Falls kein Ausgabeverzeichnis angegeben ist, wird das Quellpaket in das Verzeichnis namens I<Quelle>-I<Version> unterhalb des aktuellen Arbeitsverzeichnisses extrahiert.

note: type: Plain text
en: B<dpkg-source> will read the names of the other file(s) making up the source package from the control file; they are assumed to be in the same directory as the B<.dsc>.
de: B<dpkg-source> wird die Namen der anderen Datei(en) aus der Steuerdatei einlesen, die das Quellpaket ergeben; es wird angenommen, dass diese im gleichen Verzeichnis wie die B<.dsc> liegen.

note: type: Plain text
en: The files in the extracted package will have their permissions and ownerships set to those which would have been expected if the files and directories had simply been created - directories and executable files will be 0777 and plain files will be 0666, both modified by the extractors' umask; if the parent directory is setgid then the extracted directories will be too, and all the files and directories will inherit its group ownership.
de: Die Dateien in dem extrahierten Paket werden die Rechte und Eigentümer haben, die erwartet würden, falls die Dateien und Verzeichnisse einfach angelegt worden wären - Verzeichnisse und Programmdateien werden 0777 und einfache Dateien 0666, beide durch die umask der Person, die extrahiert, entsprechend angepasst; falls das übergeordnete Verzeichnis setgid ist, werden dies die extrahierten Verzeichnisse auch sein, und alle Dateien und Verzeichnisse werden die Gruppeneigentümerschaft erben.

note: type: Plain text
en: If the source package uses a non-standard format (currently this means all formats except "1.0"), its name will be stored in B<debian/source/format> so that the following builds of the source package use the same format by default.
de: Falls das Quellpaket ein nicht-Standard-Format verwendet (derzeit bedeutet sind dies alle Formate außer »1.0«) wird sein Name in B<debian/source/format> gespeichert, so dass alle folgenden Bauversuchen des Quellpakets standardmäßig das gleiche Format verwenden.

note: type: TP
en: B<-b> I<directory> [I<format-specific-parameters>]
de: B<-b> I<Verzeichnis> [I<Format-abhängige-Parameter>]

note: type: Plain text
en: Build a source package. The first non-option argument is taken as the name of the directory containing the debianized source tree (i.e. with a debian sub-directory and maybe changes to the original files).  Depending on the source package format used to build the package, additional parameters might be accepted.
de: Baue ein Quellpaket. Das erste nicht-Options-Argument wird als Name des Verzeichnisses verwandt, das den debianisierten (d.h. mit einem Unterverzeichnis debian und ggf. Änderungen an den Originaldateien versehenen) Quellbaum enthält. Abhängig vom dem zum Bau verwandten Quellpaketformat könnten zusätzliche Parameter akzeptiert werden.

note: type: Plain text
en: B<dpkg-source> will build the source package with the first format found in this ordered list: the format indicated with the I<--format> command line option, the format indicated in B<debian/source/format>, "1.0". The fallback to "1.0" is deprecated and will be removed at some point in the future, you should always document the desired source format in B<debian/source/format>. See section B<SOURCE PACKAGE FORMATS> for an extensive description of the various source package formats.
de: B<dpkg-source> wird das Quellpaket mit dem ersten gefundenen Format aus der folgenden geordneten Liste bauen: dem mit der Kommandozeilenoption(en) I<--format> angegeben Format, dem in B<debian/source/format> angegebenen Format, »1.0«. Die Rückfalloption »1.0« ist veraltet und wird irgendwann in der Zukunft entfernt werden, Sie sollten das gewünschte Quellformat immmer in B<debian/source/format> dokumentieren. Die verschiedenen Quellpaketformate werden im Abschnitt B<QUELLPAKET-FORMATE> ausführlich beschrieben.

note: type: TP
en: B<--print-format> I<directory>
de: B<--print-format> I<Verzeichnis>

note: type: Plain text
en: Print the source format that would be used to build the source package if B<dpkg-source -b >I<directory> was called (in the same conditions and with the same parameters).
de: Gibt das Quellformat aus, dass zum Bau des Quellpakets verwandt würde, falls B<dpkg-source -b >I<Verzeichnis> aufgerufen würde (unter den gleichen Bedingungen und mit den gleichen Parametern).

note: type: TP
en: B<--before-build> I<directory>
de: B<--before-build> I<Verzeichnis>

note: type: Plain text
en: Run the corresponding hook of the source package format. This hook is called before any build of the package (B<dpkg-buildpackage> calls it very early even before B<debian/rules clean>). This command is idempotent and can be called multiple times. Not all source formats implement something in this hook, and those that do usually prepare the source tree for the build for example by ensuring that the Debian patches are applied.
de: Der entsprechende Hook dess Quellpaketformats soll ausgeführt werden. Dieser Hook wird vor jedem Bau des Pakets aufgerufen (B<dpkg-buildpackage> ruft ihn sehr früh, sogar vor B<debian/rules clean> auf). Dieser Befehl ist idempotent und kann mehrfach aufgerufen werden. Nicht alle Quellformate implementieren in diesem Hook etwas und wenn dies erfolgt, dann gewöhnlich zur Vorbereitung des Quellbaums für den Bau, in dem beispielsweise sichergestellt wird, dass alle Debian-Patches angewandt sind.

note: type: TP
en: B<--after-build> I<directory>
de: B<--after-build> I<Verzeichnis>

note: type: Plain text
en: Run the corresponding hook of the source package format. This hook is called after any build of the package (B<dpkg-buildpackage> calls it last). This command is idempotent and can be called multiple times. Not all source formats implement something in this hook, and those that do usually use it to undo what B<--before-build> has done.
de: Der entsprechende Hook dess Quellpaketformats soll ausgeführt werden. Dieser Hook wird nach jedem Bau des Pakets aufgerufen (B<dpkg-buildpackage> ruft als letztes auf). Dieser Befehl ist idempotent und kann mehrfach aufgerufen werden. Nicht alle Quellformate implementieren in diesem Hook etwas und wenn dies erfolgt, dann gewöhnlich um rückgängig zu machen, was B<--before-build> durchgeführt hat.

note: type: TP
en: B<--commit> [I<directory>] ...
de: B<--commit> [I<Verzeichnis>] …

note: type: Plain text
en: Record changes in the source tree unpacked in I<directory>. This command can take supplementary parameters depending on the source format.  It will error out for formats where this operation doesn't mean anything.
de: Zeichnet Änderungen am in I<Verzeichnis> entpackten Quellbaum auf. Dieser Befehl kann zusätzliche Parameter akzeptieren, abhängig vom Quellformat. Er wird zu einer Fehlermeldung bei Formaten, für denen dieser Vorgang keine Bedeutung hat, führen.

note: type: SH
en: GENERIC BUILD OPTIONS
de: GENERISCHE BAUOPTIONEN

note: type: Plain text
en: Specifies the main source control file to read information from. The default is B<debian/control>.  If given with relative pathname this is interpreted starting at the source tree's top level directory.
de: Bestimmt die Hauptquell-»control«-Datei, aus der Informationen ausgelesen werden sollen. Der Standardwert ist B<debian/control>. Falls der Pfadname relativ ist, wird dieser relativ zum obersten Verzeichnis des Quellbaums interpretiert.

note: type: Plain text
en: Specifies the changelog file to read information from. The default is B<debian/changelog>.  If given with relative pathname this is interpreted starting at the source tree's top level directory.
de: Bestimmt die »changelog«-Datei, aus der Informationen ausgelesen werden sollen. Der Standardwert ist B<debian/changelog>. Falls der Pfadname relativ ist, wird dieser relativ zum obersten Verzeichnis des Quellbaums interpretiert.

note: type: TP
en: B<--format=>I<value>
de: B<--format=>I<Wert>

note: type: Plain text
en: Use the given format for building the source package. It does override any format given in B<debian/source/format>.
de: Verwende das angegebene Format zum Bau des Quellpakets. Es überschreibt jedes in B<debian/source/format> angegebene Format.

note: type: Plain text
en: Read substitution variables in I<substvars-file>; the default is to not read any file. This option can be used multiple times to read substitution variables from multiple files.
de: Lese Substitutionsvariablen aus I<Substvars-Datei>; standardmäßig wird keine Datei gelesen. Diese Option kann mehrfach verwandt werden, um Substitutionsvariablen aus mehreren Dateien einzulesen.

note: type: TP
en: B<-Z>I<compression>, B<--compression>=I<compression>
de: B<-Z>I<Komprimierung>, B<--compression>=I<Komprimierung>

note: type: Plain text
en: Specify the compression to use for created files (tarballs and diffs).  Note that this option will not cause existing tarballs to be recompressed, it only affects new files. Supported values are: I<gzip>, I<bzip2>, I<lzma> and I<xz>.  I<gzip> is the default. I<xz> is only supported since dpkg-dev 1.15.5.
de: Gibt die Komprimierung an, die für die angelegte Dateien (Tarbälle und Diffs) verwendet wird. Beachten Sie, dass diese Option nicht dazu führt, dass existierende Tarbälle rekomprimiert werden, sie betrifft nur neue Dateien. Unterstützte Werte sind I<gzip>, I<bzip2>, I<lzma> und I<xz>. I<gzip> ist voreingestellt. I<xz> wird erst seit Dpkg-dev 1.15.5 unterstützt.

note: type: TP
en: B<-z>I<level>, B<--compression-level>=I<level>
de: B<-z>I<Stufe>, B<--compression-level>=I<Stufe>

note: type: Plain text
en: Compression level to use. As with B<-Z> it only affects newly created files. Supported values are: I<1> to I<9>, I<best>, and I<fast>.  The default is I<9> for gzip and bzip2, I<6> for xz and lzma.
de: Zu verwendende Komprimierstufe. Wie bei B<-Z> betrifft dies nur neu angelegte Dateien. Unterstützte Werte sind I<1> bis I<9>, I<best> (am besten) und I<fast> (schnell). Der Standardwert ist I<9> für Gzip und Bzip2, I<6> für Xz und Lzma.

note: type: Plain text
en: You may specify a perl regular expression to match files you want filtered out of the list of files for the diff. (This list is generated by a find command.) (If the source package is being built as a version 3 source package using a VCS, this can be used to ignore uncommited changes on specific files. Using -i.* will ignore all of them.)  B<-i> by itself enables the option, with a default regexp that will filter out control files and directories of the most common revision control systems, backup and swap files and Libtool build output directories. There can only be one active regexp, of multiple B<-i> options only the last one will take effect.
de: Sie können einen regulären Perl-Ausdruck angeben, der auf Dateien passt, die Sie aus der Liste der Dateien für den Diff entfernen möchten; diese Liste wird von einem Find-Befehl generiert. Falls das Quellpaket als Version 3-Quellpaket mittels eines VCS gebaut wird, ignoriert dies stattdessen Änderungen an bestimmten Dateien, die noch nicht übertragen (»committed«) wurden (mit -i.* werden alle davon ignoriert). B<-i> aktiviert diese Option mit einem voreingestellten regulären Ausdruck, der Steuerdateien und -Verzeichnisse der häufigsten Revisionskontrollsysteme, Backups, Swap-Dateien und Bau-Ausgabeverzeichnisse von Libtool herausgefiltert. Es kann nur einen aktiven regulären Ausdruck geben, von mehrfach angegebenen B<-i>-Optionen wird nur die letzte berücksichtigt.

note: type: Plain text
en: This is very helpful in cutting out extraneous files that get included in the diff, e.g. if you maintain your source in a revision control system and want to use a checkout to build a source package without including the additional files and directories that it will usually contain (e.g. CVS/, .cvsignore, .svn/). The default regexp is already very exhaustive, but if you need to replace it, please note that by default it can match any part of a path, so if you want to match the begin of a filename or only full filenames, you will need to provide the necessary anchors (e.g. '(^|/)', '($|/)') yourself.
de: Dies ist sehr hilfreich, um irrelevante Dateien, die im Diff aufgenommen werden, zu entfernen. Falls Sie zum Beispiel Ihre Quellen in einem Revisionskontrollsystem speichern und »Checkout« verwenden möchten, um Ihr Quellpaket zu bauen, ohne die zusätzlichen Dateien und Verzeichnisse, die darin typischerweise enthalten sind (z.B. CVS/, .cvsignore, .svn/), mit aufzunehmen. Der voreingestellte reguläre Ausdruck ist bereits sehr erschöpfend, aber falls Sie ihn ersetzen müssen, beachten Sie, dass er standardmäßig auf alle Teile des Pfades passen kann. Falls Sie daher nur den Anfang eines Pfades oder komplette Dateinamen vergleichen wollen, müssen Sie die notwendigen Anker (z.B. »(^|/)«, »($|/)«) selbst bereitstellen.

note: type: Plain text
en: The perl regular expression specified will extend the default value of B<--diff-ignore> and its current value (if set). It does this by concatenating "B<|>I<regexp>" to the existing value.  This option is convenient to use in B<debian/source/options> to exclude some auto-generated files from the automatic patch generation.
de: Der angegebene reguläre Ausdruck (Perl-Format) wird den standardmäßigen Wert von B<--diff-ignore> and dessen aktuellen Wert (falls gesetzt) erweiteren. Dies erfolgt, indem »B<|>I<regexp>« an den existierenden Wert angehängt wird. Diese Option ist bequem in B<debian/source/options> zu nutzen, um einige automatisch erstellten Dateien von der automatischen Patch-Erzeugung auszuschließen.

note: type: TP
en: B<-I>[I<file-pattern>], B<--tar-ignore>[=I<file-pattern>]
de: B<-I>[I<Dateimuster>], B<--tar-ignore>[=I<Dateimuster>]

note: type: Plain text
en: If this option is specified, the pattern will be passed to B<tar>(1)'s --exclude option when it is called to generate a .orig.tar or .tar file. For example, -ICVS will make tar skip over CVS directories when generating a .tar.gz file. The option may be repeated multiple times to list multiple patterns to exclude.
de: Falls diese Option angegeben wird, wird der Dateiname an die --exclude-Option von B<tar>(1) weitergegeben, wenn es zur Erstellung der Datei .orig.tar oder .tar aufgerufen wird. Zum Beispiel führt -ICVS dazu, dass tar über CVS-Verzeichnisse hinweggeht, wenn es eine .tar-Datei erstellt. Diese Option kann mehrfach wiederholt werden, um mehrere Muster aufzuführen, die ausgeschlossen werden sollen.

note: type: Plain text
en: B<-I> by itself adds default --exclude options that will filter out control files and directories of the most common revision control systems, backup and swap files and Libtool build output directories.
de: B<-I> fügt standardmäßig von selbst --exclude-Optionen hinzu, die die Steuerdateien und -Verzeichnisse der häufigsten Revisionskontrollsysteme, Backups, Swap-Dateien und Bau-Ausgabeverzeichnisse von Libtool herausfiltern.

note: type: Plain text
en: B<Note:> While they have similar purposes, B<-i> and B<-I> have very different syntax and semantics. B<-i> can only be specified once and takes a perl compatible regular expression which is matched against the full relative path of each file. B<-I> can specified multiple times and takes a filename pattern with shell wildcards.  The pattern is applied to the full relative path but also to each part of the path individually. The exact semantic of tar's --exclude option is somewhat complicated, see http://www.gnu.org/software/tar/manual/tar.html#wildcards for a full documentation.
de: B<Hinweis:> Obwohl sie ähnliche Zwecke verfolgen, haben B<-i> und B<-I> eine sehr verschiedene Syntax und Semantik. B<-i> kann nur einmal angegeben werden und nimmt einen regulären Perlausdruck an, der gegen den vollen relativen Pfad jeder Datei geprüft wird. B<-I> kann mehrfach angegeben werden und nimmt ein Dateinamen-Muster mit Shell-Jokerzeichen an. Das Muster wird gegen den vollen relativen Pfad aber auch individuell gegen jeden Teil des Pfades angewendet. Die exakte Symantik der Option --exclude ist etwas kompliziert, lesen Sie http://www.gnu.org/software/tar/manual/tar.html#wildcards für eine komplette Dokumentation.

note: type: Plain text
en: The default regexp and patterns for both options can be seen in the output of the B<--help> command.
de: Der voreingestellte reguläre Ausdruck und Muster für beide Optionen können in der Ausgabe des Befehls B<--help> gesehen werden.

note: type: SH
en: GENERIC EXTRACT OPTIONS
de: GENERISCHE EXTRAHIERUNGSOPTIONEN

note: type: Plain text
en: Do not copy original tarballs near the extracted source package.
de: Kopiere die Original-Tarbälle in die Nähe des extrahierten Quellpakets.

note: type: Plain text
en: Do not check signatures and checksums before unpacking.
de: Prüfe Signaturen und Prüfsummen vor dem Entpacken nicht.

note: type: Plain text
en: Refuse to unpack the source package if it doesn't contain an OpenPGP signature that can be verified either with the user's I<trustedkeys.gpg> keyring, one of the vendor-specific keyrings, or one of the official Debian keyrings (I</usr/share/keyrings/debian-keyring.gpg> and I</usr/share/keyrings/debian-maintainers.gpg>).
de: Entpacken des Quellpakets ablehnen, falls es keine OpenPGP-Signatur enthält, die entweder mit dem I<trustedkeys.gpg>-Schlüsselring des Benutzers, mit einem der Schlüsselringen des Lieferanten oder mit einem der offiziellen Debian-Schüsselringe (I</usr/share/keyrings/debian-keyring.gpg> und I</usr/share/keyrings/debian-maintainers.gpg>) überprüft werden kann.

note: type: SH
en: SOURCE PACKAGE FORMATS
de: QUELLPAKET-FORMATE

note: type: Plain text
en: If you don't know what source format to use, you should probably pick either "3.0 (quilt)" or "3.0 (native)". See http://wiki.debian.org/Projects/DebSrc3.0 for information on the deployment of those formats within Debian.
de: Falls Sie nicht wissen, welches Quellformat Sie verwenden sollen, verwenden Sie wahrscheinlich am besten entweder »3.0 (quilt)« oder »3.0 (native)«. Lesen Sie http://wiki.debian.org/Projects/DebSrc3.0 für Informationen über den Einsatz dieser Formate innerhalb von Debian.

note: type: Plain text
en: A source package in this format consists either of a B<.orig.tar.gz> associated to a B<.diff.gz> or a single B<.tar.gz> (in that case the package is said to be I<native>).
de: Ein Quellpaket in diesem Format besteht entweder aus einem B<.orig.tar.gz> mit zugehörigem B<.diff.gz> oder einem einzelnen B<.tar.gz> (in diesem Fall wird das Paket als I<nativ> bezeichnet).

note: type: Plain text
en: B<Extracting>
de: B<Extrahieren>

note: type: Plain text
en: Extracting a native package is a simple extraction of the single tarball in the target directory. Extracting a non-native package is done by first unpacking the B<.orig.tar.gz> and then applying the patch contained in the B<.diff.gz> file. The timestamp of all patched files is reset to the extraction time of the source package (this avoids timestamp skews leading to problems when autogenerated files are patched). The diff can create new files (the whole debian directory is created that way) but can't remove files (empty files will be left over).
de: Extrahieren eines nativen Pakets ist ein einfaches Extrahieren eines einzelnen Tarballs in das Zielverzeichnis. Extrahieren eines nicht-nativen Pakets erfolgt zuerst durch Entpacken des B<.orig.tar.gz> und dann durch Anwendung des Patches aus der B<.diff.gz>-Datei. Der Zeitstempel aller gepatchten Dateien wird auf den Zeitpunkt der Extrahierung des Quellpakets zurückgesetzt (das vermeidet Zeitstempelversätze, die zu Problemen führen, wenn autogenerierte Dateien gepatcht werden). Der Diff kann neue Dateien anlegen (das gesamte Debian-Verzeichnis wird auf diese Weise erstellt), kann aber keine Dateien entfernen (leere Dateien bleiben zurück).

note: type: Plain text
en: B<Building>
de: B<Bauen>

note: type: Plain text
en: Building a native package is just creating a single tarball with the source directory. Building a non-native package involves extracting the original tarball in a separate ".orig" directory and regenerating the B<.diff.gz> by comparing the source package I<directory> with the .orig directory.
de: Bauen eines nativen Paket besteht nur aus dem Erstellen eines einzigen Tarballs mit dem Quellverzeichnis. Bauen eines nicht-nativen Pakets schließt das Extrahieren des Original-Tarballs in ein separates Verzeichnis ».orig« und die Neuerstellung des B<.diff.gz> durch Vergleich des Quellpaket-I<Verzeichnisses> mit dem Verzeichnis .orig ein.

note: type: TP
en: B<Build options (with -b):>
de: B<Bau-Optionen (mit -b):>

note: type: Plain text
en: If a second non-option argument is supplied it should be the name of the original source directory or tarfile or the empty string if the package is a Debian-specific one and so has no Debianisation diffs. If no second argument is supplied then B<dpkg-source> will look for the original source tarfile I<package>B<_>I<upstream-version>B<.orig.tar.gz> or the original source directory I<directory>B<.orig> depending on the B<-sX> arguments.
de: Falls ein zweites nicht-Options-Argument angegeben ist, sollte es der Namen des Originalquellverzeichnisses oder der Tardatei sein. Falls das Paket Debian-spezifisch ist, dann sollte dieses Argument die leere Zeichenkette sein, da es kein Debianisierungs-Diff gibt. Falls kein zweites Argument übergeben wird, dann schaut B<dpkg-source> nach der ursprünglichen Tardatei I<Paket>B<_>I<Upstream-Version>B<.orig.tar.>I<Erweiterung> oder dem ursprünglichen Quellverzeichnis I<Verzeichnis>B<.orig>, abhängig von den B<-sX>-Argumenten.

note: type: Plain text
en: B<-sa>, B<-sp>, B<-sk>, B<-su> and B<-sr> will not overwrite existing tarfiles or directories. If this is desired then B<-sA>, B<-sP>, B<-sK>, B<-sU> and B<-sR> should be used instead.
de: B<-sa>, B<-sp>, B<-sk>, B<-su> und B<-sr> werden keine existierenden Tardateien oder Verzeichnisse überschreiben. Falls dies gewünscht ist, sollten stattdessen B<-sA>, B<-sP>, B<-sK>, B<-sU> und B<-sR> verwendet werden.

note: type: Plain text
en: Specifies to expect the original source as a tarfile, by default I<package>B<_>I<upstream-version>B<.orig.tar.>I<extension>.  It will leave this original source in place as a tarfile, or copy it to the current directory if it isn't already there. The tarball will be unpacked into I<directory>B<.orig> for the generation of the diff.
de: Gibt an, dass die Originalquellen als Tardatei erwartet werden sollen, standardmäßig I<Paket>B<_>I<Ursprungsversion>B<.orig.tar>I<Erweiterung>. Es wird diese Originalquellen als Tardatei am Platz belassen, oder sie in das aktuelle Verzeichnis kopieren, falls sie dort noch nicht sind. Der Tarball wird nach I<Verzeichnis>B<.orig> für die Erstellung des Diffs entpackt.

note: type: Plain text
en: Like B<-sk> but will remove the directory again afterwards.
de: Wie B<-sk>, aber das Verzeichnis wird danach entfernt.

note: type: Plain text
en: Specifies that the original source is expected as a directory, by default I<package>B<->I<upstream-version>B<.orig> and B<dpkg-source> will create a new original source archive from it.
de: Gibt an, dass die Originalquellen als Verzeichnis erwartet werden, standardmäßig I<Paket>B<->I<Ursprungsversion>B<.orig>. B<dpkg-source> wird daraus ein neues Original-Quellarchiv erstellen.

note: type: Plain text
en: Like B<-su> but will remove that directory after it has been used.
de: Wie B<-su>, aber das Verzeichnis wird nach der Verwendung entfernt.

note: type: Plain text
en: Specifies that the original source is available both as a directory and as a tarfile. dpkg-source will use the directory to create the diff, but the tarfile to create the B<.dsc>.  This option must be used with care - if the directory and tarfile do not match a bad source archive will be generated.
de: Gibt an, dass die Originalquellen sowohl als Verzeichnis als auch als Tardatei verfügbar sind. dpkg-source wird das Verzeichnis zur Erstellung des Diffs verwenden, aber die Tardatei für die B<.dsc>. Diese Option muss mit Vorsicht verwendet werden - falls das Verzeichnis und die Tardatei nicht zusammen passen, wird ein fehlerhaftes Quellarchiv erstellt.

note: type: Plain text
en: Specifies to not look for any original source, and to not generate a diff.  The second argument, if supplied, must be the empty string. This is used for Debian-specific packages which do not have a separate upstream source and therefore have no debianisation diffs.
de: Gibt an, dass nicht nach Originalquellen geschaut und kein Diff erstellt werden soll. Das zweite Argument, falls angegeben, muss die leere Zeichenkette sein. Dies wird für Debian-spezifische Pakete verwendet, die keine Quellen von Originalautoren und somit kein Debianisierungs-Diff haben.

note: type: TP
en: B<-sa> or B<-sA>
de: B<-sa> oder B<-sA>

note: type: Plain text
en: Specifies to look for the original source archive as a tarfile or as a directory - the second argument, if any, may be either, or the empty string (this is equivalent to using B<-sn>).  If a tarfile is found it will unpack it to create the diff and remove it afterwards (this is equivalent to B<-sp>); if a directory is found it will pack it to create the original source and remove it afterwards (this is equivalent to B<-sr>); if neither is found it will assume that the package has no debianisation diffs, only a straightforward source archive (this is equivalent to B<-sn>).  If both are found then B<dpkg-source> will ignore the directory, overwriting it, if B<-sA> was specified (this is equivalent to B<-sP>)  or raise an error if B<-sa> was specified.  B<-sA> is the default.
de: Gibt an, dass nach dem Original-Quellarchiv als Tardatei oder als Verzeichnis gesucht werden soll - das zweite Argument, falls vorhanden, kann eines von beiden sein, oder die leere Zeichenkette (dies ist äquivalent zur Verwendung von B<-sn>). Falls eine Tardatei gefunden wird, wird diese zur Erstellung eines Diffs entpackt und danach entfernt (dies ist äquivalent zu B<-sp>); falls ein Verzeichnis gefunden wird, wird dieses gepackt, um die Originalquellen zu erstellen und danach entfernt (dies ist äquivalent zu B<-sr>); falls keines von beiden gefunden wird, wird angenommen, dass das Paket kein Debianisierungs-Diff sondern nur ein direktes Quellarchiv (dies ist äquivalent zu B<-sn>). Falls sowohl ein Verzeichnis als auch eine Tar-Datei gefunden werden, dann ignoriert B<dpkg-source> das Verzeichnis, und überschreibt es, falls B<-sA> angegeben wurde (dies ist äquivalent zu B<-sP>) oder löst einen Fehler aus, falls B<-sa> angegeben wurde. B<-sA> ist die Voreinstellung.

note: type: Plain text
en: The process fails if the generated diff contains changes to files outside of the debian sub-directory. This option is not allowed in B<debian/source/options> but can be used in B<debian/source/local-options>.
de: Der Prozess schlägt fehl, falls das erstellte Diff Änderungen an Dateien außerhalb des Unterverzeichnisses »debian« enthält. Diese Option ist in B<debian/source/options> nicht erlaubt, kann aber in B<debian/source/local-options> verwandt werden.

note: type: TP
en: B<Extract options (with -x):>
de: B<Extrahierungs-Optionen (mit -x):>

note: type: Plain text
en: In all cases any existing original source tree will be removed.
de: In allen Fällen werden die Originalquellbäume entfernt.

note: type: Plain text
en: Used when extracting then the original source (if any) will be left as a tarfile. If it is not already located in the current directory or if an existing but different file is there it will be copied there.  (B<This is the default>).
de: Verwendet beim Extrahieren. Die Originalquellen (falls vorhanden) werden als Tar-Datei belassen. Falls diese sich nicht im aktuellen Verzeichnis befinden oder falls eine existierende, aber davon verschiedene Datei bereits vorhanden ist, wird sie dort hin kopiert. (B<Dies ist die Voreinstellung.>)

note: type: Plain text
en: Unpacks the original source tree.
de: Entpackt den Originalquellbaum.

note: type: Plain text
en: Ensures that the original source is neither copied to the current directory nor unpacked. Any original source tree that was in the current directory is still removed.
de: Stellt sicher, dass die Originalquellen weder in das aktuelle Verzeichnis kopiert noch entpackt werden. Jeder Originalquellbaum, der im aktuellen Verzeichnis war, wird dennoch entfernt.

note: type: Plain text
en: All the B<-s>I<X> options are mutually exclusive. If you specify more than one only the last one will be used.
de: Alle B<-s>I<X>-Optionen schließen sich paarweise aus. Falls Sie mehr als eine angeben, wird nur die letzte verwendet.

note: type: Plain text
en: Skips application of the debian diff on top of the upstream sources.
de: Überspringt die Anwendung des Debian-Diffs auf die Quellen der Originalautoren.

note: type: Plain text
en: Also known as wig&pen. This format is not recommended for wide-spread usage, the format "3.0 (quilt)" replaces it. Wig&pen was the first specification of a new-generation source package format.
de: Auch als »wig&pen« bekannt. Dieses Format wird nicht für den breiten Einsatz empfohlen, es wird durch das Format »3.0 (quilt)« ersetzt. Wig&pen war die erste Spezifikation eines Paketformats der nächsten Generation.

note: type: Plain text
en: The behaviour of this format is the same as the "3.0 (quilt)" format except that it doesn't use an explicit list of patches. All files in B<debian/patches/> matching the perl regular expression B<[\ew-]+> must be valid patches: they are applied at extraction time.
de: Das Verhalten dieses Formats ist identisch zum Format »3.0 (quilt)«, abgesehen davon, dass es keine explizite Liste von Patches verwendet. Alle Dateien in B<debian/patches/>, die auf den regulären Perlausdruck B<[\ew-]+> passen, müssen gültige Patches sein: sie werden zum Zeitpunkt der Extrahierung angewandt.

note: type: Plain text
en: When building a new source package, any change to the upstream source is stored in a patch named B<zz_debian-diff-auto>.
de: Wenn ein neues Quellpaket gebaut wird, werden alle Änderungen an den Quellen der Originalautoren in einem Patch mit Namen B<zz_debian-diff-auto> gespeichert.

note: type: Plain text
en: This format is an extension of the native package format as defined in the 1.0 format. It supports all compression methods and will ignore by default any VCS specific files and directories as well as many temporary files (see default value associated to B<-I> option in the B<--help> output).
de: Dieses Format ist eine Erweiterung des nativen Paketformats wie es im 1.0-Format definiert ist. Es unterstützt alle Kompressionsmethoden und ignoriert standardmäßig alle VCS-spezifischen Dateien und Verzeichnisse sowie viele temporäre Dateien (lesen Sie den Standardwert der Option B<-I> bei der Ausgabe von B<--help>).

note: type: Plain text
en: A source package in this format contains at least an original tarball (B<.orig.tar.>I<ext> where I<ext> can be B<gz>, B<bz2>, B<lzma> and B<xz>) and a debian tarball (B<.debian.tar.>I<ext>). It can also contain additional original tarballs (B<.orig->I<component>B<.tar.>I<ext>).  I<component> can only contain alphanumeric characters and dashes ("-").
de: Ein Quellpaket in diesem Format enthält mindestens einen Original-Tarball (B<.orig.tar.>I<erw>, wobei I<erw> B<gz>, B<bz2>, B<lzma> und B<xz> sein kann) und einen Debian-Tarball (B<.debian.tar.>I<erw>). Es kann auch zusätzliche Original-Tarbälle (B<.orig->I<Komponente>B<.tar.>I<erw>)) enthalten. I<Komponente> kann nur alphanumerische Zeichen und Gedankenstriche (»-«) enthalten.

note: type: Plain text
en: The main original tarball is extracted first, then all additional original tarballs are extracted in subdirectories named after the I<component> part of their filename (any pre-existing directory is replaced). The debian tarball is extracted on top of the source directory after prior removal of any pre-existing B<debian> directory. Note that the debian tarball must contain a B<debian> sub-directory but it can also contain binary files outside of that directory (see B<--include-binaries> option).
de: Der Haupt-Originaltarball wird zuerst extrahiert, dann werden alle zusätzlichen Originaltarbälle in Unterverzeichnisse extrahiert, die nach dem I<Komponente>n-Teil ihres Dateinamens benannt werden (jedes bereits existierende Verzeichnis wird ersetzt). Der Debian-Tarball wird auf das Quellverzeichnis extrahiert, nachdem jedes bereits existierende B<debian>-Verzeichnis entfernt wurde. Beachten Sie, dass der Debian-Tarball ein B<debian>-Unterverzeichnis enthalten muss, er aber auch Binärdateien außerhalb dieses Verzeichnisses enthalten darf (sehen Sie hierzu die Option B<--include-binaries>).

note: type: Plain text
en: All patches listed in B<debian/patches/debian.series> or B<debian/patches/series> are then applied.  If the former file is used and the latter one doesn't exist (or is a symlink), then the latter is replaced with a symlink to the former. This is meant to simplify usage of quilt to manage the set of patches. Note however that while B<dpkg-source> parses correctly series files with explicit options used for patch application (stored on each line after the patch filename and one or more spaces), it does ignore those options and always expect patches that can be applied with the B<-p1> option of B<patch>. It will thus emit a warning when it encounters such options, and the build is likely to fail.
de: Dann werden alle in B<debian/patches/debian.series> oder B<debian/patches/series> aufgeführten Patches angewandt. Falls die erstere Datei verwandt wird und die letztere nicht existiert (oder ein Symlink ist), dann wird die letztere mit einem Symlink zu ersterer ersetzt. Dies ist zur Vereinfachung der Verwendung von Quilt gedacht, um den Satz an Patches zu verwalten. Beachten Sie allerdings, dass B<dpkg-source> zwar Seriendateien auswertet, in denen explizite Optionen für die Anwendung der Patches verwandt werden (diese werden auf jede Zeile nach dem Patch-Dateinamen und einem oder mehreren Leerzeichen gespeichert), diese Optionen dann aber ignoriert und immer erwartet, dass die Patches mit der Option B<-p1> von B<patch> angewandt werden können. Es wird daher eine Warnung ausgeben, wenn es auf solche Optionen trifft, und der Bau wird wahrscheinlich fehlschlagen.

note: type: Plain text
en: Contrary to quilt's default behaviour, patches are expected to apply without any fuzz. When that is not the case, you should refresh such patches with quilt, or dpkg-source will error out while trying to apply them.
de: Im Gegensatz zum Standardverhalten bei Quilt wird erwartet, dass die Patches ohne Unschärfe angewandt werden können. Wenn das nicht der Fall ist, sollten Sie die Patches mit Quilt erneuern oder Dpkg-source wird mit einer Fehlermeldung beim Versuch, sie anzuwenden, abbrechen.

note: type: Plain text
en: Similarly to quilt's default behaviour, the patches can remove files too.
de: Ähnlich wie bei Quilt können Patches auch Dateien entfernen.

note: type: Plain text
en: The file B<.pc/applied-patches> is created if some patches have been applied during the extraction.
de: Die Datei B<.pc/applied-patches> wird angelegt, falls einige Patches während der Extrahierung angewandt wurden.

note: type: Plain text
en: All original tarballs found in the current directory are extracted in a temporary directory by following the same logic as for the unpack, the debian directory is copied over in the temporary directory, and all patches except the automatic patch (B<debian-changes->I<version> or B<debian-changes>, depending on B<--single-debian-patch>) are applied. The temporary directory is compared to the source package directory. When the diff is non-empty, the build fails unless B<--single-debian-patch> or B<--auto-commit> has been used, in which case the diff is stored in the automatic patch.  If the automatic patch is created/deleted, it's added/removed from the series file and from the quilt metadata.
de: Alle im aktuellen Verzeichnis gefundenen Original-Tarbälle werden in ein temporäres Verzeichnis entpackt. Hierbei wird die gleiche Logik wie für das Entpacken verwandt, das debian-Verzeichnis wird in das temporäre Verzeichnis kopiert und alle Patches außer dem automatischen Patch (B<debian-changes->I<Version> oder B<debian-changes>, abhängig von B<--single-debian-patch>) werden angewandt. Das temporäre Verzeichnis wird mit dem Quellpaketverzeichnis verglichen. Wenn der Diff nicht leer ist, schlägt der Bau fehl, falls nicht B<--single-debian-patch> oder B<--auto-commit> verwandt wurde; in diesem Fall wird der Diff im automatischen Patch gespeichert. Falls der automatische Patch erzeugt/gelöscht wird, wird er zu der Datei series und den Quilt-Metadaten hinzugefügt bzw. aus diesen gelöscht.

note: type: Plain text
en: Any change on a binary file is not representable in a diff and will thus lead to a failure unless the maintainer deliberately decided to include that modified binary file in the debian tarball (by listing it in B<debian/source/include-binaries>). The build will also fail if it finds binary files in the debian sub-directory unless they have been whitelisted through B<debian/source/include-binaries>.
de: Änderungen an Binärdateien können in einem Diff nicht dargestellt werden und führen daher zu einem Fehlschlag, es sei denn, der Betreuer hat sich absichtlich dazu entschlossen, die veränderte Binärdatei dem Debian-Tarball hinzuzufügen (indem er sie in B<debian/source/include-binaries> aufgeführt hat). Der Bau wird auch fehlschlagen, falls er Binärdateien im debian-Unterverzeichnis findet, die nicht über B<debian/source/include-binaries> freigegeben wurden.

note: type: Plain text
en: The updated debian directory and the list of modified binaries is then used to generate the debian tarball.
de: Das aktualisierte debian-Verzeichnis und die Liste der veränderten Programme wird dann zur Erstellung des Debian-Tarballs verwandt.

note: type: Plain text
en: The automatically generated diff doesn't include changes on VCS specific files as well as many temporary files (see default value associated to B<-i> option in the B<--help> output). In particular, the B<.pc> directory used by quilt is ignored during generation of the automatic patch.
de: Der automatisch erstellte Diff enthält keine Änderungen an VCS-spezifischen sowie vielen temporären Dateien (lesen Sie hierzu den zur Option B<-i> zugeordneten Standardwert in der Ausgabe von B<--help>). Insbesondere wird das von Quilt verwandte B<.pc>-Verzeichnis während der Erstellung des automatischen Patches ignoriert.

note: type: Plain text
en: Note: B<dpkg-source> B<--before-build> (and B<-b>) will ensure that all patches listed in the series file are applied so that a package build always has all patches applied. It does this by finding unapplied patches (they are listed in the B<series> file but not in B<.pc/applied-patches>), and if the first patch in that set can be applied without errors, it will apply them all. The option B<--no-preparation> can be used to disable this behavior.
de: Hinweis: B<dpkg-source> B<--before-build> (und B<-b>) stellen sicher, dass alle in der Series-Datei aufgeführten Patches angewendet sind, so dss ein Paketbau immer mit allen angewandten Patches durchgeführt wird. Dies erfolgt, indem nicht angewandte Patches ermittelt werden (sie sind in der Datei B<series>, aber nicht in der Datei B<.pc/applied-patches> aufgeführt) und wenn der erste Patch in dem Satz ohne Fehler angewandt werden kann, werden sie alle angewandt. Die Option B<--no-preparation> kann zum Abschalten dieses Verhaltens verwandt werden.

note: type: Plain text
en: B<Recording changes>
de: B<Änderungen aufzeichnen>

note: type: TP
en: B<--commit> [I<directory>] [I<patch-name>] [I<patch-file>]
de: B<--commit> [I<Verzeichnis>] [I<Patch-Name>] [I<Patch-Datei>]

note: type: Plain text
en: Generates a patch corresponding to the local changes that are not managed by the quilt patch system and integrates it in the patch system under the name I<patch-name>. If the name is missing, it will be asked interactively. If I<patch-file> is given, it is used as the patch corresponding to the local changes to integrate. Once integrated, an editor is launched so that you can edit the meta-information in the patch header.
de: Erstellt einen Patch, der den lokalen Änderungen entspricht, die nicht vom Quilt-Patch-System verwaltet werden und integriert es unter dem Namen I<Patch-Name> in das Patch-System. Falls der Name fehlt, wird er interaktiv erfragt. Falls I<Patch-Datei> angegeben ist, wird er als Patch, der zu den lokalen Änderungen, die integriert werden sollen, gehört, verwandt. Sobald die Patch integriert wurde, wird ein Editor gestartet, so dass Sie die Metainformationen in den Kopfzeilen des Patches einfügen können.

note: type: Plain text
en: Passing I<patch-file> is mainly useful after a build failure that pre-generated this file, and on this ground the given file is removed after integration. Note also that the changes contained in the patch file must already be applied on the tree and that the files modified by the patch must not have supplementary unrecorded changes.
de: Die Verwendung von I<patch-file> ist primär nach einem Baufehler nützlich, der diese Datei vorgenerierte und daher wird die übergebene Datei nach der Integration entfernt. Beachten Sie auch, dass die Änderungen, die in der Patch-Datei angegeben sind, bereits im Baum angewandt worden sein müssen und dass die Dateien, die von diesem Patch geändert werden, keine zusätzlichen, nicht aufgezeichneten Änderungen enthalten dürfen.

note: type: Plain text
en: If the patch generation detects modified binary files, they will be automatically added to B<debian/source/include-binaries> so that they end up in the debian tarball (exactly like B<dpkg-source --include-binaries -b> would do).
de: Falls die Patch-Erzeugung veränderte Binärdateien erkennt, werden diese automatisch zu B<debian/source/include-binaries> hinzugefügt, so dass sie im Debian-Tarball landen (genau wie dies B<dpkg-source --include-binaries -b> machen würde).

note: type: Plain text
en: B<Build options>
de: B<Bau-Optionen>

note: type: TP
en: B<--allow-version-of-quilt-db=>I<version>
de: B<--allow-version-of-quilt-db=>I<Version>

note: type: Plain text
en: Allow B<dpkg-source> to build the source package if the version of the quilt metadata is the one specified, even if B<dpkg-source> doesn't know about it. Effectively this says that the given version of the quilt metadata is compatible with the version 2 that B<dpkg-source> currently supports. The version of the quilt metadata is stored in B<.pc/.version>.
de: Erlaubt es B<dpkg-source>, ein Quellpaket zu bauen, falls die Version der Quilt-Metadaten die angegebene ist, selbst falls B<dpkg-source> nichts davon weiß. Effektiv teilt dies mit, dass die angegebene Version der Quilt-Metadaten zu Version 2, die B<dpkg-source> derzeit unterstützt, kompatibel ist. Die Version der Quilt-Metadaten wird in B<.pc/.version> gespeichert.

note: type: Plain text
en: Do not ignore removed files and include them in the automatically generated patch.
de: Ignoriere entfernte Dateien nicht und füge sie zu dem automatisch generierten Patch hinzu.

note: type: Plain text
en: Include timestamp in the automatically generated patch.
de: Füge Zeitstempel zu dem automatisch generierten Patch hinzu.

note: type: Plain text
en: Add all modified binaries in the debian tarball. Also add them to B<debian/source/include-binaries>: they will be added by default in subsequent builds and this option is thus no more needed.
de: Füge alle veränderten Programme zu dem debian-Tarball hinzu. Füge sie auch in B<debian/source/include-binaries>: sie werden in folgenden Bauten standardmäßig hinzugefügt und diese Option wird daher dann nicht mehr benötigt.

note: type: Plain text
en: Do not try to prepare the build tree by applying patches which are apparently unapplied.
de: Versuche nicht den Bau-Baum durch Anwenden aller derzeit nicht angewandten Patches vorzubreiten.

note: type: Plain text
en: Use B<debian/patches/debian-changes> instead of B<debian/patches/debian-changes->I<version> for the name of the automatic patch generated during build. This option is particularly useful when the package is maintained in a VCS and a patch set can't reliably be generated. Instead the current diff with upstream should be stored in a single patch. The option would be put in B<debian/source/local-options> and would be accompanied by a B<debian/source/local-patch-header> file explaining how the Debian changes can be best reviewed, for example in the VCS that is used.
de: Verwende B<debian/patches/debian-changes> statt B<debian/patches/debian-changes->I<Version> als Namen für den während des Baus automatisch generierten Patch. Diese Option ist insbesondere nützlich, wenn das Paket in einem VCS betreut wird und ein Patch-Satz nicht zuverlässig erstellt werden kann. Stattdessen sollte der aktuelle Diff zu den Quellen der Originalautoren in einem einzelnen Patch gespeichert werden. Diese Option sollte in B<debian/source/local-options> eingestellt werden und würde dann von einer Datei B<debian/source/local-patch-header> begleitet, in der erklärt wird, wie die Debian-Änderungen am besten begutachtet werden können, beispielsweise im eingesetzten VCS.

note: type: Plain text
en: Automatically create the main original tarball as empty if it's missing and if there are supplementary original tarballs. This option is meant to be used when the source package is just a bundle of multiple upstream software and where there's no "main" software.
de: Erstelle den Hauptoriginal-Tarball automatisch als leer falls er fehlt und falls es ergänzende Original-Tarbälle gibt. Diese Option ist dafür gedacht, wenn das Quellpaket nur eine Sammlung von mehreren Softwaren der Originalautoren ist und es keine »Haupt«-Software gibt.

note: type: Plain text
en: By default, dpkg-source will automatically unapply the patches in the B<--after-build> hook if it did apply them during B<--before-build>. Those options allow you to forcefully disable or enable the patch unapplication process. Those options are only allowed in B<debian/source/local-options> so that all generated source packages have the same behavior by default.
de: Standardmäßig wird dpkg-source die Patches im B<--after-build>-Hook entfernen, falls es sie in B<--before-build> angewandt hat. Diese Optionen erlauben es Ihnen, den Patch-Anwendungs- oder -Entfernungs-Prozess zwangsweise zu aktivieren bzw. zu deaktivieren. Diese Optionen sind nur in B<debian/source/local-options> erlaubt, so dass alle erstellten Quellpakete standardmäßig das gleiche Verhalten zeigen.

note: type: Plain text
en: The process fails if an automatic patch has been generated. This option can be used to ensure that all changes were properly recorded in separate quilt patches prior to the source package build. This option is not allowed in B<debian/source/options> but can be used in B<debian/source/local-options>.
de: Dieser Prozess schlägt fehl, falls ein automatischer Patch erstellt wurde. Diese Option kann dazu verwandt werden, sicherzustellen, dass alle Änderungen korrekt in separaten Quilt-Patches aufgezeichnet wurden, bevor das Paket gebaut wurde. Diese Option ist in B<debian/source/options> nicht erlaubt, kann aber in B<debian/source/local-options> verwandt werden.

note: type: Plain text
en: The process doesn't fail if an automatic patch has been generated, instead it's immediately recorded in the quilt series.
de: Der Vorgang schlägt nicht fehl, falls ein automatischer Patch erstellt wurde, stattdessen wird dieser sofort in die Quilt-Serie aufgenommen.

note: type: Plain text
en: B<Extract options>
de: B<Extrahierungs-Optionen>

note: type: Plain text
en: Skips extraction of the debian tarball on top of the upstream sources.
de: Überspringt das Entpacken des Debian-Tarballs auf die Quellen der Originalautoren.

note: type: Plain text
en: Do not apply patches at the end of the extraction.
de: Wende am Ende der Extrahierung keine Patches an.

note: type: Plain text
en: This format is special. It doesn't represent a real source package format but can be used to create source packages with arbitrary files.
de: Dieses Format ist besonders. Es stellt kein echtes Quellpaket dar, kann aber zur Erstellung eines Quellpakets mit beliebigen Dateien verwandt werden.

note: type: Plain text
en: All non-option arguments are taken as files to integrate in the generated source package. They must exist and are preferably in the current directory. At least one file must be given.
de: Alle Argumente, die keine Optionen sind, werden als Dateien verstanden, die in das generierte Quellpaket integriert werden sollen. Sie müssen existieren und sich bevorzugt im aktuellen Verzeichnis befinden. Mindestens eine Datei muss angegeben werden.

note: type: TP
en: B<--target-format=>I<value>
de: B<--target-format=>I<Wert>

note: type: Plain text
en: B<Required>. Defines the real format of the generated source package.  The generated .dsc file will contain this value in its I<Format> field and not "3.0 (custom)".
de: B<Notwendig>. Definiert das echte Format des generierten Quellpakets. Die generierte .dsc-Datei wird diesen Wert und nicht »3.0 (custom)« in ihrem I<Format>-Feld enthalten.

note: type: Plain text
en: This format is experimental.
de: Dieses Format ist experimentell.

note: type: Plain text
en: A source package in this format consists of a single bundle of a git repository B<.git> to hold the source of a package.  There may also be a B<.gitshallow> file listing revisions for a shallow git clone.
de: Ein Quellpaket in diesem Format besteht aus einem einzelnen Bündel eines Git-Depots B<.git>, um die Quellen des Pakets zu verwahren. Es kann auch eine Datei B<.gitshallow> geben, die die Revisionen für einen flachen Git-Clone aufführt.

note: type: Plain text
en: The bundle is cloned as a git repository to the target directory.  If there is a gitshallow file, it is installed as `.git/shallow` inside the cloned git repository.
de: Das Bündel wird als Git-Depot in das Zielverzeichnis geklont. Falls es eine Datei gitshallow gibt, wird diese als ».git/shallow« innerhalb des geklonten Git-Depots installiert.

note: type: Plain text
en: Note that by default the new repository will have the same branch checked out that was checked out in the original source. (Typically "master", but it could be anything.) Any other branches will be available under `remotes/origin/`.
de: Beachten Sie, dass standardmäßig im neuen Depot der gleiche Zweig ausgecheckt ist, der auch in der ursprünglichen Quelle ausgecheckt war (typischerweise »master«, es könnte aber auch was beliebig anderes sein). Alle anderen Zweige sind unter »remotes/origin/« verfügbar.

note: type: Plain text
en: Before going any further, some checks are done to ensure that we don't have any non-ignored uncommitted changes.
de: Bevor fortgefahren wird, werden einige Überprüfungen ausgeführt, um sicherzustellen, dass keine nicht-ignorierten, nicht-übertragene (»uncommitted«) Änderungen vorliegen.

note: type: Plain text
en: B<git-bundle>(1) is used to generate a bundle of the git repository.  By default, all branches and tags in the repository are included in the bundle.
de: B<git-bundle>(1) wird zur Erstellung des Bündels des Git-Depots verwandt. Standardmäßig werden alle Zweige und Markierungen im Depot im Bündel einbezogen.

note: type: TP
en: B<--git-ref=>I<ref>
de: B<--git-ref=>I<Referenz>

note: type: Plain text
en: Allows specifying a git ref to include in the git bundle. Use disables the default behavior of including all branches and tags. May be specified multiple times. The I<ref> can be the name of a branch or tag to include. It may also be any parameter that can be passed to B<git-rev-list>(1). For example, to include only the master branch, use --git-ref=master. To include all tags and branches, except for the private branch, use --git-ref=--all --git-ref=^private
de: Erlaubt die Angabe einer Git-Referenz zur Aufnahme in dem Git-Bündel. Die Verwendung deaktiviert das standardmäßige Verhalten, alle Zweige und Markierungen aufzunehmen. Kann mehrfach angegeben werden. I<Referenz> kann der Name eines Zweiges oder einer Markierung, der/die aufgenommen werden soll, sein. Es kann auch ein Parameter sein, der an B<git-rev-list>(1) übergeben werden kann. Verwenden Sie beispielsweise »--git-ref=master«, um nur den Master-Zweig aufzunehmen. Um alle Markierungen und Zweige außer dem Zweig »private« aufzunehmen, verwenden Sie »--git-ref=--all --git-ref=^private.

note: type: TP
en: B<--git-depth=>I<number>
de: B<--git-depth=>I<Zahl>

note: type: Plain text
en: Creates a shallow clone with a history truncated to the specified number of revisions.
de: Erstellt einen seichten Klon mit einem Verlauf, der bei der angegebenen Anzahl an Revisionen abgeschnitten wird.

note: type: Plain text
en: This format is experimental. It generates a single tarball containing the bzr repository.
de: Dieses Formate ist experimentell. Es erstellt einen einzigen Tarball, der das Bzr-Depot enthält.

note: type: Plain text
en: The tarball is unpacked and then bzr is used to checkout the current branch.
de: Der Tarball wird entpackt und dann wird Bzr verwandt, um den aktuellen Zweig auszuchecken.

note: type: Plain text
en: Then the VCS specific part of the source directory is copied over to a temporary directory. Before this temporary directory is packed in a tarball, various cleanup are done to save space.
de: Dann wird der VCS-spezifische Teil des Quellpakets in ein temporäres Verzeichnis kopiert. Bevor dieses temporäre Verzeichnis in einen Tarball gepackt wird, werden verschiedene Bereinigungen durchgeführt, um Platz zu sparen.

note: type: SH
en: WARNINGS AND ERRORS
de: WARNUNGEN UND FEHLER

note: type: SS
en: no source format specified in debian/source/format
de: kein Quellformat in debian/source/format angegeben

note: type: Plain text
en: The file B<debian/source/format> should always exist and indicate the desired source format. For backwards compatibility, format "1.0" is assumed when the file doesn't exist but you should not rely on this: at some point in the future dpkg-source will be modified to fail when that file doesn't exist.
de: Die Datei B<debian/source/format> sollte immer existieren und das gewünschte Quellformat angeben. Für Rückwärtskompatibilität wird das Format »1.0« angenommen, wenn die Datei nicht existiert, aber Sie sollten sich nicht darauf verlassen: Irgendwann in der Zukunft wird dpkg-source verändert und dann fehlschlagen, wenn diese Datei nicht existiert.

note: type: Plain text
en: The rationale is that format "1.0" is no longer the recommended format, you should usually pick one of the newer formats ("3.0 (quilt)", "3.0 (native)") but B<dpkg-source> will not do this automatically for you.  If you want to continue using the old format, you should be explicit about it and put "1.0" in B<debian/source/format>.
de: Die Begründung liegt darin, dass »1.0« nicht mehr das empfohlene Format ist, Sie sollten normalerweise eines der neueren Formate (»3.0 (quilt)«, »3.0 (native)«) auswählen, aber B<dpkg-source> wird dies nicht für Sie automatisch vornehmen. Falls Sie weiterhin das alte Format verwenden möchten, sollten Sie dies explizit angeben und »1.0« in B<debian/source/format> eintragen.

note: type: SS
en: the diff modifies the following upstream files
de: der Diff verändert die folgenden Dateien der Originalautoren

note: type: Plain text
en: When using source format "1.0" it is usually a bad idea to modify upstream files directly as the changes end up hidden and mostly undocumented in the .diff.gz file. Instead you should store your changes as patches in the debian directory and apply them at build-time. To avoid this complexity you can also use the format "3.0 (quilt)" that offers this natively.
de: Beim Einsatz des Quellformats »1.0« ist es normalerweise keine gute Idee, die Dateien der Originalautoren direkt zu verändern, da die Änderungen größtenteils versteckt und undokumentiert in der diff.gz-Datei verschwinden. Stattdessen sollten Sie Ihre Änderungen als Patches im debian-Verzeichnis speichern und während des Baus anwenden. Um diese Komplexität zu vermeiden, können Sie auch das Format »3.0 (quilt)« verwenden, das dies von sich aus anbietet.

note: type: SS
en: cannot represent change to I<file>
de: kann Änderungen an I<Datei> nicht darstellen

note: type: Plain text
en: Changes to upstream sources are usually stored with patch files, but not all changes can be represented with patches: they can only alter the content of plain text files. If you try replacing a file with something of a different type (for example replacing a plain file with a symlink or a directory), you will get this error message.
de: Änderungen an den Quellen der Originalautoren werden normalerweise als Patch-Dateien gespeichert, aber nicht alle Änderungen können als Patches dargestellt werden: Sie können nur Änderungen am Inhalt einfacher Textdateien vornehmen. Falls Sie versuchen, eine Datei mit etwas eines anderen Typs zu ersetzen (beispielsweise eine einfache Datei mit einem Symlink oder einem Verzeichnis), werden Sie diese Fehlermeldung erhalten.

note: type: SS
en: newly created empty file I<file> will not be represented in diff
de: neu angelegte leere Datei I<Datei> wird im Diff nicht dargestellt werden

note: type: Plain text
en: Empty files can't be created with patch files. Thus this change is not recorded in the source package and you are warned about it.
de: Leere Dateien können nicht mit Patchdateien erstellt werden. Daher wird diese Änderung nicht im Quellpaket aufgezeichnet und Sie erhalten dazu diese Warnung.

note: type: SS
en: executable mode I<perms> of I<file> will not be represented in diff
de: ausführbarer Modus I<Rechte> von I<Datei> wird nicht im Diff dargestellt werden

note: type: SS
en: special mode I<perms> of I<file> will not be represented in diff
de: besonderer Modus I<Rechte> von I<Datei> wird nicht im Diff dargestellt werden

note: type: Plain text
en: Patch files do not record permissions of files and thus modified permissions are not stored in the source package. This warning reminds you of that fact.
de: Patch-Dateien speichern nicht die Rechte von Dateien und daher werden geänderte Rechte nicht im Quellpaket gespeichert. Diese Warnung erinnert Sie an diese Tatsache.

note: type: SH
en: FILE FORMATS
de: DATEIFORMATE

note: type: Plain text
en: This file contains on a single line the format that should be used to build the source package (possible formats are described above). No leading or trailing spaces are allowed.
de: Diese Datei enthält auf einer einzelnen Zeile das Format, das zum Bau des Quellpakets verwandt werden soll (mögliche Formate sind oben beschrieben). Leerzeichen am Zeilenanfang oder -ende sind nicht erlaubt.

note: type: Plain text
en: This file contains a list of binary files (one per line) that should be included in the debian tarball. Leading and trailing spaces are stripped.  Lines starting with "#" are comments and are skipped. Empty lines are ignored.
de: Diese Datei enthält eine Liste von Binärdateien (eine pro Zeile), die in den Debian-Tarball aufgenommen werden sollen. Leerzeichen am Anfang und Ende der Zeile werden entfernt. Zeilen, die mit »#« anfangen, sind Kommentare und werden übersprungen. Leere Zeilen werden ignoriert.

note: type: Plain text
en: This file contains a list of long options that should be automatically prepended to the set of command line options of a B<dpkg-source -b> or B<dpkg-source --print-format> call. Options like B<--compression> and B<--compression-level> are well suited for this file.
de: Diese Datei enhält eine Liste an Optionen, die automatisch vor den Satz an Befehlszeilenoptionen bei einem Aufruf B<dpkg-source -b> oder B<dpkg-source --print-format> gesetzt werden sollen. Optionen wie B<-compression> und B<--compression-level> sind für diese Datei gut geeignet.

note: type: Plain text
en: Each option should be put on a separate line. Empty lines and lines starting with "#" are ignored. The leading "--" should be stripped and short options are not allowed. Optional spaces are allowed around the "=" symbol and optional quotes are allowed around the value.  Here's an example of such a file:
de: Jede Option sollte auf einer separaten Zeile stehen. Leerzeilen und Zeilen, die mit »#« beginnen, werden ignoriert. Das einleitende »--« sollte entfernt werden und kurze Optionen sind nicht erlaubt. Optionale Leerzeichen um das »=«-Symbol sowie optionale Anführungszeichen um den Wert sind erlaubt. Hier ist ein Beispiel für so eine Datei:

note: type: Plain text
en:   # let dpkg-source create a debian.tar.bz2 with maximal compression
      compression = "bzip2"
      compression-level = 9
      # use debian/patches/debian-changes as automatic patch
      single-debian-patch
      # ignore changes on config.{sub,guess}
      extend-diff-ignore = "(^|/)(config.sub|config.guess)$"
de:   # lass dpkg-source ein debian.tar.bz2 mit maximaler Komprimierung
      # erstellen
      compression = "bzip2"
      compression-level = 9
      # verwende debian/patches/debian-changes als automatischen Patch
      single-debian-patch
      # ignoriere Änderungen von config.{sub,guess}
      extend-diff-ignore = "(^|/)(config.sub|config.guess)$"

note: type: Plain text
en: Note: B<format> options are not accepted in this file, you should use B<debian/source/format> instead.
de: Hinweis: B<--format>-Optionen werden in dieser Datei nicht akzeptiert, Sie sollten stattdessen B<debian/source/format> verwenden.

note: type: Plain text
en: Exactly like B<debian/source/options> except that the file is not included in the generated source package. It can be useful to store a preference tied to the maintainer or to the VCS repository where the source package is maintained.
de: Genau wie B<debian/source/options>, außer das die Datei nicht in das erstellte Quellpaket aufgenommen wird. Dies kann nützlich sein, um Voreinstellungen zu speichern, die an einen bestimmten Betreuer oder an ein bestimmtes VCS, in dem das Paket gewartet wird, gebunden sind.

note: type: Plain text
en: Free form text that is put on top of the automatic patch generated in formats "2.0" or "3.0 (quilt)". B<local-patch-header> is not included in the generated source package while B<patch-header> is.
de: Formloser Text, der an den Anfang des in den Formaten »2.0« und »3.0 (quilt)« generierten automatischen Patches gestellt wird. B<local-patch-header> wird dem erstellen Quellpaket nicht hinzugefügt, B<patch-header> dagegen schon.

note: type: Plain text
en: This file lists all patches that have to be applied (in the given order)  on top of the upstream source package. Leading and trailing spaces are stripped. Lines starting with "#" are comments and are skipped. Empty lines are ignored. Remaining lines start with a patch filename (relative to the B<debian/patches/> directory) up to the first space character or the end of line. Optional quilt options can follow up to the end of line or the first "#" preceded by one or more spaces (which marks the start of a comment up to the end of line).
de: Diese Datei führt alle Patches auf, die (in der angegebenen Reihenfolge) auf das Quellpaket der Originalautoren angewandt werden müssen. Leerzeichen am Anfang und Ende werden entfernt. Zeilen, die mit »#« anfangen, sind Kommentare und werden übersprungen. Leere Zeilen werden ignoriert. Die verbleibenen Zeilen beginnen mit dem Dateinamen eines Patches (relativ zum Verzeichnis B<debian/patches/>) bis zum ersten Leerzeichen oder bis zum Zeilenende. Bis zum Ende der Zeile oder bis zum ersten »#« gefolgt von einem oder mehreren Leerzeichen (dies markiert den Beginn eines Kommentars, der bis zum Zeilenende geht) können optionale Quilt-Befehle folgen.

note: type: Plain text
en: dpkg-split - Debian package archive split/join tool
de: dpkg-split - Debian-Paketarchiv Teilungs- und Zusammensetzwerkzeug

note: type: Plain text
en: B<dpkg-split> [I<option>...] I<command>
de: B<dpkg-split> [I<Option> …] I<Befehl>

note: type: Plain text
en: B<dpkg-split> splits Debian binary package files into smaller parts and reassembles them again, to support the storage of large package files on small media such as floppy disks.
de: B<dpkg-split> zerteilt Debian-Binärpaketdateien in kleinere Teile und setzt diese wieder zusammen, um die Lagerung von großen Paketdateien auf kleinen Medien wie Disketten zu ermöglichen.

note: type: Plain text
en: It can be operated manually using the B<--split>, B<--join> and B<--info> options.
de: Es kann manuell mit den Optionen B<--split>, B<--join> und B<--info> verwendet werden.

note: type: Plain text
en: It also has an automatic mode, invoked using the B<--auto> option, where it maintains a queue of parts seen but not yet reassembled and reassembles a package file when it has seen all of its parts. The B<--listq> and B<--discard> options allow the management of the queue.
de: Es hat auch einen automatischen Modus, der über die B<--auto>-Option aufgerufen wird, wo es eine Liste von Teilen, die bereits gesehen, aber noch nicht wieder zusammengesetzt wurden, verwaltet. Sobald alle Teile gesehen wurden, wird dann die Datei wieder zusammengesetzt. Die Optionen B<--listq> und B<--discard> erlauben die Verwaltung dieser Liste.

note: type: Plain text
en: All splitting, joining and queueing operations produce informative messages on standard output; these may safely be ignored.
de: Alle Teilungs-, Vereinigungs- und Warteoperationen erzeugen informative Nachrichten auf der Standardausgabe; diese können ohne Risiko ignoriert werden.

note: type: TP
en: B<-s>, B<--split> I<complete-archive> [I<prefix>]
de: B<-s>, B<--split> I<Komplettarchiv> [I<Präfix>]

note: type: Plain text
en: Splits a single Debian binary package into several parts.
de: Teilt ein einzelnes Debian-Binärpaket in mehrere Teile.

note: type: Plain text
en: The parts are named I<prefix>B<.>I<N>B<of>I<M>B<.deb> where I<N> is the part number, starting at 1, and I<M> is the total number of parts (both in decimal).
de: Die Teile werden I<Präfix>B<.>I<N>B<of>I<M>B<.deb> benannt, wobei I<N> die bei 1 beginnende Teilnummer und I<M> die Gesamtzahl der Teile ist (beide Angaben dezimal).

note: type: Plain text
en: If no I<prefix> is supplied then the I<complete-archive> filename is taken, including directory, with any trailing B<.deb> removed.
de: Falls kein I<Präfix> bereitgestellt wird, wird der Dateiname von I<Komplettarchiv> genommen, einschließlich Verzeichnis, wobei das abschließende B<.deb> entfernt wird.

note: type: TP
en: B<-j>, B<--join> I<part>...
de: B<-j>, B<--join> I<Teil> …

note: type: Plain text
en: Joins the parts of a package file together, reassembling the original file as it was before it was split.
de: Vereint die Teile einer Paketdatei, und baut damit die Originaldatei wieder zusammen, wie sie vor dem Aufteilen war.

note: type: Plain text
en: The part files given as arguments must be all the parts of exactly the same original binary file. Each part must occur exactly once in the argument list, though the parts to not need to be listed in order.
de: Die Teildateien, die als Argument übergeben werden, müssen alle Teile der gleichen Originaldatei sein. Jeder Teil muss genau einmal in der Argumentliste auftauchen, allerdings müssen die Teile nicht in ihrer Reihenfolge aufgeführt werden.

note: type: Plain text
en: The parts must of course all have been generated with the same part size specified at split time, which means that they must usually have been generated by the same invocation of B<dpkg-split --split>.
de: Die Teile müssen natürlich alle mit der gleichen zur Zeit des Aufteilens angegeben Teil-Größe generiert worden sein. Dies bedeutet, dass sie für gewöhnlich von dem gleichen Aufruf von B<dpkg-split --split> erzeugt worden sein müssen.

note: type: Plain text
en: The parts' filenames are not significant for the reassembly process.
de: Die Dateinamen der Teile sind für den Prozess des Wiederzusammenbauens nicht relevant.

note: type: Plain text
en: By default the output file is called I<package>B<_>I<version>B<_>I<arch>B<.deb>.
de: Standardmäßig wird die Ausgabedatei I<Paket>B<->I<Version>B<_>I<Arch>B<.deb> genannt.

note: type: TP
en: B<-I>, B<--info> I<part>...
de: B<-I>, B<--info> I<Teil> …

note: type: Plain text
en: Prints information, in a human-readable format, about the part file(s)  specified. Arguments which are not binary package parts produce a message saying so instead (but still on standard output).
de: Gibt Informationen über die angegebenen Teildatei(en) in menschenlesbarem Format aus. Argumente, die keine Binärpaketdateien sind, führen zu einer entsprechenden Nachricht (allerdings auch in der Standardausgabe).

note: type: TP
en: B<-a>, B<--auto -o> I<complete-output part>
de: B<-a>, B<--auto -o> I< Komplettausgabe Teil>

note: type: Plain text
en: Automatically queue parts and reassemble a package if possible.
de: Reiht Teile automatisch in die Warteschlange und setzt, falls möglich, ein Paket wieder zusammen.

note: type: Plain text
en: The I<part> specified is examined, and compared with other parts of the same package (if any) in the queue of packages file parts.
de: Der angegebene I<Teil> wird untersucht und mit anderen Teilen desselben Paketes (falls vorhanden) in der Warteschlange der Paketdatei-Teile verglichen.

note: type: Plain text
en: If all parts of the package file of which I<part> is a part are available then the package is reassembled and written to I<complete-output> (which should not usually already exist, though this is not an error).
de: Falls alle Teile der Paketdatei, von der I<Teil> ein Teil ist, verfügbar sind, dann wird das Paket wieder zusammengesetzt und nach I<Komplettausgabe> geschrieben (welche für gewöhnlich noch nicht existieren sollte, obgleich dies kein Fehler ist).

note: type: Plain text
en: If not then the I<part> is copied into the queue and I<complete-output> is not created.
de: Falls nicht, wird I<Teil> in die Warteschlange kopiert und I<Komplettausgabe> wird nicht erzeugt.

note: type: Plain text
en: If I<part> is not a split binary package part then B<dpkg-split> will exit with status B<1>; if some other trouble occurs then it will exit with status B<2>.
de: Falls I<Teil> kein Teil eines aufgeteilten Binärpaketes ist, dann beendet sich I<dpkg-split> mit Rückgabecode B<1>; falls irgendwelche anderen Probleme auftreten lautet der Rückgabecode B<2>.

note: type: Plain text
en: The B<--output> or B<-o> option must be supplied when using B<--auto>.  (If this were not mandatory the calling program would not know what output file to expect.)
de: Die Option B<--output> oder B<-o> muss bei Verwenden von B<--auto> angegeben werden. (Falls dies nicht obligatorisch wäre, wüsste das Programm nicht, welche Ausgabedatei es zu erwarten hätte.)

note: type: Plain text
en: Lists the contents of the queue of packages to be reassembled.
de: Listet den Inhalt der Warteschlange der wieder zusammenzubauenden Pakete auf.

note: type: Plain text
en: For each package file of which parts are in the queue the output gives the name of the package, the parts in the queue, and the total number of bytes stored in the queue.
de: Für jede Paketdatei, von der Teile in der Warteschlange sind, enthält die Ausgabe den Namen des Paketes, die Teile in der Warteschlange sowie die Gesamtanzahl gespeicherter Bytes in der Warteschlange.

note: type: TP
en: B<-d>, B<--discard> [I<package>...]
de: B<-d>, B<--discard> [I<Paket> …]

note: type: Plain text
en: This discards parts from the queue of those waiting for the remaining parts of their packages.
de: Dies löscht Teile aus der Warteschlange derer, die auf die verbleibenden Teile ihrer Pakete warten.

note: type: Plain text
en: If no I<package> is specified then the queue is cleared completely; if any are specified then only parts of the relevant package(s) are deleted.
de: Falls kein I<Paket> agegeben wird, wird die Warteschlange komplett geleert; falls irgendwelche angegeben sind, werden nur die Teile des/der passenden Pakete(s) gelöscht.

note: type: TP
en: B<--depotdir>I< directory>
de: B<--depotdir>I< Verzeichnis>

note: type: Plain text
en: Specifies an alternative directory for the queue of parts awaiting automatic reassembly. The default is B</var/lib/dpkg>.
de: Gibt ein alternatives Verzeichnis für die Warteschlange von Teilen, die auf automatisches Wiederzusammenführen warten, an. Standardmäßig ist dies B</var/lib/dpkg>.

note: type: Plain text
en: Specifies the maximum part size when splitting, in kibibytes (1024 bytes). The default is 450 KiB.
de: Gibt die maximale Teilgröße in kibibytes (1024 bytes) beim Aufteilen an. Standardmäßig ist dies 450 kiB.

note: type: TP
en: B<-o>, B<--output> I<complete-output>
de: B<-o>, B<--output> I<Komplettausgabe>

note: type: Plain text
en: Specifies the output file name for a reassembly.
de: Gibt den Ausgabe-Dateinamen für ein Wiederzusammenbauen an.

note: type: Plain text
en: This overrides the default for a manual reassembly (B<--join>)  and is mandatory for an automatic queue-or-reassemble (B<--auto>).
de: Dies hebt die Voreinstellung für ein manuelles Wiederzusammenbauen auf (B<--join>) und ist zwingend für ein automatisches Einreihen-oder-Zusammenbauen (B<--auto>) notwendig.

note: type: Plain text
en: When doing automatic queue-or-reassembly B<dpkg-split> usually prints a message if it is given a I<part> that is not a binary package part. This option suppresses this message, to allow programs such as B<dpkg> to cope with both split and unsplit packages without producing spurious messages.
de: Falls Sie ein automatisches Einreihen oder Wiederzusammensetzen durchführen, gibt B<dpkg-split> normalerweise eine Meldung aus, falls ein übergebener I<Teil> kein Binärpaketteil ist. Diese Option unterdrückt diese Meldung um Programmen wie B<dpkg> zu erlauben, sowohl mit geteilten als auch ungeteilten Paketen umzugehen, ohne störende Meldungen zu erzeugen.

note: type: Plain text
en: Forces the output filenames generated by B<--split> to be msdos-compatible.
de: Erzwingt, dass die von B<--split> erzeugten Ausgabe-Dateinamen MSDOS-kompatibel sind.

note: type: Plain text
en: This mangles the prefix - either the default derived from the input filename or the one supplied as an argument: alphanumerics are lowercased, plus signs are replaced by B<x>'s and all other characters are discarded.
de: Dies verstümmelt den Präfix - entweder den voreingestellten aus dem Eingabe-Dateinamen abgeleiteten oder den als Argument übergebenen: alphanummerische Zeichen werden klein geschrieben, Pluszeichen werden durch B<x> ersetzt und alle anderen Zeichen werden entfernt.

note: type: Plain text
en: The result is then truncated as much as is necessary, and filenames of the form I<prefixN>B<of>I<M>B<.deb> are generated.
de: Das Ergebnis wird dann soweit wie nötig abgeschnitten, und Dateinamen der Form I<PräfixN>B<of>I<M>B<.deb> werden generiert.

note: type: Plain text
en: The requested split, merge, or other command succeeded.  B<--info> commands count as successful even if the files are not binary package parts.
de: Das angeforderte Aufteilen, Zusammenfügen oder ein anderer Befehl war erfolgreich. B<--info>-Befehle werden als erfolgreich gewertet, sogar falls die Dateien keine Teile eines Binärpaketes waren.

note: type: Plain text
en: Only occurs with B<--auto> and indicates that the I<part> file was not a binary package part.
de: Tritt nur bei B<--auto> auf und zeigt an, dass die Datei I<Teil> kein Teil eines Binärprogramms war.

note: type: Plain text
en: Some kind of trouble happened, such as a system call failure, a file that looked like a package part file but was corrupted, a usage error or some other problem.
de: Eine bestimmte Gattung von Problemen trat auf, wie zum Beispiel ein Fehlschlag eines Systemaufrufs, eine Datei, die wie ein Paketteil aussah aber beschädigt war, ein Benutzungsfehler oder einige andere Probleme.

note: type: Plain text
en: Full details of the packages in the queue are impossible to get without digging into the queue directory yourself.
de: Volle Details über die Pakete in der Warteschlange sind nicht zu erhalten, ohne selbst im Warteschlangenverzeichnis zu wühlen.

note: type: Plain text
en: There is no easy way to test whether a file that may be a binary package part is one.
de: Es gibt keine einfache Art zu testen, ob eine Datei, die ein Teil eines Binärpaketes sein könnte, eines ist.

note: type: Plain text
en: The default queue directory for part files awaiting automatic reassembly.
de: Das voreingestellte Verzeichnis für die Warteschlange der Teil-Dateien, die auf automatisches Zusammenfügen warten.

note: type: Plain text
en: The filenames used in this directory are in a format internal to B<dpkg-split> and are unlikely to be useful to other programs, and in any case the filename format should not be relied upon.
de: Die in diesem Verzeichnis benutzten Dateinamen liegen in einem intern B<dpkg-split>-Format vor und sind sehr wahrscheinlich für andere Programme nicht nützlich, und in keinem Fall sollte sich auf das Format der Dateinamen verlassen werden.

note: type: TH
en: Debian project
de: Debian-Projekt

note: type: Plain text
en: dpkg-statoverride - override ownership and mode of files
de: dpkg-statoverride - über Eigentümerschaft und Modus von Dateien hinwegsetzen

note: type: Plain text
en: B<dpkg-statoverride> [I<option>...] I<command>
de: B<dpkg-statoverride> [I<Option> …] I<Befehl>

note: type: Plain text
en: `B<stat overrides>' are a way to tell B<dpkg>(1)  to use a different owner or mode for a file when a package is installed. (note: I use the word `file' here, but in reality this can be any filesystem object that dpkg handles, including directories, devices, etc.). This can be used to force programs that are normally setuid to be install without a setuid flag, or only executable by a certain group.
de: »B<Stat-Hinwegsetzungen>« sind eine Möglichkeit B<dpkg>(1) zu berichten, einen anderen Eigentümer oder Modus für eine Datei zu verwenden, wenn ein Paket installiert wird. (Hinweis: Ich verwende das Wort »Datei« hier, aber tatsächlich kann dies jedes Dateisystemobjekt sein, das Dpkg handhabt, darunter Verzeichnisse, Geräte, usw.). Dies kann dazu verwendet werden, Programme, die normalerweise setuid sind, dazu zu zwingen, ohne setuid-Markierung zu installieren, oder nur von einer bestimmten Gruppe ausführbar zu sein.

note: type: Plain text
en: B<dpkg-statoverride> is a utility to manage the list of stat overrides. It has three basic functions: adding, removing and listing overrides.
de: B<dpkg-statoverride> ist ein Hilfswerkzeug um die Liste der Status-Hinwegsetzungen zu verwalten. Es hat drei grundlegende Funktionen: Hinzufügen, Entfernen und Auflisten von Hinwegsetzungen.

note: type: TP
en: B<--add>I< user group mode file>
de: B<--add>I< Benutzer Gruppe Modus Datei>

note: type: Plain text
en: Add an override for I<file>. I<file> does not need to exist when this command is used; the override will be stored and used later.  Users and groups can be specified by their name (for example B<root> or B<nobody>), or by their number by prepending the number with a `B<#>' (for example B<#0> or B<#65534>). The I<mode> needs to be specified in octal.
de: Füge eine Hinwegsetzung für I<Datei> hinzu. I<Datei> muss noch nicht existieren wenn dieser Befehl verwendet wird; die Hinwegsetzung wird aufbewahrt und später verwendet. Benutzer und Gruppen können über ihren Namen (beispielsweise B<root> oder B<nobody>) spezifiziert werden, oder über ihre Nummer mit vorangestelltem »B<#>« (beispielsweise B<#0> oder B<#65534>). Der I<Modus> muss oktal angegeben werden.

note: type: Plain text
en: If --update is specified and I<file> exists, it is immediately set to the new owner and mode.
de: Falls --update angegeben ist und die I<Datei> existiert, dann wird diese sofort auf den neuen Eigentümer und Modus eingestellt.

note: type: Plain text
en: Remove an override for I<file>, the status of I<file> is left unchanged by this command.
de: Entfernt eine Hinwegsetzung für I<Datei>, der Status von I<Datei> bleibt durch diesen Befehl unverändert.

note: type: TP
en: B<--list> [I<glob-pattern>]
de: B<--list> [I<Glob-Muster>]

note: type: Plain text
en: List all overrides. If a glob pattern is specified restrict the output to overrides which match the glob. If there are no overrides or none match the glob B<dpkg-statoverride> will exit with an exitcode of 1.
de: Liste alle Hinwegsetzungen auf. Falls ein Glob-Muster spezifiziert wurde, begrenze die Ausgabe auf Hinwegsetzungen, die auf den Glob passen. Falles es keine Hinwegsetzungen gibt oder keine auf den Glob passt, wird sich B<dpkg-statoverride> mit einem Exit-Wert von 1 beenden.

note: type: Plain text
en: Change the I<directory> of the dpkg database where the statoverride file is also stored. Defaults to I</var/lib/dpkg>.
de: Wechsle das I<Verzeichnis> der Dpkg-Datenbank, wo auch die statoverride-Datei gelagert ist. Der Standard ist I</var/lib/dpkg>.

note: type: Plain text
en: Force an action, even if a sanity check would otherwise prohibit it.  This is necessary to override an existing override.
de: Erzwinge eine Aktion, selbst wenn eine Sinn-Überprüfung diese normalerweise verböte. Dies ist notwendig, um sich über eine existierende Hinwegsetzung hinwegzusetzen.

note: type: Plain text
en: Immediately try to change the file to the new owner and mode if it exists.
de: Versuche die Datei sofort auf den neuen Eigentümer und neuen Modus zu ändern, falls sie existiert.

note: type: Plain text
en: Be less verbose about what we do.
de: Sei nicht so ausführlich darüber, was wir machen.

note: type: Plain text
en: File which contains the current list of stat overrides of the system. It is located in the dpkg administration directory, along with other files important to dpkg, such as `status' or `available'.
de: Datei, die die aktuelle Liste der Hinwegsetzungen auf dem System enthält. Sie befindet sich im Dpkg-Administrationsverzeichnis, zusammen mit anderen für Dpkg wichtigen Dateien, wie »status« oder »available«.

note: type: Plain text
en: Note: B<dpkg-statoverride> preserves the old copy of this file, with extension "-old", before replacing it with the new one.
de: Hinweis: B<dpkg-statoverride> erhält die alte Kopie dieser Datei mit der Endung »-old« bevor es sie mit einer neuen ersetzt.

note: type: Plain text
en: dpkg-trigger - a package trigger utility
de: dpkg-trigger - ein Paket-Trigger-Hilfswerkzeug

note: type: Plain text
en: B<dpkg-trigger> [I<option>...] I<trigger-name>
de: B<dpkg-trigger> [I<Option>...] I<Trigger-Name>

note: type: Plain text
en: B<dpkg-trigger> [I<option>...] I<command>
de: B<dpkg-trigger> [I<Option> …] I<Befehl>

note: type: Plain text
en: B<dpkg-trigger> is a tool to explicitly activate triggers and check for its support on the running B<dpkg>.
de: B<dpkg-trigger> ist ein Werkzeug, um Trigger (deutsch: Auslöser) explizit zu aktivieren und den laufenden B<dpkg> auf deren Unterstützung hin zu überprüfen.

note: type: Plain text
en: This can be used by maintainer scripts in complex and conditional situations where the file triggers, or the declarative B<activate> triggers control file directive, are insufficiently rich. It can also be used for testing and by system administrators (but note that the triggers won't actually be run by B<dpkg-trigger>).
de: Dies kann von Betreuerskripten in komplexen und if-then-else-Situationen verwandt werden, wo die Datei-Trigger oder die Steuerung von Dateidirektiven durch explizite B<activate>-Trigger nicht ausreichen. Es kann auch zum Testen und von Systemadministratoren verwandt werden (beachten Sie aber, dass Trigger nicht tatsächlich durch B<dpkg-trigger> ausgeführt werden).

note: type: Plain text
en: Unrecognized trigger name syntaxes are an error for B<dpkg-trigger>.
de: Nicht erkannte Triggernamen-Syntaxen sind für B<dpkg-trigger> ein Fehler.

note: type: Plain text
en: Check if the running B<dpkg> supports triggers (usually called from a postinst). Will exit B<0> if a triggers-capable B<dpkg> has run, or B<1> with an error message to stderr if not. Normally, however, it is better just to activate the desired trigger with B<dpkg-trigger>.
de: Überprüfe, ob der laufende B<dpkg> Trigger unterstützt (normalerweise vom Postinst aufgerufen). Endet mit B<0>, falls ein Trigger-fähiger B<dpkg> ausgeführt wurde, oder mit B<1> und einer Fehlermeldung nach Stderr, falls nicht. Normalerweise ist es allerdings besser, einfach den gewünschten Trigger mit B<dpkg-trigger> zu aktivieren.

note: type: TP
en: B<--by-package=>I<package>
de: B<--by-package=>I<Paket>

note: type: Plain text
en: Override trigger awaiter (normally set by B<dpkg> through the B<DPKG_MAINTSCRIPT_PACKAGE> environment variable of the maintainer scripts, naming the package to which the script belongs, and this will be used by default).
de: Überschreibe den Trigger-Erwartenden (normalerweise wird dies von B<dpkg> durch die Umgebungsvariable B<DPKG_MAINTSCRIPT_PACKAGE> der Betreuerskripte gesetzt, wobei das Paket benannt wird, zu dem das Skript gehört und dies wird standardmäßig verwandt).

note: type: Plain text
en: This option arranges that the calling package T (if any) need not await the processing of this trigger; the interested package(s) I, will not be added to T's trigger processing awaited list and T's status is unchanged.  T may be considered installed even though I may not yet have processed the trigger.
de: Diese Option arrangiert, dass das aufrufende Paket T (falls zutreffend) nicht auf die Abarbeitung des Triggers warten muss, das bzw. die interessierte(n) Paket(e) I werden nicht zu der Liste der auf Bearbeitung wartenden Trigger von T hinzugefügt und der Status von T bleibt unverändert. T kann als installiert betrachtet werden, obwohl I den Trigger noch nicht verarbeitet haben könnte.

note: type: Plain text
en: Just test, do not actually change anything.
de: Nur testen, nichts tatsächlich ändern.

note: type: Plain text
en: dpkg-vendor - queries information about distribution vendors
de: dpkg-vendor - fragt Informationen über den Distributionslieferanten ab

note: type: Plain text
en: B<dpkg-vendor> [I<option>...] I<command>
de: B<dpkg-vendor> [I<Option> …] I<Befehl>

note: type: Plain text
en: B<dpkg-vendor> is a tool to query information about vendors listed in B</etc/dpkg/origins>. B</etc/dpkg/origins/default> contains information about the current vendor.
de: B<dpkg-vendor> ist ein Werkzeug, um Informationen über in B</etc/dpkg/origins> aufgeführte Lieferanten (engl. »vendor«) abzufragen. B</etc/dpkg/origins/default> enthält Informationen über den aktuellen Lieferanten.

note: type: TP
en: B<--is>I< vendor>
de: B<--is>I< Lieferant>

note: type: Plain text
en: Exits with B<0> if the current vendor is I<vendor>. Otherwise exits with non-zero.
de: Beendet sich mit B<0>, falls der aktuelle Lieferant I<Lieferant> ist, ansonsten mit einem von Null verschiedenen Wert.

note: type: TP
en: B<--derives-from>I< vendor>
de: B<--derives-from>I< Lieferant>

note: type: Plain text
en: Exits with B<0> if the current vendor distribution is a derivative of I<vendor>, otherwise exits with non-zero. It uses the "Parent" field to browse all ancestors of the current vendor.
de: Beendet sich mit B<0>, falls die aktuelle Lieferant-Distribution von I<Lieferant> abgeleitet ist, ansonsten mit einem von Null verschiedenen Wert. Es verwendet das Feld »Parent«, um alle Vorfahren des aktuellen Lieferanten zu ermitteln.

note: type: TP
en: B<--query>I< field>
de: B<--query>I< Feld>

note: type: Plain text
en: Print on standard output the value of the vendor-specific I<field> for the current vendor.
de: Gibt auf der Standardausgabe den Wert des Lieferanten-spezifischen I<Feld>es für den aktuellen Lieferanten aus.

note: type: TP
en: B<--vendor>I< vendor>
de: B<--vendor>I< Lieferant>

note: type: Plain text
en: Assumes the current vendor is I<vendor> instead of discovering it with the B<DEB_VENDOR> environment variable or B</etc/dpkg/origins/default>.
de: Nimmt an, dass der aktuelle Lieferant I<Lieferant> ist, statt ihn über die Umgebungsvariable B<DEB_VENDOR> oder aus B</etc/dpkg/origins/default> zu ermitteln.

note: type: Plain text
en: This setting defines the current vendor. If not set, it will discover the current vendor by reading B</etc/dpkg/origins/default>.
de: Diese Einstellung definiert den aktuellen Lieferanten. Falls nicht gesetzt, wird er aus B</etc/dpkg/origins/default> ermittelt.

note: type: Plain text
en: dselect - Debian package management frontend
de: dselect - Debian-Paketverwaltungsoberfläche

note: type: Plain text
en: B<dselect> [I<option>...] [I<action>]
de: B<dselect> [I<Option> …] I<Aktion>

note: type: Plain text
en: B<dselect>
    is one of the primary user interfaces for managing packages on a Debian
    system. At the B<dselect> main menu, the system administrator can:
     - Update the list of available package versions,
     - View the status of installed and available packages,
     - Alter package selections and manage dependencies,
     - Install new packages or upgrade to newer versions.
de: B<dselect>
    ist eine der primären Benutzerschnittstellen zur Verwaltung von Paketen auf
    einem Debian-System. Im Basis-Menü von B<dselect> kann der Systemadministrator:
     - Die Liste der verfügbaren Paketversionen aktualisieren,
     - Den Status der installierten und verfügbaren Pakete betrachten,
     - Die Paketauswahl ändern und Abhängigkeiten verwalten,
     - Neue Pakete installieren oder ein Upgrade auf neuere Versionen durchführen.

note: type: Plain text
en: B<dselect> operates as a front-end to B<dpkg>(1), the low-level debian package handling tool. It features a full-screen package selections manager with package depends and conflicts resolver. When run with administrator privileges, packages can be installed, upgraded and removed. Various access methods can be configured to retrieve available package version information and installable packages from package repositories.  Depending on the used access method, these repositories can be public archive servers on the internet, local archive servers or cdroms.  The recommended access method is I<apt>, which is provided by the package B<apt>.
de: B<dselect> arbeitet als Oberfläche von B<dpkg>(1), dem systemnahen Debian-Paket-Handhabungswerkzeug. Es bietet einen Vollbildschirm-Paketauswahl-Verwalter mit einem Paketeabhängigkeits- und -konfliktlöser. Bei Aufruf mit Administratorprivilegien können Pakete installiert und entfernt sowie Upgrades durchgeführt werden. Verschiedene Zugriffsmethoden können konfiguriert werden um verfügbare Paketinformationen und installierbare Pakete aus Paketdepots zu holen. Abhängig von der verwendeten Zugriffsmethode können diese Depots öffentliche Archiv-Server im Internet, lokale Archiv-Server oder CD-ROMs sein. Die empfohlene Zugriffsmethode ist I<apt>, die vom Paket B<apt> bereitgestellt wird.

note: type: Plain text
en: Normally B<dselect> is invoked without parameters. An interactive menu is presented, offering the user a list of actions. If an action is given as argument, then that action is started immediately. Several command line parameters are still available to modify the running behaviour of B<dselect> or show additional information about the program.
de: Normalerweise wird B<dselect> ohne Parameter aufgerufen. Es wird ein interaktives Menü präsentiert, das dem Benutzer eine Liste von Aktionen anbietet. Falls eine Aktion als Argument übergeben wird, wird diese Aktion sofort begonnen. Es sind noch mehrere Kommandozeilenparameter vorhanden, um das Laufzeitverhalten von B<dselect> zu verändern oder zusätzliche Informationen über das Programm anzuzeigen.

note: type: Plain text
en: All options can be specified both on the command line and in the B<dselect> configuration file I</etc/dpkg/dselect.cfg> or the files on the configuration directory I</etc/dpkg/dselect.cfg.d/>. Each line in the configuration file is either an option (exactly the same as the command line option but without leading dashes) or a comment (if it starts with a B<#>).
de: Alle Optionen können sowohl auf der Kommandozeile als auch in der Konfigurationsdatei I</etc/dpkg/dselect.cfg> oder in den Dateien im Konfigurationsverzeichnis I</etc/dpkg/dselect.cfg.d/> von B<dselect> angegeben werden. Jede Zeile in der Konfigurationsdatei ist entweder eine Option (exakt identisch mit der Kommandozeilenoption, nur ohne einleitende Gedankenstriche) oder ein Kommentar (falls sie mit B<#> beginnt).

note: type: Plain text
en: Changes the directory where the dpkg `I<status>', `I<available>' and similar files are located. This defaults to I</var/lib/dpkg> and normally there shouldn't be any need to change it.
de: Ändert das Verzeichnis, in dem die Dateien »I<status>«, »I<available>« und ähnliche Dateien von Dpkg liegen. Standardmäßig ist dies I</var/lib/dpkg> und normalerweise sollte es keinen Grund geben, dieses zu ändern.

note: type: TP
en: B<--debug>I< file >|I< >B<-D>I<file>
de: B<--debug>I< Datei>|I< >B<-D>I<Datei>

note: type: Plain text
en: Turn on debugging. Debugging information is sent to I<file>.
de: Aktiviere Debugging. Debug-Informationen werden nach I<Datei> gesendet.

note: type: Plain text
en: Turns on expert mode, i.e. doesn't display possibly annoying help messages.
de: Aktiviert den Expertenmodus, d.h. zeigt keine möglicherweise nervenden Hilfeinformationen an.

note: type: TP
en: B<--colour>|B<--color> I<screenpart:>[I<foreground>],[I<background>][I<:attr>[I<+attr+...>]]
de: [B<--colour>|B<--color> I<Bildschirmteil:>[I<Vordergrund>],[I<Hintergrund>][I<:Attr>[I<+Attr+…>]]]

note: type: Plain text
en: Configures screen colors. This works only if your display supports colors.  This option may be used multiple times (and is best used in I<dselect.cfg>). Each use changes the color (and optionally, other attributes) of one part of the screen.  The parts of the screen (from top to bottom) are:
de: Konfiguriert die Bildschirmfarben. Dies funktioniert nur, falls Ihr Bildschirm Farben unterstützt. Diese Option kann mehrfach verwendet werden (und wird am besten in I<dselect.cfg> verwendet). Jede Verwendung ändert die Farben (und optional andere Attribute) eines Teils des Bildschirms. Die Teile des Bildschirms (von oben nach unten) sind:

note: type: Plain text
en: The screen title.
de: Der Bildschirm-Titel.

note: type: Plain text
en: The header line above the list of packages.
de: Die Kopfzeile über der Paketliste.

note: type: Plain text
en: The scrolling list of packages (and also some help text).
de: Die scrollende Liste von Paketen (und auch etwas Hilfetext).

note: type: Plain text
en: The selected item in the list.
de: Der ausgewählte Eintrag in der Liste.

note: type: Plain text
en: In the list of packages, the text indicating the current state of each package.
de: In der Liste der Pakete, der Text, der den aktuellen Zustand jedes Pakets anzeigt.

note: type: Plain text
en: In the list of packages, the text indicating the current state of the currently selected package.
de: In der Liste der Pakete, der Text, der den aktuellen Zustand des aktuell ausgewählten Paketes anzeigt.

note: type: Plain text
en: The header line that displays the state of the currently selected package.
de: Die Kopfzeile, die den Zustand des aktuell ausgewählten Paketes anzeigt.

note: type: Plain text
en: The package's short description.
de: Die Kurzbeschreibung des Pakets.

note: type: Plain text
en: Used to display package info such as the package's description.
de: Verwendet um Paketinformationen wie die Paketbeschreibung anzuzeigen.

note: type: Plain text
en: The last line of the screen when selecting packages.
de: Die unterste Zeile des Bildschirms bei der Paketauswahl.

note: type: Plain text
en: Used to display query lines
de: Verwendet zum Anzeigen von Abfragezeilen

note: type: Plain text
en: Color of help screens.
de: Farbe der Hilfebildschirme.

note: type: Plain text
en: After the part of the screen comes a colon and the color specification. You can specify either the foreground color, the background color, or both, overriding the compiled-in colors. Use standard curses color names.
de: Nach dem Teil des Bildschirms kommt ein Doppelpunkt und die Farbangabe. Sie können entweder die Vordergrundfarbe, die Hintergrundfarbe oder beide angeben und damit die eingebauten Werte überschreiben. Verwenden Sie die Standard-Farbnamen von Curses.

note: type: Plain text
en: Optionally, after the color specification is another colon, and an attribute specification. This is a list of one or more attributes, separated by plus ("+") characters. Available attributes include (not all of these will work on all terminals): normal, standout, underline, reverse, blink, bright, dim, bold
de: Optional kann nach der Farbangabe ein weiterer Doppelpunkt und eine Attribut-Angabe folgen. Dies ist eine Liste von einem oder mehreren Attribut(en), getrennt durch Plus-Zeichen (»+«). Folgende Attribute sind verfügbar (aber nicht alle funktionieren in allen Terminals): normal, standout, underline, reverse, blink, bright, dim, bold

note: type: Plain text
en: Print a brief help text and exit successfully.
de: Gib einen kurzen Hilfetext aus und beende sich erfolgreich.

note: type: Plain text
en: Print version information and exit successfully.
de: Gebe Versionsinformationen aus und beende sich erfolgreich.

note: type: Plain text
en: When B<dselect> is started it can perform the following actions, either directly if it was specified on the command line or by prompting the user with a menu of available actions if running interactively:
de: Wenn B<Dselect> gestartet wird, kann es die folgenden Aktionen durchführen, entweder direkt, falls sie auf der Kommandozeile angegeben wurde oder indem dem Benutzer ein Menü der verfügbaren Aktionen bei interkativen Betrieb angezeigt wird:

note: type: SS
en: access
de: Zugriff

note: type: Plain text
en: Choose and configure an access method to access package repositories.
de: Wähle und konfiguriere eine Zugriffsmethode für Paketdepots.

note: type: Plain text
en: By default, B<dselect> provides several methods such as I<cdrom>, I<multi_cd>, I<nfs>, I<multi_nfs>, I<harddisk>, I<mounted>, I<multi_mount>, I<floppy> or I<ftp>, but other packages may provide additional methods, eg. the I<apt> access method provided by the B<apt> package.
de: Standardmäßig stellt B<dselect> mehrere Methoden wie I<cdrom>, I<multi_cd>, I<nfs>, I<multi_nfs>, I<harddisk>, I<mounted>, I<multi_mount>, I<floppy> oder I<ftp> zur Verfügung, aber andere Pakete können zusätzliche Methoden bereitstellen, z.B. stellt das B<apt>-Paket die I<apt>-Zugriffsmethode bereit.

note: type: Plain text
en: The use of the I<apt> access method is strongly recommended.
de: Die Verwendung der I<apt>-Zugriffsmethode wird nachdrücklich empfohlen.

note: type: SS
en: update
de: Erneuern

note: type: Plain text
en: Refresh the available packages database.
de: Die verfügbare Paketdatenbank auffrischen.

note: type: Plain text
en: Retrieves a list of available package versions from the package repository, configured for the current access method, and update the dpkg database. The package lists are commonly provided by the repository as files named I<Packages> or I<Packages.gz>.  These files can be generated by repository maintainers, using the program B<dpkg-scanpackages>(1).
de: Holt die Liste der verfügbaren Paketversionen aus dem Paket-Depot, das für die aktuelle Zugriffsmethode konfiguriert ist, und aktualisiert die Datenbank von dpkg. Die Paketliste wird im Depot typischerweise in Dateien mit den Namen I<Packages> oder I<Packages.gz> bereitgestellt. Diese Dateien können von den Betreuern des Depots mit dem Programm B<dpkg-scanpackages>(1) erstellt werden.

note: type: Plain text
en: Details of the update action depend on the access method's implementation.  Normally the process is straightforward and requires no user interaction.
de: Die Details der Aktion »Erneuern« hängen von der Implementierung der Zugriffsmethode ab. Normalerweise ist der Prozess unkompliziert und verlangt keine Benutzerinteraktionen.

note: type: SS
en: select
de: Auswählen

note: type: Plain text
en: View or manage package selections and dependencies.
de: Paketauswahlen oder -abhängigkeiten betrachten oder verwalten.

note: type: Plain text
en: This is the main function of B<dselect>. In the select screen, the user can review a list of all available and installed packages. When run with administrator privileges, it is also possible to interactively change packages selection state. B<dselect> tracks the implications of these changes to other depending or conflicting packages.
de: Dies ist die Hauptfunktionalität von B<dselect>. Im Auswahlbildschirm kann der Benutzer die Liste der verfügbaren und installierten Pakete begutachten. Wenn B<dselect> mit administrativen Rechten ausgeführt wird ist es auch möglich, den Paketauswahlzustand interaktiv zu verändern. B<dselect> verfolgt die Auswirkungen dieser Änderungen auf andere abhängige oder im Konflikt stehende Pakete.

note: type: Plain text
en: When a conflict or failed depends is detected, a dependency resolution subscreen is prompted to the user. In this screen, a list of conflicting or depending packages is shown, and for each package listed, the reason for its listing is shown. The user may apply the suggestions proposed by B<dselect>, override them, or back out all the changes, including the ones that created the unresolved depends or conflicts.
de: Wenn ein Konflikt oder eine fehlgeschlagene Abhängigkeit erkannt wird, wird dem Benutzer ein Unterbildschirm mit einer Lösung der Abhängigkeitsproblematik angeboten. Auf diesem Bildschirm wird eine Liste der im Konflikt stehenden oder abhängigen Pakete gezeigt, wobei für jedes aufgeführte Paket der Grund ebenfalls angegeben ist. Der Benutzer kann die Vorschläge von B<dselect> annehmen, sich über sie hinwegsetzen oder alle Änderungen zurücknehmen, darunter diejenigen, die zu den unerfüllten Abhängigkeiten oder Konflikten führten.

note: type: Plain text
en: The use of the interactive package selections management screen is explained in more detail below.
de: Die Verwendung des interaktiven Paketauswahlbildschirms wird unten detaillierter beschrieben.

note: type: SS
en: install
de: Installieren

note: type: Plain text
en: Installs selected packages.
de: Installiert ausgewählte Pakete.

note: type: Plain text
en: The configured access method will fetch installable or upgradable packages from the relevant repositories and install these using B<dpkg>.  Depending on the implementation of the access method, all packages can be prefetched before installation, or fetched when needed.  Some access methods may also remove packages that were marked for removal.
de: Die konfigurierte Zugriffsmethode wird installierbare oder für ein Upgrade verfügbare Pakete aus den relevanten Depots holen und dann mittels B<dpkg> installieren. Abhängig von der Implementation der Zugriffsmethode können alle Pakete vor der Installation bereits geholt werden, oder bei Bedarf geholt werden. Bei einigen Zugriffsmethoden werden auch Pakete entfernt, die zur Entfernung markiert wurden.

note: type: Plain text
en: If an error occurred during install, it is usually advisable to run install again. In most cases, the problems will disappear or be solved.  If problems persist or the installation performed was incorrect, please investigate into the causes and circumstances, and file a bug in the Debian bug tracking system. Instructions on how to do this can be found at http://bugs.debian.org/ or by reading the documentation for B<bug>(1) or B<reportbug>(1), if these are installed.
de: Falls während der Installation ein Fehler auftrat ist es normalerweise empfehlenswert, die Installation erneut durchzuführen. In den meisten Fällen wird das Problem verschwinden oder gelöst werden. Falls Probleme bleiben oder die durchgeführte Installation nicht korrekt war, untersuchen Sie bitte den Grund und die Umstände und reichen Sie einen Fehler in der Fehlerdatenbank von Debian ein. Anleitungen wie dies erfolgen kann, sind auf http://bugs.debian.org/ verfügbar oder können durch Lesen der Dokumentation für B<bug>(1) oder B<reportbug>(1) (falls diese installiert sind) erhalten werden.

note: type: Plain text
en: Details of the install action depend on the access method's implementation.  The user's attention and input may be required during installation, configuration or removal of packages. This depends on the maintainer scripts in the package. Some packages make use of the B<debconf>(1)  library, allowing for more flexible or even automated installation setups.
de: Details der Installationsaktion hängen von der Implementierung der Zugriffsmethode ab. Die Aufmerksamkeit und Eingabe des Benutzers könnten während der Installation, Konfiguration oder dem Entfernen von Paketen notwendig sein. Dies hängt von den Betreuerskripten im Paket ab. Einige Pakete verwenden die Bibliothek B<debconf>(1), die flexiblere oder sogar automatisierte Installationseinrichtungen erlaubt.

note: type: SS
en: config
de: Konfig

note: type: Plain text
en: Configures any previously installed, but not fully configured packages.
de: Konfiguriert alle bisher installierten, aber noch nicht voll konfigurierten Pakete.

note: type: SS
en: remove
de: Löschen

note: type: Plain text
en: Removes or purges installed packages, that are marked for removal.
de: Löscht oder entfernt installierte Pakete vollständig, die zum Löschen markiert sind.

note: type: SS
en: quit
de: Beenden

note: type: Plain text
en: Quit B<dselect>
de: B<Dselect> beenden

note: type: Plain text
en: Exits the program with zero (successful) errorcode.
de: Beendet das Programm mit dem Fehlercode Null (erfolgreich).

note: type: SH
en: Package selections management
de: Paketauswahlverwaltung

note: type: Plain text
en: B<dselect> directly exposes the administrator to some of the complexities involved with managing large sets of packages with many interdependencies. For a user who is unfamiliar with the concepts and the ways of the debian package management system, it can be quite overwhelming. Although B<dselect> is aimed at easing package management and administration, it is only instrumental in doing so and can not be assumed to be a sufficient substitute for administrator skill and understanding. The user is required to be familiar with the concepts underlying the Debian packaging system.  In case of doubt, consult the B<dpkg>(1) manpage and the Debian Policy manual, contained in the B<debian-policy> package.
de: B<dselect> setzt den Administrator direkt einigen Komplexitäten aus, die beim Verwalten großer Paketmengen mit vielen Abhängigkeiten untereinander auftreten. Für einen Benutzer, der sich mit den Konzepten und den Arten des Debian-Paktverwaltungssystems nicht auskennt kann dies recht überwältigend sein. Obwohl B<dselect> darauf abzielt, die Paketverwaltung und -administration zu vereinfachen, kann es dazu nur ein Werkzeug sein und somit nicht ausreichende Administratorfähigkeiten und Administratorverständnis ersetzen. Es wird vom Benutzer erwartet, dass er mit den Konzepten des unterliegenden Debian-Paketsystems vertraut ist. Im Zweifelsfall ziehen Sie die Handbuchseite B<dpkg>(1) und das Debian-Richtlinien-Handbuch zu Rate. Letzteres ist auf Englisch im Paket B<debian-policy> enthalten.

note: type: Plain text
en: Unless B<dselect> is run in expert or immediate mode, a help screen is first displayed when choosing this action from the menu. The user is I<strongly> advised to study all of the information presented in the online help screens, when one pops up.  The online help screens can at any time be invoked with the B<'?'> key.
de: Falls B<dselect> nicht im Experten- oder direkten Modus läuft wird zuerst ein Hilfebildschirm angezeigt, wenn diese Aktion vom Menü ausgewählt wird. Dem Benutzer wird I<nachdrücklich> empfohlen, die gesamten in der Online-Hilfe angezeigten Informationen zu prüfen, wenn diese angezeigt werden. Die Online-Hilfebildschirme können jederzeit mit der Taste B<»?«> aufgerufen werden.

note: type: SS
en: Screen layout
de: Bildschirmlayout

note: type: Plain text
en: The select screen is by default split in a top and a bottom half.  The top half shows a list of packages. A cursor bar can select an individual package, or a group of packages, if applicable, by selecting the group header. The bottom half of the screen shows some details about the package currently selected in the top half of the screen.  The type of detail that is displayed can be varied.
de: Der Auswahlbildschirm ist standardmäßig in eine obere und eine untere Hälfte geteilt. Die obere Hälft zeigt eine Liste von Paketen. Ein Cursorbalken wählt individuelle Pakete oder, falls zutreffend, eine Gruppe von Paketen durch Auswahl der Gruppenkopfzeile aus. Die untere Hälfte des Bildschirms zeigt einige Details über das derzeit in der oberen Hälfte des Bildschirms ausgewählte Paket an. Die Art der angezeigten Details kann variiert werden.

note: type: Plain text
en: Pressing the B<'I'> key toggles a full-screen display of the packages list, an enlarged view of the package details, or the equally split screen.
de: Drücken der Taste B<»I«> schaltet zwischen der Vollbilddarstellung der Paketliste, einer vergrößerten Darstellung der Paketdetails und dem gleichmäßig geteilten Bildschirm um.

note: type: SS
en: Package details view
de: Paket-Detailbetrachtung

note: type: Plain text
en: The package details view by default shows the extended package description
    for the package that is currently selected in the packages status list.
    The type of detail can be toggled by pressing the B<'i'> key. This
    alternates between:
     - the extended description
     - the control information for the installed version
     - the control information for the available version
de: Standardmäßig zeigt die Paket-Detailbetrachtung die ausführliche
    Paketbeschreibung des derzeit in der Paketstatusliste ausgewählten Pakets.
    Die Art der Details kann durch Drücken der Taste B<»i«> umgeschaltet werden.
    Diese wechseln zwischen:
     - der ausführlichen Beschreibung
     - der Steuerinformation für die installierte Version
     - der Steuerinformation für die verfügbare Version

note: type: Plain text
en: In a dependency resolution screen, there is also the possibility of viewing the specific unresolved depends or conflicts related to the package and causing it to be listed.
de: Im Bildschirm der Abhängigkeitsauflösung gibt es auch die Möglichkeit, die spezifizierten nicht aufgelösten Abhängigkeiten oder Konflikte mit Bezug zu dem Paket anzuschauen und deren Auflistung zu erreichen.

note: type: SS
en: Packages status list
de: Paketstatusliste

note: type: Plain text
en: The main select screen displays a list of all packages known to the debian package management system. This includes packages installed on the system and packages known from the available packages database.
de: Der Hauptauswahlbildschirm zeigt eine Liste aller Pakete, die dem Debian-Paketverwaltungssystem bekannt sind. Dies beinhaltet alle auf dem System installierten Pakete und Pakete, die aus den verfügbaren Paketdatenbanken bekannt sind.

note: type: Plain text
en: For every package, the list shows the package's status, priority, section, installed and available versions, the package name and its short description, all in one line. By pressing the B<'V'> key, the display of the installed and available version can be toggled between on an off. By pressing the B<'v'> key, the package status display is toggled between verbose and shorthand.  Shorthand display is the default.
de: Für jedes Paket zeigt die Liste den Paketstatus, die Priorität, den Bereich, installierte und verfügbare Versionen, den Namen und die Kurzbeschreibung des Paketes, alles in einer Zeile. Durch Drücken der Taste B<»V«> kann die Anzeige der installierten und verfügbaren Version zwischen ein und aus umgeschaltet werden. Durch Drücken der Taste B<»v«> wird die Anzeige des Paketstatus zwischen ausführlich und verkürzt umgeschaltet. Die verkürzte Anzeige ist voreingestellt.

note: type: Plain text
en: The shorthand status indication consists of four parts: an error flag, which should normally be clear, the current status, the last selection state and the current selection state.  The first two relate to the actual state of the package, the second pair are about the selections set by the user.
de: Die Kurzstatusangabe besteht aus vier Teilen: einer Fehlermarkierung, die normalerweise leer sein sollte, dem aktuellen Status, dem letzten Auswahlstatus und dem aktuellen Auswahlstatus. Die ersten zwei beziehen sich auf den derzeitigen Status des Pakets, das zweite Paar behandeln die vom Benutzer gesetzte Auswahl.

note: type: Plain text
en: These are the meanings of the shorthand package status indicator codes:
     Error flag:
      I<empty>   no error
      B<R>       serious error, needs reinstallation;
     Installed state:
      I<empty>   not installed;
      B<*>       fully installed and configured;
      B<->       not installed but some config files may remain;
      B<U>       unpacked but not yet configured;
      B<C>       half-configured (an error happened);
      B<I>       half-installed (an error happened).
     Current and requested selections:
      B<*>       marked for installation or upgrade;
      B<->       marked for removal, configuration files remain;
      B<=>       on hold: package will not be processed at all;
      B<_>       marked for purge, also remove configuration;
      B<n>       package is new and has yet to be marked.
de: Dies sind die Bedeutungen der kurzen Paketstatus-Anzeige-Codes:
     Fehlermarkierung:
      I<leer>    kein Fehler
      B<R>       schwerwiegender Fehler, Neuinstallation notwendig;
     Installierter Status:
      I<leer>    nicht installiert;
      B<*>       vollständig installiert und konfiguriert;
      B<->       nicht installiert, aber einige Konfigurationsdateien könnten bleiben;
      B<U>       entpackt, aber noch nicht konfiguriert;
      B<C>       halb konfiguriert (ein Fehler ist aufgetreten);
      B<I>       halb installiert (ein Fehler ist aufgetreten).
     Aktuelle und angeforderte Auswahlen:
      B<*>       markiert zur Installation oder Upgrade;
      B<->       markiert zur Entfernung, Konfigurationsdateien bleiben;
      B<=>       auf »halten«: Paket wird überhaupt nicht verarbeitet werden;
      B<_>       markiert zum vollständigen Löschen, auch der Konfiguration;
      B<n>       Paket ist neu und muss erst noch markiert werden.

note: type: SS
en: Cursor and screen movement
de: Cursor- und Bildschirm-Bewegung

note: type: Plain text
en: The package selection list and the dependency conflict resolution screens can be navigated using motion commands mapped to the following keys:
de: Die Paketauswahllisten und die Abhängigkeitskonflikte-Lösungsbildschirme können mit den Bewegungsbefehlen navigiert werden, die auf die folgenden Tasten abgebildet sind:

note: type: Plain text
en:   B<p, Up, k>           move cursor bar up
      B<n, Down, j>         move cursor bar down
      B<P, Pgup, Backspace> scroll list 1 page up
      B<N, Pgdn, Space>     scroll list 1 page down
      B<^p>                 scroll list 1 line up
      B<^n>                 scroll list 1 line down
      B<t, Home>            jump to top of list
      B<e, End>             jump to end of list
      B<u>                  scroll info 1 page up
      B<d>                  scroll info 1 page down
      B<^u>                 scroll info 1 line up
      B<^d>                 scroll info 1 line down
      B<B, Left-arrow>      pan display 1/3 screen left
      B<F, Right-arrow>     pan display 1/3 screen right
      B<^b>                 pan display 1 character left
      B<^f>                 pan display 1 character right
de:   B<p, Hoch, k>                bewege Cursor-Balken hoch
      B<n, Runter, j>              bewege Cursor-Balken runter
      B<P, Bild hoch, Rückschritt> scrolle Liste eine Seite hoch
      B<N, Bild runter, Leertaste> scrolle Liste eine Seite runter
      B<^p>                        scrolle Liste eine Zeile hoch
      B<^n>                        scrolle Liste eine Zeile runter
      B<t, Pos 1>                  springe zum Listen-Anfang
      B<e, Ende>                   springe zum Listen-Ende
      B<u>                         scrolle Info eine Seite hoch
      B<d>                         scrolle Info eine Seite runter
      B<^u>                        scrolle Info eine Zeile hoch
      B<^d>                        scrolle Info eine Zeile runter
      B<B, Linker Pfeil>           bewege Bildschirm 1/3-Bildschirmbreite links
      B<F, Rechter Pfeil>          bewege Bildschirm 1/3-Bildschirmbreite rechts
      B<^b>                        bewege Bildschirm ein Zeichen nach links
      B<^f>                        bewege Bildschirm ein Zeichen nach rechts

note: type: SS
en: Searching and sorting
de: Suchen und Sortieren

note: type: Plain text
en: The list of packages can be searched by package name. This is done by pressing B<'/'>, and typing a simple search string. The string is interpreted as a B<regex>(7)  regular expression.  If you add B<'/d'> to the search expression, dselect will also search in descriptions. If you add B<'/i'> the search will be case insensitive.  You may combine these two suffixes like this: B<'/id'>.  Repeated searching is accomplished by repeatedly pressing the B<'n'> or B<'\e'> keys, until the wanted package is found.  If the search reaches the bottom of the list, it wraps to the top and continues searching from there.
de: Die Liste der Pakete kann nach Paketnamen durchsucht werden. Dies erfolgt durch Drücken von B<»/«> und der Eingabe einer einfachen Suchzeichenkette. Die Zeichenkette wird als regulärer Ausdruck gemäß B<regex>(7) interpretiert. Falls Sie zu dem Suchausdruck B<»/d«> hinzufügen wird Dselect auch in Beschreibungen suchen. Falls Sie B<»/i«> hinzufügen, wird Groß-/Kleinschreibung ignoriert. Sie können die Suffixe wie folgt kombinieren: B<»/id«>. Wiederholtes Suchen wird durch Drücken von B<»n«> oder B<»\e«> erreicht, bis das gewünschte Paket gefunden wurde. Falls die Suche das Ende der Liste erreicht, springt sie zum Anfang und fährt von dort fort.

note: type: Plain text
en: The list sort order can be varied by pressing
    the B<'o'> and B<'O'> keys repeatedly.
    The following nine sort orderings can be selected:
     alphabet          available           status
     priority+section  available+priority  status+priority
     section+priority  available+section   status+section
de: Die List-Sortierreihenfolge kann durch wiederholtes
    Drücken der Tasten B<»o«> and B<»O«> verändert werden.
    Die folgenden Sortierreihenfolgen können ausgewählt werden:
     alphabetisch      verfügbar           Status
     Priorität+Bereich verfügbar+Priorität Status+Priorität
     Bereich+Priorität verfügbar+Bereich   Status+Bereich

note: type: Plain text
en: Where not listed above explicitly, alphabetic order is used as the final subordering sort key.
de: Wo dies oben nicht explizit aufgeführt ist, wird alphabetische Reihenfolge als abschließender Unterordnungs-Sortierschlüssel verwendet.

note: type: SS
en: Altering selections
de: Auswahlen ändern

note: type: Plain text
en: The requested selection state of individual packages may be
    altered with the following commands:
      B<+, Insert>    install or upgrade
      B<=, H>         hold in present state and version
      B<:, G>         unhold: upgrade or leave uninstalled
      B<-, Delete>    remove, but leave configuration
      B<_>            remove & purge configuration
de: Der angeforderte Auswahlstatus individueller Pakete kann mit
    den folgenden Befehlen geändert werden:
      B<+, Einfg>     Installieren oder Upgrade durchführen
      B<=, H>         gegenwärtigen Status und Version beibehalten
      B<:, G>         Loslassen: Upgrad durchführen oder uninstalliert lassen
      B<-, Entf>      Entfernen, aber Konfiguration behalten
      B<_>            Entfernen und Konfiguration löschen

note: type: Plain text
en: When the change request results in one or more unsatisfied depends or conflicts, B<dselect> prompts the user with a dependency resolution screen. This will be further explained below.
de: Wenn sich aus der Änderungsanforderung eine oder mehrere unerfüllte Abhängigkeiten oder Konflikte ergeben, bietet B<dselect> dem Benutzer einen Bildschirm zu Abhängigkeitsauflösung an. Dieser wird weiter unten detaillierter beschrieben.

note: type: Plain text
en: It is also possible to apply these commands to groups of package selections, by pointing the cursor bar onto a group header. The exact grouping of packages is dependent on the current list ordering settings.
de: Es ist auch möglich, die Befehle auf Gruppen von Paketauswahlen anzuwenden, indem mit dem Cursor-Balken die Gruppen-Überschrift ausgewählt wird. Die genaue Gruppierung der Pakete hängt von den Einstellungen der aktuellen Listensortierung ab.

note: type: Plain text
en: Proper care should be taken when altering large groups of selections, because this can instantaneously create large numbers of unresolved depends or conflicts, all of which will be listed in one dependency resolution screen, making them very hard to handle. In practice, only hold and unhold operations are useful when applied to groups.
de: Veränderungen von großen Gruppen von Auswahlen sollten vorsichtig durchgeführt werden, da dies sofort zu einer großen Anzahl an nicht-aufgelösten Abhängigkeiten oder Konflikten führen kann, die dann alle im Bildschirm der Abhängigkeitsauflösung dargestellt werden. Dies kann dann schwer zu handhaben sein. In der Praxis sind nur die Operationen Halten und Loslassen nützlich, wenn sie auf Gruppen angewandt werden.

note: type: SS
en: Resolving depends and conflicts
de: Abhängigkeiten und Konflikte auflösen

note: type: Plain text
en: When the change request results in one or more unsatisfied depends or conflicts, B<dselect> prompts the user with a dependency resolution screen. First however, an informative help screen is displayed.
de: Wenn sich aus der Änderungsanforderung eine oder mehrere unerfüllte Abhängigkeiten oder Konflikte ergeben, bietet B<dselect> dem Benutzer einen Bildschirm zu Abhängigkeitsauflösung an. Zuerst wird allerdings ein Hilfebildschirm angezeigt.

note: type: Plain text
en: The top half of this screen lists all the packages that will have unresolved depends or conflicts, as a result of the requested change, and all the packages whose installation can resolve any of these depends or whose removal can resolve any of the conflicts.  The bottom half defaults to show the depends or conflicts that cause the currently selected package to be listed.
de: Die obere Hälfte dieses Bildschirms führt alle Pakete auf, die auf Grund der angeforderten Änderung unerfüllte Abhängigkeiten oder Konflikte haben und alle Pakete, deren Installation (einige) dieser Abhängigkeiten erfüllen oder deren Entfernung (einige) der Konflikte beseitigen kann. Die untere Hälfte zeigt standardmäßig die Abhängigkeiten oder Konflikte, die zu der Auflistung des derzeit ausgewählte Paketes geführt haben.

note: type: Plain text
en: When the sublist of packages is displayed initially, B<dselect> may have already set the requested selection status of some of the listed packages, in order to resolve the depends or conflicts that caused the dependency resolution screen to be displayed. Usually, it is best to follow up the suggestions made by B<dselect>.
de: Wenn anfänglich eine Teilliste von Paketen dargestellt wird, könnte B<dselect> bereits den erbetenen Auswahlstatus von einigen der aufgeführten Pakete gesetzt haben, um die Abhängigkeiten oder Konflikte aufzulösen, die dazu geführt hatten, dass der Bildschirm zu Abhängigkeitsauflösung angezeigt wurde. Normalerweise ist es am besten, den Vorschlägen von B<dselect> zu folgen.

note: type: Plain text
en: The listed packages' selection state may be reverted to the original settings, as they were before the unresolved depends or conflicts were created, by pressing the B<'R'> key. By pressing the B<'D'> key, the automatic suggestions are reset, but the change that caused the dependency resolution screen to be prompted is kept as requested.  Finally, by pressing B<'U'>, the selections are again set to the automatic suggestion values.
de: Durch Drücken der Taste B<»R«> kann der Auswahlzustand der aufgeführten Pakete zu den Originaleinstellungen zurückgesetzt werden, wie er vor den unaufgelösten Abhängigkeiten oder Konflikten war. Durch Drücken der Taste B<»D«> werden die automatischen Vorschläge zurückgesetzt, aber die Änderungen, die zu der Anzeige des Abhängigkeitsauflösungsbildschirms geführt hatten, werden wie gebeten beibehalten. Schließlich werden durch Drücken der Taste B<»U«> die Auswahlen wieder auf die automatischen Auswahlwerte gesetzt.

note: type: SS
en: Establishing the requested selections
de: Die angeforderten Auswahlen einrichten

note: type: Plain text
en: By pressing B<enter>, the currently displayed set of selections is accepted. If B<dselect> detects no unresolved depends as a result of the requested selections, the new selections will be set.  However, if there are any unresolved depends, B<dselect> will again prompt the user with a dependency resolution screen.
de: Durch Drücken von B<Enter> wird die derzeit angezeigte Auswahlgruppe akzeptiert. Falls B<dselect> keine unaufgelösten Abhängigkeit als Ergebnis der angeforderten Auswahl entdeckt, wird die neue Auswahl gesetzt. Falls es allerdings unaufgelöste Abhängigkeiten gibt, wird B<dselect> dem Benutzer erneut den Bildschirm mit der Abhängigkeitsauflösung anzeigen.

note: type: Plain text
en: To alter a set of selections that creates unresolved depends or conflicts and forcing B<dselect> to accept it, press the B<'Q'> key. This sets the selections as specified by the user, unconditionally. Generally, don't do this unless you've read the fine print.
de: Um die Menge der Auswahlen zu ändern, die unaufgelöste Abhängigkeiten oder Konflikte erzeugt und B<dselect> zu zwingen, diese zu akzeptieren, drücken Sie die Taste B<»Q«>. Dies setzt die Auswahl wie vom Benutzer angegeben, ohne Bedingungen. Machen Sie dies nur, wenn Sie sich über die Konsequenzen im Klaren sind.

note: type: Plain text
en: The opposite effect, to back out any selections change requests and go back to the previous list of selections, is attained by pressing the B<'X'> or B<escape> keys. By repeatedly pressing these keys, any possibly detrimental changes to the requested package selections can be backed out completely to the last established settings.
de: Der gegenteilige Effekt, um alle Auswahländerungen zurückzusetzen und zurück auf die vorherige Auswahlliste zu gehen, wird durch Drücken der Tasten B<»X«> oder B<»Esc«> erreicht. Durch wiederholtes Drücken dieser Tasten können möglicherweise schädliche Änderungen an der angeforderten Paketauswahl komplett auf die letzten bestehenden Einstellungen zurückgesetzt werden.

note: type: Plain text
en: If you mistakenly establish some settings and wish to revert all the selections to what is currently installed on the system, press the B<'C'> key.  This is somewhat similar to using the unhold command on all packages, but provides a more obvious panic button in cases where the user pressed B<enter> by accident.
de: Falls Sie bestimmte Einstellungen aus Versehen vornehmen und alle Auswahlen so zurücksetzen wollen, dass diese den bereits auf dem System installierten Paketen entsprechen, dann drücken Sie die Taste B<»C«>. Dies ähnelt etwas der Verwendung des Befehls Loslassen, angewendet auf alle Pakete, bietet aber einen etwas deutlicheren Panikknopf, falls der Benutzer aus Versehen die B<Eingabetaste> gedrückt hat.

note: type: Plain text
en: If set, B<dselect> will use it as the directory from which to read the user specific configuration file.
de: Falls gesetzt wird B<dselect> es als das Verzeichnis verwenden, aus dem die benutzerspezifische Konfigurationsdatei gelesen wird.

note: type: Plain text
en: The B<dselect> package selection interface is confusing to some new users.  Reportedly, it even makes seasoned kernel developers cry.
de: Die Paketauswahl-Schnittstelle von B<Dselect> bringt einige neue Benutzer durcheinander. Gerüchteweise bringt sie sogar erfahrene Kernelentwickler zum Heulen.

note: type: Plain text
en: The documentation is lacking.
de: Die Dokumentation ist verbesserungswürdig.

note: type: Plain text
en: There is no help option in the main menu.
de: Es gibt keine Hilfe-Option im Hauptmenü.

note: type: Plain text
en: The visible list of available packages cannot be reduced.
de: Die sichtbare Liste von verfügbaren Paketen kann nicht verkleinert werden.

note: type: Plain text
en: The built in access methods can no longer stand up to current quality standards. Use the access method provided by apt, it is not only not broken, it is also much more flexible than the built in access methods.
de: Die eingebauten Zugriffsmethoden können sich nicht mehr mit aktuellen Qualitätsstandards messen. Verwenden Sie die von apt bereitgestellte Zugriffsmethode, sie funktioniert nicht nur, sondern ist sogar flexibler als die eingebauten Zugriffsmethoden.

note: type: Plain text
en: dselect.cfg - dselect configuration file
de: dselect.cfg - dselect Konfigurationsdatei

note: type: Plain text
en: This file contains default options for dselect. Each line contains a single option which is exactly the same as a normal command line option for dselect except for the leading dashes which are not used here. Quotes surrounding option values are stripped. Comments are allowed by starting a line with a hash sign ("B<#>").
de: Diese Datei enthält Standardoptionen für dselect. Jede Zeile enthält eine einzelne Option, die exakt die gleiche wie für die normalen Kommandozeilen-Option von dselect sind, abgesehen von den einleitenden Gedankenstrichen, die hier nicht verwendet werden. Anführungszeichen (»Quotes«) um Optionswerte werden entfernt. Kommentare sind durch Einleiten einer Zeile mit einem Rautenzeichen (»B<#>«) erlaubt.

note: type: Plain text
en: See I</usr/share/doc/dpkg/THANKS> for the list of people who have contributed to B<dselect>.
de: Lesen Sie I</usr/share/doc/dpkg/THANKS> für die Liste der Leute, die zu B<dselect> beigetragen haben.

note: type: Plain text
en: start-stop-daemon - start and stop system daemon programs
de: start-stop-daemon - startet und stoppt System-Daemon-Programme

note: type: Plain text
en: B<start-stop-daemon> [I<option>...] I<command>
de: B<start-stop-daemon> [I<Option> …] I<Befehl>

note: type: Plain text
en: B<start-stop-daemon> is used to control the creation and termination of system-level processes.  Using one of the matching options, B<start-stop-daemon> can be configured to find existing instances of a running process.
de: B<start-stop-daemon> wird zur Steuerung der Erzeugung und Beendigung von Prozessen auf Systemebene verwendet. Durch die Verwendung einer der Abgleich-Optionen kann B<start-stop-daemon> so konfiguriert werden, dass er existierende Instanzen von einem laufenden Prozess finden kann.

note: type: Plain text
en: Note: unless B<--pidfile> is specified, B<start-stop-daemon> behaves similar to B<killall>(1).  B<start-stop-daemon> will scan the process table looking for any processes which match the process name, uid, and/or gid (if specified). Any matching process will prevent B<--start> from starting the daemon. All matching processes will be sent the TERM signal (or the one specified via B<--signal> or B<--retry>) if B<--stop> is specified. For daemons which have long-lived children which need to live through a B<--stop>, you must specify a pidfile.
de: Hinweis: Falls B<--pidfile> nicht angegeben ist, verhält sich B<start-stop-daemon> ähnlich zu B<killall>(1). B<start-stop-daemon> wird die Prozesstabelle nach Prozessen durchsuchen, die auf den Prozessnamen, uid und/oder gid (falls angegeben) passen. Jeder passende Prozess wird B<--start> daran hindern, den Daemon zu starten. Allen passenden Prozessen wird das TERM-Signal (oder das mit B<--signal> oder B<--retry> angegebene) geschickt, falls B<--stop> angegeben ist. Für Daemons die langlebige Kinder haben, die ein B<--stop> überleben müssen, müssen Sie eine PID-Datei angeben.

note: type: TP
en: B<-S>, B<--start> [B<-->] I<arguments>
de: B<-S>, B<--start> [B<-->] I<Argumente>

note: type: Plain text
en: Check for the existence of a specified process.  If such a process exists, B<start-stop-daemon> does nothing, and exits with error status 1 (0 if B<--oknodo> is specified).  If such a process does not exist, it starts an instance, using either the executable specified by B<--exec> or, if specified, by B<--startas>.  Any arguments given after B<--> on the command line are passed unmodified to the program being started.
de: Prüfe auf Existenz eines angegebenen Prozesses. Falls ein solcher Prozess existiert führt B<start-stop-daemon> nichts aus und beendet sich mit Fehlerstatus 1 (0, falls B<--oknodo> angegeben wurde). Falls ein solcher Prozess nicht existiert, dann startet es eine Instanz, entweder unter Verwendung des ausführbaren Programms, das mittels B<--exec> (oder, falls angegeben, mittels B<--startas>) spezifiziert wurde. Jedes weitere auf der Kommandozeile nach B<--> angegebene Argument wird unverändert an das zu startende Programm weitergegeben.

note: type: Plain text
en: Checks for the existence of a specified process.  If such a process exists, B<start-stop-daemon> sends it the signal specified by B<--signal>, and exits with error status 0.  If such a process does not exist, B<start-stop-daemon> exits with error status 1 (0 if B<--oknodo> is specified). If B<--retry> is specified, then B<start-stop-daemon> will check that the process(es) have terminated.
de: Überprüft auf die Existenz eines speziellen Prozesses. Falls ein solcher Prozess existiert, dann sendet B<start-stop-daemon> das durch B<--signal> angegebene Signal und beendet sich mit Fehlerstatus 0. Falls kein solcher Prozess existiert, dann beendet sich B<start-stop-daemon> mit Fehlerstatus 1 (0 falls B<--oknodo> angegeben ist). Falls B<--retry> angegeben wurde, wird B<start-stop-daemon> überprüfen, ob der/die Prozess(e) beendet wurden.

note: type: Plain text
en: Check for the existence of a specified process, and returns an exit status code, according to the LSB Init Script Actions.
de: Überprüft auf die Existenz eines bestimmten Prozesses und liefert den Exit-Status-Code entsprechend der »LSB Init Script Actions« zurück.

note: type: Plain text
en: Show the program version and exit.
de: Zeige die Programmversion und beendet sich.

note: type: SH
en: MATCHING OPTIONS
de: ABGLEICH-OPTIONEN

note: type: TP
en: B<-p>, B<--pidfile> I<pid-file>
de: B<-p>, B<--pidfile> I<pid-Datei>

note: type: Plain text
en: Check whether a process has created the file I<pid-file>. Note: using this matching option alone might cause unintended processes to be acted on, if the old process terminated without being able to remove the I<pid-file>.
de: Prüfe, ob ein Prozess I<pid-Datei> erstellt hat. Hinweis: Wird diese Abgleichoption alleine verwandt, könnte auf nicht geplante Prozesse eingewirkt werden, falls der alte Prozess beendet wurde, ohne dass er I<pid-Datei> entfernen konnte.

note: type: TP
en: B<-x>, B<--exec> I<executable>
de: B<-x>, B<--exec> I<Programm>

note: type: Plain text
en: Check for processes that are instances of this I<executable>. The I<executable> argument should be an absolute pathname. Note: this might not work as intended with interpreted scripts, as the executable will point to the interpreter. Take into account processes running from inside a chroot will also be matched, so other match restrictions might be needed.
de: Überprüfe auf Prozesse, die Instanzen von diesem Programm sind. Das Argument I<Programm> sollte ein absoluter Pfadname sein. Hinweis: Dies könnte bei interpretierten Skripten nicht wie geplant funktionieren, da das I<Programm> auf den Interpreter zeigt. Berücksichtigen Sie, dass dies auch auf Prozesse, die innerhalb einer Chroot laufen, passen könnte, daher könnten andere Abgleichrestriktionen benötigt werden.

note: type: TP
en: B<-n>, B<--name> I<process-name>
de: B<-n>, B<--name> I<Prozessname>

note: type: Plain text
en: Check for processes with the name I<process-name>. The I<process-name> is usually the process filename, but it could have been changed by the process itself. Note: on most systems this information is retrieved from the process comm name from the kernel, which tends to have a relatively short length limit (assuming more than 15 characters is non-portable).
de: Überprüfe auf Prozesse mit dem Namen I<Prozessname>. Der I<Prozessname> ist normalerweise der Dateiname des Prozesses, er könnte aber vom Prozess selbst geändert worden sein. Hinweis: Auf den meisten Systemen wird diese Information aus dem »comm«-Namen des Prozesses aus dem Kernel ausgelesen. Dieser hat typischerweise eine recht kurze Längenbegrenzung (mehr als 15 Zeichen anzunehmen ist nicht portabel).

note: type: TP
en: B<-u>, B<--user> I<username>|I<uid>
de: B<-u>, B<--user> I<Benutzername>|I<uid>

note: type: Plain text
en: Check for processes owned by the user specified by I<username> or I<uid>. Note: using this matching option alone will cause all processes matching the user to be acted on.
de: Überprüfe auf Prozesse die dem mit I<Benutzername> oder I<uid> spezifizierten Benutzer gehören. Hinweis: Wird diese Abgleichoption alleine verwandt, wird auf alle Prozesse, die auf den Benutzer passen, eingewirkt.

note: type: TP
en: B<-g>, B<--group> I<group>|I<gid>
de: B<-g>, B<--group> I<Gruppe>|I<gid>

note: type: Plain text
en: Change to I<group> or I<gid> when starting the process.
de: Wechsle zum Starten des Prozesses zur I<Gruppe> oder I<gid>.

note: type: TP
en: B<-s>, B<--signal> I<signal>
de: B<-s>, B<--signal> I<Signal>

note: type: Plain text
en: With B<--stop>, specifies the signal to send to processes being stopped (default TERM).
de: Mit B<--stop> wird das an den zu beendenden Prozess zu sendende Signal spezifiziert (standardmäßig TERM).

note: type: TP
en: B<-R>, B<--retry> I<timeout>|I<schedule>
de: B<-R>, B<--retry> I<Zeitüberschreitung>|I<Plan>

note: type: Plain text
en: With B<--stop>, specifies that B<start-stop-daemon> is to check whether the process(es)  do finish. It will check repeatedly whether any matching processes are running, until none are. If the processes do not exit it will then take further action as determined by the schedule.
de: Mit B<--stop> spezifiziert, dass B<start-stop-daemon> überprüfen soll, ob der Prozess (die Prozesse) sich beenden. Es überprüft wiederholt, ob passende Prozesse laufen, bis dies nicht mehr der Fall ist. Falls sich die Prozesse nicht beenden, werden weitere im »Plan« angegebene Aktionen durchgeführt.

note: type: Plain text
en: If I<timeout> is specified instead of I<schedule>, then the schedule I<signal>B</>I<timeout>B</KILL/>I<timeout> is used, where I<signal> is the signal specified with B<--signal>.
de: Falls I<Zeitüberschreitung> anstelle von I<Plan> spezifiziert wird, dann wird der Plan I<Signal>B</>I<Zeitüberschreitung>B</KILL/>I<Zeitüberschreitung> verwendet, wobei I<Signal> das mit B<--signal> spezifizierte Signal ist.

note: type: Plain text
en: I<schedule> is a list of at least two items separated by slashes (B</>); each item may be B<->I<signal-number> or [B<->]I<signal-name>, which means to send that signal, or I<timeout>, which means to wait that many seconds for processes to exit, or B<forever>, which means to repeat the rest of the schedule forever if necessary.
de: I<Plan> ist eine Liste von mindestens zwei durch Schrägstriche (B</>)  getrennten Punkten; jeder Punkt kann aus B<->I<Signalnummer> oder [B<->]I<Signalname> bestehen, was bedeutet, dass dieses Signal gesendet werden soll, oder aus I<Zeitüberschreitung>, was bedeutet, dass soviele Sekunden auf das Beenden von Prozessen gewartet werden soll, oder aus B<forever> was bedeutet, den Rest des Plans falls notwendig für immer zu wiederholen.

note: type: Plain text
en: If the end of the schedule is reached and B<forever> is not specified, then B<start-stop-daemon> exits with error status 2.  If a schedule is specified, then any signal specified with B<--signal> is ignored.
de: Falls das Ende des Plans erreicht wird und B<forever> nicht spezifiziert wurde, dann beendet sich der B<start-stop-daemon> mit dem Fehlerstatus 2. Falls ein Plan spezifiziert wurde, dann wird jedes mit B<--signal> spezifizierte Signal ignoriert.

note: type: TP
en: B<-a>, B<--startas> I<pathname>
de: B<-a>, B<--startas> I<Pfadname>

note: type: Plain text
en: With B<--start>, start the process specified by I<pathname>.  If not specified, defaults to the argument given to B<--exec>.
de: Mit B<--start> wird der über I<Pfadname> spezifizierte Prozess gestartet. Falls nicht angegeben, werden standardmäßig die an B<--exec> übergebenen Argumente verwendet.

note: type: Plain text
en: Print actions that would be taken and set appropriate return value, but take no action.
de: Gebe die Aktionen aus, die erledigt würden und setze die entsprechenden Rückgabewerte, führe aber keine Aktionen durch.

note: type: Plain text
en: Return exit status 0 instead of 1 if no actions are (would be) taken.
de: Liefert den Rückgabewert 0 anstatt 1 falls keine Aktionen ausgeführt wurden (würden).

note: type: Plain text
en: Do not print informational messages; only display error messages.
de: Gebe keine informativen Meldungen aus, zeige nur Fehlermeldungen an.

note: type: TP
en: B<-c>, B<--chuid> I<username>|I<uid>[B<:>I<group>|I<gid>]
de: B<-c >, B< --chuid >I<Benutzername>|I<uid>[B<:>I<Gruppe>|I<gid>]

note: type: Plain text
en: Change to this username/uid before starting the process. You can also specify a group by appending a B<:>, then the group or gid in the same way as you would for the `chown' command (I<user>B<:>I<group>).  If a user is specified without a group, the primary GID for that user is used.  When using this option you must realize that the primary and supplemental groups are set as well, even if the B<--group> option is not specified. The B<--group> option is only for groups that the user isn't normally a member of (like adding per process group membership for generic users like B<nobody>).
de: Wechsele vor dem Start des Prozesses zu diesem Benutzername/uid. Sie können durch Anhängen von B<:> auch die Gruppe spezifizieren, in diesem Fall wird die Gruppe oder gid wie bei dem »chown«-Befehl (I<Benutzer>B<:>I<Gruppe>) angegeben. Falls ein Benutzer ohne Gruppe angegeben ist, wird die primäre GID für diesen Benutzer verwandt. Wenn Sie diese Option verwenden, müssen Sie daran denken, dass die primäre und zusätzliche Gruppen auch gesetzt werden, selbst wenn die Option B<--group> nicht angegeben wird. Die Option B<--group> ist nur für Gruppen, in denen der Benutzer normalerweise kein Mitglied ist (wie das Hinzufügen von pro-Prozess Gruppenmitgliedschaften für generische Benutzer wie B<nobody>).

note: type: TP
en: B<-r>, B<--chroot> I<root>
de: B<-r>, B<--chroot> I<Wurzel>

note: type: Plain text
en: Chdir and chroot to I<root> before starting the process. Please note that the pidfile is also written after the chroot.
de: Chdir und chroot vor dem Start des Prozesse zu I<Wurzel>. Bitte beachten Sie, dass die PID-Datei auch nach dem chroot geschrieben wird.

note: type: TP
en: B<-d>, B<--chdir> I<path>
de: B<-d>, B<--chdir> I<Pfad>

note: type: Plain text
en: Chdir to I<path> before starting the process. This is done after the chroot if the B<-r>|B<--chroot> option is set. When not specified, start-stop-daemon will chdir to the root directory before starting the process.
de: Chdir vor dem Starten des Prozesses zu I<Pfad>. Dies wird, falls die B<-r>|B<--chroot> Option gesetzt ist, nach dem chroot durchgeführt. Falls nicht angegeben, wird start-stop-daemon vor dem Prozess-Start in das Wurzelverzeichnis wechseln.

note: type: Plain text
en: Typically used with programs that don't detach on their own. This option will force B<start-stop-daemon> to fork before starting the process, and force it into the background.  B<WARNING: start-stop-daemon> cannot check the exit status if the process fails to execute for B<any> reason. This is a last resort, and is only meant for programs that either make no sense forking on their own, or where it's not feasible to add the code for them to do this themselves.
de: Typischerweise verwendet für Programme, die sich nicht selbständig ablösen. Diese Option zwingt B<start-stop-daemon> vor dem Start des Prozesses einen Fork durchzuführen, und zwingt diesen dann in den Hintergrund. B<WARNUNG: start-stop-daemon> kann nicht den Rückgabewert überprüfen, falls der Prozess aus B<irgendeinem> Grund nicht startet. Dies ist ein letztes Mittel und ist nur für Programme gedacht, bei denen das selbstständige Forken keinen Sinn ergibt oder wo es nicht sinnvoll ist, den Code hierfür hinzuzufügen.

note: type: Plain text
en: Do not close any file descriptor when forcing the daemon into the background.  Used for debugging purposes to see the process output, or to redirect file descriptors to log the process output.  Only relevant when using B<--background>.
de: Keinen Dateideskriptor schließen, wenn ein Daemon in den Hintergrund gezwungen wird. Dies wird zu Fehlersuchzwecken angewandt oder um Dateideskriptoren zur Protokollierung der Prozessausgabe umzuleiten. Nur relevant bei der Verwendung von B<--background>.

note: type: TP
en: B<-N>, B<--nicelevel> I<int>
de: B<-N>, B<--nicelevel> I<Ganzzahl>

note: type: Plain text
en: This alters the priority of the process before starting it.
de: Dies ändert die Priorität des Prozesses bevor er gestartet wird.

note: type: TP
en: B<-P>, B<--procsched> I<policy>B<:>I<priority>
de: B<-P>, B<--procsched> I<Strategie>B<:>I<Priorität>

note: type: Plain text
en: This alters the process scheduler policy and priority of the process before starting it. The priority can be optionally specified by appending a B<:> followed by the value. The default I<priority> is 0. The currently supported policy values are B<other>, B<fifo> and B<rr>.
de: Dies ändert die Prozesssteuerstrategie (»process scheduler policy«) und die Priorität des Prozesses, bevor dieser gestartet wird. Die Priorität kann optional festgelegt werden, indem ein B<:> gefolgt von einem Wert angegeben wird. Die Standard-I<Priorität> beträgt 0. Die derzeit unterstützten Werte für die Strategie lauten B<other>, B<fifo> und B<rr>.

note: type: TP
en: B<-I>, B<--iosched> I<class>B<:>I<priority>
de: B<-I>, B<--iosched> I<Klasse>B<:>I<Priorität>

note: type: Plain text
en: This alters the IO scheduler class and priority of the process before starting it. The priority can be optionally specified by appending a B<:> followed by the value. The default I<priority> is 4, unless I<class> is B<idle>, then I<priority> will always be 7. The currently supported values for I<class> are B<idle>, B<best-effort> and B<real-time>.
de: Dies ändert die IO-Steuerklasse (»IO scheduler class«) und die Priorität des Prozesses, bevor dieser gestartet wird. Die Priorität kann optional festgelegt werden, indem ein B<:> gefolgt von einem Wert angegeben wird. Die Standard-I<Priorität> beträgt 4, außer I<Klasse> lautet B<idle>, dann beträgt sie immer 7. Die derzeit unterstützten Werte für die I<Klasse> lauten B<idle>, B<best-effort> und B<real-time>.

note: type: TP
en: B<-k>, B<--umask> I<mask>
de: B<-k>, B<--umask> I<Maske>

note: type: Plain text
en: This sets the umask of the process before starting it.
de: Dies setzt die umask des Prozesses bevor er gestartet wird.

note: type: Plain text
en: Used when starting a program that does not create its own pid file. This option will make B<start-stop-daemon> create the file referenced with B<--pidfile> and place the pid into it just before executing the process. Note, the file will not be removed when stopping the program.  B<NOTE:> This feature may not work in all cases. Most notably when the program being executed forks from its main process. Because of this, it is usually only useful when combined with the B<--background> option.
de: Verwendet, wenn ein Programm gestartet wird, das keine eigene PID-Datei anlegt. Diese Option sorgt dafür, dass B<start-stop-daemon> die mit B<--pidfile> referenzierte Datei anlegt und die PID kurz vor der Ausführung des Prozesse hineinlegt. Beachten Sie, dass die Datei nicht entfernt wird, wenn das Programm beendet wird. B<HINWEIS:> Diese Funktion könnte in nicht allen Fällen funktionieren. Insbesondere wenn das auszuführende Programm sich vom Hauptprozess forkt. Deshalb ist diese Option normalerweise nur in Kombination mit der Option B<--background> sinnvoll.

note: type: Plain text
en: Print verbose informational messages.
de: Gibt ausführliche informative Meldungen aus.

note: type: Plain text
en: The requested action was performed. If B<--oknodo> was specified, it's also possible that nothing had to be done.  This can happen when B<--start> was specified and a matching process was already running, or when B<--stop> was specified and there were no matching processes.
de: Die angeforderte Aktion wurde durchgeführt. Falls B<--oknodo> angegeben wurde, kann es auch sein, dass nicht durchgeführt wurde. Das kann passieren, wenn B<--start> angegeben wurde und der passende Prozess bereits lief oder wenn B<--stop> angegeben wurde und es keinen passenden Prozess gab.

note: type: Plain text
en: If B<--oknodo> was not specified and nothing was done.
de: Falls B<--oknodo> nicht angegeben war und nichts durchgeführt wurde.

note: type: Plain text
en: If B<--stop> and B<--retry> were specified, but the end of the schedule was reached and the processes were still running.
de: Falls B<--stop> und B<--retry> angegeben waren, aber das Ende des Plans erreicht wurde und die Prozesse noch liefen.

note: type: Plain text
en: Any other error.
de: Jeder andere Fehler.

note: type: Plain text
en: When using the B<--status> command, the following status codes are returned:
de: Bei der Verwendung des Befehls B<--status> werden die folgenden Statuscodes zurückgeliefert:

note: type: Plain text
en: Program is running.
de: Programm läuft.

note: type: Plain text
en: Program is not running and the pid file exists.
de: Programm läuft nicht und die PID-Datei existiert.

note: type: Plain text
en: Program is not running.
de: Programm läuft nicht.

note: type: Plain text
en: Unable to determine program status.
de: Programmstatus kann nicht bestimmt werden.

note: type: Plain text
en: Start the B<food> daemon, unless one is already running (a process named food, running as user food, with pid in food.pid):
de: Starte den Daemon B<food> falls noch keiner läuft (ein Prozess mit Namen food, der als Benutzer food mit PID in food.pid läuft):

note: type: Plain text
en: Send B<SIGTERM> to B<food> and wait up to 5 seconds for it to stop:
de: Schicke B<SIGTERM> an B<food> und warte bis zu fünf Sekunden auf sein Beenden:

note: type: Plain text
en: Demonstration of a custom schedule for stopping B<food>:
de: Vorführung eines angepassten Plans zum Beenden von B<food>:

note: type: Plain text
en: update-alternatives - maintain symbolic links determining default commands
de: update-alternatives - Verwaltung symbolischer Links zur Bestimmung von Standardwerten für Befehle

note: type: Plain text
en: B<update-alternatives> [I<option>...] I<command>
de: B<update-alternatives> [I<Option> …] I<Befehl>

note: type: Plain text
en: B<update-alternatives> creates, removes, maintains and displays information about the symbolic links comprising the Debian alternatives system.
de: B<update-alternatives> erzeugt, entfernt, verwaltet und zeigt die Informationen über die symbolischen Links, die das »Debian Alternativ-System« bilden, an.

note: type: Plain text
en: It is possible for several programs fulfilling the same or similar functions to be installed on a single system at the same time.  For example, many systems have several text editors installed at once.  This gives choice to the users of a system, allowing each to use a different editor, if desired, but makes it difficult for a program to make a good choice for an editor to invoke if the user has not specified a particular preference.
de: Es ist möglich, mehrere Programme, die die gleiche oder ähnliche Funktionalität bereitstellen, gleichzeitig auf einem System zu installieren. Beispielsweise sind auf vielen Systemen mehrere Texteditoren gleichzeitig installiert. Dies gibt den Benutzern eines Systems die Möglichkeit, falls gewünscht, jeweils einen anderen Editor zu verwenden, allerdings wird es damit für ein Programm schwierig, einen guten Wahl für einen Editor zum Starten zu treffen, falls der Benutzer keine spezielle Wahl getroffen hat.

note: type: Plain text
en: Debian's alternatives system aims to solve this problem.  A generic name in the filesystem is shared by all files providing interchangeable functionality.  The alternatives system and the system administrator together determine which actual file is referenced by this generic name.  For example, if the text editors B<ed>(1)  and B<nvi>(1)  are both installed on the system, the alternatives system will cause the generic name I</usr/bin/editor> to refer to I</usr/bin/nvi> by default. The system administrator can override this and cause it to refer to I</usr/bin/ed> instead, and the alternatives system will not alter this setting until explicitly requested to do so.
de: Debians Alternativ-System hat das Ziel, dieses Problem zu lösen. Ein generischer Name im Dateisystem wird von allen Dateien, die austauschbare Funktionalität bereitstellen, verwendet. Das Alternativ-System bestimmt zusammen mit dem Systemadministrator welche Datei tatsächlich durch diesen generischen Namen referenziert wird. Falls beispielsweise sowohl der Texteditor B<ed>(1) als auch B<nvi>(1) im System installiert sind, wird das Alternativ-System dafür sorgen, dass der generische Name I</usr/bin/editor> standardmäßig auf I</usr/bin/nvi> zeigt. Der Systemadministrator kann dies Ändern und dafür sorgen, dass er stattdessen auf I</usr/bin/ed> zeigt, und das Alternativ-System wird diese Einstellung nicht verändern, bis es explizit dazu aufgefordert wird.

note: type: Plain text
en: The generic name is not a direct symbolic link to the selected alternative.  Instead, it is a symbolic link to a name in the I<alternatives> I<directory>, which in turn is a symbolic link to the actual file referenced.  This is done so that the system administrator's changes can be confined within the I</etc> directory: the FHS (q.v.) gives reasons why this is a Good Thing.
de: Der generische Name ist nicht ein direkter symbolischer Link auf die ausgewählte Alternative. Stattdessen ist es ein symbolischer Link auf einen Namen im I<Alternativ-Verzeichnis>, welches wiederum ein symbolischer Link auf die tatsächlich referenzierte Datei ist. Dies ist so realisiert, damit die Änderungen des Systemadministrators auf das I</etc> Verzeichnis beschränkt bleiben: der FHS (siehe dort) erklärt warum dies eine Gute Idee ist.

note: type: Plain text
en: When each package providing a file with a particular functionality is installed, changed or removed, B<update-alternatives> is called to update information about that file in the alternatives system.  B<update-alternatives> is usually called from the B<postinst> (configure) or B<prerm> (install) scripts in Debian packages.
de: Für jedes Paket, das eine Datei mit einer bestimmten Funktionalität bereitstellt, wird bei der Installation, der Änderung oder der Entfernung B<update-alternatives> aufgerufen, um die Informationen über diese Datei im Alternativ-System zu aktualisieren. B<update-alternatives> wird gewöhnlich vom Skript B<postinst> (configure) oder B<prerm> (install) eines Debian-Paketes aufgerufen.

note: type: Plain text
en: It is often useful for a number of alternatives to be synchronized, so that they are changed as a group; for example, when several versions of the B<vi>(1)  editor are installed, the man page referenced by I</usr/share/man/man1/vi.1> should correspond to the executable referenced by I</usr/bin/vi>.  B<update-alternatives> handles this by means of I<master> and I<slave> links; when the master is changed, any associated slaves are changed too.  A master link and its associated slaves make up a I<link> I<group>.
de: Es ist oft sinnvoll, dass eine Reihe von Alternativen synchronisiert werden, so dass sie als Gruppe geändert werden; wenn beispielsweise mehrere Versionen des B<vi>(1) Editors installiert sind, sollte die Handbuchseite, die durch I</usr/share/man/man1/vi.1> referenziert wird, zu dem ausführbaren Programm, dass durch I</usr/bin/vi> referenziert wird, gehören. B<update-alternatives> erledigt dies mit Hilfe von I<Master-> und I<Slave-Links>; wird der Master-Link geändert, wird auch jeder zugehörige Slave-Link geändert. Ein Master-Link und seine zugehörigen Slave-Links bilden zusammen eine I<Link-Gruppe>.

note: type: Plain text
en: Each link group is, at any given time, in one of two modes: automatic or manual.  When a group is in automatic mode, the alternatives system will automatically decide, as packages are installed and removed, whether and how to update the links.  In manual mode, the alternatives system will retain the choice of the administrator and avoid changing the links (except when something is broken).
de: Eine Linkgruppe ist zu jeder Zeit in einem der beiden Modi: automatisch oder manuell. Ist eine Gruppe im automatischen Modus, dann wird das Alternativ-System bei der Paketinstallation und -entfernung automatisch entscheiden, ob und wie die Links aktualisiert werden. Im manuellen Modus wird das Alternativ-System die Wahl des Administrators beibehalten und Änderungen der Links vermeiden (außer irgendetwas ist defekt).

note: type: Plain text
en: Link groups are in automatic mode when they are first introduced to the system.  If the system administrator makes changes to the system's automatic settings, this will be noticed the next time B<update-alternatives> is run on the changed link's group, and the group will automatically be switched to manual mode.
de: Beim erstmaligen Einführen in das System befindet sich eine Linkgruppe im automatischen Modus. Führt der Systemadministrator Änderungen an den automatischen Einstellungen des Systems durch, wird dies beim nächsten Aufruf von B<update-alternatives> auf die Linkgruppe bemerkt und die Gruppe wird automatisch in den manuellen Modus umgeschaltet.

note: type: Plain text
en: Each alternative has a I<priority> associated with it.  When a link group is in automatic mode, the alternatives pointed to by members of the group will be those which have the highest priority.
de: Jede Alternative hat eine ihr zugeordnete I<Priorität>. Befindet sich eine Linkgruppe im automatischen Modus, zeigen die Mitglieder einer Gruppe auf die Alternative mit der höchsten Priorität.

note: type: Plain text
en: When using the B<--config> option, B<update-alternatives> will list all of the choices for the link group of which given I<name> is the master alternative name. The current choice is marked with a '*'.  You will then be prompted for your choice regarding this link group.  Depending on the choice made, the link group might no longer be in I<auto> mode. You will need to use the B<--auto> option in order to return to the automatic mode (or you can rerun B<--config> and select the entry marked as automatic).
de: Wird die B<--config>-Option verwendet, dann zeigt B<update-alternatives> alle Auswahlmöglichkeiten für die Link-Gruppe an, für die der gegebene I<Name> der Master-Alternative-Name ist. Die aktuelle Auswahl ist mit »*« markiert. Sie werden dann aufgefordert, Ihre Auswahl bezüglich der Linkgruppe anzugeben. Abhängig von der getroffenen Auswahl könnte sich die Link-Gruppe nicht mehr im I<automatischen> Modus befinden. Sie müssen dann die Option B<--auto> verwenden, um wieder in den automatischen Zustand zurückzukehren (oder Sie können B<--config> erneut ausführen und den als automatisch markierten Eintrag auswählen).

note: type: Plain text
en: If you want to configure non-interactively you can use the B<--set> option instead (see below).
de: Falls Sie nicht-interaktiv konfigurieren möchten, können Sie stattdessen die Option B<--set> verwenden (siehe unten).

note: type: Plain text
en: Different packages providing the same file need to do so B<cooperatively>.  In other words, the usage of B<update-alternatives> is B<mandatory> for all involved packages in such case. It is not possible to override some file in a package that does not employ the B<update-alternatives> mechanism.
de: Verschiedene Pakete, die die gleiche Datei bereitstellen, müssen dies B<kooperativ> durchführen. Anders gesagt ist in diesem Fall die Verwendung von B<update-alternatives> für alle beteiligten Pakete B<zwingend>. Es ist nicht möglich, sich über eine Datei in einem Paket hinwegzusetzen, welches den B<update-alternatives>-Mechanismus nicht verwendet.

note: type: SH
en: TERMINOLOGY
de: BEGRIFFE

note: type: Plain text
en: Since the activities of B<update-alternatives> are quite involved, some specific terms will help to explain its operation.
de: Da die Tätigkeiten von B<update-alternatives> recht komplex sind, sollen einige spezielle Begriffe helfen, seine Vorgehensweise zu erläutern.

note: type: TP
en: generic name (or alternative link)
de: generischer Name (oder Alternativ-Link)

note: type: Plain text
en: A name, like I</usr/bin/editor>, which refers, via the alternatives system, to one of a number of files of similar function.
de: Ein Name wie I</usr/bin/editor>, der sich über das Alternativ-System auf eine Reihe von Dateien mit ähnlicher Funktionalität bezieht.

note: type: TP
en: alternative name
de: Alternativ-Name

note: type: Plain text
en: The name of a symbolic link in the alternatives directory.
de: Der Name eines symbolischen Links im Alternativ-Verzeichnis.

note: type: TP
en: alternative (or alternative path)
de: Alternative (oder Alternativ-Pfad)

note: type: Plain text
en: The name of a specific file in the filesystem, which may be made accessible via a generic name using the alternatives system.
de: Der Name einer speziellen Datei im Dateisystem, die mittels eines generischen Namens über das Alternativ-System zugreifbar gemacht werden kann.

note: type: TP
en: alternatives directory
de: Alternativ-Verzeichnis

note: type: Plain text
en: A directory, by default I</etc/alternatives>, containing the symlinks.
de: Ein Verzeichnis, standardmäßig I</etc/alternatives>, das die Symlinks enthält.

note: type: TP
en: administrative directory
de: administratives Verzeichnis

note: type: Plain text
en: A directory, by default I</var/lib/dpkg/alternatives>, containing B<update-alternatives>' state information.
de: Ein Verzeichnis, standardmäßig I</var/lib/dpkg/alternatives>, das die B<update-alternatives> Zustandsinformationen enthält.

note: type: TP
en: link group
de: Linkgruppe

note: type: Plain text
en: A set of related symlinks, intended to be updated as a group.
de: Ein Satz zusammengehörender Symlinks, die als Gruppe aktualisiert werden sollen.

note: type: TP
en: master link
de: Master-Link

note: type: Plain text
en: The alternative link in a link group which determines how the other links in the group are configured.
de: Der Alternativ-Link in einer Linkgruppe der bestimmt, wie die anderen Links in der Gruppe konfiguriert werden.

note: type: TP
en: slave link
de: Slave-Link

note: type: Plain text
en: An alternative link in a link group which is controlled by the setting of the master link.
de: Ein Alternativ-Link in einer Linkgruppe, der durch die Einstellung des Master-Links gesteuert wird.

note: type: TP
en: automatic mode
de: automatischer Modus

note: type: Plain text
en: When a link group is in automatic mode, the alternatives system ensures that the links in the group point to the highest priority alternative appropriate for the group.
de: Ist eine Linkgruppe im automatischen Modus, dann sorgt das Alternativ-System dafür, dass die Links in der Gruppe auf die für die Gruppe passende Alternative mit der höchsten Priorität zeigen.

note: type: TP
en: manual mode
de: manueller Modus

note: type: Plain text
en: When a link group is in manual mode, the alternatives system will not make any changes to the system administrator's settings.
de: Ist eine Linkgruppe im manuellen Modus, dann führt das Alternativ-System keine Änderungen an den Einstellungen des Systemadministrators durch.

note: type: TP
en: B<--install> I<link name path priority> [B<--slave> I<link name path>]...
de: B<--install> I<Link Name Pfad Priorität> [B<--slave> I<Link Name Pfad>] …

note: type: Plain text
en: Add a group of alternatives to the system.  I<link> is the generic name for the master link, I<name> is the name of its symlink in the alternatives directory, and I<path> is the alternative being introduced for the master link.  The arguments after B<--slave> are the generic name, symlink name in the alternatives directory and the alternative path for a slave link.  Zero or more B<--slave> options, each followed by three arguments, may be specified. Note that the master alternative must exist or the call will fail. However if a slave alternative doesn't exist, the corresponding slave alternative link will simply not be installed (a warning will still be displayed). If some real file is installed where an alternative link has to be installed, it is kept unless B<--force> is used.
de: Füge eine Gruppe von Alternativen zum System hinzu. I<Link> ist der generische Name des Master-Links, I<Name> ist der Name seines Symlinks im Alternativ-Verzeichnis und I<Pfad> ist die Alternative, die für den Master-Link eingeführt wird. Die Argumente nach B<--slave> sind der generische Name, Symlink-Name in dem Alternativ-Verzeichnis und der Alternativ-Pfad für den Slave-Link. Null oder mehrere B<--slave>-Optionen, jede von drei Argumenten gefolgt, können spezifiziert werden. Beachten Sie, dass die Master-Alternative existieren muss, ansonsten schlägt der Aufruf fehl. Falls allerdings eine Slave-Alternative nicht existiert wird der zugehörige Slave-Alternative-Link einfach nicht installiert (es wird noch eine Warnung ausgegeben). Falls eine echte Datei an einer Stelle installiert wird, an der ein Alternativ-Link installiert werden muss, wird diese beibehalten, solange B<--force> nicht verwandt wird.

note: type: Plain text
en: If the alternative name specified exists already in the alternatives system's records, the information supplied will be added as a new set of alternatives for the group.  Otherwise, a new group, set to automatic mode, will be added with this information.  If the group is in automatic mode, and the newly added alternatives' priority is higher than any other installed alternatives for this group, the symlinks will be updated to point to the newly added alternatives.
de: Falls der angegebene Alternativ-Name bereits in den Aufzeichnungen des Alternativ-Systems existiert, werden die angegebenen Informationen als neuer Satz von Alternativen für die Gruppe hinzugefügt. Andernfalls wird eine neue Gruppe, eingestellt im automatischen Modus, mit dieser Information hinzugefügt. Falls die Gruppe sich im automatischen Modus befindet und die Priorität der neu hinzugefügten Alternative höher ist als die jeder anderen installierten Alternative für diese Gruppe werden die Symlinks aktualisiert, so dass sie auf die neu hinzugefügte Alternative zeigen.

note: type: TP
en: B<--set> I<name path>
de: B<--set> I<Name Pfad>

note: type: Plain text
en: Set the program I<path> as alternative for I<name.> This is equivalent to B<--config> but is non-interactive and thus scriptable.
de: Setzt das Programm I<Pfad> als Alternative für I<Name>. Dies ist äquivalent zu B<--config>, ist aber nicht interaktiv und kann somit geskriptet werden.

note: type: TP
en: B<--remove> I<name path>
de: B<--remove> I<Name Pfad>

note: type: Plain text
en: Remove an alternative and all of its associated slave links.  I<name> is a name in the alternatives directory, and I<path> is an absolute filename to which I<name> could be linked. If I<name> is indeed linked to I<path>, I<name> will be updated to point to another appropriate alternative (and the group is put back in automatic mode), or removed if there is no such alternative left.  Associated slave links will be updated or removed, correspondingly.  If the link is not currently pointing to I<path>, no links are changed; only the information about the alternative is removed.
de: Entferne eine Alternative und alle zugehörigen Slave-Links. I<Name> ist ein Name im Alternativ-Verzeichnis, und I<Pfad> ist ein absoluter Dateiname zu dem I<Name> gelinkt werden könnte. Falls I<Name> tatsächlich nach I<Pfad> gelinkt ist, dann wird I<Name> aktualisiert, um auf eine andere geeignete Alternative zu zeigen (und die Gruppe wird wieder in den automatischen Modus versetzt) oder entfernt, falls keine solche Alternative übrig bleibt. Zugehörige Slave-Links werden entsprechend aktualisiert oder entfernt. Falls der Link derzeit nicht auf I<Pfad> zeigt, werden keine Links geändert; nur die Information über die Alternative wird entfernt.

note: type: TP
en: B<--remove-all> I<name>
de: B<--remove-all> I<Name>

note: type: Plain text
en: Remove all alternatives and all of their associated slave links.  I<name> is a name in the alternatives directory.
de: Entferne alle Alternativen und deren zugehörige Slave-Links. I<Name> ist ein Name im Alternativ-Verzeichnis.

note: type: Plain text
en: Call B<--config> on all alternatives. It can be usefully combined with B<--skip-auto> to review and configure all alternatives which are not configured in automatic mode. Broken alternatives are also displayed.  Thus a simple way to fix all broken alternatives is to call B<yes \[aq]\[aq] | update-alternatives --force --all>.
de: Ruft B<--config> für alle Alternativen auf. In der Kombination mit B<--skip-auto> kann dies nützlich sein, um alle Alternativen zu prüfen und zu konfigurieren, die sich nicht im automatischen Modus befinden. Defekte Alternativen werden auch angezeigt. Um alle defekten Alternativen zu reparieren dient daher ein einfacher Aufruf von B<yes \[aq]\[aq] | update-alternatives --force --all>.

note: type: TP
en: B<--auto> I<name>
de: B<--auto> I<Name>

note: type: Plain text
en: Switch the link group behind the alternative for I<name> to automatic mode.  In the process, the master symlink and its slaves are updated to point to the highest priority installed alternatives.
de: Überführt die Linkgruppe hinter der Alternative mit Name I<Name> in den automatischen Modus. Bei diesem Prozess werden der Master-Symlink und seine Slave-Links aktualisiert, um auf die installierte Alternative mit höchster Priorität zu zeigen.

note: type: TP
en: B<--display> I<name>
de: B<--display> I<Name>

note: type: Plain text
en: Display information about the link group.  Information displayed includes the group's mode (auto or manual), which alternative the master link currently points to, what other alternatives are available (and their corresponding slave alternatives), and the highest priority alternative currently installed.
de: Zeige Informationen über die Linkgruppe an. Die angezeigten Informationen enthalten den Modus der Gruppe (automatisch oder manuell), auf welche Alternative der Master-Link derzeit zeigt, welche weiteren Alternativen zur Verfügung stehen (und ihre zugehörigen Slave-Alternativen), und die installierte Alternative mit der höchsten Priorität.

note: type: Plain text
en: List all master alternative names (those controlling a link group)  and their status. Each line contains up to 3 fields (separated by one or more spaces). The first field is the alternative name, the second one is the status (either "auto" or "manual"), and the last one contains the current choice in the alternative (beware: it's a filename and thus might contain spaces).
de: Führe alle Master-Alternativ-Namen (die eine Linkgruppe steuern) mit ihrem Status auf. Jede Zeile enthält bis zu 3 Felder (getrennt durch mindestens ein Leerzeichen). Im ersten Feld steht der Alternativ-Name, im zweiten der Status (entweder »auto« oder »manual«) und im letzten die derzeitige Wahl der Alternative (Achtung: Dies ist ein Dateiname, der Leerzeichen enthalten kann).

note: type: Plain text
en: Read configuration of alternatives on standard input in the format generated by B<update-alternatives --get-selections> and reconfigure them accordingly.
de: Lese eine Konfiguration von Alternativen über die Standardeingabe im von B<update-alternatives --get-selections> generierten Format und konfiguriere die Alternativen entsprechend neu.

note: type: TP
en: B<--query> I<name>
de: B<--query> I<Name>

note: type: Plain text
en: Display information about the link group like --display does, but in a machine parseable way (see section B<QUERY FORMAT> below).
de: Zeige alle Informationen über die Linkgruppe an, wie dies auch von --display erfolgt, allerdings in einem maschinenlesbaren Format (siehe Abschnitt B<ABFRAGE-FORMAT> unten).

note: type: TP
en: B<--list> I<name>
de: B<--list> I<Name>

note: type: Plain text
en: Display all targets of the link group.
de: Zeige alle Ziele der Linkgruppe an.

note: type: TP
en: B<--config> I<name>
de: B<--config> I<Name>

note: type: Plain text
en: Show available alternatives for a link group and allow the user to interactively select which one to use. The link group is updated.
de: Zeige die verfügbaren Alternativen für eine Linkgruppe an und erlaube es dem Benutzer interaktiv auszuwählen, welche zu benutzen ist. Die Linkgruppe wird aktualisiert.

note: type: TP
en: B<--altdir>I< directory>
de: B<--altdir>I< Verzeichnis>

note: type: Plain text
en: Specifies the alternatives directory, when this is to be different from the default.
de: Spezifiziert das Alternativ-Verzeichnis, wenn sich dieses von der Standardeinstellung unterscheiden soll.

note: type: Plain text
en: Specifies the administrative directory, when this is to be different from the default.
de: Spezifiziert das administrative Verzeichnis, wenn sich dieses von der Standardeinstellung unterscheiden soll.

note: type: TP
en: B<--log>I< file>
de: B<--log>I< Datei>

note: type: Plain text
en: Specifies the log file, when this is to be different from the default (/var/log/alternatives.log).
de: Gibt die Protokolldatei an, wenn diese sich von der Vorgabe (/var/log/alternatives.log) unterscheiden soll.

note: type: Plain text
en: Let B<update-alternatives> replace or drop any real file that is installed where an alternative link has to be installed or removed.
de: Lässt B<update-alternatives> alle echten Dateien ersetzen oder entfernen, die sich an Stellen befinden, an denen ein Alternativ-Link installiert werden muss.

note: type: Plain text
en: Skip configuration prompt for alternatives which are properly configured in automatic mode. This option is only relevant with B<--config> or B<--all>.
de: Überspringt die Konfigurationsabfrage für Alternativen, die korrekt im automatische Modus konfiguriert sind. Diese Option ist nur mit B<--config> oder B<--all> relevant.

note: type: Plain text
en: Generate more comments about what B<update-alternatives> is doing.
de: Erzeugt mehr Kommentare über die Tätigkeit von B<update-alternatives>.

note: type: Plain text
en: Don't generate any comments unless errors occur.
de: Erzeuge keine Kommentare, es sei denn, ein Fehler tritt auf.

note: type: Plain text
en: If set and the B<--admindir> option has not been specified, it will be used as the base administrative directory.
de: Falls gesetzt und die Option B<--admindir> nicht angegeben wurde, wird dies als Basis-Administrationsverzeichnis verwandt.

note: type: Plain text
en: The default alternatives directory.  Can be overridden by the B<--altdir> option.
de: Das standardmäßige Alternativ-Verzeichnis. Kann mittels der Option B<--altdir> geändert werden.

note: type: Plain text
en: The default administration directory.  Can be overridden by the B<--admindir> option.
de: Das standardmäßige administrative Verzeichnis. Kann mittels der B<--admindir> Option geändert werden.

note: type: Plain text
en: The requested action was successfully performed.
de: Die angeforderte Aktion wurde erfolgreich ausgeführt.

note: type: Plain text
en: Problems were encountered whilst parsing the command line or performing the action.
de: Beim Lesen der Kommandozeile oder beim Ausführen der Aktion traten Probleme auf.

note: type: SH
en: QUERY FORMAT
de: ABFRAGE-FORMAT

note: type: Plain text
en: The B<update-alternatives --query> format is using an RFC822-like flat format. It's made of I<n> + 1 blocks where I<n> is the number of alternatives available in the queried link group. The first block contains the following fields:
de: Das Format von B<update-alternatives --query> ist ein RFC822-artiges, flaches Format. Es besteht aus I<n>+1 Blöcken, wobei I<n> die Anzahl der in einer abgefragten Linkgruppe verfügbaren Alternativen ist. Der erste Block enthält die folgenden Felder:

note: type: TP
en: B<Name:>I< name>
de: B<Name:>I< Name>

note: type: Plain text
en: The alternative name in the alternative directory.
de: Der alternative Name im Alternativ-Verzeichnis.

note: type: TP
en: B<Link:>I< link>
de: B<Link:>I< Link>

note: type: Plain text
en: The generic name of the alternative.
de: Der generische Name der Alternative.

note: type: TP
en: B<Slaves:>I< list-of-slaves>
de: B<Slaves:>I< Liste-von-Slaves>

note: type: Plain text
en: When this field is present, the B<next> lines hold all slave links associated to the master link of the alternative. There is one slave per line. Each line contains one space, the generic name of the slave alternative, another space, and the path to the slave link.
de: Wenn diese Feld vorhanden ist enthält die B<nächste> Zeile alle Slave-Links, die dem Masterlink dieser Alternativen zugeordnet sind. Pro Zeile wird ein Slave aufgeführt. Jede Zeile enthält ein Leerzeichen, den generischen Namen des Slaves, ein weiteres Leerzeichen und den Pfad zu dem Slave-Link.

note: type: TP
en: B<Status:>I< status>
de: B<Status:>I< Status>

note: type: Plain text
en: The status of the alternative (B<auto> or B<manual>).
de: Der Status der Alternative (B<auto> oder B<manual>).

note: type: TP
en: B<Best:>I< best-choice>
de: B<Best:>I< beste-Wahl>

note: type: Plain text
en: The path of the best alternative for this link group. Not present if there is no alternatives available.
de: Der Pfad der besten Alternative für diese Linkgruppe. Nicht vorhanden, falls keine Alternative verfügbar ist.

note: type: TP
en: B<Value:>I< currently-selected-alternative>
de: B<Value:>I< derzeit-ausgewählte-Alternative>

note: type: Plain text
en: The path of the currently selected alternative. It can also take the magic value B<none>. It is used if the link doesn't exist.
de: Der Pfad der derzeit ausgewählten Alternative. Es akzeptiert auch den magischen Wert B<none>, der verwandt wird, falls der Link nicht existiert.

note: type: TP
en: The other blocks describe the available alternatives in the queried link group:
de: Die anderen Blöcke beschreiben die verfügbaren Alternativen in der abgefragten Linkgruppe:

note: type: TP
en: B<Alternative:>I< path-of-this-alternative>
de: B<Alternative:>I< Pfad-dieser-Alternativen>

note: type: Plain text
en: Path to this block's alternative.
de: Pfad zum Block dieser Alternativen.

note: type: TP
en: B<Priority:>I< priority-value>
de: B<Priority:>I< Prioritätswert>

note: type: Plain text
en: Value of the priority of this alternative.
de: Wert der Priorität dieser Alternativen.

note: type: Plain text
en: When this header is present, the B<next> lines hold all slave alternatives associated to the master link of the alternative. There is one slave per line. Each line contains one space, the generic name of the slave alternative, another space, and the path to the slave alternative.
de: Wenn diese Kopfzeile vorhanden ist enthält die B<nächste> Zeile alle Slave-Alternativen, die dem Masterlink dieser Alternativen zugeordnet sind. Pro Zeile wird ein Slave aufgeführt. Jede Zeile enthält ein Leerzeichen, den generischen Namen des Slaves, ein weiteres Leerzeichen und den Pfad zu der Slave-Alternative.

note: type: TP
en: B<Example>
de: B<Beispiel>

note: type: Plain text
en: With B<--verbose> B<update-alternatives> chatters incessantly about its activities on its standard output channel.  If problems occur, B<update-alternatives> outputs error messages on its standard error channel and returns an exit status of 2.  These diagnostics should be self-explanatory; if you do not find them so, please report this as a bug.
de: Mit B<--verbose> quatscht B<update-alternatives> ohne Unterlass über seine Aktivitäten auf seinem Standardausgabekanal. Falls Probleme auftreten, gibt B<update-alternatives> eine Fehlermeldung auf seinem Standardfehlerkanal aus und beendet sich mit dem Exit-Status 2. Die Diagnostiken sollten selbsterklärend sein; falls Sie dies nicht so empfinden, melden Sie dies bitte als Fehler.

note: type: Plain text
en: There are several packages which provide a text editor compatible with B<vi>, for example B<nvi> and B<vim>. Which one is used is controlled by the link group B<vi>, which includes links for the program itself and the associated manpage.
de: Es gibt mehrere Pakete, die einen zum B<vi>-kompatiblen Texteditor bereitstellen, beispielsweise B<nvi> und B<vim>. Welcher benutzt wird, wird durch die Linkgruppe B<vi> eingestellt, welche Links für das Programm selber und die zugehörige Handbuchseite beinhaltet.

note: type: Plain text
en: To display the available packages which provide B<vi> and the current setting for it, use the B<--display> action:
de: Um alle verfügbaren Programme anzuzeigen, die B<vi> bereitstellen, und die dazu gehörigen Einstellungen, benutzen Sie die Aktion B<--display>:

note: type: Plain text
en: To choose a particular B<vi> implementation, use this command as root and then select a number from the list:
de: Um eine bestimmte B<vi>-Implementation auszuwählen, benutzen Sie als Root den folgenden Befehl und wählen dann eine Zahl aus der Liste aus:

note: type: Plain text
en: To go back to having the B<vi> implementation chosen automatically, do this as root:
de: Um zur automatischen Auswahl der B<vi>-Implementation zurückzukehren, führen Sie folgendes als Root aus:

note: type: Plain text
en: If you find a bug, please report it using the Debian bug-tracking system.
de: Falls Sie einen Fehler finden, melden Sie ihn bitte über die Fehlerdatenbank von Debian.

note: type: Plain text
en: If you find any discrepancy between the operation of B<update-alternatives> and this manual page, it is a bug, either in the implementation or the documentation; please report it.
de: Falls Sie einen Unterschied zwischen der Implementation von B<update-alternatives> und dieser Handbuchseite finden, ist dies ein Fehler, entweder in der Implementation oder in der Dokumentation; bitte melden Sie dies.

note: type: Plain text
en: B<ln>(1), FHS, the Filesystem Hierarchy Standard.
de: B<ln>(1), FHS, der Dateisystem Hierarchie-Standard (Filesystem Hierarchy Standard).

en: No man page matching to %1 found.<br><br>Check that you have not mistyped the name of the page that you want.
    Be careful that you must take care about upper case and lower case characters!<br>If everything looks correct, then perhaps you need to set a better search path for man pages, be it by the environment variable MANPATH or a matching file in the directory /etc .
de: 找不到符合 %1 的 man page。<br><br>請檢查您是否打錯您所要頁面的名稱。
    請注意您必須確認大寫與小寫字母！<br>如果一切看來都正確，可能您得設定一個更好的 man page 搜尋路徑，可用 MANPATH 環境變數或在 /etc 目錄中符合的檔案來設定。

en: Open of %1 failed.
de: 開啟 %1 失敗。

en: Man output
de: Man 輸出

en: <body><h1>KDE Man Viewer Error</h1>
de: <body><h1>KDE Man Viewer 錯誤</h1>

en: There is more than one matching man page.
de: 符合的 man page 不只一項。

en: Note: if you read a man page in your language, be aware it can contain some mistakes or be obsolete. In case of doubt, you should have a look at the English version.
de: 注意：如果您以您的語言來閱讀 man page，請小心它可能包含一些錯誤和缺漏。如果對此有疑慮，您應該使用英語版本。

en: System Calls
de: 系統呼叫

en: Subroutines
de: 函式呼叫

en: Perl Modules
de: Perl 模組

en: Network Functions
de: 網路功能

en: Devices
de: 裝置

en: File Formats
de: 檔案格式

en: System Administration
de: 系統管理

en: Kernel
de: 核心

en: Local Documentation
de: 本地端文件

en: New
de: 新項目

en: UNIX Manual Index
de: UNIX 手冊索引

en: Section
de: 章節

en: Index for Section %1: %2
de: 章節索引 %1：%2

en: Generating Index
de: 產生索引中

en: Could not find the sgml2roff program on your system. Please install it, if necessary, and extend the search path by adjusting the environment variable PATH before starting KDE.
de: 抱歉，您的系統並未安裝 sgm2roff。請確認您有正確安裝上該程式套件，並確認 PATH 環境變數內能夠找到該程式項目。

note: type: TH
en: Manual pager utils
de: Værktøjer til manualsider

note: type: Plain text
en: %apropos% - search the manual page names and descriptions
de: %apropos% - søg i manualens sidenavne og beskrivelser

note: type: Plain text
en: B<%apropos%> [\|B<-dalhvV>\|] [\|B<-e>\||\|B<-w>\||\|B<-r>\|] [\|B<-s> I<list>\|] [\|B<-m> I<system>\|[\|,.\|.\|.\|]\|] [\|B<-M> I<path>\|] [\|B<-L> I<locale>\|] [\|B<-C> I<file>\|] I<keyword> \&.\|.\|.
de: B<%apropos%> [\|B<-dalhvV>\|] [\|B<-e>\||\|B<-w>\||\|B<-r>\|] [\|B<-s> I<liste>\|] [\|B<-m> I<system>\|[\|,.\|.\|.\|]\|] [\|B<-M> I<sti>\|] [\|B<-L> I<sted>\|] [\|B<-C> I<fil>\|] I<nøgleord> \&.\|.\|.

note: type: Plain text
en: Each manual page has a short description available within it.  B<%apropos%> searches the descriptions for instances of I<keyword>.
de: Hver manualside har en kort beskrivelse tilgængelig. B<%apropos%> søger i beskrivelserne efter resultater indeholdende I<nøgleord>.

note: type: Plain text
en: I<keyword> is usually a regular expression, as if (B<-r>)  was used, or may contain wildcards (B<-w>), or match the exact keyword (B<-e>).  Using these options, it may be necessary to quote the I<keyword> or escape (\e) the special characters to stop the shell from interpreting them.
de: I<nøgleord> er normalt et regulært udtryk, som om (B<-r>) blev brugt, eller kan indeholde jokertegn (B<-w>), eller matche det præcise nøgleord (B<-e>). Ved brug af disse tilvalg kan det være nødvendigt at placere I<nøgleord> i citationstegn eller escape (\e), de specielle tegn der stopper skallen fra at fortolke dem.

note: type: Plain text
en: The standard matching rules allow matches to be made against the page name and word boundaries in the description.
de: De normale matchregler tillader at match foretages mod sidenavnet og ordgrænser i beskrivelsen.

note: type: Plain text
en: The database searched by B<%apropos%> is updated by the B<%mandb%> program.  Depending on your installation, this may be run by a periodic cron job, or may need to be run manually after new manual pages have been installed.
de: Databasen der søges i af B<%apropos%> opdateres af programmet B<%mandb%>. Afhængig af din installation kan dette enten køres af et regelmæssigt cronjob eller skal køres manuelt efter at nye manualsider er blevet installeret.

note: type: Plain text
en: Print debugging information.
de: Vis fejlsøgningsinformation.

note: type: Plain text
en: Print verbose warning messages.
de: Vis uddybende advarsler.

note: type: Plain text
en: Interpret each keyword as a regular expression.  This is the default behaviour.  Each keyword will be matched against the page names and the descriptions independently.  It can match any part of either.  The match is not limited to word boundaries.
de: Fortolk hvert nøgleord som et regulært udtryk. Dette er standardopførelsen. Hvert nøgleord vil blive matchet mod sidenavnene og beskrivelserne uafhængigt. Programmet kan matche enhver del af begge. Matchen er ikke begrænset til ordgrænser.

note: type: Plain text
en: Each keyword will be exactly matched against the page names and the descriptions.
de: Hvert nøgleord vil blive matchet mod sidenavnene og beskrivelserne.

note: type: TP
en: B<-M\ >I<path>,\ B<--manpath=>I<path>
de: B<-M\ >I<sti>,\ B<--manpath=>I<sti>

note: type: TP
en: B<-C\ >I<file>,\ B<--config-file=>I<file>
de: B<-C\ >I<fil>,\ B<--config-file=>I<fil>

note: type: Plain text
en: Use this user configuration file rather than the default of I<~/.manpath>.
de: Brug denne brugerkonfigurationsfil frem for standarden I<~/.manpath>.

note: type: Plain text
en: Print a help message and exit.
de: Vis en hjælpebesked og afslut.

note: type: Plain text
en: Successful program execution.
de: Programkørsel endt uden fejl.

note: type: Plain text
en: Usage, syntax or configuration file error.
de: Brugs-, syntaks- eller konfigurationsfilfejl.

note: type: Plain text
en: Operational error.
de: Operationel fejl.

note: type: Plain text
en: Nothing was found that matched the criteria specified.
de: Intet blev fundet som matchede de angivne kriterier.

note: type: Plain text
en: If $B<SYSTEM> is set, it will have the same effect as if it had been specified as the argument to the B<-m> option.
de: Hvis $B<SYSTEM> er angivet, vil det have den samme effekt, som hvis den var blevet angivet som argument for tilvalget B<-m>.

note: type: Plain text
en: A traditional B<whatis> text database.
de: En traditionel B<whatis>-tekstdatabase.

note: type: Plain text
en: lexgrog - parse header information in man pages
de: lexgrog - fortolk hovedfilsinformation i manualsider

note: type: Plain text
en: B<lexgrog> [\|B<-m>\||\|B<-c>\|] [\|B<-fhwV>\|] [\|B<-E> I<encoding>\|] I<file> \&.\|.\|.
de: B<lexgrog> [\|B<-m>\||\|B<-c>\|] [\|B<-fhwV>\|] [\|B<-E> I<kodning>\|] I<fil> \&.\|.\|.

note: type: TP
en: B<-E> I<encoding>, B<--encoding> I<encoding>
de: B<-E> I<kodning>, B<--encoding> I<kodning>

note: type: Plain text
en: Usage error.
de: Fejl i anvendelse.

note: type: Plain text
en: The code used by B<lexgrog> to scan man pages was written by:
de: Koden brugt af B<lexgrog> til at skanne manualsider blev skrevet af:

note: type: Plain text
en: Colin Watson wrote the current incarnation of the command-line front-end, as well as this man page.
de: Colin Watson skrev den aktuelle inkarnation af kommandolinjebrugerfladen, samt denne manualside.

note: type: Plain text
en: %man% - an interface to the on-line reference manuals
de: %man% - en grænseflade til referencemanualerne på nettet

note: --help and --version type: Plain text
en: B<%man%> B<-c> [\|B<-C> I<file>\|] [\|B<-d>\|] [\|B<-D>\|] I<page> \&.\|.\|.
de: B<%man%> B<-c> [\|B<-C> I<fil>\|] [\|B<-d>\|] [\|B<-D>\|] I<side> \&.\|.\|.

note: type: tbl table
en: Executable programs or shell commands
de: Kørbare programmer eller skalkommandoer

note: type: tbl table
en: System calls (functions provided by the kernel)
de: Systemkald (funktioner stillet til rådighed af kernen)

note: type: tbl table
en: Library calls (functions within program libraries)
de: Bibliotekskald (funktioner i programbiblioteker)

note: type: tbl table
en: Special files (usually found in I</dev>)
de: Specielle filer (normalt fundet i I</dev>)

note: type: tbl table
en: File formats and conventions eg I</etc/passwd>
de: Filformater og konventioner f.eks. I</etc/passwd>

note: type: tbl table
en: Miscellaneous (including macro packages and conventions),
    e.g. B<man>(7), B<groff>(7)
de: Diverse (inklusiv makropakker og konventioner),
    f.eks. B<man>(7), B<groff>(7)

note: type: tbl table
en: System administration commands (usually only for root)
de: Kommandoer til systemadministration (normalt kun for root)

note: type: tbl table
en: Kernel routines [\|Non standard\|]
de: Kernerutiner [\|Ikkestandard\|]

note: type: tbl table
en: B<bold text>
de: B<fed tekst>

note: type: tbl table
en: type exactly as shown.
de: skriv præcis som vist.

note: type: tbl table
en: I<italic text>
de: I<kursiv>

note: type: tbl table
en: replace with appropriate argument.
de: erstat med passende argument.

note: type: tbl table
en: any or all arguments within [ ] are optional.
de: et eller alle argumenter inden i [ ] er valgfrie.

note: type: tbl table
en: options delimited by | cannot be used together.
de: tilvalg afgrænset af | kan ikke bruges sammen.

note: type: tbl table
en: I<argument> is repeatable.
de: I<argument> kan gentages.

note: type: tbl table
en: [\|I<expression>\|] .\|.\|.
de: [\|I<udtryk>\|] .\|.\|.

note: type: SH
en: OVERVIEW
de: APERÇU

note: type: Plain text
en: Don't actually display the manual pages, but do print the location(s) of the cat files that would be displayed.  If -w and -W are both specified, print both separated by a space.
de: Vis ikke reelt manualsiderne, men vis dog placeringerne for katalogfilerne, som ville være blevet vist. Hvis -w og -W begge er angivet, så vis begge adskilt af mellemrum.

note: type: Plain text
en: This option is not for general use and should only be used by the B<%catman%> program.
de: Dette tilvalg er ikke for generel brug og bør kun bruges af programmet B<%catman%>.

note: type: TP
en: B<-R\ >I<encoding>,\ B<--recode>=I<encoding>
de: B<-R\ >I<kodning>,\ B<--recode>=I<kodning>

note: type: SS
en: Finding manual pages
de: Finde manualsider

note: type: Plain text
en: If this system has access to other operating system's manual pages, they can be accessed using this option.  To search for a manual page from NewOS's manual page collection, use the option B<-m> B<NewOS>.
de: Hvis dette system har adgang til andre operativsystemers manualsider, så kan de tilgås med dette tilvalg. For at søge efter en manualside fra NytOS's manualsidesamling bruges tilvalget B<-m> B<NytOS>.

note: type: Plain text
en: The I<system> specified can be a combination of comma delimited operating system names.  To include a search of the native operating system's manual pages, include the system name B<man> in the argument string.  This option will override the $B<SYSTEM> environment variable.
de: Det angivet I<system> kan være en kombination af kommaadskilt operativsystemnavne. For at inkludere en søgning i manualsiderne for udgangspunktets operativsystem inkluderes systemnavnet B<man> i argumentstrengen. Dette tilvalg vil overskrive miljøvariablen $B<SYSTEM>.

note: type: Plain text
en: Specify an alternate manpath to use.  By default, B<%man%> uses B<%manpath%> derived code to determine the path to search.  This option overrides the $B<MANPATH> environment variable and causes option B<-m> to be ignored.
de: Angiv en alternativ manualsti. Som standard bruger B<%man%> B<%manpath%>-afledt kode til at bestemme søgestien. Dette tilvalg overskriver miljøvariablen $B<MANPATH> og medfører at tilvalget B<-m> ignoreres.

note: type: TP
en: B<-S\ >I<list>,\ B<-s\ >I<list>,\ B<--sections=>I<list>
de: B<-S\ >I<liste>,\ B<-s\ >I<liste>,\ B<--sections=>I<liste>

note: type: Plain text
en: To disable this behaviour, use the B<--no-subpages> option.
de: For at deaktivere denne opførsel så brug tilvalget B<--no-subpages>.

note: type: Plain text
en: B<(press h for help or q to quit)>
de: B<(tryk h for hjælp eller q for afslut)>

note: type: TP
en: B<-E\ >I<encoding>,\ B<--encoding>=I<encoding>
de: B<-E\ >I<kodning>,\ B<--encoding>=I<kodning>

note: type: TP
en: B<-p\ >I<string>,\ B<--preprocessor=>I<string>
de: B<-p\ >I<streng>,\ B<--preprocessor=>I<streng>

note: type: SS
en: Getting help
de: Få hjælp

note: type: Plain text
en: A child process returned a non-zero exit status.
de: En underproces returnerede en afslutningsstatus forskellig fra nul.

note: type: Plain text
en: At least one of the pages/files/keywords didn't exist or wasn't matched.
de: Mindst en af siderne/filerne/nøgleordene fandtes ikke eller blev ikke matchet.

note: type: Plain text
en: man-db configuration file.
de: konfigurationsfil for man-db.

note: type: Plain text
en: the man-db package manual, B<FSSTND>
de: Manual for pakken man-db, B<FSSTND>

note: #-#-#-#-#  5 (man-db-manpages 2.6.1-pre1)  #-#-#-#-# type: SH
en: HISTORY
de: HISTORIK

note: type: Plain text
en: 1990, 1991 - Originally written by John W. Eaton (jwe@che.utexas.edu).
de: 1990, 1991 - Oprindelig skrevet af John W. Eaton (jwe@che.utexas.edu).

note: type: TP
en: B<-f> I<encodings>, B<--from-code> I<encodings>
de: B<-f> I<Kodninger>, B<--from-code> I<Kodninger>

note: type: TP
en: B<-t> I<encoding>, B<--to-code> I<encoding>
de: B<-t> I<kodning>, B<--to-code> I<kodning>

note: type: Plain text
en: Convert the manual page to I<encoding>.
de: Konverter manualsiden til I<kodning>.

note: type: Plain text
en: Do not issue error messages when the page cannot be converted.
de: Vis ikke fejlbeskeder når siden ikke kan konverteres.

note: type: Plain text
en: Do not issue warnings.
de: Vis ikke advarsler.

note: type: Plain text
en: The following field types are currently recognised:
de: De følgende felttyper genkendes i øjeblikket:

note: type: TP
en: B<#>I<\ comment>
de: B<#>I<\ kommentar>

note: type: Plain text
en: Blank lines or those beginning with a B<#> will be treated as comments and ignored.
de: Tomme linjer eller dem som begynder med B<#> vil blive opfattet som kommentarer og ignoreret.

note: type: TP
en: B<DEFINE>I<\ key\ value>
de: B<DEFINER>I<\ nøgle\ værdi>

note: type: Plain text
en: accessdb - dumps the content of a man-db database in a human readable format
de: accessdb - dumper indholdet af en man-db-database i et læsbart format

note: type: Plain text
en: Supplying an argument to accessdb will override this default.
de: Angivelse af et argument til accessdb vil overskrive denne standard.

note: type: tbl table
en: Name
de: Navn

note: type: tbl table
en: Filename
de: Filnavn

note: type: tbl table
en: Binary tree
de: Binært træ

note: type: tbl table
en: Yes
de: Ja

note: type: tbl table
en: No
de: Nej

note: type: Plain text
en: Produce no warnings.
de: Lav ingen advarsler.

note: type: Plain text
en: Show the version, then exit.
de: Vis versionen og afslut.

note: type: Plain text
en: Usage, syntax, or configuration file error.
de: Brugs- syntaks- eller konfigurationsfilfejl.

note: type: Plain text
en: A child process failed.
de: En underproces mislykkedes.

note: type: Plain text
en: The following warning messages can be emitted during database building.
de: De følgende advarselsbeskeder kan udelades under opbygning af database.

note: type: Plain text
en: Older locations for the database cache included:
de: Tidligere placeringer for databasens mellemlager inkluderede:

note: type: Attribute 'lang' of: <refentry>
en: en
de: ja

note: type: Content of: <refentry><refentryinfo><authorgroup><author><contrib>
en: Developer
de: 開発者

note: type: Content of: <refentry><refnamediv><refpurpose>
en: extract tracks from &matroska; files into other files
de: &matroska; ファイルから、他の形式のファイルを抽出する

note: type: Content of: <refentry><refsynopsisdiv><title>
en: Synopsis
de: 書式

note: type: Content of: <refentry><refsect1><para>
en: This program extracts specific parts from a &matroska; file to other useful formats. The first argument, <option>mode</option>, tells &mkvextract; what to extract. Currently supported is the extraction of <link linkend="mkvextract.description.tracks">tracks</link>, <link linkend="mkvextract.description.tags">tags</link>, <link linkend="mkvextract.description.attachments">attachments</link>, <link linkend="mkvextract.description.chapters">chapters</link>, <link linkend="mkvextract.description.cuesheets">CUE sheets</link> and <link linkend="mkvextract.description.timecodes_v2">timecodes</link>.  The second argument is the name of the source file. It must be a &matroska; file. All following arguments are options and extraction specifications; both of which depend on the selected mode.
de: &matroska; ファイルの特定の部分を、他の有用なフォーマットで抽出します。最初の<option>mode</option>引数は、&mkvextract; に何を抽出すべきかを指示します。現在サポートされているのは、<link linkend="mkvextract.description.tracks">トラック</link>、<link linkend="mkvextract.description.tags">タグ</link>、<link linkend="mkvextract.description.attachments">添付ファイル</link>、<link linkend="mkvextract.description.chapters">チャプタ</link>、<link linkend="mkvextract.description.cuesheets">CUEシート</link> 及び <link linkend="mkvextract.description.timecodes_v2">タイムコード</link>の抽出です。二個目の引数はソースファイルの名前です。これは&matroska;ファイルでなければなりません。続く全ての引数は、オプションと抽出設定です。これらは指定されたmodeに依存します。

note: type: Content of: <refentry><refsect1><refsect2><title>
en: Common options
de: 共通オプション

note: type: Content of: <refentry><refsect1><refsect2><para>
en: The following options are available in all modes and only described once in this section.
de: 以下のオプションは、全てのmodeで使用できるので、このセクションで一括して説明します。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Sets the parse mode to 'full'. The default mode does not parse the whole file but uses the meta seek elements for locating the required elements of a source file. In 99% of all cases this is enough. But for files that do not contain meta seek elements or which are damaged the user might have to use this mode. A full scan of a file can take a couple of minutes while a fast scan only takes seconds.
de: 解析モードを'full'に設定します。デフォルトのモードでは、ソースファイルの必要な要素を見つけるのにファイル全体を解析せずにメタシーク要素を使用します。99%のケースではこれで十分ですが、メタシーク要素が含まれていなかったり壊れていたりするファイルにはこのモードを使用しなければならないかもしれません。高速スキャンが数秒しかかからないのに対して、ファイルをフルスキャンするのには数分かかることがあります。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Sets the character set to convert strings given on the command line from. It defaults to the character set given by system's current locale.
de: コマンドライン文字列の文字コードを指定します。デフォルトは、システムの現在のロケールの文字コードになります。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Sets the character set to which strings are converted that are to be output.  It defaults to the character set given by system's current locale.
de: 出力する文字コードを指定します。デフォルトは、システムの現在のロケールの文字コードになります。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Writes all messages to the file <parameter>file-name</parameter> instead of to the console.  While this can be done easily with output redirection there are cases in which this option is needed: when the terminal reinterprets the output before writing it to a file.  The character set set with <link linkend="mkvextract.description.common.output_charset"><option>--output-charset</option></link> is honored.
de: 全てのメッセージを、コンソールではなく<parameter>file-name</parameter>に書き出します。出力をリダイレクトすることで同じことが容易に可能ですが、このオプションが必要になることもあります。ターミナルが出力を、ファイルに書き出す前に処理してしまう場合などです。<link linkend="mkvextract.description.common.output_charset"><option>--output-charset</option></link>によって指定された文字コードは尊重されます。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Forces the translations for the language <parameter>code</parameter> to be used (e.g.  '<literal>de_DE</literal>' for the German translations). It is preferable to use the environment variables <varname>LANG</varname>, <varname>LC_MESSAGES</varname> and <varname>LC_ALL</varname> though. Entering '<literal>list</literal>' as the <parameter>code</parameter> will cause &mkvextract; to output a list of available translations.
de: 指定した<parameter>code</parameter>を強制的に言語コード(例: 日本語ならば'<literal>ja_JP</literal>')として使用します。しかし、環境変数<varname>LANG</varname>や<varname>LC_MESSAGES</varname>、<varname>LC_ALL</varname>を使用したほうが好ましいでしょう。<parameter>code</parameter>に<literal>list</literal>と指定すると、指定できる言語コードの一覧を出力します。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Turn on debugging for a specific feature. This option is only useful for developers.
de: 特定の機能のデバッグをオンにします。このオプションは開発者にのみ有用です。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Turn on experimental features. A list of available features can be requested with <command>mkvextract --engage list</command>. These features are not meant to be used in normal situations.
de: 実験的機能をオンにします。利用可能な機能のリストは <command>mkvextract --engage list</command>で得られます。これらの機能は通常の状況で使用されることを意図されていません。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Be verbose and show all the important &matroska; elements as they're read.
de: 出力が冗長になり、&matroska;のエレメントにとって重要なこと全てを、読み込まれるつどに表示していきます。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Show version information and exit.
de: バージョン情報を出力して終了します。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Afterwards the program exists with an exit code of 0 if no newer release is available, with 1 if a newer release is available and with 2 if an error occured (e.g. if the update information could not be retrieved).
de: その後プログラムは、新しいリリースが入手可能ではなかった場合は終了コード0で、新しいリリースが入手可能であった場合は終了コード1で、エラーが発生した場合（例：アップデート情報を取得できなかった場合）は終了コード2で、それぞれ終了します。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: This option is only available if the program was built with support for libcurl.
de: このオプションは、プログラムがlibcurlのサポートつきでビルドされた場合のみ使用できます。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Reads additional command line arguments from the file <parameter>options-file</parameter>.  Lines whose first non-whitespace character is a hash mark ('<literal>#</literal>') are treated as comments and ignored. White spaces at the start and end of a line will be stripped. Each line must contain exactly one option.
de: <parameter>options-file</parameter>で指定されたファイルから追加のコマンドラインオプションを読み込みます。行で最初の空白文字でない文字がハッシュマーク('<literal>#</literal>')である行はコメントとして扱われ、無視されます。行頭、及び行末の空白文字は取り除かれます。各行には一つずつしかオプションを指定できません。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Several chars can be escaped, e.g. if you need to start a non-comment line with '#'. The rules are described in <link linkend="mkvextract.escaping">the section about escaping text</link>.
de: エスケープすることができる文字もあります。例えば、コメントではない行を'#'で始める必要がある場合です。そのルールは、<link linkend="mkvextract.escaping">エスケープ文字についてのセクション</link>で説明されています。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: The command line '<command>mkvextract tracks source.mkv --raw 1:destination.raw</command>' could be converted into the following option file:
de: '<command>mkvextract tracks source.mkv --raw 1:destination.raw</command>'というコマンドラインと同じことは、次のようなオプションファイルによって指定できます。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><programlisting>
en: # Extract a track from source.mkv
    tracks
    source.mkv
    # Output the track as raw data.
    --raw
    1:destination.raw
de: # source.mkv からトラックを抽出
    tracks
    source.mkv
    # トラックをrawデータとして出力
    --raw 
    1:destination.raw

note: type: Content of: <refentry><refsect1><refsect2><title>
en: Track extraction mode
de: トラック抽出モード

note: type: Content of: <refentry><refsect1><refsect2><para>
en: Syntax: <command>mkvextract</command> <option>tracks</option> <parameter>source-filename</parameter> <optional><parameter>options</parameter></optional> <parameter>TID1:dest-filename1</parameter> <optional><parameter>TID2:dest-filename2</parameter> ...</optional>
de: 書式: <command>mkvextract</command> <option>tracks</option> <parameter>source-filename</parameter> <optional><parameter>options</parameter></optional> <parameter>TID1:dest-filename1</parameter> <optional><parameter>TID2:dest-filename2</parameter> ...</optional>

note: type: Content of: <refentry><refsect1><refsect2><para>
en: The following command line options are available for each track in the '<literal>tracks</literal>' extraction mode.  They have to appear in front of the track specification (see below) they should be applied to.
de: 以下のコマンドラインオプションは、トラック抽出モードでは各トラック毎に指定することができます。これらのオプションは、作用するトラック指定子(下記参照)の前に指定しなければなりません。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Sets the character set to convert the next text subtitle track to. Only valid if the next track ID targets a text subtitle track. It defaults to UTF-8.
de: 直後の字幕トラックの出力文字コードを指定します。直後のトラックIDが指すのが、字幕トラックのときのみ有効です。デフォルトはUTF-8になります。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Keep only the BlockAdditions up to this level.  The default is to keep all levels.  This option only affects certain kinds of codecs like WAVPACK4.
de: このレベルまでのBlockAdditionを保持します。デフォルトでは全て保持します。このオプションは、WAVPACK4などの特定のコーデックにのみ有効です。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Causes &mkvextract; to extract a <abbrev>CUE</abbrev> sheet from the chapter information and tag data for the following track into a file whose name is the track's output name with '<literal>.cue</literal>' appended to it.
de: &mkvextract;に、直後のトラックのチャプタ情報とタグデータから<abbrev>CUE</abbrev>シートを生成します。出力ファイルの名前はトラックの出力名に'<literal>.cue</literal>'をつけたものになります。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Extracts the raw data into a file without any container data around it.  Unlike the <link linkend="mkvextract.description.tracks.fullraw"><option>--fullraw</option></link> flag this flag does not cause the contents of the <classname>CodecPrivate</classname> element to be written to the file.  This mode works with all <classname>CodecIDs</classname>, even the ones that &mkvextract; doesn't support otherwise, but the resulting files might not be usable.
de: コンテナ情報を含まない、rawデータをファイルに抽出します。<link linkend="mkvextract.description.tracks.fullraw"><option>--fullraw</option></link>フラグとは違い、このフラグは<classname>CodecPrivate</classname>要素の内容はファイルに書き出しません。このモードは、&mkvextract;がサポートしないものも含めて全ての<classname>CodecID</classname>で使用できますが、出力されたファイルは使用できないかもしれません。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Extracts the raw data into a file without any container data around it.  The contents of the <classname>CodecPrivate</classname> element will be written to the file first if the track contains such a header element.  This mode works with all <classname>CodecIDs</classname>, even the ones that &mkvextract; doesn't support otherwise, but the resulting files might not be usable.
de: コンテナ情報を含まない、rawデータをファイルに抽出します。トラックが<classname>CodecPrivate</classname>要素のヘッダ情報を含む場合、その内容はファイルの先頭に書き出されます。このモードは、&mkvextract;がサポートしない<classname>CodecID</classname>にも使用できますが、出力されたファイルは使用できないかもしれません。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Causes extraction of the track with the ID <parameter>TID</parameter> into the file <parameter>outname</parameter> if such a track exists in the source file. This option can be given multiple times. The track IDs are the same as the ones output by &mkvmerge;'s <option>--identify</option> option.
de: IDが<parameter>TID</parameter>であるトラックがソースファイルに存在すれば、<parameter>outname</parameter>に抽出します。このオプションは複数回指定できます。トラックIDは、&mkvmerge;に<option>--identify</option>を指定して実行した際の出力に表示されるものと同じです。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Each output name should be used only once. The exception are RealAudio and RealVideo tracks. If you use the same name for different tracks then those tracks will be saved in the same file. Example:
de: 各出力ファイル名は一回しか使用されません。RealAudio及びRealVideoトラックは例外です。もし、異なるトラックに同じファイル名が指定された場合、それらは同一のファイルに保存されます。例:

note: type: Content of: <refentry><refsect1><refsect2><title>
en: Tags extraction mode
de: タグ抽出モード

note: type: Content of: <refentry><refsect1><refsect2><para>
en: Syntax: <command>mkvextract</command> <option>tags</option> <parameter>source-filename</parameter> <optional><parameter>options</parameter></optional>
de: 書式: <command>mkvextract</command> <option>tags</option> <parameter>source-filename</parameter> <optional><parameter>options</parameter></optional>

note: type: Content of: <refentry><refsect1><refsect2><para>
en: The extracted tags are written to the console unless the output is redirected (see the section about <link linkend="mkvextract.output_redirection">output redirection</link> for details).
de: 抽出されたタグは、出力がリダイレクトされていなければコンソールに出力されます。(詳細については、<link linkend="mkvextract.output_redirection">出力リダイレクト</link>についてのセクションを参照ください。)

note: type: Content of: <refentry><refsect1><refsect2><title>
en: Attachments extraction mode
de: 添付ファイル抽出モード

note: type: Content of: <refentry><refsect1><refsect2><para>
en: Syntax: <command>mkvextract</command> <option>attachments</option> <parameter>source-filename</parameter> <optional><parameter>options</parameter></optional> <parameter>AID1:outname1</parameter> <optional><parameter>AID2:outname2</parameter> ...</optional>
de: 書式: <command>mkvextract</command> <option>attachments</option> <parameter>source-filename</parameter> <optional><parameter>options</parameter></optional> <parameter>AID1:outname1</parameter> <optional><parameter>AID2:outname2</parameter> ...</optional>

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Causes extraction of the attachment with the ID <parameter>AID</parameter> into the file <parameter>outname</parameter> if such an attachment exists in the source file.  If the <parameter>outname</parameter> is left empty then the name of the attachment inside the source &matroska; file is used instead.  This option can be given multiple times.  The attachment IDs are the same as the ones output by &mkvmerge;'s <option>--identify</option> option.
de: IDが<parameter>AID</parameter>である添付ファイルがもしソースファイルに存在すれば抽出します。<parameter>outname</parameter>が指定されない場合、&matroska;に格納された添付ファイルの名前が使用されます。このオプションは複数回指定できます。添付ファイルIDは、&mkvmerge;に<option>--identify</option>オプションを指定したときに出力されるものと同じです。

note: type: Content of: <refentry><refsect1><refsect2><title>
en: Chapters extraction mode
de: チャプタ抽出モード

note: type: Content of: <refentry><refsect1><refsect2><para>
en: Syntax: <command>mkvextract</command> <option>chapters</option> <parameter>source-filename</parameter> <optional><parameter>options</parameter></optional>
de: 書式: <command>mkvextract</command> <option>chapters</option> <parameter>source-filename</parameter> <optional><parameter>options</parameter></optional>

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Exports the chapter information in the simple format used in the <abbrev>OGM</abbrev> tools (CHAPTER01=..., CHAPTER01NAME=...). In this mode some information has to be discarded. Default is to output the chapters in &xml; format.
de: チャプタ情報を<abbrev>OGM</abbrev> toolsで使用される、シンプルフォーマット(CHAPTER01=..., CHAPTER01NAME=...)で出力します。このモードでは、一部の情報は破棄されます。デフォルトでは、チャプタは&xml;フォーマットで出力されます。

note: type: Content of: <refentry><refsect1><refsect2><para>
en: The extracted chapters are written to the console unless the output is redirected (see the section about <link linkend="mkvextract.output_redirection">output redirection</link> for details).
de: 抽出されたチャプタは、出力がリダイレクトされていなければコンソールに出力されます。(詳細については、<link linkend="mkvextract.output_redirection">出力リダイレクト</link>についてのセクションを参照ください。)

note: type: Content of: <refentry><refsect1><refsect2><title>
en: Cue sheet extraction mode
de: CUEシート抽出モード

note: type: Content of: <refentry><refsect1><refsect2><para>
en: Syntax: <command>mkvextract</command> <option>cuesheet</option> <parameter>source-filename</parameter> <optional><parameter>options</parameter></optional>
de: 書式: <command>mkvextract</command> <option>cuesheet</option> <parameter>source-filename</parameter> <optional><parameter>options</parameter></optional>

note: type: Content of: <refentry><refsect1><refsect2><para>
en: The extracted cue sheet is written to the console unless the output is redirected (see the section about <link linkend="mkvextract.output_redirection">output redirection</link> for details).
de: 抽出されたCUEシートは、出力がリダイレクトされていなければコンソールに出力されます。(詳細については、<link linkend="mkvextract.output_redirection">出力リダイレクト</link>についてのセクションを参照ください。)

note: type: Content of: <refentry><refsect1><refsect2><title>
en: Timecode extraction mode
de: タイムコード抽出モード

note: type: Content of: <refentry><refsect1><refsect2><para>
en: Syntax: <command>mkvextract</command> <option>timecodes_v2</option> <parameter>source-filename</parameter> <optional><parameter>options</parameter></optional> <parameter>TID1:dest-filename1</parameter> <optional><parameter>TID2:dest-filename2</parameter> ...</optional>
de: 書式: <command>mkvextract</command> <option>timecodes_v2</option> <parameter>source-filename</parameter> <optional><parameter>options</parameter></optional> <parameter>TID1:dest-filename1</parameter> <optional><parameter>TID2:dest-filename2</parameter> ...</optional>

note: type: Content of: <refentry><refsect1><refsect2><para>
en: The extracted timecodes are written to the console unless the output is redirected (see the section about <link linkend="mkvextract.output_redirection">output redirection</link> for details).
de: 抽出されたタイムコードは、出力がリダイレクトされていなければコンソールに出力されます。(詳細については、<link linkend="mkvextract.output_redirection">出力リダイレクト</link>についてのセクションを参照ください。)

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Causes extraction of the timecodes for the track with the ID <parameter>TID</parameter> into the file <parameter>outname</parameter> if such a track exists in the source file. This option can be given multiple times. The track IDs are the same as the ones output by &mkvmerge;'s <option>--identify</option> option.
de: IDが<parameter>TID</parameter>であるトラックがソースファイルに存在すれば、タイムコードを<parameter>outname</parameter>に抽出します。このオプションは複数回指定できます。トラックIDは、&mkvmerge;に<option>--identify</option>を指定して実行した際の出力に表示されるものと同じです。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Example:
de: 例:

note: type: Content of: <refentry><refsect1><title>
en: Output redirection
de: 出力リダイレクト

note: type: Content of: <refentry><refsect1><para>
en: Several extraction modes cause &mkvextract; to write the extracted data to the console. There are generally two ways of writing this data into a file: one provided by the shell and one provided by &mkvextract; itself.
de: いくつかのモードでは、&mkvextract;は抽出されたデータをコンソールに出力します。一般的に、このデータをファイルに書き出すには二つの方法があります。一つはシェルによって提供され、もう一つは&mkvextract;自体によって提供されます。

note: type: Content of: <refentry><refsect1><para>
en: The shell's builtin redirection mechanism is used by appending '<literal>&gt; output-filename.ext</literal>' to the command line. Example:
de: シェルビルトインのリダイレクト機構は、コマンドラインに'<literal>&gt; output-filename.ext</literal>'を追加することで使用できます。例:

note: type: Content of: <refentry><refsect1><para>
en: &mkvextract;'s own redirection is invoked with the <link linkend="mkvextract.description.common.redirect_output"><option>--redirect-output</option></link> option. Example:
de: &mkvextract;自体のリダイレクトは、<link linkend="mkvextract.description.common.redirect_output"><option>--redirect-output</option></link>オプションを指定することで使用できます。例:

note: type: Content of: <refentry><refsect1><note><para>
en: On Windows you should probably use the <link linkend="mkvextract.description.common.redirect_output"><option>--redirect-output</option></link> option because <command>cmd.exe</command> sometimes interpretes special characters before they're written into the output file resulting in broken output.
de: Windowsでは、<link linkend="mkvextract.description.common.redirect_output"><option>--redirect-output</option></link>オプションを使用するべきでしょう。<command>cmd.exe</command>は、特殊文字を出力ファイルに書き出す前に処理してしまい、出力が壊れる虞があります。

note: type: Content of: <refentry><refsect1><title>
en: Output file formats
de: 出力ファイルフォーマット

note: type: Content of: <refentry><refsect1><para>
en: The decision about the output format is based on the track type, not on the extension used for the output file name. The following track types are supported at the moment:
de: 出力ファイルのフォーマットの決定は、トラックの種類によって決まり、出力ファイル名の拡張子は使用されません。現在、以下の種類のトラックがサポートされています。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: <abbrev>H.264</abbrev> / <abbrev>AVC</abbrev> video tracks are written to <abbrev>H.264</abbrev> elementary streams which can be processed further with e.g. <productname>MP4Box</productname> from the <productname>GPAC</productname> package.
de: <abbrev>H.264</abbrev>/<abbrev>AVC</abbrev>ビデオトラックは、<abbrev>H.264</abbrev>エレメンタリ・ストリームに書き出されます。これは例えば<productname>GPAC</productname>パッケージに含まれる、<productname>MP4Box</productname>などにより処理できます。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Fixed <abbrev>FPS</abbrev> video tracks with this <classname>CodecID</classname> are written to <abbrev>AVI</abbrev> files.
de: この<classname>CodecID</classname>をもつ、固定<abbrev>FPS</abbrev>ビデオトラックは<abbrev>AVI</abbrev>ファイルに書き出されます。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: <productname>RealVideo</productname> tracks are written to <productname>RealMedia</productname> files.
de: <productname>RealVideo</productname>トラックは、<productname>RealMedia</productname>ファイルに書き出されます。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: These will be extracted to raw <abbrev>MP3</abbrev> and <abbrev>AC3</abbrev> files.
de: これらは、生の<abbrev>MP3</abbrev>ファイル及び<abbrev>AC3</abbrev>ファイルに抽出されます。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Raw <abbrev>PCM</abbrev> data will be written to a <abbrev>WAV</abbrev> file.
de: <abbrev>PCM</abbrev>Rawデータは、<abbrev>WAV</abbrev>ファイルに書き出されます。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: All <abbrev>AAC</abbrev> files will be written into an <abbrev>AAC</abbrev> file with <abbrev>ADTS</abbrev> headers before each packet. The <abbrev>ADTS</abbrev> headers will not contain the deprecated emphasis field.
de: 全ての<abbrev>AAC</abbrev>ファイルは、<abbrev>ADTS</abbrev>ヘッダを各パケットの前に追加されたうえで<abbrev>AAC</abbrev>ファイルに書き出されます。<abbrev>ADTS</abbrev>ヘッダは、廃止予定であるエンファシスフィールドを含みません。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Vorbis audio will be written into an &oggvorbis; file.
de: Vorbis audioは&oggvorbis;ファイルに書き出されます。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: <productname>RealAudio</productname> tracks are written to <productname>RealMedia</productname> files.
de: <productname>RealAudio</productname>トラックは<productname>RealMedia</productname>ファイルに書き出されます。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: <productname>TrueAudio</productname> tracks are written to <abbrev>TTA</abbrev> files. Please note that due to &matroska;'s limited timecode precision the extracted file's header will be different regarding two fields: <varname>data_length</varname> (the total number of samples in the file) and the <abbrev>CRC</abbrev>.
de: <productname>TrueAudio</productname>トラックは<abbrev>TTA</abbrev>ファイルに書き出されます。&matroska;のタイムコード精度の上限のため、抽出されたファイルのヘッダは、<varname>data_length</varname>フィールド(ファイルに含まれる総サンプル数)と<abbrev>CRC</abbrev>については不正確になります。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Simple text subtitles will be written as <abbrev>SRT</abbrev> files.
de: シンプル・テキスト字幕は<abbrev>SRT</abbrev>ファイルに書き出されます。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: <abbrev>SSA</abbrev> and <abbrev>ASS</abbrev> text subtitles will be written as <abbrev>SSA</abbrev>/<abbrev>ASS</abbrev> files respectively.
de: <abbrev>SSA</abbrev>及び<abbrev>ASS</abbrev>テキスト字幕は、それぞれ<abbrev>SSA</abbrev>、<abbrev>ASS</abbrev>ファイルに書き出されます。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: <productname>Kate</productname> streams will be written within an <productname>Ogg</productname> container.
de: <productname>Kate</productname>ストリームは<productname>Ogg</productname>コンテナに格納されます。

note: type: Content of: <refentry><refsect1><title>
en: Tags
de: タグ

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Tags are converted to a &xml; format. This format is the same that &mkvmerge; supports for reading tags.
de: タグは、&xml;フォーマットに変換されます。このフォーマットは&mkvmerge;でタグを読み込む際のフォーマットと同じです。

note: type: Content of: <refentry><refsect1><title>
en: Attachments
de: 添付ファイル

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Attachments are written to they output file as they are. No conversion whatsoever is done.
de: 添付ファイルはそのままの形式で出力ファイルに書き出されます。変換等の処理は全く行われません。

note: type: Content of: <refentry><refsect1><title>
en: Chapters
de: チャプタ

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Chapters are converted to a &xml; format. This format is the same that &mkvmerge; supports for reading chapters. Alternatively a stripped-down version can be output in the simple <abbrev>OGM</abbrev> style format.
de: チャプタは&xml;フォーマットに変換されます。このフォーマットは&mkvmerge;がチャプタを読み込む際のフォーマットと同じです。他にも、簡略化された<abbrev>OGM</abbrev>スタイルのフォーマットで出力することもできます。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
en: Timecodes
de: タイムコード

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Timecodes are first sorted and then output as a timecode v2 format compliant file ready to be fed to &mkvmerge;.  The extraction to other formats (v1, v3 and v4) is not supported.
de: タイムコードはまず整列された後に、&mkvmerge;で読み込むことのできる timecode v2 形式に準拠するファイルに書き出されます。他の形式(v1, v3, v4)への抽出はサポートされていません。

note: type: Content of: <refentry><refsect1><title>
en: Exit codes
de: 返り値

note: type: Content of: <refentry><refsect1><para>
en: &mkvextract; exits with one of three exit codes:
de: &mkvextract;は下の3つの返り値を返します。

note: type: Content of: <refentry><refsect1><itemizedlist><listitem><para>
en: <constant>0</constant> -- This exit codes means that extraction has completed successfully.
de: <constant>0</constant> -- この返り値は抽出が成功したことを意味します。

note: type: Content of: <refentry><refsect1><itemizedlist><listitem><para>
en: <constant>1</constant> -- In this case &mkvextract; has output at least one warning, but extraction did continue.  A warning is prefixed with the text '<literal>Warning:</literal>'.  Depending on the issues involved the resulting files might be ok or not.  The user is urged to check both the warning and the resulting files.
de: <constant>1</constant> -- この返り値は、一つ以上の警告が出力されましたが、抽出が続行されたことを意味します。警告は '<literal>警告:</literal>' という文字列を先頭につけて出力されます。出力ファイルが無事であるかどうかは、場合によります。出力ファイルを確認することを強く推奨します。

note: type: Content of: <refentry><refsect1><itemizedlist><listitem><para>
en: <constant>2</constant> -- This exit code is used after an error occurred.  &mkvextract; aborts right after outputting the error message.  Error messages range from wrong command line arguments over read/write errors to broken files.
de: <constant>2</constant> -- この返り値は、エラーが発生し、エラーメッセージを出力した後に&mkvextract;が処理を中断したことを示します。エラーメッセージは不正なコマンドラインやファイルI/Oエラー、壊れたファイルなど様々です。

note: type: Content of: <refentry><refsect1><title>
en: Escaping special chars in text
de: テキスト中の特殊文字をエスケープする

note: type: Content of: <refentry><refsect1><para>
en: There are a few places in which special characters in text must or should be escaped. The rules for escaping are simple: each character that needs escaping is replaced with a backslash followed by another character.
de: 特殊文字をエスケープしなければならない、あるいはすべき場所が少しだけあります。エスケープのルールは単純です：エスケープする必要のある各文字を、バックスラッシュ（Windows上の日本語フォントでは\記号）の後ろに違う文字が1つついたものと入れ替えます。

note: type: Content of: <refentry><refsect1><para>
en: The rules are: ' ' (a space) becomes '\s', '&quot;' (double quotes) becomes '\2', ':' becomes '\c', '#' becomes '\h' and '\' (a single backslash) itself becomes '\\'.
de: ルール：' '（半角スペース）は'\s'に、'&quot;'（ダブルクォーテーション）は'\2'に、':'は'\c'に、'#'は'\h'に、そして'\'それ自体は'\\'になります。

note: type: Content of: <refentry><refsect1><title>
en: Environment variables
de: 環境変数

note: type: Content of: <refentry><refsect1><para>
en: &mkvextract; uses the default variables that determine the system's locale (e.g. <varname>LANG</varname> and the <varname>LC_*</varname> family). Additional variables:
de: &mkvextract;はシステムのロケールを決めるデフォルトの変数（例：<varname>LANG</varname>や<varname>LC_*</varname>系）を使用します。追加の変数は以下の通りです：

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
en: <varname>MKVTOOLNIX_DEBUG</varname> and its short form <varname>MTX_DEBUG</varname>
de: <varname>MKVTOOLNIX_DEBUG</varname>とその短縮形<varname>MTX_DEBUG</varname>

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: The content is treated as if it had been passed via the <link linkend="mkvextract.description.debug"><option>--debug</option></link> option.
de: その内容は、あたかも<link linkend="mkvextract.description.debug"><option>--debug</option></link>オプション経由で渡されたかのように扱われます。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
en: <varname>MKVTOOLNIX_ENGAGE</varname> and its short form <varname>MTX_ENGAGE</varname>
de: <varname>MKVTOOLNIX_ENGAGE</varname>とその短縮形<varname>MTX_ENGAGE</varname>

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: The content is treated as if it had been passed via the <link linkend="mkvextract.description.engage"><option>--engage</option></link> option.
de: その内容は、あたかも<link linkend="mkvextract.description.engage"><option>--engage</option></link>オプション経由で渡されたかのように扱われます。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
en: <varname>MKVTOOLNIX_OPTIONS</varname> and its short form <varname>MTX_OPTIONS</varname>
de: <varname>MKVTOOLNIX_OPTIONS</varname>とその短縮形<varname>MTX_OPTIONS</varname>

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: The content is split on white space. The resulting partial strings are treated as if it had been passed as command line options. If you need to pass special characters (e.g. spaces) then you have to escape them (see <link linkend="mkvextract.escaping">the section about escaping special characters in text</link>).
de: 内容は空白で分割されます。得られた一部の文字列は、あたかもそれがコマンドラインオプションとして渡されたかのように扱われます。もし特殊な文字（例：空白）を渡す必要があるなら、それらをエスケープする必要があります（<link linkend="mkvextract.escaping">テキスト中の特殊文字のエスケープについてのセクション</link>をご覧ください）。

note: type: Content of: <refentry><refsect1><title>
en: See also
de: 関連項目

note: type: Content of: <refentry><refsect1><title>
en: WWW
de: ウェブ

note: type: Content of: <refentry><refsect1><para>
en: The latest version can always be found at <ulink url="http://www.bunkus.org/videotools/mkvtoolnix/">the MKVToolNix homepage</ulink>.
de: 最新のバージョンは、常時<ulink url="http://www.bunkus.org/videotools/mkvtoolnix/">MKVToolNixのホームページ</ulink>から取得できます。

note: type: Content of: <refentry><refnamediv><refpurpose>
en: Print information about elements in &matroska; files
de: &matroska;ファイルの要素についての情報を表示します。

note: type: Content of: <refentry><refsect1><para>
en: This program lists all elements contained in a &matroska;. The output can be limited to a list of tracks in the file including information about the codecs used.
de: このプログラムは、&matroska; ファイルに格納されている全ての要素の一覧を表示します。出力は、使用されているコーデックを含む、トラックのリストのみに制限することもできます。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Start the <abbrev>GUI</abbrev>. This option is only available if mkvinfo was compiled with <abbrev>GUI</abbrev> support.
de: <abbrev>GUI</abbrev>を起動します。このオプションは、mkvinfoが<abbrev>GUI</abbrev>をサポートするようにコンパイルされていなければ無効です。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Calculates and display the <function>Adler32</function> checksum for each frame. Useful for debugging only.
de: フレームごとに<function>Adler32</function>チェックサムを計算し、表示します。デバッグのためにのみ有用です。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Only show a terse summary of what &mkvinfo; finds and not each element.
de: 全てのエレメントについて表示するのではなく、&mkvinfo;の見つけたものの簡潔なサマリを表示します。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Show statistics for each track in verbose mode. Also sets verbosity to 1 if it was at level 0 before.
de: 各トラックの統計情報を冗長モードで表示します。また、冗長レベルが0だった場合は1に設定します。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Show the first 16 bytes of each frame as a hex dump.
de: 各フレームの最初の16バイトを16進数のダンプとして表示します。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Show all bytes of each frame as a hex dump.
de: 各フレームの全てのバイトを16進数のダンプとして表示します。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Show the size of each element including its header.
de: ヘッダも含めた各要素のサイズを表示します。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Writes all messages to the file <parameter>file-name</parameter> instead of to the console.  While this can be done easily with output redirection there are cases in which this option is needed: when the terminal reinterprets the output before writing it to a file.  The character set set with <link linkend="mkvinfo.description.output_charset"><option>--output-charset</option></link> is honored.
de: 全てのメッセージをコンソールではなく<parameter>file-name</parameter>で指定したファイルに書き出します。出力リダイレクトによっても同じことが簡単にできますが、このオプションが必要な場合もあります。ターミナルがファイルに書き込む前に出力を処理してしまう場合などです。<link linkend="mkvinfo.description.output_charset"><option>--output-charset</option></link>によって指定された文字コードは尊重されます。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Forces the translations for the language <parameter>code</parameter> to be used (e.g.  '<literal>de_DE</literal>' for the German translations). It is preferable to use the environment variables <varname>LANG</varname>, <varname>LC_MESSAGES</varname> and <varname>LC_ALL</varname> though. Entering '<literal>list</literal>' as the <parameter>code</parameter> will cause &mkvinfo; to output a list of available translations.
de: 指定した<parameter>code</parameter>を強制的に言語コード(例: 日本語ならば'<literal>ja_JP</literal>')として使用します。しかし、環境変数<varname>LANG</varname>や<varname>LC_MESSAGES</varname>、<varname>LC_ALL</varname>を使用したほうが好ましいでしょう。<parameter>code</parameter>に<literal>list</literal>と指定すると、指定できる言語コードの一覧を出力します。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Turn on experimental features. A list of available features can be requested with <command>mkvinfo --engage list</command>. These features are not meant to be used in normal situations.
de: 実験的機能をオンにします。利用可能な機能のリストは<command>mkvinfo --engage list</command>で得られます。これらの機能は通常の状況で使用されることを意図されていません。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Be more verbose. See the section about <link linkend="mkvinfo.verbosity_levels">verbosity levels</link> for a description which information will be output at which level.
de: 冗長モードになります。<link linkend="mkvinfo.verbosity_levels">冗長レベル</link>セクションに、どの冗長レベルでどの情報が出力されるかの説明があります。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Several chars can be escaped, e.g. if you need to start a non-comment line with '#'. The rules are described in <link linkend="mkvinfo.escaping">the section about escaping text</link>.
de: エスケープすることのできる文字もあります。例えば、コメントではない行を'#'で始める必要のある場合です。そのルールは、<link linkend="mkvinfo.escaping">エスケープ文字についてのセクション</link>で説明されています。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: The command line '<command>mkvinfo -v -v input.mkv --redirect-output info.txt</command>' could be converted into the following option file:
de: '<command>mkvinfo -v -v input.mkv --redirect-output info.txt</command>というコマンドラインと同じことは、次のようなオプションファイルで指定できます。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><programlisting>
en: # Be more verbose
    -v
    -v
    # Parse input.mkv
    input.mkv
    # and write the output to info.txt
    --redirect-output
    info.txt
de: # 冗長モード
    -v
    -v
    # input.mkvを解析する
    input.mkv
    # info.txtに出力を書き込む
    --redirect-output
    info.txt

note: type: Content of: <refentry><refsect1><title>
en: Verbosity levels
de: 冗長レベル

note: type: Content of: <refentry><refsect1><para>
en: The <link linkend="mkvinfo.description.verbose"><option>-v</option></link> option can be used to increase &mkvinfo;'s verbosity level and print more information about the current file.
de: <link linkend="mkvinfo.description.verbose"><option>-v</option></link>オプションにより、&mkvinfo;の冗長レベルを上げ、入力ファイルについてのより詳しい情報を出力させることができます。

note: type: Content of: <refentry><refsect1><para>
en: At level 0 &mkvinfo; will print only the track headers it finds and their types. &mkvinfo; will exit as soon as the headers are parsed completely (more technical: as soon as the first cluster is encountered). In this level the seek head entries and the cues will not be displayed -- even if they're located in front of the track information.
de: レベル0では、トラックヘッダとトラックの種類のみを出力します。&mkvinfo;は、ヘッダを完全に解析し終るとすぐに(より技術的には、最初のクラスタを検出した直後に)終了します。このレベルでは、シークヘッドエントリ及びCUEがトラック情報の前に格納されていたとしても表示されません。

note: type: Content of: <refentry><refsect1><para>
en: At level 1 &mkvinfo; will also print all &matroska; elements encountered for the complete file but the seek head entries and the cue entries. If the summary mode is enabled then &mkvinfo; will output the frame position as well.
de: レベル1では、ファイル全体にあるシークヘッドエントリとCUE以外の&matroska;エレメントを表示します。もし、サマリモードが有効の場合、フレーム位置も出力します。

note: type: Content of: <refentry><refsect1><para>
en: At level 2 &mkvinfo; will also print the seek head entries, the cue entries and the file position at which each &matroska; element can be found at.
de: レベル2では、シークヘッドエントリ、CUE、及び各&matroska;エレメントのファイル内位置も表示します。

note: type: Content of: <refentry><refsect1><para>
en: At level 3 and above &mkvinfo; will print some information that is not directly connected to a &matroska; element. All other elements only print stuff about the elements that were just found. Level 3 adds meta information to ease debugging (read: it's intended for developers only). All lines written by level 3 are enclosed in square brackets to make filtering them out easy.
de: レベル3以上では、&matroska;エレメントに直接関係ない情報も表示します。他のエレメントについては、見付かったものだけを表示します。レベル3はデバッグ用にメタ情報を追加します(開発者向け)。レベル3で追加された行は、全て角括弧で囲われています。

note: type: Content of: <refentry><refsect1><para>
en: &mkvinfo; exits with one of three exit codes:
de: &mkvinfo;は下の3つの返り値を返します。

note: type: Content of: <refentry><refsect1><itemizedlist><listitem><para>
en: <constant>0</constant> -- This exit codes means that the run has completed successfully.
de: <constant>0</constant> -- この返り値は正常に終了したことを示します。

note: type: Content of: <refentry><refsect1><itemizedlist><listitem><para>
en: <constant>1</constant> -- In this case &mkvinfo; has output at least one warning, but the run did continue.  A warning is prefixed with the text '<literal>Warning:</literal>'.
de: <constant>1</constant> -- この返り値は、少なくとも一つの警告が表示されましたが、処理が続行されたことを意味します。警告は '<literal>警告:</literal>' という文字列を先頭につけて出力されます。

note: type: Content of: <refentry><refsect1><itemizedlist><listitem><para>
en: <constant>2</constant> -- This exit code is used after an error occurred.  &mkvinfo; aborts right after outputting the error message.  Error messages range from wrong command line arguments over read/write errors to broken files.
de: <constant>2</constant> -- この返り値は、エラーが発生し、エラーメッセージを表示した直後に&mkvinfo;が終了したことを示します。エラーメッセージは不正なコマンドラインやファイルI/Oエラー、壊れたファイルなど様々です。

note: type: Content of: <refentry><refsect1><para>
en: &mkvinfo; uses the default variables that determine the system's locale (e.g. <varname>LANG</varname> and the <varname>LC_*</varname> family). Additional variables:
de: &mkvinfo;はシステムのロケールを決めるデフォルトの変数（例：<varname>LANG</varname>や<varname>LC_*</varname>系）を使用します。追加の変数は以下の通りです：

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: The content is treated as if it had been passed via the <link linkend="mkvinfo.description.debug"><option>--debug</option></link> option.
de: その内容は、あたかも<link linkend="mkvinfo.description.debug"><option>--debug</option></link>オプション経由で渡されたかのように扱われます。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: The content is treated as if it had been passed via the <link linkend="mkvinfo.description.engage"><option>--engage</option></link> option.
de: その内容は、あたかも<link linkend="mkvinfo.description.engage"><option>--engage</option></link>オプション経由で渡されたかのように扱われます。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: The content is split on white space. The resulting partial strings are treated as if it had been passed as command line options. If you need to pass special characters (e.g. spaces) then you have to escape them (see <link linkend="mkvinfo.escaping">the section about escaping special characters in text</link>).
de: その内容は空白で分割されます。得られた一部の文字列は、あたかもそれがコマンドラインオプションとして渡されたかのように扱われます。もし特殊な文字（例：空白）を渡す必要があるなら、それらをエスケープする必要があります（<link linkend="mkvinfo.escaping">テキスト中の特殊文字のエスケープについてのセクション</link>をご覧ください）。

note: type: Content of: <refentry><refnamediv><refpurpose>
en: Merge multimedia streams into a &matroska; file
de: マルチメディアストリームを&matroska;ファイルに格納します。

note: type: Content of: <refentry><refsect1><para>
en: This program takes the input from several media files and joins their streams (all of them or just a selection) into a &matroska; file; see <ulink url="http://www.matroska.org/">the &matroska; website</ulink>.
de: このプログラムはいくつかのメディアファイルを入力とし、それらに格納されたストリームのうち全て、もしくは選択されたものを&matroska;ファイルに書き込みます。<ulink url="http://www.matroska.org/">&matroska;</ulink>のウェブサイトも参照してください。

note: type: Content of: <refentry><refsect1><important><para>
en: The order of command line options is important. Please read the section <link linkend="mkvmerge.option_order">&quot;Option order&quot;</link> if you're new to the program.
de: コマンドラインオプションの順番は重要です。もしあなたが初心者なら、<link linkend="mkvmerge.option_order">&quot;オプションの順番&quot;</link>セクションを読んで下さい。

note: type: Content of: <refentry><refsect1><refsect2><title>
en: Global options
de: グローバルオプション

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Increase verbosity.
de: より詳細な情報を表示します

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Suppress status output.
de: ステータス情報の出力を抑制します。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Write to the file <parameter>file-name</parameter>.  If splitting is used then this parameter is treated a bit differently.  See the explanation for the <link linkend="mkvmerge.description.split"><option>--split</option></link> option for details.
de: <parameter>file-name</parameter>で指定したファイルに書き込みます。もし、ファイル分割が有効な場合このオプションは若干解釈が違います。詳細は<link linkend="mkvmerge.description.split"><option>--split</option></link>オプションの説明を参照してください。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Create a WebM compliant file. This is also turned on if the output file name's extension is &quot;webm&quot;. This mode enforces several restrictions. The only allowed codecs are VP8 video and Vorbis audio tracks. Neither chapters nor tags are allowed. The DocType header item is changed to &quot;webm&quot;.
de: WebMの規格に準拠したファイルを作成します。mkvmergeは出力ファイル名の拡張子が&quot;webm&quot;であった場合にもこれをオンにします。このモードではいくつかの制限が実施されます。使用できるコーデックはVP8ビデオとVorbisオーディオのトラックのみです。チャプタとタグは使用することができません。DocTypeヘッダアイテムは&quot;webm&quot;へと変更されます。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Sets the general title for the output file, e.g. the movie name.
de: 出力ファイル全体のタイトルを指定します(例:映画のタイトルなど)。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Sets the default language code that will be used for all tracks unless overwritten with the <link linkend="mkvmerge.description.language"><option>--language</option></link> option. The default language code is '<literal>und</literal>' for 'undefined'.
de: デフォルトの言語コードを指定します。<link linkend="mkvmerge.description.language"><option>--language</option></link>オプションで指定しなかったトラックはすべてここで指定した言語コードになります。デフォルトは'<literal>und</literal>'、つまり'未定義'です。

note: type: Content of: <refentry><refsect1><refsect2><title>
en: Segment info handling (global options)
de: セグメント情報の扱い (グローバルオプション)

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Read segment information from a <abbrev>XML</abbrev> file. This file can contain the segment family <abbrev>UID</abbrev>, segment <abbrev>UID</abbrev>, previous and next segment <abbrev>UID</abbrev> elements. An example file and a <abbrev>DTD</abbrev> are included in the MKVToolNix distribution.
de: <abbrev>XML</abbrev>ファイルからセグメント情報を読み取ります。このファイルは、セグメントファミリ<abbrev>UID</abbrev>、セグメント<abbrev>UID</abbrev>、前、及び、後セグメント<abbrev>UID</abbrev>エレメントを含むことができます。MKVToolNixは、サンプルファイルと<abbrev>DTD</abbrev>を含んで配布されています。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: See the section about <link linkend="mkvmerge.segmentinfo">segment info XML files</link> below for details.
de: 詳細は、下にある<link linkend="mkvmerge.segmentinfo">セグメント情報XMLファイル</link>のセクションを参照してください。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Sets the segment UIDs to use. This is a comma-separated list of 128bit segment UIDs in the usual UID form: hex numbers with or without the &quot;0x&quot; prefix, with or without spaces, exactly 32 digits.
de: 使用するセグメントUIDを設定します。これはコンマで区切られた、通常のUID形式(&quot;0x&quot;を前置する、またはしない、空白を含む、または含まない、ちょうど32桁の16進数)128ビットセグメントUIDのリストです。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Each file created contains one segment, and each segment has one segment UID. If more segment UIDs are specified than segments are created then the surplus UIDs are ignored. If fewer UIDs are specified than segments are created then random UIDs will be created for them.
de: 作成される各ファイルは一つのセグメントを含み、そして各セグメントは一つのセグメントUIDを持ちます。もし、作成されたセグメントよりも多数のセグメントUIDが指定された場合、余ったセグメントUIDは無視されます。また、もし指定されたセグメントUIDよりも多数のセグメントが作成された場合は、ランダムなUIDが作成されて使用されます。

note: type: Content of: <refentry><refsect1><refsect2><title>
en: Chapter and tag handling (global options)
de: チャプタ及びタグの扱い (グローバルオプション)

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Sets the ISO639-2 language code that is written for each chapter entry.  Defaults to '<literal>eng</literal>'.  See the section about <link linkend="mkvmerge.chapters">chapters</link> below for details.
de: 各チャプタのエントリに書き込むISO639-2言語コードを指定します。デフォルトは'<literal>eng</literal>'です。詳細は<link linkend="mkvmerge.chapters">チャプタ</link>のセクションを参照してください。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: This option can be used both for simple chapter files and for source files that contain chapters but no information about the chapters' language, e.g. MP4 and OGM files.
de: このオプションはシンプルチャプタファイルを読み込んだ場合、そしてソースファイルがチャプタを含むがチャプタの言語情報を含まなかった場合(例:MP4,OGMファイル)に適用されます。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Sets the character set that is used for the conversion to UTF-8 for simple chapter files. See the section about <link linkend="mkvmerge.text_files_and_charsets"> text files and character sets</link> for an explanation how &mkvmerge; converts between character sets.
de: シンプルチャプタファイルをUTF-8に変換する際の文字コードを指定します。&mkvmerge;の文字コード変換については、<link linkend="mkvmerge.text_files_and_charsets">テキストファイルと文字コード</link>のセクションを参照してください。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: This switch does also apply to chapters that are copied from certain container types, e.g. Ogg/OGM and MP4 files.  See the section about chapters below for details.
de: このスイッチはチャプタがOgg,OGMファイルなどのコンテナからコピーされる際にも適用されます。詳細については後述のチャプタについてのセクションを参照してください。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: &mkvmerge; supports reading <abbrev>CUE</abbrev> sheets for audio files as the input for chapters. <abbrev>CUE</abbrev> sheets usually contain the entries <varname>PERFORMER</varname> and <varname>TITLE</varname> for each index entry. &mkvmerge; uses these two strings in order to construct the chapter name. With this option the format used for this name can be set.
de: &mkvmerge;は音声ファイル向けの<abbrev>CUE</abbrev>シートからチャプタ情報を読み込むことができます。<abbrev>CUE</abbrev>シートには通常<varname>PERFORMER</varname>エントリ及び<varname>TITLE</varname>エントリが各インデックスエントリに存在します。&mkvmerge;はこれら二つの文字列をチャプタの名前を生成するのに使用します。このフォーマットをこのオプションで指定することができます。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: If this option is not given then &mkvmerge; defaults to the format '<code>%p - %t</code>' (the performer, followed by a space, a dash, another space and the title).
de: このオプションが指定されていない場合、デフォルトで'<code>%p - %t</code>'というフォーマットが使用されます。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: If the format is given then everything except the following meta characters is copied as-is, and the meta characters are replaced like this:
de: フォーマットが指定された場合、下のメタ文字以外はそのままコピーされ、メタ文字は以下のように置換されます。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><itemizedlist><listitem><para>
en: <parameter>%p</parameter> is replaced by the current entry's <varname>PERFORMER</varname> string,
de: <parameter>%p</parameter>はそのエントリの<varname>PERFORMER</varname>文字列で置換されます。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><itemizedlist><listitem><para>
en: <parameter>%t</parameter> is replaced by the current entry's <varname>TITLE</varname> string,
de: <parameter>%t</parameter>はそのエントリの<varname>TITLE</varname>文字列で置換されます。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><itemizedlist><listitem><para>
en: <parameter>%n</parameter> is replaced by the current track number and
de: <parameter>%n</parameter>はそのエントリのトラック番号で置換されます。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><itemizedlist><listitem><para>
en: <parameter>%N</parameter> is replaced by the current track number padded with a leading zero if it is &lt; 10.
de: <parameter>%N</parameter>は、そのエントリのトラック番号が10未満の場合0を前置して二桁にした数字で置換されます。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Read chapter information from the file <parameter>file-name</parameter>. See the section about <link linkend="mkvmerge.chapters">chapters</link> below for details.
de: チャプタ情報を<parameter>file-name</parameter>で指定したファイルから読み込みます。詳細は<link linkend="mkvmerge.chapters">チャプタ</link>のセクションを参照してください。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Read global tags from the file <parameter>file-name</parameter>. See the section about <link linkend="mkvmerge.tags">tags</link> below for details.
de: <parameter>file-name</parameter>で指定したファイルからグローバルタグを読み込みます。詳細は<link linkend="mkvmerge.tags">タグ</link>のセクションを参照してください。

note: type: Content of: <refentry><refsect1><refsect2><title>
en: General output control (advanced global options)
de: 出力一般のコントロール（高度なグローバルオプション）

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: This option changes the order in which the tracks for an input file are created. The argument is a comma separated list of pairs IDs. Each pair contains first the file ID (<parameter>FID1</parameter>) which is simply the number of the file on the command line starting at 0. The second is a track ID (<parameter>TID1</parameter>) from that file.  If some track IDs are omitted then those tracks are created after the ones given with this option have been created.
de: このオプションは入力されたトラックが配置される順序を変更します。オプション引数はコンマで区切られるIDペアのリストです。各ペアは最初を0としてコマンドラインの何番目に指定したファイルであるかを示すファイルID(<parameter>FID1</parameter>)と、そのファイルの中の何番目のトラックかを示すトラックID(<parameter>TID1</parameter>)からなります。ここで指定されなかったトラックは、指定されたトラックの後に配置されます。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Limit the number of data blocks or the duration of data in each cluster. The <parameter>spec</parameter> parameter can either be a number <parameter>n</parameter> without a unit or a number <parameter>d</parameter> postfixed with '<literal>ms</literal>'.
de: クラスタごとの、データブロック個数の上限または持続時間を指定します。<parameter>spec</parameter>パラメータには単位なしの数字<parameter>n</parameter>もしくは、'<literal>ms</literal>'を後ろに付けた数字<parameter>d</parameter>を指定することができます。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: If no unit is used then &mkvmerge; will put at most <parameter>n</parameter> data blocks into each cluster. The maximum number of blocks is 65535.
de: 単位が指定されなかった場合、クラスタごとのデータブロックの最大個数は<parameter>n</parameter>に設定されます。上限は65535です。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: If the number <parameter>d</parameter> is postfixed with '<literal>ms</literal>' then &mkvmerge; puts at most <parameter>d</parameter> milliseconds of data into each cluster. The minimum for <parameter>d</parameter> is '<literal>100ms</literal>', and the maximum is '<literal>32000ms</literal>'.
de: 数字<parameter>d</parameter>に'<literal>ms</literal>'が後置されていた場合、&mkvmerge;は各データクラスタ毎に最大でも<parameter>d</parameter>ミリ秒分のデータしか格納しません。<parameter>d</parameter>の最小値は'<literal>100ms</literal>'、最大値は'<literal>32000ms</literal>'です。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: &mkvmerge; defaults to putting at most 65535 data blocks and 5000ms of data into a cluster.
de: デフォルトは、データクラスタ毎に65535データブロック以下、5000ms以下のデータを書き込みます。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Programs trying to find a certain frame can only seek directly to a cluster and have to read the whole cluster afterwards. Therefore creating larger clusters may lead to imprecise or slow seeking.
de: プログラムがあるフレームを見つけようとするときは、クラスタに直接シークして、その後クラスタ全体を読み込みます。よって、より大きなクラスタを作ると、シークが不正確かつ遅くなるかもしれません。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Tells &mkvmerge; not to create and write the cue data which can be compared to an index in an AVI. &matroska; files can be played back without the cue data, but seeking will probably be imprecise and slower. Use this only if you're really desperate for space or for testing purposes. See also option <link linkend="mkvmerge.description.cues"><option>--cues</option></link> which can be specified for each input file.
de: キューデータ(AVIファイルにおけるインデックスのようなもの)を作成しません。キューデータなしでもファイルは再生できますが、シークは不正確かつ遅くなるでしょう。このオプションは、少しでもファイルサイズを小さくしようと必死なとき、またはテスト目的以外には使用しないでください。<link linkend="mkvmerge.description.cues"><option>--cues</option></link>オプションは各入力ファイルごとに指定できます。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Tells &mkvmerge; to create a meta seek element at the end of the file containing all clusters. See also the section about the <link linkend="mkvmerge.file_layout">&matroska; file layout</link>.
de: ファイルの終端に全てのクラスタを含むメタシーク要素を作成します。<link linkend="mkvmerge.file_layout">&matroska;ファイルレイアウト</link>のセクションも参照してください。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Disables lacing for all tracks. This will increase the file's size, especially if there are many audio tracks. This option is not intended for everyday use.
de: 全てのトラックで複数のフレームを1つのブロックにまとめません。これは特に多数のオーディオトラックがある場合に、ファイルサイズを増大させます。テスト目的でのみ使用してください。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Write durations for all blocks. This will increase file size and does not offer any additional value for players at the moment.
de: 全てのブロックの長さを記録します。これはファイルサイズを増大させますが、現在のところプレーヤには何のメリットももたらしません。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Forces the timecode scale factor to <parameter>factor</parameter>. Valid values are in the range <constant>1000</constant>..<constant>10000000</constant> or the special value <constant>-1</constant>.
de: タイムコードスケールの係数を<parameter>factor</parameter>に強制設定します。この値は1000～10000000、もしくは-1に設定しなければなりません。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Normally &mkvmerge; will use a value of <constant>1000000</constant> which means that timecodes and durations will have a precision of 1ms. For files that will not contain a video track but at least one audio track &mkvmerge; will automatically chose a timecode scale factor so that all timecodes and durations have a precision of one audio sample. This causes bigger overhead but allows precise seeking and extraction.
de: 通常&mkvmerge;は<constant>1000000</constant>を使用します。これはタイムコードとフレーム持続期間が1ミリ秒単位の精度を持つことを意味します。ビデオトラックを含まず、1つ以上のオーディオトラックを含むファイルでは、&mkvmerge;は全てのタイムコードとフレーム持続時間がサンプリング音1つ分の精度を持つようタイムコードスケールの係数を自動的に選択します。これによってオーバーヘッドは大きくなりますが、正確なシークと展開が可能になります。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: If the special value <constant>-1</constant> is used then &mkvmerge; will use sample precision even if a video track is present.
de: 特殊な値<constant>-1</constant>が指定された場合、たとえビデオトラックが存在していてもサンプリング音の精度を使用します。

note: type: Content of: <refentry><refsect1><refsect2><title>
en: File splitting, linking, appending and concatenation (more global options)
de: ファイルの分割と紐付け、追加結合、連結(グローバルオプションの続き):

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Splits the output file after a given size or a given time.  Please note that tracks can only be split right before a key frame.  Due to buffering &mkvmerge; will split right before the next key frame after the split point has been reached.  Therefore the split point may be a bit off from what the user has specified.
de: 出力ファイルを指定したサイズ、又は時間で分割します。トラックはキーフレームの直後でしか分割できないことに注意してください。&mkvmerge;はバッファリングを行うため、ファイルは分割すべき点の次にくるキーフレームの直前で分割されます。よって、分割点はユーザが指定した点よりも若干後ろになります。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><orderedlist><listitem><para>
en: Splitting by size.
de: 指定サイズで分割します。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><orderedlist><listitem><para>
en: Syntax: <option>--split</option> <optional><literal>size:</literal></optional><parameter>d</parameter><optional>k|m|g</optional>
de: 書式: <option>--split</option> <optional><literal>size:</literal></optional><parameter>d</parameter><optional>k|m|g</optional>

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><orderedlist><listitem><para>
en: Examples: <code>--split size:700m</code> or <code>--split 150000000</code>
de: 例: <code>--split size:700m</code> or <code>--split 150000000</code>

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><orderedlist><listitem><para>
en: The parameter <parameter>d</parameter> may end with '<literal>k</literal>', '<literal>m</literal>' or '<literal>g</literal>' to indicate that the size is in KB, MB or GB respectively.  Otherwise a size in bytes is assumed.  After the current output file has reached this size limit a new one will be started.
de: パラメータ<parameter>d</parameter>の後ろには'<literal>k</literal>'・'<literal>m</literal>'・'<literal>g</literal>'を付けて、単位がそれぞれKB・MB・GBであることを示すことができます。付けない場合はバイト単位になります。出力中のファイルがこの上限に達したら、次の新しいファイルへの出力が開始されます。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><orderedlist><listitem><para>
en: The '<literal>size:</literal>' prefix may be omitted for compatibility reasons.
de: '<literal>size:</literal>'という接頭辞は、互換性のために省略できるようになっています。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><orderedlist><listitem><para>
en: Splitting after a duration.
de: 指定時間で分割します。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><orderedlist><listitem><para>
en: Syntax: <option>--split</option> <optional><literal>duration:</literal></optional><parameter>HH:MM:SS.nnnnnnnnn</parameter>|<parameter>d</parameter>s
de: 書式: <option>--split</option> <optional><literal>duration:</literal></optional><parameter>HH:MM:SS.nnnnnnnnn</parameter>|<parameter>d</parameter>s

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><orderedlist><listitem><para>
en: Examples: <code>--split duration:00:60:00.000</code> or <code>--split 3600s</code>
de: 例: <code>--split duration:00:60:00.000</code> or <code>--split 3600s</code>

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><orderedlist><listitem><para>
en: The parameter must either have the form <parameter>HH:MM:SS.nnnnnnnnn</parameter> for specifying the duration in up to nano-second precision or be a number <parameter>d</parameter> followed by the letter '<literal>s</literal>' for the duration in seconds. <parameter>HH</parameter> is the number of hours, <parameter>MM</parameter> the number of minutes, <parameter>SS</parameter> the number of seconds and <parameter>nnnnnnnnn</parameter> the number of nanoseconds.  Both the number of hours and the number of nanoseconds can be omitted.  There can be up to nine digits after the decimal point.  After the duration of the contents in the current output has reached this limit a new output file will be started.
de: パラメータは<parameter>HH:MM:SS.nnnnnnnnn</parameter>という形式でナノ秒精度で長さを指定するか、数字<parameter>d</parameter>のあとに'<literal>s</literal>'と書いて秒数で長さを指定しなければなりません。<parameter>HH</parameter>は時間、<parameter>MM</parameter>は分、<parameter>SS</parameter>は秒数で<parameter>nnnnnnnnn</parameter>ナノ秒を示します。時間及びナノ秒は省略できます。小数点の後ろには9桁までの数字を指定できます。指定した長さだけ出力されたら、次のファイルへの出力が開始されます。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><orderedlist><listitem><para>
en: The '<literal>duration:</literal>' prefix may be omitted for compatibility reasons.
de: '<literal>duration:</literal>'という接頭辞は、互換性のために省略できるようになっています。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><orderedlist><listitem><para>
en: Splitting after specific timecodes.
de: 指定した各タイムコードで分割します。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><orderedlist><listitem><para>
en: Syntax: <option>--split</option> <literal>timecodes:</literal><parameter>A</parameter><optional>,<parameter>B</parameter><optional>,<parameter>C</parameter>...</optional></optional>
de: 書式: <option>--split</option> <literal>timecodes:</literal><parameter>A</parameter><optional>,<parameter>B</parameter><optional>,<parameter>C</parameter>...</optional></optional>

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><orderedlist><listitem><para>
en: Example: <code>--split timecodes:00:45:00.000,01:20:00.250,6300s</code>
de: 例: <code>--split timecodes:00:45:00.000,01:20:00.250,6300s</code>

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><orderedlist><listitem><para>
en: The parameters <parameter>A</parameter>, <parameter>B</parameter>, <parameter>C</parameter> etc must all have the same format as the ones used for the duration (see above). The list of timecodes is separated by commas.  After the input stream has reached the current split point's timecode a new file is created. Then the next split point given in this list is used.
de: パラメータ<parameter>A</parameter>、<parameter>B</parameter>、<parameter>C</parameter>…は、durationで使用されるものと同じフォーマットで指定しなければなりません(上記参照)。タイムコードのリストはコンマで区切られます。入力ストリームが現在の分割点に達すると次のファイルが作成され、このリストから次の分割点が使用されます。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><orderedlist><listitem><para>
en: The '<literal>timecodes:</literal>' prefix must not be omitted.
de: '<literal>timecodes:</literal>'という接頭辞は、互換性のために省略できるようになっています。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: For this splitting mode the output filename is treated differently than for the normal operation. It may contain a <function>printf</function> like expression '<code>%d</code>' including an optional field width, e.g. '<code>%02d</code>'. If it does then the current file number will be formatted appropriately and inserted at that point in the filename.  If there is no such pattern then a pattern of '<code>-%03d</code>' is assumed right before the file's extension: '<code>-o output.mkv</code>' would result in '<code>output-001.mkv</code>' and so on. If there's no extension then '<code>-%03d</code>' will be appended to the name.
de: この分割モードでは、出力ファイル名は通常の操作とは異なる扱いを受けます。このモードでは出力ファイル名は<function>printf</function>のように'<code>%d</code>'というパターンを含むことができます。'<literal>%02d</literal>'のように幅指定を追加することもできます。出力ファイル名がこのパターンを含む場合、ファイル番号が適切なフォーマットで指定された位置に挿入されます。含まない場合、'<code>-%03d</code>'というパターンがファイルの拡張子の直前に指定されたものとみなされ、例えば'<code>-o output.mkv</code>'を指定した場合、'<code>output-001.mkv</code>'等のファイル名に出力されます。拡張子が存在しない場合、'<code>-%03d</code>'はファイル名の末尾に追加されます。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Link files to one another when splitting the output file. See the section on <link linkend="mkvmerge.file_linking">file linking</link> below for details.
de: 分割された出力ファイルを相互に紐付けします。詳細は<link linkend="mkvmerge.file_linking">ファイル紐付け</link>のセクションを参照してください。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Links the first output file to the segment with the segment UID given by the <parameter>segment-UID</parameter> parameter. See the section on <link linkend="mkvmerge.file_linking">file linking</link> below for details.
de: 最初の出力ファイルを<parameter>segment-UID</parameter>で指定したセグメントUIDに紐付けします。詳細は<link linkend="mkvmerge.file_linking">ファイル紐付け</link>のセクションを参照してください。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Links the last output file to the segment with the segment UID given by the <parameter>segment-UID</parameter> parameter. See the section on <link linkend="mkvmerge.file_linking">file linking</link> below for details.
de: 最後の出力ファイルを<parameter>segment-UID</parameter>で指定したセグメントUIDに紐付けします。詳細は<link linkend="mkvmerge.file_linking">ファイル紐付け</link>のセクションを参照してください。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Determines how timecodes are calculated when appending files.  The parameter <parameter>mode</parameter> can have two values: '<literal>file</literal>' which is also the default and '<literal>track</literal>'.
de: ファイルを結合する際に、タイムコードがどのように計算されるかを決定します。パラメータ<parameter>mode</parameter>は'<literal>file</literal>'(デフォルト)、'<literal>track</literal>の二つの値を取り得ます。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: When mkvmerge appends a track (called '<literal>track2_1</literal>' from now on) from a second file (called '<literal>file2</literal>') to a track (called '<literal>track1_1</literal>') from the first file (called '<literal>file1</literal>')  then it has to offset all timecodes for '<literal>track2_1</literal>' by an amount.  For '<literal>file</literal>' mode this amount is the highest timecode encountered in '<literal>file1</literal>' even if that timecode was from a different track than '<literal>track1_1</literal>'. In track mode the offset is the highest timecode of '<literal>track1_1</literal>'.
de: mkvmergeが二つめのファイル(以後'<literal>file2</literal>'と呼ぶ)のトラック(以後'<literal>track2_1</literal>'と呼ぶ)を、一つめのファイル(以後'<literal>file1</literal>'と呼ぶ)のトラック(以後'<literal>track1_1</literal>'と呼ぶ)と結合する際、'<literal>track2_1</literal>'のタイムコードは一定量だけずらす必要があります。'<literal>file</literal>'モードでは、ずらす量は'<literal>file1</literal>'の中の'<literal>track1_1</literal>'以外のトラックを含む全てのトラックの中で一番大きいタイムコードの値になります。'<literal>track</literal>'モードでは、'<literal>track1_1</literal>'の中で一番大きいタイムコードの値になります。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Unfortunately mkvmerge cannot detect which mode to use reliably. Therefore it defaults to '<literal>file</literal>' mode. '<literal>file</literal>' mode usually works better for files that have been created independently of each other; e.g. when appending <abbrev>AVI</abbrev> or <abbrev>MP4</abbrev> files. '<literal>track</literal>' mode may work better for sources that are essentially just parts of one big file, e.g. for <abbrev>VOB</abbrev> and <abbrev>EVO</abbrev> files.
de: 残念ながら、mkvmergeはどちらのモードが適切であるか判断はできません。デフォルトは'<literal>file</literal>'モードになっています。'<literal>file</literal>'モードは独立に作られたファイル同士を結合する際、例えば<abbrev>AVI</abbrev>又は<abbrev>MP4</abbrev>ファイルを結合する際に、通常はより上手く働きます。'<literal>track</literal>'モードは、例えば<abbrev>VOB</abbrev>や<abbrev>EVO</abbrev>ファイルなどの大きなファイルの一部がソースの場合より上手く働くかもしれません。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Subtitle tracks are always treated as if '<literal>file</literal>' mode were active even if '<literal>track</literal>' mode actually is.
de: 字幕トラックは'<literal>track</literal>'モードが指定された場合でも、常に'<literal>file</literal>'が指定されたかのように処理されます。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: This option controls to which track another track is appended.  Each spec contains four IDs: a file ID, a track ID, a second file ID and a second track ID.  The first pair, "source file ID" and "source track ID", identifies the track that is to be appended.  The second pair, "destination file ID" and "destination track ID", identifies the track the first one is appended to.
de: このオプションは、どのトラックがどのトラックに追加されるのかを制御します。ファイルID、トラックID、追加するファイルID、追加するトラックIDの4つのIDで一組の指定を構成します。最初のファイルIDとトラックIDの組み合わせは、追加される対象のトラックを指定します。次のファイルIDとトラックIDは、そのトラックに追加されるトラックを指定します。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: If this option has been omitted then a standard mapping is used.  This standard mapping appends each track from the current file to a track from the previous file with the same track ID.  This allows for easy appending if a movie has been split into two parts and both file have the same number of tracks and track IDs with the command <command>mkvmerge -o output.mkv part1.mkv +part2.mkv</command>.
de: このオプションが指定されない場合、標準のマッピングが使用されます。この場合、前のファイルのトラックに、現在のファイルのトラックIDが同じであるトラックが追加されます。これにより、動画が二つのファイルに分割されており、かつ同じトラック数とトラックIDを持つ場合、<command>mkvmerge -o output.mkv part1.mkv +part2.mkv</command>のようにして簡単に結合することができます。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: A single '+' causes the next file to be appended instead of added. The '+' can also be put in front of the next file name. Therefore the following two commands are equivalent:
de: '+'一文字を指定すると、次に指定されたファイルは追加ではなく結合されます。'+'は次のファイル名の直前に置くこともできます。よって、次の2つのコマンドは等価です。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Normally &mkvmerge; looks for files in the same directory as an input file that have the same base name and only differ in their running number (e.g. 'VTS_01_1.VOB', 'VTS_01_2.VOB', 'VTS_01_3.VOB' etc) and treats all of those files as if they were concatenated into a single big file. This option, a single '=', causes mkvmerge not to look for those additional files.
de: 通常mkvmergeは、入力ファイルと同じディレクトリにあり、同じ基底名を持ち、通し番号だけが異なるファイル（例：'VTS_01_1.VOB', 'VTS_01_2.VOB', 'VTS_01_3.VOB' etc）を検索し、それらのファイル全てを、まるで1つの大きなファイルへと連結されているかのように扱います。この'='一文字のオプションを使うと、mkvmergeはそういった追加ファイルを検索しません。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: The '=' can also be put in front of the next file name. Therefore the following two commands are equivalent:
de: '='は次のファイル名の直前に置くこともできます。よって、次の2つのコマンドは等価です。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: If multiple file names are contained in a pair of parenthesis then those files will be treated as if they were concatenated into a single big file consisting of the content of each of the files one after the other.
de: 複数のファイル名が括弧の中に含まれている場合、それらのファイルは、各ファイルの内容によって順々に構成される1つの大きなファイルへと連結されているかのように扱われます。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: This can be used for e.g. VOB files coming from a DVD or MPEG transport streams. It cannot be used if each file contains its own set of headers which is usually the case with stand-alone files like AVI or MP4.
de: これは、例えばDVDのVOBファイルやMPEGトランスポートストリーム等のために使用することができます。通常AVIやMP4のようなスタンドアローンのファイルの場合ですが、各ファイルが自身のヘッダを一通り含んでいる場合には使用することができません。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Putting a file name into parenthesis also prevents &mkvmerge; from looking for additional files with the same base name as described in <link linkend="mkvmerge.description.prevent_concatenation">option <option>=</option></link>. Therefore these two command lines are equivalent:
de: ファイル名を括弧で括るのは、<link linkend="mkvmerge.description.prevent_concatenation">オプション<option>=</option></link>で説明されているように同じ基底名を持つファイルを&mkvmerge;に検索させない効果もあります。 よって、これらの2つのコマンドラインは同値です：

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Several things should be noted:
de: いくつか注意事項があります：

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><orderedlist><listitem><para>
en: There must be spaces both after the opening and before the closing parenthesis.
de: 開く括弧の後と閉じる括弧の前の両方に空白が必要です。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><orderedlist><listitem><para>
en: Every parameter between parenthesis is interpreted as a file name. Therefore all options applying to this logical file must be listed before the opening parenthesis.
de: 括弧内の全てのパラメータはファイル名として解釈されます。よって、この論理上のファイルに適用される全てのオプションは、開く括弧の前に記述する必要があります。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><orderedlist><listitem><para>
en: Some shells treat parenthesis as special characters. Hence you must escape or quote them as shown in the example above.
de: 括弧を特殊文字として扱うシェルもあります。よって、上の例で示されているように括弧をエスケープするかクォーテーションで囲む必要があります。

note: type: Content of: <refentry><refsect1><refsect2><title>
en: Attachment support (more global options)
de: 添付ファイルのサポート（グローバルオプションの続き）

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Plain text description of the following attachment. Applies to the next <link linkend="mkvmerge.description.attach_file"><option>--attach-file</option></link> or <option>--attach-file-once</option> option.
de: 次の添付ファイルを説明するプレーンテキストを指定します。次の<link linkend="mkvmerge.description.attach_file"><option>--attach-file</option></link>オプション又は<option>--attach-file-once</option>オプションで指定した添付ファイルに適用されます。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: <abbrev >MIME</abbrev> type of the following attachment. Applies to the next <link linkend="mkvmerge.description.attach_file"><option>--attach-file</option></link> or <link linkend="mkvmerge.description.attach_file"><option>--attach-file-once</option></link> option.  A list of officially recognized <abbrev>MIME</abbrev> types can be found e.g. at <ulink url="http://www.iana.org/assignments/media-types/">the IANA homepage</ulink>. The <abbrev>MIME</abbrev> type is mandatory for an attachment.
de: 次の添付ファイルの<abbrev >MIME</abbrev>タイプを指定します。<link linkend="mkvmerge.description.attach_file"><option>--attach-file</option></link>及び<link linkend="mkvmerge.description.attach_file"><option>--attach-file-once</option></link>オプションに適用されます。公式に認知されている<abbrev>MIME</abbrev>タイプは例えば<ulink url="http://www.iana.org/assignments/media-types/">IANAのホームページ</ulink>に掲載されています。<abbrev>MIME</abbrev>タイプは添付ファイルに必須です。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Sets the name that will be stored in the output file for this attachment.  If this option is not given then the name will be derived from the file name of the attachment as given with the <link linkend="mkvmerge.description.attach_file"><option>--attach-file</option></link> or the <link linkend="mkvmerge.description.attach_file"><option>--attach-file-once</option></link> option.
de: この添付ファイルの、出力ファイル内での名前を指定します。このオプションが指定されなかった場合、<link linkend="mkvmerge.description.attach_file"><option>--attach-file</option></link>または<link linkend="mkvmerge.description.attach_file"><option>--attach-file-once</option></link>で指定されたファイル名がそのまま使用されます。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Creates a file attachment inside the &matroska; file. The <abbrev>MIME</abbrev> type must have been set before this option can used. The difference between the two forms is that during splitting the files attached with <option>--attach-file</option> are attached to all output files while the ones attached with <option>--attach-file-once</option> are only attached to the first file created.  If splitting is not used then both do the same.
de: &matroska;ファイルの内部に添付ファイルを作成します。これらのオプションを使用するには、<abbrev>MIME</abbrev>タイプをこれらのオプションより前に指定しなければなりません。二つのオプションの違いは、出力ファイルを分割する際に、<option>--attach-file</option>では全ての出力ファイルに添付されますが、<option>--attach-file-once</option>では最初に作成されたファイルにしか添付されない点です。分割が使用されない場合、2つは等価です。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: &mkvextract; can be used to extract attached files from a &matroska; file.
de: &mkvextract;で&matroska;ファイルから添付ファイルを抽出することができます。

note: type: Content of: <refentry><refsect1><refsect2><title>
en: Options that can be used for each input file
de: 各入力ファイルに指定できるオプション

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Copy the audio tracks <parameter>n</parameter>, <parameter>m</parameter> etc. The numbers are track IDs which can be obtained with the <link linkend="mkvmerge.description.identify"><option>--identify</option></link> switch. They're not simply the track numbers (see section <link linkend="mkvmerge.track_ids">track IDs</link>). Default: copy all audio tracks.
de: オーディオトラック<parameter>n</parameter>、<parameter>m</parameter>…をコピーします。番号は<link linkend="mkvmerge.description.identify"><option>--identify</option></link>オプションで得られるトラックIDです。これは単純にトラック番号を示すものではありません(<link linkend="mkvmerge.track_ids">トラックID</link>のセクションを参照してください)。デフォルト: 全てのオーディオトラックをコピーします。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: If the IDs are prefixed with <literal>!</literal> then the meaning is reversed: copy everything but the IDs listed after the <literal>!</literal>.
de: もしIDにプレフィックス<literal>!</literal>がついていた場合は、意味が逆になります：<literal>!</literal>の後に列挙されたIDを除く全てをコピーします。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Copy the video tracks <parameter>n</parameter>, <parameter>m</parameter> etc. The numbers are track IDs which can be obtained with the <link linkend="mkvmerge.description.identify"><option>--identify</option></link> switch. They're not simply the track numbers (see section <link linkend="mkvmerge.track_ids">track IDs</link>). Default: copy all video tracks.
de: ビデオトラック<parameter>n</parameter>、<parameter>m</parameter>…をコピーします。数字は<link linkend="mkvmerge.description.identify"><option>--identify</option></link>オプションで得られるトラックIDです。これは単純にトラック番号を示すものではありません(<link linkend="mkvmerge.track_ids">トラックID</link>のセクションを参照してください)。 デフォルト: 全てのビデオトラックをコピーします。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Copy the subtitle tracks <parameter>n</parameter>, <parameter>m</parameter> etc. The numbers are track IDs which can be obtained with the <link linkend="mkvmerge.description.identify"><option>--identify</option></link> switch. They're not simply the track numbers (see section <link linkend="mkvmerge.track_ids">track IDs</link>). Default: copy all subtitle tracks.
de: 字幕トラック<parameter>n</parameter>、<parameter>m</parameter>…をコピーします。番号は<link linkend="mkvmerge.description.identify"><option>--identify</option></link>オプションで得られるトラックIDです。これは単純にトラック番号を示すものではありません(<link linkend="mkvmerge.track_ids">トラックID</link>のセクションを参照してください)。デフォルト: 全ての字幕トラックをコピーします。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Copy the button tracks <parameter>n</parameter>, <parameter>m</parameter> etc. The numbers are track IDs which can be obtained with the <link linkend="mkvmerge.description.identify"><option>--identify</option></link> switch. They're not simply the track numbers (see section <link linkend="mkvmerge.track_ids">track IDs</link>). Default: copy all button tracks.
de: ボタントラック<parameter>n</parameter>、<parameter>m</parameter>…をコピーします。番号は<link linkend="mkvmerge.description.identify"><option>--identify</option></link>オプションで得られるトラックIDです。これは単純にトラック番号を示すものではありません(<link linkend="mkvmerge.track_ids">トラックID</link>のセクションを参照してください)。デフォルト: 全てのボタントラックをコピーします。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Copy the tags for tracks <parameter>n</parameter>, <parameter>m</parameter> etc.  The numbers are track IDs which can be obtained with the <link linkend="mkvmerge.description.identify"><option>--identify</option></link> switch (see section <link linkend="mkvmerge.track_ids">track IDs</link>).  They're not simply the track numbers.  Default: copy tags for all tracks.
de: トラック<parameter>n</parameter>、<parameter>m</parameter>…のタグをコピーします。番号は<link linkend="mkvmerge.description.identify"><option>--identify</option></link>オプションで得られるトラックIDです。これは単純にトラック番号を示すものではありません(<link linkend="mkvmerge.track_ids">トラックID</link>のセクションを参照してください)。デフォルト: 全てのトラックのタグをコピーします。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Copy the attachments with the IDs <parameter>n</parameter>, <parameter>m</parameter> etc to all or only the first output file. Each ID can be followed by either '<literal>:all</literal>' (which is the default if neither is entered) or '<literal>:first</literal>'. If splitting is active then those attachments whose IDs are specified with '<literal>:all</literal>' are copied to all of the resulting output files while the others are only copied into the first output file. If splitting is not active then both variants have the same effect.
de: IDが<parameter>n</parameter>、<parameter>m</parameter>…の添付ファイルを全ての、または最初の出力ファイルにコピーします。各IDの後ろには、'<literal>:all</literal>'(デフォルト)又は'<literal>:first</literal>'を指定することができます。出力ファイル分割が有効の場合、'<literal>:all</literal>'をつけたIDの添付ファイルは全ての出力ファイルにコピーされ、'<literal>:first</literal>'をつけた場合は最初の出力ファイルにのみコピーされます。分割が有効でない場合は二つは同等です。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: The default is to copy all attachments to all output files.
de: デフォルトでは、全ての添付ファイルが全ての出力ファイルにコピーされます。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Don't copy any audio track from this file.
de: このファイルからオーディオトラックをコピーしません。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Don't copy any video track from this file.
de: このファイルからビデオトラックをコピーしません。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Don't copy any subtitle track from this file.
de: このファイルから字幕トラックをコピーしません。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Don't copy any button track from this file.
de: このファイルからボタントラックをコピーしません。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Don't copy any track specific tags from this file.
de: このファイルからオーディオトラックをコピーしません。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Don't copy chapters from this file.
de: このファイルからチャプタをコピーしません。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Don't copy attachments from this file.
de: このファイルから添付ファイルをコピーしません。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Don't copy global tags from this file.
de: このファイルからグローバルタグを引き継ぎません。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Sets the charset that is used for the conversion to UTF-8 for chapter information contained in the source file. See the section about <link linkend="mkvmerge.text_files_and_charsets"> text files and character sets</link> for an explanation how &mkvmerge; converts between character sets.
de: ソースファイルに含まれるチャプタ情報ををUTF-8に変換する際の文字コードを指定します。&mkvmerge;の文字コード変換については、<link linkend="mkvmerge.text_files_and_charsets">テキストファイルと文字コード</link>のセクションを参照してください。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Sets the ISO639-2 language code that is written for each chapter entry.  This option can be used for source files that contain chapters but no information about the chapters' languages, e.g. for MP4 and OGM files.
de: 各チャプタエントリのISO639-2言語コードを指定します。このオプションはソースファイルがチャプタは含みますが、チャプタの言語情報を含まない場合(例:MP4、OGMファイル)に使用されます。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Adjust the timecodes of the track with the id <parameter>TID</parameter> by <parameter>d</parameter> ms. The track IDs are the same as the ones given with <link linkend="mkvmerge.description.identify"><option>--identify</option></link> (see section <link linkend="mkvmerge.track_ids">track IDs</link>).
de: トラックIDが<parameter>TID</parameter>のトラックのタイムコードを<parameter>d</parameter>ミリ秒だけ調整します。トラックIDは<link linkend="mkvmerge.description.identify"><option>--identify</option></link>オプションで得られるものと同じです(<link linkend="mkvmerge.track_ids">トラックID</link>のセクションを参照してください)。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: <parameter>o</parameter>/<parameter>p</parameter>: adjust the timestamps by <parameter>o</parameter>/<parameter>p</parameter> to fix linear drifts. <parameter>p</parameter> defaults to 1 if omitted. Both <parameter>o</parameter> and <parameter>p</parameter> can be floating point numbers.
de: <parameter>o</parameter>/<parameter>p</parameter>: タイムスタンプを<parameter>o</parameter>/<parameter>p</parameter>の割合で調整し、リニアドリフトを修正します。<parameter>p</parameter>が省略された場合、デフォルトで1が使用されます。<parameter>o</parameter>及び<parameter>p</parameter>には小数を指定できます。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Defaults: no manual sync correction (which is the same as <parameter>d</parameter> = <constant>0</constant> and <parameter>o</parameter>/<parameter>p</parameter> = <constant>1.0</constant>).
de: デフォルト: マニュアル同期修正は行われません(<parameter>d</parameter> = <constant>0</constant> かつ<parameter>o</parameter> = <constant>1.0</constant>の場合と同じです)。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: This option can be used multiple times for an input file applying to several tracks by selecting different track IDs each time.
de: このオプションは異るトラックIDを指定することで複数の入力トラックに対して使用することができます。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Controls for which tracks cue (index) entries are created for the given track (see section <link linkend="mkvmerge.track_ids">track IDs</link>). '<literal>none</literal>' inhibits the creation of cue entries.  For '<literal>iframes</literal>' only blocks with no backward or forward references ( = I frames in video tracks) are put into the cue sheet. '<literal>all</literal>' causes &mkvmerge; to create cue entries for all blocks which will make the file very big.
de: 指定されたトラックについて、どのトラックCUE(インデックス)エントリが作成されるのかを指定します(<link linkend="mkvmerge.track_ids">トラックID</link>のセクションを参照)。'<literal>none</literal>'はCUEエントリを作成しません。'<literal>iframes</literal>は前方参照及び後方参照を含まないブロック(ビデオトラックでは I frame)のみがCUEシートに挿入されます。'<literal>all</literal>'では&mkvmerge;は全てのブロックに対してCUEエントリを作成し、非常に大きなファイルを出力するでしょう。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: The default is '<literal>iframes</literal>' for video tracks and '<literal>none</literal>' for all others.  See also option <link linkend="mkvmerge.description.no_cues"><option>--no-cues</option></link> which inhibits the creation of cue entries regardless of the <option>--cues</option> options used.
de: デフォルトはビデオトラックは'<literal>iframes</literal>で、その他のトラックは'<literal>none</literal>'です。<option>--cues</option>が使用されているかどうかに関わらずCUEエントリの作成を抑制する、<link linkend="mkvmerge.description.no_cues"><option>--no-cues</option></link>オプションも参照してください。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Sets the 'default' flag for the given track (see section <link linkend="mkvmerge.track_ids">track IDs</link>) if the optional argument <parameter>bool</parameter> is not present.  If the user does not explicitly select a track himself then the player should prefer the track that has his 'default' flag set. Only one track of each kind (audio, video, subtitles, buttons) can have his 'default' flag set.  If the user wants no track to have the default track flag set then he has to set <parameter>bool</parameter> to <constant>0</constant> for all tracks.
de: 省略可能な引数<parameter>bool</parameter>が指定されなかった場合、指定されたトラックに'デフォルト'フラグを付与します(<link linkend="mkvmerge.track_ids">トラックID</link>のセクションも参照)。ユーザが明示的にトラックを選択しなかった場合、プレイヤーは'デフォルト'フラグの付いたトラックを優先的に再生します。各トラックの種類(オーディオ、ビデオ、字幕、ボタン)ごとに、一つだけのトラックにだけ'デフォルト'フラグは付与できます。もし、デフォルトフラグをどのトラックにも付けたくない場合は、全てのトラックで<parameter>bool</parameter>を<constant>0</constant>にすれば可能です。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Sets the 'forced' flag for the given track (see section <link linkend="mkvmerge.track_ids">track IDs</link>) if the optional argument <parameter>bool</parameter> is not present. A player must play all tracks for which this flag is set to <constant>1</constant>.
de: 省略可能な引数<parameter>bool</parameter>が指定されなかった場合、指定されたトラックに'強制表示'フラグを付与します（<link linkend="mkvmerge.track_ids">トラックID</link>のセクションも参照。）プレーヤはこのフラグが<constant>1</constant>に設定されている全てのトラックを再生しなければなりません。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Keep only the <classname>BlockAdditions</classname> up to the level <parameter>level</parameter> for the given track.  The default is to keep all levels.  This option only affects certain kinds of codecs like WAVPACK4.
de: 指定したトラックで、レベル<parameter>level</parameter>までの<classname>BlockAddition</classname>を保持します。デフォルトでは全て保持します。このオプションはWAVPACK4などの特定のコーデックにのみ有効です。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Sets the track name for the given track (see section <link linkend="mkvmerge.track_ids">track IDs</link>) to <parameter>name</parameter>.
de: 指定したトラックのトラック名を<parameter>name</parameter>にします(<link linkend="mkvmerge.track_ids">トラックID</link>のセクションも参照)。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Sets the language for the given track (see section <link linkend="mkvmerge.track_ids">track IDs</link>). Both ISO639-2 language codes and ISO639-1 country codes are allowed. The country codes will be converted to language codes automatically.  All languages including their ISO639-2 codes can be listed with the <link linkend="mkvmerge.description.list_languages"><option>--list-languages</option></link> option.
de: 指定したトラックの言語を設定します(<link linkend="mkvmerge.track_ids">トラックID</link>のセクションも参照)。ISO639-2 言語コード及び ISO639-1 国別コードが使用できます。国別コードは言語コードへ自動的に変換されます。ISO639-2 に含まれる全てのコードは<link linkend="mkvmerge.description.list_languages"><option>--list-languages</option></link>オプションで一覧できます。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Read tags for the track with the number <parameter>TID</parameter> from the file <parameter>file-name</parameter>. See the section about <link linkend="mkvmerge.tags">tags</link> below for details.
de: <parameter>file-name</parameter>で指定したファイルからグローバルタグを読み込みます。詳細は<link linkend="mkvmerge.tags">タグ</link>のセクションを参照してください。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Tells &mkvmerge; that the track with the ID <parameter>TID</parameter> is <abbrev>SBR AAC</abbrev> (also known as <abbrev>HE-AAC</abbrev> or <abbrev>AAC+</abbrev>). This options is needed if a) the source file is an <abbrev>AAC</abbrev> file (<emphasis>not</emphasis> for a &matroska; file) and b) the <abbrev>AAC</abbrev> file contains <abbrev>SBR AAC</abbrev> data.  The reason for this switch is that it is technically impossible to automatically tell normal <abbrev>AAC</abbrev> data from <abbrev>SBR AAC</abbrev> data without decoding a complete <abbrev>AAC</abbrev> frame. As there are several patent issues with <abbrev>AAC</abbrev> decoders &mkvmerge; will never contain this decoding stage. So for <abbrev>SBR AAC</abbrev> files this switch is mandatory. The resulting file might not play back correctly or even not at all if the switch was omitted.
de: &mkvmerge;にIDが<parameter>TID</parameter>のトラックが<abbrev>SBR AAC</abbrev> (別名<abbrev>HE-AAC</abbrev>又は<abbrev>AAC+</abbrev>)であることを教えます。このオプションは、 a) ソースファイルが(&matroska;ファイルでは<emphasis>なく</emphasis>)<abbrev>AAC</abbrev>ファイルでありかつ b) <abbrev>AAC</abbrev>ファイルが<abbrev>SBR AAC</abbrev>データを含む場合に必要です。このスイッチが存在する理由は、通常の<abbrev>AAC</abbrev>ファイルと<abbrev>SBR AAC</abbrev>ファイルを自動的に区別することは、<abbrev>AAC</abbrev>フレームを完全にデコードしなければ技術的に不可能であるためです。<abbrev>AAC</abbrev>はいくつかの特許問題を抱えているため、&mkvmerge;は将来的にもこのデコードステージを含むことはありません。よって、<abbrev>SBR AAC</abbrev>にはこのスイッチが必須となります。このスイッチが指定されなかった場合、出力ファイルは正常に再生ができなくなるか、完全に再生不能になるでしょう。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: If the source file is a &matroska; file then the <classname>CodecID</classname> should be enough to detect <abbrev>SBR AAC</abbrev>. However, if the <classname>CodecID</classname> is wrong then this switch can be used to correct that.
de: ソースファイルが&matroska;ファイルの場合、<classname>CodecID</classname>により<abbrev>SBR AAC</abbrev>を検知できます。しかし、<classname>CodecID</classname>が不正な場合、このスイッチで修正することができます。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: If mkvmerge wrongfully detects that an <abbrev>AAC</abbrev> file is <abbrev>SBR</abbrev> then you can add '<literal>:0</literal>' to the track ID.
de: もし、mkvmergeが<abbrev>AAC</abbrev>ファイルを間違って<abbrev>SBR</abbrev>と認識してしまった場合、トラックIDに'<literal>:0</literal>'を指定できます。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Read the timecodes to be used for the specific track ID from <parameter>file-name</parameter>.  These timecodes forcefully override the timecodes that &mkvmerge; normally calculates. Read the section about <link linkend="mkvmerge.external_timecode_files">external timecode files</link>.
de: 指定したトラックIDのタイムコードを、<parameter>file-name</parameter>から読み込みます。これらのタイムコードは&mkvmerge;が通常計算するタイムコードを強制的に上書きします。<link linkend="mkvmerge.external_timecode_files">外部タイムコードファイル</link>のセクションを参照してください。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Forces the default duration of a given track to the specified value.  Also modifies the track's timecodes to match the default duration.  The argument <parameter>x</parameter> must be postfixed with '<literal>s</literal>', '<literal>ms</literal>', '<literal>us</literal>', '<literal>ns</literal>', '<literal>fps</literal>', '<literal>p</literal>' or '<literal>i</literal>' to specify the default duration in seconds, milliseconds, microseconds, nanoseconds, 'frames per second', 'progressive frames per second' or 'interlaced frames per second' respectively. The number <parameter>x</parameter> itself can be a floating point number or a fraction.
de: 指定したトラックの default duration を強制的に設定します。トラックのトラックのタイムコードも、 default duration に合うように変更されます。引数<parameter>x</parameter>は'<literal>s</literal>'、'<literal>ms</literal>'、'<literal>us</literal>'、'<literal>ns</literal>'、'<literal>fps</literal>'、<literal>p</literal>'。'<literal>i</literal>のうちどれか一つを後置されていなければなりません。それぞれ、 default duration は秒、ミリ秒、マイクロ秒、ナノ秒、'fps'、1秒あたりのプログレッシブフレーム、1秒あたりのインターレスのフレーム数単位で指定されます。<parameter>x</parameter>は小数または分数で指定できます。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: If the default duration is not forced then mkvmerge will try to derive the track's default duration from the container and/or the encoded bitstream for certain track types, e.g. AVC/h.264 or MPEG-2.
de: デフォルトのフレーム持続時間が指定されなかった場合は、mkvmergeはそのトラックのデフォルトのフレーム持続時間を、コンテナと、AVC/h.264やMPEG-2のような特定のトラックタイプの場合はエンコードされたビットストリームから取得しようと試みます。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: This option can also be used to change the <abbrev>FPS</abbrev> of video tracks without having to use an external timecode file.
de: このオプションは、外部タイムコードファイルを使用せずにビデオトラックの<abbrev>FPS</abbrev>を変更するのにも使えます。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Forces the <abbrev>NALU</abbrev> size length to <parameter>n</parameter> bytes.  This parameter is only used if the <foreignphrase>AVC/h.264</foreignphrase> elementary stream packetizer is used.  If left out it defaults to 4 bytes, but there are files that contain frames or slices that are all smaller than 65536 bytes.  For such files you can use this parameter and decrease the size to 2.
de: <abbrev>NALU</abbrev>サイズ長を<parameter>n</parameter>バイトに強制設定します。このパラメータは<foreignphrase>AVC/h.264</foreignphrase>エレメンタリストリームパケタイザが使用される場合にのみ使用されます。何も指定しなかった時のデフォルト値は4バイトですが、65535バイト以上のフレームやスライスが含まれていないファイルも存在します。そのようなファイルでは、このパラメータを使用してNALUサイズ長を2に減らすことができます。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Selects the compression method to be used for the track. Note that the player also has to support this method. Valid values are '<literal>none</literal>', '<literal>zlib</literal>', '<literal>lzo</literal>'/'<literal>lxo1x</literal>', '<literal>bz2</literal>'/'<literal>bzlib</literal>' and '<literal>mpeg4_p2</literal>'/'<literal>mpeg4p2</literal>'.  The values '<literal>lzo</literal>'/'<literal>lxo1x</literal>' and '<literal>bz2</literal>'/'<literal>bzlib</literal>' are only available if &mkvmerge; has been compiled with support for the <productname>liblzo</productname> and <productname>bzlib</productname> compression libraries, respectively.
de: トラックの圧縮法を選択します。プレイヤーが選択した圧縮法をサポートしている必要があることに注意してください。指定できる圧縮法は、'<literal>none</literal>'、'<literal>zlib</literal>'、'<literal>lzo</literal>'/'<literal>lxo1x</literal>'、'<literal>bz2</literal>'/'<literal>bzlib</literal>'及び'<literal>mpeg4_p2</literal>'/'<literal>mpeg4p2</literal>'です。'<literal>lzo</literal>'/'<literal>lxo1x</literal>'と'<literal>bz2</literal>'/'<literal>bzlib</literal>'は&mkvmerge;がそれぞれ、<productname>liblzo</productname>及び<productname>bzlib</productname>圧縮ライブラリのサポート付きでコンパイルされたときのみ使用できます。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: The compression method '<literal>mpeg4_p2</literal>'/'<literal>mpeg4p2</literal>' is a special compression method called '<foreignphrase>header removal</foreignphrase>' that is only available for <abbrev>MPEG4</abbrev> part 2 video tracks.
de: '<literal>mpeg4_p2</literal>'/'<literal>mpeg4p2</literal>'圧縮法は、 <abbrev>MPEG4</abbrev> part2 ビデオトラックにのみ適用できる、'<foreignphrase>header removal</foreignphrase>'と呼ばれる特殊な圧縮法です。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: The default for some subtitle tracks is '<literal>zlib</literal>' compression. This compression method is also the one that most if not all playback applications support. Support for other compression methods other than '<literal>none</literal>' is not assured.
de: いくつかの字幕トラックにおけるデフォルトは'<literal>zlib</literal>'圧縮法です。この圧縮法はほとんど全ての再生アプリケーションでサポートされています。'<literal>none</literal>'以外の他の圧縮法については、サポートされているとは限りません。

note: type: Content of: <refentry><refsect1><refsect2><title>
en: Options that only apply to video tracks
de: ビデオトラックにのみ適用されるオプション

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Forces the <classname>FourCC</classname> to the specified value. Works only for video tracks in the '<foreignphrase>MS compatibility mode</foreignphrase>'.
de: <classname>FourCC</classname>を指定した値に強制設定します。ビデオトラックが'<foreignphrase>MS互換モード</foreignphrase>'である場合にのみ有効です。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: &matroska; files contain two values that set the display properties that a player should scale the image on playback to: display width and display height.  These values can be set with this option, e.g. '<literal>1:640x480</literal>'.
de: &matroska;ファイルは再生時の画像スケールを決定するための二つの値を持ちます。表示幅と表示高さです。これらの値をこのオプションで、例えば'<literal>1:640x480</literal>'のように指定できます。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Another way to specify the values is to use the <link linkend="mkvmerge.description.aspect_ratio"><option>--aspect-ratio</option></link> or the <link linkend="mkvmerge.description.aspect_ratio_factor"><option>--aspect-ratio-factor</option></link> option (see below).  These options are mutually exclusive.
de: これらの値を設定する別の方法として、<link linkend="mkvmerge.description.aspect_ratio"><option>--aspect-ratio</option></link>又は<link linkend="mkvmerge.description.aspect_ratio_factor"><option>--aspect-ratio-factor</option></link>オプションが使用できます(下記参照)。これらのオプションは互いに排他的です。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: &matroska; files contain two values that set the display properties that a player should scale the image on playback to: display width and display height.  With this option &mkvmerge; will automatically calculate the display width and display height based on the image's original width and height and the aspect ratio given with this option.  The ratio can be given either as a floating point number <parameter>ratio</parameter> or as a fraction '<parameter>width</parameter>/<parameter>height</parameter>', e.g. '<literal>16/9</literal>'.
de: &matroska;ファイルは再生時の画像スケールを決定するための二つの値を持ちます。表示幅と表示高さです。これらの値をこのオプションで、例えば'<literal>1:640x480</literal>'のように指定できます。このオプションを指定すると、&mkvmerge;は自動的に表示幅及び表示高さを、画像の元の幅と高さ、そして指定されたアスペクト比から自動的に計算します。アスペクト比は、小数<parameter>ratio</parameter>または分数'<parameter>width</parameter>/<parameter>height</parameter>'(例: '<literal>16/9</literal>')の形式で指定できます。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Another way to specify the values is to use the <link linkend="mkvmerge.description.aspect_ratio_factor"><option>--aspect-ratio-factor</option></link> or <link linkend="mkvmerge.description.display_dimensions"><option>--display-dimensions</option></link> options (see above and below). These options are mutually exclusive.
de: これらの値を設定する別の方法として、<link linkend="mkvmerge.description.aspect_ratio_factor"><option>--aspect-ratio-factor</option></link>又は<link linkend="mkvmerge.description.display_dimensions"><option>--display-dimensions</option></link>オプションが使用できます(上記及び下記参照)。これらのオプションは互いに排他的です。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Another way to set the aspect ratio is to specify a <parameter>factor</parameter>. The original aspect ratio is first multiplied with this <parameter>factor</parameter> and used as the target aspect ratio afterwards.
de: アスペクト比を設定するもうひとつの方法は、元のアスペクト比からの係数を指定する方法です。元のアスペクト比に、<parameter>factor</parameter>を乗じたものが新しいアスペクト比として使用されます。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Another way to specify the values is to use the <link linkend="mkvmerge.description.aspect_ratio"><option>--aspect-ratio</option></link> or <link linkend="mkvmerge.description.display_dimensions"><option>--display-dimensions</option></link> options (see above). These options are mutually exclusive.
de: これらの値を設定する別の方法として、<link linkend="mkvmerge.description.aspect_ratio"><option>--aspect-ratio</option></link>又は<link linkend="mkvmerge.description.display_dimensions"><option>--display-dimensions</option></link>オプションが使用できます(上記参照)。これらのオプションは互いに排他的です。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Sets the pixel cropping parameters of a video track to the given values.
de: ビデオトラックのピクセルクロッピングのパラメータを指定した値に設定します。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Sets the stereo mode for the video track with the track ID <parameter>TID</parameter>.  The mode can either be a number <parameter>n</parameter> between <constant>0</constant> and <constant>14</constant> or one of these keywords:
de: トラックIDが<parameter>TID</parameter>のビデオトラックのステレオモードを設定します。ステレオモードは、<constant>0</constant>～<constant>14</constant>の数字<parameter>n</parameter>、または以下のキーワードのうちの1つを指定することができます：

note: type: Content of: <refentry><refsect1><refsect2><title>
en: Options that only apply to text subtitle tracks
de: テキスト字幕トラックにのみ適用されるオプション

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Sets the character set for the conversion to UTF-8 for UTF-8 subtitles for the given track ID. If not specified the charset will be derived from the current locale settings. Note that a charset is not needed for subtitles read from &matroska; files or from Kate streams, as these are always stored in UTF-8. See the section about <link linkend="mkvmerge.text_files_and_charsets"> text files and character sets</link> for an explanation how &mkvmerge; converts between character sets.
de: 指定したIDの示すトラックのUTF-8字幕をUTF-8へ変換する際の文字コードを指定します。デフォルトでは、現在のロケールの設定が使用されます。&mkvmerge;の文字コード変換については、<link linkend="mkvmerge.text_files_and_charsets">テキストファイルと文字コード</link>のセクションを参照してください。

note: type: Content of: <refentry><refsect1><refsect2><title>
en: Other options
de: その他のオプション

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Will let &mkvmerge; probe the single file and report its type, the tracks contained in the file and their track IDs. If this option is used then the only other option allowed is the filename.
de: &mkvmerge;に、単一のファイルを探査してその種類と、ファイルに含まれるトラック及びそのトラックIDを表示させます。このオプションを指定した場合、他に指定できるのはファイル名のみです。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: This option causes &mkvmerge; to output additional information about the container and each track within. The extra information is surronded by square brackets. It consists of space-saparated key/value pairs where keys and values are separated by a colon.
de: このオプションを指定すると、&mkvmerge;はコンテナと中身の各トラックについての追加の情報を出力します。追加情報は、四角の括弧で囲まれます。それはスペースで区切られたキーと値のペアで構成され、キーと値はコロンで区切られます。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Each value is escaped according to the rules described in <link linkend="mkvmerge.escaping">the section about escaping special characters in text</link>.
de: 各値は、<link linkend="mkvmerge.escaping">テキスト中の特殊文字のエスケープについてのセクション</link>で説明されているルールに従ってエスケープされます。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Lists supported input file types.
de: サポートされている入力ファイルの種類を列挙します。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Lists all languages and their ISO639-2 code which can be used with the <link linkend="mkvmerge.description.language"><option>--language</option></link> option.
de: <link linkend="mkvmerge.description.language"><option>--language</option></link>オプションに指定できる、ISO639-2言語コードの一覧を出力します。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Sets the process priority that &mkvmerge; runs with. Valid values are '<literal>lowest</literal>', '<literal>lower</literal>', '<literal>normal</literal>', '<literal>higher</literal>' and '<literal>highest</literal>'. If nothing is given then '<literal>normal</literal>' is used. On Unix like systems &mkvmerge; will use the <citerefentry><refentrytitle>nice</refentrytitle><manvolnum>2</manvolnum></citerefentry> function. Therefore only the super user can use '<literal>higher</literal>' and '<literal>highest</literal>'. On Windows all values are useable for every user.
de: &mkvmerge;を実行する際のプロセス優先度を指定します。指定できるのは'<literal>lowest</literal>'、'<literal>lower</literal>'、'<literal>normal</literal>'、'<literal>higher</literal>'、及び'<literal>highest</literal>'です。指定されない場合、'<literal>normal</literal>'が使用されます。UNIX系のシステムでは、&mkvmerge;は<citerefentry><refentrytitle>nice</refentrytitle><manvolnum>2</manvolnum></citerefentry>関数を使用するので、'<literal>higher</literal>'及び'<literal>highest</literal>'はスーパーユーザのみが使用可能です。Windowsでは全てのユーザが全優先度を使用可能です。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Sets the character set to convert strings given on the command line from. It defaults to the character set given by system's current locale. This settings applies to arguments of the following options: <link linkend="mkvmerge.description.title"><option>--title</option></link>, <link linkend="mkvmerge.description.track_name"><option>--track-name</option></link> and <link linkend="mkvmerge.description.attachment_description"><option>--attachment-description</option></link>.
de: コマンドライン文字列の文字コードを指定します。デフォルトは、システムの現在のロケールの文字コードになります。この設定は<link linkend="mkvmerge.description.title"><option>--title</option></link>、<link linkend="mkvmerge.description.track_name"><option>--track-name</option></link>、及び<link linkend="mkvmerge.description.attachment_description"><option>--attachment-description</option></link>の三つのオプションの引数に影響します。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Writes all messages to the file <parameter>file-name</parameter> instead of to the console.  While this can be done easily with output redirection there are cases in which this option is needed: when the terminal reinterprets the output before writing it to a file.  The character set set with <link linkend="mkvmerge.description.output_charset"><option>--output-charset</option></link> is honored.
de: 全てのメッセージをコンソールではなく<parameter>file-name</parameter>で指定したファイルに書き出します。出力リダイレクトによっても同じことが簡単にできますが、このオプションが必要な場合もあります。ターミナルがファイルに書き込む前に出力を処理してしまう場合などです。<link linkend="mkvmerge.description.output_charset"><option>--output-charset</option></link>によって指定された文字コードは尊重されます。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Forces the translations for the language <parameter>code</parameter> to be used (e.g.  '<literal>de_DE</literal>' for the German translations). It is preferable to use the environment variables <varname>LANG</varname>, <varname>LC_MESSAGES</varname> and <varname>LC_ALL</varname> though. Entering '<literal>list</literal>' as the <parameter>code</parameter> will cause &mkvmerge; to output a list of available translations.
de: 指定した<parameter>code</parameter>を強制的に言語コード(例: 日本語ならば'<literal>ja_JP</literal>')として使用します。しかし、環境変数<varname>LANG</varname>や<varname>LC_MESSAGES</varname>、<varname>LC_ALL</varname>を使用したほうが好ましいでしょう。<parameter>code</parameter>に<literal>list</literal>と指定すると、指定できる言語コードの一覧を出力します。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Turn on experimental features. A list of available features can be requested with <command>mkvmerge --engage list</command>. These features are not meant to be used in normal situations.
de: 実験的機能をオンにします。利用可能な機能のリストは<command>mkvmerge --engage list</command>で得られます。これらの機能は通常の状況で使用されることは意図されていません。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Reads additional command line arguments from the file <parameter>options-file</parameter>. See the section about <link linkend="mkvmerge.option_files">option files</link> for further information.
de: ファイル<parameter>options-file</parameter>から追加のコマンドライン引数を読み込みます。詳細は<link linkend="mkvmerge.option_files">オプションファイル</link>のセクションを参照してください。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: Lists information about optional features that have been compiled in and exit. The first line output will be the version information. All following lines contain exactly one word whose presence indicates that the feature has been compiled in. These features are:
de: コンパイル時に組込まれたオプション機能を一覧表示して終了します。出力の一行目はバージョン情報になります。以降の全ての行は、その機能がコンパイルされていることを示す一単語のみを含みます。オプション機能の一覧を下に示します。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><itemizedlist><listitem><para>
en: '<literal>BZ2</literal>' -- the <productname>bzlib</productname> compression library. Affects the available compression methods for the <link linkend="mkvmerge.description.compression"><option>--compression</option></link> option.
de: "'<literal>BZ2</literal>' -- <productname>bzlib</productname>圧縮ライブラリ。<link linkend="mkvmerge.description.compression"><option>--compression</option></link>オプションに指定できる圧縮メソッドに影響します。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><itemizedlist><listitem><para>
en: '<literal>LZO</literal>' -- the <productname>lzo</productname> compression library. Affects the available compression methods for the <link linkend="mkvmerge.description.compression"><option>--compression</option></link> option.
de: '<literal>LZO</literal>' -- <productname>lzo</productname>圧縮ライブラリ。<link linkend="mkvmerge.description.compression"><option>--compression</option></link>オプションに指定できる圧縮メソッドに影響します。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><itemizedlist><listitem><para>
en: '<literal>FLAC</literal>' -- reading raw <abbrev>FLAC</abbrev> files and handling <abbrev>FLAC</abbrev> tracks in other containers, e.g. <productname>Ogg</productname> or &matroska;.
de: '<literal>FLAC</literal>' -- 生<abbrev>FLAC</abbrev>ファイルの読み込み及び、他のコンテナ(例: <productname>Ogg</productname>、&matroska;など)に格納された<abbrev>FLAC</abbrev>トラックの処理。

note: type: Content of: <refentry><refsect1><title>
en: Usage
de: 使用法

note: type: Content of: <refentry><refsect1><para>
en: For each file the user can select which tracks &mkvmerge; should take.  They are all put into the file specified with <option>-o</option>. A list of known (and supported) source formats can be obtained with the <option>-l</option> option.
de: 各ファイルについて、ユーザは&mkvmerge;が取り出すべきトラックを選択できます。取り出されたトラックは、すべて<option>-o</option>で指定されたファイルに書き出されます。既知の(サポート済の)入力ファイルフォーマットは<option>-l</option>オプションで取得できます。

note: type: Content of: <refentry><refsect1><title>
en: Option order
de: オプションの順番

note: type: Content of: <refentry><refsect1><para>
en: The order in which options are entered is important for some options. Options fall into two categories:
de: いくつかのオプションでは、入力する順番が重要になります。オプションは2つに分類されます：

note: type: Content of: <refentry><refsect1><orderedlist><listitem><para>
en: Options that affect the whole program and are not tied to any input file. These include but are not limited to <option>--command-line-charset</option>, <option>--output</option> or <option>--title</option>. These can appear anywhere on the command line.
de: プログラム全体に影響し、どの入力ファイルにも関連付けられていないオプション。例えば、<option>--command-line-charset</option>、<option>--output</option>、<option>--title</option>などです。これらのオプションは、コマンドラインのどこに書いても構いません。

note: type: Content of: <refentry><refsect1><orderedlist><listitem><para>
en: Options that affect a single input file or a single track in an input file. These options all apply to the following input file on the command line. All options applying to the same input (or to tracks from the same input file) file can be written in any order as long as they all appear before that input file's name. Examples for options applying to an input file are <option>--no-chapters</option> or <option>--chapter-charset</option>. Examples for options applying to a single track are <option>--default-duration</option> or <option>--language</option>.
de: 1つの入力ファイルのみ、もしくは入力ファイル中の1つのトラックのみに影響するオプション。これらのオプションは全て、コマンドラインでその後ろに続く入力ファイルに適用されます。同じ入力ファイル（または同じ入力ファイル中のトラック）に適用される全てのオプションは、その入力ファイルのファイル名の前に書きさえすれば、どんな順番でも構いません。1つの入力ファイルに適用されるオプションの例を挙げると、<option>--no-chapters</option>や<option>--chapter-charset</option>などがあります。1つのトラックのみに適用されるオプションには、例えば<option>--default-duration</option>や<option>--language</option>があります。

note: type: Content of: <refentry><refsect1><para>
en: The options are processed from left to right. If an option appears multiple times within the same scope then the last occurence will be used. Therefore the title will be set to &quot;Something else&quot; in the following example:
de: オプションは左から右へと処理されます。もし同じスコープ内に1つのオプションが2回以上出てきた場合には、最後のものが使われます。よって、次の例ではタイトルは&quot;Something else&quot;に設定されます。

note: type: Content of: <refentry><refsect1><para>
en: The following example shows that using the <option>--language</option> option twice is OK because they're used in different scopes. Even though they apply to the same track ID they apply to different input files and therefore have different scopes:
de: 次の例は、違うスコープ内で使われているので<option>--language</option>オプションを2回使ってもよいということを示しています。それらは同じトラックIDに適用されますが、違う入力ファイルに適用されるので違うスコープを持っているのです。

note: type: Content of: <refentry><refsect1><title>
en: Examples
de: 例

note: type: Content of: <refentry><refsect1><para>
en: Let's assume you have a file called MyMovie.avi and the audio track in a separate file, e.g. '<literal>MyMovie.wav</literal>'. First you want to encode the audio to &oggvorbis;:
de: あなたは、 MyMovie.avi というファイルを持っていて、またオーディオトラックが別の、例えば '<literal>MyMovie.wav</literal>'というファイルに入っているとします。あなたは、まず音声を&oggvorbis;でエンコードしたいと思います。

note: type: Content of: <refentry><refsect1><para>
en: After a couple of minutes you can join video and audio:
de: 数分後、ビデオとオーディオを結合できます。

note: type: Content of: <refentry><refsect1><para>
en: If your <abbrev>AVI</abbrev> already contains an audio track then it will be copied as well (if &mkvmerge; supports the audio format). To avoid that simply do
de: <abbrev>AVI</abbrev>ファイルが既にオーディオトラックを持っていた場合(そしてそのフォーマットを&mkvmerge;がサポートしていた場合)、そのトラックもコピーされます。これを避けるには、下のようにしてください。

note: type: Content of: <refentry><refsect1><para>
en: After some minutes of consideration you rip another audio track, e.g.  the director's comments or another language to '<literal>MyMovie-add-audio.wav</literal>'.  Encode it again and join it up with the other file:
de: ちょっと考えて、あなたはもうひとつのオーディオトラック(例えばオーディオコメンタリや吹替えなど)を'<literal>MyMovie-add-audio.wav</literal>にリッピングしました。再びエンコードして、新しいファイルにまとめます。

note: type: Content of: <refentry><refsect1><para>
en: The same result can be achieved with
de: 同じことは、次のようにしても可能です。

note: type: Content of: <refentry><refsect1><para>
en: Now fire up <productname>mplayer</productname> and enjoy. If you have multiple audio tracks (or even video tracks) then you can tell <productname>mplayer</productname> which track to play with the '<option>-vid</option>' and '<option>-aid</option>' options. These are 0-based and do not distinguish between video and audio.
de: あとは<productname>mplayer</productname>を立ち上げて動画を楽しむだけです。もし、複数のオーディオトラック(もしかするとビデオトラックも)がある場合は、再生するトラックを'<option>-vid</option>'と'<option>-aid</option>'オプションで<productname>mplayer</productname>に指定できます。ゼロベースで、ビデオとオーディオの区別をしないIDを指定します。

note: type: Content of: <refentry><refsect1><para>
en: If you need an audio track synchronized you can do that easily. First find out which track ID the Vorbis track has with
de: もし、オーディオトラックの同期をとる必要がある場合も、簡単にとることができます。まず、次のようにしてVorbisトラックのトラックIDを取得します。

note: type: Content of: <refentry><refsect1><para>
en: Now you can use that ID in the following command line:
de: 次に、このIDを使って、次のようなコマンドラインを実行します。

note: type: Content of: <refentry><refsect1><para>
en: This would add 200ms of silence at the beginning of the audio track with the ID <constant>12345</constant> taken from '<literal>outofsync.ogg</literal>'.
de: 上のようにすると、'<literal>outofsync.ogg</literal>'に入っている、IDが <constant>12345</constant> のオーディオトラックの最初に200msの無音を挿入します。

note: type: Content of: <refentry><refsect1><para>
en: Some movies start synced correctly but slowly drift out of sync. For these kind of movies you can specify a delay factor that is applied to all timestamps -- no data is added or removed. So if you make that factor too big or too small you'll get bad results. An example is that an episode I transcoded was <constant>0.2</constant> seconds out of sync at the end of the movie which was <constant>77340</constant> frames long. At <constant>29.97fps</constant> <constant>0.2</constant> seconds correspond to approx. <constant>6</constant> frames. So I did
de: 最初は同期がとれているのにだんだんとずれていく動画もあります。このような動画には、全てのタイムコードに適用される遅れ係数を指定することができます。データは追加も削除もされないので、あまり大きな、またはあまりに小さな係数を指定するとまずい結果になるでしょう。例として、私が変換したある動画は、全長が<constant>77340</constant>フレームで、最終的に<constant>0.2</constant>秒ずれていました。<constant>29.97fps</constant>では、<constant>0.2</constant>は約<constant>6</constant>フレームに相当します。よって、私は次のようなコマンドを実行しました。

note: type: Content of: <refentry><refsect1><para>
en: The result was fine.
de: 結果は良好でした。

note: type: Content of: <refentry><refsect1><para>
en: The sync options can also be used for subtitles in the same manner.
de: 同期オプションは字幕にも同様に使用できます。

note: type: Content of: <refentry><refsect1><para>
en: For text subtitles you can either use some Windows software (like <productname>SubRipper</productname>) or the <productname>subrip</productname> package found in <citerefentry><refentrytitle>transcode</refentrytitle><manvolnum>1</manvolnum></citerefentry>'s sources in the '<literal>contrib/subrip</literal>' directory. The general process is:
de: テキスト字幕を生成するには、<productname>SubRipper</productname>のようなWindowsソフトウェアを使用するか、<citerefentry><refentrytitle>transcode</refentrytitle><manvolnum>1</manvolnum></citerefentry>のソースコードの、<literal>contrib/subrip</literal>'ディレクトリの中にある<productname>subrip</productname>パッケージが使用できます。一般的なプロセスは以下の通りです。

note: type: Content of: <refentry><refsect1><orderedlist><listitem><para>
en: extract a raw subtitle stream from the source:
de: ソースから生字幕を抽出:

note: type: Content of: <refentry><refsect1><orderedlist><listitem><para>
en: convert the resulting PGM images to text with gocr:
de: 出力されたPGMイメージをgocrでテキスト化:

note: type: Content of: <refentry><refsect1><orderedlist><listitem><para>
en: spell-check the resulting text files:
de: 出力されたテキストファイルを校正:

note: type: Content of: <refentry><refsect1><orderedlist><listitem><para>
en: convert the text files to a SRT file:
de: テキストファイルをSRTファイルに変換:

note: type: Content of: <refentry><refsect1><para>
en: The resulting file can be used as another input file for &mkvmerge;:
de: 出力されたファイルを&mkvmerge;の入力ファイルとして使用する:

note: type: Content of: <refentry><refsect1><para>
en: If you want to specify the language for a given track then this is easily done. First find out the ISO639-2 code for your language. &mkvmerge; can list all of those codes for you:
de: もし、あるトラックに言語コードを指定したいならば、簡単に指定できます。まず、指定する言語のISO639-2コードを調べます。次のようにすれば&mkvmerge;に全ての言語コードを一覧表示させることができます。

note: type: Content of: <refentry><refsect1><para>
en: Search the list for the languages you need. Let's assume you have put two audio tracks into a &matroska; file and want to set their language codes and that their track IDs are 2 and 3. This can be done with
de: 必要な言語をリストの中から探してください。&matroska;ファイルの中に、二つのオーディオトラックがあり、トラックIDは2と3だとします。この二つに言語コードを指定するには、次のようにします。

note: type: Content of: <refentry><refsect1><para>
en: As you can see you can use the <link linkend="mkvmerge.description.language"><option>--language</option></link> switch multiple times.
de: このように、<link linkend="mkvmerge.description.language"><option>--language</option></link>スイッチを複数回使うことができます。

note: type: Content of: <refentry><refsect1><para>
en: Maybe you'd also like to have the player use the Dutch language as the default language. You also have extra subtitles, e.g. in English and French, and want to have the player display the French ones by default. This can be done with
de: プレイヤーにデフォルトでオランダ語を再生させたいときもあるでしょう。さらに、例えば英語とフランス語の字幕があって、フランス語をデフォルトで再生させたいと仮定します。これは、次のようにすれば可能です。

note: type: Content of: <refentry><refsect1><para>
en: If you do not see the language or default track flags that you've specified in &mkvinfo;'s output then please read the section about <link linkend="mkvmerge.default_values">default values</link>.
de: もし、指定したはずの言語やデフォルトフラグが&mkvinfo;の出力に見当たらない場合は、<link linkend="mkvmerge.default_values">デフォルト値</link>のセクションを参照してください。

note: type: Content of: <refentry><refsect1><para>
en: Turn off the compression for an input file.
de: 入力ファイルの圧縮をオフにします。

note: type: Content of: <refentry><refsect1><title>
en: Track IDs
de: トラックID

note: type: Content of: <refentry><refsect1><para>
en: Some of the options for &mkvmerge; need a track ID to specify which track they should be applied to.  Those track IDs are printed by the readers when demuxing the current input file, or if &mkvmerge; is called with the <link linkend="mkvmerge.description.identify"><option>--identify</option></link> option.  An example for such output:
de: &mkvmerge;のオプションの中には、どのトラックに適用するかを特定するために、トラックIDを指定する必要なものがあります。このトラックIDは、入力ファイルがdemuxされる際に表示されるほか、&mkvmerge;に<link linkend="mkvmerge.description.identify"><option>--identify</option></link>オプションを指定して表示させることもできます。この場合の出力は次のようになります。

note: type: Content of: <refentry><refsect1><para>
en: Do not confuse the track IDs that are assigned to the tracks that are placed in the output MKV file with the track IDs of the input files. Only the input file track IDs are used for options needing these values.
de: 出力されるMKVファイルの中に配置されるトラックに割り当てられるトラックIDと、入力ファイルのトラックIDを混同しないでください。これらの値が必要なオプションに使われるのは、入力ファイルのトラックIDだけです。

note: type: Content of: <refentry><refsect1><para>
en: Also note that each input file has its own set of track IDs. Therefore the track IDs for file '<filename>file1.ext</filename>' as reported by '<literal>mkvmerge --identify</literal>' do not change no matter how many other input files are there or in which position '<filename>file1.ext</filename>' is used.
de: また、各入力ファイルは、それ固有のトラックIDの組を持っていることにも注意してください。従って、'<literal>mkvmerge --identify</literal>'で報告される'<filename>file1.ext</filename>'のトラックIDは、他にいくつ入力ファイルがあっても、また、'<filename>file1.ext</filename>'がどの位置で使われようとも、変わることはありません。

note: type: Content of: <refentry><refsect1><para>
en: Track IDs are assigned like this:
de: トラックIDは次のように割り当てられます:

note: type: Content of: <refentry><refsect1><itemizedlist><listitem><para>
en: <abbrev>AVI</abbrev> files: The video track has the ID 0. The audio tracks get IDs in ascending order starting at 1.
de: <abbrev>AVI</abbrev>ファイル: ビデオトラックのIDは0になります。オーディオトラックのIDは1から昇順に割り当てられます。

note: type: Content of: <refentry><refsect1><itemizedlist><listitem><para>
en: <abbrev>AAC</abbrev>, <abbrev>AC3</abbrev>, <abbrev>MP3</abbrev>, <abbrev>SRT</abbrev> and <abbrev>WAV</abbrev> files: The one 'track' in that file gets the ID 0.
de: <abbrev>AAC</abbrev>、<abbrev>AC3</abbrev>、<abbrev>MP3</abbrev>、<abbrev>SRT</abbrev>、及び<abbrev>WAV</abbrev>ファイル: ファイル中の唯一のトラックがID 0 を割り当てられます。

note: type: Content of: <refentry><refsect1><itemizedlist><listitem><para>
en: Most other files: The track IDs are assigned in order the tracks are found in the file starting at 0.
de: その他の殆どのファイル：トラックIDは、トラックがファイル中で見つかった順番に0から割り当てられます。

note: type: Content of: <refentry><refsect1><para>
en: The special track ID '<constant>-1</constant>' is a wild card and applies the given switch to all tracks that are read from an input file.
de: '<constant>-1</constant>'は特殊で、そのスイッチが入力ファイルから読み込まれる全てのトラックに適用されることを示します。

note: type: Content of: <refentry><refsect1><para>
en: The options that use the track IDs are the ones whose description contains '<literal>TID</literal>'.  The following options use track IDs as well: <option>--audio-tracks</option>, <option>--video-tracks</option>, <option>--subtitle-tracks</option>, <option>--button-tracks</option> and <option>--track-tags</option>.
de: トラックIDを使用するオプションの説明には、'<literal>TID</literal>'が含まれています。また、<option>--audio-tracks</option>、<option>--video-tracks</option>、<option>--subtitle-tracks</option>、<option>--button-tracks</option>及び<option>--track-tags</option>オプションもトラックIDを使用します。

note: type: Content of: <refentry><refsect1><title>
en: Text files and character set conversions
de: テキストファイルと文字コード変換

note: type: Content of: <refentry><refsect1><note><para>
en: This section applies to all programs in MKVToolNix even if it only mentions &mkvmerge;.
de: このセクションは、暗黙のうちに&mkvmerge;だけでなくMKVToolNixの全てのプログラムにあてはまります。

note: type: Content of: <refentry><refsect1><para>
en: All text in a &matroska; file is encoded in UTF-8. This means that &mkvmerge; has to convert every text file it reads as well as every text given on the command line from one character set into UTF-8. In return this also means that &mkvmerge;'s output has to be converted back to that character set from UTF-8, e.g. if a non-English translation is used with <link linkend="mkvmerge.description.ui_language"><option>--ui-language</option></link> or for text originating from a &matroska; file.
de: &matroska;ファイルに格納されているテキストの文字コードは全てUTF-8です。よって、&mkvmerge;がテキストファイルを読み込む際には全てをUTF-8に文字コード変換する必要があります。代わりに、&mkvmerge;が例えば<link linkend="mkvmerge.description.ui_language"><option>--ui-language</option></link>によって非英語翻訳が使用される際や、&matroska;ファイルに格納されていたテキストを出力する際には、UTF-8から指定された文字コードに変換すればよいということになります。

note: type: Content of: <refentry><refsect1><para>
en: &mkvmerge; does this conversion automatically based on the presence of a <foreignphrase>byte order marker</foreignphrase> (short: <abbrev>BOM</abbrev>) or the system's current locale. How the character set is inferred from the locale depends on the operating system that &mkvmerge; is run on.
de: &mkvmerge;はこの変換を<foreignphrase>バイト・オーダー・マーク</foreignphrase>(<abbrev>BOM</abbrev>)の有無、又はシステムのロケールに基づいて自動的に行ないます。ロケールからどのように文字コードが推測されるかは、&mkvmerge;を実行するシステムに依存します。

note: type: Content of: <refentry><refsect1><para>
en: Text files that start with a BOM are already encoded in one representation of UTF. &mkvmerge; supports the following five modes: UTF-8, UTF-16 Little and Big Endian, UTF-32 Little and Big Endian. Text files with a BOM are automatically converted to UTF-8. Any of the parameters that would otherwise set the character set for such a file (e.g. <link linkend="mkvmerge.description.sub_charset"><option>--sub-charset</option></link>) is silently ignored.
de: BOMで始まるテキストファイルは、既にUTFエンコーディングの一種でエンコードされています。&mkvmerge;はUTF-8、UTF-16リトルエンディアン及びビッグエンディアン、UTF-32リトルエンディアン及びビッグエンディアンの五つのモードをサポートします。BOMで始まるテキストファイルは自動的にUTF-8に変換されます。この場合、テキストファイルの文字コードを指定するパラメータ(例: <link linkend="mkvmerge.description.sub_charset"><option>--sub-charset</option></link>)は全て黙殺されます。

note: type: Content of: <refentry><refsect1><para>
en: On Unix-like systems &mkvmerge; uses the <citerefentry><refentrytitle>setlocale</refentrytitle><manvolnum>3</manvolnum></citerefentry> system call which in turn uses the environment variables <varname>LANG</varname>, <varname>LC_ALL</varname> and <varname>LC_CYPE</varname>. The resulting character set is often one of UTF-8 or the ISO-8859-* family and is used for all text file operations and for encoding strings on the command line and for output to the console.
de: UNIX系システム上では、&mkvmerge;は<citerefentry><refentrytitle>setlocale</refentrytitle><manvolnum>3</manvolnum></citerefentry>システムコールを使うので、<varname>LANG</varname>、<varname>LC_ALL</varname>及び<varname>LC_CYPE</varname>環境変数を使用します。大抵は、UTF-8かISO-8859-*ファミリのどれかが全てのテキストファイルとコマンドライン文字列の処理、及びコンソールへの出力の文字コードとして使用されます。

note: type: Content of: <refentry><refsect1><para>
en: On Windows there are actually two different character sets that &mkvmerge; uses due to the way the Windows shell program <command>cmd.exe</command> is implemented. The first character set is determined by a call to the <function>GetACP()</function> system call. This character set is used as the default for text file conversions and for all elements displayed by the <abbrev>GUI</abbrev> programs in the MKVToolNix package.
de: Windowsでは、<command>cmd.exe</command>Windowsシェルプログラムの実装方式のために、&mkvmerge;は実は二つの異なる文字コードを使用します。一つ目は<function>GetACP()</function>システムコールによって決定される文字コードです。この文字コードはテキストファイル変換にデフォルトで使用され、MKVToolNixパッケージに含まれる<abbrev>GUI</abbrev>プログラムで表示される全ての文字列に適用されます。

note: type: Content of: <refentry><refsect1><para>
en: Another charset may be used if <command>cmd.exe</command> is used. However, reading the command line is done with the <function>GetCommandLineW()</function> function which already returns a Unicode string. Therefore the option <option>--command-line-charset</option> is ignored on Windows.  Output to the console is done with the <function>WriteConsoleW()</function> function. Therefore the option <option>--output-charset</option> is only used on Windows if the output is redirected with <option>--redirect-output</option>.
de: <command>cmd.exe</command>を使用した場合、もう1つの文字コードが使用されるかもしれません。しかし、コマンドラインの読み込みは、既にユニコード文字列を返している<function>GetCommandLineW()</function>関数によってなされます。よって、<option>--command-line-charset</option>オプションはWindowsでは無視されます。コンソールへの出力は<function>WriteConsoleW()</function>関数によってなされます。よって、<option>--output-charset</option>オプションは、Windows上では<option>--redirect-output</option>で出力がリダイレクトされた場合のみ使用されます。

note: type: Content of: <refentry><refsect1><para>
en: The following options exist that allow specifying the character sets:
de: 次のような文字コードを指定するオプションがあります。

note: type: Content of: <refentry><refsect1><itemizedlist><listitem><para>
en: <link linkend="mkvmerge.description.sub_charset"><option>--sub-charset</option></link> for text subtitle files and for text subtitle tracks stored in container formats for which the character set cannot be determined unambiguously (e.g. Ogg files),
de: <link linkend="mkvmerge.description.sub_charset"><option>--sub-charset</option></link>は、テキスト字幕ファイルの文字コードと、他のコンテナに格納されたテキスト字幕トラックの文字コードが曖昧さなく決定できない場合(例: Oggファイル)の文字コードを指定します。

note: type: Content of: <refentry><refsect1><itemizedlist><listitem><para>
en: <link linkend="mkvmerge.description.chapter_charset"><option>--chapter-charset</option></link> for chapter text files and for chapters and file titles stored in container formats for which the character set cannot be determined unambiguously (e.g. Ogg files for chapter information, track and file titles etc; MP4 files for chapter information),
de: <link linkend="mkvmerge.description.chapter_charset"><option>--chapter-charset</option></link>は、チャプタテキストファイルの文字コードと、他のコンテナフォーマットに格納されているチャプタ及びタイトルの文字コードを曖昧さなく決定できない場合(例: Oggファイルのチャプタ情報、トラックとファイルのタイトル等、及びMP4ファイルのチャプタ情報)の文字コードを指定します。

note: type: Content of: <refentry><refsect1><itemizedlist><listitem><para>
en: <link linkend="mkvmerge.description.command_line_charset"><option>--command-line-charset</option></link> for all strings on the command line,
de: <link linkend="mkvmerge.description.command_line_charset"><option>--command-line-charset</option></link>は全てのコマンドライン文字列の文字コードを指定します。

note: type: Content of: <refentry><refsect1><itemizedlist><listitem><para>
en: <link linkend="mkvmerge.description.output_charset"><option>--output-charset</option></link> for all strings written to the console or to a file if the output has been redirected with the <link linkend="mkvmerge.description.redirect_output"><option>--redirect-output</option></link> option.
de: <link linkend="mkvmerge.description.output_charset"><option>--output-charset</option></link>はコンソールに出力される文字列の文字コード及び、<link linkend="mkvmerge.description.redirect_output"><option>--redirect-output</option></link>オプションによりファイルに出力がリダイレクトされている場合、そのファイルの文字列の文字コードを指定します。

note: type: Content of: <refentry><refsect1><title>
en: Option files
de: オプションファイル：

note: type: Content of: <refentry><refsect1><para>
en: An option file is a file &mkvmerge; can read additional command line arguments from. This can be used in order to circumvent certain limitations of the shell or the operating system when executing external programs like a limited command line length.
de: オプションファイルとは、&mkvmerge;が追加のコマンドラインの引数をそれから読み込むことができるものです。これは、コマンドラインの長さ制限等の、外部プログラムを実行する際のシェルやオペレーティングシステムの特定の制限を回避するために使用することができます。

note: type: Content of: <refentry><refsect1><para>
en: There are several rules regarding option files. Lines whose first non-whitespace character is a hash mark ('<literal>#</literal>') are treated as comments and ignored. White spaces at the start and end of a line will be stripped. Each line must contain exactly one option.
de: オプションファイルに関していくつか規則があります。行で最初の空白文字でない文字がハッシュマーク('<literal>#</literal>')である行はコメントとして扱われ、無視されます。行頭、及び行末の空白文字は取り除かれます。各行には一つずつしかオプションを指定できません。

note: type: Content of: <refentry><refsect1><para>
en: A line not containing anything is also ignored. An empty argument is represented by the line '<literal>#EMPTY#</literal>'.
de: 何も書かれていない行も無視されます。空の引数は、'<literal>#EMPTY#</literal>'という行によって表すことができます。

note: type: Content of: <refentry><refsect1><para>
en: Several chars can be escaped, e.g. if you need to start a non-comment line with '#'. The rules are described in <link linkend="mkvmerge.escaping">the section about escaping text</link>.
de: エスケープすることのできる文字もあります。例えば、コメントではない行を'#'で始める必要のある場合です。そのルールは、<link linkend="mkvmerge.escaping">エスケープ文字についてのセクション</link>で説明されています。

note: type: Content of: <refentry><refsect1><para>
en: Note that backslashes must always be escaped. Hash marks ('#') must be escaped if they should not start a comment.
de: バックスラッシュ（Windows上の日本語フォントでは\記号）は、必ずエスケープされなければなりません。ハッシュマーク（#）は、それがコメントの始まりでなければエスケープされなければなりません。

note: type: Content of: <refentry><refsect1><para>
en: The command line '<command>mkvmerge -o "my file.mkv" -A "a movie.avi" sound.ogg</command>' could be converted into the following option file:
de: '<command>mkvmerge -o "my file.mkv" -A "a movie.avi" sound.ogg</command>'というコマンドラインと同じことは、次のようなオプションファイルによって指定できます。

note: type: Content of: <refentry><refsect1><programlisting>
en: # Write to the file "c:\Matroska\my file.mkv" on Windows.
    -o
    c:\\Matroska\\my file.mkv
    # Set the title to '#65'.
    --title
    \h65
    # Only take the video from "a movie.avi".
    -A
    a movie.avi
    sound.ogg
de: # Windowsでは、"my file.mkv" に書き込む。
    -o
    c:\\Matroska\\my file.mkv
    # タイトルを'#65'に設定する。
    --title
    \h65
    # "a movie.avi" からビデオトラックのみを取り出す。
    -A
    a movie.avi
    sound.ogg

note: type: Content of: <refentry><refsect1><title>
en: Subtitles
de: 字幕

note: type: Content of: <refentry><refsect1><para>
en: There are several text and bitmap subtitle formats that can be embedded into &matroska;. Text subtitles must be recoded to UTF-8 so that they can be displayed correctly by a player (see the section about <link linkend="mkvmerge.text_files_and_charsets"> text files and character sets</link> for an explanation how &mkvmerge; converts between character sets). Kate subtitles are already encoded in UTF-8 and do not have to be re-encoded.
de: &matroska;に埋め込むことのできるテキスト及びビットマップ字幕フォーマットがいくつかあります。テキスト字幕は、プレイヤーで正しく表示されるためにUTF-8で保存されなればなりません(&mkvmerge;の文字コード変換については<link linkend="mkvmerge.text_files_and_charsets">テキストファイルと文字コード</link>のセクションを参照してください)。Kate字幕は既にUTF-8でエンコードされているので、再変換する必要はありません。

note: type: Content of: <refentry><refsect1><para>
en: The following subtitle formats are supported at the moment:
de: 現在、次の字幕フォーマットがサポートされています。

note: type: Content of: <refentry><refsect1><itemizedlist><listitem><para>
en: Subtitle Ripper (SRT) files
de: SubRipテキスト字幕形式(SRT)ファイル

note: type: Content of: <refentry><refsect1><itemizedlist><listitem><para>
en: Substation Alpha (SSA) / Advanced Substation Alpha scripts (ASS)
de: Substation Alpha (SSA) / Advanced Substation (ASS) 字幕

note: type: Content of: <refentry><refsect1><itemizedlist><listitem><para>
en: Universal Subtitle Format (USF) files
de: Universal Subtitle Format (USF)ファイル

note: type: Content of: <refentry><refsect1><itemizedlist><listitem><para>
en: OggKate streams
de: OggKateストリーム

note: type: Content of: <refentry><refsect1><itemizedlist><listitem><para>
en: VobSub bitmap subtitle files
de: VobSubビットマップ字幕

note: type: Content of: <refentry><refsect1><itemizedlist><listitem><para>
en: PGS bitmap subtitle files as found on BluRay discs
de: ブルーレイディスクで見られるようなPGSビットマップ字幕ファイル

note: type: Content of: <refentry><refsect1><title>
en: File linking
de: ファイル紐付け

note: type: Content of: <refentry><refsect1><para>
en: &matroska; supports file linking which simply says that a specific file is the predecessor or successor of the current file. To be precise, it's not really the files that are linked but the &matroska; segments. As most files will probably only contain one &matroska; segment the following explanations use the term 'file linking' although 'segment linking' would be more appropriate.
de: &matroska;はファイル紐付けをサポートします。ファイル紐付けとは、単純に現在のファイルの前の、又は次のファイルを指定する機能です。正確に言うと、本当に紐付けされるのはファイルではなく&matroska;セグメントです。ほとんどのファイルは&matroska;セグメントを一つしか持たないので、以降の説明ではより正確な'セグメント紐付け'という用語ではなく、'ファイル紐付け'という用語を使用します。

note: type: Content of: <refentry><refsect1><para>
en: Each segment is identified by a unique 128 bit wide segment UID. This UID is automatically generated by &mkvmerge;. The linking is done primarily via putting the segment UIDs (short: <abbrev>SID</abbrev>) of the previous/next file into the segment header information. &mkvinfo; prints these <abbrev>SIDs</abbrev> if it finds them.
de: 各セグメントはユニークな128bit幅のセグメントUIDを持ちます。このUIDは&mkvmerge;が自動的に生成します。紐付けは基本的にセグメントUID(略して<abbrev>SID</abbrev>)をヘッダ情報の中に挿入することで行われます。&mkvinfo;はこの<abbrev>SID</abbrev>を、存在する場合は表示します。

note: type: Content of: <refentry><refsect1><para>
en: If a file is split into several smaller ones and linking is used then the timecodes will not start at 0 again but will continue where the last file has left off. This way the absolute time is kept even if the previous files are not available (e.g. when streaming). If no linking is used then the timecodes should start at 0 for each file. By default &mkvmerge; does not use file linking. If you want that you can turn it on with the <option>--link</option> option. This option is only useful if splitting is activated as well.
de: もしひとつのファイルがいくつかの小さなファイルに分割されて紐付けされる場合、タイムコードは0から始まらず、前のファイルの続きから始まります。この方式では、前のファイルが無い場合も絶対時間が保たれます(例: ストリーミングを使用している際)。もし、紐付けが使用されない場合、タイムコードは各ファイルで0から始まります。デフォルトでは&mkvmerge;はファイル紐付けを使用しません。ファイル紐付けを使用したい場合は、<option>--link</option>オプションを使用する必要があります。このオプションはファイル分割が有効な場合以外には無効です。

note: type: Content of: <refentry><refsect1><para>
en: Regardless of whether splitting is active or not the user can tell &mkvmerge; to link the produced files to specific <abbrev>SIDs</abbrev>. This is achieved with the options <option>--link-to-previous</option> and <option>--link-to-next</option>.  These options accept a segment <abbrev>SID</abbrev> in the format that &mkvinfo; outputs: 16 hexadecimal numbers between <constant>0x00</constant> and <constant>0xff</constant> prefixed with '<literal>0x</literal>' each, e.g. '<code>0x41 0xda 0x73 0x66 0xd9 0xcf 0xb2 0x1e 0xae 0x78 0xeb 0xb4 0x5e 0xca 0xb3 0x93</code>'. Alternatively a shorter form can be used: 16 hexadecimal numbers between <constant>0x00</constant> and <constant>0xff</constant> without the '<literal>0x</literal>' prefixes and without the spaces, e.g.  '<code>41da7366d9cfb21eae78ebb45ecab393</code>'.
de: ファイル分割が有効か無効かに関わらず、ユーザは&mkvmerge;に、生成したファイルを特定の<abbrev>SID</abbrev>に紐付けすることができます。これは<option>--link-to-previous</option>オプションと<option>--link-to-next</option>オプションにより可能です。これらのオプションは&mkvinfo;が出力するフォーマット(16個の<constant>0x00</constant>から<constant>0xff</constant>までの、'<literal>0x</literal>'を頭につけた16進数)の<abbrev>SID</abbrev>を受け付けます(例: '<code>0x41 0xda 0x73 0x66 0xd9 0xcf 0xb2 0x1e 0xae 0x78 0xeb 0xb4 0x5e 0xca 0xb3 0x93</code>')。もしくは短い形式（'<literal>0x</literal>'及び数字の間のスペースを省いた<constant>0x00</constant>から<constant>0xff</constant>までの16進数の数字）を指定することもできます。例: '<code>41da7366d9cfb21eae78ebb45ecab393</code>'

note: type: Content of: <refentry><refsect1><para>
en: If splitting is used then the first file is linked to the <abbrev>SID</abbrev> given with <option>--link-to-previous</option> and the last file is linked to the <abbrev>SID</abbrev> given with <option>--link-to-next</option>. If splitting is not used then the one output file will be linked to both of the two <abbrev>SIDs</abbrev>.
de: もしファイル分割が有効の場合、最初のファイルが<option>--link-to-previous</option>オプションで指定した<abbrev>SID</abbrev>に紐付けされ、最後のファイルが<option>--link-to-next</option>オプションで指定した<abbrev>SID</abbrev>に紐付けされます。ファイル分割が無効の場合、一つの出力ファイルが両方の<abbrev>SID</abbrev>に紐付けされます。

note: type: Content of: <refentry><refsect1><title>
en: Default values
de: デフォルト値

note: type: Content of: <refentry><refsect1><para>
en: The &matroska; specification states that some elements have a default value. Usually an element is not written to the file if its value is equal to its default value in order to save space. The elements that the user might miss in &mkvinfo;'s output are the <parameter>language</parameter> and the <parameter>default track flag</parameter> elements.  The default value for the <parameter>language</parameter> is English ('<literal>eng</literal>'), and the default value for the <parameter>default track flag</parameter> is <parameter>true</parameter>. Therefore if you used <option>--language 0:eng</option> for a track then it will not show up in &mkvinfo;'s output.
de: &matroska;ファイルの仕様には、デフォルト値を持つエレメントの存在が明記されています。通常、デフォルト値と等しい値をもつエレメントはファイルサイズを抑えるためファイルに書き込まれません。&mkvinfo;では表示されないかもしれないエレメントは、<parameter>言語</parameter>と<parameter>デフォルトトラックフラグ</parameter>エレメントです。<parameter>言語</parameter>エレメントのデフォルト値は英語('<literal>eng</literal>')で、<parameter>デフォルトトラックフラグ</parameter>エレメントのデフォルト値は<parameter>true</parameter>です。よって、あるトラックに<option>--language: 0:eng</option>を指定した場合には、&mkvinfo;の出力には現れません。

note: type: Content of: <refentry><refsect1><para>
en: Maybe you also want to keep some photos along with your &matroska; file, or you're using <abbrev>SSA</abbrev> subtitles and need a special <productname>TrueType</productname> font that's really rare. In these cases you can attach those files to the &matroska; file. They will not be just appended to the file but embedded in it. A player can then show those files (the 'photos' case) or use them to render the subtitles (the '<productname>TrueType</productname> fonts' case).
de: &matroska;ファイルに写真を入れておきたいということや、非常に稀でしょうが<abbrev>SSA</abbrev>字幕を使っていて<productname>TrueType</productname>フォントを使用したいということがあるかもしれません。このような場合には、&matroska;ファイルにファイルを添付することができます。添付されるファイルは&matroska;ファイルにただ単純に追加されるのではなく、埋め込まれます。よって、プレイヤーはこれらのファイルを表示したり(写真の場合)、字幕を描画するのに使用したり(フォントの場合)できます。

note: type: Content of: <refentry><refsect1><para>
en: Here's an example how to attach a photo and a <productname>TrueType</productname> font to the output file:
de: 下に、出力ファイルに写真と<productname>TrueType</productname>フォントを添付する方法の例を示します。

note: type: Content of: <refentry><refsect1><para>
en: If a &matroska; containing attachments file is used as an input file then &mkvmerge; will copy the attachments into the new file. The selection which attachments are copied and which are not can be changed with the options <link linkend="mkvmerge.description.attachments"><option>--attachments</option></link> and <link linkend="mkvmerge.description.no_attachments"><option>--no-attachments</option></link>.
de: 添付ファイルつきの&matroska;ファイルが入力ファイルとして使われた場合、&mkvmerge;はその添付ファイルを新しいファイルにコピーします。添付ファイルのコピーの有無は、<link linkend="mkvmerge.description.attachments"><option>--attachments</option></link>及び<link linkend="mkvmerge.description.no_attachments"><option>--no-attachments</option></link>オプションを使って切り替えることができます。

note: type: Content of: <refentry><refsect1><para>
en: The &matroska; chapter system is more powerful than the old known system used by <abbrev>OGM</abbrev> files. The full specifications can be found at <ulink url="http://www.matroska.org/">the &matroska; website</ulink>.
de: &matroska;チャプタシステムは、<abbrev>OGM</abbrev>ファイルで使用されていた従来のシステムより強力です。その仕様の全ては、<ulink url="http://www.matroska.org">&matroska;のウェブサイト</ulink>に記されています。

note: type: Content of: <refentry><refsect1><para>
en: &mkvmerge; supports two kinds of chapter files as its input. The first format, called '<foreignphrase>simple chapter format</foreignphrase>', is the same format that the <abbrev>OGM</abbrev> tools expect. The second format is a &xml; based chapter format which supports all of &matroska;'s chapter functionality.
de: &mkvmerge;は2種類のチャプタファイルを入力としてサポートしています。一つ目は'<foreignphrase>シンプルチャプタファイル</foreignphrase>'と呼ばれるもので、<abbrev>OGM</abbrev> toolsが想定しているものと同じフォーマットです。二つ目は&xml;ベースのチャプタフォーマットで、&matroska;のチャプタ機能の全てをサポートしています。

note: type: Content of: <refentry><refsect1><refsect2><title>
en: The simple chapter format
de: シンプルチャプタフォーマット

note: type: Content of: <refentry><refsect1><refsect2><para>
en: This formmat consists of pairs of lines that start with '<literal>CHAPTERxx=</literal>' and '<literal>CHAPTERxxNAME=</literal>' respectively. The first one contains the start timecode while the second one contains the title. Here's an example:
de: このフォーマットは、'<literal>CHAPTERxx=</literal>'で始まる行と'<literal>ChapterxxNAME=</literal>'で始まる行のペアから成ります。前者の行は開始タイムコードを含み、後者はタイトルを含みます。下に例を示します。

note: type: Content of: <refentry><refsect1><refsect2><para>
en: &mkvmerge; will transform every pair or lines into one &matroska; <classname>ChapterAtom</classname>. It does not set any <classname>ChapterTrackNumber</classname> which means that the chapters all apply to all tracks in the file.
de: &mkvmerge;は各ペア、もしくは行を、一個の&matroska;<classname>ChapterAtom</classname>に変換します。<classname>ChapterTrackNumber</classname>は設定しないので、全てのトラックにチャプタは適用されます。

note: type: Content of: <refentry><refsect1><refsect2><para>
en: As this is a text file character set conversion may need to be done. See the section about <link linkend="mkvmerge.text_files_and_charsets"> text files and character sets</link> for an explanation how &mkvmerge; converts between character sets.
de: このときにテキストファイルの文字コードが必要になります。&mkvmerge;の文字コード変換については<link linkend="mkvmerge.text_files_and_charsets">テキストファイルと文字コード</link>のセクションを参照してください。

note: type: Content of: <refentry><refsect1><refsect2><title>
en: The &xml; based chapter format
de: &xml;チャプタフォーマット

note: type: Content of: <refentry><refsect1><refsect2><para>
en: The &xml; based chapter format looks like this example:
de: &xml;チャプタフォーマットの例を以下に示します。

note: type: Content of: <refentry><refsect1><refsect2><para>
en: With this format three things are possible that are not possible with the simple chapter format:
de: このフォーマットでは、シンプルチャプタフォーマットでは不可能な、3つのことが可能です。

note: type: Content of: <refentry><refsect1><refsect2><orderedlist><listitem><para>
en: The timestamp for the end of the chapter can be set,
de: チャプタの終了タイムコードを指定できます。

note: type: Content of: <refentry><refsect1><refsect2><orderedlist><listitem><para>
en: chapters can be nested,
de: ネストしたチャプタを作成できます。

note: type: Content of: <refentry><refsect1><refsect2><orderedlist><listitem><para>
en: the language and country can be set.
de: 言語及び国を設定できます。

note: type: Content of: <refentry><refsect1><refsect2><para>
en: The mkvtoolnix distribution contains some sample files in the <filename>doc</filename> subdirectory which can be used as a basis.
de: mkvtoolnixは、テンプレートとなるサンプルファイルと一緒に配布されています。サンプルファイルは<filename>doc</filename>サブディレクトリの中にあります。

note: type: Content of: <refentry><refsect1><para>
en: The following lists the supported XML tags, their data types and, where appropriate, the valid range for their values:
de: 以下にサポートされているXMLタグ、そのデータタイプ、そして適切な場所では、その値の有効な範囲を挙げます：

note: type: Content of: <refentry><refsect1><refsect2><title>
en: General notes
de: 注意

note: type: Content of: <refentry><refsect1><refsect2><para>
en: When splitting files &mkvmerge; will correctly adjust the chapters as well. This means that each file only includes the chapter entries that apply to it, and that the timecodes will be offset to match the new timecodes of each output file.
de: &mkvmerge;は出力ファイルを分割する際、チャプタも適切に処理します。つまり、分割された各ファイルはそのファイルに関係するチャプタのみを含み、タイムコードには適切なオフセットがかかります。

note: type: Content of: <refentry><refsect1><refsect2><para>
en: &mkvmerge; is able to copy chapters from &matroska; source files unless this is explicitly disabled with the <link linkend="mkvmerge.description.no_chapters"><option>--no-chapters</option></link> option. The chapters from all sources (&matroska; files, Ogg files, <abbrev>MP4</abbrev> files, chapter text files) are usually not merged but end up in separate <classname>ChapterEditions</classname>. Only if chapters are read from several &matroska; or &xml; files that share the same edition UIDs will chapters be merged into a single <classname>ChapterEdition</classname>. If such a merge is desired in other situations as well then the user has to extract the chapters from all sources with &mkvextract; first, merge the &xml; files manually and mux them afterwards.
de: &mkvmerge;は、<link linkend="mkvmerge.description.no_chapters"><option>--no-chapters</option></link>オプションで明示的に無効化されていなければ、&matroska;ソースファイルからチャプタをコピーできます。全てのソース(&matroska;ファイル、Oggファイル、<abbrev>MP4</abbrev>ファイル、チャプタテキストファイル)に由来するチャプタは通常はマージされず、別々の<classname>ChapterEditions</classname>が作成されます。いくつかの&matroska;もしくは&xml;ファイルで、エディションUIDが共有される場合にのみ、チャプタは一つの<classname>ChapterEdition</classname>にマージされます。そのような場合以外でマージを行いたい場合は、ユーザはまず全てのソースから&mkvextract;でチャプタを抽出し、手動で&xml;ファイルをマージした後にMUXを行なわなければなりません。

note: type: Content of: <refentry><refsect1><refsect2><para>
en: &matroska; supports an extensive set of tags that is deprecated and a new, simpler system like it is is used in most other containers: <parameter>KEY=VALUE</parameter>. However, in &matroska; these tags can also be nested, and both the <parameter>KEY</parameter> and the <parameter>VALUE</parameter> are elements of their own. The example file <filename>example-tags-2.xml</filename> shows how to use this new system.
de: &matroska;は廃止予定の拡張可能なタグのセットと、新しい、他のよくあるコンテナで採用されているようなより単純な、<parameter>KEY=VALUE</parameter>というシステムをサポートします。しかし、&matroska;では、これらのタグはネストすることも可能で、さらに<parameter>KEY</parameter>と<parameter>VALUE</parameter>は両方がそれ自信のエレメントです。サンプルファイル<filename>example-tags-2.xml</filename>がこの新しいシステムの使い方の例を示しています。

note: type: Content of: <refentry><refsect1><refsect2><title>
en: Scope of the tags
de: タグのスコープ

note: type: Content of: <refentry><refsect1><refsect2><para>
en: &matroska; tags do not automatically apply to the complete file. They can, but they also may apply to different parts of the file: to one or more tracks, to one or more chapters, or even to a combination of both. The <ulink url="http://matroska.org/technical/specs/index.html">the &matroska; specification</ulink> gives more details about this fact.
de: &matroska;タグは自動的にはファイル全体に適用はされません。適用することもできますが、ファイルの異る部分々々に適用することもできます。一つ、もしくは複数のトラック、一つ、もしくは複数のチャプタ、さらにはその組み合わせにも適用することが可能です。<ulink url="http://matroska.org/technical/specs/index.html">&matroska;の仕様</ulink>に、このことの詳細が記述されています。

note: type: Content of: <refentry><refsect1><refsect2><para>
en: One important fact is that tags are linked to tracks or chapters with the <classname>Targets</classname> &matroska; tag element, and that the UIDs used for this linking are <emphasis>not</emphasis> the track IDs &mkvmerge; uses everywhere. Instead the numbers used are the UIDs which &mkvmerge; calculates automatically (if the track is taken from a file format other than &matroska;) or which are copied from the source file if the track's source file is a &matroska; file. Therefore it is difficult to know which UIDs to use in the tag file before the file is handed over to &mkvmerge;.
de: 重要なことは、タグは<classname>Targets</classname>&matroska;タグエレメントによってトラック及びチャプタにリンクされますが、このリンクの際に使用されるUIDは&mkvmerge;が色々な所で使用するトラックID<emphasis>ではない</emphasis>ことです。その代わりに、&mkvmerge;は自動的に計算したUID(トラックが&matroska;以外のファイルフォーマットから取り出される場合)か、トラックのソースファイルが&matroska;ファイルの場合ソースファイルからコピーされた数字が使用されます。よって、タグファイルが&mkvmerge;に渡される前に、使用されるUIDを知ることは困難です。

note: type: Content of: <refentry><refsect1><refsect2><para>
en: &mkvmerge; knows two options with which you can add tags to &matroska; files: The <link linkend="mkvmerge.description.global_tags"><option>--global-tags</option></link> and the <link linkend="mkvmerge.description.tags"><option>--tags</option></link> options. The difference is that the former option, <link linkend="mkvmerge.description.global_tags"><option>--global-tags</option></link>, will make the tags apply to the complete file by removing any of those <classname>Targets</classname> elements mentioned above.  The latter option, <link linkend="mkvmerge.description.tags"><option>--tags</option></link>, automatically inserts the UID that &mkvmerge; generates for the tag specified with the <parameter>TID</parameter> part of the <link linkend="mkvmerge.description.tags"><option>--tags</option></link> option.
de: &mkvmerge;は&matroska;ファイルにタグを追加する二つのオプションを認識します。<link linkend="mkvmerge.description.global_tags"><option>--global-tags</option></link>と<link linkend="mkvmerge.description.tags"><option>--tags</option></link>オプションです。この二つの違いは、前者の<link linkend="mkvmerge.description.global_tags"><option>--global-tags</option></link>は、上述の<classname>Targets</classname>エレメントを全て取り除くことで、タグがファイル全体に適用されるようにします。後者の<link linkend="mkvmerge.description.tags"><option>--tags</option></link>オプションは、&mkvmerge;が of the <link linkend="mkvmerge.description.tags"><option>--tags</option></link>に指定した<parameter>TID</parameter>の示すトラックに対して自動的に計算したUIDを挿入します。

note: type: Content of: <refentry><refsect1><refsect2><title>
en: Example
de: 例

note: type: Content of: <refentry><refsect1><refsect2><para>
en: Let's say that you want to add tags to a video track read from an <abbrev>AVI</abbrev>. <command>mkvmerge --identify file.avi</command> tells you that the video track's ID (do not mix this ID with the UID!) is 0. So you create your tag file, leave out all <classname>Targets</classname> elements and call &mkvmerge;:
de: あなたは、<abbrev>AVI</abbrev>から読み込まれるビデオトラックにタグをつけたいと仮定しましょう。<command>mkvmerge --identify file.avi</command>を実行すると、ビデオトラックのトラックID(このIDをUIDと混同しないでください!)は0であると教えてくれます。よって、あなたは全ての<classname>Targets</classname>エレメントを記入しないタグファイルを作成し、&mkvmerge;を以下のように実行します。

note: type: Content of: <refentry><refsect1><refsect2><title>
en: Tag file format
de: タグファイルフォーマット

note: type: Content of: <refentry><refsect1><refsect2><para>
en: &mkvmerge; supports a &xml; based tag file format. The format is very closely modeled after <ulink url="http://matroska.org/technical/specs/index.html">the &matroska; specification</ulink>. Both the binary and the source distributions of MKVToolNix come with a sample file called <filename>example-tags-2.xml</filename> which simply lists all known tags and which can be used as a basis for real life tag files.
de: &mkvmerge;は&xml;ベースのタグファイルフォーマットをサポートします。このフォーマットは<ulink url="http://matroska.org/technical/specs/index.html">&matroska;の仕様</ulink>に非常に近いデザインになっています。MKVToolNixのバイナリ、及びソースディストリビューションはどちらも、既知のタグをただリストしただけの、実際のタグファイルのテンプレートとして使用できる<filename>example-tags-2.xml</filename>というサンプルファイルを含んでいます。

note: type: Content of: <refentry><refsect1><refsect2><para>
en: The basics are:
de: 基本的には、以下の様な構成です。

note: type: Content of: <refentry><refsect1><refsect2><itemizedlist><listitem><para>
en: The outermost element must be <classname>&lt;Tags&gt;</classname>.
de: 最も外側のエレメントは<classname>&lt;Tags&gt;</classname>でなければなりません。

note: type: Content of: <refentry><refsect1><refsect2><itemizedlist><listitem><para>
en: One logical tag is contained inside one pair of <classname>&lt;Tag&gt;</classname> &xml; tags.
de: 一個の論理タグは<classname>&lt;Tag&gt;</classname>&xml;タグの内部に包含されます。

note: type: Content of: <refentry><refsect1><refsect2><itemizedlist><listitem><para>
en: White spaces directly before and after tag contents are ignored.
de: タグの中身の直前・直後のスペースは無視されます。

note: type: Content of: <refentry><refsect1><refsect2><title>
en: Data types
de: データタイプ

note: type: Content of: <refentry><refsect1><refsect2><para>
en: The new &matroska; tagging system only knows two data types, a UTF-8 string and a binary type. The first is used for the tag's name and the <classname>&lt;String&gt;</classname> element while the binary type is used for the <classname>&lt;Binary&gt;</classname> element.
de: 新しい&matroska;タグシステムは、UTF-8文字列とバイナリの二つのデータタイプしか認識しません。前者はタグの名前と<classname>&lt;String&gt;</classname>エレメントに使用され、後者は<classname>&lt;Binary&gt;</classname>エレメントに使用されます。

note: type: Content of: <refentry><refsect1><refsect2><para>
en: As binary data itself would not fit into a &xml; file &mkvmerge; supports two other methods of storing binary data. If the contents of a &xml; tag starts with '<literal>@</literal>' then the following text is treated as a file name. The corresponding file's content is copied into the &matroska; element.
de: バイナリデータは、そのままでは&xml;ファイルに格納できないので、&mkvmerge;は二つのバイナリデータを格納する方法をサポートします。&xml;タグの中身が'<literal>@</literal>'で始まる場合、そのあとのテキストはファイル名として扱われ、対応するファイルの中身が&matroska;エレメントにコピーされます。

note: type: Content of: <refentry><refsect1><refsect2><para>
en: Otherwise the data is expected to be <foreignphrase>Base64</foreignphrase> encoded. This is an encoding that transforms binary data into a limited set of <abbrev>ASCII</abbrev> characters and is used e.g. in email programs. &mkvextract; will output <foreignphrase>Base64</foreignphrase> encoded data for binary elements.
de: もう一つの方法では、データは<foreignphrase>Base64</foreignphrase>エンコードされる必要があります。これは、バイナリデータを<abbrev>ASCII</abbrev>キャラクタの一部だけで表現するためのエンコードで、例えばEメールなどに使用されています。&mkvextract;は、バイナリエレメントを<foreignphrase>Base64</foreignphrase>エンコードされたデータとして出力します。

note: type: Content of: <refentry><refsect1><refsect2><para>
en: The deprecated tagging system knows some more data types which can be found in the official &matroska; tag specs. As &mkvmerge; does not support this system anymore these types aren't described here.
de: 古いタグシステムは、公式の&matroska;の仕様に示されているように、もっと多くのデータタイプを認識していました。&mkvmerge;はもはやこのシステムをサポートしないので、それらのタイプについてはここでは説明しません。

note: type: Content of: <refentry><refsect1><refsect2><title>
en: Known tags for the XML file format
de: XMLファイルフォーマットで知られているタグ

note: type: Content of: <refentry><refsect1><title>
en: The segment info XML files
de: セグメント情報XMLファイル

note: type: Content of: <refentry><refsect1><para>
en: Other &quot;segment information&quot; header fields can be set via command line options but not via the XML file. This includes e.g. the <option><link linkend="mkvmerge.description.title">--title</link></option> and the <option><link linkend="mkvmerge.description.timecode_scale">--timecode-scale</link></option> options.
de: 他の&quot;segment information&quot;ヘッダフィールドはコマンドラインオプション経由で設定できますが、XMLファイル経由では設定できません。 これはには例えば<option><link linkend="mkvmerge.description.title">--title</link></option>や<option><link linkend="mkvmerge.description.timecode_scale">--timecode-scale</link></option> オプションなどが含まれます。

note: type: Content of: <refentry><refsect1><para>
en: There are other elements that can be set neither via command line options nor via the XML files. These include the following elements: <varname>DateUTC</varname> (also known as the &quot;muxing date&quot;), <varname>MuxingApp</varname>, <varname>WritingApp</varname> and <varname>Duration</varname>. They're always set by &mkvmerge; itself.
de: 他にもコマンドラインオプション経由でもXMLファイル経由でも設定できない要素があります。これらには以下のものが含まれます：<varname>DateUTC</varname> （別名&quot;muxing date&quot;）、<varname>MuxingApp</varname>、<varname>WritingApp</varname>、そして<varname>Duration</varname>です。それらは常に&mkvmerge;自身によって設定されます。

note: type: Content of: <refentry><refsect1><title>
en: &matroska; file layout
de: &matroska;ファイルのレイアウト

note: type: Content of: <refentry><refsect1><para>
en: The &matroska; file layout is quite flexible. &mkvmerge; will render a file in a predefined way. The resulting file looks like this:
de: &matroska;ファイルのレイアウトは非常に柔軟性に富んでいます。&mkvmerge;はあらかじめ定義された方法でファイルを書き出します。出力されたファイルはこのようになります。

note: type: Content of: <refentry><refsect1><para>
en: [EBML head] [segment {meta seek #1} [segment information] [track information] {attachments} {chapters} [cluster 1] {cluster 2} ...  {cluster n} {cues} {meta seek #2} {tags}]
de: [EBMLヘッダ] [セグメント {メタシーク #1} [セグメント情報] [トラック情報] {添付ファイル} {チャプタ} [クラスタ 1] {クラスタ 2} ...  {クラスタ n} {CUE} {メタシーク #2} {タグ}]

note: type: Content of: <refentry><refsect1><para>
en: The elements in curly braces are optional and depend on the contents and options used. A couple of notes:
de: 波括弧でくくられたエレメントは省略可能で、コンテンツと指定されたオプションに依存します。いくつか注釈があります。

note: type: Content of: <refentry><refsect1><itemizedlist><listitem><para>
en: meta seek #1 includes only a small number of level 1 elements, and only if they actually exist: attachments, chapters, cues, tags, meta seek #2. Older versions of &mkvmerge; used to put the clusters into this meta seek element as well. Therefore some imprecise guessing was necessary to reserve enough space. It often failed. Now only the clusters are stored in meta seek #2, and meta seek #1 refers to the meta seek element #2.
de: メタシーク #1は、少数のレベル1エレメント(添付ファイル、チャプタ、CUE、タグ、メタシーク #2)のみを、それらが存在するときにのみ含みます。以前のバージョンの&mkvmerge;は、このメタシークエレメントにクラスタも挿入していました。このため、十分なスペースを確保しておくために不正確な推測が必要で、この推測は多くの場合失敗していました。現在では、クラスタのみはメタシーク #2に格納され、メタシーク #1がメタシークエレメント #2を参照しています。

note: type: Content of: <refentry><refsect1><itemizedlist><listitem><para>
en: Attachment, chapter and tag elements are only present if they were added.
de: 添付ファイル、チャプタ、及びタグエレメントはそれらが存在するときにのみ追加されます。

note: type: Content of: <refentry><refsect1><para>
en: [EBML head] [segment [segment information] [track information] [cluster 1]]
de: [EBMLヘッダ] [セグメント [セグメント情報] [トラック情報] [クラスタ1]]

note: type: Content of: <refentry><refsect1><para>
en: This might be the case for audio-only files.
de: 音声のみのファイルはこのようになるでしょう。

note: type: Content of: <refentry><refsect1><title>
en: External timecode files
de: 外部タイムコードファイル

note: type: Content of: <refentry><refsect1><para>
en: &mkvmerge; allows the user to chose the timecodes for a specific track himself. This can be used in order to create files with variable frame rate video or include gaps in audio. A frame in this case is the unit that &mkvmerge; creates separately per &matroska; block. For video this is exactly one frame, for audio this is one packet of the specific audio type. E.g. for <abbrev>AC3</abbrev> this would be a packet containing <constant>1536</constant> samples.
de: ユーザは、特定のトラックのタイムコードを自分で&mkvmerge;に指定することができます。これは可変フレームレートビデオを含むファイルを作成するときや、オーディオに無音を挿入するときに使用できます。この場合、フレームは&matroska;ブロックを作成する際の単位となります。ビデオでは、これはちょうど1フレームとなり、オーディオではこれは各オーディオタイプの1パケットとなります。例えば、<abbrev>AC3</abbrev>では、これは<constant>1536</constant>サンプルを含む1パケットとなります。

note: type: Content of: <refentry><refsect1><para>
en: Timecode files that are used when tracks are appended to each other must only be specified for the first part in a chain of tracks.  For example if you append two files, v1.avi and v2.avi, and want to use timecodes then your command line must look something like this:
de: 結合されたトラックにタイムコードファイルを指定する場合は、各結合されるトラックチェインの最初の部分にのみ指定してください。例えばv1.avi、v2.aviの二つのファイルを結合し、タイムコードを使用したいときのコマンドラインは次のようになります。

note: type: Content of: <refentry><refsect1><para>
en: There are four formats that are recognized by &mkvmerge;. The first line always contains the version number. Empty lines, lines containing only whitespace and lines beginning with '<literal>#</literal>' are ignored.
de: &mkvmerge;は、4つのフォーマットを認識します。最初の1行は常にバージョン番号を含みます。空行、空白のみを含む行、及び'<literal>#</literal>'で始まる行は無視されます。

note: type: Content of: <refentry><refsect1><refsect2><title>
en: Timecode file format v1
de: タイムコードファイルフォーマット v1

note: type: Content of: <refentry><refsect1><refsect2><para>
en: This format starts with the version line. The second line declares the default number of frames per second.  All following lines contain three numbers separated by commas: the start frame (<constant>0</constant> is the first frame), the end frame and the number of frames in this range. The <abbrev>FPS</abbrev> is a floating point number with the dot '<literal>.</literal>' as the decimal point. The ranges can contain gaps for which the default <abbrev>FPS</abbrev> is used. An example:
de: このフォーマットはバージョン行から始まります。2行目はデフォルトフレームレートを宣言します。残りの全ての行は、コンマで区切られた3つの数字を含みます。開始フレーム(<constant>0</constant>が最初のフレームです)、終了フレーム、そしてこの範囲で適用されるフレームレートです。<abbrev>FPS</abbrev>は、ドット'<literal>.</literal>'を小数点として持つ小数です。フレーム範囲はデフォルト<abbrev>FPS</abbrev>が使用されるギャップを含むこともあります。例を下に示します。

note: type: Content of: <refentry><refsect1><refsect2><title>
en: Timecode file format v2
de: タイムコードファイルフォーマット v2

note: type: Content of: <refentry><refsect1><refsect2><para>
en: In this format each line contains a timecode for the corresponding frame.  This timecode must be given in millisecond precision.  It can be a floating point number, but it doesn't have to be.  You <emphasis>have to</emphasis> give at least as many timecode lines as there are frames in the track.  The timecodes in this file must be sorted.  Example for 25fps:
de: このフォーマットでは、各行は対応するフレームのタイムコードを含みます。このタイムコードはミリ秒単位の精度で指定しなければなりません。小数を指定することができますが、小数でなくてもかまいません。最低でも、トラックに含まれるフレーム数と同数のタイムコード行を含ま<emphasis>なければなりません</emphasis>。このファイル内のタイムコードは整列されていなければなりません。例えば、25fpsでは以下のようになります。

note: type: Content of: <refentry><refsect1><refsect2><title>
en: Timecode file format v3
de: タイムコードファイルフォーマット v3

note: type: Content of: <refentry><refsect1><refsect2><para>
en: In this format each line contains a duration in seconds followed by an optional number of frames per second.  Both can be floating point numbers.  If the number of frames per second is not present the default one is used.  For audio you should let the codec calculate the frame timecodes itself.  For that you should be using <constant>0.0</constant> as the number of frames per second.  You can also create gaps in the stream by using the '<literal>gap</literal>' keyword followed by the duration of the gap.  Example for an audio file:
de: このフォーマットでは、各行は秒単位の持続時間と、省略可能なフレームレートを含みます。この二つは両方とも小数を指定できます。もし、フレームレートが指定されない場合はデフォルトの値が使用されます。オーディオではコーデックにタイムコードを計算させるべきです。このためには、フレームレートとして<constant>0.0</constant>を指定してください。また、'<literal>gap</literal>'キーワードの後に持続時間を指定して、無音を指定することもできます。オーディオファイル用の例を示します。

note: type: Content of: <refentry><refsect1><refsect2><title>
en: Timecode file format v4
de: タイムコードファイルフォーマット v4

note: type: Content of: <refentry><refsect1><refsect2><para>
en: This format is identical to the v2 format.  The only difference is that the timecodes do not have to be sorted.  This format should almost never be used.
de: このフォーマットはv2フォーマットと同一です。唯一の違いは、タイムコードが整列されていなくてもいいという点です。このフォーマットが使われることはほぼ無いでしょう。

note: type: Content of: <refentry><refsect1><para>
en: &mkvmerge; exits with one of three exit codes:
de: &mkvmerge;は下の3つの返り値を返します。

note: type: Content of: <refentry><refsect1><itemizedlist><listitem><para>
en: <constant>0</constant> -- This exit codes means that muxing has completed successfully.
de: <constant>0</constant> -- この返り値はMUXが正常に終了したことを示します。

note: type: Content of: <refentry><refsect1><itemizedlist><listitem><para>
en: <constant>1</constant> -- In this case &mkvmerge; has output at least one warning, but muxing did continue.  A warning is prefixed with the text '<literal>Warning:</literal>'.  Depending on the issues involved the resulting file might be ok or not.  The user is urged to check both the warning and the resulting file.
de: <constant>1</constant> -- この返り値は、一つ以上の警告が出力されましたが、抽出が続行されたことを意味します。警告は '<literal>警告:</literal>' という文字列を先頭につけて出力されます。出力ファイルが無事であるかどうかは、場合によります。出力ファイルを確認することを強く推奨します。

note: type: Content of: <refentry><refsect1><itemizedlist><listitem><para>
en: <constant>2</constant> -- This exit code is used after an error occurred.  &mkvmerge; aborts right after outputting the error message.  Error messages range from wrong command line arguments over read/write errors to broken files.
de: <constant>2</constant> -- この返り値は、エラーが発生し、エラーメッセージを出力した後に&mkvmerge;が処理を中断したことを示します。エラーメッセージは不正なコマンドラインやファイルI/Oエラー、壊れたファイルなど様々です。

note: type: Content of: <refentry><refsect1><para>
en: &mkvmerge; uses the default variables that determine the system's locale (e.g. <varname>LANG</varname> and the <varname>LC_*</varname> family). Additional variables:
de: &mkvmerge;はシステムのロケールを決めるデフォルトの変数（例：<varname>LANG</varname>や<varname>LC_*</varname>系）を使用します。追加の変数は以下の通りです：

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: The content is treated as if it had been passed via the <link linkend="mkvmerge.description.debug"><option>--debug</option></link> option.
de: その内容は、あたかも<link linkend="mkvmerge.description.debug"><option>--debug</option></link>オプション経由で渡されたかのように扱われます。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: The content is treated as if it had been passed via the <link linkend="mkvmerge.description.engage"><option>--engage</option></link> option.
de: その内容は、あたかも<link linkend="mkvmerge.description.engage"><option>--engage</option></link>オプション経由で渡されたかのように扱われます。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: The content is split on white space. The resulting partial strings are treated as if it had been passed as command line options. If you need to pass special characters (e.g. spaces) then you have to escape them (see <link linkend="mkvmerge.escaping">the section about escaping special characters in text</link>).
de: その内容は空白で分割されます。得られた一部の文字列は、あたかもそれがコマンドラインオプションとして渡されたかのように扱われます。もし特殊な文字（例：空白）を渡す必要があるなら、それらをエスケープする必要があります（<link linkend="mkvmerge.escaping">テキスト中の特殊文字のエスケープについてのセクション</link>をご覧ください）。

note: type: Content of: <refentry><refnamediv><refpurpose>
en: Modify properties of existing &matroska; files without a complete remux
de: 再MUXすることなく、既存の&matroska;ファイルのプロパティを修正する

note: type: Content of: <refentry><refsect1><para>
en: This program analyses an existing &matroska; file and modifies some of its properties. Then it writes those modifications to the existing file. Among the properties that can be changed are the segment information elements (e.g. the title) and the track headers (e.g. the language code, 'default track' flag or the name).
de: このプログラムは、既存の&matroska;ファイルを解析し、そのプロパティのいくつかを修正します。そして、それらの修正を既存のファイルに書き込みます。プロパティの中で変更可能なのは、セグメント情報エレメント(例えばタイトル)と、トラックヘッダ(例えば言語コードや'デフォルトトラック'フラグ、トラック名)です。

note: type: Content of: <refentry><refsect1><para>
en: Options:
de: オプション:

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Lists all known and editable property names, their type (string, integer, boolean etc) and a short description. The program exits afterwards. Therefore the <parameter>source-filename</parameter> parameter does not have to be supplied.
de: 既知の編集可能なプロパティの名前、型(文字列、整数、真偽値等)、短い説明を一覧表示します。その後、プログラムは終了します。よって、<parameter>source-filename</parameter>パラメータを指定する必要はありません。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Sets the parse mode. The parameter '<parameter>mode</parameter>' can either be '<literal>fast</literal>' (which is also the default)  or '<literal>full</literal>'. The '<literal>fast</literal>' mode does not parse the whole file but uses the meta seek elements for locating the required elements of a source file. In 99% of all cases this is enough. But for files that do not contain meta seek elements or which are damaged the user might have to set the '<literal>full</literal>' parse mode. A full scan of a file can take a couple of minutes while a fast scan only takes seconds.
de: 解析モードを設定します。'<parameter>mode</parameter>'パラメータは'<literal>fast</literal>'(デフォルト)と'<literal>full</literal>'のどちらかを指定できます。'<literal>fast</literal>'モードはファイル全体を解析するのではなく、メタシークエレメントを使ってソースファイル内の必要なエレメントを探します。99%の場合これで十分です。しかし、メタシークエレメントを含まないファイルや破損したファイルに対しては'<literal>full</literal>'解析モードを指定する必要があるかもしれません。'<literal>full</literal>'スキャンには数分かかることがありますが、'<literal>fast</literal>'スキャンには数秒しかかかりません。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Sets the &matroska; file section (segment information or a certain track's headers) that all following <link linkend="mkvpropedit.description.add">add</link>, <link linkend="mkvpropedit.description.set">set</link> and <link linkend="mkvpropedit.description.delete">delete</link> actions operate on. This option can be used multiple times in order to make modifications to more than one element.
de: このオプション以降の<link linkend="mkvpropedit.description.add">add</link>、<link linkend="mkvpropedit.description.set">set</link>、<link linkend="mkvpropedit.description.delete">delete</link>アクションが適用される&matroska;ファイルセクション(セグメント情報または特定のトラックのヘッダ)を指定します。このオプションは、複数のエレメントを修正するために、複数回指定することができます。

note: type: Content of: <refentry><refsect1><para>
en: By default &mkvpropedit; will edit the segment information section.
de: デフォルトでは、&mkvpropedit;はセグメント情報のセクションを編集します。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: See the section about <link linkend="mkvpropedit.edit_selectors">edit selectors</link> for a full description of the syntax.
de: 文法の完全な説明は、<link linkend="mkvpropedit.edit_selectors">エディットセレクタ</link>のセクションを参照してください。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Adds a property <parameter>name</parameter> with the value <parameter>value</parameter>. The property will be added even if such a property exists already. Note that most properties are unique and cannot occur more than once.
de: <parameter>name</parameter>で指定された名前のプロパティを<parameter>value</parameter>で指定した値で追加します。プロパティは、既にその名前のプロパティが存在する場合も追加されます。ほとんどのプロパティは一意的で、複数回追加できないことに注意してください。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Sets all occurrences of the property <parameter>name</parameter> to the value <parameter>value</parameter>. If no such property exists then it will be added.
de: 見付けた全ての、プロパティ名が<parameter>name</parameter>であるプロパティの値を、<parameter>value</parameter>に設定します。そのようなプロパティが存在しないときは、プロパティは追加されます。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Deletes all occurrences of the property <parameter>name</parameter>. Note that some properties are required and cannot be deleted.
de: 見付けた全ての、プロパティ名が<parameter>name</parameter>であるプロパティを削除します。いくつかのプロパティは必須で、削除できないことに注意してください。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Add or replace tags in the file with the ones from <filename>filename</filename> or remove them if <filename>filename</filename> is empty. &mkvpropedit; reads the same XML tag format that &mkvmerge; reads as well.
de: <filename>ファイル名</filename>からのタグを、このファイル中のタグに追加、あるいは置換します。もし<filename>ファイル名</filename>が空白なら、タグを削除します。&mkvpropedit;は、&mkvmerge;が読み込むのと同じXMLタグフォーマットを読み込みます。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: The <parameter>selector</parameter> must be one of the words <constant>all</constant>, <constant>global</constant> or <constant>track</constant>. For <constant>all</constant> &mkvpropedit; will replace or remove all tags in a file. With <constant>global</constant> only global tags will be replaced or removed.
de: <parameter>セレクタ</parameter>は、<constant>all</constant>、<constant>global</constant>、または<constant>track</constant>のうちどれか一つを指定してください。<constant>all</constant>を指定すると、&mkvpropedit;はファイル中の全てのタグを置換あるいは削除します。<constant>global</constant>を指定すると、グローバルタグだけが置換あるいは削除されます。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: With <constant>track</constant> &mkvpropedit; will replace tags for a specific track. Additionally the tags read from <filename>filename</filename> will be assigned to the same track. The track is specified in the same way <link linkend="mkvpropedit.edit_selectors">edit selectors</link> are specified (see below), e.g. <code>--tags track:a1:new-audio-tags.xml</code>.
de: <constant>track</constant>を指定すると、&mkvpropedit;は特定のトラックのタグを置換します。また、<filename>filename</filename>から読み込まれたタグは、同じトラックに割り当てられます。<link linkend="mkvpropedit.edit_selectors">edit selectors</link>が指定されるのと同じ様に（下を参照してください）、トラックは指定されます。(see below), e.g. <code>--tags track:a1:new-audio-tags.xml</code>.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Add or replace chapters in the file with the ones from <filename>filename</filename> or remove them if <filename>filename</filename> is empty. &mkvpropedit; reads the same XML and simple chapter formats that &mkvmerge; reads as well.
de: <filename>ファイル名</filename>からのチャプタを、このファイル中のタグに追加、あるいは置換します。もし<filename>ファイル名</filename>が空白なら、チャプタを削除します。&mkvpropedit;は、&mkvmerge;が読み込むのと同じXMLまたはシンプルチャプタフォーマットを読み込みます。

note: type: Content of: <refentry><refsect1><para>
en: Other options:
de: その他のオプション:

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Writes all messages to the file <parameter>file-name</parameter> instead of to the console.  While this can be done easily with output redirection there are cases in which this option is needed: when the terminal reinterprets the output before writing it to a file.  The character set set with <link linkend="mkvpropedit.description.output_charset"><option>--output-charset</option></link> is honored.
de: 全てのメッセージをコンソールではなく<parameter>file-name</parameter>で指定したファイルに書き出します。出力リダイレクトによっても同じことが簡単にできますが、このオプションが必要な場合もあります。ターミナルがファイルに書き込む前に出力を処理してしまう場合などです。<link linkend="mkvpropedit.description.output_charset"><option>--output-charset</option></link>によって指定された文字コードは尊重されます。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Turn on experimental features. A list of available features can be requested with <command>mkvpropedit --engage list</command>. These features are not meant to be used in normal situations.
de: 実験的機能をオンにします。利用可能な機能のリストは<command>mkvpropedit --engage list</command>で得られます。これらの機能は通常の状況で利用されることは意図されていません。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Several chars can be escaped, e.g. if you need to start a non-comment line with '#'. The rules are described in <link linkend="mkvpropedit.escaping">the section about escaping text</link>.
de: エスケープすることのできる文字もあります。例えば、コメントではない行を'#'で始める必要のある場合です。そのルールは、<link linkend="mkvpropedit.escaping">エスケープ文字についてのセクション</link>で説明されています。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: The command line '<command>mkvpropedit source.mkv --edit track:a2 --set name=Comments</command>' could be converted into the following option file:
de: '<command>mkvpropedit source.mkv --edit track:a2 --set name=Comments</command>'というコマンドラインと同じことは、次のようなオプションファイルによって指定できます。

note: type: Content of: <refentry><refsect1><title>
en: Edit selectors
de: エディットセレクタ

note: type: Content of: <refentry><refsect1><para>
en: The <link linkend="mkvpropedit.description.edit"><option>--edit</option></link> option sets the &matroska; file section (segment information or a certain track's headers) that all following <link linkend="mkvpropedit.description.add">add</link>, <link linkend="mkvpropedit.description.set">set</link> and <link linkend="mkvpropedit.description.delete">delete</link> actions operate on. This stays valid until the next <link linkend="mkvpropedit.description.edit"><option>--edit</option></link> option is found. The argument to this option is called the edit selector.
de: <link linkend="mkvpropedit.description.edit"><option>--edit</option></link>オプションは、以降の<link linkend="mkvpropedit.description.add">add</link>、<link linkend="mkvpropedit.description.set">set</link>及び<link linkend="mkvpropedit.description.delete">delete</link>アクションが適用される&matroska;ファイルセクション(セグメント情報または特定のトラックヘッダ)を設定します。これは次の<link linkend="mkvpropedit.description.edit"><option>--edit</option></link>オプションが見付かるまでずっと有効です。このオプションへの引数はエディットセレクタと呼ばれます。

note: type: Content of: <refentry><refsect1><refsect2><title>
en: Segment information
de: セグメント情報

note: type: Content of: <refentry><refsect1><refsect2><para>
en: The segment information can be selected with one of these three words: '<literal>info</literal>', '<literal>segment_info</literal>' or '<literal>segmentinfo</literal>'. It contains properties like the segment title or the segment <abbrev>UID</abbrev>.
de: セグメント情報は次の3つの単語によって選択されます。'<literal>info</literal>'、'<literal>segment_info</literal>'または'<literal>segmentinfo</literal>'です。これはセグメントタイトルやセグメント<abbrev>UID</abbrev>などのプロパティを格納しています。

note: type: Content of: <refentry><refsect1><refsect2><title>
en: Track headers
de: トラックヘッダ

note: type: Content of: <refentry><refsect1><refsect2><para>
en: Track headers can be selected with a slightly more complex selector. All variations start with '<literal>track:</literal>'. The track header properties include elements like the language code, 'default track' flag or the track's name.
de: トラックヘッダはもうちょっとだけ複雑なセレクタで選択されます。全ての場合でセレクタは'<literal>track:</literal>'で始まります。トラックヘッダプロパティには、言語コード、'デフォルトトラック'フラグやトラック名のようなエレメントがあります。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: If the parameter <parameter>n</parameter> is a number then the <parameter>n</parameter>th track will be selected. The track order is the same that &mkvmerge;'s <option>--identify</option> option outputs.
de: パラメータ<parameter>n</parameter>が数字であれば、<parameter>n</parameter>番目のトラックが選択されます。トラックの順番は、&mkvmerge;に<option>--identify</option>オプションを指定すると出力されるものと同じです。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: If the parameter starts with a single character <parameter>t</parameter> followed by a <parameter>n</parameter> then the <parameter>n</parameter>th track of a specific track type will be selected. The track type parameter <parameter>t</parameter> must be one of these four characters: '<literal>a</literal>' for an audio track, '<literal>b</literal>' for a button track, '<literal>s</literal>' for a subtitle track and '<literal>v</literal>' for a video track. The track order is the same that &mkvmerge;'s <option>--identify</option> option outputs.
de: パラメータが一文字の英字<parameter>t</parameter>で始まり、次に<parameter>n</parameter>が続く場合、あるトラックタイプで<parameter>n</parameter>番目のトラックが選択されます。トラックタイプパラメータ<parameter>t</parameter>は、オーディオトラックを示す'<literal>a</literal>'、ボタントラックを示す'<literal>b</literal>'、字幕トラックを示す'<literal>s</literal>'、ビデオトラックを示す'<literal>v</literal>'の四つのうちの一つでなければなりません。トラックの順番は&mkvmerge;の<option>--identify</option>オプションで出力される順番と同じです。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: If the parameter starts with a '<literal>=</literal>' followed by a number <parameter>uid</parameter> then the track whose track <abbrev>UID</abbrev> element equals this <parameter>uid</parameter>. Track <abbrev>UIDs</abbrev> can be obtained with &mkvinfo;.
de: パラメータが'<literal>=</literal>'で始まり、次に<parameter>uid</parameter>が続く場合は、トラック<abbrev>UID</abbrev>エレメントが<parameter>uid</parameter>のトラックが選択されます。トラック<abbrev>UID</abbrev>は&mkvinfo;で取得できます。

note: type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
en: If the parameter starts with a '<literal>@</literal>' followed by a number <parameter>number</parameter> then the track whose track number element equals this <parameter>number</parameter>. Track number can be obtained with &mkvinfo;.
de: パラメータが'<literal>@</literal>'で始まり、次に<parameter>number</parameter>が続く場合は、トラックナンバーエレメントが<parameter>number</parameter>と等しいトラックが選択されます。トラックナンバーは&mkvinfo;で取得できます。

note: type: Content of: <refentry><refsect1><refsect2><title>
en: Notes
de: 注意

note: type: Content of: <refentry><refsect1><refsect2><para>
en: Due to the nature of the track edit selectors it is possible that several selectors actually match the same track headers. In such cases all actions for those edit selectors will be combined and executed in the order in which they're given on the command line.
de: トラックエディットセレクタの性質から、いくつかのセレクタが同じトラックヘッダにマッチすることがあります。このような場合、それらのエディットセレクタへの全てのアクションは一つにまとめられ、コマンドラインに指定された順番に実行されます。

note: type: Content of: <refentry><refsect1><para>
en: The following example edits a file called '<literal>movie.mkv</literal>'. It sets the segment title and modifies the language code of an audio and a subtitle track. Note that this example can be shortened by leaving out the first <link linkend="mkvpropedit.description.edit"><option>--edit</option></link> option because editing the segment information element is the default for all options found before the first <link linkend="mkvpropedit.description.edit"><option>--edit</option></link> option anyway.
de: 下に'<literal>movie.mkv</literal>'というファイルを編集する例を示します。この例では、セグメントタイトルを設定し、オーディオトラックと字幕トラックの言語コードを修正します。この例は、最初の<link linkend="mkvpropedit.description.edit"><option>--edit</option></link>オプションが見付かる前の全てのオプションはデフォルトで結局セグメント情報エレメントを編集するので、最初の<link linkend="mkvpropedit.description.edit"><option>--edit</option></link>オプションを省略して短縮できることに注意してください。

note: type: Content of: <refentry><refsect1><para>
en: The second example removes the 'default track flag' from the first subtitle track and sets it for the second one. Note that &mkvpropedit;, unlike &mkvmerge;, does not set the 'default track flag' of other tracks to '0' if it is set to '1' for a different track automatically.
de: 二番目の例は、最初の字幕トラックから'デフォルトトラックフラグ'を削除し二番目の字幕トラックに設定します。&mkvpropedit;は&mkvmerge;とは違い、'デフォルトトラックフラグ'が違うトラックで'1'に設定されているからといって自動的に他のトラックの'デフォルトトラックフラグ'を'0'に設定はしない、という点に注意してください。

note: type: Content of: <refentry><refsect1><para>
en: Replacing the tags for the second subtitle track in a file looks like this:
de: ファイル中で2番目の字幕トラックのタグを置換するには、以下のようにします：

note: type: Content of: <refentry><refsect1><para>
en: Removing all tags requires leaving out the file name:
de: タグを削除するには、ファイル名を空白にします

note: type: Content of: <refentry><refsect1><para>
en: Replacing the chapters in a file looks like this:
de: ファイル中のチャプタを置換するには、以下のようにします：

note: type: Content of: <refentry><refsect1><para>
en: Removing all chapters requires leaving out the file name:
de: 全てのチャプタを削除するには、ファイル名を空白にします

note: type: Content of: <refentry><refsect1><para>
en: &mkvpropedit; exits with one of three exit codes:
de: &mkvpropedit;は下の3つの返り値を返します。

note: type: Content of: <refentry><refsect1><itemizedlist><listitem><para>
en: <constant>0</constant> -- This exit codes means that the modification has completed successfully.
de: <constant>0</constant> -- この返り値は変更が成功したことを示します。

note: type: Content of: <refentry><refsect1><itemizedlist><listitem><para>
en: <constant>1</constant> -- In this case &mkvpropedit; has output at least one warning, but the modification did continue.  A warning is prefixed with the text '<literal>Warning:</literal>'.  Depending on the issues involved the resulting files might be ok or not.  The user is urged to check both the warning and the resulting files.
de: <constant>1</constant> -- この返り値は、一つ以上の警告が出力されましたが、抽出が続行されたことを意味します。警告は '<literal>警告:</literal>' という文字列を先頭につけて出力されます。出力ファイルが無事であるかどうかは、場合によります。出力ファイルを確認することを強く推奨します。

note: type: Content of: <refentry><refsect1><itemizedlist><listitem><para>
en: <constant>2</constant> -- This exit code is used after an error occurred.  &mkvpropedit; aborts right after outputting the error message.  Error messages range from wrong command line arguments over read/write errors to broken files.
de: <constant>2</constant> -- この返り値は、エラーが発生し、エラーメッセージを表示した直後に&mkvpropedit;が終了したことを示します。エラーメッセージは不正なコマンドラインやファイルI/Oエラー、壊れたファイルなど様々です。

note: type: Content of: <refentry><refsect1><para>
en: &mkvpropedit; uses the default variables that determine the system's locale (e.g. <varname>LANG</varname> and the <varname>LC_*</varname> family). Additional variables:
de: &mkvpropedit;はシステムのロケールを決めるデフォルトの変数（例：<varname>LANG</varname>や<varname>LC_*</varname>系）を使用します。追加の変数は以下の通りです：

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: The content is treated as if it had been passed via the <link linkend="mkvpropedit.description.debug"><option>--debug</option></link> option.
de: その内容は、あたかも<link linkend="mkvpropedit.description.debug"><option>--debug</option></link>オプション経由で渡されたかのように扱われます。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: The content is treated as if it had been passed via the <link linkend="mkvpropedit.description.engage"><option>--engage</option></link> option.
de: その内容は、あたかも<link linkend="mkvpropedit.description.engage"><option>--engage</option></link>オプション経由で渡されたかのように扱われます。

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: The content is split on white space. The resulting partial strings are treated as if it had been passed as command line options. If you need to pass special characters (e.g. spaces) then you have to escape them (see <link linkend="mkvpropedit.escaping">the section about escaping special characters in text</link>).
de: その内容は空白で分割されます。得られた一部の文字列は、あたかもそれがコマンドラインオプションとして渡されたかのように扱われます。もし特殊な文字（例：空白）を渡す必要があるなら、それらをエスケープする必要があります（<link linkend="mkvpropedit.escaping">テキスト中の特殊文字のエスケープについてのセクション</link>をご覧ください）。

note: type: Content of: <refentry><refnamediv><refpurpose>
en: a GUI for &mkvmerge; including a chapter and a header editor
de: &mkvmerge; のチャプタ、ヘッダ編集機能付きGUI

note: type: Content of: <refentry><refsect1><para>
en: &mmg; is a <productname>wxWindows</productname> based <abbrev>GUI</abbrev> for &mkvmerge;. It offers easy access to all of &mkvmerge;'s options. All settings (e.g. source files, track options etc) can be saved and restored.  Included is a chapter editor that can read <abbrev>OGM</abbrev> style and &xml; style chapter files, write &xml; style chapter files and even read chapters from &matroska; files and write chapters directly to &matroska; files. Included is also a header editor that can be used to quickly change properties of existing &matroska; files without needing a complete remux.
de: &mmg;は、<productname>wxWindows</productname>ベースの&mkvmerge;の<abbrev>GUI</abbrev>です。&mkvmerge;の全てのオプションを簡単に使用できます。全ての設定(例：ソースファイル、トラックオプションなど)は保存・読み込みが可能です。&matroska;ファイルからチャプタ情報を読みこむことができ、また<abbrev>OGM</abbrev>形式、&xml;形式のチャプタファイルを読み込み可能で、&xml;形式に書き出し可能なチャプタエディタが搭載されています。さらに、既存の&matroska;ファイルのヘッダを再MUXすることなく書き換え可能なヘッダエディタも搭載されています。

note: type: Content of: <refentry><refsect1><para>
en: &mmg; knows few options. The first possibility is to start it with a single file name. If that file name's extenion is '<literal>.mmg</literal>' then it will be treated as a preferences file and &mmg; will load its setting when it starts. Otherwise the name is interpreted as being the name of an input file which will be added.
de: &mmg;はあまり多くのオプションをとりません。最初に考えられるのは、一つのファイル名を指定することです。もし、ファイル名の拡張が'<literal>.mmg</literal>'であれば、そのファイルは設定ファイルとして扱われ、&mmg;はスタート時に設定を読み込みます。もしそうでなければ、ファイル名は入力ファイルとして追加されるファイルの名前として扱われます。

note: type: Content of: <refentry><refsect1><para>
en: The second operation mode is invoked with the option <option>--edit-headers</option> and a file name. This lets &mmg; run its header editor and load the file.
de: 二番目の動作モードに入るには、<option>--edit-headers</option>オプションをファイル名と共に指定します。すると、&mmg;はヘッダエディタを立ち上げ、ファイルを読み込みます。

note: type: Content of: <refentry><refsect1><para>
en: The full documentation is available in HTML form (<filename>doc/mkvmerge-gui.html</filename>).
de: 完全なドキュメントは、HTML形式で存在します。(<filename>doc/mkvmerge-gui.html</filename>)

note: type: Content of: <refentry><refsect1><para>
en: &mkvmerge;, &mkvextract;, &mkvinfo;, &mkvpropedit;
de: &mkvmerge; &mkvextract;, &mkvinfo;, &mkvpropedit;

note: type: Plain text
en: B<\*[PROGRAM]> is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
de: B<\*[PROGRAM]> est un logiciel libre : vous pouvez le redistribuer et/ou le modifier aux conditions définies dans la licence publique générale GNU telle que publiée par la Free Software Foundation ; version 2 ou, selon votre préférence, toute version ultérieure.

note: type: Plain text
en: schroot - securely enter a chroot environment
de: schroot — entrer de manière sécurisée dans un environnement de chroot

note: type: Plain text
en: B<schroot> [B<-h>\[or]B<--help> \[or] B<-V>\[or]B<--version> \[or] B<-l>\[or]B<--list> \[or] B<-i>\[or]B<--info> \[or] B<--config> \[or] B<--location> \[or] B<--automatic-session> \[or] B<-b>\[or]B<--begin-session> \[or] B<--recover-session> \[or] B<-r>\[or]B<--run-session> \[or] B<-e>\[or]B<--end-session>] [B<-f>\[or]B<--force>] [B<-n >I<session-name>\[or]B<--session-name=>I<session-name>] [B<-d >I<directory>\[or]B<--directory=>I<directory>] [B<-u >I<user>\[or]B<--user=>I<user>] [B<-p>\[or]B<--preserve-environment>] [B<-s >I<shell>\[or]B<--shell=>I<shell>] [B<-q>\[or]B<--quiet> \[or] B<-v>\[or]B<--verbose>] [B<-c >I<chroot>\[or]B<--chroot=>I<chroot> \[or] [B<--all> \[or] B<--all-chroots> \[or] B<--all-source-chroots> \[or] B<--all-sessions>] [B<--exclude-aliases>]] [B<-o>\[or]B<--option=>I<key=value>] [B<-->] [B<COMMAND> [ B<ARG1> [ B<ARG2> [ B<ARGn>]]]]
de: B<schroot> [B<-h>\[ou]B<--help> \[ou] B<-V>\[ou]B<--version> \[ou] B<-l>\[ou]B<--list> \[ou] B<-i>\[ou]B<--info> \[ou] B<--config> \[ou] B<--location> \[ou] B<--automatic-session> \[ou] B<-b>\[ou]B<--begin-session> \[ou] B<--recover-session> \[ou] B<-r>\[ou]B<--run-session> \[ou] B<-e>\[ou]B<--end-session>] [B<-f>\[ou]B<--force>] [B<-n >I<nom-de-session>\[ou]B<--session-name=>I<nom-de-session>] [B<-d >I<répertoire>\[ou]B<--directory=>I<répertoire>] [B<-u >I<utilisateur>\[ou]B<--user=>I<utilisateur>] [B<-u >I<utilisateur>\[ou]B<--user=>I<utilisateur>] [B<-p>\[ou]B<--preserve-environment>][B<-s >I<shell>\[ou]B<--shell=>I<shell>] [B<-q> \[ou]B<--quiet> \[ou] B<-v>\[ou]B<--verbose>] [B<-c >I<chroot>\[ou]B<--chroot=>I<chroot> \[or] B<--all> \[ou] B<--all-chroots> \[ou] B<--all-source-chroots> \[ou] B<--all-sessions>] \[ou] B<--exclude-aliases> [B<-o>\[ou]B<--option=>I<clé=valeur>]  [B<-->] [B<COMMANDE> [ B<ARG1> [ B<ARG2> [ B<ARGn>]]]]

note: type: Plain text
en: B<schroot> allows the user to run a command or a login shell in a chroot environment.  If no command is specified, a login shell will be started in the user's current working directory inside the chroot.
de: B<schroot> autorise l'utilisateur à exécuter une commande ou un interpréteur de commande de connexion dans un environnement de chroot. Si aucune commande n'est précisée, un interpréteur de commande de connexion sera démarré dans le répertoire de travail courant de l'utilisateur à l'intérieur du chroot.

note: type: Plain text
en: The command is a program, plus as many optional arguments as required.  Each argument may be separately quoted.
de: La commande est un programme plus autant d'arguments optionnels que requis. Chaque argument doit être déclaré séparément.

note: type: Plain text
en: The directory the command or login shell is run in depends upon the context.  See I<--directory> option below for a complete description.
de: Le répertoire dans lequel la commande ou l'interpréteur de commandes initial sont exécutés dépend du contexte. Voir l'option I<--directory> ci-dessous pour une description complète.

note: type: Plain text
en: All chroot usage will be logged in the system logs.  Under some circumstances, the user may be required to authenticate themselves; see the section \[lq]I<Authentication>\[rq], below.
de: Toute utilisation de chroot sera enregistrée dans les journaux du système. Dans certaines circonstances, l'utilisateur pourrait devoir s'identifier ; consultez la section \[lq]I<Authentification>\[rq] ci-dessous.

note: type: Plain text
en: If no chroot is specified, the chroot name or alias \[oq]default\[cq] will be used as a fallback.  This is equivalent to \[lq]--chroot=default\[rq].
de: Si aucun chroot n'est spécifié, le nom de chroot ou alias \[oq]default\[cq] sera utilisé à la place. Ce qui est équivalent à \[lq]--chroot=default\[rq].

note: type: Plain text
en: There is often a need to run programs in a virtualised environment rather than on the host system directly.  Unlike other virtualisation systems such as B<kvm> or B<Xen>, schroot does not virtualise the entire system; it only virtualises the filesystem, and some parts of the filesystem may still be shared with the host.  It is therefore fast, lightweight and flexible.  However, it does not virtualise other aspects of the system, such as shared memory, networking, devices etc., and so may be less secure than other systems, depending upon its intended use.  Some examples of existing uses for schroot include:
de: Il y a souvent besoin d'exécuter des programmes dans des environnements virtualisés plutôt que directement sur le système hôte. À la différence des autres systèmes de virtualisation comme B<kvm> ou B<Xen>, schroot ne virtualise pas le système en entier ; il virtualise seulement le système de fichiers, et certaines parties du système de fichiers peuvent toujours être partagées avec l'hôte. Il est par conséquent rapide, léger et flexible. Cependant, il ne virtualise pas les autres aspects du système, comme la mémoire partagée, le réseau, les périphériques etc., et par conséquent peut être moins sécurisé que d'autres systèmes, en fonction de l'utilisation voulue. Des exemples d'utilisations connues de schroot sont :

note: type: Plain text
en: Running an untrusted program in a sandbox, so that it can't interfere with files on the host system; this may also be used to limit the damage a compromised service can inflict upon the host
de: Exécution de programmes non fiables dans un bac à sable ; de cette façon, ils ne peuvent pas interférer avec les fichiers du système hôte ; cela peut également être utilisé pour diminuer les dommages que causerait la compromission d'un service sur l'hôte.

note: type: Plain text
en: Using a I<defined> or I<clean> environment, to guarantee the reproducibility and integrity of a given task
de: Utiliser un environnement I<défini> ou I<propre> pour garantir la reproductibilité et l'intégrité d'une tâche donnée.

note: type: Plain text
en: Using different versions of an operating system, or even different operating systems altogether, e.g. different GNU/Linux distributions
de: Utiliser une version différente d'un système d'exploitation, ou même un système d'exploitation complètement différent, p.ex. une distribution GNU/Linux différente.

note: type: Plain text
en: Running 32-bit programs using a 32-bit chroot on a 64-bit host system
de: Exécuter des programmes 32 bits sur un système hôte 64 bits, en utilisant un chroot 32 bits.

note: type: Plain text
en: Automatic building of Debian packages using B<sbuild>(1), which builds each package in a pristine chroot snapshot when using LVM snapshots or unions
de: Construction automatique de paquets Debian en utilisant B<sbuild>(1), qui construit chaque paquet dans un cliché chroot dédié quand les clichés LVM ou les unions sont utilisés.

note: type: Plain text
en: Supporting multiple system images in a cluster setup, where modifying the base image is time-consuming and/or supporting all the required configurations needed by users is difficult: different chroots can support all the different configurations required, and cluster users may be given access to the chroots they need (which can include root access for trusted users to maintain their own images)
de: Prise en charge d'images multiples de systèmes dans une installation de cluster, où modifier l'image de base est consommatrice de temps et/ou prendre en charge toutes les configurations requises par les utilisateurs est difficile : différents chroots peuvent prendre en charge toutes les configurations différentes requises, et l'accès peut être donné aux utilisateurs du cluster pour les chroots dont ils ont besoin (ce qui peut inclure des accès root pour les utilisateurs de confiance afin qu'ils puissent maintenir leurs propres images)

note: type: Plain text
en: A chroot may be used directly as root by running B<chroot>(8), but normal users are not able to use this command.  B<schroot> allows access to chroots for normal users using the same mechanism, but with several additional features.  While schroot uses a directory as a chroot just like B<chroot>(8), it does not require this to be a regular directory in the filesystem.  While this is the default, the chroot can also be created from a file, a filesystem, including LVM and Btrfs snapshots and loopback mounts, or composed of a unionfs overlay.  Being user-extensible, the scope for creating chroots from different sources is limited only by your imagination.  schroot performs permissions checking and allows additional automated setup of the chroot environment, such as mounting additional filesystems and other configuration tasks.  This automated setup is done through the action of I<setup scripts> which may be customised and extended to perform any actions required.  Typical actions include mounting the user's home directory, setting up networking and system databases, and even starting up services.  These are again entirely customisable by the admin.  The setup scripts are run for all types of chroot, with the exception of the \[oq]plain\[cq] type, the simplest chroot type, offering no automated setup features at all.  The configuration of schroot is covered in more detail in B<schroot.conf>(5).
de: Un chroot peut être utilisé directement en exécutant B<chroot>(8), mais les utilisateurs standards ne sont pas autorisés à exécuter cette commande. B<schroot> autorise l'accès à des chroots pour des utilisateurs normaux en utilisant le même mécanisme, mais avec plusieurs caractéristiques supplémentaires. Alors que schroot utilise un répertoire comme chroot exactement comme B<chroot> (8), il n'a pas besoin que celui-ci soit un répertoire régulier du système de fichier. Bien que cela soit la valeur par défaut, le chroot peut également être créé à partir d'un fichier, d'un système de fichier, incluant les clichés LVM et Btrfs et les montages « loopback », ou composé d'une surcouche unionfs. Étant extensible par l'utilisateur, les possibilités de création de chroot provenant de sources différentes n'est limité que par votre imagination. schroot effectue des vérifications de permission et autorise des mises en place automatiques supplémentaires de l'environnement de chroot, comme le montage de systèmes de fichiers supplémentaires et d'autres tâches de configuration. Cette mise en place automatique est faite par l'action de I<scripts de mise en place> qui peuvent être configurés et étendus pour effectuer toute action nécessaire. Les actions typiques incluent le montage du répertoire personnel de l'utilisateur, la configuration du réseau et des bases de données du système, et même le démarrage de services. Ils sont également entièrement personnalisables par l'administrateur. Les scripts de mise en place sont exécutés pour tous les types de chroot, à l'exception de ceux de type \[oq]plain\[cq], le type de chroot le plus simple, qui ne permet aucune mise en place automatique. La configuration de schroot est décrite plus en détail dans B<schroot.conf>(5).

note: type: Plain text
en: B<schroot> accepts the following options:
de: B<schroot> accepte les options suivantes :

note: type: Plain text
en: Show help summary.
de: Afficher un résumé de l'aide.

note: type: Plain text
en: Print version information.
de: Afficher les informations de version.

note: type: Plain text
en: List all available chroots.
de: Lister tous les chroots disponibles.

note: type: Plain text
en: Print detailed information about the specified chroots.
de: Afficher des informations détaillées à propos des chroots spécifiés.

note: type: Plain text
en: Print configuration of the specified chroots.  This is useful for testing that the configuration in use is the same as the configuration file.  Any comments in the original file will be missing.
de: Afficher la configuration des chroots spécifiés. C'est utile pour tester que la configuration utilisée est la même que celle du fichier de configuration. Tout commentaire du fichier original est omis.

note: type: Plain text
en: Print location (path) of the specified chroots.  Note that chroot types which can only be used within a session will not have a location until they are active.
de: Afficher la localisation (chemin) des chroots spécifiés. Noter que les types de chroot qui ne peuvent être utilisés qu'à l'intérieur d'une session n'auront aucune localisation avant d'être activés.

note: type: Plain text
en: Print only essential messages.
de: Afficher uniquement les messages essentiels.

note: type: Plain text
en: Print all messages.
de: Afficher tous les messages.

note: type: SS
en: Chroot selection
de: Sélection de chroots.

note: type: Plain text
en: Specify a chroot or active session to use.  This option may be used multiple times to specify more than one chroot, in which case its effect is similar to I<--all>.  The chroot name may be prefixed with a I<namespace>; see the section \[lq]I<Chroot Namespaces>\[rq], below.
de: Spécifier un chroot ou une session active à utiliser. Cette option peut être utilisée plusieurs fois pour spécifier plus d'un chroot, qui dans ce cas a un effet similaire à I<--all>. Le nom du chroot peut être préfixé par un I<espace de noms> ; veuillez vous reporter à la section \[lq]I<Espaces de noms Chroot>\[rq] ci-après.

note: type: Plain text
en: Select all chroots, source chroots and active sessions.  When a command has been specified, the command will be run in all chroots, source chroots and active sessions.  If I<--info> has been used, display information about all chroots.  This option does not make sense to use with a login shell (run when no command has been specified).  This option is equivalent to \[lq]--all-chroots --all-source-chroots --all-sessions\[rq].
de: Sélectionner tous les chroots, chroots source et sessions actives. Quand une commande a été spécifiée, cette commande sera exécutée dans tous les chroots, chroots source et sessions actives. Si I<--info> a été utilisé, afficher les informations à propos de tous les chroots. Cette option n'a aucun sens à être utilisée avec un interpréteur de commande de connexion (« login shell »), quand aucune commande n'est spécifiée. Cette option est équivalente à \[lq]--all-chroots --all-source-chroots --all-sessions\[rq].

note: type: Plain text
en: Select all chroots.  Identical to I<--all>, except that source chroots and active sessions are not considered.
de: Sélectionner tous les chroots. Identique à I<--all>, sauf que les chroots source et les sessions actives ne sont pas pris en compte.

note: type: Plain text
en: Select all active sessions.  Identical to I<--all>, except that chroots and source chroots are not considered.
de: Sélectionner toutes les sessions actives. Identique à I<--all>, sauf que les chroots et les chroots source ne sont pas pris en compte.

note: type: Plain text
en: Select all source chroots.  Identical to I<--all>, except that chroots and sessions are not considered.
de: Sélectionner tous les chroots source. Identique à I<--all>, sauf que les chroots et les sessions ne sont pas pris en compte.

note: type: Plain text
en: Do not select aliases in addition to chroots.  This ensures that only real chroots are selected, and are only listed once.
de: Ne pas sélectionner les alias en plus des chroots. Cela permet de s'assurer que seul les chroots réels sont sélectionnés, et qu'ils ne sont listés qu'une seule fois.

note: type: SS
en: Chroot environment
de: Environnement de chroot

note: type: TP
en: B<-d>, B<--directory=>I<directory>
de: B<-d>, B<--directory=>I<répertoire>

note: type: Plain text
en: Change to I<directory> inside the chroot before running the command or login shell.  If I<directory> is not available, schroot will exit with an error status.
de: Se déplacer dans le I<répertoire> dans le chroot avant d'exécuter la commande ou l'interpréteur de commande de connexion. Si le I<répertoire> n'est pas disponible, schroot se terminera par un état d'erreur.

note: type: Plain text
en: The default behaviour is as follows (all directory paths are inside the chroot).  A login shell is run in the current working directory.  If this is not available, it will try $HOME (when I<--preserve-environment> is used), then the user's home directory, and I</> inside the chroot in turn.  A command is always run in the current working directory inside the chroot.  If none of the directories are available, schroot will exit with an error status.
de: Le comportement par défaut est comme suit (tous les chemins de répertoire sont à l'intérieur du chroot). Un interpréteur de commande de connexion est exécuté dans le répertoire de travail courant. S'il n'est pas disponible, $HOME sera essayé (quand I<--preserve-environment> est utilisé), ensuite le répertoire personnel de l'utilisateur, et finalement I</> à l'intérieur du chroot. Une commande est toujours exécutée dans le répertoire de travail courant à l'intérieur du chroot. Si aucun des répertoires n'est disponible, schroot se terminera avec un état d'erreur.

note: type: TP
en: B<-u>, B<--user=>I<user>
de: B<-u>, B<--user=>I<utilisateur>

note: type: Plain text
en: Run as a different user.  The default is to run as the current user.  If required, the user may be required to authenticate themselves with a password.  For further information, see the section \[lq]I<Authentication>\[rq], below.
de: Exécuter en tant qu'utilisateur différent. Par défaut la commande est exécutée avec l'utilisateur courant. Si nécessaire, l'utilisateur peut avoir besoin de s'identifier avec un mot de passe. Pour plus d'informations, consultez la section \[lq]I<Authentification>\[rq], ci-dessous.

note: type: Plain text
en: Preserve the user's environment inside the chroot environment.  The default is to use a clean environment; this option copies the entire user environment and sets it in the session.  The environment variables allowed are subject to certain restrictions; see the section \[lq]I<Environment>\[rq], below.
de: Préserver l'environnement de l'utilisateur à l'intérieur de l'environnement de chroot. Par défaut un environnement propre est utilisé ; cette option copie l'ensemble de l'environnement de l'utilisateur et le met en place dans la session. Les variables d'environnement autorisées sont soumises à certaines restrictions ; voir la section \[lq]I<Environnement>\[rq], ci-dessous.

note: type: TP
en: B<-s>, B<--shell=>I<shell>
de: B<-s>, B<-shell=>I<shell>

note: type: Plain text
en: Use I<shell> as the login shell.  When running a login shell a number of potential shells will be considered, in this order: the command in the SHELL environment variable (if I<--preserve-environment> is used, or \f[CI]preserve-environment\fR is enabled), the user's shell in the \[oq]passwd\[cq] database, I</bin/bash> and finally I</bin/sh>.  This option overrides this list, and will use the shell specified.  This option also overrides the \f[CI]shell\fR configuration key, if set.
de: Utiliser I<shell> en tant qu'interpréteur de commande de connexion. Lors de l'exécution d'un interpréteur de commande de connexion plusieurs interpréteurs de commandes potentiels seront considérés dans cet ordre : la commande dans la variable d'environnement SHELL (si l'option I<--preserve-environment> est utilisée ou si \f[CI]preserve-environment\fR est activé), l'interpréteur de commandes de l'utilisateur dans la base de données \[oq]passwd\[cq], I</bin/bash> et finalement I</bin/sh>. Cette option écrase cette liste et utilisera l'interpréteur de commandes spécifié. Cette option écrase également la clé de configuration \f[CI]shell\fR si définie.

note: type: TP
en: B<-o>, B<--option=>I<key=value>
de: B<-o>, B<--option=>I<clé=valeur>

note: type: Plain text
en: Set an option.  The value of selected configuration keys in I<schroot.conf> may be modified using this option.  The key must be present in the \f[CI]user-modifiable-keys\fR configuration key in I<schroot.conf>, or additionally the \f[CI]user-modifiable-keys\fR key if running as (or switching to) the root user.  The key and value set here will be set in the environment of the setup scripts, and may hence be used to customise the chroot on a per-session basis.
de: Définir une option. Les valeur des clés de configuration sélectionnées dans I<schroot.conf> peuvent être modifiées en utilisant cette option. Les clés doivent être présentes dans la clé de configuration \f[CI]user-modifiable-keys\fR dans I<schroot.conf>, à moins que la clé \f[CI]user-modifiable-keys\fR ne soit exécutée par le superutilisateur (ou déplacée vers lui). Les clés et les valeurs définies ici seront définies dans l'environnement des scripts de mise en place et peuvent par conséquent être utilisées pour personnaliser le chroot pour chaque session.

note: type: SS
en: Session actions
de: Actions de session

note: type: Plain text
en: Begin, run and end a session automatically.  This is the default action, so does not require specifying in normal operation.
de: Démarrer, exécuter et terminer une session automatiquement. C'est l'action par défaut, et donc n'a pas besoin d'être spécifiée en opération normale.

note: type: Plain text
en: Begin a session.  A unique session identifier (session ID) is returned on standard output.  The session ID is required to use the other session options.  Note that the session identifier may be specified with the I<--session-name> option.
de: Débuter une session. Un identifiant unique de session est retourné sur la sortie standard. L'identifiant de session est nécessaire pour utiliser les autres options de session. Notez que l'identifiant de session peut être spécifié avec l'option I<--session-name>.

note: type: Plain text
en: Recover an existing session.  If an existing session has become unavailable, for example becoming unmounted due to a reboot, this option will make the session available for use again, for example by remounting it.  The session ID is specified with the I<--chroot> option.
de: Restaurer une session existante. Si une session existante est devenue inaccessible, par exemple démontée à cause d'un redémarrage, cette option permettra que la session soit disponible pour être utilisée de nouveau, par exemple en la remontant. L'identifiant de session est spécifié avec l'option I<--chroot>.

note: type: Plain text
en: Run an existing session.  The session ID is specified with the I<--chroot> option.
de: Lancer une session existante. L'identifiant de session est spécifié avec l'option I<--chroot>.

note: type: Plain text
en: End an existing session.  The session ID is specified with the I<--chroot> option.
de: Terminer une session existante. L'identifiant de session est spécifié avec l'option I<--chroot>.

note: type: SS
en: Session options
de: Options de session

note: type: TP
en: B<-n>, B<--session-name=>I<session-name>
de: B<-n>, B<--session-name=>I<nom-de-session>

note: type: Plain text
en: Name a session.  The specified I<session-name> replaces the default session name containing an automatically-generated session ID.  The session name must not contain a namespace qualifier, since sessions are always created within the \[oq]session:\[cq] namespace.  The session name is also subject to the chroot naming restrictions documented in B<schroot.conf>(5).
de: Nommer une session. Le I<nom-de-session> spécifié remplace le nom de session par défaut contenant un identifiant de session généré automatiquement. Le nom de session ne doit pas contenir de qualificatif d'espace de noms, parce que les sessions sont toujours créées dans l'espace de noms \[oq]session:\[cq]. Le nom de session est aussi sujet aux restrictions de dénomination de chroot documentées dans B<schroot.conf>(5).

note: type: Plain text
en: Force a session operation, even if it would otherwise fail.  This may be used to forcibly end a session, even if it has active users.  This does not guarantee that the session will be ended cleanly; filesystems may not be unmounted, for example.
de: Forcer une opération de session, même si elle aurait autrement échouée. Cela peut être utilisé pour forcer la fin d'une session, même s'il y a des utilisateurs actifs. Cela ne garantit pas que la session se terminera proprement ; par exemple, les systèmes de fichiers peuvent ne pas être démontés.

note: type: SS
en: Separator
de: Séparateur

note: type: Plain text
en: End of options.  Used to indicate the end of the schroot options; any following options will be passed to the command being run, rather than to schroot.
de: Fin des options. Utilisé pour indiquer la fin des options de schroot ; toutes les options suivantes seront passées à la commande exécutée, au lieu de schroot.

note: type: SH
en: AUTHENTICATION
de: AUTHENTIFICATION

note: type: Plain text
en: If the user is not an allowed user, or a member of the allowed groups (or if changing to root, the allowed root users or allowed root groups) for the specified chroot(s), permission will be immediately denied.  If switching users, and the user running the command has access, the user will be required to authenticate themselves using the credentials of the user being switched to.
de: Si l'utilisateur n'est pas un utilisateur autorisé, ou membre d'un groupe autorisé (ou en cas de changement vers root, un utilisateur root autorisé ou un groupe root autorisé) pour le chroot spécifié, les permissions seront immédiatement refusées. En cas de changement d'utilisateur et si l'utilisateur exécutant la commande y est autorisé, l'utilisateur devra s'authentifier lui-même en utilisant les identifiants de l'utilisateur vers lequel le changement sera fait.

note: type: Plain text
en: On systems supporting Pluggable Authentication Modules (PAM), schroot will use PAM for authentication and authorisation of users.  If and when required, schroot will prompt for a password.  If PAM is not available, all authentication will automatically fail (user switching is I<not> supported without PAM).
de: Pour les systèmes prenant en charge le système d'authentification « Pluggable Authentication Modules » (PAM), schroot utilisera PAM pour l'authentification et l'autorisation des utilisateurs. Si besoin, schroot demandera un mot de passe. Si PAM n'est pas disponible, toutes les authentifications échoueront automatiquement (le changement d'utilisateur sans PAM I<n'est pas> pris en charge).

note: type: Plain text
en: Note that when PAM is in use, the root user is not granted any special privileges by default in the program.  However, the default PAM configuration permits root to log in without a password (I<pam_rootok.so>), but this may be disabled to prevent root from accessing any chroots except if specifically permitted.  In such a situation, root must be added to the allowed users or groups as for any other user or group.  If PAM is not available, the root user will be permitted to access all chroots, even when not explicitly granted access.
de: Notez que quand PAM est utilisé, l'utilisateur root n'obtiendra aucun privilège particulier par défaut dans le programme. Cependant, la configuration par défaut de PAM permet à root de se connecter sans mot de passe (I<pam_rootok.so>), mais cela peut être désactivé pour empêcher root d'accéder à des chroots quelconques sauf ceux spécifiquement permis. Dans une telle situation, root doit être ajouté aux utilisateurs ou groupes autorisés comme n'importe quel utilisateur ou groupe. Si PAM n'est pas disponible, l'utilisateur root pourra accéder à tous les chroots, même non explicitement autorisé.

note: type: SH
en: CHROOT NAMESPACES
de: ESPACES DE NOMS CHROOT

note: type: SS
en: Namespace basics
de: Bases des espaces de noms

note: type: Plain text
en: There are three different types of chroot: regular chroots, source chroots and session chroots.  These different types of chroot are separated into different I<namespaces>.  A namespace is a prefix to a chroot name.  Currently there are three namespaces: \[oq]chroot:\[cq], \[oq]source:\[cq] and \[oq]session:\[cq].  Use I<--list --all> to list all available chroots in all namespaces.  Because \[oq]:\[cq] is used as the separator between namespace and chroot names, it is not permitted to use this character in chroot names.
de: Il y a trois types de chroot différents : les chroots réguliers, les chroots source et les chroots session. Ces différents types de chroot sont séparés dans différents I<espaces de noms>. Un espace de noms est un préfixe à un nom de chroot. Pour le moment il y a trois espaces de noms : \[oq]chroot:\[cq], \[oq]source:\[cq] et \[oq]session:\[cq]. Utilisez I<--list --all> pour lister tous les chroots disponibles dans tous les espaces de noms. Parce que  \[oq]:\[cq] est utilisé comme séparateur entre l'espace de noms et les noms de chroots, il n'est pas permis d'utiliser ce caractère dans les noms de chroot.

note: type: Plain text
en: Depending upon the action you request schroot to take, it may look for the chroot in one of the three namespaces, or a particular namespace may be specified.  For example, a chroot named \[lq]sid\[rq] is actually named \[lq]chroot:sid\[rq] if the namespace is included, but the namespace may be omitted for most actions.
de: En fonction de l'action que vous demandez à schroot d'exécuter, celui-ci peut rechercher le chroot dans l'un de ces trois espaces de noms, ou un espace de noms particulier peut être spécifié. Par exemple, un chroot nommé \[lq]sid\[rq] est en fait nommé \[lq]chroot:sid\[rq] si l'espace de noms est inclus, mais l'espace de noms peut être omis pour la plupart des actions.

note: type: SS
en: Source chroots
de: Chroots source

note: type: Plain text
en: Some chroot types, for example LVM snapshots and Btrfs snapshots, provide session-managed copy-on-write snapshots of the chroot.  These also provide a I<source chroot> to allow easy access to the filesystem used as a source for snapshotting.  These are regular chroots as well, just with the snapshotting disabled.  For a chroot named \[lq]sid-snapshot\[rq] (i.e. with a fully qualified name of \[lq]chroot:sid-snapshot\[rq]), there will also be a corresponding source chroot named \[lq]source:sid-snapshot\[rq].  Earlier versions of schroot provided source chroots with a \[oq]-source\[cq] suffix.  These are also provided for compatibility.  In this example, this would be called \[lq]chroot:sid-snapshot-source\[rq].  These compatibility names will be dropped in a future version, so programs and scripts should switch to using the namespace-qualified names rather than the old suffix.
de: Certains types de chroot comme par exemple les clichés LVM ou Btrfs, fournissent des clichés du chroot de type « copie en cas d'écriture » contrôlés par la session. Ils fournissent également un I<chroot source> pour permettre un accès facile au système de fichiers utilisé comme source de cliché. Ce sont des chroots réguliers également, en désactivant le cliché. Pour un chroot nommé \[lq]sid-snapshot\[rq] (c'est-à-dire avec \[lq]chroot:sid-snapshot\[rq] comme nom complet qualifié), il y aura également un chroot source nommé \[lq]source:sid-snapshot\[rq]. Les versions précédentes de schroot fournissent des chroots source avec un suffixe \[oq]-source\[cq]. Ces suffixes sont également fournis à des fins de compatibilité. Dans notre exemple il serait appelé \[lq]chroot:sid-snapshot-source\[rq]. Cette dénomination de compatibilité sera abandonnée dans une version future, les programmes et les scripts devraient donc être modifiés pour utiliser des noms utilisant les espaces de noms au lieu des vieux suffixes.

note: type: SS
en: Session chroots
de: Chroots session

note: type: Plain text
en: All sessions created with I<--begin-session> are placed within the \[oq]session:\[cq] namespace.  A session named with I<--session-name> may have any name, even the same name as the chroot it was created from, providing that it is unique within this namespace.  This was not permitted in previous versions of schroot which did not have namespaces.
de: Toute session créée avec l'option I<--begin-session> est placée dans l'espace de noms \[oq]session:\[cq]. Une session nommée avec I<--session-name> peut avoir différents noms, même un nom identique au chroot à partir duquel elle a été créée, à condition qu'il soit unique dans l'espace de noms. Cela n'était pas permis dans les versions précédentes de schroot qui n'avait pas d'espaces de noms.

note: type: SS
en: Actions and default namespaces
de: Actions et espaces de noms par défaut

note: type: Plain text
en: All actions use \[oq]chroot:\[cq] as the default namespace, with some session actions being the exception.  I<--run-session>, I<--recover-session> and I<--end-session> use \[oq]session:\[cq] as the default namespace instead, since these actions work on session chroots.  The upshot is that the namespace is usually never required except when you need to work with a chroot in a namespace other than the default, such as when using a source chroot.  To make chroot selection unambiguous, it is always possible to use the full name including the namespace, even when not strictly required.
de: Toutes les actions utilisent \[oq]chroot:\[cq] comme espace de noms par défaut, avec quelques exceptions pour des actions de sessions. I<--run-session>, I<--recover-session> et I<--end-session> utilisent \[oq]session:\[cq] comme espace de noms par défaut, car ces actions agissent sur les chroots session. Le résultat est que l'espace de noms n'est normalement jamais requis, sauf quand vous avez besoin de travailler avec un chroot dans un espace de noms différent de celui par défaut, comme lorsque vous utilisez un chroot source. Pour effectuer une sélection de chroot sans ambigüité, il est toujours possible d'utiliser le nom complet incluant l'espace de noms, même quand cela n'est pas strictement nécessaire.

note: type: SH
en: PERFORMANCE
de: PERFORMANCES

note: type: Plain text
en: Performance on some filesystems, for example Btrfs, is bad when running dpkg due to the amount of fsync operations performed.  This may be mitigated by installing the eatmydata package and then adding eatmydata to the \f[CI]command-prefix\fR configuration key, which disables all fsync operations.  Note that this should only be done in snapshot chroots where data loss is not an issue.  This is useful when using a chroot for package building, for example.
de: Les performances sur certains systèmes de fichiers, par exemple Btrfs, sont mauvaises lors de l'utilisation de dpkg à cause de la quantité d'opérations fsync à effectuer. Cela peut être limité par l'installation du paquet eatmydata et ensuite par l'ajout de eatmydata à la clé de configuration \f[CI]command-prefix\fR, ce qui désactivera toutes les opérations fsync. Notez que cela ne doit être effectué que dans les chroots clichés où la perte de données n'est pas un problème. C'est utile lors de l'utilisation d'un chroot pour une construction de paquets, par exemple.

note: type: SH
en: DIRECTORY FALLBACKS
de: RÉPERTOIRES DE SUBSTITUTION

note: type: Plain text
en: schroot will select an appropriate directory to use within the chroot based upon whether an interactive login shell will be used, or a command invoked, and additionally if the I<--directory> option is used.  In the case of running commands directly, or explicitly specifying a directory, only one directory will be used for safety and consistency, while for a login shell several possibilities may be tried.  The following subsections list the fallback sequence for each case.  CWD is the current working directory, DIR is the directory specified with I<--directory>.
de: schroot sélectionnera un répertoire approprié à utiliser à l'intérieur du chroot si un interpréteur de commande de connexion est utilisé ou une commande exécutée et également si l'option I<--directory> est utilisée. Dans le cas de l'exécution directe ou en spécifiant explicitement un répertoire, seulement un répertoire sera utilisé par mesure de sécurité et de cohérence, alors que pour un interpréteur de commande de connexion plusieurs possibilités peuvent être testées. La sous-section suivante liste la séquence de substitution pour chaque cas. CWD est le répertoire de travail courant, DIR est le répertoire spécifié par I<--directory>.

note: type: SS
en: Login shell
de: Interpréteur de commande de connexion

note: type: tbl table
en: (Host \[-E<gt>] Chroot)	Comment
de: (Hôte \[-E<gt>] Chroot)	Commentaire

note: type: tbl table
en: Normal behaviour (if I<--directory> is not used)
de: Comportement normal (si I<--directory> n'est pas utilisé)

note: type: tbl table
en: If CWD is nonexistent and --preserve-environment is used
de: Si CWD n'existe pas et --preserve-environment est utilisé

note: type: tbl table
en: If CWD is nonexistent (or --preserve-environment is used and no $HOME exists)
de: Si CWD n'existe pas (ou --preserve-environment est utilisé et aucun $HOME n'existe)

note: type: tbl table
en: None of the above exist
de: Aucun des répertoires ci-dessus n'existe

note: type: tbl table
en: If / is nonexistent
de: Si / n'existe pas

note: type: SS
en: Command
de: Commande

note: type: tbl table
en: If CWD is nonexistent
de: Si CWD n'existe pas

note: type: Plain text
en: No fallbacks should exist under any circumstances.
de: Aucune solution de repli ne devrait exister en toute circonstance.

note: type: SS
en: --directory used
de: utilisation de --directory

note: type: tbl table
en: CWD \[-E<gt>] DIR	Normal behaviour
de: CWD \[-E<gt>] DIR	Comportement normal

note: type: tbl table
en: B<FAIL>	If DIR is nonexistent
de: B<FAIL>	Si DIR n'existe pas

note: type: SS
en: Debugging
de: Débogage

note: type: Plain text
en: Note that I<--debug=notice> will show the internal fallback list computed for the session.
de: Notez que I<--debug=notice> affichera la liste interne des répertoires de repli calculée pour la session.

note: type: SS
en: List available chroots
de: Lister les chroots disponibles

note: type: SS
en: Get information about a chroot
de: Récupérer les informations d'un chroot

note: type: Plain text
en: Use I<--all> or I<-c> multiple times to use all or multiple chroots, respectively.
de: Utilisez I<-c> ou I<--all> plusieurs fois pour utiliser plusieurs ou tous les chroots respectivement.

note: type: SS
en: Running commands in a chroot
de: Exécuter des commandes dans un chroot

note: type: Plain text
en: Use I<--> to allow options beginning with \[oq]-\[cq] or \[oq]--\[cq] in the command to run in the chroot.  This prevents them being interpreted as options for schroot itself.  Note that the top line was echoed to standard error, and the remaining lines to standard output.  This is intentional, so that program output from commands run in the chroot may be piped and redirected as required; the data will be the same as if the command was run directly on the host system.
de: Utilisez I<--> pour autoriser les options débutant avec \[oq]-\[cq] ou \[oq]--\[cq] pour la commande à exécuter dans le chroot. Cela empêche qu'elles soient interprétées en tant qu'options de schroot. Notez que la première ligne a été affichée sur l'erreur standard, et le reste sur la sortie standard. C'est intentionnel, pour que la sortie du programme exécuté dans le chroot puisse être redirigée via un pipe ou autre si besoin ; les données seront les mêmes que si la commande était exécutée directement sur le système hôte.

note: type: SS
en: Switching users
de: Changer d'utilisateur

note: type: Plain text
en: If the user \[oq]rleigh\[cq] was in \f[CI]root-users\fR in I<\*[SCHROOT_CONF]>, or one of the groups he belonged to was in \f[CI]root-groups\fR, they would be granted root access without authentication, but the PAM authorisation step is still applied.
de: Si l'utilisateur \[oq]rleigh\[cq] était dans \f[CI]root-users\fR de I<\*[SCHROOT_CONF]>, ou un des groupes auxquels il appartient était dans \f[CI]root-groups\fR, un accès root lui sera fourni sans authentification, mais l'étape d'autorisation PAM est toujours appliquée.

note: type: Plain text
en: A chroot may be needed to run more than one command.  In particular, where the chroot is created on the fly from an LVM LV or a file on disc, there is a need to make the chroot persistent while a given task (or set of tasks) is performed.  Sessions exist for this purpose.  For simple chroot types such as \[oq]plain\[cq] and \[oq]directory\[cq], sessions may be created but are not strictly necessary.
de: Un chroot peut être nécessaire pour exécuter plus d'une commande. En particulier, quand le chroot est créé à la volée à partir d'un volume logique LVM ou d'un fichier sur le disque, il est nécessaire de rendre le chroot persistant pendant qu'une tâche donnée (ou un jeu de tâches) est exécutée. Les sessions existent pour cette raison. Pour les chroots de type simple comme \[oq]plain\[cq] et \[oq]directory\[cq], des sessions peuvent être créées mais ne sont pas strictement nécessaires.

note: type: Plain text
en: Let's start by looking at a session-capable chroot:
de: Commençons par examiner un chroot capable d'utiliser des sessions :

note: type: Plain text
en: Note that the I<Session Managed> option is set to \[oq]true\[cq].  This is a requirement in order to use session management, and is supported by most chroot types.  Next, we will create a new session:
de: Notez que l'option I<Session Managed> est définie à \[oq]true\[cq]. Cela est requis pour utiliser le gestionnaire de session et est pris en charge par la plupart des types de chroot. Ensuite nous allons créer une nouvelle session :

note: type: Plain text
en: The session ID of the newly-created session is returned on standard output.  It is common to store it like this:
de: L'identifiant de session de la session nouvellement créée est retourné sur la sortie standard. Il est habituel de le conserver comme ceci :

note: type: Plain text
en: The session may be used just like any normal chroot.  This is what the session looks like:
de: La session peut être utilisée comme n'importe quel chroot. Voici à quoi ressemble la session :

note: type: Plain text
en: Now the session has been created, commands may be run in it:
de: Maintenant que la session a été créée, il est possible d'exécuter des commandes comme ceci :

note: type: Plain text
en: When all the commands to run in the session have been performed, the session may be ended:
de: Quand toutes les commandes à exécuter dans la session ont été effectuées, la session peut être terminée :

note: type: Plain text
en: Finally, the session names can be long and unwieldy.  A name may be specified instead of using the automatically generated session ID:
de: Finalement, les noms de session peuvent être longs et peu maniables. Un nom peut être spécifié à la place de l'identifiant de session généré automatiquement :

note: type: Plain text
en: \f[CR]% \f[CB]schroot -b -c sid-snap -n my-session-name\f[CB]\[CR]
    \f[CR]my-session-name\fR
de: \f[CR]% \f[CB]schroot -b -c sid-snap -n mon-nom-session\f[CB]\[CR]
    \f[CR]mon-nom-session\fR

note: type: SH
en: TROUBLESHOOTING
de: DÉPANNAGES

note: type: Plain text
en: If something is not working, and it's not clear from the error messages what is wrong, try using the B<--debug=>I<level> option to turn on debugging messages.  This gives a great deal more information.  Valid debug levels are \[oq]none\[cq], and \[oq]notice\[cq], \[oq]info\[cq], \[oq]warning\[cq] and \[oq]critical\[cq] in order of increasing severity.  The lower the severity level, the more output.
de: Si quelque chose ne fonctionne pas, et qu'il n'est pas facile de déterminer ce qui ne va pas à partir des messages d'erreur, vous pouvez utiliser l'option B<--debug=>I<niveau> pour activer les messages de débogage. Cela donnera un plus grand nombre d'informations. Les niveaux de débogage valides sont \[oq]none\[cq], \[oq]notice\[cq], \[oq]info\[cq], \[oq]warning\[cq] et \[oq]critical\[cq] par ordre croissant de sévérité. Plus le niveau de sévérité est faible, plus il y a de sortie.

note: type: Plain text
en: If you are still having trouble, the developers may be contacted on the mailing list:
de: Si vous avez toujours des problèmes, les développeurs peuvent être contactés sur la liste de diffusion (en anglais) :

note: type: Plain text
en: On the B<mips> and B<mipsel> architectures, Linux kernels up to and including at least version 2.6.17 have broken B<personality>(2)  support, which results in a failure to set the personality.  This will be seen as an \[lq]Operation not permitted\[rq] (EPERM) error.  To work around this problem, set \f[CI]personality\fR to \[oq]undefined\[cq], or upgrade to a more recent kernel.
de: Sur les architectures B<mips> et B<mipsel>, les noyaux Linux, jusqu'à la version 2.6.17 incluse, ont une prise en charge cassée des B<personality>(2), qui a pour conséquence un échec de la mise en place des personnalités. Cela se manifeste par une erreur \[lq]Operation not permitted\[rq] (EPERM). Pour contourner ce problème, définissez \f[CI]personality\fR à \[oq]undefined\[cq], ou mettez à jour votre noyau vers une version plus récente.

note: type: Plain text
en: By default, the environment is not preserved, and the following environment variables are defined: HOME, LOGNAME, PATH, SHELL, TERM (preserved if already defined), and USER.  The environment variables SCHROOT_COMMAND, SCHROOT_USER, SCHROOT_GROUP, SCHROOT_UID and SCHROOT_GID are set inside the chroot specifying the command being run, the user name, group name, user ID and group ID, respectively.  Additionally, the environment variables SCHROOT_SESSION_ID, SCHROOT_CHROOT_NAME and SCHROOT_ALIAS_NAME specify the session ID, the original chroot name prior to session creation, and the alias used to originally identify the selected chroot, respectively.
de: Par défaut, l'environnement n'est pas préservé, et les variables d'environnement suivantes sont définies : HOME, LOGNAME, PATH, SHELL, TERM (préservée si déjà spécifiée) et USER. Les variables d'environnement SCHROOT_COMMAND, SCHROOT_USER, SCHROOT_GROUP, SCHROOT_UID et SCHROOT_GID sont définies à l'intérieur du chroot spécifiant respectivement la commande exécutée, le nom d'utilisateur, le nom de groupe, l'identifiant de l'utilisateur et l'identifiant du groupe. En plus, les variables d'environnement SCHROOT_SESSION_ID, SCHROOT_CHROOT_NAME et SCHROOT_ALIAS_NAME définissent respectivement l'identifiant de session, le nom de chroot d'origine avant la création de la session et l'alias utilisé pour identifier le chroot d'origine sélectionné.

note: type: Plain text
en: The following, potentially dangerous, environment variables are removed for safety by default: BASH_ENV, CDPATH, ENV, HOSTALIASES, IFS, KRB5_CONFIG, KRBCONFDIR, KRBTKFILE, KRB_CONF, LD_.*, LOCALDOMAIN, NLSPATH, PATH_LOCALE, RES_OPTIONS, TERMINFO, TERMINFO_DIRS, and TERMPATH.  If desired, the \f[CI]environment-filter\fR configuration key will allow the exclusion list to the modified; see B<schroot.conf>(5)  for further details.
de: Les variables d'environnement, potentiellement dangereuses, suivantes sont retirées par défaut pour des raisons de sécurité : BASH_ENV, CDPATH, ENV, HOSTALIASES, IFS, KRB5_CONFIG, KRBCONFDIR, KRBTKFILE, KRB_CONF, LD_.*, LOCALDOMAIN, NLSPATH, PATH_LOCALE, RES_OPTIONS, TERMINFO, TERMINFO_DIRS, et TERMPATH. Si nécessaire, la clé de configuration \f[CI]environment-filter\fR permettra de modifier la liste d'exclusion. Consultez B<schroot.conf>(5) pour plus de détails.

note: type: SS
en: Configuration files
de: Fichiers de configuration

note: type: Plain text
en: The system-wide chroot definition file.  This file must be owned by the root user, and not be writable by other.
de: Le fichier de configuration des chroots pour l'ensemble du système. Ce fichier doit être possédé par l'utilisateur root, et être non inscriptible par les autres.

note: type: Plain text
en: Additional chroot definitions may be placed in files under this directory.  They are treated in exactly that same manner as I<\*[SCHROOT_CONF]>.  Each file may contain one or more chroot definitions.  Note that the files in this directory follow the same naming rules as B<run-parts>(8)  when run with the I<--lsbsysinit> option.
de: Des définitions de chroot supplémentaires peuvent être placées dans des fichiers de ce répertoire. Elles sont traitées de la même façon que I<\*[SCHROOT_CONF]>. Chaque fichier peut contenir une ou plusieurs définitions de chroot. Notez que les fichiers de ce répertoire suivent les mêmes règles de dénomination que B<run-parts>(8) lorsqu'ils sont exécutés avec l'option I<--lsbsysinit>.

note: type: Plain text
en: The system-wide chroot setup script directories.  See B<schroot-setup>(5).
de: Le répertoire de scripts de mise en place de chroot pour l'ensemble du système. Consultez B<schroot-setup>(5).

note: type: Plain text
en: PAM configuration.
de: Configuration de PAM.

note: type: SS
en: System directories
de: Répertoires systèmes

note: type: Plain text
en: Directory containing helper programs used by setup scripts.
de: Répertoire contenant les programmes d'assistance utilisés par les scripts de mise en place.

note: type: SS
en: Session directories
de: Répertoires de sessions

note: type: Plain text
en: Each directory contains a directory or file with the name of each session.  Not all chroot types make use of all the following directories.
de: Chaque répertoire contient un répertoire ou un fichier avec le nom de chaque session. Tous les types de chroot n'utilisent pas tous les répertoires ci-dessous.

note: type: Plain text
en: Directory containing the session configuration for each active session.
de: Répertoire contenant la configuration de session pour chaque session active.

note: type: Plain text
en: Directory used to mount the filesystems used by each active session.
de: Répertoire utilisé pour monter le système de fichiers utilisé pour chaque session active.

note: type: Plain text
en: Directory used for filesystem union source (underlay).
de: Répertoire utilisé comme source d'union de système de fichiers (sous-couche).

note: type: Plain text
en: Directory used for filesystem union writeable overlay.
de: Répertoire utilisé comme sur-couche inscriptible pour l'union de système de fichiers.

note: type: Plain text
en: Directory used for unpacking file chroots.
de: Répertoire utilisé pour le dépaquetage de chroots de fichiers.

note: type: Plain text
en: schroot-setup - schroot chroot setup scripts
de: schroot-setup — scripts de mise en place des chroots schroot

note: type: Plain text
en: B<schroot> uses scripts to set up and then clean up the chroot environment.  The directory \f[BI]\*[SCHROOT_CONF_SETUP_D]\fR contains scripts run when a chroot is created and destroyed.  Several environment variables are set while the scripts are being run, which allows their behaviour to be customised, depending upon, for example, the type of chroot in use.
de: B<schroot> utilise des scripts pour mettre en place et ensuite nettoyer les environnements de chroot. Le répertoire \f[BI]\*[SCHROOT_CONF_SETUP_D]\fR contient des scripts qui sont exécutés lorsque un chroot est créé ou détruit. Plusieurs variables d'environnements sont définies quand les scripts sont exécutés, ce qui permet de personnaliser leur comportement, par exemple en fonction du type de chroot utilisé.

note: type: Plain text
en: The scripts are run in name order, like those run by B<init>(8), by using the same style of execution as B<run-parts>(8).
de: L'exécution des scripts se fait suivant l'ordre lexical des noms, comme pour ceux exécutés par B<init>(8), en utilisant le même style d'exécution que B<run-parts>(8).

note: type: Plain text
en: The setup scripts are all invoked with two options:
de: Les scripts de mise en place sont tous invoqués avec deux options :

note: type: Plain text
en: The action to perform.
de: L'action à effectuer.

note: type: Plain text
en: When a session is first started, the chroot is set up by running the scripts in \*[SCHROOT_CONF_SETUP_D] with the \[oq]setup-start\[cq] option.  When the session is ended, the scripts in I<\*[SCHROOT_CONF_SETUP_D]> are run in reverse order with the \[oq]setup-stop\[cq] option.
de: Quand une session est lancée, le chroot est mis en place en exécutant les scripts dans \*[SCHROOT_CONF_SETUP_D] avec l'option \[oq]setup-start\[cq]. Quand la session est terminée, les scripts dans I<\*[SCHROOT_CONF_SETUP_D]> sont exécutés dans l'ordre inverse avec l'option \[oq]setup-stop\[cq].

note: type: Plain text
en: The chroot status.
de: Le statut du chroot.

note: type: Plain text
en: This is either \[oq]ok\[cq] if there are no problems, or \[oq]fail\[cq] if something went wrong.  For example, particular actions may be skipped on failure.
de: C'est soit \[oq]ok\[cq] s'il n'y a aucun problème, soit \[oq]fail\[cq] si quelque chose s'est mal passé. Par exemple, certaines actions pourraient être ignorées en cas d'échec.

note: type: Plain text
en: Note that the scripts should be I<idempotent>.  They B<must> be idempotent during the \[oq]setup-stop\[cq] phase, because they may be run more than once, for example on failure.
de: Notez que les scripts devraient être I<idempotent>. Ils B<doivent> être idempotent pendant la phase \[oq]setup-stop\[cq], car ils pourraient être exécutés plus d'une fois, par exemple en cas d'échec.

note: type: SS
en: General variables
de: Variables générales

note: type: Plain text
en: The username of the user the command in the chroot will run as.
de: Le nom d'utilisateur sous lequel la commande sera exécutée dans le chroot.

note: type: Plain text
en: The chroot name.  Note that this is the name of the orignal chroot before session creation; you probably want SESSION_ID.
de: Le nom du chroot. Notez que c'est le nom du chroot d'origine avant la création de session ; vous voulez probablement SESSION_ID.

note: type: Plain text
en: The host system architecture schroot is running upon.  This may be used to introduce architecture-specific behaviour into the setup scripts where required.  HOST is the GNU triplet for the architecture, while HOST_OS, HOST_VENDOR and HOST_CPU are the component parts of the triplet.
de: L'architecture du système hôte sur lequel schroot est exécuté. Cela peut être utilisé pour des comportements spécifiques à l'architecture dans les scripts de mise en place quand cela est nécessaire. HOST est le triplet GNU pour l'architecture, alors que HOST_OS, HOST_VENDOR et HOST_CPU sont les parties composant ce triplet.

note: type: Plain text
en: The directory under which helper programs are located.
de: Le répertoire dans lequel les programmes d'assistance sont localisés.

note: type: Plain text
en: The directory under which non-filesystem chroots are mounted (e.g. block devices and LVM snapshots).
de: Le répertoire dans lequel les chroots non système de fichiers sont montés (par exemple périphériques de blocs et clichés LVM).

note: type: Plain text
en: The process ID of the schroot process.
de: L'identifiant de processus du processus schroot.

note: type: Plain text
en: The operating system platform schroot is running upon.  This may be used to introduce platform-specific behaviour into the setup scripts where required.  Note that the HOST variables are probably what are required.  In the context of schroot, the platform is the supported configuration and behaviour for a given architecture, and may be identical between different architectures.
de: Le système d'exploitation de la plate-forme sur laquelle schroot est exécuté. Il peut être utilisé pour introduire des comportements dépendant de la plate-forme dans les scripts de mise en place quand cela est nécessaire. Notez que les variables HOST sont probablement ce qui est requis. Dans le contexte de schroot, la plate-forme est la configuration prise en charge et le comportement pour une architecture donnée, et peut être identique parmi plusieurs architectures.

note: type: Plain text
en: The session identifier.
de: Identifiant de session.

note: type: Plain text
en: Set to \[oq]quiet\[cq] if only error messages should be printed, \[oq]normal\[cq] if other messages may be printed as well, and \[oq]verbose\[cq] if all messages may be printed.  Previously called AUTH_VERBOSITY.
de: Définir à \[oq]quiet\[cq] si seuls les messages d'erreur doivent être affichés, \[oq]normal\[cq] pour afficher plus de messages et \[oq]verbose\[cq] si tous les messages doivent être affichés. Précédemment appelée AUTH_VERBOSITY.

note: type: Plain text
en: Set to \[oq]true\[cq] if a session will be created, otherwise \[oq]false\[cq].
de: Définir à \[oq]true\[cq] si une session sera créée, sinon \[oq]false\[cq].

note: type: Plain text
en: Set to \[oq]true\[cq] if a session will be cloned, otherwise \[oq]false\[cq].
de: Définir à \[oq]true\[cq] si une session sera clonée, sinon \[oq]false\[cq].

note: type: Plain text
en: Set to \[oq]true\[cq] if a session will be purged, otherwise \[oq]false\[cq].
de: Définir à \[oq]true\[cq] si une session sera purgée, sinon \[oq]false\[cq].

note: type: Plain text
en: The type of the chroot.  This is useful for restricting a setup task to particular types of chroot (e.g. only block devices or LVM snapshots).
de: Le type de chroot. C'est utile pour restreindre une tâche de mise en place à des types de chroot particuliers (par exemple seulement les périphériques de blocs ou les clichés LVM).

note: type: Plain text
en: The name of the chroot.  This is useful for restricting a setup task to a particular chroot, or set of chroots.
de: Le nom du chroot. C'est utile pour restreindre une tâche de mise en place à un chroot particulier ou un ensemble de chroots.

note: type: Plain text
en: The name of the alias used to select the chroot.  This is useful for specialising a setup task based upon one of its alternative alias names, or the default chroot name.  For example, it could be used to specify additional sources in I</etc/apt/sources.list>, such as a stable-security alias for a stable chroot, or an experimental alias for an unstable chroot.
de: Le nom de l'alias utilisé pour sélectionner le chroot. C'est utile pour spécialiser une tâche de mise en place en fonction de l'un de ses noms d'alias, ou le nom par défaut du chroot. Par exemple, il peut être utilisé pour spécifier des sources additionnelles dans I</etc/apt/sources.list>, comme un alias « stable-security » pour un chroot « stable », ou un alias « experimental » pour un chroot « unstable ».

note: type: Plain text
en: The description of the chroot.
de: Description du chroot.

note: type: Plain text
en: The location to mount the chroot.  It is used for mount point creation and mounting.
de: Le lieu de montage du chroot. Il est utilisé pour la création et le montage des points de montage.

note: type: Plain text
en: The location of the chroot inside the mount point.  This is to allow multiple chroots on a single filesystem.  Set for all mountable chroot types.
de: La localisation du chroot à l'intérieur du point de montage. Cela permet d'autoriser plusieurs chroots sur un système de fichiers unique. Définie pour l'ensemble des types de chroot.

note: type: Plain text
en: The absolute path to the chroot.  This is typically CHROOT_MOUNT_LOCATION and CHROOT_LOCATION concatenated together.  This is the path which should be used to access the chroots.
de: Le chemin absolu du chroot. C'est typiquement CHROOT_MOUNT_LOCATION et CHROOT_LOCATION concaténés ensemble. C'est le chemin qui doit être utilisé pour accéder aux chroots.

note: type: SS
en: Plain and directory chroot variables
de: Variables pour les chroots « plain » et « directory »

note: type: Plain text
en: These chroot types use only general variables.
de: Ces types de chroot utilisent uniquement les variables générales.

note: type: SS
en: File variables
de: Variables pour les chroots fichier (« file »)

note: type: Plain text
en: The file containing the chroot files.
de: Le fichier contenant les fichiers du chroot.

note: type: Plain text
en: Set to \[oq]true\[cq] to repack the chroot into an archive file on ending a session, otherwise \[oq]false\[cq].
de: Définir à \[oq]true\[cq] pour recompacter le chroot dans une archive à la fin de la session, sinon \[oq]false\[cq].

note: type: SS
en: Mountable chroot variables
de: Variables pour les chroots montables

note: type: Plain text
en: These variables are only set for directly mountable chroot types.
de: Ces variables sont seulement définies pour les types de chroot montables directement.

note: type: Plain text
en: The device to mount containing the chroot.  mounting.
de: Le périphérique à monter contenant le chroot.

note: type: Plain text
en: Options to pass to B<mount>(8).
de: Les options à passer à B<mount>(8).

note: type: Plain text
en: The location of the chroot inside the mount point.  This allows the existence of multiple chroots on a single filesystem.
de: La localisation du chroot à l'intérieur du point de montage. Permet d'autoriser l'existence de plusieurs chroots sur un système de fichiers unique.

note: type: SS
en: Filesystem union variables
de: Variables pour les chroots d'union de systèmes de fichiers

note: type: Plain text
en: Union filesystem type.
de: Type d'union de systèmes de fichiers.

note: type: Plain text
en: Union filesystem mount options.
de: Options de montage des unions de systèmes de fichiers.

note: type: Plain text
en: Union filesystem overlay directory (writable).
de: Répertoire pour la sur-couche (« overlay ») de l'union de systèmes de fichiers (inscriptible).

note: type: Plain text
en: Union filesystem underlay directory (read-only).
de: Répertoire pour la sous-couche (« underlay ») de l'union de systèmes de fichiers (lecture-seule).

note: type: SS
en: Block device variables
de: Variables des périphériques de type bloc

note: type: Plain text
en: The device containing the chroot root filesystem.  This is usually, but not necessarily, the device which will be mounted.  For example, an LVM snapshot this will be the original logical volume.
de: Le périphérique contenant le système de fichiers root du chroot. C'est normalement, mais non nécessairement, le périphérique qui sera monté. Par exemple pour un cliché LVM, ce sera le volume logique initial.

note: type: SS
en: LVM snapshot variables
de: Variables de clichés LVM

note: type: Plain text
en: Snapshot name to pass to B<lvcreate>(8).
de: Nom du cliché à passer à B<lvcreate>(8).

note: type: Plain text
en: The name of the LVM snapshot device.
de: Le nom du périphérique de cliché LVM.

note: type: Plain text
en: Options to pass to B<lvcreate>(8).
de: Les options à passer à B<lvcreate>(8).

note: type: SS
en: Custom variables
de: Variables personnalisées

note: type: Plain text
en: Custom keys set in I<schroot.conf> will be uppercased and set in the environment as described in B<schroot.conf>(5).
de: Les clés personnalisées définies dans I<schroot.conf> seront capitalisées et définies dans l'environnement comme décrit dans B<schroot.conf>(5).

note: type: SS
en: Setup script configuration
de: Configuration des scripts de mise en place

note: type: Plain text
en: The directory \f[BI]\*[SCHROOT_SYSCONF_DIR]/default\fR contains the default settings used by setup scripts.
de: Le répertoire \f[BI]\*[SCHROOT_SYSCONF_DIR]/default\fR contient les configurations par défaut utilisées par les scripts de mise en place.

note: type: Plain text
en: Main configuration file read by setup scripts.  The format of this file is described in B<schroot-script-config>(5).  This is the default value for the \f[CI]script-config\fR key.  Note that this was formerly named I<\*[SCHROOT_SYSCONF_DIR]/script-defaults>.  The following files are referenced by default:
de: Fichier de configuration principal lu par les scripts de mise en place. Le format de ce fichier est décrit dans B<schroot-script-config>(5). C'est la valeur par défaut pour la clé \f[CI]script-config\fR. Notez que précédemment il était nommé I<\*[SCHROOT_SYSCONF_DIR]/script-defaults>. Les fichiers suivants sont référencés par défaut :

note: type: Plain text
en: A list of files to copy into the chroot from the host system.  Note that this was formerly named I<\*[SCHROOT_SYSCONF_DIR]/copyfiles-defaults>.
de: Une liste des fichiers à copier dans le chroot à partir du système hôte. Notez que précédemment elle était nommée I<\*[SCHROOT_SYSCONF_DIR]/copyfiles-defaults>.

note: type: Plain text
en: A file in the format decribed in B<fstab>(5), used to mount filesystems inside the chroot.  The mount location is relative to the root of the chroot.  Note that this was formerly named I<\*[SCHROOT_SYSCONF_DIR]/mount-defaults>.
de: Un fichier au format décrit dans B<fstab>(5), utilisé pour monter les systèmes de fichiers dans le chroot. Le point de montage est relatif à la racine du chroot. Notez que précédemment il était nommé I<\*[SCHROOT_SYSCONF_DIR]/mount-defaults>.

note: type: Plain text
en: System databases (as described in I</etc/nsswitch.conf> on GNU/Linux systems) to copy into the chroot from the host.  Note that this was formerly named I<\*[SCHROOT_SYSCONF_DIR]/nssdatabases-defaults>.
de: Base de données système (comme décrit dans  I</etc/nsswitch.conf> sur les systèmes GNU/Linux) à copier dans le chroot depuis l'hôte. Notez que précédemment elle était nommée I<\*[SCHROOT_SYSCONF_DIR]/nssdatabases-defaults>.

note: type: SS
en: Setup scripts
de: Scripts de mise en place

note: type: Plain text
en: The directory \f[BI]\*[SCHROOT_CONF_SETUP_D]\fR contains the chroot setup scripts.
de: Le répertoire \f[BI]\*[SCHROOT_CONF_SETUP_D]\fR contient les scripts de mise en place des chroots.

note: type: Plain text
en: Print debugging diagnostics and perform basic sanity checking.
de: Afficher les diagnostics de débogage et exécute des vérifications d'intégrité.

note: type: Plain text
en: Unpack, clean up, and repack file-based chroots.
de: Décompresser, nettoyer, et recompresser les chroots basés sur les fichiers.

note: type: Plain text
en: Create and remove union filesystems.
de: Créer et enlever les unions de système de fichiers.

note: type: Plain text
en: Create and remove LVM snapshots.
de: Créer et enlever les clichés LVM.

note: type: Plain text
en: Mount and unmount filesystems.
de: Monter et démonter les systèmes de fichiers.

note: type: Plain text
en: Sets up the QEMU user emulator using binfmt-support.  This permits a chroot for a different CPU architecture to be used transparently, providing an alternative to cross-compiling or whole-machine emulation.
de: Mettre en place l'émulateur QEMU en utilisant binfmt-support. Cela permet d'utiliser de manière transparente un chroot pour une architecture CPU différente, fournissant une alternative à la compilation croisée ou à l'émulation d'une machine complète.

note: type: Plain text
en: Kill processes still running inside the chroot when ending a session, which would prevent unmounting of filesystems and cleanup of any other resources.
de: Tuer les processus qui continuent à s'exécuter dans le chroot quand une session se termine, qui pourraient empêcher le démontage des systèmes de fichiers et le nettoyage des autres ressources.

note: type: Plain text
en: Copy files from the host system into the chroot.  Configure networking by copying I<hosts> and I<resolv.conf>, for example.
de: Copier les fichiers depuis le système hôte dans le chroot. Par exemple, configure le réseau en copiant I<hosts> et I<resolv.conf>.

note: type: Plain text
en: Configure system databases by copying passwd, shadow, group etc. into the chroot.
de: Configurer les bases de données du système en copiant passwd, shadow, group, etc. dans le chroot.

note: type: Plain text
en: Set the chroot name (I</etc/debian_chroot>) in the chroot.  This may be used by the shell prompt to display the current chroot.
de: Définir le nom de chroot (I</etc/debian_chroot>) dans le chroot. Il peut être utilisé par une invite de commande pour afficher le chroot courant.

note: type: Plain text
en: schroot.conf - chroot definition file for schroot
de: schroot.conf — fichier de définition des chroots de schroot

note: type: Plain text
en: \f[BI]schroot.conf\fR is a plain UTF-8 text file, describing the chroots available for use with schroot.
de: \f[BI]schroot.conf\fR est un fichier texte codé en UTF-8, décrivant les chroots utilisables avec schroot.

note: type: Plain text
en: Comments are introduced following a \[oq]\f[CR]\[sh]\fR\[cq] (\[lq]hash\[rq])  character at the beginning of a line, or following any other text.  All text right of the \[oq]\f[CR]\[sh]\fR\[cq] is treated as a comment.
de: Les commentaires sont préfixés par un caractère \[oq]\f[CR]\[sh]\fR\[cq] (\[lq]hash\[rq]) au début d'une ligne ou à la suite de n'importe quel texte. Tout texte à la droite de \[oq]\f[CR]\[sh]\fR\[cq] est traité comme un commentaire.

note: type: Plain text
en: The configuration format is an INI-style format, split into groups of key-value pairs separated by section names in square brackets.
de: Le format de configuration est de type INI, découpé en groupes de paires clé-valeur séparés par des noms de section entre crochets.

note: type: Plain text
en: A chroot is defined as a group of key-value pairs, which is started by a name in square brackets on a line by itself.  The file may contain multiple groups which therefore define multiple chroots.
de: Un chroot est défini comme un groupe de paires de clé-valeur, qui débute par un nom entre crochets, seul sur une ligne. Le fichier peut contenir plusieurs groupes définissant ainsi plusieurs chroots.

note: type: Plain text
en: A chroot definition is started by the name of the chroot in square brackets.  For example,
de: La définition du chroot débute par son nom entre crochets. Par exemple,

note: type: Plain text
en: The name is subject to certain naming restrictions.  For further details, see the section \[lq]I<Chroot Names>\[rq] below.
de: Le nom est sujet à certaines restrictions de dénomination. Pour plus de détails, consultez la section \[lq]I<Nom de Chroot>\[rq] ci-dessous.

note: type: Plain text
en: This is then followed by several key-value pairs, one per line:
de: S'ensuit ensuite plusieurs paires clé-valeur, une par ligne :

note: type: Plain text
en: The type of the chroot.  Valid types are \[oq]plain\[cq], \[oq]directory\[cq], \[oq]file\[cq], \[oq]loopback\[cq], \[oq]block-device\[cq], \[oq]btrfs-snapshot\[cq] and \[oq]lvm-snapshot\[cq].  If empty or omitted, the default type is \[oq]plain\[cq].  Note that \[oq]plain\[cq] chroots do not run setup scripts and mount filesystems; \[oq]directory\[cq] is recommended for normal use (see \[lq]I<Plain and directory chroots>\[rq], below).
de: Le type de chroot. Les types valides sont \[oq]plain\[cq], \[oq]directory\[cq], \[oq]file\[cq], \[oq]loopback\[cq], \[oq]block-device\[cq], \[oq]btrfs-snapshot\[cq] et \[oq]lvm-snapshot\[cq]. Si vide ou omis, le type par défaut est \[oq]plain\[cq]. Notez que les chroots \[oq]plain\[cq] n'exécutent aucun script de mise en place et ne montent aucun système de fichiers ; \[oq]directory\[cq] est recommandé pour les utilisations normales (consultez \[lq]I<Chroots « plain » et « directory »>\[rq], ci-dessous).

note: type: Plain text
en: A short description of the chroot.  This may be localised for different languages; see the section \[lq]I<Localisation>\[rq] below.
de: Une description courte du chroot. Elle peut être traduite en différentes langues ; consultez la section \[lq]I<Localisation>\[rq] ci-dessous.

note: type: TP
en: \f[CBI]priority=\f[CI]number\fR
de: \f[CBI]priority=\f[CI]nombre\fR

note: type: Plain text
en: Set the priority of a chroot.  \f[CI]number\fR is a positive integer indicating whether a distribution is older than another.  For example, \[lq]oldstable\[rq] and \[lq]oldstable-security\[rq] might be \[oq]0\[cq], while \[lq]stable\[rq] and \[lq]stable-security\[rq] are \[oq]1\[cq], \[lq]testing\[rq] is \[oq]2\[cq] and \[lq]unstable\[rq] is \[oq]3\[cq].  The values are not important, but the difference between them is.  This option is deprecated and no longer used by schroot, but is still permitted to be used; it will be obsoleted and removed in a future release.
de: Définir la priorité d'un chroot. \f[CI]nombre\fR est un entier positif indiquant si une distribution est plus ancienne qu'une autre. Par exemple, \[lq]oldstable\[rq] et \[lq]oldstable-security\[rq] peuvent être \[oq]0\[cq] alors que \[lq]stable\[rq] et \[lq]stable-security\[rq] sont \[oq]1\[cq], \[lq]testing\[rq] est \[oq]2\[cq] et \[lq]unstable\[rq] est \[oq]3\[cq]. Les valeurs ne sont pas importantes, mais les différences entre elles le sont. Cette option est déconseillée et n'est plus utilisée par schroot, mais il est encore permis de l'utiliser, elle deviendra obsolète et sera retirée dans une prochaine version.

note: type: TP
en: \f[CBI]message-verbosity=\f[CI]verbosity\fR
de: \f[CBI]message-verbosity=\f[CI]verbosité\fR

note: type: Plain text
en: Set the verbosity of messages printed by schroot when setting up, running commands and cleaning up the chroot.  Valid settings are \[oq]quiet\[cq] (suppress most messages), \[oq]normal\[cq] (the default) and \[oq]verbose\[cq] (show all messages).  This setting is overridden by the options I<--quiet> and I<--verbose>.
de: Définir la verbosité des messages affichés par schroot lors de la mise en place, de l'exécution des commandes et du nettoyage du chroot. Les paramètres valides sont \[oq]quiet\[cq] (supprime la plupart des messages), \[oq]normal\[cq] (par défaut) et \[oq]verbose\[cq] (affiche tous les messages). Ce paramètre est écrasé par les options I<--quiet> et I<--verbose>.

note: type: TP
en: \f[CBI]users=\f[CI]user1,user2,...\fR
de: \f[CBI]users=\f[CI]utilisateur1,utilisateur2,…\fR

note: type: Plain text
en: A comma-separated list of users which are allowed access to the chroot.  If empty or omitted, no users will be allowed access (unless a group they belong to is also specified in \f[CI]groups\fR).
de: Une liste séparée par des virgules des utilisateurs qui sont autorisés à accéder au chroot. Si vide ou omis, aucun utilisateur ne sera autorisé à accéder au chroot (sauf s'il appartient à un groupe spécifié dans \f[CI]groups\fR).

note: type: TP
en: \f[CBI]groups=\f[CI]group1,group2,...\fR
de: \f[CBI]groups=\f[CI]groupe1,groupe2,...\fR

note: type: Plain text
en: A comma-separated list of groups which are allowed access to the chroot.  If empty or omitted, no groups of users will be allowed access.
de: Une liste séparée par des virgules des groupes qui sont autorisés à accéder au chroot. Si vide ou omis, aucun groupe d'utilisateurs ne sera autorisé à accéder au chroot.

note: type: TP
en: \f[CBI]root-users=\f[CI]user1,user2,...\fR
de: \f[CBI]root-users=\f[CI]utilisateur1,utilisateur2,...\fR

note: type: Plain text
en: A comma-separated list of users which are allowed B<password-less> root access to the chroot.  If empty or omitted, no users will be allowed root access without a password (but if a user or a group they belong to is in \f[CI]users\fR or \f[CI]groups\fR, respectively, they may gain access with a password).  See the section \[lq]I<Security>\[rq] below.
de: Une liste séparée par des virgules d'utilisateurs qui sont autorisés à devenir root dans le chroot B<sans mot de passe>. Si vide ou omis, aucun utilisateur ne sera autorisé à devenir root sans mot de passe (mais si un utilisateur ou un groupe auquel il appartient est dans \f[CI]users\fR ou \f[CI]groups\fR, respectivement, il peut obtenir un accès avec un mot de passe). Consultez la section \[lq]I<Sécurité>\[rq] ci-dessous.

note: type: TP
en: \f[CBI]root-groups=\f[CI]group1,group2,...\fR
de: \f[CBI]root-groups=\f[CI]groupe1,groupe2,...\fR

note: type: Plain text
en: A comma-separated list of groups which are allowed B<password-less> root access to the chroot.  If empty or omitted, no users will be allowed root access without a password (but if a user or a group they belong to is in \f[CI]users\fR or \f[CI]groups\fR, respectively, they may gain access with a password).  See the section \[lq]I<Security>\[rq] below.
de: Une liste séparée par des virgules de groupes qui sont autorisés à devenir root dans le chroot B<sans mot de passe>. Si vide ou omis, aucun utilisateur ne sera autorisé à devenir root sans mot de passe (mais si un utilisateur ou un groupe auquel il appartient est dans \[CI]users\fR ou \f[CI]groups\fR, respectivement, il peut obtenir un accès avec un mot de passe). Consultez la section \[lq]I<Sécurité>\[rq] ci-dessous.

note: type: Plain text
en: A comma-separated list of aliases (alternate names) for this chroot.  For example, a chroot named \[lq]sid\[rq] might have an \[oq]unstable\[cq] alias for convenience.  Aliases are subject to the same naming restrictions as the chroot name itself.
de: Une liste séparée par des virgules des alias (noms alternatifs) pour ce chroot. Par exemple, un chroot, nommé \[lq]sid\[rq] peut avoir un alias \[oq]unstable\[cq] pour des raisons de commodité. Les alias sont sujets aux mêmes restrictions que le nom du chroot lui-même.

note: type: TP
en: \f[CBI]profile=\f[CI]directory\fR
de: \f[CBI]profile=\f[CI]répertoire\fR

note: type: TP
en: \f[CBI]script-config=\f[CI]filename\fR
de: \f[CBI]script-config=\f[CI]nom-de-fichier\fR

note: type: Plain text
en: The behaviour of the chroot setup scripts may be customised on a per-chroot basis by setting a specific configuration profile.  The directory is relative to I<\*[SCHROOT_SYSCONF_DIR]>.  The default is \[oq]default\[cq].  The files in this directory are sourced by the setup scripts, and so their behaviour may be customised by selecting the appropriate profile.  Alternatives are \[oq]minimal\[cq] (minimal configuration), \[oq]desktop\[cq] (for running desktop applications in the chroot, making more functionality from the host system available in the chroot) and \[oq]sbuild\[cq] (for using the chroot for Debian package building).  Other packages may provide additional profiles.  The default values of the keys \f[CI]setup.config\fR, \f[CI]setup.copyfiles\fR, \f[CI]setup.fstab\fR and \f[CI]setup.nssdatabases\fR are set based upon the \f[CI]profile\fR setting.
de: Le comportement des scripts de mise en place des chroots peut être personnalisé pour chaque chroot en définissant un profil de configuration spécifique. Le nom du répertoire est relatif à <\*[SCHROOT_SYSCONF_DIR]>. Le nom par défaut est \[oq]default\[cq]. Les fichiers de ce répertoire seront sourcés par les scripts de mise en place, et leur comportement peut par conséquent être personnalisé en sélectionnant le profil approprié. Les alternatives sont \[oq]minimal\[cq] (pour une configuration minimale), \[oq]desktop\[cq] (pour exécuter des programmes graphiques dans un chroot, autorisant plus de fonctionnalités du système hôte disponibles dans le chroot) et \[oq]sbuild\[cq] (pour utiliser le chroot pour la construction de paquet Debian). D'autres paquets peuvent fournir des profils supplémentaires. La valeur par défaut des clés \f[CI]setup.config\fR, \f[CI]setup.copyfiles\fR, \f[CI]setup.fstab\fR et \f[CI]setup.nssdatabases\fR est définie en fonction de la configuration de \f[CI]profile\fR.

note: type: Plain text
en: Desktop users should note that the fstab file I<desktop/fstab> will need editing if you use gdm3; please see the comments in this file for further instructions.  The \f[CI]preserve-environment\fR key should also be set to \[oq]true\[cq] so that the environment is preserved inside the chroot.
de: À noter pour les utilisateurs graphiques que le fichier fstab I<desktop/fstab> aura besoin d'une modification si vous utilisez gdm3 ; veuillez consulter les commentaires dans ce fichier pour plus d'information. La clé \f[CI]preserve-environment\fR doit être définie à \[oq]true\[cq] pour que l'environnement soit préservé dans le chroot.

note: type: Plain text
en: If none of the configuration profiles provided above meet your needs, then they may be edited to further customise them, and/or copied and used as a template for entirely new profiles.
de: Si aucun des profils de configuration fournis ci-dessus ne convient à vos besoins, ils peuvent être édités pour les personnaliser davantage, et/ou copiés et utilisés en tant que modèles pour de tout nouveau profil.

note: type: Plain text
en: Note that the different profiles have different security implications; see the section \[lq]I<Security>\[rq] below for further details.
de: Notez que les différents profils ont des implications de sécurité différentes ; consultez la section \[lq]I<Sécurité>\[rq] ci-dessous pour plus d'informations.

note: type: TP
en: \f[CBI]setup.config=\f[CI]filename\fR
de: \f[CBI]setup.config=\f[CI]nom-de-fichier\fR

note: type: Plain text
en: This key specifies a file which the setup scripts will source when they are run.  This defaults to the same value as set by \f[CI]script-config\fR.  The file is a Bourne shell script, and in consequence may contain any valid shell code, in addition to simple variable assignments.  This will, for example, allow behaviour to be customised according to the specific chroot type or name.  Note that the script will be sourced once for each and every script invocation, and must be idempotent.
de: Cette clé spécifie un fichier que les scripts de mise en place vont sourcer quand ils seront exécutés. La valeur par défaut est celle définie par \f[CI]script-config\fR. Le fichier est un script de type Bourne shell, et par conséquent peut contenir tout code shell valide, en plus des simples affectations de variable. Cela permet, par exemple, d'adapter les comportements en fonction d'un type spécifique ou nom de chroot. Notez que le script sera chargé à chaque invocation des scripts de mise en place et doit être idempotent.

note: type: TP
en: \f[CBI]setup.copyfiles=\f[CI]filename\fR
de: \f[CBI]setup.copyfiles=\f[CI]nom-de-fichier\fR

note: type: Plain text
en: A file containing a list of files to copy into the chroot (one file per line).  The file will have the same absolute location inside the chroot.
de: Un fichier contenant une liste de fichiers à copier dans le chroot (un fichier par ligne). Le fichier aura le même chemin absolu dans le chroot.

note: type: TP
en: \f[CBI]setup.fstab=\f[CI]filename\fR
de: \f[CBI]setup.fstab=\f[CI]nom-de-fichier\fR

note: type: TP
en: \f[CBI]setup.nssdatabases=\f[CI]filename\fR
de: \f[CBI]setup.nssdatabases=\f[CI]nom-de-fichier\fR

note: type: Plain text
en: A file listing the system databases to copy into the chroot.  The default databases are \[oq]passwd\[cq], \[oq]shadow\[cq], \[oq]group\[cq] and \[oq]gshadow\[cq].  Other potential databases which could be added include \[oq]services\[cq], \[oq]protocols\[cq], \[oq]networks\[cq], and \[oq]hosts\[cq].  The databases are copied using B<getent>(1)  so all database sources listed in I</etc/nsswitch.conf> will be used for each database.
de: Un fichier listant les bases de données du système à copier dans le chroot. Les bases de données par défaut sont \[oq]passwd\[cq], \[oq]shadow\[cq], \[oq]group\[cq] et \[oq]gshadow\[cq]. Les autres bases de données qui pourraient être ajoutés incluent \[oq]services\[cq], \[oq]protocols\[cq], \[oq]networks\[cq], et \[oq]hosts\[cq]. Les bases de données sont copiées en utilisant B<getent>(1) pour que toutes les sources de bases de données listées dans I</etc/nsswitch.conf> soient utilisées pour chaque base de données.

note: type: TP
en: \f[CBI]command-prefix=\f[CI]command,option1,option2,...\fR
de: \f[CBI]command-prefix=\f[CI]commande,option1,option2,...\fR

note: type: Plain text
en: A comma-separated list of a command and the options for the command.  This command and its options will be prefixed to all commands run inside the chroot.  This is useful for adding commands such as nice, ionice or eatmydata for all commands run inside the chroot.  nice and ionice will affect CPU and I/O scheduling.  eatmydata ingores filesystem fsync operations, and is useful for throwaway snapshot chroots where you don't care about dataloss, but do care about high speed.
de: Une liste séparée par des virgules d'une commande et des options de la commande. Cette commande et ses options seront préfixées à toutes les commandes exécutées dans le chroot. C'est utile pour ajouter des commandes comme nice, ionice ou eatmydata pour toutes les commandes exécutées dans le chroot. nice et ionice affecteront l'ordonnancement CPU et I/O. eatmydata ignore les opérations fsync sur le système de fichiers et est utile pour les chroots clichés jetables où vous ne vous souciez pas des pertes de données, mais désirez une grande vitesse.

note: type: Plain text
en: Set the personality (process execution domain) to use.  This option is useful when using a 32-bit chroot on 64-bit system, for example.  Valid options on Linux are \[oq]bsd\[cq], \[oq]hpux\[cq], \[oq]irix32\[cq], \[oq]irix64\[cq], \[oq]irixn32\[cq], \[oq]iscr4\[cq], \[oq]linux\[cq], \[oq]linux32\[cq], \[oq]linux_32bit\[cq], \[oq]osf4\[cq], \[oq]osr5\[cq], \[oq]riscos\[cq], \[oq]scorvr3\[cq], \[oq]solaris\[cq], \[oq]sunos\[cq], \[oq]svr4\[cq], \[oq]uw7\[cq], \[oq]wysev386\[cq], and \[oq]xenix\[cq].  The default value is \[oq]linux\[cq].  There is also the special option \[oq]undefined\[cq] (personality not set).  For a 32-bit chroot on a 64-bit system, \[oq]linux32\[cq] is the option required.  The only valid option for non-Linux systems is \[oq]undefined\[cq].  The default value for non-Linux systems is \[oq]undefined\[cq].
de: Définir les personnalités (domaine d'exécution des processus) à utiliser. Cette option est utile par exemple lors de l'utilisation d'un chroot 32 bits sur un système 64 bits. Les options valides sous Linux sont \[oq]bsd\[cq], \[oq]hpux\[cq], \[oq]irix32\[cq], \[oq]irix64\[cq], \[oq]irixn32\[cq], \[oq]iscr4\[cq], \[oq]linux\[cq], \[oq]linux32\[cq], \[oq]linux_32bit\[cq], \[oq]osf4\[cq], \[oq]osr5\[cq], \[oq]riscos\[cq], \[oq]scorvr3\[cq], \[oq]solaris\[cq], \[oq]sunos\[cq], \[oq]svr4\[cq], \[oq]uw7\[cq], \[oq]wysev386\[cq] et \[oq]xenix\[cq]. La valeur par défaut est \[oq]linux\[cq]. Il y a aussi l'option spéciale \[oq]undefined\[cq] (personnalité non définie). Pour un chroot 32 bits sur un système 64 bits, \[oq]linux32\[cq] est l'option requise. La seule option valide pour les systèmes non Linux est \[oq]undefined\[cq]. La valeur par défaut pour les systèmes non Linux est \[oq]undefined\[cq].

note: type: Plain text
en: By default, the environment will not be preserved inside the chroot, instead a minimal environment will be used.  Set to \f[CI]true\fR to always preserve the environment.  This is useful for example when running X applications inside the chroot, which need the environment to function correctly.  The environment may also be preserved using the I<--preserve-environment> option.
de: Par défaut, l'environnement ne sera pas préservé à l'intérieur du chroot. À la place un environnement minimal sera utilisé. Définir à \f[CI]true\fR pour toujours préserver l'environnement. C'est utile par exemple lors de l'exécution des applications graphiques à l'intérieur du chroot, qui ont besoin de l'environnement pour fonctionner correctement. L'environnement peut également être préservé en utilisant l'option I<--preserve-environment>

note: type: Plain text
en: When running a login shell a number of potential shells will be considered, in this order: the command in the SHELL environment variable (if I<--preserve-environment> is used, or \f[CI]preserve-environment\fR is enabled), the user's shell in the \[oq]passwd\[cq] database, I</bin/bash> and finally I</bin/sh>.  This setting overrides this list, and will use the shell specified.  It may be overridden using the I<--shell> option.
de: Lors de l'exécution d'un interpréteur de commande de connexion plusieurs interpréteurs de commandes potentiels seront considérés dans cet ordre : la commande dans la variable d'environnement SHELL (si l'option I<--preserve-environment> est utilisée ou si \f[CI]preserve-environment\fR est activé), l'interpréteur de commandes de l'utilisateur dans la base de données \[oq]passwd\[cq], I</bin/bash> et finalement I</bin/sh>. Ce paramètre écrase cette liste et utilisera l'interpréteur de commandes spécifié. Il peut être écrasé en utilisant l'option I<--shell>.

note: type: Plain text
en: The environment to be set in the chroot will be filtered in order to remove environment variables which may pose a security risk.  Any environment variable matching the specified POSIX extended regular expression will be removed prior to executing any command in the chroot.
de: L'environnement à définir dans le chroot sera filtré dans le but d'enlever les variables d'environnement qui peuvent poser un problème de sécurité. Toute variable d'environnement qui correspondrait à l'expression régulière POSIX étendue spécifiée sera supprimée avant l'exécution de toute commande dans le chroot.

note: type: Plain text
en: Potentially dangerous environment variables are removed for safety by default using the following regular expression:
de: Les variables d'environnement potentiellement dangereuses sont retirées par sécurité par défaut en utilisant l'expression régulière suivante :

note: type: SS
en: Plain and directory chroots
de: Chroots « plain » et « directory »

note: type: Plain text
en: Chroots of type \[oq]plain\[cq] or \[oq]directory\[cq] are directories accessible in the filesystem.  The two types are equivalent except for the fact that directory chroots run setup scripts, whereas plain chroots do not.  In consequence, filesystems such as I</proc> are not mounted in plain chroots; it is the responsibility of the system administrator to configure such chroots by hand, whereas directory chroots are automatically configured.  Additionally, directory chroots implement the B<filesystem union chroot> options (see \[lq]I<Filesystem Union chroot options>\[rq], below).
de: Les chroots de type \[oq]plain\[cq] ou \[oq]directory\[cq] sont des répertoires accessibles dans le système de fichiers. Les deux types sont équivalents à l'exception du fait que les chroots « directory » exécutent les scripts de mise en place tandis que les chroots « plain » non. Par conséquent, les systèmes de fichiers comme I</proc> ne sont pas montés dans les chroots « plain » ; c'est la responsabilité de l'administrateur de configurer manuellement ces types de chroot alors que les chroots « directory » sont automatiquement configurés. De plus, les chroots « directory » implémentent les options des B<chroots unions de systèmes de fichiers> (consultez \[lq]I<Options des chroots union de systèmes de fichiers> ci-dessous)

note: type: Plain text
en: These chroot types have an additional (mandatory) configuration option:
de: Ces types de chroot ont une option de configuration supplémentaire (requise) :

note: type: TP
en: \f[CBI]directory=\f[CI]directory\fR
de: \f[CBI]directory=\f[CI]répertoire\fR

note: type: Plain text
en: The directory containing the chroot environment.  This is where the root will be changed to when executing a login shell or a command.  The directory must exist and have read and execute permissions to allow users access to it.  Note that on Linux systems it will be bind-mounted elsewhere for use as a chroot; the directory for \[oq]plain\[cq] chroots is mounted with the I<--rbind> option to B<mount>(8), while for \[oq]directory\[cq] chroots I<--bind> is used instead so that sub-mounts are not preserved (they should be set in the I<fstab> file just like in I</etc/fstab> on the host).
de: Le répertoire contenant l'environnement de chroot. C'est là où la racine sera déplacée lors de l'exécution d'un interpréteur de commande de connexion ou d'une commande. Le répertoire doit exister et être accessible en lecture et exécution pour autoriser les utilisateurs à y accéder. Notez que sur les systèmes Linux il sera monté autre part pour être utilisé comme chroot ; le répertoire pour les chroots \[oq]plain\[cq] est monté avec l'option I<--rbind> pour B<mount>(8), alors que pour les chroots \[oq]directory\[cq] l'option I<--bind> sera utilisée à la place pour que les sous-montages ne soient pas conservés (ils doivent être définis dans le fichier I<fstab> comme dans le fichier I</etc/fstab> de l'hôte).

note: type: SS
en: File chroots
de: Chroots « file »

note: type: Plain text
en: Chroots of type \[oq]file\[cq] are files on the current filesystem containing an archive of the chroot files.  They implement the B<source chroot> options (see \[lq]I<Source chroot options>\[rq], below).  Note that a corresponding source chroot (of type \[oq]file\[cq]) will be created for each chroot of this type; this is for convenient access to the source archive, e.g. for the purpose of updating. These additional options are also implemented:
de: Les chroots de type \[oq]file\[cq] sont des fichiers sur le système de fichiers courant contenant une archive des fichiers du chroot. Ils implémentent les options des B<chroot source> (consultez  \[lq]I<Options des chroots source>\[rq], ci-dessous). Notez qu'un chroot source correspondant (de type \[oq]file\[cq]) sera créé pour chaque chroot de ce type ; c'est pour un accès commode à l'archive source, par exemple dans le but de mettre à jour. Les options supplémentaires suivantes sont aussi implémentées :

note: type: TP
en: \f[CBI]file=\f[CI]filename\fR
de: \f[CBI]file=\f[CI]nom-de-fichier\fR

note: type: Plain text
en: The file containing the archived chroot environment (mandatory).  This must be a tar (tape archive), optionally compressed with gzip or bzip2.  The file extensions used to determine the type are are I<.tar>, I<.tar.gz>, I<.tar.bz2>, I<.tgz>, and I<.tbz>.  This file must be owned by the root user, and not be writable by other.  Note that zip archives are no longer supported; zip was not able to archive named pipes and device nodes, so was not suitable for archiving chroots.
de: Le fichier contenant l'environnement de chroot archivé (requis). Cela doit être une archive tar, optionnellement compressée par gzip ou bzip2. Les extensions de fichier utilisées pour déterminer le type sont I<.tar>, I<.tar.gz>, I<.tar.bz2>, I<.tgz> et I<.tbz>. Ce fichier doit appartenir à l'utilisateur root et être non inscriptible par les autres. Notez que les archives zip ne sont plus gérées ; zip n'était capable d'archiver ni les tubes nommés (« named pipes ») ni les nœuds de périphériques (« device nodes ») et donc n'était pas adéquat pour archiver des chroots.

note: type: TP
en: \f[CBI]location=\f[CI]path\fR
de: \f[CBI]location=\f[CI]chemin\fR

note: type: Plain text
en: This is the path to the chroot I<inside> the archive.  For example, if the archive contains a chroot in I</squeeze>, you would specify \[lq]/squeeze\[rq] here.  If the chroot is the only thing in the archive, i.e. I</> is the root filesystem for the chroot, this option should be left blank, or omitted entirely.
de: C'est le chemin du chroot à l'I<intérieur> de l'archive. Par exemple, si l'archive contient un chroot dans I</squeeze>, vous devriez spécifier ici \[lq]/squeeze\[rq]. Si le chroot est la seule chose à l'intérieur de l'archive, c'est-à-dire si I</> est la racine du système de fichiers pour le chroot, cette option doit être laissée vide, ou omise complètement.

note: type: SS
en: Loopback chroots
de: Chroots loopback

note: type: Plain text
en: Chroots of type \[oq]loopback\[cq] are a filesystem available as a file on disk, accessed via a loopback mount.  The file will be loopback mounted and unmounted on demand.  Loopback chroots implement the B<mountable chroot> and B<filesystem union chroot> options (see \[lq]I<Mountable chroot options>\[rq] and \[lq]I<Filesystem Union chroot options>\[rq], below), plus an additional option:
de: Les chroots de type \[oq]loopback\[cq] sont des systèmes de fichiers disponibles comme des fichiers sur le disque, accessibles par un montage loopback. Le fichier sera monté en loopback et démonté à la demande. Les chroots loopback implémentent les options de B<chroot montable> et de B<chroot d'union de systèmes de fichiers> (consultez \[lq]I<Options de chroot montable>\[rq] et \[lq]I<Options de chroot d'union de systèmes de fichiers>\[rq], ci-dessous), plus une option supplémentaire :

note: type: Plain text
en: This is the filename of the file containing the filesystem, including the absolute path.  For example \[lq]/srv/chroot/sid\[rq].
de: C'est le nom du fichier contenant le système de fichiers, incluant le chemin absolu. Par exemple, \[lq]/srv/chroot/sid\[rq].

note: type: SS
en: Block device chroots
de: Chroots périphérique de blocs (« block device »).

note: type: Plain text
en: Chroots of type \[oq]block-device\[cq] are a filesystem available on an unmounted block device.  The device will be mounted and unmounted on demand.  Block device chroots implement the B<mountable chroot> and B<filesystem union chroot> options (see \[lq]I<Mountable chroot options>\[rq] and \[lq]I<Filesystem Union chroot options>\[rq], below), plus an additional option:
de: Les chroots de type \[oq]block-device\[cq] sont des systèmes de fichiers disponibles sur un périphérique bloc non monté. Le périphérique sera monté et démonté à la demande. Les chroots périphériques bloc implémentent les options B<chroot montable> et B<chroot d'union de systèmes fichiers> (consultez \[lq]I<Options des chroots montables>\[rq] et \[lq]I<Options des chroots d'union de systèmes de fichiers>\[rq] ci-dessous) et une option supplémentaire :

note: type: TP
en: \f[CBI]device=\f[CI]device\fR
de: \f[CBI]device=\f[CI]périphérique\fR

note: type: Plain text
en: This is the device name of the block device, including the absolute path.  For example, \[lq]/dev/sda5\[rq].
de: C'est le nom du périphérique contenant le périphérique bloc, incluant le chemin absolu. Par exemple, \[lq]/dev/sda5\[rq].

note: type: SS
en: Btrfs snapshot chroots
de: Chroots clichés Btrfs

note: type: Plain text
en: Chroots of type \[oq]btrfs-snapshot\[cq] are a Btrfs snapshot created from an existing Btrfs subvolume on a mounted Btrfs filesystem.  A snapshot will be created from this source subvolume on demand at the start of a session, and then the snapshot will be mounted.  At the end of the session, the snapshot will be unmounted and deleted.  This chroot type implements the B<source chroot> options (see \[lq]I<Source chroot options>\[rq], below).  Note that a corresponding source chroot (of type \[oq]directory\[cq]) will be created for each chroot of this type; this is for convenient access to the source volume. These additional options are also implemented:
de: Les chroots de type \[oq]btrfs-snapshot\[cq] sont des clichés Btrfs créés à partir d'un sous-volume Btrfs existant sur un système de fichiers Btrfs monté. Un cliché sera créé à partir de ce sous-volume source à la demande au démarrage d'une session et le cliché sera monté. À la fin de la session, le cliché sera démonté et supprimé. Ce type de chroot implémentent les options de B<chroots source> (consultez \[lq]I<Options de chroots source>\[rq] ci-dessous). Notez qu'un chroot source correspondant (de type \[oq]directory\[cq]) sera créé pour chaque chroot de ce type ; c'est pour un accès commode au volume source. Les options supplémentaires suivantes sont également implémentées :

note: type: TP
en: \f[CBI]btrfs-source-subvolume=\f[CI]directory\fR
de: \f[CBI]btrfs-source-subvolume=\f[CI]répertoire\fR

note: type: Plain text
en: The directory containing the source subvolume.
de: Le répertoire contenant le sous-volume source.

note: type: TP
en: \f[CBI]btrfs-snapshot-directory=\f[CI]directory\fR
de: \f[CBI]btrfs-snapshot-directory=\f[CI]répertoire\fR

note: type: Plain text
en: The directory in which to store the snapshots of the above source subvolume.
de: Le répertoire dans lequel les clichés du sous-volume ci-dessus seront enregistrés.

note: type: SS
en: LVM snapshot chroots
de: Chroots clichés LVM

note: type: Plain text
en: Chroots of type \[oq]lvm-snapshot\[cq] are a filesystem available on an LVM logical volume (LV).  A snapshot LV will be created from this LV on demand, and then the snapshot will be mounted.  At the end of the session, the snapshot LV will be unmounted and removed.
de: Les chroots de type \[oq]lvm-snapshot\[cq] sont des systèmes de fichiers disponibles sur un volume logique LVM (LV). Un cliché LV sera créé à partir de ce LV à la demande, ce dernier sera ensuite monté. À la fin de la session, le cliché LV sera démonté et supprimé.

note: type: Plain text
en: LVM snapshot chroots implement the B<source chroot> options (see \[lq]I<Source chroot options>\[rq], below), and all the options for \[oq]block-device\[cq].  Note that a corresponding source chroot (of type \[oq]block-device\[cq]) will be created for each chroot of this type; this is for convenient access to the source device. This additional option is also implemented:
de: Les chroots clichés LVM implémentent les options des B<chroots sources> (consultez \[lq]I<Options des chroots source>\[rq] ci-dessous) et toute les options des \[oq]périphériques bloc\[cq]. Notez qu'un chroot source correspondant (de type \[oq]block-device\[cq]) sera créé pour chaque chroot de ce type ; c'est pour un accès commode au périphérique source. L'option supplémentaire suivante est également implémentée :

note: type: TP
en: \f[CBI]lvm-snapshot-options=\f[CI]snapshot_options\fR
de: \f[CBI]lvm-snapshot-options=\f[CI]options_de_clichés\fR

note: type: Plain text
en: Snapshot options.  These are additional options to pass to lvcreate(8).  For example, \[lq]-L 2g\[rq] to create a snapshot 2 GiB in size.  B<Note:> the LV name (I<-n>), the snapshot option (I<-s>) and the original LV path may not be specfied here; they are set automatically by schroot.
de: Options de clichés. Ce sont les options supplémentaires à passer à lvcreate(8). Par exemple, \[lq]-L 2g\[rq] pour créer des clichés de 2 GiB. B<Note :> le nom du LV (I<-n>), les options des clichés (I<-s>) et le chemin original du LV ne devraient pas être spécifiés ici ; ils sont définis automatiquement par schroot.

note: type: SS
en: Custom chroots
de: Chroots personnalisés

note: type: Plain text
en: Chroots of type \[oq]custom\[cq] are a special type of chroot, used for implementing new types of chroot not supported by any of the above chroot types.  This may be useful for implementing and testing a new chroot type without needing to write any C++ code.  However, you will need to write your own setup script to do the setup work, since by itself this chroot type does very little.  You will also need to add custom keys to your chroot definition for use in the setup script; unlike the configuration for the above chroot types, no validation of the options will take place unless you do it yourself in your custom setup script.  These additional options are also implemented:
de: Les chroots de type \[oq]custom\[cq] sont des types de chroot spéciaux, utilisés pour implémenter de nouveaux types de chroot supportés par aucun des types de chroot ci-dessus. Cela peut être utile pour implémenter et tester un nouveau type de chroot sans besoin d'écrire de code  C++. Cependant, vous devrez écrire vos propre scripts de mise en place pour effectuer la mise en place, car par défaut ce type de chroot ne fait pas grand chose. Vous aurez aussi besoin d'ajouter des clés personnalisées à votre définition de chroot pour être utilisées dans le script de mise en place ; à la différence de la configuration des types de chroot ci-dessus, aucune validation des options ne sera faite à moins que vous ne le fassiez vous-même dans votre script de mise en place personnalisé. Les options supplémentaires suivantes sont également implémentées :

note: type: Plain text
en: Set whether or not sessions may be cloned using this chroot (enabled by default).
de: Définir si les sessions peuvent être clonées en utilisant ce chroot ou non (activé par défaut).

note: type: Plain text
en: Set whether or not sessions may be cloned using this chroot (disabled by default).
de: Définir si les sessions peuvent être purgées en utilisant ce chroot ou non (désactivé par défaut).

note: type: Plain text
en: Set whether or not source chroots may be cloned using this chroot (disabled by default).
de: Définir si les chroots source peuvent être purgés en utilisant ce chroot ou non (désactivé par défaut).

note: type: SS
en: Source chroot options
de: Options des chroots source

note: type: Plain text
en: The \[oq]btrfs-snapshot\[cq], \[oq]file\[cq] and \[oq]lvm-snapshot\[cq] chroot types implement source chroots.  Additionally, chroot types with union support enabled implement source chroots (see \[lq]I<Filesystem Union chroot options>\[rq], below).  These are chroots which automatically create a copy of themselves before use, and are usually session managed.  These chroots additionally provide an extra chroot in the I<source:> namespace, to allow convenient access to the original (non-snapshotted) data, and to aid in chroot maintenance.  I.e. for a chroot named I<wheezy> (I<chroot:wheezy>), a corresponding I<source:wheezy> chroot will be created.  For compatibility with older versions of schroot which did not support namespaces, a chroot with a I<-source> suffix appended to the chroot name will be created in addition (i.e. I<wheezy-source> using the above example).  Note that these compatibility names will be removed in schroot 1.5.0, so the use of the I<source:> namespace is preferred over the use of the I<-source> suffix form.  See B<schroot>(1)  for further details.
de: Les chroots de type \[oq]btrfs-snapshot\[cq], \[oq]file\[cq] et \[oq]lvm-snapshot\[cq] implémentent les chroots source. De plus, les types de chroot avec la prise en charge de l'union activée implémentent les chroots source (consultez \[lq]I<Options des chroots union de systèmes de fichiers>\[rq] ci-dessous). Ce sont des chroots qui créent automatiquement une copie d'eux-mêmes avant utilisation et qui sont en général gérés par des sessions. Ces chroots fournissent en plus un chroot supplémentaire dans l'espace de noms I<source:>, pour permettre un accès commode aux données d'origine (non-imagées) et aider à la maintenance du chroot. Par exemple pour un chroot nommé I<wheezy> (I<chroot:wheezy>), un chroot source I<source:wheezy> correspondant sera créé. Pour des questions de compatibilité avec des versions plus anciennes de schroot qui ne prennent pas en charge les espaces de noms, un chroot de même nom avec le suffixe I<-source> ajouté sera créé en plus (par exemple I<wheezy-source> en continuant l'exemple ci-dessus). Notez que ces noms pour compatibilité seront retirés dans schroot 1.5.0, et par conséquent l'utilisation de l'espace de noms I<source:> est préféré à la place de l'utilisation de la forme avec le suffixe I<-source>. Consultez B<schroot>(1) pour plus de détails.

note: type: Plain text
en: These chroots provide the following additional options:
de: Ces chroots fournissent les options supplémentaires suivantes :

note: type: Plain text
en: Set whether the source chroot should be automatically cloned (created) for this chroot.  The default is \f[CI]true\fR to automatically clone, but if desired may be disabled by setting to \f[CI]false\fR.  If disabled, the source chroot will be inaccessible.
de: Définir si le chroot source doit être cloné automatiquement (créé) pour ce chroot. La valeur par défaut est \f[CI]true\fR pour cloner automatiquement, mais si besoin le clonage peut être désactivé en la définissant à \f[CI]false\fR. Si le clonage est désactivé, le chroot source sera inaccessible.

note: type: TP
en: \f[CBI]source-users=\f[CI]user1,user2,...\fR
de: \f[CBI]source-users=\f[CI]utilisateur1,utilisateur2,...\fR

note: type: Plain text
en: A comma-separated list of users which are allowed access to the source chroot.  If empty or omitted, no users will be allowed access.  This will become the \f[CI]users\fR option in the source chroot.
de: Une liste séparée par des virgules des utilisateurs qui sont autorisés à accéder au chroot source. Si vide ou omis, aucun utilisateur ne sera autorisé à accéder au chroot. Cela deviendra l'option \f[CI]users\fR dans le chroot source.

note: type: TP
en: \f[CBI]source-groups=\f[CI]group1,group2,...\fR
de: \f[CBI]source-groups=\f[CI]groupe1,groupe2,...\fR

note: type: Plain text
en: A comma-separated list of groups which are allowed access to the source chroot.  If empty or omitted, no users will be allowed access.  This will become the \f[CI]groups\fR option in the source chroot.
de: Une liste séparée par des virgules des groupes qui sont autorisés à accéder au chroot source. Si vide ou omis, aucun utilisateur ne sera autorisé à accéder au chroot. Cela deviendra l'option \f[CI]groups\fR dans le chroot source.

note: type: TP
en: \f[CBI]source-root-users=\f[CI]user1,user2,...\fR
de: \f[CBI]source-root-users=\f[CI]utilisateur1,utilisateur2,...\fR

note: type: Plain text
en: A comma-separated list of users which are allowed B<password-less> root access to the source chroot.  If empty or omitted, no users will be allowed root access without a password (but if a user is in \f[CI]users\fR, they may gain access with a password).  This will become the \f[CI]root-users\fR option in the source chroot.  See the section \[lq]I<Security>\[rq] below.
de: Une liste séparée par des virgules d'utilisateurs qui sont autorisés à devenir root dans le chroot source B<sans mot de passe>. Si vide ou omis, aucun utilisateur ne sera autorisé à devenir root sans mot de passe (mais si un utilisateur est dans \f[CI]users\fR, il peut obtenir un accès avec un mot de passe). Cela deviendra l'option \f[CI]root-users\fR dans le chroot source. Consultez la section \[lq]I<Sécurité>\[rq] ci-dessous.

note: type: TP
en: \f[CBI]source-root-groups=\f[CI]group1,group2,...\fR
de: \f[CBI]source-root-groups=\f[CI]groupe1,groupe2,...\fR

note: type: Plain text
en: A comma-separated list of groups which are allowed B<password-less> root access to the source chroot.  If empty or omitted, no users will be allowed root access without a password (but if a user's group is in \f[CI]groups\fR, they may gain access with a password).  This will become the \f[CI]root-groups\fR option in the source chroot.  See the section \[lq]I<Security>\[rq] below.
de: Une liste séparée par des virgules de groupes qui sont autorisés à devenir root dans le chroot source B<sans mot de passe>. Si vide ou omis, aucun utilisateur ne sera autorisé à devenir root sans mot de passe (mais si un groupe auquel appartient l'utilisateur est dans \f[CI]groups\fR, il peut obtenir cet accès avec un mot de passe). Cela deviendra l'option \f[CI]root-groups\fR dans le chroot source. Consultez la section \[lq]I<Sécurité>\[rq] ci-dessous.

note: type: SS
en: Mountable chroot options
de: Options des chroots montables

note: type: Plain text
en: The \[oq]block-device\[cq], \[oq]loopback\[cq] and \[oq]lvm-snapshot\[cq] chroot types implement device mounting.  These are chroots which require the mounting of a device in order to access the chroot.  These chroots provide the following additional options:
de: Les chroots de type  \[oq]block-device\[cq], \[oq]loopback\[cq] et \[oq]lvm-snapshot\[cq] implémentent le montage de périphérique. Ce sont des chroots qui ont besoin de monter un périphérique pour pouvoir accéder au chroot. Ces chroot fournissent les options supplémentaires suivantes :

note: type: Plain text
en: Mount options for the block device.  These are additional options to pass to B<mount>(8).  For example, \[lq]-o atime,sync,user_xattr\[rq].
de: Les options de montage pour le périphérique bloc. Ce sont des options supplémentaires à passer à B<mount>(8). Par exemple, \[lq]-o atime,sync,user_xattr\[rq].

note: type: Plain text
en: This is the path to the chroot I<inside> the filesystem on the device.  For example, if the filesystem contains a chroot in I</chroot/sid>, you would specify \[lq]/chroot/sid\[rq] here.  If the chroot is the only thing on the filesystem, i.e. I</> is the root filesystem for the chroot, this option should be left blank, or omitted entirely.
de: C'est le chemin vers le chroot I<à l'intérieur> du système de fichiers sur le périphérique. Par exemple, si le système de fichiers contient un chroot dans I</chroot/sid>, vous spécifieriez ici \[lq]/chroot/sid\[rq]. Si le chroot est la seule chose sur le système de fichiers, c'est-à-dire que I</> est la racine du système de fichiers pour le chroot, cette option doit être laissée vide ou omise entièrement.

note: type: SS
en: Filesystem Union chroot options
de: Options de chroot d'union de systèmes de fichiers

note: type: Plain text
en: The \[oq]block-device\[cq], \[oq]directory\[cq] and \[oq]loopback\[cq] chroot types allow for the creation of a session using filesystem unions to overlay the original filesystem with a separate writable directory.  The original filesystem is read-only, with any modifications made to the filesystem made in the overlying writable directory, leaving the original filesystem unchanged.  A union permits multiple sessions to access and make changes to a single chroot simultaneously, while keeping the changes private to each session.  To enable this feature, set \f[CI]union-type\fR to any supported value.  If enabled, the chroot will also be a B<source chroot>, which will provide additional options (see \[lq]I<Source chroot options>\[rq], above).  All entries are optional.
de: Les chroots de type \[oq]block-device\[cq], \[oq]directory\[cq] et \[oq]loopback\[cq] permettent, lors de la création d'une session utilisant les unions de systèmes de fichiers, de superposer sur le système de fichiers d'origine un répertoire séparé inscriptible. Le système de fichiers d'origine est en lecture seule ; toute modification faite au système de fichiers dans le dossier inscriptible superposé laisse le système de fichiers d'origine inchangé. Une union permet à plusieurs sessions d'accéder et faire des changements simultanément sur un unique chroot, en gardant les changements de manière privée à chaque session. Pour activer cette caractéristique, définissez \f[CI]union-type\fR à n'importe quelle valeur gérée. Dès lors, le chroot sera également un B<chroot source>, qui fournira des options supplémentaires (consultez \[lq]I<Options des chroots source>\[rq] ci-dessus). Toutes les entrées sont optionnelles.

note: type: Plain text
en: Set the union filesystem type.  Currently supported filesystems are \[oq]aufs\[cq], \[oq]overlayfs\[cq] and \[oq]unionfs\[cq].  The default is \[oq]none\[cq], which disables this feature.
de: Définir le type d'union de systèmes de fichiers. Pour le moment les systèmes de fichiers pris en charge sont \[oq]aufs\[cq], \[oq]overlayfs\[cq] et \[oq]unionfs\[cq]. La valeur par défaut est \[oq]none\[cq], qui désactive cette caractéristique.

note: type: Plain text
en: Union filesystem mount options (branch configuration), used for mounting the union filesystem specified with I<union-type>.  This replaces the complete \[lq]-o\[rq] string for mount and allows for the creation of complex filesystem unions.  Note that \[oq]aufs\[cq], \[oq]overlayfs\[cq] and \[oq]unionfs\[cq] each have different supported mount options.  B<Note:> One can use the variables \[lq]${CHROOT_UNION_OVERLAY_DIRECTORY}\[rq] and \[lq]${CHROOT_UNION_UNDERLAY_DIRECTORY}\[rq] to refer to the writable overlay session directory and read-only underlying directory which are to form the union.  See B<schroot-setup>(5)  for a complete variable list.
de: Options de montage des unions de systèmes de fichiers (configuration des branches), utilisées pour monter l'union de systèmes de fichiers spécifiées avec I<union-type>. Cela remplacera la chaîne de caractères complète \[lq]-o\[rq] pour les montages et autorise la création d'unions de systèmes de fichiers complexes. Notez que \[oq]aufs\[cq], \[oq]overlayfs\[cq] et \[oq]unionfs\[cq] prennent en charge différentes options de montage. B<Note:> Il est possible d'utiliser les variables \[lq]${CHROOT_UNION_OVERLAY_DIRECTORY}\[rq] et \[lq]${CHROOT_UNION_UNDERLAY_DIRECTORY}\[rq] pour se référer respectivement à la surcouche inscriptible et au répertoire en lecture seule en dessous qui forment l'union. Consultez B<schroot-setup>(5) pour une liste complète des variables.

note: type: TP
en: \f[CBI]union-overlay-directory\f[CI]=directory\fR
de: \f[CBI]union-overlay-directory\f[CI]=répertoire\fR

note: type: Plain text
en: Specify the directory where the writeable overlay session directories will be created.  The default is \[oq]\*[SCHROOT_OVERLAY_DIR]\[cq].
de: Spécifier le répertoire où les répertoires de la surcouche inscriptible pour la session seront créés. Par défaut il s'agit de \[oq]\*[SCHROOT_OVERLAY_DIR]\[cq].

note: type: TP
en: \f[CBI]union-underlay-directory\f[CI]=directory\fR
de: \f[CBI]union-underlay-directory\f[CI]=répertoire\fR

note: type: Plain text
en: Specify the directory where the read-only underlying directories will be created.  The default is \[oq]\*[SCHROOT_UNDERLAY_DIR]\[cq].
de: Spécifier le répertoire où les répertoires de la sous-couche en lecture seule seront créés. Par défaut il s'agit de \[oq]\*[SCHROOT_UNDERLAY_DIR]\[]\[cq].

note: type: SS
en: Customisation
de: Personnalisation

note: type: Plain text
en: In addition to the configuration keys listed above, it is possible to add custom keys.  These keys will be used to add additional environment variables to the setup script environment when setup scripts are run.  The only restriction is that the key name consists only of alphanumeric characters and hyphens, begins with an alphabet character and contains at least one period.  That is to say, that it matches the extended regular expression \[lq]^([a-z][a-z0-9]*\e.)+[a-z][a-z0-9-]*$\[rq].
de: En plus de la configuration des clés listées ci-dessus, il est possible d'ajouter des clés personnalisées. Ces clés seront utilisées pour ajouter des variables d'environnement supplémentaires à l'environnement d'exécution des scripts de mise en place. La seule restriction est que le nom des clés doit contenir uniquement des caractères alphanumériques ou des traits d'union, doit commencer par un caractère de l'alphabet et contenir au moins un point. C'est-à-dire qu'il doit correspondre à l'expression régulière étendue \[lq]^([a-z][a-z0-9]*\e.)+[a-z][a-z0-9-]*$\[rq].

note: type: Plain text
en: For example:
de: Par exemple :

note: type: Plain text
en: would set the following environment:
de: Définira les variables d'environnement suivantes :

note: type: Plain text
en: Note that it is an error to use different key names which would set the same environment variable by mixing periods and hyphens.
de: Notez que c'est une erreur d'utiliser différents noms de clé qui définiront la même variable d'environnement en mélangeant des points et des traits d'union.

note: type: Plain text
en: Custom configuration keys may also be modified at runtime using the I<--option> option.  However, for security, only selected keys may be modified.  These keys are specified using the following options:
de: Les clés de configuration personnalisées peuvent également être modifiées lors de l'exécution en utilisant l'option I<--option>. Cependant, pour des raisons de sécurité, seules les clés sélectionnées peuvent être modifiées. Ces clés sont spécifiées en utilisant les options suivantes :

note: type: TP
en: \f[CBI]user-modifiable-keys=\f[CI]key1,key2,..\fR
de: \f[CBI]user-modifiable-keys=\f[CI]clé1,clé2,..\fR

note: type: Plain text
en: Set the keys which users may modify using I<--option>.
de: Définir les clés que l'utilisateur peut modifier en utilisant I<--option>.

note: type: TP
en: \f[CBI]root-modifiable-keys=\f[CI]key1,key2,..\fR Set the keys which the
de: \f[CBI]root-modifiable-keys=\f[CI]clé1,clé2,..\fR

note: type: Plain text
en: root user may modify using I<--option>.  Note that the root user may use the keys specified in \f[CI]user-modifiable-keys\fR in addition to those specified here.
de: Définir les clés que le superutilisateur peut modifier en utilisant I<--option>. Notez que le superutilisateur peut utiliser les clés définies dans \f[CI]user-modifiable-keys\fR en plus des clés définies ici.

note: type: Plain text
en: Some keys may be localised in multiple languages.  This is achieved by adding the locale name in square brackets after the key name.  For example:
de: Quelques clés peuvent être localisées dans plusieurs langues. C'est effectué en ajoutant le nom local entre crochets après le nom de la clé. Par exemple :

note: type: Plain text
en: description[en_GB]=\f[CI]British English translation\fR
de: description[en_GB]=\f[CI]Traduction anglaise britannique\fR

note: type: Plain text
en: This will localise the \f[CI]description\fR key for the en_GB locale.
de: Cela localisera la clé \f[CI]description\fR pour la locale en_GB.

note: type: Plain text
en: description[fr]=\f[CI]French translation\fR
de: description[fr]=\f[CI]Traduction française\fR

note: type: Plain text
en: This will localise the \f[CI]description\fR key for all French locales.
de: Cela localisera la clé \f[CI]description\fR pour la locale française.

note: type: SH
en: CHROOT NAMES
de: NOMS DES CHROOTS

note: type: Plain text
en: A number of characters or words are not permitted in a chroot name, session name or configuration filename.  The name may not contain a leading period (\[oq].\[cq]).  The characters \[oq]:\[cq] (colon), \[oq],\[cq] (comma) and \[oq]/\[cq] (forward slash) are not permitted anywhere in the name.  The name may also not contain a trailing tilde (\[oq]~\[cq]).  The rationale for these restrictions is given below.
de: Certains caractères ou mots ne sont pas permis dans le nom de chroot, nom de session ou nom de fichier de configuration. Le nom ne peut pas commencer par un point (\[oq].\[cq]). Les caractères \[oq]:\[cq] (deux-points), \[oq],\[cq] (virgule) et \[oq]/\[cq] (barre oblique) ne sont permis nulle part dans le nom. Le nom ne peut également pas contenir de tilde (\[oq]~\[cq]) final. Les raisons de ces restrictions sont données ci-dessous.

note: type: Plain text
en: A leading period could be used to create a name with a relative path in it, in combination with \[oq]/\[cq], and this could allow overwriting of files on the host filesystem.  Not allowing this character also means hidden files cannot be created.  It also means some editor backups are automatically ignored.  Periods are allowed anywhere else in the name.
de: Un point en début de nom peut être utilisé pour créer un nom comprenant un chemin relatif, en combinaison avec \[oq]/\[cq], et cela peut permettre l'écrasement de fichiers du système hôte. Ne pas autoriser ce caractère signifie aussi que des fichiers cachés ne peuvent pas être créés. Cela implique aussi que les sauvegardes automatiques de certain éditeurs sont automatiquement ignorées. Les points sont autorisés partout ailleurs dans le nom.

note: type: Plain text
en: A colon is used as a namespace delimiter, and so is not permitted as part of a chroot or session name.  LVM snapshot names may also not contain this character due to a naming restriction by B<lvcreate>(8).
de: Le deux-points est utilisé comme séparateur d'espace de noms, et n'est donc pas permis en tant que portion du nom d'un chroot ou d'une session. Les noms des clichés LVM ne peuvent aussi contenir ce caractère lié à des restrictions de dénominations de B<lvcreate>(8).

note: type: Plain text
en: Names containing this character are not valid filenames.  A forward slash would potentially allow creation of files in subdirectories.
de: Les noms contenant ce caractère ne sont pas des noms de fichier valides. Une barre oblique permettrait éventuellement la création de fichiers dans des sous-répertoires.

note: type: Plain text
en: Commas are used to separate items in lists.  Aliases are separated by commas and hence can't contain commas in their name.
de: Les virgules sont utilisées pour séparer des objets dans une liste. Les alias sont séparés par des virgules et donc ne peuvent pas contenir de virgules dans leur nom.

note: type: Plain text
en: Filenames containing trailing tildes are used for editor backup files, which are ignored.  Tildes are allowed anywhere else in the name.
de: Les noms de fichiers contenant des tildes finaux sont utilisés comme fichiers de sauvegarde par les éditeurs, et qui sont ignorés. Les tildes sont autorisés partout ailleurs dans le nom.

note: type: Plain text
en: These names may not appear at the end of a name.  These are saved copies of conffiles used by the dpkg package manager, and will be ignored.
de: Ces noms ne doivent pas apparaître à la fin du nom. Ce sont des copies de sauvegarde des fichiers de configuration utilisées par le gestionnaire de paquet dpkg, et seront ignorées.

note: type: SH
en: SECURITY
de: SÉCURITÉ

note: type: SS
en: Untrusted users
de: Utilisateurs non-fiables

note: type: Plain text
en: Note that giving untrusted users root access to chroots is a B<serious security risk>! Although the untrusted user will only have root access to files inside the chroot, in practice there are many obvious ways of breaking out of the chroot and of disrupting services on the host system.  As always, this boils down to I<trust>.
de: Notez que donner des accès root à des chroots pour des utilisateurs non-fiables est un B<sérieux problème de sécurité>! Bien que l'utilisateur non-fiable n'aura un accès root qu'aux fichiers à l'intérieur du chroot, en pratique il y a plein de façons évidentes de sortir du chroot et de perturber les services sur le système hôte. Comme toujours, cela revient à la I<confiance>.

note: type: Plain text
en: B<Do not give chroot root access to users you would not trust> B<with root access to the host system.>
de: B<Ne donnez pas d'accès root au chroot pour des utilisateurs auxquels vous ne faites pas confiance pour un accès root sur le système hôte.>

note: type: SS
en: Profiles
de: Profils

note: type: Plain text
en: Depending upon which profile you have configured with the \f[CI]script-config\fR option, different filesystems will be mounted inside the chroot, and different files will be copied into the chroot from the host.  Some profiles will mount the host's I</dev>, while others will not.  Some profiles also bind mount additional parts of the host filesystem in order to allow use of certain features, including user's home directories and specific parts of I</var>.  Check the profile's I<fstab> file to be certain of what will be mounted, and the other profile files to see which files and system databases will be copied into the chroot.  Choose a different profile or edit the files to further restrict what is made available inside the chroot.
de: En fonction du profil que vous avez configuré avec l'option \f[CI]script-config\fR, différents systèmes de fichiers seront montés à l'intérieur du chroot, et différents fichiers seront copiés dans le chroot à partir de l'hôte. Certains profils monteront le I</dev> de l'hôte, tandis que d'autres non. Certains profils montent en lien (« bind ») d'autres portions du système de fichiers de l'hôte, afin de permettre l'utilisation de certaines propriétés, incluant le répertoire personnel de l'utilisateur et des portions particulières de I</var>. Consultez le fichier I<fstab> du profil pour être certain de ce qui va être monté, et les autres fichiers du profil pour savoir quels fichiers et bases de données systèmes seront copiés dans le chroot. Choisissez un profil différent ou éditez les fichiers pour restreindre d'avantage ce qui sera disponible à l'intérieur du chroot.

note: type: Plain text
en: There is a tradeoff between security (keeping the chroot as minimal as possible) and usability (which sometimes requires access to parts of the host filesystem).  The different profiles make different tradeoffs, and it is important that you assess which meets the security/usability tradeoff you require.
de: Il y a un compromis entre la sécurité (garder le chroot aussi petit que possible) et la convivialité (qui requiert parfois l'accès à des portions du système de fichiers de l'hôte). Les différents profils font différents compromis, et il est important que vous évaluiez lequel correspond au compromis sécurité/convivialité dont vous avez besoin.

note: type: Plain text
en: # Sample configuration
de: # Exemple de configuration

note: type: Plain text
en: [sid-file]
    type=file
    description=Debian sid file-based chroot
    priority=3
    groups=sbuild
    file=/srv/chroots/sid.tar.gz
de: [sid-file]
    type=file
    description=Debian sid file-based chroot
    description[fr_FR]=Chroot fichier basé sur Debian sid
    priority=3
    groups=sbuild
    file=/srv/chroots/sid.tar.gz

note: type: Plain text
en: [sid-snapshot]
    type=lvm-snapshot
    description=Debian unstable LVM snapshot
    priority=3
    groups=sbuild
    users=rleigh
    source-root-users=rleigh
    source-root-groups=admin
    device=/dev/hda_vg/sid_chroot
    mount-options=-o atime,sync,user_xattr
    lvm-snapshot-options=--size 2G
de: [sid-snapshot]
    type=lvm-snapshot
    description=Debian unstable LVM snapshot
    description[fr_FR]=Cliché LVM de Debian unstable
    priority=3
    groups=sbuild
    users=rleigh
    source-root-users=rleigh
    source-root-groups=admin
    device=/dev/hda_vg/sid_chroot
    mount-options=-o atime,sync,user_xattr
    lvm-snapshot-options=--size 2G

note: type: SS
en: Chroot definitions
de: Définitions des chroots

note: type: Plain text
en: Additional chroot definitions may be placed in files under this directory.  They are treated in exactly that same manner as I<\*[SCHROOT_CONF]>.  Each file may contain one or more chroot definitions.
de: Des définitions de chroot supplémentaires peuvent être placées dans des fichiers de ce répertoire. Elles sont traitées de la même façon que I<\*[SCHROOT_CONF]>. Chaque fichier peut contenir une ou plusieurs définitions de chroot.

note: type: Plain text
en: schroot-script-config - schroot chroot setup script configuration
de: schroot-script-config - configuration du script d'installation chroot de schroot

note: type: Plain text
en: B<schroot> uses scripts to set up and then clean up the chroot environment.  These scripts may be customised using the \f[CI]script-config\fR key in I<\*[SCHROOT_CONF]>.  This key specifies a file which the setup scripts will source when they are run.  The file is a Bourne shell script, and in consequence may contain any valid shell code, in addition to simple variable assignments.  This will, for example, allow behaviour to be customised according to the specific chroot type or name.
de: B<schroot> utilise des scripts pour mettre en place et ensuite nettoyer l'environnement de chroot. Ces scripts peuvent être personnalisés en utilisant la clé  \f[CI]script-config\fR dans I<\*[SCHROOT_CONF]>. Cette clé spécifie un fichier que les scripts de mise en place vont sourcer quand ils seront exécutés. Le fichier est un script de type Bourne shell, et par conséquent peut contenir tout code shell valide, en plus des simples assignements de variable. Cela permet, par exemple, d'adapter les comportements en fonction d'un type spécifique ou nom de chroot.

note: type: Plain text
en: This file is deprecated, but is still used if present; it will be obsoleted and removed in a future release.  All the settings in this file are now settable using configuration keys in I<schroot.conf>, as detailed below.  Existing configuration should be modified to use these keys in place of this file.
de: Ce fichier déconseillé mais est toujours utilisé si présent ; il deviendra obsolète et sera retiré dans une prochaine version. Toutes les configurations de ce fichier sont maintenant définissables en utilisant les clés de configuration dans I<schroot.conf>, comme détaillé ci-dessous. Les configurations existantes doivent être modifiées pour utiliser ces clés à la place de ce fichier.

note: type: Plain text
en: The environment is the same as for all setup scripts, described in B<schroot-setup>(5).
de: L'environnement est le même que pour tous les scripts de mise en place décrit dans B<schroot-setup>(5).

note: type: Plain text
en: The following variables may be set to configure setup script behaviour.  Note that new variables may be added in future releases.  Third-party extensions to schroot which add their own setup scripts may add additional variables which are not documented here; consult the extension documentation for further details.
de: Les variables suivantes peuvent être définies pour configurer les comportements des scripts de mise en place. Notez que de nouvelles variables pourront être ajoutées dans de future versions. Des extensions tiers de schroot qui ajoutent leur propre script de mise en place peuvent ajouter d'autres variables qui ne sont pas documentées ici ; veuillez consulter la documentation des extensions pour plus de détails.

note: type: Plain text
en: A file containing a list of files to copy into the chroot (one file per line).  The file will have the same absolute location inside the chroot.  Note that this is settable using the \f[CI]setup.copyfiles\fR key.
de: Un fichier contenant une liste de fichier à copier dans le chroot (un fichier par ligne). Le fichier aura le même chemin absolu dans le chroot. Notez que c'est définissable en utilisant la clé \f[CI]setup.copyfiles\fR.

note: type: Plain text
en: A file listing the system databases to copy into the chroot.  The default databases are \[oq]passwd\[cq], \[oq]shadow\[cq], \[oq]group\[cq], \[oq]services\[cq], \[oq]protocols\[cq], \[oq]networks\[cq], and \[oq]hosts\[cq].  \[oq]gshadow\[cq] is not yet copied by default, due to not being supported by all but the most recent version of the GNU C library.  The databases are copied using B<getent>(1)  so all database sources listed in I</etc/nsswitch.conf> will be used for each database.  Note that this is settable using the \f[CI]setup.nssdatabases\fR key.
de: Un fichier listant les bases de données du système à copier dans le chroot. Les bases de données par défaut sont \[oq]passwd\[cq], \[oq]shadow\[cq], \[oq]group\[cq], \[oq]services\[cq], \[oq]protocols\[cq], \[oq]networks\[cq], et \[oq]hosts\[cq]. \[oq]gshadow\[cq] n'est pas encore copiée par défaut, car elle n'est disponible qu'avec les dernières versions de la librairie GNU C. Les bases de données sont copiées en utilisant B<getent>(1) pour que toutes les sources de bases de données listées dans I</etc/nsswitch.conf> soient utilisées pour chaque base de données. Notez que c'est définissable en utilisant la clé \f[CI]setup.nssdatabases\fR.

note: type: TH
en: SCHROOT-FAQ
de: FAQ de SCHROOT

note: type: Plain text
en: schroot - frequently asked questions
de: Foire aux questions de schroot

note: type: Plain text
en: This manual page covers various frequently asked questions about configuration and usage of schroot.
de: Cette page de manuel couvre différentes questions fréquentes sur la configuration et l'utilisation de schroot.

note: type: SS
en: Why is schroot overwriting configuration files in the chroot?
de: Pourquoi schroot écrase-t-il des fichiers de configuration dans le chroot ?

note: type: Plain text
en: By default, schroot copies over the system NSS databases (\[oq]passwd\[cq], \[oq]shadow\[cq], \[oq]group\[cq], \[oq]gshadow\[cq], \[oq]services\[cq], \[oq]protocols\[cq], \[oq]networks\[cq], and \[oq]hosts\[cq], etc.) into the chroot.  The reason for this is that the chroot environment is not a completely separate system, and it copying them over keeps them synchronised.  However, this is not always desirable, particularly if installing a package in the chroot creates system users and groups which are not present on the host, since these will disappear next time the databases are copied over.
de: Par défaut, schroot copie les bases de donnée NSS du système (\[oq]passwd\[cq], \[oq]shadow\[cq], \[oq]group\[cq], \[oq]gshadow\[cq], \[oq]services\[cq], \[oq]protocols\[cq], \[oq]networks\[cq], \[oq]hosts\[cq], etc.) dans le chroot. La raison est que l'environnement de chroot n'est pas complètement séparé du système, et copier ces fichiers permet de les maintenir à jour. Cependant, ce n'est pas toujours désirable, en particulier si installer un paquet dans le chroot crée des utilisateurs et groupes système qui ne sont pas présents chez l'hôte, car ils disparaîtront la prochaine fois que les bases de données seront copiées.

note: type: Plain text
en: In the future, we will be working on a better scheme for keeping the host and chroot databases in sync which can merge entries rather than overwriting the entire database, which would preserve chroot-specific changes.
de: Prochainement, nous travaillerons à un meilleur schéma pour garder les bases de données de l'hôte et du chroot synchronisées ce qui permettra des fusions d'entrée plutôt qu'un écrasement entier de la base de données, qui garderait les changements spécifiques du chroot.

note: type: SS
en: Should I use the plain or directory chroot type?
de: Quel type de chroot dois-je utiliser : « plain » ou « directory » ?

note: type: Plain text
en: These two chroot types are basically equivalent, since they are both just directories in the filesystem.  plain is very simple and does not perform any setup tasks; the only reason you would want to use it is if you're upgrading from a program such as B<dchroot(1)> or B<chroot(8)> which don't do anything other than running a command or shell in a directory.  On the other hand, directory chroots do run setup scripts, which can mount additional filesystems and do other setup tasks.
de: Ces deux types de chroot sont en principe équivalents car ce sont simplement des répertoires du système de fichiers. « plain » est très simple et n'effectue aucune tâche de mise en place ; la seule raison pour laquelle vous pourriez vouloir l'utiliser est que vous mettez à niveau depuis un programme comme B<dchroot(1)> ou B<chroot(8)> qui ne font rien d'autre qu'exécuter une commande ou un shell dans un répertoire. D'un autre coté, les chroots « directory » exécutent des scripts de mise en place qui peuvent monter des systèmes de fichiers additionnels ou d'autres tâches de mise en place.

note: type: SH
en: ADVANCED CONFIGURATION
de: CONFIGURATION AVANCÉE

note: type: SS
en: What are snapshots and unions?
de: Que sont les « clichés » (« snapshots ») et les « unions » ?

note: type: Plain text
en: Some chroot types support I<cloning>.  This means when you start a session, you get a I<copy> of the chroot which lasts just for the lifetime of the session.  This is useful when you want a temporary clean copy of a system for a single task, which is then automatically deleted when you're done with it.  For example, the Debian package build d\[ae]mons run B<sbuild>(1)  to build Debian packages, and this program uses schroot to create a clean build environment for each package.  Without snapshotting, the chroot would need to be reset to its initial state at the end of each build to make it ready for the next one, and any debris left over from package removals or earlier builds could interfere with the next build.
de: Certains types de chroot supportent le I<clonage>. Cela veut dire que quand vous démarrez une session vous obtenez une I<copie> du chroot qui ne dure que pour la durée de la session. C'est utile quand vous voulez une copie propre temporaire du système pour une tache simple, qui est ensuite automatiquement détruite quand vous ne l'utilisez plus. Par exemple, le service de construction des paquets Debian exécute B<sbuild>(1) pour construire les paquets Debian qui utilise schroot pour créer un environnement de construction propre pour chaque paquet. Sans cliché, le chroot devrait être réinitialisé à la fin de chaque construction afin de le préparer pour le suivant, et chaque débris laissé par la désinstallation de paquet ou de construction précédente peut interférer avec la construction suivante.

note: type: Plain text
en: The most commonly-used snapshotting method is to use LVM snapshots (chroot type \[oq]lvm-snapshot\[cq]).  In this case the chroot must exist on an LVM logical volume (LV); snapshots of an LV may then be made with B<lvcreate>(8)  during chroot session setup.  However, these use up a lot of disk space.  A newer method is to use Btrfs snapshots which use up much less disk space (chroot type \[oq]btrfs-snapshot\[cq]), and may be more reliable than LVM snapshots.  Btrfs is however still experimental, but it is hoped that it will become the recommended method as it matures.
de: La méthode de cliché la plus utilisée utilise les clichés LVM (chroot de type \[oq]lvm-snapshot\[cq]). Dans ce cas, le chroot doit exister sur un volume logique LVM (LV) ; les clichés d'un LV peuvent ainsi être effectués avec la commande B<lvcreate>(8) pendant l'initialisation de la session de chroot. Cependant, cela utilise beaucoup d'espace disque. Une nouvelle méthode consiste à utiliser les clichés Btrfs qui utilisent beaucoup moins d'espace disque (chroot de type \[oq]btrfs-snapshot\[cq]), et peuvent être plus sûrs que les clichés LVM. Cependant, Btrfs est encore expérimental, mais cela deviendra certainement la méthode conseillée quand il deviendra mature.

note: type: Plain text
en: Unions are an alternative to snapshots.  In this situation, instead of creating a copy of the chroot filesystem, we overlay a read-write temporary filesystem on top of the chroot filesystem so that any modifications are stored in the overlay, leaving the original chroot filesystem untouched.  The Linux kernel has yet to integrate support for union filesystems such as aufs and unionfs, so LVM snapshots are still the recommended method at present.
de: Les unions sont des alternatives aux clichés. Dans ce cas, au lieu de créer une copie du système de fichiers du chroot, un système de fichiers temporaire inscriptible est superposé au système de fichiers du chroot. Toute modification est ainsi sauvée dans la surcouche, laissant le système de fichier du chroot original inchangé. Le noyau Linux doit pour le moment intégrer le support des unions de système de fichiers comme aufs et unionfs. ainsi les clichés LVM restent la méthode recommandée pour le moment.

note: type: SS
en: Can I run a d\[ae]mons in a chroot?
de: Puis-je exécuter un service (« daemon ») dans un chroot ?

note: type: Plain text
en: A common problem is trying to run a d\[ae]mon in a chroot, and finding that this doesn't work.  Typically, the d\[ae]mon is killed shortly after it starts up.
de: Un problème commun est d'essayer d'exécuter un service dans un chroot et découvrir que cela ne marche pas. Typiquement, le service est tué rapidement après avoir été démarré.

note: type: Plain text
en: When schroot runs, it begins a session, runs the specified command or shell, waits for the command or shell to exit, and then it ends the session.  For a normal command or shell, this works just fine.  However, d\[ae]mons normally start up by running in the background and detaching from the controlling terminal.  They do this by forking twice and letting the parent processes exit.  Unfortunately, this means schroot detects that the program exited (the d\[ae]mon is a orphaned grandchild of this process) and it then ends the session.  Part of ending the session is killing all processes running inside the chroot, which means the d\[ae]mon is killed as the session ends.
de: Quand schroot est exécuté, il initie une session, exécute la commande ou le shell spécifié, attend que cette commande ou ce shell se termine et ferme la session. Pour une commande ou un shell normal, cela marche bien. Cependant les services commencent par se lancer en tâche de fond et se détachent du terminal les contrôlant. Ils font cela en forquant deux fois et en laissant le processus parent se terminer. Malheureusement schroot détecte que le programme s'est terminé (le service est un orphelin petit-fils de ce processus) et il ferme la session. Une partie de la terminaison de la session est de tuer tous les processus restant dans le chroot, ce qui veut dire tuer le service lors de la fermeture de la session.

note: type: Plain text
en: In consequence, it's not possible to run a d\[ae]mon I<directly> with schroot.  You can however do it if you create a session with I<--begin-session> and then run the d\[ae]mon with I<--run-session>.  It's your responsibility to end the session with I<--end-session> when the daemon has terminated or you no longer need it.
de: En conséquence, il n'est pas possible d'exécuter un service I<directement> avec schroot. Vous pouvez cependant le faire si vous créez une session avec I<--begin-session> et ensuite exécutez le service avec I<--run-session>. Il est alors de votre responsabilité de terminer la session avec I<--end-session> quand le service a terminé ou que vous n'en avez plus besoin.

note: type: SS
en: How do I manually cleaning up a broken session?
de: Comment puis-je nettoyer manuellement une session cassée ?

note: type: Plain text
en: Occasionally, it may be necessary to manually clean up sessions.  If something changes on your system which causes the setup scripts to fail when ending a session, for example removal of a needed file or directory, it may not be possible for schroot to clean everything up automatically.  For each of the session directories listed in the \[lq]I<Session directories>\[rq] section in B<schroot>(1), any files with the name of the session ID need deleting, and any directories with the name of the session ID need umounting (if there are any filesystems mounted under it), and then also removing.
de: Occasionnellement, il peut être nécessaire de nettoyer manuellement des sessions. Si quelque chose a changé dans votre système qui fait échouer le script de mise en place lors de la fin de session, par exemple en retirent un fichier ou répertoire requis, il peut être impossible à schroot de nettoyer tout automatiquement. Pour chaque répertoire de session listé dans la section \[lq]I<Répertoires de session>\[rq] dans B<schroot>(1), tout fichier avec le nom d'un identifiant de session doit être supprimé, et tout répertoire avec le nom d'un identifiant de session doit être démonté (s'il y a des systèmes de fichiers montés à l'intérieur) et également supprimé.

note: type: Plain text
en: For example, to remove a session named I<my-session> by hand:
de: Par exemple, pour supprimer une session nommée I<ma-session> à la main :

note: type: Plain text
en: Remove the session configuration file
de: Supprimez le fichier de configuration de la session

note: type: Plain text
en: %\ \f[CB]rm\ \*[SCHROOT_SESSION_DIR]/my-session\fR\[CR]
de: %\ \f[CB]rm\ \*[SCHROOT_SESSION_DIR]/ma-session\fR\[CR]

note: type: Plain text
en: Check for mounted filesystems
de: Vérifiez les systèmes de fichiers

note: type: Plain text
en: %\ \f[CB]\*[SCHROOT_LIBEXEC_DIR]/schroot-listmounts\ -m\ \e
      \*[SCHROOT_MOUNT_DIR]/my-session\fR\[CR]
de: %\ \f[CB]\*[SCHROOT_LIBEXEC_DIR]/schroot-listmounts\ -m\ \e
      \*[SCHROOT_MOUNT_DIR]/ma-session\fR\[CR]

note: type: Plain text
en: Unmount any mounted filesystems
de: Démontez tout système de fichiers

note: type: Plain text
en: Remove I<\*[SCHROOT_MOUNT_DIR]/my-session>
de: Supprimez  I<\*[SCHROOT_MOUNT_DIR]/ma-session>

note: type: Plain text
en: Repeat for the other directories such as I<\*[SCHROOT_UNDERLAY_DIR]>, I<\*[SCHROOT_OVERLAY_DIR]> and I<\*[SCHROOT_FILE_UNPACK_DIR]>
de: Répétez pour les autres répertoires comme I<\*[SCHROOT_UNDERLAY_DIR]>, I<\*[SCHROOT_OVERLAY_DIR]> et I<\*[SCHROOT_FILE_UNPACK_DIR]>

note: type: Plain text
en: B<NOTE:> Do not remove any directories without checking if there are any filesystems mounted below them, since filesystems such as I</home> could still be bind mounted.  Doing so could cause irretrievable data loss!
de: B<NOTE :> Ne supprimez aucun répertoire sans vérifier s'il y a des systèmes de fichiers montés sous eux, car les systèmes de fichiers comme I</home> peuvent toujours être montés. Ne pas le faire peut engendrer la perte irréparable de données.

note: type: SH
en: ADVANCED USAGE
de: UTILISATION AVANCÉE

note: type: SS
en: How do I use sessions?
de: Comment utiliser les sessions ?

note: type: Plain text
en: In normal use, running a command might look like this:
de: Lors d'une utilisation normale, lancer une commande peut ressembler à ça :

note: type: Plain text
en: %\ \f[CB]schroot\ -c squeeze -- command\fR\[CR]
de: %\ \f[CB]schroot\ -c squeeze -- commande\fR\[CR]

note: type: Plain text
en: which would run the command I<command> in the I<squeeze> chroot.  While it's not apparent that a session is being used here, schroot is actually doing the following steps:
de: Cela lancera la commande I<commande> dans le chroot I<squeeze>. Alors qu'il n'est pas clair qu'une session est utilisé ici, schroot effectue en fait les étapes suivantes :

note: type: Plain text
en: Creating a session using the I<squeeze> chroot.  This will be automatically given a unique name, such as I<squeeze-57a69547-e014-4f5d-a98b-f4f35a005307>, though you don't usually need to know about this
de: Création d'une session utilisant le chroot I<squeeze>. Cela va donner automatiquement un nom unique, comme I<squeeze-57a69547-e014-4f5d-a98b-f4f35a005307>, que normalement vous n'avez pas besoin de connaître.

note: type: Plain text
en: Setup scripts are run to create the session chroot and configure it for you
de: Les scripts de mise en place sont exécutés pour créer la session de chroot et la configurent pour vous.

note: type: Plain text
en: The command I<command> is run inside the session chroot
de: La commande I<commande> est exécutée dans la session de chroot.

note: type: Plain text
en: Setup scripts are run to clean up the session chroot
de: Les scripts de mise en place sont exécutés pour nettoyer le session de chroot.

note: type: Plain text
en: The session is deleted
de: La session est supprimée.

note: type: Plain text
en: Now, if you wanted to run more than one command, you could run a shell and run them interactively, or you could put them into shell script and run that instead.  But you might want to do something in between, such as running arbitrary commands from a program or script where you don't know which commands to run in advance.  You might also want to preseve the chroot state in between commands, where the normal automatic session creation would reset the state in between each command.  This is what sessions are for: once created, the session is persistent and won't be automatically removed.  With a session, you can run as many commands as you like, but you need to create and delete the session by hand since schroot can't know by itself when you're done with it unlike in the single command case above.  This is quite easy:
de: Maintenant si vous voulez exécuter plus d'une commande, vous pouvez exécuter un interpréteur de commandes et les exécuter interactivement, ou vous pouvez les mettre dans un script shell et l'exécuter à leur place. Mais vous pourriez vouloir faire quelque chose d'intermédiaire, comme exécuter des commandes arbitraires d'un programme ou script où vous ne connaissez pas quelle commande exécuter à l'avance. Vous pourriez également vouloir préserver l'état du chroot entre les commandes. C'est la raison d'être des sessions : une fois créée, la session est persistante et ne sera pas automatiquement supprimée. Avec une session, vous pouvez exécuter autant de commandes que vous le voulez, mais vous devez créer et supprimer la session manuellement car schroot ne peut pas savoir par lui-même quand vous avez fini à l'exception du cas de la commande unique ci-dessus. C'est relativement facile :

note: type: Plain text
en: This created a new session based upon the I<squeeze> chroot.  The unique name for the session, the session ID, was printed to standard output, so we could also save it as a shell variable at the same time like so:
de: Cela crée une nouvelle session basée sur le chroot I<squeeze>. Le nom unique de la session, l'identifiant de session, a été écrit sur la sortie standard. Nous pouvons donc l'enregistrer en tant que variable shell en même temps comme cela :

note: type: Plain text
en: Now we have created the session and got the session ID, we can run commands in it using the session ID:
de: Maintenant nous avons créé la session et nous avons son identifiant, nous pouvons y lancer des commandes en utilisant l'identifiant de session :

note: type: Plain text
en: % \f[CB]schroot --run-session -c squeeze-57a69547-e014-4f5d-a98b-f4f35a005307 \e
      -- command1\fR\[CR]
de: % \f[CB]schroot --run-session -c squeeze-57a69547-e014-4f5d-a98b-f4f35a005307 \e
      -- commande1\fR\[CR]

note: type: Plain text
en: or
de: ou

note: type: Plain text
en: % \f[CB]schroot --run-session -c "$SESSION" -- command1\fR\[CR]
de: % \f[CB]schroot --run-session -c "$SESSION" -- commande1\fR\[CR]

note: type: Plain text
en: and then as many more commands as we like
de: et ensuite nous pouvons avoir autant de commande que nous le voulons

note: type: Plain text
en: % \f[CB]schroot --run-session -c "$SESSION" -- command2\fR\[CR]
    % \f[CB]schroot --run-session -c "$SESSION" -- command3\fR\[CR]
    % \f[CB]schroot --run-session -c "$SESSION" -- command4\fR\[CR]
de: % \f[CB]schroot --run-session -c "$SESSION" -- commande2\fR\[CR]
    % \f[CB]schroot --run-session -c "$SESSION" -- commande3\fR\[CR]
    % \f[CB]schroot --run-session -c "$SESSION" -- commande4\fR\[CR]

note: type: Plain text
en: When we are done with the session, we can remove it with I<--end-session>:
de: Quand nous avons fini avec cette session, nous pouvons la supprimer avec I<--end-session> :

note: type: Plain text
en: Since the automatically generated session names can be long and unwieldy, the I<--session-name> option allows you to provide you own name:
de: Comme les noms de sessions générés automatiquement peuvent être longs et peu maniables, l'option I<--session-name> vous permet de spécifier votre propre nom :

note: type: Plain text
en: % \f[CB]schroot --begin-session -c squeeze --session-name my-name\fR\[CR]
    my-name
de: % \f[CB]schroot --begin-session -c squeeze --session-name mon-nom\fR\[CR]
    mon-nom

note: type: SH
en: CONTRIBUTING
de: CONTRIBUER

note: type: SS
en: Getting help and getting involved
de: Recevoir de l'aide ou s'impliquer.

note: type: Plain text
en: The mailing list \f[CR]E<lt>buildd-tools-devel@lists.alioth.debian.orgE<gt>\fR is used for both user support and development discussion.  The list may be subscribed to from the project website at \f[CR]https://alioth.debian.org/projects/buildd-tools/\fR or the Mailman list interface at \f[CR]http://lists.alioth.debian.org/mailman/listinfo/buildd-tools-devel\fR.
de: La liste de diffusion \f[CR]E<lt>buildd-tools-devel@lists.alioth.debian.orgE<gt>\fR est utilisée pour l'aide aux utilisateurs et les discussions au sujet du développement. Vous pouvez vous inscrire à la liste sur le site web du projet à l'adresse \f[CR]https://alioth.debian.org/projects/buildd-tools/\fR ou via l'interface du gestionnaire de listes à l'adresse \f[CR]http://lists.alioth.debian.org/mailman/listinfo/buildd-tools-devel\fR.

note: type: SS
en: Reporting bugs
de: Signaler des bogues.

note: type: Plain text
en: On Debian systems, bugs may be reported using the B<reportbug>(1)  tool, or alternatively by mailing \f[CR]E<lt>submit@bugs.debian.orgE<gt>\fR (see \f[CR]http://bugs.debian.org\fR for details on how to do that).
de: Sur les système Debian, les bogues peuvent être signalés en utilisant l'utilitaire B<reportbug>(1) ou en envoyant un message à \f[CR]E<lt>submit@bugs.debian.orgE<gt>\fR (consultez \f[CR]http://bugs.debian.org\fR pour plus de détail sur comment le faire).

note: type: SS
en: Getting the latest sources
de: Obtenir les dernières sources.

note: type: Plain text
en: schroot is maintained in the git version control system.  You can get the latest sources from \f[CR]git://git.debian.org/git/buildd-tools/schroot\fR.
de: schroot est maintenu dans le système de gestion de source git. Vous pouvez obtenir les dernières sources à partir de \f[CR]git://git.debian.org/git/buildd-tools/schroot\fR.

note: type: Plain text
en: The master branch containes the current development release.  Stable releases are found on branches, for example the 1.4 series of releases are on the schroot-1.4 branch.
de: La branche maîtresse contient la version de développement courante. Les versions stables peuvent être trouvées dans les branches. Par exemple la série de version 1.4 est la branche schroot-1.4.

note: type: Plain text
en: dchroot - enter a chroot environment
de: dchroot - entrer dans un environnement de chroot.

note: type: Plain text
en: B<dchroot> [B<-h>\[or]B<--help> \[or] B<-V>\[or]B<--version> \[or] B<-l>\[or]B<--list> \[or] B<-i>\[or]B<--info> \[or] B<--config> \[or] B<--location>] [B<--directory=>I<directory>] [B<-d>\[or]B<--preserve-environment>] [B<-q>\[or]B<--quiet> \[or] B<-v>\[or]B<--verbose>] [B<-c >I<chroot>\[or]B<--chroot=>I<chroot> \[or] B<--all>] [B<COMMAND> [ B<ARG1> [ B<ARG2> [ B<ARGn>]]]]
de: B<dchroot> [B<-h>\[ou]B<--help> \[ou] B<-V>\[ou]B<--version> \[ou] B<-l>\[ou]B<--list> \[ou] B<-i>\[ou]B<--info> \[ou] B<--config> \[ou] B<--location>] [B<--directory=>I<répertoire>] [B<-d>\[ou]B<--preserve-environment>] [B<-q>\[or]B<--quiet> \[ou] B<-v>\[ou]B<--verbose>] [B<-c >I<chroot>\[ou]B<--chroot=>I<chroot> \[ou] B<--all>] [B<COMMANDE> [ B<ARG1> [ B<ARG2> [ B<ARGn>]]]]

note: type: Plain text
en: B<dchroot> allows the user to run a command or a login shell in a chroot environment.  If no command is specified, a login shell will be started in the user's home directory inside the chroot.
de: B<dchroot> autorise l'utilisateur à exécuter une commande ou un interpréteur de commande de connexion dans un environnement chrooté. Si aucune commande n'est précisée, un interpréteur de commande de connexion sera démarré dans le répertoire personnel de l'utilisateur dans le chroot.

note: type: Plain text
en: The command is one or more arguments which will be run in the user's default shell using its I<-c> option.  As a result, shell code may be embedded in this argument.  If multiple command options are used, they are concatenated together, separated by spaces.  Users should be aware of the shell quoting issues this presents, and should use B<schroot> if necessary, which does not have any quoting issues.
de: La commande est un ou plusieurs arguments qui seront exécutés dans l'interpréteur de commandes par défaut de l'utilisateur en utilisant l'option I<-c>. Par conséquent, du code shell peut être embarqué dans cet argument. Si de multiples options de commande sont utilisées, elles sont concaténées ensemble, séparées par des espaces. Les utilisateurs doivent faire attention aux problèmes de citation que cela présente, et doivent utiliser B<schroot> si nécessaire, qui ne présente pas ces problèmes de citation.

note: type: Plain text
en: This version of dchroot is a compatibility wrapper around the B<schroot>(1)  program.  It is provided for backward compatibility with the dchroot command-line options, but schroot is recommended for future use.  See the section \[lq]I<Incompatibilities>\[rq] below for known incompatibilities with older versions of dchroot.
de: Cette version de dchroot est une encapsulation de compatibilité autour du programme B<schroot>(1). Elle est fournie à des fins de rétro-comptabilité avec les options de ligne de commande de dchroot, mais schroot est recommandé pour des utilisations futures. Voyez la section \[lq]I<Incompatibilités>\[rq] ci-dessous pour plus d'informations sur des incompatibilités connues avec des versions plus anciennes de dchroot.

note: type: Plain text
en: If no chroot is specified, the chroot name or alias \[oq]default\[cq] will be used as a fallback.
de: Si aucun chroot n'est spécifié, le nom de chroot ou alias \[oq]default\[cq] sera utilisé à la place.

note: type: Plain text
en: B<dchroot> accepts the following options:
de: B<dchroot> accepte les options suivantes :

note: type: SS
en: Basic options
de: Options basiques

note: type: Plain text
en: Select all chroots.
de: Sélectionner tous les chroots.

note: type: Plain text
en: Specify a chroot to use.  This option may be used multiple times to specify more than one chroot, in which case its effect is similar to I<--all>.
de: Spécifier un chroot à utiliser. Cette option peut être utilisée plusieurs fois pour spécifier plus d'un chroot, dans ce cas elle a un effet similaire à I<--all>.

note: type: Plain text
en: Print detailed information about the specified chroots.  Note that earlier versions of dchroot did not include this option.
de: Afficher des informations détaillées à propos des chroots spécifiés. Notez que les versions précédentes de dchroot n'incluent pas cette option.

note: type: Plain text
en: Print location (path) of the specified chroots.
de: Afficher l'emplacement (chemin) des chroots sélectionnés.

note: type: Plain text
en: Print configuration of the specified chroots.  This is useful for testing that the configuration in use is the same as the configuration file.  Any comments in the original file will be missing.  Note that earlier versions of dchroot did not include this option.
de: Afficher la configuration des chroots spécifiés. C'est utile pour tester que la configuration utilisée est la même que celle du fichier de configuration. Tous les commentaires du fichier original sont omis. Notez que les versions précédentes de dchroot n'incluent pas cette option.

note: type: TP
en: B<--directory=>I<directory>
de: B<--directory=>I<répertoire>

note: type: Plain text
en: Change to I<directory> inside the chroot before running the command or login shell.  If I<directory> is not available, dchroot will exit with an error status.
de: Se déplacer dans le I<répertoire> dans le chroot avant d'exécuter la commande ou l'interpréteur de commande de connexion. Si le I<répertoire> n'est pas disponible, dchroot se terminera par un état d'erreur.

note: type: Plain text
en: The default behaviour is as follows (all directory paths are inside the chroot).  Unless the I<--preserve-environment> option is used to preserve the environment, the login shell or command will run in the user's home directory, or I</> if the home directory is not available.  When the I<--preserve-environment> option is used, it will attempt to use the current working directory, again falling back to I</> if it is not accessible.  If none of the directories are available, dchroot will exit with an error status.
de: Le comportement par défaut est comme suit (tous les répertoires sont dans le chroot). Sauf si l'option I<--preserve-environment> est utilisée pour préserver l'environnement, l'interpréteur de commande de connexion ou la commande sera exécuté dans le répertoire personnel de l'utilisateur, ou dans I</> si le répertoire personnel n'est pas disponible. Quand l'option I<--preserve-environment> est utilisé, une exécution dans le répertoire courant sera utilisée, se rabattant sur I</> si non accessible. Si aucun des répertoires n'est disponible, dchroot se terminera par un état d'erreur.

note: type: Plain text
en: Preserve the user's environment inside the chroot environment.  The default is to use a clean environment; this option copies the entire user environment and sets it in the session.
de: Préserver l'environnement de l'utilisateur à l'intérieur de l'environnement de chroot. Par défaut un environnement propre est utilisé ; cette option copie l'ensemble de l'environnement de l'utilisateur et le met en place dans la session.

note: type: Plain text
en: Print all messages.  Note that earlier versions of dchroot did not include this option.
de: Afficher tous les messages. Notez que les versions précédentes de dchroot n'incluent pas cette option.

note: type: Plain text
en: Note that earlier versions of dchroot did not provide long options.
de: Notez que les versions précédentes de dchroot ne fournissent pas les options longues.

note: type: SH
en: INCOMPATIBILITIES
de: INCOMPATIBILITÉS

note: type: SS
en: Debian dchroot prior to version 0.99.0
de: Debian dchroot antérieur à la version 0.99.0

note: type: Plain text
en: Log messages are worded and formatted differently.
de: Les messages d'information sont formulés et formatés différemment.

note: type: Plain text
en: B<su>(1)  is no longer used to run commands in the chroot; this is done by dchroot internally.  This change may cause subtle differences.  If you find an incompatibility, please report it so it may be corrected.
de: B<su>(1) n'est plus utilisé pour exécuter les commandes dans le chroot ; c'est effectué en interne par dchroot. Ce changement peut causer des différences subtiles. Si vous trouvez une incompatibilité, merci de le signaler pour qu'elle puisse être corrigée.

note: type: Plain text
en: dchroot provides a restricted subset of the functionality implemented by B<schroot>, but is still schroot underneath.  Thus dchroot is still subject to schroot security checking, including PAM authentication and authorisation, and session management, for example, and hence may behave slightly differently to older dchroot versions in some circumstances.
de: dchroot fournit un nombre restreint des fonctionnalités implémentées par B<schroot>, mais c'est quand même schroot qui est en-dessous. Par conséquent dchroot est encore soumis aux vérifications de sécurité de schroot, incluant l'authentification et autorisation PAM et la gestion des sessions, par exemple, et par conséquent peut se comporter légèrement différemment des versions plus anciennes de dchroot dans certaines circonstances.

note: type: SS
en: Debian dchroot prior to version 1.5.1
de: Debian dchroot antérieur à la version 1.5.1

note: type: Plain text
en: This version of dchroot uses I<schroot.conf> to store the configuration for available chroots, rather than the I<dchroot.conf> file used historically.  dchroot supported automatic migration of I<dchroot.conf> to the I<schroot.conf> keyfile format with its I<--config> option from versions 0.2.2 to 1.5.0; support for the old format is now no longer available.
de: Cette version de dchroot utilise I<schroot.conf> pour sauver la configuration pour les chroots disponibles, au lieu du fichier I<dchroot.conf> utilisé historiquement. dchroot prend en charge la migration automatique de I<dchroot.conf> vers le format de fichier par clé de I<schroot.conf> avec l'option I<--config> des versions 0.2.2 à 1.5.0 ; la prise en charge des formats plus anciens n'est plus disponible.

note: type: SS
en: DSA dchroot
de: dchroot DSA

note: type: Plain text
en: Machines run by the Debian System Administrators for the Debian Project have a B<dchroot-dsa> package which provides an alternate dchroot implementation.
de: Les machines exécutées par les Administrateurs Système Debian pour le projet Debian ont un paquet B<dchroot-dsa> qui fourni une implémentation alternative de dchroot.

note: type: Plain text
en: All the above incompatibilities apply.
de: Toutes les incompatibilités ci-dessus s'appliquent.

note: type: Plain text
en: This version of dchroot has incompatible command-line options, and while some of those options are supported or have equivalent options by a different name, the I<-c> option is not required to specify a chroot, and this version of dchroot cannot implement this behaviour in a backward-compatible manner (because if I<-c> is omitted, the default chroot is used).  DSA dchroot uses the first non-option as the chroot to use, only allowing one chroot to be used at once.
de: Cette version de dchroot possède des options de ligne de commande incompatibles alors que certaines de ces options sont supportées ou ont des options équivalentes avec un nom différent, l'option I<-c> n'est pas nécessaire pour spécifier un chroot et cette version de dchroot ne peut pas implémenter ce comportement de façon rétro-compatible (parce que si I<-c> est omis, le chroot par défaut est utilisé). Le dchroot DSA utilise le premier argument non-option comme chroot à utiliser, ne permettant l'utilisation que d'un seul chroot à la fois.

note: type: Plain text
en: dchroot will select an appropriate directory to use within the chroot based upon whether the I<--directory> or I<--preserve-environment> options are used.  When explicitly specifying a directory, only one directory will be used for safety and consistency, while for a login shell or command several possibilities may be tried.  Note that due to multiple fallbacks being considered for commands, it is dangerous to run commands using dchroot; use schroot instead.  The following subsections list the fallback sequence for each case.  CWD is the current working directory, DIR is the directory specified with I<--directory>.
de: dchroot sélectionnera un répertoire approprié à utiliser à l'intérieur du chroot suivant si les options I<--directory> ou I<--preserve-environment> sont utilisées. Quand un répertoire est explicitement spécifié, seul un répertoire sera utilisé pour des raisons de sécurité et d'intégrité. Notez qu'à cause des multiples solutions de repli considérées pour les commandes, il est dangereux d'exécuter des commandes en utilisant dchroot ; utiliser schroot à la place. Les sous-sections suivantes listent les séquences de solutions de repli pour chaque cas. CWD est le répertoire de travail courant, DIR est le répertoire spécifié par I<--directory>.

note: type: SS
en: Login shell or command
de: Interpréteur de commande de connexion ou commande

note: type: tbl table
en: Normal behaviour (if --directory and I<--preserve-environment> are not
de: Comportement normal (si ni I<--directory> ni I<--preserve-environment> ne sont

note: type: tbl table
en: used)
de:  utilisés)

note: type: tbl table
en: If passwd pw_dir is nonexistent
de: Si passwd pw_dir n'existe pas

note: type: SS
en: --preserve-environment used
de: --preserve-environment est utilisé

note: type: tbl table
en: Normal behaviour (if I<--preserve-environment> used)
de: Comportement normal (si I<--preserve-environment> n'est pas utilisé)

note: type: Plain text
en: Use I<--> to allow options beginning with \[oq]-\[cq] or \[oq]--\[cq] in the command to run in the chroot.  This prevents them being interpreted as options for dchroot itself.  Note that the top line was echoed to standard error, and the remaining lines to standard output.  This is intentional, so that program output from commands run in the chroot may be piped and redirected as required; the data will be the same as if the command was run directly on the host system.
de: Utilisez I<--> pour autoriser les options débutant avec \[oq]-\[cq] ou \[oq]--\[cq] pour la commande à exécuter dans le chroot. Cela empêche qu'elles soient interprétées en tant qu'options de dchroot. Notez que la première ligne a été affichée sur l'erreur standard, et le reste sur la sortie standard. C'est intentionnel, pour que la sortie du programme exécuté dans le chroot puisse être redirigée via un pipe ou autre si besoin ; les données seront les mêmes que si la commande était exécutée directement sur le système hôte.

note: type: Plain text
en: The system-wide B<schroot> definition file.  This file must be owned by the root user, and not be writable by other.
de: Le fichier de configuration de B<schroot> pour l'ensemble du système. Ce fichier doit être possédé par l'utilisateur root, et être non inscriptible par les autres.

note: type: Plain text
en: This implementation of dchroot uses the same command-line options as the original B<dchroot> by David Kimdon \f[CR]E<lt>dwhedon@debian.orgE<gt>\fR, but is an independent implementation.
de: L'implémentation de dchroot utilise les mêmes options de ligne de commande que le B<dchroot> d'origine de David Kimdon \f[CR]E<lt>dwhedon@debian.orgE<gt>\fR, mais est une implémentation indépendante.

note: type: Plain text
en: dchroot-dsa - enter a chroot environment
de: dchroot-dsa — entrer dans un environnement de chroot.

note: type: Plain text
en: B<dchroot-dsa> [B<-h>\[or]B<--help> \[or] B<-V>\[or]B<--version> \[or] B<-l>\[or]B<--list> \[or] B<-i>\[or]B<--info> \[or] B<--config> \[or] B<-p>|B<--listpaths>] [B<-d >I<directory>\[or]B<--directory=>I<directory>] [B<-q>\[or]B<--quiet> \[or] B<-v>\[or]B<--verbose>] [B<-c >I<chroot>\[or]B<--chroot=>I<chroot> \[or] B<--all> \[or] B<CHROOT]> [B<COMMAND>]
de: B<dchroot-dsa> [B<-h>\[ou]B<--help> \[ou] B<-V>\[ou]B<--version> \[ou] B<-l>\[ou]B<--list> \[ou] B<-i>\[ou]B<--info> \[ou] B<--config> \[ou] B<-p>|B<--listpaths>] [B<-d >I<répertoire>\[ou]B<--directory=>I<répertoire>] [B<-q>\[ou]B<--quiet> \[ou] B<-v>\[ou]B<--verbose>] [B<-c >I<chroot>\[or]B<--chroot=>I<chroot> \[ou] B<--all> \[ou] B<CHROOT]> [B<COMMANDE>]

note: type: Plain text
en: B<dchroot-dsa> allows the user to run a command or a login shell in a chroot environment.  If no command is specified, a login shell will be started in the user's home directory inside the chroot.
de: B<dchroot-dsa> autorise l'utilisateur à exécuter une commande ou un interpréteur de commande de connexion dans un environnement chrooté. Si aucune commande n'est précisée, un interpréteur de commande de connexion sera démarré dans le répertoire personnel de l'utilisateur dans le chroot.

note: type: Plain text
en: The user's environment will be preserved inside the chroot.
de: L'environnement de l'utilisateur sera préservé à l'intérieur du chroot.

note: type: Plain text
en: The command is a single argument which must be an absolute path to the program.  Additional options are not permitted.
de: La commande est un unique argument qui doit être un chemin absolu vers le programme. Des options supplémentaires ne sont pas permises.

note: type: Plain text
en: This version of dchroot-dsa is a compatibility wrapper around the B<schroot>(1)  program.  It is provided for backward compatibility with the dchroot-dsa command-line options, but schroot is recommended for future use.  See the section \[lq]I<Incompatibilities>\[rq] below for known incompatibilities with older versions of dchroot-dsa.
de: Cette version de dchroot-dsa est une encapsulation de compatibilité autour du programme B<schroot>(1). Elle est fournie à des fins de rétro-compatibilité avec les options de ligne de commande de dchroot-dsa, mais schroot est recommandé pour des utilisations futures. Voyez la section \[lq] I<Incompatibilités>\[rq] ci-dessous pour plus d'informations sur des incompatibilités connues avec des versions plus anciennes de dchroot-dsa.

note: type: Plain text
en: B<dchroot-dsa> accepts the following options:
de: B<dchroot-dsa> accepte les options suivantes :

note: type: Plain text
en: Select all chroots.  Note that earlier versions of dchroot-dsa did not include this option.
de: Sélectionner tous les chroots. Notez que les versions précédentes de dchroot-dsa n'incluent pas cette option.

note: type: Plain text
en: Specify a chroot to use.  This option may be used multiple times to specify more than one chroot, in which case its effect is similar to I<--all>.  If this option is not used, the first non-option argument specified the chroot to use.  Note that earlier versions of dchroot-dsa did not include this option.
de: Spécifier un chroot à utiliser. Cette option peut être utilisée plusieurs fois pour spécifier plus d'un chroot, qui dans ce cas a un effet similaire à I<--all>. Si cette option n'est pas utilisée, le premier argument non-option définira le chroot à utiliser. Notez que les versions précédentes de dchroot-dsa n'incluent pas cette option.

note: type: Plain text
en: Print detailed information about the available chroots.  Note that earlier versions of dchroot-dsa did not include this option.
de: Afficher des informations détaillées à propos des chroots disponibles. Notez que les versions précédentes de dchroot-dsa n'incluent pas cette option.

note: type: Plain text
en: Print absolute locations (paths) of the available chroots.
de: Afficher les chemins absolus des chroots disponibles.

note: type: Plain text
en: Print configuration of the available chroots.  This is useful for testing that the configuration in use is the same as the configuration file.  Any comments in the original file will be missing.  Note that earlier versions of dchroot-dsa did not include this option.
de: Afficher la configuration des chroots disponibles. C'est utile pour tester que la configuration utilisée est la même que celle du fichier de configuration. Tous les commentaires du fichier d'origine sont omis. Notez que les versions précédentes de dchroot-dsa n'incluent pas cette option.

note: type: Plain text
en: Change to I<directory> inside the chroot before running the command or login shell.  If I<directory> is not available, dchroot-dsa will exit with an error status.
de: Se déplacer dans le I<répertoire> dans le chroot avant d'exécuter la commande ou l'interpréteur de commande de connexion. Si le I<répertoire> n'est pas disponible, dchroot-dsa se terminera par un état d'erreur.

note: type: Plain text
en: The default behaviour (all directory paths are inside the chroot) is to run the login shell or command in the user's home directory, or I</> if the home directory is not available.  If none of the directories are available, dchroot-dsa will exit with an error status.
de: Le comportement par défaut (tous les répertoires sont dans le chroot) est d'exécuter l'interpréteur de commande de connexion ou la commande dans le répertoire personnel de l'utilisateur, ou dans I</> si le répertoire personnel n'est pas disponible. Si aucun de ces répertoires n'est disponible, dchroot se terminera par un état d'erreur.

note: type: Plain text
en: Print only essential messages.  Note that earlier versions of dchroot-dsa did not include this option.
de: Afficher uniquement les messages essentiels. Notez que les versions précédentes de dchroot-dsa n'incluent pas cette option.

note: type: Plain text
en: Print all messages.  Note that earlier versions of dchroot-dsa did not include this option.
de: Afficher tous les messages. Notez que les versions précédentes de dchroot-dsa n'incluent pas cette option.

note: type: Plain text
en: This version of dchroot-dsa uses I<schroot.conf> to store the configuration for available chroots, rather than the I<dchroot.conf> file used historically.  dchroot-dsa supported automatic migration of I<dchroot.conf> to the I<schroot.conf> keyfile format with its I<--config> option from versions 0.2.2 to 1.5.0; support for the old format is now no longer available.
de: Cette version de dchroot-dsa utilise I<schroot.conf> pour sauver la configuration pour les chroots disponibles, au lieu du fichier I<dchroot.conf> utilisé historiquement. dchroot-dsa prend en charge la migration automatique de I<dchroot.conf> vers le format de fichier par clé de I<schroot.conf> avec l'option I<--config> des versions 0.2.2 à 1.5.0 ; la prise en charge des formats plus anciens n'est plus disponible.

note: type: Plain text
en: dchroot-dsa provides a restricted subset of the functionality implemented by B<schroot>, but is still schroot underneath.  Thus dchroot-dsa is still subject to schroot security checking, including PAM authentication and authorisation, and session management, for example, and hence may behave slightly differently to earlier versions of dchroot-dsa in some circumstances.
de: dchroot-dsa fournit un nombre restreint des fonctionnalités implémentées par B<schroot>, mais c'est quand même schroot qui est en-dessous. Par conséquent dchroot-dsa est toujours soumis aux vérifications de sécurité de schroot, incluant les authentification et autorisation PAM et la gestion des sessions, par exemple, et par conséquent il peut se comporter légèrement différemment des versions plus anciennes de dchroot-dsa dans certaines circonstances.

note: type: SS
en: Debian dchroot
de: dchroot de Debian

note: type: Plain text
en: A B<dchroot> package provides an alternative dchroot implementation.
de: Le paquet B<dchroot> fournit une implémentation alternative de dchroot.

note: type: Plain text
en: This version of dchroot has incompatible command-line options, and while some of those options are supported or have equivalent options by a different name, the I<-c> option is required to specify a chroot.  It also allows a shell script to be used as the option instead of a single absolute path, and allows multiple command options instead of a single option.
de: Cette version de dchroot possède des options de ligne de commande incompatibles et certaines de ces options sont supportées ou ont des options équivalentes avec un nom différent, l'option I<-c> n'est pas nécessaire pour spécifier un chroot. Elle permet également à un shell script d'être utilisé comme option au lieu d'un chemin absolu unique ce qui permet l'exécution de commandes à options multiples au lieu d'une seule option.

note: type: Plain text
en: dchroot-dsa will select an appropriate directory to use within the chroot based upon whether the I<--directory> option is used.  When explicitly specifying a directory, only one directory will be used for safety and consistency, while for a login shell or command several possibilities may be tried.  Note that due to multiple fallbacks being considered for commands, it is dangerous to run commands using dchroot-dsa; use schroot instead.  The following subsections list the fallback sequence for each case.  CWD is the current working directory, DIR is the directory specified with I<--directory>.
de: dchroot-dsa sélectionnera un répertoire approprié à utiliser à l'intérieur du chroot suivant si l'option I<--directory> est utilisée. Quand un répertoire est explicitement spécifié, seul un répertoire sera utilisé pour des raisons de sécurité et d'intégrité. Notez qu'à cause de multiples solutions de repli considérées pour les commandes, il est dangereux d'exécuter des commandes en utilisant dchroot ; utiliser schroot à la place. Les sous-sections suivantes listent les séquences de solutions de repli pour chaque cas. CWD est le répertoire de travail courant, DIR est le répertoire spécifié par I<--directory>.

note: type: tbl table
en: Normal behaviour (if --directory is not used)
de: Comportement normal (si I<--directory> n'est pas utilisé)

note: type: Plain text
en: Note that the top line was echoed to standard error, and the remaining lines to standard output.  This is intentional, so that program output from commands run in the chroot may be piped and redirected as required; the data will be the same as if the command was run directly on the host system.
de: Notez que la première ligne a été affichée sur l'erreur standard, et le reste sur la sortie standard. C'est intentionnel, pour que la sortie du programme exécuté dans le chroot puisse être redirigée via un pipe ou autre si besoin ; les données seront les mêmes que si la commande était exécutée directement sur le système hôte.

note: type: Plain text
en: This implementation of dchroot-dsa uses the same command-line options as the B<dchroot> found on machines run by the Debian System Administrators for the Debian Project.  These machines have a B<dchroot-dsa> source package which provides a B<dchroot-dsa> package, written by Ben Collins \f[CR]E<lt>bcollins@debian.orgE<gt>\fR and Martin Schulze \f[CR]E<lt>joey@debian.orgE<gt>\fR.
de: Cette implémentation de dchroot-dsa utilise les même options de ligne de commande que le B<dchroot> trouvé sur les machines exécutées par les Administrateur Système Debian pour le projet Debian. Ces machines ont un paquet source B<dchroot-dsa> qui fournit un paquet B<dchroot-dsa>, écrit par Ben Collins \f[CR] E<lt>bcollins@debian.orgE<gt>\fR et Martin Schulze \f[CR]E<lt>joey@debian.orgE<gt>\fR.

en: System Management Commands
de: Kommandoer for systemhåndtering

en: edit the password, group, shadow-password or shadow-group file
de: rediger adgangskoden, gruppe, shadow-adgangskode- eller shadow-gruppe-fil

en: options
de: tilvalg

en: The <command>vipw</command> and <command>vigr</command> commands edits the files <filename>/etc/passwd</filename> and <filename>/etc/group</filename>, respectively. With the <option>-s</option> flag, they will edit the shadow versions of those files, <filename>/etc/shadow</filename> and <filename>/etc/gshadow</filename>, respectively. The programs will set the appropriate locks to prevent file corruption. When looking for an editor, the programs will first try the environment variable <envar>$VISUAL</envar>, then the environment variable <envar>$EDITOR</envar>, and finally the default editor, <citerefentry><refentrytitle>vi</refentrytitle><manvolnum>1</manvolnum></citerefentry>.
de: Kommandoerne <command>vipw</command> og <command>vigr</command> redigerer filerne <filename>/etc/passwd</filename> og <filename>/etc/group</filename>, respektivt. Med flaget <option>-s</option> vil de redigere versionerne for Shadow for disse filer, <filename>/etc/shadow</filename> og <filename>/etc/gshadow</filename>, respektivt. Programmerne vil sætte de passende låse for at forhindre filødelæggelse. Når der kigges efter et redigerngsprogram, så vil programmet øfrst forsøge med miljøvariablen <envar>$VISUAL</envar>, derefter miljøvariablen <envar>$EDITOR</envar>, og endelig standardredigeringsprogrammet, <citerefentry><refentrytitle>vi</refentrytitle><manvolnum>1</manvolnum></citerefentry>.

en: The options which apply to the <command>vipw</command> and <command>vigr</command> commands are:
de: Tilvalgene som gælder for kommandoerne <command>vipw</command> og <command>vigr</command> er:

en: Edit group database.
de: Rediger gruppedatabase.

en: Display help message and exit.
de: Vis hjælpeteksten og afslut.

en: Edit passwd database.
de: Rediger passwd-database.

en: Quiet mode.
de: Stille tilstand.

en: Apply changes in the <replaceable>CHROOT_DIR</replaceable> directory and use the configuration files from the <replaceable>CHROOT_DIR</replaceable> directory.
de: Brug ændringer i mappen <replaceable>CHROOT_DIR</replaceable> og brug konfigurationsfilerne fra mappen <replaceable>CHROOT_DIR</replaceable>.

en: Edit shadow or gshadow database.
de: Rediger shadow- eller gshadow-database.

en: Indicates which user's tcb shadow file to edit.
de: Indikerer hvilken brugers tcb-shadowfil at redigere.

en: The following configuration variables in <filename>/etc/login.defs</filename> change the behavior of this tool:
de: De følgende konfigurationsvariabler i <filename>/etc/login.defs</filename> ændrer opførelsen for dette værktøj:

en: <option>USE_TCB</option> (boolean)
de: <option>USE_TCB</option> (boolesk)

en: If <replaceable>yes</replaceable>, the <citerefentry><refentrytitle>tcb</refentrytitle><manvolnum>5</manvolnum></citerefentry> password shadowing scheme will be used.
de: Hvis <replaceable>ja</replaceable>, så vil skemaet for adgangskodeskygge <citerefentry><refentrytitle>tcb</refentrytitle><manvolnum>5</manvolnum></citerefentry> blive brugt.

en: VISUAL
de: VISUEL

en: Editor to be used.
de: Redigeringsprogram der skal bruges.

en: EDITOR
de: REDIGERINGSPROGRAM

en: Editor to be used if <option>VISUAL</option> is not set.
de: Redigeringsprogram der skal bruges hvis <option>VISUAL</option> ikke er angivet.

en: Group account information.
de: Information om gruppekonto.

en: Secure group account information.
de: Information om sikret gruppekonto.

en: User account information.
de: Information om brugerkonto.

en: Secure user account information.
de: Information om sikret brugerkonto.

en: <citerefentry><refentrytitle>vi</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>group</refentrytitle><manvolnum>5</manvolnum></citerefentry>, <citerefentry><refentrytitle>gshadow</refentrytitle><manvolnum>5</manvolnum></citerefentry><citerefentry condition="tcb"><refentrytitle>login.defs</refentrytitle><manvolnum>5</manvolnum></citerefentry>, <citerefentry><refentrytitle>passwd</refentrytitle><manvolnum>5</manvolnum></citerefentry>, <citerefentry condition="tcb"><refentrytitle>tcb</refentrytitle><manvolnum>5</manvolnum></citerefentry>, <citerefentry><refentrytitle>shadow</refentrytitle><manvolnum>5</manvolnum></citerefentry>.
de: <citerefentry><refentrytitle>vi</refentrytitle><manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>gruppe</refentrytitle><manvolnum>5</manvolnum></citerefentry>, <citerefentry><refentrytitle>gshadow</refentrytitle><manvolnum>5</manvolnum></citerefentry><citerefentry condition="tcb"><refentrytitle>login.defs</refentrytitle><manvolnum>5</manvolnum></citerefentry>, <citerefentry><refentrytitle>passwd</refentrytitle><manvolnum>5</manvolnum></citerefentry>, <citerefentry condition="tcb"><refentrytitle>tcb</refentrytitle><manvolnum>5</manvolnum></citerefentry>, <citerefentry><refentrytitle>shadow</refentrytitle><manvolnum>5</manvolnum></citerefentry>.

en: modify a user account
de: ændre en brugerkonto

en: LOGIN
de: LOGIND

en: The <command>usermod</command> command modifies the system account files to reflect the changes that are specified on the command line.
de: Kommandoen <command>usermod</command> ændrer systemkontofilerne så de reflekterer ændringerne som angives på kommandolinjen.

en: The options which apply to the <command>usermod</command> command are:
de: Tilvalgene som kan bruges for kommandoen <command>usermod</command> er:

en: Add the user to the supplementary group(s). Use only with the <option>-G</option> option.
de: Tilføj brugeren til de supplementære grupper. Brug kun med tilvalget <option>-G</option>.

en: <option>-c</option>, <option>--comment</option><replaceable>COMMENT</replaceable>
de: <option>-c</option>, <option>--comment</option><replaceable>KOMMENTAR</replaceable>

en: The new value of the user's password file comment field. It is normally modified using the <citerefentry><refentrytitle>chfn</refentrytitle><manvolnum>1</manvolnum></citerefentry> utility.
de: Den nye værdi for brugerens kommentar kommentarfelt i adgangskodefilen. Den ændres normalt med redskabet <citerefentry><refentrytitle>chfn</refentrytitle><manvolnum>1</manvolnum></citerefentry>.

en: <option>-d</option>, <option>--home</option><replaceable>HOME_DIR</replaceable>
de: <option>-d</option>, <option>--home</option><replaceable>HJEMMEMAPPE</replaceable>

en: The user's new login directory.
de: Brugerens nye logindmappe.

en: If the <option>-m</option> option is given, the contents of the current home directory will be moved to the new home directory, which is created if it does not already exist.
de: Hvis tilvalget <option>-m</option> er angivet, vil indholdet af den aktuelle hjemmemappe blive flyttet til den nye hjemmemappe, som oprettes hvis denne ikke allerede findes.

en: <option>-e</option>, <option>--expiredate</option><replaceable>EXPIRE_DATE</replaceable>
de: <option>-e</option>, <option>--expiredate</option><replaceable>UDLØBSDATO</replaceable>

en: The date on which the user account will be disabled. The date is specified in the format <emphasis remap="I">YYYY-MM-DD</emphasis>.
de: Datoen hvorpå brugerkontoen vil blive deaktiveret. Datoen er angivet i formatet <emphasis remap="I">ÅÅÅÅ-MM-DD</emphasis>.

en: An empty <replaceable>EXPIRE_DATE</replaceable> argument will disable the expiration of the account.
de: Et tomt argument for <replaceable>UDLØBSDATO</replaceable> vil deaktivere udløb for kontoen.

en: This option requires a <filename>/etc/shadow</filename> file. A <filename>/etc/shadow</filename> entry will be created if there were none.
de: Dette tilvalg kræver en <filename>/etc/shadow</filename>-fil. Et <filename>/etc/shadow</filename>-punkt vil blive oprettet hvis et sådant ikke fandtes.

en: <option>-f</option>, <option>--inactive</option><replaceable>INACTIVE</replaceable>
de: <option>-f</option>, <option>--inactive</option><replaceable>INAKTIV</replaceable>

en: The number of days after a password expires until the account is permanently disabled.
de: Antallet af dage fra en adgangskode udløber til kontoen bliver permanent deaktiveret.

en: The number of days after a password has expired before the account will be disabled.
de: Antallet af dage efter en adgangskode er udløbet før kontoen vil blive deaktiveret.

en: This option sets the <option>INACTIVE</option> variable in <filename>/etc/default/useradd</filename>.
de: Dette tilvalg sætter variablen <option>INACTIVE</option> i <filename>/etc/default/useradd</filename>.

en: The name of a new user's login shell.
de: Navnet på en ny brugers logindskal.

en: You may not add a user to a NIS or LDAP group. This must be performed on the corresponding server.
de: Du kan ikke tilføje en bruger til en NIS eller LDAP-gruppe. Dette skal udføres på den tilsvarende server.

en: Usernames may only be up to 32 characters long.
de: Brugernavne må kun være op til 32 tegn lange.

en: <option>CREATE_HOME</option> (boolean)
de: <option>CREATE_HOME</option> (boolesk)

en: Indicate if a home directory should be created by default for new users.
de: Indikerer om en hjemmemappe skal oprettes som standard for nye brugere.

en: This setting does not apply to system users, and can be overridden on the command line.
de: Denne indstilling gælder ikke for systembrugere og kan overskrives på kommandolinjen.

en: <option>GID_MAX</option> (number)
de: <option>GID_MAX</option> (nummer)

en: <option>GID_MIN</option> (number)
de: <option>GID_MIN</option> (nummer)

en: The default value for <option>GID_MIN</option> (resp. <option>GID_MAX</option>) is 1000 (resp. 60000).
de: Standardværdien for <option>GID_MIN</option> (resp. <option>GID_MAX</option>) er 1000 (resp. 60000).

en: Default values for account creation.
de: Standardværdier for kontooprettelse.

en: Directory containing default files.
de: Mappe indeholdende standardfiler.

en: invalid argument to option
de: Ugyldigt argument for tilvalg

en: UID already in use (and no <option>-o</option>)
de: UID er allerede i brug (og intet <option>-o</option>)

en: specified group doesn't exist
de: angivet gruppe findes ikke

en: username already in use
de: brugernavn er allerede i brug

en: can't create home directory
de: kan ikke oprette hjemmemappe

en: The <command>useradd</command> command exits with the following values: <placeholder-1/>
de: Kommandoen <command>useradd</command> findes med de følgende værdier: <placeholder-1/>

en: You can use the <option>--</option> argument to separate <command>su</command> options from the arguments supplied to the shell.
de: Du kan bruge argumentet <option>--</option> til at adskille <command>su</command>-tilvalg fra argumenterne angivet til skallen.

en: The user will be prompted for a password, if appropriate. Invalid passwords will produce an error message. All attempts, both valid and invalid, are logged to detect abuse of the system.
de: Brugeren vil blive spurgt om sin adgangskode, hvis det er relevant. Ugyldige adgangskoder vil medføre en fejlbesked. Alle forsøg, både gyldige og ugyldige, logges for at deteketere misbrug af systemet.

en: The shell specified with --shell.
de: Skallen angivet med --shell.

en: If the target user has a restricted shell, this option has no effect (unless <command>su</command> is called by root).
de: Hvis målbrugeren har en begrænset skal, så har dette tilvalg ingen effekt (med mindre <command>su</command> kaldes af root).

en: If not defined, root will be allowed on any device.
de: Hvis ikke defineret så vil administrator (root) være tilladt på alle enheder

en: The device should be specified without the /dev/ prefix.
de: Enheden skal angives uden præfikset /dev/.

en: Indicate if login is allowed if we can't cd to the home directory. Default is no.
de: Indiker om logind er tilladt, hvis vi ikke kan cd til hjemmemappen. Standarden er nej.

note: XXX: When compiled with PAM support, only sulogin uses ENV_HZ
en: <option>ENV_HZ</option> (string)
de: <option>ENV_HZ</option> (streng)

en: This field is reserved for future use.
de: Dette felt er reserveret for fremtidig brug.

en: Backup file for /etc/shadow.
de: Sikkerhedskopi for /etc/shadow.

en: Note that this file is used by the tools of the shadow toolsuite, but not by all user and password management tools.
de: Bemærk at denne fil bruges af værktøjer fra shodows værktøjssæt, men ikke af alle håndteringsværktøjer for brugere og adgangskoder.

en: SYNTAX
de: SYNTAKS

en: sp_min - days before which password may not be changed
de: sp_min - antal dage hvor adgangskode ikke må ændres

en: sp_max - days after which password must be changed
de: sp_max - antal dage hvorefter adgangskode skal ændres

en: sp_flag - reserved for future use
de: sp_flag - reserveret for fremtidig brug

en: can't open password files
de: kan ikke åbne adgangskodefiler

en: can't lock password files
de: kan ikke låse adgangskodefiler

en: can't update password files
de: kan ikke opdatere adgangskodefiler

en: can't sort password files
de: kan ikke sortere adgangskodefiler

en: The <command>pwck</command> command exits with the following values: <placeholder-1/>
de: Kommandoen <command>pwck</command> findes med de følgende værdier: <placeholder-1/>

en: You can find advices on how to choose a strong password on http://en.wikipedia.org/wiki/Password_strength
de: Du kan finde råd om hvordan du vælger en god adgangskode på http://en.wikipedia.org/wiki/Password_strength

en: The options which apply to the <command>passwd</command> command are:
de: Tilvalgene som gælder for kommandoen <command>passwd</command> er:

en: This option can be used only with <option>-S</option> and causes show status for all users.
de: Dette tilvalg kan kun bruges med <option>-S</option> medfører vis status for alle brugere.

en: Delete a user's password (make it empty). This is a quick way to disable a password for an account. It will set the named account passwordless.
de: Slet en brugers adgangskode (gør den tom). Dette er en hurtig måde at deaktivere en adgangskode for en konto. Den vil sætte den navngivne konto uden adgangskode.

en: Immediately expire an account's password. This in effect can force a user to change his/her password at the user's next login.
de: Angiv øjeblikkelig en kontos adgangskode som udløbet. Dette kan tvinge en bruger til at ændre sin adgangskode ved brugerens næste logind.

en: <option>-i</option>, <option>--inactive</option><replaceable>INACTIVE</replaceable>
de: <option>-i</option>, <option>--inactive</option><replaceable>INAKTIV</replaceable>

en: This option is used to disable an account after the password has been expired for a number of days. After a user account has had an expired password for <replaceable>INACTIVE</replaceable> days, the user may no longer sign on to the account.
de: Denne indstilling bruges til at deaktivere en konto efter at adgangskoden er udløbet i et antal dage. Efter at en brugerkonto har haft en udløbet adgangskode for <replaceable>INAKTIV</replaceable> dage, kan brugeren ikke længere logge ind på kontoen.

en: This variable is deprecated. You should use <option>ENCRYPT_METHOD</option>.
de: Denne variabel er forældet, du skal bruge <option>ENCRYPT_METHOD</option>.

en: <option>OBSCURE_CHECKS_ENAB</option> (boolean)
de: <option>OBSCURE_CHECKS_ENAB</option> (boolesk)

en: Enable additional checks upon password changes.
de: Aktiver yderligere kontroller før ændringer af adgangskode.

en: <option>PASS_ALWAYS_WARN</option> (boolean)
de: <option>PASS_ALWAYS_WARN</option> (boolesk)

en: Warn about weak passwords (but still allow them) if you are root.
de: Advar om svage adgangskoder (men tillad dem stadig) hvis du er administrator (root).

en: <option>PASS_CHANGE_TRIES</option> (number)
de: <option>PASS_CHANGE_TRIES</option> (antal)

en: Maximum number of attempts to change password if rejected (too easy).
de: Maksimalt antal forsøg at ændre adgangskode hvis afvist (for nemt).

en: <option>PASS_MAX_LEN</option> (number)
de: <option>PASS_MAX_LEN</option> (antal)

en: <option>PASS_MIN_LEN</option> (number)
de: <option>PASS_MIN_LEN</option> (antal)

en: <option>SHA_CRYPT_MIN_ROUNDS</option> (number)
de: <option>SHA_CRYPT_MIN_ROUNDS</option> (antal)

en: PAM configuration for <command>passwd</command>.
de: PAM-konfiguration for <command>passwd</command>.

en: permission denied
de: tilladelse nægtet

en: invalid combination of options
de: Ugyldig kombination af tilvalg

en: unexpected failure, nothing done
de: uventet fejl, intet udført

en: unexpected failure, <filename>passwd</filename> file missing
de: uventet fejl, <filename>passwd</filename>-filen mangler

en: <filename>passwd</filename> file busy, try again
de: <filename>passwd</filename>-filen er optaget, forsøg igen

en: The <command>passwd</command> command exits with the following values: <placeholder-1/>
de: Kommandoen <command>passwd</command> afsluttedes med de følgende værdier: <placeholder-1/>

en: politely refuse a login
de: nægt venligt et logind

en: The <command>nologin</command> command appearred in BSD 4.4.
de: Kommandoen <command>nologin</command> fremkom i BSD 4.4.

en: update and create new users in batch
de: opdater og opret nye brugere i et job

en: file
de: fil

en: This is the name of the user.
de: Dette er navnet på brugeren.

en: This field will be encrypted and used as the new value of the encrypted password.
de: Dette felt vil være krypteret og brugt som den nye værdi for den krypterede adgangskode.

en: This field is used to define the UID of the user.
de: Dette flet bruges til at definere UID for brugeren.

en: If the field is empty, an new (unused) UID will be defined automatically by <command>newusers</command>.
de: Hvis feltet er tomt, vil en ny (ubrugt) UID blive defineret automatisk af <command>newusers</command>.

en: If this field contains a number, this number will be used as the UID.
de: Hvis dette felt indeholer et tal, så vil dette tal blive brugt som UID'en.

en: If this field contains the name of an existing user (or the name of an user created before by <command>newusers</command>), the UID of the specified user will be used.
de: Hvis dette felt indeholder navnet på en eksisterende bruger (eller navnet på en bruger oprettet før af <command>newusers</command>), så vil UID'en for den angivne bruger blive brugt.

en: If the UID of an existing user is changed, the files ownership of the user's file should be fixed manually.
de: Hvis UID'en for en eksisterende bruger har ændret sig, så skal filens ejerskab for brugerens fil rettes manuelt.

en: This field is used to define the primary group ID for the user.
de: Dette felt bruges til at definere det primære gruppe-id for brugeren.

en: This field is copied in the GECOS field of the user.
de: Dette felt er kopieret i GECOS-feltet for brugeren.

en: This field is used to define the home directory of the user.
de: Dette felt bruges til at definere hjemmemappen for brugeren.

en: If this field does not specify an existing directory, the specified directory is created, with ownership set to the user being created or updated and its primary group.
de: Hvis feltet ikke angiver en eksisterende mappe, så oprettes den angiven mappe, med ejerskab angivet for brugeren der oprettes elelr opdateres og dennes primære gruppe.

en: If the home directory of an existing user is changed, <command>newusers</command> does not move or copy the content of the old directory to the new location. This should be done manually.
de: Hvis hjemmemappen for en eksisterende bruger ændres så flytter eller kopierer <command>newusers</command> ikke indholdet fra den gamle mappe til den nye placering. Dette ksal gøres manuelt.

en: This field defines the shell of the user. No checks are performed on this field.
de: Dette felt definerer brugerens skal. Ingen kontrollerer udføres på dette felt.

en: This command is intended to be used in a large system environment where many accounts are updated at a single time.
de: Denne kommando skal bruges i store systemmiljøer hvor mange kontoer opdateres på en gang.

en: The options which apply to the <command>newusers</command> command are:
de: Tilvalgene som gælder for kommandoen <command>newusers</command> er:

en: Use the specified method to encrypt the passwords.
de: Brug den angivne metode til at kryptere adgangskoderne.

en: The available methods are DES, MD5, NONE, and SHA256 or SHA512 if your libc support these methods.
de: De tilgængelige metoder er DES, Md5, NONE og SHA256 eller SHA512 hvis din libc understøtter disse metoder.

en: System users will be created with no aging information in <filename>/etc/shadow</filename>, and their numeric identifiers are chosen in the <option>SYS_UID_MIN</option>-<option>SYS_UID_MAX</option> range, defined in <filename>login.defs</filename>, instead of <option>UID_MIN</option>-<option>UID_MAX</option> (and their <option>GID</option> counterparts for the creation of groups).
de: Systembrugere vil blive oprettet uden aldersinformation i <filename>/etc/shadow</filename>, og deres numeriske identifikatører vælges i intervallet <option>SYS_UID_MIN</option>-<option>SYS_UID_MAX</option>, defineret i <filename>login.defs</filename>, i stedet for <option>UID_MIN</option>-<option>UID_MAX</option> (og deres <option>GID</option>-modparte for oprettelsen af grupper.).

en: Use the specified number of rounds to encrypt the passwords.
de: Brug det angivet antal rundet til at kryhptere adgangskoderne.

en: The value 0 means that the system will choose the default number of rounds for the crypt method (5000).
de: Værdien 0 betyder at systemet vil vælge antallet af standardrunder for krypteringsmetoden (5000).

en: A minimal value of 1000 and a maximal value of 999,999,999 will be enforced.
de: En minimusværdi på 1000 og en maksimumsværdi på 999.999.999 vil blive påtvunget.

en: You can only use this option with the SHA256 or SHA512 crypt method.
de: Du kan kun bruge dette tilvalg med SHA256- eller SHA512-krypteringsmetoden.

en: By default, the number of rounds is defined by the SHA_CRYPT_MIN_ROUNDS and SHA_CRYPT_MAX_ROUNDS variables in <filename>/etc/login.defs</filename>.
de: Som standard er antallet af runder defineret af variablerne SHA_CRYPT_MIN_ROUNDS og SHA_CRYPT_MAX_ROUNDS i <filename>/etc/login.defs</filename>.

en: The input file must be protected since it contains unencrypted passwords.
de: Inddatafilen skal beskyttes da den indeholder adgangskoder der ikke er krypteret.

en: You should make sure the passwords and the encryption method respect the system's password policy.
de: Du skal sikre dig at adgangskoderne og krypteringsmetoden respekterer systemets adgangskodepolitik.

en: PAM configuration for <command>newusers</command>.
de: PAM-konfiguration for <command>newusers</command>.

en: log in to a new group
de: log ind på en ny gruppe

en: The <command>newgrp</command> command is used to change the current group ID during a login session. If the optional <option>-</option> flag is given, the user's environment will be reinitialized as though the user had logged in, otherwise the current environment, including current working directory, remains unchanged.
de: Kommandoen <command>newgrp</command> bruges til at ændre den aktuelle grupp-id under en logindsession. Hvis det valgfrie flag <option>-</option> er angivet, så vil brugerens miljø blive geninitialiseres som om at brugeren havde logget ind, ellers bevares det aktuelle miljø, inklusiv aktuel arbejdsmappe, uændret.

en: enforce login time restrictions
de: påtving restriktioner for logindperiode

en: List of current login sessions.
de: Liste over aktuelle logindsessioner.

en: This file is a readable text file, each line of the file describing one configuration parameter. The lines consist of a configuration name and value, separated by whitespace. Blank lines and comment lines are ignored. Comments are introduced with a "#" pound sign and the pound sign must be the first non-white character of the line.
de: Denne fil er en læsbar tekstfil, hvier linje i filen beskriver en konfigurationsparameter. Linjerne består af et konfigurationsnavn og -værdi, adskilt af mellemrum. Tomme linjer og kommentarlinjer ignoreres. Kommentarer indledes med tegnet »#« og tegnet skal være det første tegn på linjen, som ikke er et mellemrum.

en: The following configuration items are provided:
de: De følgende konfigurationspunkter tilbydes:

en: <option>CHFN_AUTH</option> (boolean)
de: <option>CHFN_AUTH</option> (boolesk)

en: <option>FAIL_DELAY</option> (number)
de: <option>FAIL_DELAY</option> (antal)

en: Enable logging of successful logins.
de: Aktiver logning af succesfulde logind.

en: <option>LOG_UNKFAIL_ENAB</option> (boolean)
de: <option>LOG_UNKFAIL_ENAB</option> (boolesk)

en: Enable display of unknown usernames when login failures are recorded.
de: Aktiver visning af ukendte brugernavne når logindfejl optages.

en: Note: logging unknown usernames may be a security issue if an user enter her password instead of her login name.
de: Bemærk: Logning af ukendte brugernaven kan udgøre en sikkerhedsmæssig risiko såfremt en bruger indtatser sin adgangskode i stedet for sit logindnavn.

en: <option>LOGIN_RETRIES</option> (number)
de: <option>LOGIN_RETRIES</option> (antal)

en: Maximum number of login retries in case of bad password.
de: Maksimalt antal logindforsøg i tilfælde af ugyldig adgangskode.

en: This will most likely be overridden by PAM, since the default pam_unix module has its own built in of 3 retries. However, this is a safe fallback in case you are using an authentication module that does not enforce PAM_MAXTRIES.
de: Denne vil højst sandsynlig blive overskrevet af PAM, da standardmodulet pam_unix har sin egen indbygget 3 forsøg. Dette er dog en ekstra sikkerhed i tilfælde af at du bruger et godkendelsesmodul som ikke påtvinger PAM_MAXTRiES.

en: <option>LOGIN_TIMEOUT</option> (number)
de: <option>LOGIN_TIMEOUT</option> (antal)

en: Max time in seconds for login.
de: Maks. tidsforbrug i sekunder for logind.

en: <option>MOTD_FILE</option> (string)
de: <option>MOTD_FILE</option> (streng)

en: <option>TTYGROUP</option> (string)
de: <option>TTYGROUP</option> (streng)

en: <option>TTYPERM</option> (string)
de: <option>TTYPERM</option> (streng)

en: By default, the ownership of the terminal is set to the user's primary group and the permissions are set to <replaceable>0600</replaceable>.
de: Som standard er ejerskabet af terminalen angivet til brugerens primære gruppe og rettighederne er angivet til <replaceable>0600</replaceable>.

en: <option>TTYTYPE_FILE</option> (string)
de: <option>TTYTYPE_FILE</option> (streng)

en: Default <command>ulimit</command> value.
de: Standardværdi for <command>ulimit</command>.

en: The following cross references show which programs in the shadow password suite use which parameters.
de: De følgende krydsreferencer viser hvilke programmer i shadows adgangskodeprogrampakke der bruger hvilke parametre.

en: login access control table
de: kontroltabel for logindadgang

en: Each line of the login access control table has three fields separated by a ":" character:
de: Hver linje i kontroltabellen for logindadagng har tre felter adskilt af tegnet »:«:

en: host
de: vært

en: Name of the remote host for this login.
de: Navn på den eksterne vært for dette logind.

en: Preserve environment.
de: Bevar miljø.

en: Perform autologin protocol for rlogin.
de: Udfør autologin-protokol for rlogin.

en: The location of files is subject to differences in system configuration.
de: Placeringen af filer er underlagt forskelle i systemkonfiguration.

en: List of previous login sessions.
de: Liste over tidligere logindsessioner.

en: Suppress printing of system messages.
de: Undertryk udskrivning af systembeskeder.

en: Each line describes a limit for a user in the form:
de: Hver linje beskriver en begrænsning for en bruger i formen:

en: user LIMITS_STRING
de: bruger LIMITS_STRING

en: or in the form:
de: eller i formen:

en: A: max address space (KB)
de: A: Maks. adresserum (KB)

en: D: max data size (KB)
de: D: Maks. datastørrelse (KB)

en: F: maximum filesize (KB)
de: F: Maks filstørrelse (KB)

en: N: max number of open files
de: N: Maks antal åbne filer

en: T: max CPU time (MIN)
de: T: Maks CPU-tid (MIN)

en: If more than one line with limits for an user exist, only the first line for this user will be considered.
de: Hvis mere end en linje med begrænsninger for en bruger findes, så vil kun den første linje for denne bruger indgå.

en: Database times of previous user logins.
de: Databasetider for tidligere brugerlogind.

en: group name
de: gruppenavn

en: It must be a valid group name, which exist on the system.
de: Det skal være et gyldigt gruppenavn, som findes på systemet.

en: administrators
de: administratorer

en: It must be a comma-separated list of user names.
de: Det skal være en kommaadskilt liste af brugernavne.

en: Administrators can change the password or the members of the group.
de: Administratorer kan ændre adgangskoden eller medlemmerne af gruppen.

en: Administrators also have the same permissions as the members (see below).
de: Administratorer har også de samme rettigheder som medlemmerne (se nedenfor).

en: members
de: medlemmer

en: Members can access the group without being prompted for a password.
de: Medlemmer kan tilgå gruppen uden at blive spurgt efter en adgangskode.

en: You should use the same list of users as in <filename>/etc/group</filename>.
de: Du skal bruge den samme liste over brugere som i <filename>/etc/group</filename>.

en: verify integrity of group files
de: verificer integritet for gruppefiler

en: a unique and valid group name
de: et unikt og gyldigt gruppenavn

en: The options which apply to the <command>grpck</command> command are:
de: Tilvalgen som gælder for kommandoen <command>grpck</command> er:

en: can't open group files
de: kan ikke åbne gruppefiler

en: can't lock group files
de: kan ikke låse gruppefiler

en: can't update group files
de: kan ikke opdatere gruppefiler

en: The <command>grpck</command> command exits with the following values: <placeholder-1/>
de: Kommandoen <command>grpck</command> findes med de følgende værdier: <placeholder-1/>

en: display current group names
de: vis aktuelle gruppenavne

en: user
de: bruger

en: modify a group definition on the system
de: ændr en gruppedefinition på systemet

en: GROUP
de: GRUPPE

en: Users who use the group as primary group will be updated to keep the group as their primary group.
de: Brugere som bruger gruppen som primær gruppe vil blive opdateret for at beholde gruppen som deres primære gruppe.

en: group name already in use
de: gruppenavn er allerede i brug

en: The <command>groupmod</command> command exits with the following values: <placeholder-1/>
de: Kommandoen <command>groupmod</command> findes med de følgende værdier: <placeholder-1/>

en: administer members of a user's primary group
de: administrer medlemmer for en brugers primære gruppe

en: Add an user to the group membership list.
de: Tilføj en bruger til listen over gruppemedlemmer.

en: If the <filename>/etc/gshadow</filename> file exist, and the group has no entry in the <filename>/etc/gshadow</filename> file, a new entry will be created.
de: Hvis filen <filename>/etc/gshadow</filename> findes, og gruppen ikke har et punkt i filen <filename>/etc/gshadow</filename>, så vil et nyt punkt blive oprettet.

en: Delete a user from the group membership list.
de: Slet en bruger fra listen over gruppemedlemskab.

en: delete a group
de: slet en gruppe

en: The options which apply to the <command>groupdel</command> command are:
de: Tilvalgene som gælder for kommandoen <command>groupdel</command> er:

en: You may not remove the primary group of any existing user. You must remove the user before you remove the group.
de: De kan ikke fjerne den primære gruppe for en eksisterende bruger. Du skal fjerne brugeren før du fjerner gruppen.

en: You should manually check all file systems to ensure that no files remain owned by this group.
de: Du skal manuelt kontrollere alle filsystemer for at sikre dig, at ingen filer fortsat er ejet af denne gruppe.

en: can't remove user's primary group
de: Kan ikke fjerne brugers primære gruppe

en: The <command>groupdel</command> command exits with the following values: <placeholder-1/>
de: Kommandoen <command>groupdel</command> findes med de følgende værdier: <placeholder-1/>

en: create a new group
de: opret en ny gruppe

en: The options which apply to the <command>groupadd</command> command are:
de: Tilvalgene som gælder for kommandoen <command>groupadd</command> er:

en: See also the <option>-r</option> option and the <option>GID_MAX</option> description.
de: Se også tilvalget <option>-r</option> og beskrivelsen <option>GID_MAX</option>.

en: Create a system group.
de: Opret en systemgruppe.

en: The structure of the file is:
de: Strukturen for filen er:

en: The options which apply to the <command>chfn</command> command are:
de: Tilvalgende som gælder for kommandoen <command>chfn</command> er:

en: <option>-f</option>, <option>--full-name</option><replaceable>FULL_NAME</replaceable>
de: <option>-f</option>, <option>--full-name</option><replaceable>NAVN</replaceable>

en: Change the user's full name.
de: Ændr brugerens navn.

en: <option>-h</option>, <option>--home-phone</option><replaceable>HOME_PHONE</replaceable>
de: <option>-h</option>, <option>--home-phone</option><replaceable>TELEFONNUMMER</replaceable>

en: Change the user's home phone number.
de: Ændr brugerens telefonnummer.

en: <option>-o</option>, <option>--other</option><replaceable>OTHER</replaceable>
de: <option>-o</option>, <option>--other</option><replaceable>ANDEN</replaceable>

en: Change the user's other GECOS information. This field is used to store accounting information used by other applications, and can be changed only by a superuser.
de: Ændr brugerens anden GECOS-information. Dette felt bruges til at gemme kontoinformation brugt af andre programmer, og kan kun ændres af en superbruger.

en: <option>-r</option>, <option>--room</option><replaceable>ROOM_NUMBER</replaceable>
de: <option>-r</option>, <option>--room</option><replaceable>VÆRELSESNUMMER</replaceable>

en: Change the user's room number.
de: Ændr brugerens værelsesnummer.

en: <option>-w</option>, <option>--work-phone</option><replaceable>WORK_PHONE</replaceable>
de: <option>-w</option>, <option>--work-phone</option><replaceable>ARBEJDSTELEFON</replaceable>

en: Change the user's office phone number.
de: Ændr brugerens arbejdsnummer.

en: change user password expiry information
de: ændr udløbsinformation om brugeradgangskode

en: The options which apply to the <command>chage</command> command are:
de: Tilvalgene som gælder for kommandoen <command>chage</command> er:

en: The <command>chage</command> program requires a shadow password file to be available.
de: Programmet <command>chage</command> kræver at en adgangskodefil for shadow er tilgængelig.

en: The <command>chage</command> command is restricted to the root user, except for the <option>-l</option> option, which may be used by an unprivileged user to determine when his/her password or account is due to expire.
de: Kommandoen <command>chage</command> er begrænset til administratorbrugeren (root), undtaget for tilvalget <option>-l</option>, som kan bruges af en upriviligeret bruger til at bestemme hvornår denne brugers adgangskode eller konto står til at udløbe.

en: can't find the shadow password file
de: Kan ikke finde shadows adgangskodefil

en: The <command>chage</command> command exits with the following values: <placeholder-1/>
de: Kommandoen <command>chage</command> findes med de følgende værdier: <placeholder-1/>
