DNF5-ALIASES(7)                      dnf5                      DNF5-ALIASES(7)

BEZEICHNUNG
       dnf5-aliases - Aliase fur Befehlszeilenargumente

BESCHREIBUNG
       Es ist moglich, eigene Aliase zu definieren, welche dann als
       dnf(5)-Befehle oder Optionen verwendet werden konnen, um langere
       Befehls- und Optionssequenzen abzukurzen.

       Die Aliase konnen im TOML-Format konfiguriert werden. Die
       Konfigurationsdateien werden aus folgenden Erganzungsverzeichnissen
       geladen:

          o /usr/share/dnf5/aliases.d/

          o /etc/dnf/dnf5-aliases.d/

          o $XDG_CONFIG_HOME/dnf5/aliases.d/

   Syntax:
       Die Konfigurationsdatei muss mit dem Attribut version beginnen, das auf
       die erforderliche Version gesetzt ist, zum Beispiel:

          version = '1.1'

       Jeder Alias ist in einem separaten Abschnitt als Schlussel = Wert-Paar
       definiert, zum Beispiel:

          ['in']
          type = 'command'
          attached_command = 'install'
          descr.C = "Alias for 'install'"
          descr.de_DE = "Alias fur 'install'"

       Der Abschnittsname definiert den Alias eindeutig. Er ist als Pfad
       formatiert, das heisst, eine Zeichenkette oder mehrere, durch Punkte
       getrennt. Sie definieren den Bereich des Alias. Beispielsweise
       identifiziert die Zeichenkette >>group.list.in<< einen Alias, der nur
       innerhalb des Bereichs des Unterbefehls group list verwendet werden
       kann.

       Es gibt die folgenden Aliastypen:

          o command

          o cloned_named_arg

          o named_arg

          o group

   Typ: command
       Der command-Alias definiert einen Alias fur einen Befehl.

       Schlussel:

              o type - Muss den Wert command haben.

              o attached_command - Pfad zu einem Befehl, fur den dieser Alias
                definiert ist.

              o descr.<Locale> - Beschreibung, die in der Hilfe angezeigt
                wird. descr.C wird verwendet, falls eine Kopfzeile fur die
                entsprechende Locale nicht gefunden wird. Wurde in der
                Konfigurationsdateiversion 1.1 hinzugefugt.

              o descr - Beschreibung, die in der Hilfe angezeigt wird.  Wurde
                in Version 1.1 als veraltet markiert, aber verbleibt zwecks
                Abwartskompatibilitat. Locales werden nicht unterstutzt.

              o group_id - Eine Gruppe, zu der dieser Alias gehort, falls
                zutreffend.

              o complete - Gibt an, ob die Autovervollstandigung der bash(1)
                fur diesen Alias genutzt werden soll; die Vorgabe ist
                >>false<< (falsch).

              o required_values - Werte (positionale Argumente), die vom
                Befehls-Alias verarbeitet werden. Das Format ist ein Feld aus
                Tabellen; jede davon muss entweder value_help.<Locale> fur die
                aktive Locale oder value_help.C enthalten. Optional kann
                descr.<Locale> enthalten sein. Die Vorgabe ist ein leeres
                Feld. Wurde in der Konfigurationsdateiversion 1.1 hinzugefugt.

              o attached_named_args - Optionen, die vom Befehl verwendet
                werden. Das Format ist ein Feld  aus Tabellen, wovon jede
                einen id_path-Schlussel enthalten muss, der den Pfad zu einer
                Option angibt. Weiterhin kann auch ein value-Schlussel
                enthalten sein, der den Wert der Option angibt. Der
                value-Schlussel kann ${index}-Platzhalter enthalten, die durch
                Werte ersetzt werden, die vom Befehlsalias verarbeitet werden
                (wie von required_values definiert). Befehlsargumente beginnen
                beim Index 1. Index 0 bezieht sich auf den Befehlsalias
                selbst. Falls kein value-Schlussel angegeben wird, wird eine
                leere Zeichenkette an benannte Argumente ubergeben, die einen
                Wert erwarten.

       Die erforderlichen Schlussel sind type und attached_command.

       Beispiele:

              o Alias grouplist fur group list:

                   ['grouplist']
                   type = 'command'
                   attached_command = 'group.list'
                   descr.C = "Alias for 'group list'"
                   descr.de_DE = "Alias fur 'group list'"

              o Alias group.ls fur group list:

                   ['group.ls']
                   type = 'command'
                   attached_command = 'group.list'
                   descr.C = "Alias for 'group list'"
                   descr.de_DE = "Alias fur 'group list'"
                   complete = true

              o Alias list-fedora-all fur --repo=fedora list --showduplicates:

                   ['list-fedora-all']
                   type = 'command'
                   attached_command = 'list'
                   descr.C = "Alias for '--repo=fedora list --showduplicates'"
                   descr.de_DE = "Alias fur '--repo=fedora list --showduplicates'"
                   complete = true
                   attached_named_args = [
                       { id_path = 'repo', value = 'fedora' },
                       { id_path = 'list.showduplicates' }
                   ]

              o Alias whatrequires fur repoquery --installed
                --whatrequires=<erfordert_erstes_Argument>:

                   ['whatrequires']
                   type = 'command'
                   attached_command = 'repoquery'
                   descr = 'Alias fur "repoquery --installed --whatrequires=<whatrequires_first_argument>"'
                   complete = true

                   [[whatrequires.required_values]]
                   value_help.C = 'CAPABILITY,...'
                   descr.C = 'Limit to packages that require any of <capabilities>.'
                   descr.de_DE = 'Auf Pakete begrenzen, die irgendwelche <Capabilities> benotigen.'

                   [[whatrequires.attached_named_args]]
                   id_path = 'repoquery.installed'

                   [[whatrequires.attached_named_args]]
                   id_path = 'repoquery.whatrequires'
                   value='${1}'

   Typ: cloned_named_arg
       Der Alias cloned_named_arg definiert einen anderen Namen fur eine
       angegebene Option.

       Schlussel:

              o type - Muss den Wert cloned_named_arg haben.

              o long_name - Name der Alias-Option.

              o short_name - Ein einzelner Buchstabe als Kurzel des Namens.

              o source - Pfad zu der Option, fur welche dieser Alias definiert
                ist.

              o group_id - Eine Gruppe, zu der dieser Alias gehort, falls
                zutreffend.

              o complete - Gibt an, ob die Autovervollstandigung der bash(1)
                fur diesen Alias genutzt werden soll; die Vorgabe ist
                >>false<< (falsch).

       Die erforderlichen Schlussel sind type, entweder long_name oder
       short_name, und source.

       Beispiele:

              o Alias --nobest fur --no-best:

                   ['nobest']
                   type = 'cloned_named_arg'
                   long_name = 'nobest'
                   source = 'no-best'

              o Alias repoquery --list oder repoquery -l fur repoquery
                --files:

                   ['repoquery.list']
                   type = 'cloned_named_arg'
                   long_name = 'list'
                   short_name = 'l'
                   source = 'repoquery.files'

   Typ: named_arg
       named_arg definiert einen Alias, der mehrere Optionen ersetzen und
       einen Wert fur jede Option definieren kann.

       Schlussel:

              o type - Muss den Wert named_arg haben.

              o long_name - Name der Alias-Option.

              o short_name - Ein einzelner Buchstabe als Kurzel des Namens.

              o descr.<Locale> - Beschreibung, die in der Hilfe angezeigt
                wird. descr.C wird verwendet, falls eine Kopfzeile fur die
                entsprechende Locale nicht gefunden wird. Wurde in der
                Konfigurationsdateiversion 1.1 hinzugefugt.

              o descr - Beschreibung, die in der Hilfe angezeigt wird.  Wurde
                in Version 1.1 als veraltet markiert, aber verbleibt zwecks
                Abwartskompatibilitat. Locales werden nicht unterstutzt.

              o has_value - Gibt an, ob die Option einen Wert erfordert. Der
                Wert wird dann fur ${}-Zeichenketten in den Werten von
                attached_named_args ersetzt. Vorgabe ist >>false<< (falsch).

              o value_help.<Locale> - Die Zeichenkette, die in der Hilfe fur
                den Wert angezeigt wird (zum Beispiel CONFIG_FILE_PATH fur
                --config=CONFIG_FILE_PATH). value_help.C wird verwendet, falls
                eine Zeichenkette fur die entsprechende Locale nicht gefunden
                wird. Wurde in der Konfigurationsdateiversion 1.1 hinzugefugt.

              o value_help - Die Zeichenkette, die in der Hilfe fur den Wert
                angezeigt wird (zum Beispiel CONFIG_FILE_PATH fur
                --config=CONFIG_FILE_PATH). Wurde in Version 1.1 als veraltet
                markiert, aber verbleibt zwecks Abwartskompatibilitat. Locales
                werden nicht unterstutzt.

              o const_value - Vorgegebener Konstantwert (wird nur angegeben,
                wenn der Alias keinen Wert in der Befehlszeile hat). Der Wert
                wird dann fur die Ersetzung von ${}-Zeichenketten in den
                Werten von attached_named_args verwendet.

              o group_id - Eine Gruppe, zu der dieser Alias gehort, falls
                zutreffend.

              o complete - Gibt an, ob die Autovervollstandigung der bash(1)
                fur diesen Alias genutzt werden soll; die Vorgabe ist
                >>false<< (falsch).

              o attached_named_args - Optionen, die verwendet werden. Das
                Format ist ein Feld aus eingefugten Tabellen, wovon jede einen
                id_path-Schlussel zur Angabe eines Pfades als Option enthalt.
                Weiterhin kann sie auch einen value-Schlussel enthalten, der
                den Wert der Option angibt.

       Die erforderlichen Schlussel sind type und entweder long_name oder
       short_name.

       Beispiele:

              o Alias list --all-available fur list --showduplicates
                --available:

                   ['list.all-available']
                   type = 'named_arg'
                   long_name = 'all-available'
                   attached_named_args = [
                       { id_path = 'list.showduplicates' },
                       { id_path = 'list.available' }
                   ]

              o Alias download --dest=ZIELVERZEICHNIS fur download
                --destdir=ZIELVERZEICHNIS:

                   ['download.dest']
                   type = 'named_arg'
                   long_name = 'dest'
                   has_value = true
                   value_help.C = 'ZIELVERZEICHNIS'
                   attached_named_args = [
                       { id_path = 'download.destdir' }
                   ]

              o Alias --settsflags=TS-SCHALTER fur
                --setopt=tsflags=TS-SCHALTER:

                   ['settsflags']
                   type = 'named_arg'
                   long_name = 'settsflags'
                   descr.C = 'Set transaction flags'
                   descr.de_DE = 'Transaktionsschalter setzen'
                   has_value = true
                   value_help.C = 'TRANSAKTIONSSCHALTER'
                   attached_named_args = [
                    { id_path = 'setopt', value = 'tsflags=${}' }
                   ]

   Typ: group
       group definiert eine Gruppe fur mehrere Befehle oder Optionen.

       Erforderliche Schlussel:

              o type - Muss den Wert group haben.

              o header.<Locale> - Die Kopfzeile der Gruppe, wie sie in der
                Hilfe angezeigt wird. header.C wird verwendet, falls eine
                Kopfzeile fur die entsprechende Locale nicht gefunden wird.
                Wurde in der Konfigurationsdateiversion 1.1 hinzugefugt.

              o header - Die Kopfzeile der Gruppe, wie sie in der Hilfe
                angezeigt wird.  Wurde in Version 1.1 als veraltet markiert,
                aber verbleibt zwecks Abwartskompatibilitat. Locales werden
                nicht unterstutzt.

       Die erforderlichen Schlussel sind type und header.

       Die Aliase werden zur Gruppe mit dem Schlussel group_id in den
       entsprechenden Abschnitten hinzugefugt.

       Beispiele:

              o Die Gruppe query-aliases fur den Unterbefehl repo anlegen,
                welche die Aliase repo.ls und repo.if enthalt:

                   ['repo.query-aliases']
                   type = 'group'
                   header.C = 'Query Aliases:'
                   header.de_DE = 'Abfrage-Aliase:'

                   ['repo.ls']
                   type = 'command'
                   attached_command = 'repo.list'
                   descr.C = "Alias for 'repo list'"
                   descr.de_DE = "Alias fur 'repo list'"
                   group_id = 'query-aliases'

                   ['repo.if']
                   type = 'command'
                   attached_command = 'repo.info'
                   descr.C = "Alias for 'repo info'"
                   descr.de_DE = "Alias fur 'repo info'"
                   group_id = 'query-aliases'

AUTOR
       Siehe AUTHORS.md in der dnf5-Quelldistribution.

COPYRIGHT
       Mitwirkende am DNF5-Projekt.

UBERSETZUNG
       Die deutsche Ubersetzung dieser Handbuchseite wurde von Mario
       Blattermann <mario.blaettermann@gmail.com> erstellt.

       Diese Ubersetzung ist Freie Dokumentation; lesen Sie die GNU General
       Public License Version 3 <https://www.gnu.org/licenses/gpl-3.0.html>
       oder neuer bezuglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG
       ubernommen.

       Wenn Sie Fehler in der Ubersetzung dieser Handbuchseite finden,
       schicken Sie bitte eine E-Mail an die Mailingliste der Ubersetzer:
       <debian-l10n-german@lists.debian.org>.

                                25. August 2025                DNF5-ALIASES(7)