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 baserat på “repository”-metadata. Den kan också installera nya paket, ta bort gamla paket och göra frågor mot installerade och/eller tillgängliga paket bland många andra kommandon/tjänster (se nedan). yum liknar andra högre nivåns pakethanterare som apt-get och smart.

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

kommando är ett av:

* 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 [filename]
* resolvedep dep1 [dep2] [...]
* localinstall rpmfile1 [rpmfile2] [...] (underhålls endast av kompatibilitetsskäl – använd install)
* localupdate rpmfile1 [rpmfile2] [...] (underhålls 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 [command]

Om inte alternativet --help eller -h ges måste ett av kommandona ovan anges.

Repository-konfigurationen respekteras i alla operationer.

KOMMANDON

install

Används för att installera senaste versionen av ett paket eller en paketgrupp och samtidigt säkerställa att alla beroenden uppfylls. (Se Ange paketnamn nedan.) Om inget paket matchar ett angivet paketnamn antas det vara ett shell-glob och alla träffar installeras. Om namnet börjar med tecknet @ används resten av namnet som om det skickats till kommandot groupinstall. Om namnet börjar med tecknet - görs en sökning inom transaktionen och alla träffar tas bort. Om namnet är en fil fungerar install som localinstall. Om namnet inte matchar ett paket söks även bland “provides” (t.ex. "_sqlitecache.so()(64bit)") samt filistor (t.ex. "/usr/bin/yum"). Observera att jokertecken i filistor kan matcha flera paket.

update

Om det körs utan paket uppdateras alla installerade paket. Om ett eller flera paket eller paketglobs anges uppdateras endast de angivna paketen. Vid uppdatering säkerställer yum att alla beroenden uppfylls. (Se Ange paketnamn nedan.) Om angivna paket/globs matchar paket som inte är installerade så installeras de inte. update fungerar på grupper, filer, provides och filistor på samma sätt som kommandot "install".

Om huvudinställningen obsoletes är true (standard) eller flaggan --obsoletes anges, inkluderar yum beräkning av obsoletes – detta gör det bättre vid t.ex. versionsbyten av distribution.

Observera att "update" fungerar på installerade paket först, och bara om inga träffar finns tittar det på tillgängliga paket. Skillnaden märks tydligt om du gör "update foo-1-2" och foo-1-2 är installerat: då fungerar det exakt som "update foo". Vill du hellre att inget ska hända i det fallet kan du använda "update-to".

update-to

Fungerar som "update" men anger alltid vilken version av paketet vi vill uppdatera till.

check-update

Implementerat så att du kan se om maskinen har uppdateringar som behöver appliceras utan att köra interaktivt. Returnerar exitvärde 100 om det finns paket tillgängliga för uppdatering. Returnerar också en lista över paketen i listformat. Returnerar 0 om inga uppdateringar finns. Returnerar 1 vid fel. Körning i verbose-läge visar även obsoletes.

upgrade

Samma som update-kommandot med flaggan --obsoletes satt. Se update för detaljer.

upgrade-to

Fungerar som "upgrade" men anger alltid vilken version av paketet vi vill uppdatera till.

distribution-synchronization eller distro-sync

Synkroniserar mängden installerade paket med senaste tillgängliga paket; detta görs genom att obsoletera, uppgradera eller nedgradera efter behov. Detta gör “normalt” samma sak som upgrade, men om du t.ex. har paketet FOO installerat i version 4 och senaste tillgängliga bara är version 3, så kommer detta kommando att nedgradera FOO till version 3.

Kommandot utför inte operationer på grupper, lokala paket eller negativa urval.

remove eller erase

Tar bort angivna paket från systemet och tar också bort paket som beror på paketet som tas bort. remove fungerar på grupper, filer, provides och filistor på samma sätt som kommandot "install". (Se Ange paketnamn nedan.)

Observera att "yum" ingår i protected_packages-konfigurationen som standard. Du kan alltså inte av misstag ta bort yum självt.

list

Listar olika information om tillgängliga paket; mer kompletta detaljer finns i avsnittet Listalternativ nedan.

provides eller whatprovides

Tar reda på vilket paket som tillhandahåller en viss funktion eller fil. Använd ett specifikt namn eller ett filglob/jokertecken för att lista de paket (tillgängliga eller installerade) som tillhandahåller funktionen eller filen.

search

Används för att hitta paket när du vet något om paketet men inte är säker på dess namn. Som standard söker search bara i paketnamn och sammanfattningar, men om det “misslyckas” söker det sedan i beskrivningar och URL.

Yum sorterar sökresultat så att de paket som matchar fler termer hamnar först.

Du kan tvinga sökning i allt genom att ange "all" som första argument.

info

Listar beskrivning och sammanfattande information om tillgängliga paket; tar samma argument som i avsnittet Listalternativ nedan.

clean

Rensar olika saker som ackumuleras i yums cachekatalog över tid. Mer kompletta detaljer finns i avsnittet Rensningsalternativ nedan.

makecache

Laddar ner och gör all metadata användbar för de för närvarande aktiverade yum-repona.

groupinstall

Installerar alla individuella paket i en grupp, av de angivna typerna (fungerar som om du tagit varje paketnamn och lagt dem på kommandoraden för "yum install"). Konfigurationsalternativet group_package_types anger vilka typer som installeras.

groupupdate

Alias för groupinstall; fungerar 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-repon. Grupper markeras som “installed” om alla obligatoriska paket är installerade, eller om gruppen inte har några obligatoriska paket så anses den installerad om något valfritt eller standardpaket är installerat. Det valfria argumentet "hidden" listar även grupper som inte är “user visible”. Med -v (verbose) visas groupids.

groupremove

Tar bort alla paket i en grupp. Till skillnad från groupinstall tas allt bort oavsett group_package_types. Det kan vara värt att påpeka att paket kan finnas i mer än en grupp, så "groupinstall X Y" följt av "groupremove Y" ger inte samma resultat som "groupinstall X".

Konfigurationen groupremove_leaf_only ändrar beteendet så att kommandot bara tar bort paket som inte behövs av något annat.

groupinfo

Visar beskrivningen och paketlistan för en grupp (och vilka typer paketen är markerade som). Du kan använda plugins yum-filter-data och yum-list-data för att få/använda informationen omvänt (t.ex. vilka grupper som “äger” paket som behöver uppdateras). Med -v matchas paketnamnen mot installerade/tillgängliga paket likt list-kommandot.

shell

Startar “yum shell”. Om ett filnamn anges exekveras filens innehåll i yum shell-läge. Se yum-shell(8) för mer information.

resolvedep

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

localinstall

Installerar en uppsättning lokala rpm-filer. Om det behövs används aktiverade repositories för att lösa beroenden. Observera att install-kommandot gör en lokal installation om det ges ett filnamn. Detta kommando underhålls endast av kompatibilitetsskäl.

localupdate

Uppdaterar systemet genom att ange lokala rpm-filer. Endast de rpm-filer där en äldre version redan är installerad installeras; övriga ignoreras. Om det behövs används aktiverade repositories för att lösa beroenden. Observera att update-kommandot gör en lokal uppdatering om det ges ett filnamn. Detta kommando underhålls endast av kompatibilitetsskäl.

reinstall

Installerar om den identiskt versionerade paketversionen som redan är installerad. Fungerar inte för “installonly”-paket (som kärnor). reinstall fungerar på grupper, filer, provides och filistor på samma sätt som kommandot "install".

downgrade

Försöker nedgradera ett paket från versionen som är installerad till den tidigare högsta versionen (eller den angivna versionen). Beroendelösaren fungerar inte nödvändigtvis, men om du anger alla paket bör det fungera (och därmed fungerar de enkla fallen). Fungerar inte för “installonly”-paket (som kärnor). downgrade fungerar på provides, filistor och rpm-filer på samma sätt som "install".

deplist

Skriver ut en lista över alla beroenden och vilka paket som tillhandahåller dem för angivna paket.

repolist

Listar konfigurerade repositories. Standard är att lista alla aktiverade repositories. Med -v visas mer information.

Om första argumentet är 'enabled', 'disabled' eller 'all' listas bara de typerna. Du kan också ange repo-id eller namnargument, eller jokertecken som matchar mot båda. Om id eller namn matchar exakt så listas repon även om du listar enabled repos och repon är inaktiverat.

I icke-verbose-läge börjar första kolumnen med '*' om repon har metalink-data och senaste metadata inte är lokalt. Sista kolumnen visar också antalet paket i repon och (om det finns användarutestängningar) antalet uteslutna paket.

En sista specialfunktion: i icke-verbose-läge ignorerar yum repo-fel och skriver ut den information den kan få (t.ex. "yum clean all; yum -C repolist" ger output även om paketantal m.m. kan bli noll).

version

Visar en “version” av rpmdb och av de aktiverade repositories om "all" ges som första argument. Du kan också ange versionsgrupper i version-groups-konfigfilen. Med -v visas mer information. Versionen beräknas genom att ta en SHA1-hash av paketen (i sorterad ordning) samt checksum_type/checksum_data-poster från yumdb. Observera att denna rpmdb-version nu används betydligt inom yum (särskilt i yum history).

Kommandot visar nu “grupper” av paket som en separat version och har underkommandon:

* "version grouplist" – listar definierade versionsgrupper

* "version groupinfo" – visar fullständig lista över paket inom en eller flera grupper

* "version installed" – standard; visar bara versionsinformation för installerade paket

* "version available" – visar bara versionsinformation för tillgängliga paket

* "version all" – visar versionsinformation för installerade och tillgängliga paket

* "version nogroups | nogroups-*" – visar bara huvudversionsinformationen

* "version group-*" – visar bara grupperad versionsinformation; om fler argument ges visas bara data för de grupperna

history

Ger möjlighet att se vad som hänt i tidigare transaktioner (förutsatt att history_record konfigalternativet är satt). 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å informationen och new för att starta en ny historikfil.

Kommandona info/list/summary tar antingen ett transaktions-id eller ett paket (med jokertecken, som i Ange paketnamn); alla tre kan även köras utan argument. list kan få 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 och en offset från senaste transaktionen (t.ex. om du gjort 250 transaktioner refererar "last" till transaktion 250 och "last-4" till transaktion 246).

undo/redo gör ogjort eller upprepar arbetet i den angivna transaktionen. rollback gör ogjort alla transaktioner upp till angiven transaktion. Exempel: om du har tre transaktioner där paketen A, B och C installerats i tur och ordning, så försöker "undo 1" ta bort A, "redo 1" försöker installera A igen (om det inte fortfarande är installerat) och "rollback 1" försöker ta bort B och C. Efter "rollback 1" får du en fjärde transaktion, även om den resulterande rpmdb-versionen (se yum version) bör vara densamma för transaktion 1 och 4.

addon-info tar ett transaktions-id. packages-list tar ett paket (med jokertecken).

stats visar statistik om nuvarande historikdatabas.

sync låter dig ändra rpmdb/yumdb-data som lagras för installerade paket så att det stämmer med nuvarande rpmdb/yumdb (mest användbart om data inte sparades när paketet lades in i historiken).

I "history list" kan du ändra beteendet för kolumn 2 via configalternativet history_list_view.

I "history list" ger kolumnen Altered extra information om något var fel med transaktionen (detta visas även i slutet av paketkolumnen i packages-list):

>  – rpmdb ändrades utanför yum efter transaktionen

< – rpmdb ändrades utanför yum före transaktionen * – transaktionen avbröts innan den blev klar # – transaktionen blev klar men med icke-noll status E – transaktionen blev klar men hade varnings-/felutskrift under transaktionen P – transaktionen blev klar men problem fanns redan i rpmdb s – transaktionen blev klar men --skip-broken var aktiverat och fick hoppa över vissa paket

load-transaction

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

check

Kontrollerar den lokala rpmdb och skriver ut information om problem som hittas. Du kan skicka argumenten "dependencies" eller "duplicates" för att begränsa vad som kontrolleras (standard är "all" som gör båda).

info-kommandot kan även ta intervall av transaktions-id, i formen start..end, och visar då en sammanslagen historik som om transaktionerna i intervallet skett som en enda transaktion. Exempel: "history info 1..4" slår ihop de första fyra transaktionerna.

help

Skriver ut hjälp, antingen för alla kommandon eller, om ett kommandonamn anges, hjälpen för just det kommandot.

ALLMÄNNA ALTERNATIV

De flesta kommandoradsalternativ kan också ställas in i konfigurationsfilen och beskrivningarna anger vilket konfigurationsalternativ som behövs.

-h, --help

Hjälp; visar ett hjälpmeddelande och avslutar.

-y, --assumeyes

Antar ja; antar att svaret på alla frågor som skulle ställas är ja.

Konfigurationsalternativ: assumeyes

-c, --config=[konfigfil]

Anger plats för konfigfilen – kan ta HTTP- och FTP-URL:er samt lokala filsökvägar.

-q, --quiet

Kör utan utskrift. Observera att du sannolikt även vill använda -y.

-v, --verbose

Kör med mycket felsökningsutskrift.

-d, --debuglevel=[tal]

Sätter debugnivån till [tal] – ökar/minskar mängden som skrivs ut. Praktiskt intervall: 0–10.

Konfigurationsalternativ: debuglevel

-e, --errorlevel=[tal]

Sätter fel-nivån till [tal]. Praktiskt intervall: 0–10. 0 betyder bara kritiska fel, 1 betyder alla fel även mindre viktiga. 1+ betyder fler fel (om några). -e 0 är bra för cron-jobb.

Konfigurationsalternativ: errorlevel

--rpmverbosity=[namn]

Sätter debugnivån till [namn] för rpm scriptlets. 'info' är standard; andra alternativ: 'critical', 'emergency', 'error', 'warn' och 'debug'.

Konfigurationsalternativ: rpmverbosity

-R, --randomwait=[tid i minuter]

Sätter max tiden yum väntar innan ett kommando utförs – den randomiserar inom tiden.

-C, --cacheonly

Kör helt från systemcache – laddar inte ner eller uppdaterar headers om det inte behövs för att utföra åtgärden. Om du använder detta som användare använder yum inte tempcache för användaren utan bara systemcachen i systemets cachedir.

--version

Rapporterar yums versionsnummer och installerade paketversioner för allt i history_record_packages (kan utökas av plugins).

--showduplicates

Begränsar inte paket till deras senaste versioner i info, list och search (påverkar även plugins som använder doPackageLists()-API:t).

--installroot=root

Anger en alternativ installroot, relativt vilken alla paket installeras.

Konfigurationsalternativ: installroot

--enablerepo=repoidglob

Aktiverar specifika repositories via id eller glob som har inaktiverats i konfigurationen med enabled=0.

Konfigurationsalternativ: enabled

--disablerepo=repoidglob

Inaktiverar specifika repositories via id eller glob.

Konfigurationsalternativ: enabled

--obsoletes

Har bara effekt för update; aktiverar yums logik för obsoletes. Se update ovan.

Konfigurationsalternativ: obsoletes

-x, --exclude=paket

Utesluter ett specifikt paket (namn eller glob) från uppdateringar i alla repositories.

Konfigurationsalternativ: exclude

--color=[always|auto|never]

Visar färgad output beroende på terminal (auto), alltid (ANSI-koder) eller aldrig. Observera att vissa kommandon (t.ex. list och info) gör lite extra arbete när färg är aktiverat.

Konfigurationsalternativ: color

--disableexcludes=[all|main|repoid]

Inaktiverar uteslutningar definierade i dina konfigfiler. Tar ett av tre värden:

* all == inaktiverar alla excludes

* main == inaktiverar excludes definierade i [main] i yum.conf

* repoid == inaktiverar excludes definierade för den repon

--disableplugin=plugin

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

--noplugins

Kör med alla plugins inaktiverade.

Konfigurationsalternativ: plugins

--nogpgcheck

Kör utan GPG-signaturkontroll.

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 den angivna strängen. Mycket användbart ihop med --installroot. Observera att med standard cachedir (/var/cache/yum) kan detta korrumpera cachen (du kan använda $releasever i cachedir-konfigurationen för att stoppa detta).

-t, --tolerant

Detta alternativ gör för närvarande ingenting.

--setopt=option=value

Sätter valfritt konfigalternativ i yum-konfig eller repo-filer. För globala alternativ: --setopt=option=value. För repo-alternativ: --setopt=repoid.option=value.

LISTALTERNATIV

Följande är sätten du kan anropa yum i list-läge. Notera att alla list-kommandon inkluderar information om paketets version.

UTSKRIFT

Formatet för utskriften av yum list är:

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

yum list [all | glob_exp1] [glob_exp2] [...]

Listar alla tillgängliga och installerade paket.

yum list available [glob_exp1] [...]

Listar alla paket i yum repositories som är tillgängliga att installera.

yum list updates [glob_exp1] [...]

Listar alla paket med uppdateringar tillgängliga i yum repositories.

yum list installed [glob_exp1] [...]

Listar paketen som anges av args. Om ett argument inte matchar namnet på ett tillgängligt paket antas det vara ett shell-glob och matchningar skrivs ut.

yum list extras [glob_exp1] [...]

Listar paket installerade på systemet som inte är tillgängliga i något yum repository listat i konfigfilen.

yum list obsoletes [glob_exp1] [...]

Listar paket installerade på systemet som obsoletas av paket i något yum repository listat i konfigfilen.

yum list recent

Listar paket som nyligen lagts till i repositories. Detta är ofta inte så hjälpsamt; vad du kanske egentligen vill är "yum list-updateinfo new" från security yum-pluginen.

ANGE PAKETNAMN

Ett paket kan refereras för install, update, remove, list, info etc med något av följande (samt globs/jokertecken av följande):

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

Detta tar bort just denna kernel-ver-rel.arch.

Eller:

yum list available 'foo*'

Detta listar alla tillgängliga paket som matchar 'foo*'. (Enkla citattecken hindrar din shell från att expandera globs.)

RENSNINGSALTERNATIV

Följande är sätten du kan anropa yum i clean-läge. Notera att “alla filer” i kommandona nedan betyder “alla filer i för närvarande aktiverade repositories”. Om du också vill rensa (tillfälligt) inaktiverade repositories behöver du använda alternativet --enablerepo='*'.

yum clean expire-cache

Tar bort lokala data om när metadata och mirrorlists laddades ner för varje repo. Detta gör att yum revaliderar cachen för varje repo nästa gång den används. Om cachen fortfarande är giltig raderas dock inget betydande.

yum clean packages

Tar bort alla cachade paket från systemet. Observera att paket inte automatiskt raderas efter nedladdning.

yum clean headers

Tar bort alla headerfiler som äldre yum-versioner använde för beroendelösning.

yum clean metadata

Tar bort alla filer som yum använder för att bestämma fjärrtillgänglighet för paket. Detta tvingar yum att ladda ner all metadata nästa gång.

yum clean dbcache

Tar bort sqlite-cachen som används för snabbare åtkomst till metadata. Detta tvingar yum att ladda ner sqlite-metadata nästa gång, eller återskapa sqlite-metadata om ett äldre repo används.

yum clean rpmdb

Tar bort cachad data från den lokala rpmdb.

yum clean plugins

Ber aktiverade plugins att ta bort sin cachade data.

yum clean all

Gör allt ovan.

PLUGINS

Yum kan utökas med plugins. En plugin är en Python-fil ".py" som installeras i någon av katalogerna som anges av alternativet pluginpath i yum.conf. För att en plugin ska fungera måste följande villkor uppfyllas:

1. Plugin-modulfilen måste vara installerad i plugin-sökvägen enligt ovan. 2. Det globala alternativet plugins i /etc/yum.conf måste vara satt till '1'. 3. En konfigfil för pluginen måste finnas i /etc/yum/pluginconf.d/<plugin_name>.conf och inställningen enabled i denna fil måste vara '1'. Minsta innehåll för en sådan konfigfil är:

[main]
enabled = 1

Se manualsidan 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)
http://yum.baseurl.org/
http://yum.baseurl.org/wiki/Faq
yum search yum

FÖRFATTARE

Se filen Authors som medföljer detta program.

BUGGAR

Det finns förstås inga buggar, 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.

REFERERAS AV

febootstrap(8), mock(1), pirut(8), pup(8), puplet(8), system-cdinstall-helper(8), system-install-packages(8), yum-updatesd(8), yumdownloader(1)