DNF5.CONF-VENDORPOLICY-V1_0(5)

NAMN
dnf5.conf-vendorpolicy-v1_0 - DNF5:s policyfilreferens för leverantörsändring — v1.0

BESKRIVNING

Detta dokument beskriver strukturen och syntaxen i DNF5:s policykonfigurationsfiler för leverantörsändring med formatet version 1.0.

För allmän information om policyfiler för leverantörsändring, se DNF5:s policyfilreferens för leverantörsändring <#dnf5-vendor-change-policy-label>.

FILSTRUKTUR

  Nödvändiga fält

    version
        Sträng

        Konfigurationsfilens formatversion.

        För detta format måste detta vara satt till "1.0".

        Detta fält är obligatoriskt och måste anges på toppnivån i TOML-filen.

        Exempel:

                version = '1.0'

OBS:
        För att konfigurationsfilen skall ha någon påverkan på leverantörsändringspolicyn måste den definiera leverantörsavbildningar med en av de tillåtna konfigurationerna (se nedan).

        Om filen inte innehåller några leverantörslistor kommer den att laddas och dess version kommer valideras, men den kommer inte definiera några regler och kommer inte påverka beteendet hos leverantörshanteraren.

  Leverantörsavbildningsdefinition

Filen kan använda en av följande metoder för leverantörsdefinitioner. Endast en metod kan användas.

Alternativ 1: Separata listor (utgående + inkommande)

    [[outgoing_vendors]]
        Vektor av tabeller

        Lista över leverantörer från vilka ändringar tillåts (utgående paketleverantörer).

    [[incoming_vendors]]
        Vektor av tabeller

        Lista över leverantörer till vilka ändringar tillåts (inkommande paketleverantörer).

OBS:
        outgoing_vendors och incoming_vendors måste antingen båda finnas eller båda saknas.

Viktigt:
        En leverantörsändring under ersättning av ett paket tillåts endast om båda villkoren samtidigt uppfylls:

            •   Leverantören i det utgående (installerade) paketet är listad i outgoing_vendors

            •   Leverantören i det inkommande (nya) paketet är listad i incoming_vendors

Alternativ 2: Ekvivalenta leverantörer

    [[equivalent_vendors]]
        Vektor av tabeller

        Lista över leverantörer som är ömsesidigt ekvivalenta. Ändringar tillåts i båda riktningar mellan alla leverantörer i denna lista.

        OBS:
            Det går inte att kombinera equivalent_vendors med outgoing_vendors eller incoming_vendors. Dock är equivalent_vendors faktiskt en förkortad notation. Det är ekvivalent med att lista samma leverantörer i både outgoing_vendors och incoming_vendors.

  Leverantörspostfält

Varje post i [[outgoing_vendors]], [[incoming_vendors]] eller [[equivalent_vendors]] kan innehålla följande fält:

    vendor
        Sträng

        Nödvändigt fält.

        Leverantörsnamn eller -mönster för matchning.

    comparator
        Sträng

        Valfritt fält.

        Matchningsmetoden som skall användas när leverantörssträngar jämförs.

        Standard: "EXACT"

        Värden som stödjs:

        •   "EXACT" — exakt matchning (skiftlägeskänsligt)

        •   "IEXACT" — exakt matchning (skiftlägesokänsligt)

        •   "GLOB" - glob-mönster (skiftlägeskänsligt)

        •   "IGLOB" - glob-mönster (skiftlägesokänsligt)

        •   "REGEX" — reguljärt uttryck (skiftlägeskänsligt)

        •   "IREGEX" — reguljärt uttryck (skiftlägesokänsligt)

        •   "CONTAINS" — innehåller strängen (skiftlägeskänsligt)

        •   "ICONTAINS" — innehåller strängen (skiftlägesokänsligt)

        •   "STARTSWITH" — börjar med (skiftlägeskänsligt)

        •   "ISTARTSWITH" — börjar med (skiftlägesokänsligt)

        •   "ENDSWITH" — slutar med (skiftlägeskänsligt)

        •   "IENDSWITH" — slutar med (skiftlägesokänsligt)

        •   "NOT_EXACT", "NOT_IEXACT", "NOT_GLOB", "NOT_IGLOB", "NOT_CONTAINS", "NOT_ICONTAINS" — negerade varianter

    exclude
        Boolean

        Valfritt fält.

        Om true utesluts leverantören från regeln. Detta är användbart för att definiera undantag till mer generella regler. Regler (leverantörsposter) bearbetas i den ordning de är definierade. Detta betyder att en exclude-regel måste förekomma före regeln från vilken leverantören skall uteslutas.

        Standard: false

EXEMPEL

  Exempel 1: Tillåt ändring från ”LeverantörA” till ”LeverantörB”

Detta exempel visar den minsta nödvändiga konfigurationen som tillåter en ändring från ”LeverantörA” till ”LeverantörB”, men inte omvänt.

            version = '1.0'

            [[outgoing_vendors]]
            vendor = 'LeverantörA'

            [[incoming_vendors]]
            vendor = 'LeverantörB'

  Exempel 2: Tillåt ändring från godtycklig leverantör till ”Min betrodda leverantör”

Detta exempel visar hur man tillåter en ändring från alla leverantörer till ”Min betrodda leverantör”, men inte tvärt om (kräver en uttrycklig regel för att tillåta alla leverantörer).

            version = '1.0'

            [[outgoing_vendors]]
            vendor = ''
            comparator = 'CONTAINS'

            [[incoming_vendors]]
            vendor = 'Min betrodda leverantör'

  Exempel 3: Ekvivalenta leverantörer

Detta exempel visar leverantörer som är ömsesidigt ekvivalenta, och tillåter ändringar i båda riktningarna.

            version = '1.0'

            # Alla följande leverantörer är ömsesidigt ekvivalenta
            [[equivalent_vendors]]
            vendor = 'Fedora Project'

            [[equivalent_vendors]]
            vendor = 'Red Hat'
            comparator = 'ISTARTSWITH'

            [[equivalent_vendors]]
            vendor = 'CentOS'
            comparator = 'ISTARTSWITH'

  Exempel 4: Ekvivavlenta leverantörer med ett undantag

Detta exempel visar en leverantörspolicy för SUSE-relaterade leverantörer med ett undantag för openSUSE Build Service.

            version = '1.0'

            # Alla följande leverantörer är ömsesidigt ekvivalenta bortsett från de uteslutna
            [[equivalent_vendors]]
            vendor = 'openSUSE Build Service'
            comparator = 'ISTARTSWITH'
            exclude = true

            [[equivalent_vendors]]
            vendor = 'SUSE'
            comparator = 'ISTARTSWITH'

            [[equivalent_vendors]]
            vendor = 'openSUSE'
            comparator = 'ISTARTSWITH'

SE ÄVEN

    •   DNF5:s policyfilreferens för leverantörsändring <#dnf5-vendor-change-policy-label>

    •   DNF5:s policyfilreferens för leverantörsändring — v1.1 <#dnf5-vendor-change-policy-v1-1-label>

    •   dnf5.conf(5), DNF5:s konfigurationsreferens <#dnf5-conf-label>

Upphovsman
Se AUTHORS.md i dnf5 källkodsdistribution.

Copyright
Medarbetare i dnf5-projektet.

ÖVERSÄTTNING
Den svenska översättningen av denna manualsida skapades av Göran Uddeborg <goeran@uddeborg.se>

Denna översättning är fri dokumentation; läs GNU General Public License Version 3 (https://www.gnu.org/licenses/gpl-3.0.html) eller senare för upphovsrättsvillkor. Vi tar INGET ANSVAR.

Om du hittar fel i översättningen av denna manualsida, skicka ett mail till Tp-sv@listor.tp-sv.se.