BOOTCTL(1) bootctl BOOTCTL(1) NAMN bootctl -- Styr den fasta EFI-programvarans startinstallningar och hantera startladdaren SYNOPSIS bootctl [FLAGGOR] {KOMMANDO} BESKRIVNING bootctl kan undersoka den fasta EFI-programvarans och startladdarens status, lista och hantera tillgangliga startladdare och poster i startladdaren, och installera, uppdatera eller ta bort startladdaren systemd-boot(7) pa det aktuella systemet. GENERISKA FAST EFI-PROGRAMVARAS/STARTLADDARES KOMMANDON Dessa kommandon ar tillgangliga pa alla EFI-system, oavsett vilken startladdare som anvands. status Visar en kort information om systemets fasta programvara, startladdaren som anvandes for att starta systemet, startladdarna som ar tillgangliga i ESP:n, startladdarna som listas i den fasta programvarans lista over startladdare och den startladdare som just nu ar standardpost. Om inget kommando anges ar detta det underforstadda standardvalet. Se exemplet nedan for detaljer om utdatan. Tillagd i verson 239. reboot-to-firmware [BOOL] Fraga om eller satt flaggan "Reboot-Into-Firmware-Setup" i den fasta EFI-programvaran. Tar ett booleskt argument som styr huruvida uppsattningen av fast programvara skall visas vid nasta omstart. Om argumentet utelamnas visas den aktuella statusen for flaggan, eller huruvida flaggan stodjs. Detta styr samma flagga som systemctl reboot --firmware-setup, men ar mer lagniva och tillater installning av flaggan utan att faktiskt begara en omstart. Tips: anvand systemctl reboot --firmware-setup for att starta om in i uppsattningen av fast programvara en gang. See systemctl(1) for detaljer. Tillagd i version 251. KOMMANDON FOR SPECIFIKATION AV STARTLADDAREN Dessa kommandon ar tillgangliga for alla startladdare som implementerar Startladdarspecifikationen[1], sasom systemd-boot. list Visar alla tillgangliga startladdarposter som implementerar Startladdarspecifikationen[1], liksom andra poster som upptackts av eller automatiskt genererats av en startladdare som implementerar Startladdargranssnittet[2]. JSON-utdata kan begaras med --json=. Se exemplet nedan for detaljer om utdatan. Tillagd i verson 239. unlink ID Tar bort en startladdarpost inklusive filerna den refererar till. Tar ID-strang eller ett glob-monster for en startladdarpost ID som argument. Refererade filer sasom karna eller initrd tas bort endast om ingen annan post refererar till dem. Tillagd i version 253. cleanup Tar bort filer fran ESP- och XBOOTLDR-partitionerna som tillhor postelementet men inte refereras i nagra startladdarposter. Tillagd i version 253. KOMMANDON FOR GRANSSNITTET TILL STARTLADDAREN Dessa kommandon ar tillgangliga for alla startladdare som implementerar Startladdarspecifikationen[1] och Startladdargranssnittet[2], sasom systemd-boot. set-default ID, set-oneshot ID Staller in standardstartladdarposten. Tar ett ensamt strang-ID for en startladdarpost eller ett glob-monster som argument. Kommandot set-oneshot kommer stalla in standardposten endast for nasta uppstart, set-default kommer satta den varaktigt for alla framtida uppstarter. bootctl list kan anvandas for att lista tillgangliga startladdarposter och deras ID:n. Utover det kan startladdarpostens ID anges som en av: @default, @oneshot eller @current, vilket motsvarar den nuvarande standardinstallningen av startladdarpost for alla framtida starter, den nuvarande standardinstallningen av startladdarpost for nasta start och den just nu startade startladdarposten. Dessa special-ID:n slas upp som de nuvarande varden av EFI-variablerna LoaderEntryDefault, LoaderEntryOneShot och LoaderEntrySelected, se Startladdarspecifikationen[1] for detaljer. Dessa special-ID:n ar primart anvandbara som ett snabbt satt att gora den nu startade startladdarposten till standardval, eller for att uppgradera standardvardet pa startladdarposten for nasta uppstart till standardvardet pa startladdarposten for alla framtida starter, men kan anvandas for andra atgarder ocksa. Om det satts till @saved kommer den valda posten att sparas som en EFI-variabel vid varje start och automatiskt valjas nasta gang startladdaren startas. Nar en tom strang ("") anges som ID:t, da kommer motsvarande EFI-variabel nollstallas. Tips: anvand systemctl reboot --boot-loader-entry=ID for att starta om till en viss startpost och systemctl reboot --boot-loader-menu=tidsgrans for att starta om till startladdarmenyn en gang. Se systemctl(1) for detaljer. Tillagd i version 240. set-timeout TIDSGRANS, set-timeout-oneshot TIDSGRANS Satter tidsgransen for startladdarmenyn i sekunder. Kommandot set-timeout-oneshot kommer satta tidsgransen endast for nasta start. Se systemd.time(7) for detaljer om syntaxen for tidsintervall. Om detta ar satt till menu-disabled eller menu-hidden eller 0 visas ingen meny och standardposten kommer startas direkt, medan att satta detta till menu-force avaktiverar tidsgransen och visar alltid menyn. Nar en tom strang ("") anges kommer startladdaren aterga till sitt standardvarde for menyns tidsgrans. Tillagd i version 250. SYSTEMD-BOOT-KOMMANDON Dessa kommandon hanterar EFI-startladdaren systemd-boot, och fungerar inte tillsammans med andra startladdare. install Installerar systemd-boot i EFI-systempartitionen. En exemplar av systemd-boot kommer att lagras som EFI standard-/reservladdare pa ESP/EFI/BOOT/BOOT*.EFI. Startladdaren laggs sedan till langst upp i den fasta programvarans lista over startladdare. Tillagd i verson 239. update Uppdaterar alla installerade versioner av systemd-boot(7), om den tillgangliga versionen ar nyare an versionen som ar installerad i EFI-systempartitionen. Detta inkluderar aven EFI standard-/reservladdaren pa ESP/EFI/BOOT/BOOT*.EFI. Startladdaren laggs sedan till pa slutet av den fasta programvarans lista over startladdare om den saknas. Tillagd i verson 239. remove Tar bort alla installerade versioner av systemd-boot fran EFI-systempartitionen och den fasta programvarans lista over startladdare. Tillagd i verson 239. is-installed Kontrollerar huruvida systemd-boot ar installerat i ESP:n. Observera att en enskild ESP kan vara vard for flera startladdare; detta kontrollerar alltsa huruvida systemd-boot ar en (av mojligen flera) installerade startladdare -- och inte vare sig huruvida det ar standardladdaren eller huruvida den ar registrerad i nagra EFI-variabler. Tillagd i version 243. random-seed Genererar ett slumptalsfro och lagrar det i EFI-systempartitionen (ESP), att anvandas av startladdaren systemd-boot. Om ett slumpfro redan finns i ESP:n uppdateras det. Genererar aven en slump-"systemsymbol" och lagrar den bestandigt som en EFI-variabel, om inte nagon har stallts in tidigare. Om startladdaren hittar slumpfroet i ESP:n och systemsymbolen i EFI-variabeln kommer den harleda ett slumpfro att skicka till OS:et och ett nytt fro att lagra i ESP:n fran kombinationen av bada. Slumpfroet som skickas till OS:et tillgodogors karnans entropipool av systemhanteraren under den tidiga uppstarten, och mojliggor for anvandarrymden att starta upp med en entropipool som ar fullt initierad mycket tidigt. Se aven systemd-boot-random-seed.service(8). Se Slumpfron[3] for ytterligare information. Tillagd i version 243. KARNAVBILDSKOMMANDON kernel-identify karna Tar en karnavbild som argument. Kontrollerar vilken sorts karna avbilden ar. Returnerar en av "uki", "addon", "pe" och "unknown". Tillagd i version 253. kernel-inspect karna Tar en karnavbild som argument. Skriver ut detaljer om avbilden. Tillagd i version 253. FLAGGOR Foljande flaggor ar kanda: --esp-path= Sokvag till EFI-systempartitionen (ESP). Om det inte anges kontrolleras i tur och ordning /efi/, /boot/ och /boot/efi/. Det rekommenderas att montera ESP:n som /efi/, om mojligt. --boot-path= Sokvag till den utokade startladdarpartitionen, sa som den definieras i Startladdarspecifikationen[1]. Om det inte anges kontrolleras /boot/. Det rekommenderas att montera den uokade startladdarpartitionen som /boot/ om mojligt. --root=rot Tar en katalogsokvag som argument. Alla sokvagar kommer foregas av den givna alternativa rotsokvagen, inklusive konfigurationssokvagar. Tillagd i version 252. --image=avbild Tar en sokvag till en diskavbildsfil eller blockenhetsnod. Om angivet gors alla atgarder pa filsystemet i den indikerade diskavbilden. Denna flagga liknar --root=, men arbetar pa ett filsystem lagrat i diskavbilder eller blockenheter. Diskavbilden skall antingen innehalla bara ett filsystem eller ett antal filsystem inom en GPT-partitionstabell, i enlighet med Specifikation av upptackbara partitioner[4]. For ytterligare information om diskavbilder som stodjs, se flaggan med samma namn till systemd-nspawn(1). Tillagd i version 252. --image-policy=policy Tar en avbildspolicystrang som argument, enligt systemd.image-policy(7). Policyn uppratthalls vid atgarder pa diskavbilden som anges via --image=, se ovan. Om det inte anges anvands standardpolicyn "*", d.v.s. alla kanda filsystem i diskavbilden anvands. --install-source= Vid installation av binarer med --root= eller --image=, valjer var kallan till dem kommer ifran. Tar en av "auto" (standard), "image" eller "host". Med "auto" kommer binarer plockas fran den angivna katalogen eller avbilden, och om de inte finns dar kommer de plockas fran varden. Med "image" eller "host" faller man inte tillbaka vid sokningen om binarerna inte finns i den valda kallan. Tillagd i version 252. -p, --print-esp-path Denna flagga andrar beteendet hos status. Skriver bara ut sokvagen till EFI-systempartitionen (ESP) till standard ut och avslutar. Tillagd i version 236. -x, --print-boot-path Denna flagga andrar beteendet hos status. Skriver bara ut sokvagen till den utokade startladdaren om den finns och sokvagen till ESP:n annars, till standard ut och avslutar. Detta kommando ar anvandbart for att avgora var startladdarposter skall placeras, eftersom de med fordel placeras i den utokade startladdarpartitionen om den finns och i ESP:n i annat fall. Startladdarspecifikationens poster av typ 1 skall generellt placeras i katalogen "$(bootctl -x)/loader/entries/". Forekomsten av den katalogen kan aven anvandas som en indikation att stod for startladdarposter ar tillgangligt pa systemet. Pa motsvarande satt skall po, startladdarspecifikationens poster av typ 2 placeras i katalogen "$(bootctl -x)/EFI/Linux/". Observera att denna flagga (i likhet med flaggan --print-esp-path omnamnd ovan) ar tillganglig oavsett vilken startladdare som anvands, d.v.s. aven utan att systemd-boot ar installerat. Tillagd i version 242. --print-loader-path Denna flagga andrar beteendet hos status; det visar den absoluta sokvagen till startladdar-EFI-binaren som anvants for den aktuella uppstarten om denna information finns tillganglig. Observera att inget forsok gors for att verifiera huruvida binaren fortfarande finns. Tillagd i version 257. --print-stub-path Denna flagga andrar beteendet hos status: det visar den absoluta sokvagen till UKI-/stubb-EFI-binaren som anvants for den aktuella uppstarten om denna information finns tillganglig. Observera att inget forsok gors for att verifiera huruvida binaren fortfarande finns. Tillagd i version 257. -R, --print-root-device Skriv ut sokvagen till blockenhetsnoden som hyser rotfilsystemet for det lokala OS:et. Detta skriver ut en sokvag sasom /dev/nvme0n1p5. Om rotfilsystemet hanteras av dm-crypt/LUKS eller dm-verity returneras den underliggande blockenheten. Om rotfilsystemet hanteras av flera blockenheter (som btrfs stodjer) kommer atgarden misslyckas. Om flaggan anges tva ganger (d.v.s. -RR) och den funna blockenheten ar en partitionsenhet bestams och skrivs "hela" blockenheten den tillhor ut (t.ex. /dev/nvme0n1). Om rotfilsystemt ar "tmpfs" (eller ett liknande minnesfilsystem) returneras blockenheten som hanterar /usr/ om tillampligt. Om rotfilsystemet ar ett natverksfilsystem (t.ex. NFS, CIFS) kommer atgarden misslyckas. Tillagd i version 254. --no-variables Ror inte den fasta programvarans lista over startladdare som ar lagrad i EFI-variabler. Tillagd i version 220. --random-seed=yes|no Som standard initierar kommandot install en fil med ett slumptalsfro i ESP:n. Nar en avbild skapas kan det vara onskvart att avaktivera det for att undvika att ha samma fro i alla instanser. Tillagd i version 257. --graceful Ignorera misslyckandet nar EFI-systempartitionen inte finns, nar EFI-variabler inte kan skrivas eller en annan eller nyare startladdare redan ar installerad. For narvarande ar det bara tillampligt pa verben is-installed, update och random-seed. Tillagd i version 244. -q, --quiet Undertryck utskrift av resultaten fran olika kommandon och aven tipsen om att ESP:n inte ar tillganglig. Tillagd i version 251. --make-entry-directory=yes|no Styr skapandet och raderandet av katalogen med poster Startladdarspecifikationen[1] type 1 pa filsystemet som innehaller resurser sasom karnan och initrd-avbilder under install respektive remove. Katalogen namnges efter postens symbol, sa som den specificeras parametern --entry-token= som beskrivs nedan, och placeras omedelbart nedanfor rotkatalogen i $BOOT (d.v.s. nedanfor filsystemet som returneras av flaggan --print-boot-path, se ovan). Standardvardet ar "no". Tillagd i version 251. --entry-token= Styr hur startladdarposter for denna OS-installation namnges och identifieras. Accepteras under install, och tar en av vardena "auto", "machine-id", "os-id", "os-image-id" eller en godtycklig strang som foregas av "literal:" som argument. Om satt till machine-id namnges posterna efter maskin-ID for det korande systemet (t.ex. "b0e793a9baf14b5fa13ecbe84ff637ac"). Se machine-id(5) for detaljer om begreppet och filen maskin-ID. Om satt till os-id namnges posterna efter OS ID for det korande systemet, d.v.s. faltet ID= i os-release(5) (t.ex. "fedora"). Pa liknande satt, om satt till os-image-id namnges posterna efter OS:ets avbilds-ID for det korande systemet, d.v.s. faltet IMAGE_ID= i os-release (t.ex. "vendorx-cashier-system"). Om satt till auto (standard), lases filen /etc/kernel/entry-token om den finns, och det lagrade vardet. Annars, om den lokala maskinens ID ar initierat anvands det. Annars kommer IMAGE_ID= fran os-release anvandas, om det ar satt. Annars kommer ID= fran os-release anvandas, om det ar satt. Om inte satt till "machine-id", eller nar --make-entry-directory=yes anvands skrivs den valda symbolstrangen till en fil /etc/kernel/entry-token, for att sakerstalla att den kommer anvandas till framtida poster. Denna fil lases aven av kernel-install(8), for att identifiera under vilket namn poster for startladdare skall genereras for nyinstallerade karnor, eller for att bestamma postnamnen for att ta bort gamla. Att anvanda maskin-ID for att namnge posterna ar i allmanhet att foredra, dock finns det fall dar att anvanda identifierare ar ett bra alternativ. Specifikt: om identifikationsdatan som maskin-ID innebar inte far lagras pa (den okrypterade) partitionen $BOOT, eller om ID:t skall genereras vid forsta start och inte ar kant nar posterna forbereds. Observera att anvanda maskin-ID har fordelen att flera parallella installationer av samma OS kan samexistera pa samma medium, och de kan uppdatera sina startladdarposter oberoende av varandra. Nar en annan identifierare (sasom OS-ID:t eller OS-avbildens ID), skulle parallella installationer av samma OS forsoka anvanda samma postnamn. For att stodja parallella installationer maste installeraren anvanda en annan postsymbol nar en andra installation laggs till. Tillagd i version 251. --all-architectures Installera binarer for alla stodda EFI-arkitekturer (detta implicerar --no-variables). Tillagd i version 252. --efi-boot-option-description= Beskrivning av posten som lades till i den fasta programvarans startalternativlista. Som standard "Linux Boot Manager". Att anvanda standardpostnamnet "Linux Boot Manager" ar i allmanhet att foredra eftersom endast en startladdare installerad pa en enda ESP-partition skall anvandas for att starta godtyckligt antal OS-installationer som finns pa de olika diskarna som ar installerade i systemet. Specifikt skall distributioner inte anvanda denna flagga for att installera varumarkesposter i startalternativlistan. Dock kan det i situationer med flera diskar, var och en med sin egen ESP-partition, vara fordelaktigt att gora det enklare att identifiera startladdaren som anvands i den fasta programvarans startalternativmeny. Tillagd i version 252. --dry-run Kor torrsim av unlink och cleanup. I torrsimslage skriver atgarderna unlink och cleanup endast ut filerna som skulle ha raderats utan att faktiskt radera dem. Tillagd i version 253. --secure-boot-auto-enroll=yes|no, --private-key=SOKVAG/URI, --private-key-source=TYP[:NAMN], --certificate=SOKVAG, --certificate-source=TYP[:NAMN] Konfigurera ESP:n for automatregistrering for saker start nar kommandot install anropas. Tar ett booleskt argument. Avaktiverat som standard. Aktivering av denna flagga kommer gora att bootctl utrustar ESP:n med signerade "PK"-, "KEK"- och "db"-signaturdatabaser, var och en innehallande det angivna certifikatet i "DER"-format som deras enda post. Dessa signaturdatabaser for saker start kommer plockas fram och utrustas av systemd-boot om saker uppstart ar i installningslage och automatregistrering av saker start ar aktiverat. Nar man anger denna flagga maste ett certifikat och en privat nyckel ocksa ges med flaggorna --certificate= och --private-key=. Flaggan --certificate= tar en sokvag till ett PEM-kodat X.509-certifikat eller en URI som skickas vidare till OpenSSL-leverantor som ar konfigurerad med --certificate-source vilken tar en av "file" eller "provider", dar den senare foljs av en specifik leverantorsidentifierare, separerad med ett kolon, t.ex. "provider:pkcs11". Flaggan --private-key= kan ta en sokvag eller en URI som kommer skickas till OpenSSL-motorn eller -leverantoren, sasom angivits med --private-key-source= som en tupel "type:name", sasom "engine:pkcs11". Den angivna OpenSSL-signeringsmotorn eller -leverantoren kommer anvandas for att signera EFI-signaturlistorna. Tillagd i version 257. --no-pager Skicka inte utdata i ett ror till en bladdrare. --json=LAGE Visar utdata formaterad som JSON. Forvantar sig en av "short" (for den kortaste mojliga utdatan utan nagra reduntanta mellanslag eller nyrader), "pretty" (for en snygg version av detsamma, med indentering och nyrader) eller "off" (for att sla av JSON-utdata, standardvardet). -h, --help Skriv en kort hjalptext och avsluta. --version Skriv en kort versionsstrang och avsluta . SIGNERADE .EFI-FILER bootctl install och update kommer titta efter en systemd-boot-fil som slutar med suffixet ".efi.signed" forst, och kopiera den istallet for den normala ".efi"-filen. Detta gor att distributioner eller slutanvandare kan tillhandahalla signerade avbilder for UEFI SecureBoot. SLUTSTATUS Vid lyckat resultat returneras 0, en nollskild felkod annars. bootctl --print-root-device returnerar slutstatusen 80 ifall rotfilsystemet inte hanteras av en enda blockenhet, och andra nollskilda slutstatusar vid andra fel. MILJO Om $SYSTEMD_RELAX_ESP_CHECKS=1 ar satt lattas valideringskontrollerna for ESP:n, och sokvagen som anges med --esp-path= far referera till ett filsystem av godtycklig sort pa en partition av godtycklig sort. Pa liknande satt slar $SYSTEMD_RELAX_XBOOTLDR_CHECKS=1 av nagra valideringskontroller for den utokade startladdarpartitionen. EXEMPEL Exempel 1. Utdata fran status och list $ bootctl status System: Firmware: UEFI 2.40 (programversion) <- leverantor och version av fast programvara Secure Boot: disabled (setup) <- status for saker uppstart TPM2 Support: yes Boot into FW: supported <- stodjer den fasta programvaran att starta till sig sjalv Current Boot Loader: <- detaljer om sd-boot eller en annan startladdare Product: systemd-boot version implementerar Startladdargranssnittet[2] Features: \/ Boot counting \/ Menu timeout control \/ One-shot menu timeout control \/ Default entry control \/ One-shot entry control \/ Support for XBOOTLDR partition \/ Support for passing random seed to OS \/ Load drop-in drivers \/ Boot loader sets ESP information \/ Menu can be disabled ESP: /dev/disk/by-partuuid/01234567-89ab-cdef-dead-beef00000000 File: /EFI/systemd/systemd-bootx64.efi Random Seed: <- slumpfro anvant for entropi i tidig start Passed to OS: yes System Token: set Exists: yes Available Boot Loaders on ESP: ESP: /boot/efi (/dev/disk/by-partuuid/01234567-89ab-cdef-dead-beef00000000) File: /EFI/systemd/systemd-bootx64.efi (systemd-boot 251 File: /EFI/BOOT/BOOTX64.EFI (systemd-boot 251 Boot Loaders Listed in EFI Variables: Title: Linux Boot Manager ID: 0x0001 Status: active, boot-order Partition: /dev/disk/by-partuuid/ File: /EFI/systemd/systemd-bootx64.efi Title: Fedora ID: 0x0000 Status: active, boot-order Partition: /dev/disk/by-partuuid/ File: /EFI/fedora/shimx64.efi Title: Linux-Firmware-Updater ID: 0x0002 Status: active, boot-order Partition: /dev/disk/by-partuuid/ File: /EFI/fedora/fwupdx64.efi Boot Loader Entries: $BOOT: /boot/efi (/dev/disk/by-partuuid/01234567-89ab-cdef-dead-beef00000000) Default Boot Loader Entry: type: Boot Loader Specification Type #1 (.conf) title: Fedora Linux 36 (Workstation Edition) id: source: /boot/efi/loader/entries/startsymbol-karnversion.conf version: karnversion machine-id: linux: /startsymbol/karnversion/linux initrd: /startsymbol/karnversion/initrd options: root= $ bootctl list Boot Loader Entries: type: Boot Loader Specification Type #1 (.conf) title: Fedora Linux 36 (Workstation Edition) (default) (selected) id: source: /boot/efi/loader/entries/startsymbol-karnversion.conf version: karnversion machine-id: linux: /startsymbol/karnversion/linux initrd: /startsymbol/karnversion/initrd options: root= type: Boot Loader Specification Type #2 (.efi) title: Fedora Linux 35 (Workstation Edition) id: source: /boot/efi/EFI/Linux/fedora-karnversion.efi version: karnversion machine-id: linux: /EFI/Linux/fedora-karnversion.efi options: root= type: Automatic title: Reboot Into Firmware Interface id: auto-reboot-to-firmware-setup source: /sys/firmware/efi/efivars/LoaderEntries-4a67b082-0a4c-41cf-b6c7-440b29bb8c4f I listningen anger "(default)" posten som kommer anvandas som standard, och "(selected)" anger posten som valdes senaste gangen (d.v.s. den kor just nu). SE AVEN systemd-boot(7), Startladdarspecifikation[1], Startladdargranssnitt[2], systemd-boot-random-seed.service(8) NOTERINGAR 1. Startladdarspecifikation https://uapi-group.org/specifications/specs/boot_loader_specification 2. Startladdargranssnitt https://systemd.io/BOOT_LOADER_INTERFACE 3. Slumpfron https://systemd.io/RANDOM_SEEDS 4. Specifikation av upptackbara partitioner https://uapi-group.org/specifications/specs/discoverable_partitions_specification OVERSATTNING Den svenska oversattningen av denna manualsida skapades av Goran Uddeborg Denna oversattning ar fri dokumentation; las GNU General Public License Version 3 eller senare for upphovsrattsvillkor. Vi tar INGET ANSVAR. Om du hittar fel i oversattningen av denna manualsida, skicka ett mail till . systemd 257.3 BOOTCTL(1)