yum(8)

yum(8)

NAMN

yum – Yellowdog Updater Modified

SYNOPSIS

yum [alternativ] [kommando] [paket ...]

BESKRIVNING

yum är en interaktiv, RPM-baserad pakethanterare. Den kan automatiskt utföra systemuppdateringar, inklusive beroendeanalys och hantering av föråldrade paket (obsoletes) baserat på metadata från förråd (repositories). Den kan också installera nya paket, ta bort gamla paket samt göra frågor mot installerade och/eller tillgängliga paket, bland många andra kommandon och tjänster (se nedan). yum liknar andra pakethanterare på hög nivå, som apt-get och smart.

Även om det finns grafiska gränssnitt direkt mot yum-koden sker mer modern utveckling av grafiska gränssnitt via PackageKit och programmet gnome-packagekit.

kommando är ett av följande:

install package1 [package2] [...]
update [package1] [package2] [...]
update-to [package1] [package2] [...]
check-update
upgrade [package1] [package2] [...]
upgrade-to [package1] [package2] [...]
distribution-synchronization [package1] [package2] [...]
remove | erase package1 [package2] [...]
list [...]
info [...]
provides | whatprovides feature1 [feature2] [...]
clean [ packages | metadata | expire-cache | rpmdb | plugins | all ]
makecache
groupinstall group1 [group2] [...]
groupupdate group1 [group2] [...]
grouplist [hidden] [groupwildcard] [...]
groupremove group1 [group2] [...]
groupinfo group1 [...]
search string1 [string2] [...]
shell [filnamn]
resolvedep dep1 [dep2] [...]
localinstall rpmfile1 [rpmfile2] [...]     (endast av kompatibilitetsskäl – använd install)
localupdate rpmfile1 [rpmfile2] [...]      (endast av kompatibilitetsskäl – använd update)
reinstall package1 [package2] [...]
downgrade package1 [package2] [...]
deplist package1 [package2] [...]
repolist [all|enabled|disabled]
version [ all | installed | available | group-* | nogroups* | grouplist | groupinfo ]
history [info|list|packages-list|packages-info|summary|addon-info|redo|undo|rollback|new|sync|stats]
load-transaction [txfile]
check
help [kommando]

Om inte flaggorna --help eller -h används måste ett av kommandona ovan anges.

Förrådskonfiguration respekteras vid alla operationer.

KOMMANDON

install

   Används för att installera den senaste versionen av ett paket eller en grupp av paket, samtidigt som alla beroenden uppfylls (se Specificera paketnamn nedan).
   Om inget paket matchar angivet paketnamn antas namnet vara ett skal-globmönster och alla matchningar installeras.
   Om namnet börjar med tecknet @ behandlas resten som argument till kommandot groupinstall.
   Om namnet börjar med tecknet - görs en sökning i transaktionen och matchningar tas bort.
   Om namnet är en fil fungerar install som localinstall.
   Om namnet inte matchar ett paket söks även i paketens provides (t.ex. “_sqlitecache.so()(64bit)”) samt i fillistor (t.ex. “/usr/bin/yum”).
   För fillistor kan jokertecken matcha flera paket.

update

   Om kommandot körs utan paket uppdateras alla installerade paket.
   Om ett eller flera paket eller globmönster anges uppdateras bara de listade paketen. Under uppdatering säkerställer yum att alla beroenden uppfylls.
   Om angivna paket/globmönster matchar paket som inte är installerade kommer update inte att installera dem.
   update fungerar även på grupper, filer, provides och fillistor på samma sätt som install.

   Om huvudinställningen obsoletes är sann (standard), eller om flaggan --obsoletes anges, inkluderar yum “obsoletes” i sina beräkningar – vilket är användbart vid större distributionsuppgraderingar.

   Observera att update först matchar installerade paket; om inga matchningar hittas söker den i tillgängliga paket. Detta märks t.ex. vid “update foo-1-2” om foo-1-2 är installerat – då beter sig kommandot som “update foo”. Använd i stället “update-to” om du vill att inget ska hända i det fallet.

update-to

   Som update, men specificerar alltid vilken version du vill uppdatera till.

check-update

   Gör att du kan se om maskinen har uppdateringar utan att köra interaktivt.
   Returnerar statuskod 100 om uppdateringar finns och listar paketen i listformat.
   Returnerar 0 om inga uppdateringar finns, 1 vid fel.
   I verbose-läge visas även “obsoletes”.

upgrade

   Samma som update med flaggan --obsoletes aktiverad.

upgrade-to

   Som upgrade, men specificerar alltid vilken version du vill uppgradera till.

distribution-synchronization / distro-sync

   Synkroniserar installerade paket med de senaste tillgängliga i förråden genom att obsoleta, uppgradera eller nedgradera efter behov.
   Detta gör normalt samma som upgrade, men om du t.ex. har paketet FOO installerat i version 4 och senaste tillgängliga bara är version 3, kommer detta kommando att nedgradera FOO till version 3.

   Detta kommando utför inte operationer på grupper, lokala paket eller negativa val.

remove / erase

   Tar bort angivna paket samt paket som beror på dem. Fungerar på grupper, filer, provides och fillistor på samma sätt som install.
   Notera att ”yum” normalt finns i listan över skyddade paket (protected_packages), så du kan inte råka ta bort yum självt.

list

   Listar olika typer av information om paket. Se Listalternativ nedan.

provides / whatprovides

   Tar reda på vilket paket som tillhandahåller en funktion eller fil. Du kan använda ett specifikt namn eller fil-globmönster.

search

   Söker efter paket när du vet något om paketet men inte dess exakta namn.
   Som standard söker search i paketnamn och sammanfattningar; om det inte ger träffar söks även i beskrivningar och URL.
   Resultat sorteras så att paket som matchar fler termer kommer först.
   Du kan tvinga sökning ”överallt” genom att ange ”all” som första argument.

info

   Visar beskrivning och sammanfattning för paket. Tar samma argument som listlägena (se Listalternativ).

clean

   Rensar olika saker som samlas i yum-cachekatalogen över tid. Se Rensningsalternativ.

makecache

   Hämtar och skapar användbar metadata för alla aktiverade yum-förråd.

groupinstall

   Installerar alla individuella paket i en grupp (som om varje paketnamn hade angetts på kommandoraden till “yum install”). Inställningen group_package_types avgör vilka typer som installeras.

groupupdate

   Alias för groupinstall (gör ”rätt” eftersom “yum install X” och “yum update X” gör samma sak när X redan är installerat).

grouplist

   Listar tillgängliga grupper från alla yum-förråd. Grupper markeras som ”installed” om alla obligatoriska paket är installerade, eller (om inga obligatoriska finns) om något valfritt/standardpaket är installerat.
   Argumentet hidden listar även grupper som inte är ”user visible”.
   Med -v visas groupid.

groupremove

   Tar bort alla paket i en grupp (till skillnad från groupinstall, som bara installerar enligt group_package_types).
   Observera att paket kan ingå i fler än en grupp.
   Inställningen groupremove_leaf_only kan ändra beteendet så att bara ”löv”-paket (som inget annat kräver) tas bort.

groupinfo

   Visar beskrivning och paketlista för en grupp (och vilka typer paketen är markerade som).
   Med -v matchas paketnamn mot installerade/tillgängliga paket likt list.

shell [filnamn]

   Startar ”yum shell”. Om ett filnamn anges körs innehållet i filen i shell-läge. Se yum-shell(8).

resolvedep

   Listar paket som tillhandahåller angivna beroenden; högst ett paket listas per beroende.

localinstall

   Installerar lokala rpm-filer. Vid behov används aktiverade förråd för att lösa beroenden.
   Obs: install gör också lokal installation om du anger ett filnamn; localinstall finns främst av kompatibilitetsskäl.

localupdate

   Uppdaterar systemet genom att ange lokala rpm-filer. Endast rpm-filer där en äldre version redan är installerad installeras; övriga ignoreras.
   Obs: update gör också lokal uppdatering om du anger ett filnamn; localupdate finns främst av kompatibilitetsskäl.

reinstall

   Installerar om samma version som är installerad. Fungerar inte för ”installonly”-paket (t.ex. kärnor). Fungerar på grupper, filer, provides och fillistor som install.

downgrade

   Försöker nedgradera ett paket från installerad version till föregående högsta version (eller den angivna).
   Beroendelösaren kanske inte alltid lyckas, men med komplett uppsättning paket brukar det fungera. Fungerar inte för ”installonly”-paket. Arbetar på grupper, filer, provides, fillistor och rpm-filer som install.

deplist

   Visar alla beroenden och vilka paket som tillhandahåller dem för angivna paket.

repolist

   Listar konfigurerade förråd. Standard är att lista alla aktiverade.
   Med -v visas mer information.
   Om första argumentet är enabled, disabled eller all listas respektive typ.

   Du kan ange repo-id eller namn (eller jokertecken) att matcha mot. Om id eller namn matchar exakt listas repo:t även när du listar aktiverade repo:n (även om det är avstängt).

   I icke-verbose-läge:
   * Första kolumnen börjar med “*” om repo:t har metalink-data och senaste metadata inte är lokal.
   * Sista kolumnen visar antalet paket i repo:t och (om det finns användardefinierade exkluderingar) antalet exkluderade paket.

   I icke-verbose-läge ignorerar yum även repo-fel och skriver ut den information den kan få.

version

   Skapar en ”version” av rpmdb samt (om ”all” anges) av aktiverade förråd. Du kan också ange versionsgrupper via filen version-groups.
   Med -v visas mer.
   Versionen beräknas via en SHA1-hash av paketen (sorterade) samt posterna checksum_type/checksum_data i yumdb.
   Detta rpmdb-version-ID används även i yum (särskilt i yum history).

   Underkommandon:
   * version grouplist – listar definierade versionsgrupper
   * version groupinfo – visar komplett lista av paket i en eller flera versionsgrupper
   * version installed – standard, visar bara installerade paket
   * version available – visar bara tillgängliga paket
   * version all – installerade och tillgängliga
   * version nogroups / nogroups-* – visar bara huvudversionen
   * version group-* – visar bara gruppad version, eventuellt begränsat till angivna grupper

history

   Låter dig se vad som hänt i tidigare transaktioner (förutsatt att history_record är aktiverat).
   Du kan använda info/list/packages-list/packages-info/summary för att se vad som hänt, undo/redo/rollback för att agera på historiken, och new för att starta en ny historikfil.

   * info/list/summary tar antingen ett transaktions-ID eller ett paket (med jokertecken, se Specificera paketnamn). Alla tre kan köras utan argument. list kan ta nyckelordet all för att lista alla transaktioner.
   * packages-list/packages-info tar ett paket (med jokertecken) och visar data ur paketets perspektiv.
   * undo/redo/rollback tar antingen ett transaktions-ID eller nyckelordet last med ett offset från sista transaktionen (t.ex. last-4).

   Exempel: Om du har 3 transaktioner där paketen A, B, C installerats i ordning:
   * undo 1 försöker ta bort A
   * redo 1 försöker installera A igen (om det inte fortfarande är installerat)
   * rollback 1 försöker ta bort B och C
   Efter rollback 1 skapas en fjärde transaktion; rpmdb-versionen efteråt bör matcha transaktion 1.

   Extra markörer i history list (kolumnen Altered):

    >  rpmdb ändrades utanför yum efter transaktionen
    <  rpmdb ändrades utanför yum före transaktionen
    *  transaktionen avbröts före slutförande
    #  transaktionen slutfördes men med icke-noll status
    E  transaktionen slutfördes men hade varning/felutskrift under körning
    P  transaktionen slutfördes men problem fanns redan i rpmdb
    s  transaktionen slutfördes men --skip-broken var aktiv och hoppade över paket
    

load-transaction

   Laddar en sparad yum-transaktionsfil. Detta gör att du kan lösa en transaktion på en maskin och köra den på en annan.
   Vanliga sätt att få en transaktionsfil är:
   * “yum -q history addon-info last saved_tx”
   * automatiska sparningar i $TMPDIR/yum_save_tx.* när en transaktion är löst men inte körd

check

   Kontrollerar lokal rpmdb och rapporterar problem. Du kan begränsa till dependencies eller duplicates; standard är all.

help

   Visar hjälp för alla kommandon, eller för ett specifikt kommando om namn anges.

ALLMÄNNA ALTERNATIV

De flesta kommandoradsalternativ kan också sättas i konfigurationsfilen; beskrivningarna anger vilken inställning som påverkas.

-h, --help

   Hjälp; visa hjälpmeddelande och avsluta.

-y, --assumeyes

   Anta ”ja”; anta att svaret på alla frågor är ja.
   Konfigurationsalternativ: assumeyes

-c, --config=[konfigfil]

   Anger var konfigurationsfilen finns – kan vara HTTP/FTP-URL eller lokal filsökväg.

-q, --quiet

   Kör utan utdata. Notera att du sannolikt också vill använda -y.

-v, --verbose

   Kör med mycket felsökningsutdata.

-d, --debuglevel=tal

   Sätter debugnivå (praktiskt intervall 0–10).
   Konfigurationsalternativ: debuglevel

-e, --errorlevel=tal

   Sätter felnivå (praktiskt intervall 0–10).
   0 = skriv bara kritiska fel; 1 = skriv alla fel; högre = mer.
   -e 0 är bra för cron-jobb.
   Konfigurationsalternativ: errorlevel

--rpmverbosity=namn

   Sätter utdata-nivå för rpm-scriptlets. Standard är info.
   Andra alternativ: critical, emergency, error, warn, debug.
   Konfigurationsalternativ: rpmverbosity

-R, --randomwait=minuter

   Maximal tid yum väntar innan den utför kommandot (slumpad över intervallet).

-C, --cacheonly

   Kör helt från systemcache – laddar inte ned eller uppdaterar headers om det inte krävs.
   För vanliga användare används inte temporär cache, utan systemcache.

--version

   Rapporterar yum-version samt installerade paketversioner för allt i history_record_packages (kan utökas av plugins).

--showduplicates

   Begränsar inte till senaste version i info/list/search (påverkar även plugins som använder doPackageLists()).

--installroot=root

   Anger alternativ installroot, relativt vilket alla paket installeras.
   Konfigurationsalternativ: installroot

--enablerepo=repoidglob

   Aktiverar specifika förråd (id eller glob) som är avstängda (enabled=0).
   Konfigurationsalternativ: enabled

--disablerepo=repoidglob

   Stänger av specifika förråd (id eller glob).
   Konfigurationsalternativ: enabled

--obsoletes

   Påverkar bara update; aktiverar yum:s obsoletes-logik.
   Konfigurationsalternativ: obsoletes

-x, --exclude=paket

   Exkluderar ett paket (namn eller glob) från uppdateringar i alla förråd.
   Konfigurationsalternativ: exclude

--color=[always|auto|never]

   Färglägg utdata automatiskt beroende på terminal, alltid (ANSI) eller aldrig.
   Vissa kommandon (t.ex. list och info) gör lite extra arbete när färg är på.
   Konfigurationsalternativ: color

--disableexcludes=[all|main|repoid]

   Inaktiverar exkluderingar från konfigurationsfiler:
   * all – inaktivera alla excludes
   * main – inaktivera excludes definierade i [main] i yum.conf
   * repoid – inaktivera excludes definierade för angivet repo

--disableplugin=plugin

   Kör med en eller flera plugins inaktiverade. Argument är kommaseparerad lista av jokertecken som matchar plugin-namn.

--noplugins

   Kör med alla plugins inaktiverade.
   Konfigurationsalternativ: plugins

--nogpgcheck

   Kör utan kontroll av GPG-signaturer.
   Konfigurationsalternativ: gpgcheck

--skip-broken

   Löser depsolve-problem genom att ta bort paket som orsakar problem från transaktionen.
   Konfigurationsalternativ: skip_broken

--releasever=version

   Låtsas att nuvarande release-version är angivet värde. Mycket användbart tillsammans med --installroot.
   Notera: Med standard cachedir (/var/cache/yum) kan detta korrumpera cachen. Använd $releasever i cachedir-inställningen för att undvika det.

-t, --tolerant

   Gör för närvarande ingenting.

--setopt=option=value

   Sätter valfri konfigurationsparameter i yum-konfig eller repo-filer.
   För globala val: --setopt=option=value
   För repo-val: --setopt=repoid.option=value

LISTALTERNATIV

Utdataformat för yum list:

namn.arch [epoch:]version-release repo eller @installed-from-repo

yum list [all | glob1] [glob2] ...

   Lista alla tillgängliga och installerade paket.

yum list available [glob...]

   Lista alla paket i yum-förråden som kan installeras.

yum list updates [glob...]

   Lista alla paket som har uppdateringar tillgängliga i förråden.

yum list installed [glob...]

   Lista paket som matchar angivna argument. Om ett argument inte matchar ett paketnamn antas det vara ett skal-globmönster och matchningar skrivs ut.

yum list extras [glob...]

   Lista paket installerade på systemet som inte finns i några förråd listade i konfig.

yum list obsoletes [glob...]

   Lista installerade paket som är obsoletade av paket i något förråd i konfig.

yum list recent

   Lista paket som nyligen lagts till i förråden. Ofta inte så användbart; du kanske hellre vill använda “yum list-updateinfo new” från säkerhetspluginet.

SPECIFICERA PAKETNAMN

Ett paket kan refereras för install, update, remove, list, info etc med någon av följande former (och med globmönster över dessa):

name
name.arch
name-ver
name-ver-rel
name-ver-rel.arch
name-epoch:ver-rel.arch
epoch:name-ver-rel.arch

Exempel:

yum remove kernel-2.4.1-10.i686

Eller:

yum list available 'foo*'

(Enkla citattecken hindrar skalet från att expandera globmönstret.)

RENSNINGSALTERNATIV

Observera: ”alla filer” i kommandona nedan betyder ”alla filer i för tillfället aktiverade förråd”. Om du också vill rensa tillfälligt avstängda förråd behöver du använda --enablerepo='*'.

yum clean expire-cache

   Tar bort lokala data som anger när metadata och mirrorlists hämtades per repo. Detta gör att yum återvaliderar cache nästa gång. Om cache fortfarande är giltig tas inget väsentligt bort.

yum clean packages

   Tar bort cachade paket från systemet. Paket tas inte automatiskt bort efter nedladdning.

yum clean headers

   Tar bort alla header-filer som gamla yum-versioner använde för beroendelösning.

yum clean metadata

   Tar bort alla filer yum använder för att avgöra fjärrtillgänglighet. Tvingar nedladdning av metadata nästa gång.

yum clean dbcache

   Tar bort sqlite-cache för snabbare metadataåtkomst. Tvingar nedladdning eller återskapande vid nästa körning (beroende på repo/ålder).

yum clean rpmdb

   Tar bort cachade data från lokala rpmdb.

yum clean plugins

   Ber aktiverade plugins att rensa sin cache.

yum clean all

   Utför alla ovanstående.

PLUGINS

Yum kan utökas med plugins. En plugin är en Python-fil (.py) som installeras i en av katalogerna som anges av alternativet pluginpath i yum.conf. För att en plugin ska fungera krävs:

1. Plugin-modulen måste vara installerad i plugin-sökvägen. 2. Den globala inställningen plugins i /etc/yum.conf måste vara satt till 1. 3. En konfigurationsfil måste finnas i /etc/yum/pluginconf.d/<plugin_name>.conf och inställningen enabled måste vara 1.

Minsta innehåll för en sådan konfigurationsfil:

[main]
enabled = 1

Se yum.conf(5) för mer information om plugin-relaterade konfigurationsalternativ.

FILER

/etc/yum.conf
/etc/yum/version-groups.conf
/etc/yum.repos.d/
/etc/yum/pluginconf.d/
/var/cache/yum/

SE ÄVEN

pkcon(1) yum.conf(5) yum-updatesd(8) package-cleanup(1) repoquery(1) yum-complete-transaction(1) yumdownloader(1) yum-utils(1) yum-security(8) (Projektwebbplats och FAQ omnämns i originaltexten.)

FÖRFATTARE

Se filen ”Authors” som medföljer programmet.

FEL (BUGS)

Det finns förstås inga fel — men om du hittar några bör du först läsa FAQ:en som nämns ovan och sedan mejla mailinglistan (yum@lists.baseurl.org) eller rapportera i bugzilla (enligt originaltextens anvisning).