bootctl(1): Skillnad mellan sidversioner
Admin (diskussion | bidrag) (Skapade sidan med '= Sidslut = Orginalhemsidan på Engelska https://man7.org/linux/man-pages/man1/bootctl.1.html Det här är en maskinöversättning av Linux man sidor till svenska. Om du hittar fel är vi tacksamma om du rapporterar dem via formuläret som finns på https://www.linux.se/kontaka-linux-se/ <BR><BR>Tack till [https://Pc-service.se PC Service] som har sponsrat [https://www.linux.se Linux.se] med webbhotell. Kategori:Linuxmanual grupp 1 Kategori:Linuxmanual') |
Admin (diskussion | bidrag) Ingen redigeringssammanfattning |
||
| Rad 1: | Rad 1: | ||
= bootctl(1) = | |||
== NAMN == | |||
'''bootctl''' — styr EFI-firmwareinställningar för uppstart och hanterar boot loader | |||
== SYNOPSIS == | |||
<pre> | |||
bootctl [FLAGGOR...] {KOMMANDO} | |||
</pre> | |||
== BESKRIVNING == | |||
'''bootctl''' kan kontrollera status för EFI-firmware och boot loader, | |||
lista och hantera tillgängliga boot loaders och boot loader-poster, | |||
samt installera, uppdatera eller ta bort boot loadern | |||
[[systemd-boot(7)]] på det aktuella systemet. | |||
== GENERELLA EFI-FIRMWARE-/BOOT LOADER-KOMMANDON == | |||
Dessa kommandon är tillgängliga på alla EFI-system, oavsett vilken | |||
boot loader som används. | |||
; '''status''' | |||
: Visar kortfattad information om systemets firmware, boot loadern som | |||
användes för att starta systemet, de boot loaders som för närvarande | |||
finns tillgängliga i ESP, de boot loaders som finns listade i | |||
firmwarens lista över boot loaders samt aktuell standardpost för boot | |||
loadern. Om inget kommando anges är detta det underförstådda | |||
standardkommandot. | |||
: | |||
: Se exemplet nedan för detaljer om utdata. | |||
: | |||
: Tillagt i version 239. | |||
; '''reboot-to-firmware''' [''BOOL''] | |||
: Fråga efter eller sätt EFI-firmwarens flagga | |||
”Reboot-Into-Firmware-Setup”. Tar ett booleskt argument som styr om | |||
firmwareinställningarna ska visas vid nästa omstart av systemet. Om | |||
argumentet utelämnas visas flaggans aktuella status, eller om flaggan | |||
stöds. Detta styr samma flagga som | |||
'''systemctl reboot --firmware-setup''', men är mer lågnivåmässigt och | |||
gör det möjligt att sätta flaggan oberoende av att faktiskt begära en | |||
omstart. | |||
: | |||
: Tips: använd '''systemctl reboot --firmware-setup''' för att starta om | |||
till firmwareinställningarna en gång. Se [[systemctl(1)]] för detaljer. | |||
: | |||
: Tillagt i version 251. | |||
== KOMMANDON ENLIGT BOOT LOADER SPECIFICATION == | |||
Dessa kommandon är tillgängliga för alla boot loaders som implementerar | |||
'''UAPI.1 Boot Loader Specification'''[1], såsom '''systemd-boot'''. | |||
; '''list''' | |||
: Visar alla tillgängliga boot loader-poster som implementerar | |||
'''UAPI.1 Boot Loader Specification'''[1], samt alla andra poster som | |||
upptäckts eller genererats automatiskt av en boot loader som | |||
implementerar '''Boot Loader Interface'''[2]. JSON-utdata kan begäras | |||
med '''--json='''. | |||
: | |||
: Se exemplet nedan för detaljer om utdata. | |||
: | |||
: Tillagt i version 239. | |||
; '''unlink''' ''ID'' | |||
: Tar bort en boot loader-post inklusive de filer den hänvisar till. | |||
Tar en enda ID-sträng för en boot loader-post eller ett globmönster | |||
som argument. Refererade filer såsom kernel eller initrd tas endast | |||
bort om ingen annan post hänvisar till dem. | |||
: | |||
: Tillagt i version 253. | |||
; '''cleanup''' | |||
: Tar bort filer från ESP- och XBOOTLDR-partitionerna som tillhör | |||
post-token men som inte refereras av några boot loader-poster. | |||
: | |||
: Tillagt i version 253. | |||
== KOMMANDON ENLIGT BOOT LOADER INTERFACE == | |||
Dessa kommandon är tillgängliga för alla boot loaders som implementerar | |||
'''UAPI.1 Boot Loader Specification'''[1] och | |||
'''Boot Loader Interface'''[2], såsom '''systemd-boot'''. | |||
; '''set-default''' ''ID'', '''set-oneshot''' ''ID'', '''set-sysfail''' ''ID'' | |||
: Sätter standardpost för boot loadern. Tar en enda ID-sträng för en | |||
boot loader-post eller ett globmönster som argument. | |||
Kommandot '''set-oneshot''' sätter standardposten endast för nästa | |||
uppstart, medan '''set-default''' sätter den permanent för alla | |||
framtida uppstarter. Kommandot '''set-sysfail''' sätter den boot | |||
loader-post som ska användas vid systemfel. SysFail-poster kan | |||
valfritt ändra den automatiska urvalsordningen vid fel, till exempel | |||
om en firmwareuppdatering för uppstart misslyckas och felstatusen | |||
registreras i EFI-systemtabellen. | |||
: | |||
: '''bootctl list''' kan användas för att lista tillgängliga | |||
boot loader-poster och deras ID:n. | |||
: | |||
: Dessutom kan boot loader-postens ID anges som något av: | |||
'''@default''', '''@oneshot''' eller '''@current''', vilka motsvarar | |||
aktuell standardpost för alla framtida uppstarter, aktuell | |||
standardpost för nästa uppstart och den för närvarande startade | |||
boot loader-posten. Dessa special-ID:n slås upp till aktuella värden | |||
i EFI-variablerna ''LoaderEntryDefault'', ''LoaderEntrySysFail'', | |||
''LoaderEntryOneShot'' och ''LoaderEntrySelected'', se | |||
'''UAPI.1 Boot Loader Specification'''[1] för detaljer. Dessa | |||
special-ID:n är främst användbara som ett snabbt sätt att permanent | |||
göra den för närvarande startade boot loader-posten till | |||
standardvalet, eller att uppgradera standardposten för nästa uppstart | |||
till standardposten för alla framtida uppstarter, men kan även | |||
användas för andra operationer. | |||
: | |||
: Om satt till '''@saved''' kommer den valda posten att sparas som en | |||
EFI-variabel vid varje uppstart och automatiskt väljas nästa gång | |||
boot loadern startar. | |||
: | |||
: När en tom sträng ("") anges som ID avsätts motsvarande EFI-variabel. | |||
: | |||
: Tips: använd '''systemctl reboot --boot-loader-entry=''''ID''' för att | |||
starta om till en specifik boot-post och | |||
'''systemctl reboot --boot-loader-menu=''''timeout''' för att starta om | |||
till boot loader-menyn en gång. Se [[systemctl(1)]] för detaljer. | |||
: | |||
: Tillagt i version 240. | |||
; '''set-timeout''' ''TIMEOUT'', '''set-timeout-oneshot''' ''TIMEOUT'' | |||
: Sätter timeout för boot loader-menyn i sekunder. | |||
Kommandot '''set-timeout-oneshot''' sätter timeouten endast för nästa | |||
uppstart. Se [[systemd.time(7)]] för detaljer om syntaxen för | |||
tidsintervall. | |||
: | |||
: Om detta sätts till '''menu-disabled''' eller '''menu-hidden''' eller | |||
'''0''', visas ingen meny och standardposten startas omedelbart, medan | |||
värdet '''menu-force''' inaktiverar timeouten samtidigt som menyn alltid | |||
visas. När en tom sträng ("") anges återgår boot loadern till sin | |||
standard-timeout för menyn. | |||
: | |||
: Tillagt i version 250. | |||
== SYSTEMD-BOOT-KOMMANDON == | |||
Dessa kommandon hanterar EFI-boot loadern '''systemd-boot''', och fungerar | |||
inte tillsammans med andra boot loaders. | |||
; '''install''' | |||
: Installerar '''systemd-boot''' i EFI-systempartitionen. En kopia av | |||
'''systemd-boot''' lagras som EFI:s standard-/fallback-loader på | |||
''ESP''/EFI/BOOT/BOOT*.EFI. Boot loadern läggs därefter till högst upp | |||
i firmwarens lista över boot loaders. | |||
: | |||
: Tillagt i version 239. | |||
; '''update''' | |||
: Uppdaterar alla installerade versioner av [[systemd-boot(7)]], om den | |||
tillgängliga versionen är nyare än den version som är installerad i | |||
EFI-systempartitionen. Detta inkluderar även EFI:s standard-/ | |||
fallback-loader på ''ESP''/EFI/BOOT/BOOT*.EFI. Boot loadern läggs | |||
därefter till sist i firmwarens lista över boot loaders om den saknas. | |||
: | |||
: Tillagt i version 239. | |||
; '''remove''' | |||
: Tar bort alla installerade versioner av '''systemd-boot''' från | |||
EFI-systempartitionen och firmwarens lista över boot loaders. | |||
: | |||
: Tillagt i version 239. | |||
; '''is-installed''' | |||
: Kontrollerar om '''systemd-boot''' är installerad i ESP. Observera att | |||
en enda ESP kan innehålla flera boot loaders; detta kontrollerar alltså | |||
om '''systemd-boot''' är en (av möjligen flera) installerade boot loaders | |||
— inte om den är standard eller om den är registrerad i några | |||
EFI-variabler. | |||
: | |||
: Tillagt i version 243. | |||
; '''random-seed''' | |||
: Genererar ett slumpfrö och lagrar det i EFI System Partition (ESP), | |||
för användning av boot loadern '''systemd-boot'''. Om ett slumpfrö redan | |||
finns i ESP uppdateras det. Genererar också ett slumpmässigt | |||
”system token” och lagrar det permanent som en EFI-variabel, om ett | |||
sådant inte har satts tidigare. Om boot loadern hittar slumpfröet i | |||
ESP och system-token i EFI-variabeln, härleds ett slumpfrö att skicka | |||
till OS:et och ett nytt frö att lagra i ESP från kombinationen av | |||
båda. Slumpfröet som skickas till OS:et tillgodoräknas kernelns | |||
entropipool av systemhanteraren under tidig uppstart, och gör det | |||
möjligt för userspace att starta med en fullt initierad entropipool | |||
mycket tidigt. Se även [[systemd-boot-random-seed.service(8)]]. | |||
: | |||
: Se '''Random Seeds'''[3] för ytterligare information. | |||
: | |||
: Tillagt i version 243. | |||
== KERNELAVBILDSKOMMANDON == | |||
; '''kernel-identify''' ''KERNEL-IMAGE'' | |||
: Tar en kernelavbild som argument. Kontrollerar vilken typ av kernel | |||
avbilden är. Returnerar något av "uki", "addon", "pe" eller "unknown". | |||
: | |||
: Tillagt i version 253. | |||
; '''kernel-inspect''' ''KERNEL-IMAGE'' | |||
: Tar en kernelavbild som argument. Skriver ut detaljer om avbilden. | |||
: | |||
: Tillagt i version 253. | |||
== FLAGGOR == | |||
Följande flaggor förstås: | |||
; '''--esp-path=''' | |||
: Sökväg till EFI System Partition (ESP). Om den inte anges kontrolleras | |||
/efi/, /boot/ och /boot/efi/ i tur och ordning. Det rekommenderas att | |||
montera ESP på /efi/, om möjligt. | |||
; '''--boot-path=''' | |||
: Sökväg till den utökade Boot Loader-partitionen, enligt definitionen i | |||
'''UAPI.1 Boot Loader Specification'''[1]. Om den inte anges kontrolleras | |||
/boot/. Det rekommenderas att montera den utökade Boot Loader- | |||
partitionen på /boot/, om möjligt. | |||
; '''--root=''''root'' | |||
: Tar en katalogsökväg som argument. Alla sökvägar får det angivna | |||
alternativa ''root''-prefixet, inklusive sökvägar för konfiguration. | |||
: | |||
: Tillagt i version 252. | |||
; '''--image=''''image'' | |||
: Tar en sökväg till en diskavbildsfil eller blockenhetsnod. Om den | |||
anges tillämpas alla operationer på filsystemet i den angivna | |||
diskavbilden. Denna flagga liknar '''--root=''', men arbetar på | |||
filsystem lagrade i diskavbilder eller blockenheter. Diskavbilden ska | |||
antingen innehålla bara ett filsystem eller en uppsättning filsystem i | |||
en GPT-partitionstabell, i enlighet med | |||
'''UAPI.2 Discoverable Partitions Specification'''[4]. För mer | |||
information om stödda diskavbilder, se [[systemd-nspawn(1)]] och | |||
växeln med samma namn. | |||
: | |||
: Tillagt i version 252. | |||
; '''--image-policy=''''policy'' | |||
: Tar en policysträng för avbild som argument, enligt | |||
[[systemd.image-policy(7)]]. Policyn tillämpas när man arbetar på den | |||
diskavbild som anges med '''--image=''', se ovan. Om den inte anges | |||
används som standard policyn "*", dvs. alla igenkända filsystem i | |||
avbilden används. | |||
; '''--install-source=''' | |||
: När binärfiler installeras med '''--root=''' eller '''--image=''' väljer | |||
detta varifrån de ska hämtas. Tar ett av "auto" (standard), "image" | |||
eller "host". Med "auto" hämtas binärfiler från den angivna katalogen | |||
eller avbilden, och om de inte hittas där hämtas de från värdsystemet. | |||
Med "image" eller "host" görs ingen reservsökning om binärfilerna inte | |||
hittas i den valda källan. | |||
: | |||
: Tillagt i version 252. | |||
; '''-p''', '''--print-esp-path''' | |||
: Denna flagga ändrar beteendet för '''status'''. Skriver endast ut | |||
sökvägen till EFI System Partition (ESP) till standardutmatning och | |||
avslutar. | |||
: | |||
: Tillagt i version 236. | |||
; '''-x''', '''--print-boot-path''' | |||
: Denna flagga ändrar beteendet för '''status'''. Skriver endast ut | |||
sökvägen till den utökade Boot Loader-partitionen om den finns, annars | |||
sökvägen till ESP, till standardutmatning och avslutar. Detta kommando | |||
är användbart för att avgöra var boot loader-poster bör placeras, då | |||
de helst placeras i den utökade Boot Loader-partitionen om den finns, | |||
och annars i ESP. | |||
: | |||
: Boot Loader Specification Type #1-poster bör generellt placeras i | |||
katalogen "$(bootctl -x)/loader/entries/". Förekomsten av den katalogen | |||
kan också användas som en indikation på att stöd för boot loader- | |||
poster finns i systemet. På motsvarande sätt bör Boot Loader | |||
Specification Type #2-poster placeras i katalogen | |||
"$(bootctl -x)/EFI/Linux/". | |||
: | |||
: Observera att denna flagga (på samma sätt som flaggan | |||
'''--print-esp-path''' ovan) är tillgänglig oberoende av vilken | |||
boot loader som används, dvs. även utan att '''systemd-boot''' är | |||
installerad. | |||
: | |||
: Tillagt i version 242. | |||
; '''--print-loader-path''' | |||
: Denna flagga ändrar beteendet för '''status''': den visar den absoluta | |||
sökvägen till den boot loader-EFI-binär som användes för den aktuella | |||
uppstarten om denna information är tillgänglig. Observera att inget | |||
försök görs att verifiera om binären fortfarande finns. | |||
: | |||
: Tillagt i version 257. | |||
; '''--print-stub-path''' | |||
: Denna flagga ändrar beteendet för '''status''': den visar den absoluta | |||
sökvägen till den UKI-/stub-EFI-binär som användes för den aktuella | |||
uppstarten om denna information är tillgänglig. Observera att inget | |||
försök görs att verifiera om binären fortfarande finns. | |||
: | |||
: Tillagt i version 257. | |||
; '''-R''', '''--print-root-device''' | |||
: Skriver ut sökvägen till den blockenhetsnod som ligger under rot- | |||
filsystemet för det lokala OS:et. Detta skriver ut en sökväg som | |||
/dev/nvme0n1p5. Om rotfilsystemet är uppbackat av dm-crypt/LUKS eller | |||
dm-verity returneras den underliggande blockenheten. Om rotfilsystemet | |||
stöds av flera blockenheter (som btrfs tillåter) misslyckas | |||
operationen. Om växeln anges två gånger (dvs. '''-RR''') och den | |||
upptäckta blockenheten är en partitionsenhet, bestäms och skrivs den | |||
”hela” blockenheten den tillhör ut (t.ex. /dev/nvme0n1). Om | |||
rotfilsystemet är "tmpfs" (eller liknande minnesbaserat filsystem), | |||
returneras blockenheten bakom /usr/ om tillämpligt. Om rotfilsystemet | |||
är ett nätverksfilsystem (t.ex. NFS, CIFS) misslyckas operationen. | |||
: | |||
: Tillagt i version 254. | |||
; '''--variables=yes|no''' | |||
: Styr om firmwarens lista över boot loaders som lagras i EFI-variabler, | |||
och andra EFI-variabler, ska beröras. Om den inte anges används | |||
standardvärdet no när körning i container upptäcks, annars yes. | |||
: | |||
: Tillagt i version 258. | |||
; '''--random-seed=yes|no''' | |||
: Som standard initierar kommandot '''install''' en slumpfröfil i ESP. | |||
När en avbild skapas kan det vara önskvärt att inaktivera detta för | |||
att undvika att samma frö finns i alla instanser. | |||
: | |||
: Tillagt i version 257. | |||
; '''--graceful''' | |||
: Ignorera fel när EFI System Partition inte kan hittas, när EFI- | |||
variabler inte kan skrivas, eller när en annan eller nyare boot loader | |||
redan är installerad. Gäller för närvarande endast verben | |||
'''is-installed''', '''update''', '''random-seed''' och '''install'''. | |||
Sedan version v258 aktiveras detta implicit när det körs i en chroot. | |||
: | |||
: Tillagt i version 244. | |||
; '''-q''', '''--quiet''' | |||
: Undertrycker utskrift av resultat från olika kommandon och även | |||
tips om att ESP inte är tillgänglig. | |||
: | |||
: Tillagt i version 251. | |||
; '''--make-entry-directory=yes|no''' | |||
: Styr skapandet och borttagningen av postkatalogen för | |||
'''UAPI.1 Boot Loader Specification'''[1] Type #1 på filsystemet som | |||
innehåller resurser som kernel- och initrd-avbilder under '''install''' | |||
respektive '''remove'''. Katalogen namnges efter entry token, som anges | |||
med parametern '''--entry-token=''' nedan, och placeras direkt under | |||
roten ''$BOOT'' (dvs. under det filsystem som returneras av flaggan | |||
'''--print-boot-path''', se ovan). Standard är "no". | |||
: | |||
: Tillagt i version 251. | |||
; '''--entry-token=''' | |||
: Styr hur boot loader-poster för denna OS-installation namnges och | |||
identifieras. Accepteras under '''install''', och tar ett av "auto", | |||
"machine-id", "os-id", "os-image-id" eller en godtycklig sträng med | |||
prefixet "literal:" som argument. | |||
: | |||
: Om satt till '''machine-id''' namnges posterna efter maskin-ID:t för | |||
det körande systemet (t.ex. "b0e793a9baf14b5fa13ecbe84ff637ac"). Se | |||
[[machine-id(5)]] för detaljer om maskin-ID-konceptet och filen. | |||
: | |||
: Om satt till '''os-id''' namnges posterna efter OS-ID:t för det körande | |||
systemet, dvs. fältet ''ID='' i [[os-release(5)]] (t.ex. "fedora"). | |||
På motsvarande sätt, om satt till '''os-image-id''' namnges posterna | |||
efter OS-avbildens ID för det körande systemet, dvs. fältet | |||
''IMAGE_ID='' i os-release (t.ex. "vendorx-cashier-system"). | |||
: | |||
: Om satt till '''auto''' (standard) läses filen /etc/kernel/entry-token | |||
om den finns, och det lagrade värdet används. Annars, om det lokala | |||
maskin-ID:t är initierat, används detta. Annars används ''IMAGE_ID='' | |||
från os-release, om det är satt. Annars används ''ID='' från | |||
os-release, om det är satt. | |||
: | |||
: Om det inte sätts till '''machine-id''', eller när | |||
'''--make-entry-directory=yes''' används, skrivs den valda token- | |||
strängen till filen /etc/kernel/entry-token, för att säkerställa att | |||
den används även för framtida poster. Denna fil läses också av | |||
[[kernel-install(8)]], för att avgöra under vilket namn boot loader- | |||
poster ska genereras för nyinstallerade kernels, eller för att bestämma | |||
postnamnen när gamla ska tas bort. | |||
: | |||
: Att använda maskin-ID:t för att namnge posterna är generellt att | |||
föredra, men det finns fall där det är lämpligt att använda andra | |||
identifierare. Specifikt: om den identifieringsdata som maskin-ID:t | |||
innebär inte ska lagras på den (okrypterade) ''$BOOT''-partitionen, | |||
eller om ID:t ska genereras vid första uppstart och inte är känt när | |||
posterna förbereds. Observera att användning av maskin-ID:t har | |||
fördelen att flera parallella installationer av samma OS kan samexistera | |||
på samma medium, och att de kan uppdatera sina boot loader-poster | |||
oberoende av varandra. Vid användning av en annan identifierare | |||
(såsom OS-ID eller OS-avbildens ID) skulle parallella installationer | |||
av samma OS försöka använda samma postnamn. För att stödja parallella | |||
installationer måste installationsprogrammet använda en annan entry | |||
token när en andra installation läggs till. | |||
: | |||
: Tillagt i version 251. | |||
; '''--all-architectures''' | |||
: Installerar binärfiler för alla stödda EFI-arkitekturer | |||
(detta implicerar '''--variables=no'''). | |||
: | |||
: Tillagt i version 252. | |||
; '''--efi-boot-option-description=''' | |||
: Beskrivning av posten som läggs till i firmwarens lista över | |||
boot-alternativ. Standard är "Linux Boot Manager". | |||
: | |||
: Att använda standardnamnet "Linux Boot Manager" är generellt att | |||
föredra eftersom endast en bootloader installerad på en enda ESP- | |||
partition bör användas för att starta valfritt antal OS-installationer | |||
som hittas på systemets olika diskar. Distributioner bör därför inte | |||
använda denna flagga för att installera ett varumärkesmärkt namn i | |||
listan över boot-alternativ. I situationer med flera diskar, var och | |||
en med egen ESP-partition, kan det dock vara fördelaktigt att göra det | |||
lättare att identifiera vilken bootloader som används i firmwarens meny | |||
över boot-alternativ. | |||
: | |||
: Tillagt i version 252. | |||
; '''--dry-run''' | |||
: Testkörning för '''unlink''' och '''cleanup'''. | |||
: | |||
: I testläge skriver unlink- och cleanup-operationerna endast ut de | |||
filer som skulle raderas utan att faktiskt radera dem. | |||
: | |||
: Tillagt i version 253. | |||
; '''--secure-boot-auto-enroll=yes|no''', '''--private-key=''''PATH/URI'', | |||
'''--private-key-source=''''TYPE''':'':''NAME''', '''--certificate=''''PATH'', | |||
'''--certificate-source=''''TYPE''':'':''NAME''' | |||
: Konfigurerar ESP för automatisk Secure Boot-registrering när kommandot | |||
'''install''' används. Tar ett booleskt argument. Inaktiverat som | |||
standard. Att aktivera denna flagga gör att '''bootctl''' fyller ESP | |||
med signerade signaturdatabaser "PK", "KEK" och "db", som var och en | |||
innehåller det givna certifikatet i "DER"-format som enda post. Dessa | |||
signaturdatabaser för Secure Boot plockas upp och registreras av | |||
'''systemd-boot''' om Secure Boot är i setup-läge och automatisk | |||
Secure Boot-registrering är aktiverad. | |||
: | |||
: När denna flagga anges måste också ett certifikat och en privat nyckel | |||
tillhandahållas med flaggorna '''--certificate=''' och | |||
'''--private-key='''. Flaggan '''--certificate=''' tar en sökväg till | |||
ett PEM-kodat X.509-certifikat eller en URI som skickas vidare till | |||
OpenSSL-providern konfigurerad med '''--certificate-source''', vilken | |||
tar ett av "file" eller "provider", där den senare följs av en | |||
specifik provideridentifierare, separerad med kolon, t.ex. | |||
"provider:pkcs11". Flaggan '''--private-key=''' kan ta en sökväg eller | |||
en URI som skickas vidare till OpenSSL-motorn eller providern, enligt | |||
specifikationen i '''--private-key-source=''' som en tupel av typen | |||
"type:name", såsom "engine:pkcs11". Den angivna OpenSSL-signerings- | |||
motorn eller providern används för att signera EFI-signaturlistorna. | |||
: | |||
: Tillagt i version 257. | |||
; '''--no-pager''' | |||
: Skicka inte utdata till en pager. | |||
; '''--json=''''MODE'' | |||
: Visar utdata formaterad som JSON. Förväntar sig något av "short" | |||
(kortast möjliga utdata utan överflödiga blanksteg eller radbrytningar), | |||
"pretty" (en mer läsbar version av samma utdata, med indrag och | |||
radbrytningar) eller "off" (stäng av JSON-utdata, standard). | |||
; '''-h''', '''--help''' | |||
: Skriv ut en kort hjälptext och avsluta. | |||
; '''--version''' | |||
: Skriv ut en kort versionssträng och avsluta. | |||
== SIGNERADE .EFI-FILER == | |||
'''bootctl install''' och '''update''' letar först efter en | |||
'''systemd-boot'''-fil som slutar med suffixet ".efi.signed", och | |||
kopierar den i stället för den vanliga ".efi"-filen. Detta gör det | |||
möjligt för distributioner eller slutanvändare att tillhandahålla | |||
signerade avbilder för UEFI SecureBoot. | |||
== AVSLUTNINGSSTATUS == | |||
Vid framgång returneras 0, annars en felkod skild från noll. | |||
'''bootctl --print-root-device''' returnerar avslutningsstatus 80 om | |||
rotfilsystemet inte stöds av en enda blockenhet, och andra avslutnings- | |||
statusar skilda från noll för andra fel. | |||
== MILJÖ == | |||
Om ''$SYSTEMD_RELAX_ESP_CHECKS=1'' är satt lättas valideringskontrollerna | |||
för ESP, och sökvägen som anges med '''--esp-path=''' får peka på valfritt | |||
filsystem på valfri partition. | |||
På motsvarande sätt stänger ''$SYSTEMD_RELAX_XBOOTLDR_CHECKS=1'' av vissa | |||
valideringskontroller för den utökade Boot Loader-partitionen. | |||
== EXEMPEL == | |||
'''Exempel 1. Utdata från status och list''' | |||
<pre> | |||
$ bootctl status | |||
System: | |||
Firmware: UEFI 2.40 (firmware-version) ← firmwareleverantör och version | |||
Secure Boot: disabled (setup) ← status för Secure Boot | |||
TPM2 Support: yes | |||
Boot into FW: supported ← stöder firmware att starta in i sig själv | |||
Current Boot Loader: ← detaljer om systemd-boot eller annan boot loader | |||
Product: systemd-boot version som implementerar Boot Loader Interface[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: ← slumpfrö som används för entropi under tidig uppstart | |||
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/entry-token-kernel-version.conf | |||
version: kernel-version | |||
machine-id: ... | |||
linux: /entry-token/kernel-version/linux | |||
initrd: /entry-token/kernel-version/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/entry-token-kernel-version.conf | |||
version: kernel-version | |||
machine-id: ... | |||
linux: /entry-token/kernel-version/linux | |||
initrd: /entry-token/kernel-version/initrd | |||
options: root=... | |||
type: Boot Loader Specification Type #2 (.efi) | |||
title: Fedora Linux 35 (Workstation Edition) | |||
id: ... | |||
source: /boot/efi/EFI/Linux/fedora-kernel-version.efi | |||
version: kernel-version | |||
machine-id: ... | |||
linux: /EFI/Linux/fedora-kernel-version.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 | |||
</pre> | |||
I listningen anger "(default)" den post som används som standard, och | |||
"(selected)" den post som valdes senast (dvs. den som körs just nu). | |||
== SE ÄVEN == | |||
[[systemd-boot(7)]], '''UAPI.1 Boot Loader Specification'''[1], | |||
'''Boot Loader Interface'''[2], | |||
[[systemd-boot-random-seed.service(8)]] | |||
== NOTER == | |||
# '''UAPI.1 Boot Loader Specification''' | |||
#: https://uapi-group.org/specifications/specs/boot_loader_specification | |||
# '''Boot Loader Interface''' | |||
#: https://systemd.io/BOOT_LOADER_INTERFACE | |||
# '''Random Seeds''' | |||
#: https://systemd.io/RANDOM_SEEDS | |||
# '''UAPI.2 Discoverable Partitions Specification''' | |||
#: https://uapi-group.org/specifications/specs/discoverable_partitions_specification | |||
== COLOPHON == | |||
Denna sida är en del av projektet ''systemd'' | |||
(systemd system and service manager). Information om projektet finns på | |||
⟨http://www.freedesktop.org/wiki/Software/systemd⟩. | |||
Om du har en felrapport för denna manualsida, se | |||
⟨http://www.freedesktop.org/wiki/Software/systemd/#bugreports⟩. | |||
Denna sida hämtades från projektets uppströms Git-arkiv | |||
⟨https://github.com/systemd/systemd.git⟩ den 2026-01-16. | |||
(Vid den tidpunkten var datumet för den senaste commit som hittades i | |||
arkivet 2026-01-16.) Om du upptäcker renderingsproblem i denna | |||
HTML-version av sidan, eller om du anser att det finns en bättre eller | |||
mer uppdaterad källa för sidan, eller om du har korrigeringar eller | |||
förbättringar av informationen i denna COLOPHON | |||
(som ''inte'' är en del av originalmanualsidan), skicka e-post till | |||
man-pages@man7.org | |||
= Sidslut = | = Sidslut = | ||
Versionen från 25 april 2026 kl. 11.07
bootctl(1)
NAMN
bootctl — styr EFI-firmwareinställningar för uppstart och hanterar boot loader
SYNOPSIS
bootctl [FLAGGOR...] {KOMMANDO}
BESKRIVNING
bootctl kan kontrollera status för EFI-firmware och boot loader, lista och hantera tillgängliga boot loaders och boot loader-poster, samt installera, uppdatera eller ta bort boot loadern systemd-boot(7) på det aktuella systemet.
GENERELLA EFI-FIRMWARE-/BOOT LOADER-KOMMANDON
Dessa kommandon är tillgängliga på alla EFI-system, oavsett vilken boot loader som används.
- status
- Visar kortfattad information om systemets firmware, boot loadern som
användes för att starta systemet, de boot loaders som för närvarande finns tillgängliga i ESP, de boot loaders som finns listade i firmwarens lista över boot loaders samt aktuell standardpost för boot loadern. Om inget kommando anges är detta det underförstådda standardkommandot.
- Se exemplet nedan för detaljer om utdata.
- Tillagt i version 239.
- reboot-to-firmware [BOOL]
- Fråga efter eller sätt EFI-firmwarens flagga
”Reboot-Into-Firmware-Setup”. Tar ett booleskt argument som styr om firmwareinställningarna ska visas vid nästa omstart av systemet. Om argumentet utelämnas visas flaggans aktuella status, eller om flaggan stöds. Detta styr samma flagga som systemctl reboot --firmware-setup, men är mer lågnivåmässigt och gör det möjligt att sätta flaggan oberoende av att faktiskt begära en omstart.
- Tips: använd systemctl reboot --firmware-setup för att starta om
till firmwareinställningarna en gång. Se systemctl(1) för detaljer.
- Tillagt i version 251.
KOMMANDON ENLIGT BOOT LOADER SPECIFICATION
Dessa kommandon är tillgängliga för alla boot loaders som implementerar UAPI.1 Boot Loader Specification[1], såsom systemd-boot.
- list
- Visar alla tillgängliga boot loader-poster som implementerar
UAPI.1 Boot Loader Specification[1], samt alla andra poster som upptäckts eller genererats automatiskt av en boot loader som implementerar Boot Loader Interface[2]. JSON-utdata kan begäras med --json=.
- Se exemplet nedan för detaljer om utdata.
- Tillagt i version 239.
- unlink ID
- Tar bort en boot loader-post inklusive de filer den hänvisar till.
Tar en enda ID-sträng för en boot loader-post eller ett globmönster som argument. Refererade filer såsom kernel eller initrd tas endast bort om ingen annan post hänvisar till dem.
- Tillagt i version 253.
- cleanup
- Tar bort filer från ESP- och XBOOTLDR-partitionerna som tillhör
post-token men som inte refereras av några boot loader-poster.
- Tillagt i version 253.
KOMMANDON ENLIGT BOOT LOADER INTERFACE
Dessa kommandon är tillgängliga för alla boot loaders som implementerar UAPI.1 Boot Loader Specification[1] och Boot Loader Interface[2], såsom systemd-boot.
- set-default ID, set-oneshot ID, set-sysfail ID
- Sätter standardpost för boot loadern. Tar en enda ID-sträng för en
boot loader-post eller ett globmönster som argument. Kommandot set-oneshot sätter standardposten endast för nästa uppstart, medan set-default sätter den permanent för alla framtida uppstarter. Kommandot set-sysfail sätter den boot loader-post som ska användas vid systemfel. SysFail-poster kan valfritt ändra den automatiska urvalsordningen vid fel, till exempel om en firmwareuppdatering för uppstart misslyckas och felstatusen registreras i EFI-systemtabellen.
- bootctl list kan användas för att lista tillgängliga
boot loader-poster och deras ID:n.
- Dessutom kan boot loader-postens ID anges som något av:
@default, @oneshot eller @current, vilka motsvarar aktuell standardpost för alla framtida uppstarter, aktuell standardpost för nästa uppstart och den för närvarande startade boot loader-posten. Dessa special-ID:n slås upp till aktuella värden i EFI-variablerna LoaderEntryDefault, LoaderEntrySysFail, LoaderEntryOneShot och LoaderEntrySelected, se UAPI.1 Boot Loader Specification[1] för detaljer. Dessa special-ID:n är främst användbara som ett snabbt sätt att permanent göra den för närvarande startade boot loader-posten till standardvalet, eller att uppgradera standardposten för nästa uppstart till standardposten för alla framtida uppstarter, men kan även användas för andra operationer.
- Om satt till @saved kommer den valda posten att sparas som en
EFI-variabel vid varje uppstart och automatiskt väljas nästa gång boot loadern startar.
- När en tom sträng ("") anges som ID avsätts motsvarande EFI-variabel.
- Tips: använd systemctl reboot --boot-loader-entry='ID för att
starta om till en specifik boot-post och systemctl reboot --boot-loader-menu='timeout för att starta om till boot loader-menyn en gång. Se systemctl(1) för detaljer.
- Tillagt i version 240.
- set-timeout TIMEOUT, set-timeout-oneshot TIMEOUT
- Sätter timeout för boot loader-menyn i sekunder.
Kommandot set-timeout-oneshot sätter timeouten endast för nästa uppstart. Se systemd.time(7) för detaljer om syntaxen för tidsintervall.
- Om detta sätts till menu-disabled eller menu-hidden eller
0, visas ingen meny och standardposten startas omedelbart, medan
värdet menu-force inaktiverar timeouten samtidigt som menyn alltid
visas. När en tom sträng ("") anges återgår boot loadern till sin
standard-timeout för menyn.
- Tillagt i version 250.
SYSTEMD-BOOT-KOMMANDON
Dessa kommandon hanterar EFI-boot loadern systemd-boot, och fungerar inte tillsammans med andra boot loaders.
- install
- Installerar systemd-boot i EFI-systempartitionen. En kopia av
systemd-boot lagras som EFI:s standard-/fallback-loader på ESP/EFI/BOOT/BOOT*.EFI. Boot loadern läggs därefter till högst upp i firmwarens lista över boot loaders.
- Tillagt i version 239.
- update
- Uppdaterar alla installerade versioner av systemd-boot(7), om den
tillgängliga versionen är nyare än den version som är installerad i EFI-systempartitionen. Detta inkluderar även EFI:s standard-/ fallback-loader på ESP/EFI/BOOT/BOOT*.EFI. Boot loadern läggs därefter till sist i firmwarens lista över boot loaders om den saknas.
- Tillagt i version 239.
- remove
- Tar bort alla installerade versioner av systemd-boot från
EFI-systempartitionen och firmwarens lista över boot loaders.
- Tillagt i version 239.
- is-installed
- Kontrollerar om systemd-boot är installerad i ESP. Observera att
en enda ESP kan innehålla flera boot loaders; detta kontrollerar alltså om systemd-boot är en (av möjligen flera) installerade boot loaders — inte om den är standard eller om den är registrerad i några EFI-variabler.
- Tillagt i version 243.
- random-seed
- Genererar ett slumpfrö och lagrar det i EFI System Partition (ESP),
för användning av boot loadern systemd-boot. Om ett slumpfrö redan finns i ESP uppdateras det. Genererar också ett slumpmässigt ”system token” och lagrar det permanent som en EFI-variabel, om ett sådant inte har satts tidigare. Om boot loadern hittar slumpfröet i ESP och system-token i EFI-variabeln, härleds ett slumpfrö att skicka till OS:et och ett nytt frö att lagra i ESP från kombinationen av båda. Slumpfröet som skickas till OS:et tillgodoräknas kernelns entropipool av systemhanteraren under tidig uppstart, och gör det möjligt för userspace att starta med en fullt initierad entropipool mycket tidigt. Se även systemd-boot-random-seed.service(8).
- Se Random Seeds[3] för ytterligare information.
- Tillagt i version 243.
KERNELAVBILDSKOMMANDON
- kernel-identify KERNEL-IMAGE
- Tar en kernelavbild som argument. Kontrollerar vilken typ av kernel
avbilden är. Returnerar något av "uki", "addon", "pe" eller "unknown".
- Tillagt i version 253.
- kernel-inspect KERNEL-IMAGE
- Tar en kernelavbild som argument. Skriver ut detaljer om avbilden.
- Tillagt i version 253.
FLAGGOR
Följande flaggor förstås:
- --esp-path=
- Sökväg till EFI System Partition (ESP). Om den inte anges kontrolleras
/efi/, /boot/ och /boot/efi/ i tur och ordning. Det rekommenderas att montera ESP på /efi/, om möjligt.
- --boot-path=
- Sökväg till den utökade Boot Loader-partitionen, enligt definitionen i
UAPI.1 Boot Loader Specification[1]. Om den inte anges kontrolleras /boot/. Det rekommenderas att montera den utökade Boot Loader- partitionen på /boot/, om möjligt.
- --root='root
- Tar en katalogsökväg som argument. Alla sökvägar får det angivna
alternativa root-prefixet, inklusive sökvägar för konfiguration.
- Tillagt i version 252.
- --image='image
- Tar en sökväg till en diskavbildsfil eller blockenhetsnod. Om den
anges tillämpas alla operationer på filsystemet i den angivna diskavbilden. Denna flagga liknar --root=, men arbetar på filsystem lagrade i diskavbilder eller blockenheter. Diskavbilden ska antingen innehålla bara ett filsystem eller en uppsättning filsystem i en GPT-partitionstabell, i enlighet med UAPI.2 Discoverable Partitions Specification[4]. För mer information om stödda diskavbilder, se systemd-nspawn(1) och växeln med samma namn.
- Tillagt i version 252.
- --image-policy='policy
- Tar en policysträng för avbild som argument, enligt
systemd.image-policy(7). Policyn tillämpas när man arbetar på den diskavbild som anges med --image=, se ovan. Om den inte anges används som standard policyn "*", dvs. alla igenkända filsystem i avbilden används.
- --install-source=
- När binärfiler installeras med --root= eller --image= väljer
detta varifrån de ska hämtas. Tar ett av "auto" (standard), "image" eller "host". Med "auto" hämtas binärfiler från den angivna katalogen eller avbilden, och om de inte hittas där hämtas de från värdsystemet. Med "image" eller "host" görs ingen reservsökning om binärfilerna inte hittas i den valda källan.
- Tillagt i version 252.
- -p, --print-esp-path
- Denna flagga ändrar beteendet för status. Skriver endast ut
sökvägen till EFI System Partition (ESP) till standardutmatning och avslutar.
- Tillagt i version 236.
- -x, --print-boot-path
- Denna flagga ändrar beteendet för status. Skriver endast ut
sökvägen till den utökade Boot Loader-partitionen om den finns, annars sökvägen till ESP, till standardutmatning och avslutar. Detta kommando är användbart för att avgöra var boot loader-poster bör placeras, då de helst placeras i den utökade Boot Loader-partitionen om den finns, och annars i ESP.
- Boot Loader Specification Type #1-poster bör generellt placeras i
katalogen "$(bootctl -x)/loader/entries/". Förekomsten av den katalogen kan också användas som en indikation på att stöd för boot loader- poster finns i systemet. På motsvarande sätt bör Boot Loader Specification Type #2-poster placeras i katalogen "$(bootctl -x)/EFI/Linux/".
- Observera att denna flagga (på samma sätt som flaggan
--print-esp-path ovan) är tillgänglig oberoende av vilken boot loader som används, dvs. även utan att systemd-boot är installerad.
- Tillagt i version 242.
- --print-loader-path
- Denna flagga ändrar beteendet för status: den visar den absoluta
sökvägen till den boot loader-EFI-binär som användes för den aktuella uppstarten om denna information är tillgänglig. Observera att inget försök görs att verifiera om binären fortfarande finns.
- Tillagt i version 257.
- --print-stub-path
- Denna flagga ändrar beteendet för status: den visar den absoluta
sökvägen till den UKI-/stub-EFI-binär som användes för den aktuella uppstarten om denna information är tillgänglig. Observera att inget försök görs att verifiera om binären fortfarande finns.
- Tillagt i version 257.
- -R, --print-root-device
- Skriver ut sökvägen till den blockenhetsnod som ligger under rot-
filsystemet för det lokala OS:et. Detta skriver ut en sökväg som /dev/nvme0n1p5. Om rotfilsystemet är uppbackat av dm-crypt/LUKS eller dm-verity returneras den underliggande blockenheten. Om rotfilsystemet stöds av flera blockenheter (som btrfs tillåter) misslyckas operationen. Om växeln anges två gånger (dvs. -RR) och den upptäckta blockenheten är en partitionsenhet, bestäms och skrivs den ”hela” blockenheten den tillhör ut (t.ex. /dev/nvme0n1). Om rotfilsystemet är "tmpfs" (eller liknande minnesbaserat filsystem), returneras blockenheten bakom /usr/ om tillämpligt. Om rotfilsystemet är ett nätverksfilsystem (t.ex. NFS, CIFS) misslyckas operationen.
- Tillagt i version 254.
- --variables=yes|no
- Styr om firmwarens lista över boot loaders som lagras i EFI-variabler,
och andra EFI-variabler, ska beröras. Om den inte anges används standardvärdet no när körning i container upptäcks, annars yes.
- Tillagt i version 258.
- --random-seed=yes|no
- Som standard initierar kommandot install en slumpfröfil i ESP.
När en avbild skapas kan det vara önskvärt att inaktivera detta för att undvika att samma frö finns i alla instanser.
- Tillagt i version 257.
- --graceful
- Ignorera fel när EFI System Partition inte kan hittas, när EFI-
variabler inte kan skrivas, eller när en annan eller nyare boot loader redan är installerad. Gäller för närvarande endast verben is-installed, update, random-seed och install. Sedan version v258 aktiveras detta implicit när det körs i en chroot.
- Tillagt i version 244.
- -q, --quiet
- Undertrycker utskrift av resultat från olika kommandon och även
tips om att ESP inte är tillgänglig.
- Tillagt i version 251.
- --make-entry-directory=yes|no
- Styr skapandet och borttagningen av postkatalogen för
UAPI.1 Boot Loader Specification[1] Type #1 på filsystemet som innehåller resurser som kernel- och initrd-avbilder under install respektive remove. Katalogen namnges efter entry token, som anges med parametern --entry-token= nedan, och placeras direkt under roten $BOOT (dvs. under det filsystem som returneras av flaggan --print-boot-path, se ovan). Standard är "no".
- Tillagt i version 251.
- --entry-token=
- Styr hur boot loader-poster för denna OS-installation namnges och
identifieras. Accepteras under install, och tar ett av "auto", "machine-id", "os-id", "os-image-id" eller en godtycklig sträng med prefixet "literal:" som argument.
- Om satt till machine-id namnges posterna efter maskin-ID:t för
det körande systemet (t.ex. "b0e793a9baf14b5fa13ecbe84ff637ac"). Se machine-id(5) för detaljer om maskin-ID-konceptet och filen.
- Om satt till os-id namnges posterna efter OS-ID:t för det körande
systemet, dvs. fältet ID= i os-release(5) (t.ex. "fedora"). På motsvarande sätt, om satt till os-image-id namnges posterna efter OS-avbildens ID för det körande systemet, dvs. fältet IMAGE_ID= i os-release (t.ex. "vendorx-cashier-system").
- Om satt till auto (standard) läses filen /etc/kernel/entry-token
om den finns, och det lagrade värdet används. Annars, om det lokala maskin-ID:t är initierat, används detta. Annars används IMAGE_ID= från os-release, om det är satt. Annars används ID= från os-release, om det är satt.
- Om det inte sätts till machine-id, eller när
--make-entry-directory=yes används, skrivs den valda token- strängen till filen /etc/kernel/entry-token, för att säkerställa att den används även för framtida poster. Denna fil läses också av kernel-install(8), för att avgöra under vilket namn boot loader- poster ska genereras för nyinstallerade kernels, eller för att bestämma postnamnen när gamla ska tas bort.
- Att använda maskin-ID:t för att namnge posterna är generellt att
föredra, men det finns fall där det är lämpligt att använda andra identifierare. Specifikt: om den identifieringsdata som maskin-ID:t innebär inte ska lagras på den (okrypterade) $BOOT-partitionen, eller om ID:t ska genereras vid första uppstart och inte är känt när posterna förbereds. Observera att användning av maskin-ID:t har fördelen att flera parallella installationer av samma OS kan samexistera på samma medium, och att de kan uppdatera sina boot loader-poster oberoende av varandra. Vid användning av en annan identifierare (såsom OS-ID eller OS-avbildens ID) skulle parallella installationer av samma OS försöka använda samma postnamn. För att stödja parallella installationer måste installationsprogrammet använda en annan entry token när en andra installation läggs till.
- Tillagt i version 251.
- --all-architectures
- Installerar binärfiler för alla stödda EFI-arkitekturer
(detta implicerar --variables=no).
- Tillagt i version 252.
- --efi-boot-option-description=
- Beskrivning av posten som läggs till i firmwarens lista över
boot-alternativ. Standard är "Linux Boot Manager".
- Att använda standardnamnet "Linux Boot Manager" är generellt att
föredra eftersom endast en bootloader installerad på en enda ESP- partition bör användas för att starta valfritt antal OS-installationer som hittas på systemets olika diskar. Distributioner bör därför inte använda denna flagga för att installera ett varumärkesmärkt namn i listan över boot-alternativ. I situationer med flera diskar, var och en med egen ESP-partition, kan det dock vara fördelaktigt att göra det lättare att identifiera vilken bootloader som används i firmwarens meny över boot-alternativ.
- Tillagt i version 252.
- --dry-run
- Testkörning för unlink och cleanup.
- I testläge skriver unlink- och cleanup-operationerna endast ut de
filer som skulle raderas utan att faktiskt radera dem.
- Tillagt i version 253.
- --secure-boot-auto-enroll=yes|no, --private-key='PATH/URI,
--private-key-source='TYPE::NAME, --certificate='PATH, --certificate-source='TYPE::NAME
- Konfigurerar ESP för automatisk Secure Boot-registrering när kommandot
install används. Tar ett booleskt argument. Inaktiverat som standard. Att aktivera denna flagga gör att bootctl fyller ESP med signerade signaturdatabaser "PK", "KEK" och "db", som var och en innehåller det givna certifikatet i "DER"-format som enda post. Dessa signaturdatabaser för Secure Boot plockas upp och registreras av systemd-boot om Secure Boot är i setup-läge och automatisk Secure Boot-registrering är aktiverad.
- När denna flagga anges måste också ett certifikat och en privat nyckel
tillhandahållas med flaggorna --certificate= och --private-key=. Flaggan --certificate= tar en sökväg till ett PEM-kodat X.509-certifikat eller en URI som skickas vidare till OpenSSL-providern konfigurerad med --certificate-source, vilken tar ett av "file" eller "provider", där den senare följs av en specifik provideridentifierare, separerad med kolon, t.ex. "provider:pkcs11". Flaggan --private-key= kan ta en sökväg eller en URI som skickas vidare till OpenSSL-motorn eller providern, enligt specifikationen i --private-key-source= som en tupel av typen "type:name", såsom "engine:pkcs11". Den angivna OpenSSL-signerings- motorn eller providern används för att signera EFI-signaturlistorna.
- Tillagt i version 257.
- --no-pager
- Skicka inte utdata till en pager.
- --json='MODE
- Visar utdata formaterad som JSON. Förväntar sig något av "short"
(kortast möjliga utdata utan överflödiga blanksteg eller radbrytningar), "pretty" (en mer läsbar version av samma utdata, med indrag och radbrytningar) eller "off" (stäng av JSON-utdata, standard).
- -h, --help
- Skriv ut en kort hjälptext och avsluta.
- --version
- Skriv ut en kort versionssträng och avsluta.
SIGNERADE .EFI-FILER
bootctl install och update letar först efter en systemd-boot-fil som slutar med suffixet ".efi.signed", och kopierar den i stället för den vanliga ".efi"-filen. Detta gör det möjligt för distributioner eller slutanvändare att tillhandahålla signerade avbilder för UEFI SecureBoot.
AVSLUTNINGSSTATUS
Vid framgång returneras 0, annars en felkod skild från noll. bootctl --print-root-device returnerar avslutningsstatus 80 om rotfilsystemet inte stöds av en enda blockenhet, och andra avslutnings- statusar skilda från noll för andra fel.
MILJÖ
Om $SYSTEMD_RELAX_ESP_CHECKS=1 är satt lättas valideringskontrollerna för ESP, och sökvägen som anges med --esp-path= får peka på valfritt filsystem på valfri partition.
På motsvarande sätt stänger $SYSTEMD_RELAX_XBOOTLDR_CHECKS=1 av vissa valideringskontroller för den utökade Boot Loader-partitionen.
EXEMPEL
Exempel 1. Utdata från status och list
$ bootctl status
System:
Firmware: UEFI 2.40 (firmware-version) ← firmwareleverantör och version
Secure Boot: disabled (setup) ← status för Secure Boot
TPM2 Support: yes
Boot into FW: supported ← stöder firmware att starta in i sig själv
Current Boot Loader: ← detaljer om systemd-boot eller annan boot loader
Product: systemd-boot version som implementerar Boot Loader Interface[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: ← slumpfrö som används för entropi under tidig uppstart
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/entry-token-kernel-version.conf
version: kernel-version
machine-id: ...
linux: /entry-token/kernel-version/linux
initrd: /entry-token/kernel-version/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/entry-token-kernel-version.conf
version: kernel-version
machine-id: ...
linux: /entry-token/kernel-version/linux
initrd: /entry-token/kernel-version/initrd
options: root=...
type: Boot Loader Specification Type #2 (.efi)
title: Fedora Linux 35 (Workstation Edition)
id: ...
source: /boot/efi/EFI/Linux/fedora-kernel-version.efi
version: kernel-version
machine-id: ...
linux: /EFI/Linux/fedora-kernel-version.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)" den post som används som standard, och "(selected)" den post som valdes senast (dvs. den som körs just nu).
SE ÄVEN
systemd-boot(7), UAPI.1 Boot Loader Specification[1], Boot Loader Interface[2], systemd-boot-random-seed.service(8)
NOTER
- UAPI.1 Boot Loader Specification
- Boot Loader Interface
- Random Seeds
- UAPI.2 Discoverable Partitions Specification
COLOPHON
Denna sida är en del av projektet systemd (systemd system and service manager). Information om projektet finns på ⟨http://www.freedesktop.org/wiki/Software/systemd⟩. Om du har en felrapport för denna manualsida, se ⟨http://www.freedesktop.org/wiki/Software/systemd/#bugreports⟩. Denna sida hämtades från projektets uppströms Git-arkiv ⟨https://github.com/systemd/systemd.git⟩ den 2026-01-16. (Vid den tidpunkten var datumet för den senaste commit som hittades i arkivet 2026-01-16.) Om du upptäcker renderingsproblem i denna HTML-version av sidan, eller om du anser att det finns en bättre eller mer uppdaterad källa för sidan, eller om du har korrigeringar eller förbättringar av informationen i denna COLOPHON (som inte är en del av originalmanualsidan), skicka e-post till man-pages@man7.org
Sidslut
Orginalhemsidan på Engelska https://man7.org/linux/man-pages/man1/bootctl.1.html
Det här är en maskinöversättning av Linux man sidor till svenska. Om du hittar fel är vi tacksamma om du rapporterar dem via formuläret som finns på
https://www.linux.se/kontaka-linux-se/
Tack till PC Service som har sponsrat Linux.se med webbhotell.