systemctl(1)

NAMN

systemctl – styr systemd:s system- och tjänstehanterare

SYNOPSIS

systemctl [OPTIONER...] KOMMANDO [UNIT...]

BESKRIVNING

systemctl kan användas för att inspektera och styra tillståndet hos system- och tjänstehanteraren systemd(1). Se systemd(1) för en introduktion till de grundläggande begrepp och funktioner som verktyget hanterar.

KOMMANDON

Följande kommandon stöds.

Unit-kommandon – inspektion och ändring

list-units [MÖNSTER...]

Lista units som systemd för närvarande har i minnet. Detta omfattar units som refereras direkt eller genom ett beroende, units som hålls kvar av program via API, samt units som tidigare varit aktiva och misslyckats.

Som standard visas endast units som är aktiva, har väntande jobb eller har misslyckats. Detta kan ändras med --all. Om ett eller flera mönster anges visas endast units som matchar något av dem. Resultatet filtreras även av --type= och --state= om dessa används.

Kommandot visar inte oinstansierade unit-mallar, utan endast instanser av mallarna. En mall som:

foo@.service

visas därför inte, men en instans som:

foo@bar.service

kan visas. Använd list-unit-files för att lista installerade mallfiler.

Exempel på utdata:

UNIT                         LOAD   ACTIVE SUB     DESCRIPTION
sys-module-fuse.device       loaded active plugged /sys/module/fuse
-.mount                      loaded active mounted Root Mount
boot-efi.mount               loaded active mounted /boot/efi
systemd-journald.service     loaded active running Journal Service
systemd-logind.service       loaded active running Login Service
user@1000.service            loaded failed failed  User Manager for UID 1000
systemd-tmpfiles-clean.timer loaded active waiting Daily Cleanup of Temporary Directories

Kolumnerna betyder:

LOAD

Visar om unit-definitionen lästes in korrekt.

ACTIVE

Unitens övergripande aktiveringstillstånd, en generalisering av SUB.

SUB

Unitens detaljerade, typspecifika tillstånd.

LOAD kan bland annat vara:

• loaded
• not-found
• bad-setting
• error
• masked

Möjliga övergripande ACTIVE-tillstånd:

Tillstånd	Beskrivning
active	Startad, bunden, ansluten eller på annat sätt aktiv, beroende på unit-typ.
inactive	Stoppad, obunden, frånkopplad eller på annat sätt inaktiv.
failed	Liknar inactive, men uniten har misslyckats, exempelvis genom felkod, krasch, tidsgräns eller för många omstarter.
activating	Växlar från inactive till active.
deactivating	Växlar från active till inactive.
maintenance	Uniten är inaktiv och en underhållsåtgärd pågår.
reloading	Uniten är aktiv och läser om sin konfiguration.
refreshing	Uniten är aktiv och en ny mount aktiveras i dess namnrymd.

SUB-värdena varierar med unit-typen. Uppsättningen LOAD-, ACTIVE- och SUB-värden kan ändras mellan systemd-versioner.

Visa aktuella tillstånd med:

systemctl --state=help

Detta är standardkommandot om inget kommando anges.

list-automounts [MÖNSTER...]

Lista automount-units som finns i minnet, sorterade efter monteringssökväg. Om mönster anges visas endast matchande units.

Exempel:

WHAT        WHERE                    MOUNTED IDLE TIMEOUT UNIT
/dev/sdb1   /mnt/test                no      120s         mnt-test.automount
binfmt_misc /proc/sys/fs/binfmt_misc yes     0            proc-sys-fs-binfmt_misc.automount

Se även --show-types, --all och --state=.

Tillagt i version 252.

list-paths [MÖNSTER...]

Lista path-units i minnet, sorterade efter sökväg. Om mönster anges visas endast matchande units.

Exempel:

PATH                      CONDITION         UNIT                                ACTIVATES
/run/systemd/ask-password DirectoryNotEmpty systemd-ask-password-plymouth.path systemd-ask-password-plymouth.service
/var/cache/cups           PathExists        cups.path                           cups.service

Se även --show-types, --all och --state=.

Tillagt i version 254.

list-sockets [MÖNSTER...]

Lista socket-units i minnet, sorterade efter lyssningsadress. Om mönster anges visas endast matchande units.

Exempel:

LISTEN           UNIT                        ACTIVATES
kobject-uevent 1 systemd-udevd-kernel.socket systemd-udevd.service
/dev/rfkill      systemd-rfkill.socket       systemd-rfkill.service

Eftersom adresser kan innehålla mellanslag lämpar sig utmatningen inte för maskinell tolkning.

Se även --show-types, --all och --state=.

Tillagt i version 202.

list-timers [MÖNSTER...]

Lista timer-units i minnet, sorterade efter nästa utlösning.

Kolumner:

NEXT

Nästa gång timern körs.

LEFT

Tid kvar till nästa körning.

LAST

Senaste körning.

PASSED

Tid sedan senaste körning.

UNIT

Timerns unit-namn.

ACTIVATES

Tjänsten som timern aktiverar.

Se även --all och --state=.

Tillagt i version 209.

is-active MÖNSTER...

Kontrollera om någon angiven unit är aktiv. Returnerar status 0 om minst en är aktiv, annars ett värde som inte är noll.

Om --quiet inte används skrivs det aktuella tillståndet till standardutdata.

is-failed [MÖNSTER...]

Kontrollera om någon angiven unit har tillståndet failed. Utan unit kontrolleras om det finns någon misslyckad unit eller någon ordningscykel, vilket motsvarar systemtillståndet degraded.

Returnerar 0 om minst en unit har misslyckats.

Tillagt i version 197.

status [MÖNSTER...|PID...]

Visa körstatus för hela systemet eller en eller flera units, följt av de senaste journalraderna.

Om inga argument eller filter anges visas hela systemets status. Tillsammans med --all följer status för samtliga units.

Ett argument kan vara:

• unit-namn
• globmönster
• PID, varvid den unit processen tillhör visas

Med --type=, --state= eller --failed filtreras resultatet ytterligare.

Kommandot är avsett för människor. Använd show för maskinläsbar utdata.

Som standard visas tio journalrader och långa rader förkortas till terminalbredden. Detta kan ändras med --lines= och --full.

För full journalhistorik används:

journalctl --unit=UNIT
journalctl --user-unit=UNIT

Status visar endast den aktuella eller senast kända körningen. Tidigare körningar, tidigare uppstarter eller units som släppts ur minnet måste hämtas med journalctl.

Att köra status kan i sig få systemd att läsa in unit-filen. Kommandot är därför inte lämpligt för att avgöra om en unit redan låg i minnet.

Exempel:

systemctl status bluetooth

Symbolen framför unit-namnet använder färg och form:

• vit cirkel – inactive eller maintenance
• grön punkt – active
• vit punkt – deactivating
• rött kryss – failed eller error
• grön cirkulerande pil – reloading eller refreshing

Raden Loaded: visar om unit-filen är:

• loaded
• error
• not-found
• bad-setting
• masked

Raden visar även filens sökväg och aktiveringsstatus.

Raden Active: visar det aktuella aktiveringstillståndet. failed innebär exempelvis krasch, felkod eller timeout. Orsaken loggas för senare felsökning.

show [MÖNSTER...|JOBB...]

Visa egenskaper för units, jobb eller själva tjänstehanteraren.

Utan argument visas manager-egenskaper. Ett unit-namn visar unitens egenskaper och ett numeriskt jobb-ID visar jobbets egenskaper.

Tomma egenskaper döljs normalt. Använd --all för att visa dem. Med --property= väljs särskilda egenskaper.

Kommandot är avsett för maskinläsbar utdata.

Många egenskaper motsvarar inställningar i unit-filer, men visas ofta i normaliserad form. Exempelvis visas tidsvärden internt i mikrosekunder med suffixet USec.

Se org.freedesktop.systemd1(5) för D-Bus-gränssnittet.

cat MÖNSTER...

Visa källfilerna bakom en eller flera units, inklusive huvudfil och drop-ins. Varje fil föregås av en kommentar med filnamnet.

Filerna på disk kan skilja sig från systemd:s inlästa konfiguration om de ändrats utan att daemon-reload körts.

Tillagt i version 209.

help MÖNSTER...|PID...

Visa manualsidor för angivna units. Om en PID anges visas dokumentationen för den unit processen tillhör.

Tillagt i version 185.

list-dependencies [UNIT...]

Visa units som krävs eller önskas av angivna units. Följande beroenden följs rekursivt:

• Requires=
• Requisite=
• Wants=
• ConsistsOf=
• BindsTo=
• Upholds=

Utan unit används default.target.

Med --type= eller --state= går trädformatet inte att använda, och --plain antas.

Som standard expanderas bara target-units rekursivt. Med --all expanderas även andra typer.

--reverse, --after och --before ändrar vilka beroenden som visas.

Endast units som redan är inlästa kan visas. Kommandot ger därför inte alltid en fullständig lista över omvända beroenden.

Tillagt i version 198.

start MÖNSTER...

Starta eller aktivera angivna units.

Globmönster expanderas endast mot units som redan finns i minnet. Inaktiva units och ännu okända instanser matchas därför ofta inte. Aliasnamn beaktas inte.

--all kan utöka operationen till inaktiva units som refereras av andra inlästa units.

stop MÖNSTER...

Stoppa eller avaktivera angivna units.

Kommandot misslyckas om uniten saknas eller förbjuder manuell stoppning med RefuseManualStop=. Det betraktas däremot inte som ett kommandofel om ett konfigurerat ExecStop=-kommando misslyckas, eftersom systemd ändå avslutar uniten.

Om uniten fortfarande kan aktiveras av andra units visas en varning. Undertryck den med --no-warn.

reload MÖNSTER...

Be angivna units läsa om sin programspecifika konfiguration.

Detta läser inte om systemd-unitfilen. För det används:

systemctl daemon-reload

För Apache betyder reload exempelvis att webbservern läser om httpd.conf, inte att systemd läser om apache.service.

restart MÖNSTER...

Stoppa och starta angivna units. Units som inte körs startas.

En restart tömmer inte nödvändigtvis alla resurser. Exempelvis kan tjänstens fdstore behållas så länge ett jobb är väntande. För en fullständig tömning används separat stop och därefter start.

try-restart MÖNSTER...

Starta endast om units som redan körs. Inaktiva units påverkas inte.

enqueue-marked

Köa start-, stopp-, restart- eller reload-jobb för units med motsvarande needs-*-markörer.

Om en unit markerad för reload saknar reload-stöd köas restart.

Markörer kan sättas med:

systemctl set-property UNIT Markers=...

Utan --no-block väntar systemctl tills jobben slutförts.

Tillagt i version 260.

reload-or-restart MÖNSTER...

Läs om units som stöder reload. Övriga stoppas och startas. Inaktiva units startas.

Tillsammans med den äldre optionen --marked är detta ett föråldrat alias för enqueue-marked.

try-reload-or-restart MÖNSTER...

Läs om aktiva units om det stöds, annars starta om dem. Inaktiva units påverkas inte.

Tillagt i version 229.

isolate UNIT

Starta angiven unit och dess beroenden och stoppa övriga units, utom de som har IgnoreOnIsolate=yes.

Om suffix saknas antas .target.

Kommandot är riskfyllt eftersom det omedelbart kan stoppa processer som inte ingår i det nya target-läget, inklusive grafisk miljö eller terminal.

Endast units med AllowIsolate=yes får isoleras.

kill MÖNSTER...

Skicka en Unix-signal till processer i angivna units.

Använd:

• --kill-whom= för att välja processer
• --signal= för att välja signal
• --kill-value= för realtidssignal med värde
• --kill-subgroup= för viss under-cgroup

clean MÖNSTER...

Ta bort konfigurations-, status-, cache-, logg-, runtime- eller fdstore-data.

Välj resurser med --what=.

Värde	Motsvarande inställning
runtime	RuntimeDirectory=
state	StateDirectory=
cache	CacheDirectory=
logs	LogsDirectory=
configuration	ConfigurationDirectory=
fdstore	FileDescriptorStorePreserve=
all	Alla ovan
help	Visa stödda värden

Utan --what= tas cache-, runtime- och fdstore-data bort.

Units måste vara stoppade.

Tillagt i version 243.

freeze MÖNSTER...

Frys alla processer i unitens cgroup. Processerna schemaläggs inte på CPU förrän de tinas.

Funktionen kräver unified cgroup hierarchy. Uniten tinas automatiskt innan ett nytt jobb körs mot den.

Tillagt i version 246.

thaw MÖNSTER...

Tina tidigare frysta units och återuppta processerna.

Tillagt i version 246.

set-property UNIT EGENSKAP=VÄRDE...

Ändra unit-egenskaper under körning där detta stöds.

Många resursstyrningsinställningar kan ändras direkt. Ändringarna lagras normalt på disk för framtida starter. Med --runtime gäller de endast fram till nästa omstart.

Exempel:

systemctl set-property foobar.service CPUWeight=200
systemctl set-property foobar.service CPUWeight=200 MemoryMax=2G IPAccounting=yes
systemctl set-property avahi-daemon.service IPAddressDeny=

Tomt värde återställer normalt standardinställningen.

Tillagt i version 206.

bind UNIT SÖKVÄG [SÖKVÄG]

Bind-montera en fil eller katalog från värden in i unitens mount-namnrymd.

Första sökvägen är källan på värden och den andra målet i uniten. Om målet utelämnas används samma sökväg.

Med --read-only skapas en skrivskyddad mount. Med --mkdir skapas målsökvägen först.

Stöds endast för units som körs i en mount-namnrymd, exempelvis med RootImage= eller PrivateMounts=.

Mounten är tillfällig och tas bort när unitens huvudprocess avslutas.

Tillagt i version 248.

mount-image UNIT IMAGE [SÖKVÄG [PARTITIONSNAMN:MOUNTOPTIONER]]

Montera en avbildning från värden i unitens mount-namnrymd.

Argumenten anger källavbildning, målkatalog och valfritt partitionsnamn med mount-optioner.

Exempel:

systemctl mount-image foo.service /tmp/img.raw /var/lib/image root:ro,nosuid
systemctl mount-image --mkdir bar.service /tmp/img.raw /var/lib/baz/img

Tillagt i version 248.

service-log-level TJÄNST [NIVÅ]

Visa eller ändra tjänstens aktuella loggnivå.

Nivån kan vara 0–7 eller:

emerg alert crit err warning notice info debug

Tjänsten måste exportera ett lämpligt BusName= och implementera org.freedesktop.LogControl1(5).

Tillagt i version 247.

service-log-target TJÄNST [MÅL]

Visa eller ändra tjänstens loggmål.

Möjliga mål:

• console
• kmsg
• journal
• syslog
• null
• auto

Normala tjänster bör huvudsakligen använda console, journal eller null.

Även detta kräver org.freedesktop.LogControl1(5).

Tillagt i version 247.

reset-failed [MÖNSTER...]

Nollställ tillståndet failed för angivna units, eller alla units om inga namn anges.

Kommandot nollställer även:

• startbegränsningsräknare
• omstartsräknare för tjänster

Det kan därför användas när StartLimitIntervalSec= eller StartLimitBurst= hindrar en tjänst från att starta igen.

whoami [PID...]

Visa vilken unit varje angiven process tillhör. Utan PID visas den unit som det aktuella systemctl-kommandot körs i.

Tillagt i version 254.

Unitfilskommandon

list-unit-files [MÖNSTER...]

Lista installerade unit-filer tillsammans med deras aktiveringsstatus.

Till skillnad från list-units visas både mallar och instanser.

Tillagt i version 233.

enable UNIT... eller enable SÖKVÄG...

Aktivera units eller instanser genom att skapa symboliska länkar enligt unit-filernas [Install]-avsnitt.

Manager-konfigurationen läses om efteråt, motsvarande daemon-reload.

Aktivering startar inte tjänsten. Kombinera med --now för att även starta.

För instanser som:

foo@bar.service

skapas instanslänkar som pekar på mallfilen:

foo@.service

Kommandot kan ta unit-namn eller absoluta sökvägar. En fil utanför standardkatalogerna länkas in i unit-sökvägen. Filsystemet måste vara tillgängligt när systemd startar.

Enheter utan installationsinformation ger en varning, som kan döljas med --no-warn.

Att aktivera och att starta är oberoende operationer. En unit kan vara aktiverad utan att köra och kan köras utan att vara aktiverad.

--system, --user, --runtime och --global styr omfattningen.

Maskerade units kan inte aktiveras.

disable UNIT...

Inaktivera units genom att ta bort länkar från unit-konfigurationskatalogen.

Alla länkar till matchande filer kan tas bort, även manuellt skapade länkar.

Units i Also= inaktiveras också.

Manager-konfigurationen läses om. Tjänster stoppas inte om inte --now används.

Om en utlösande unit fortfarande är aktiv visas en varning. I användarläge kan en unit fortfarande vara globalt aktiverad.

Tillagt i version 238.

reenable UNIT...

Kör i praktiken disable följt av enable för att återskapa standardlänkar enligt [Install].

Startar inte om units om inte --now används.

Tillagt i version 238.

preset UNIT...

Återställ aktiveringsstatus enligt preset-policyfilerna.

--preset-mode= styr om units ska aktiveras, inaktiveras eller båda.

Units utan installationsinformation ignoreras.

Se systemd.preset(5).

Tillagt i version 238.

preset-all

Tillämpa preset-policy på alla installerade unit-filer.

Tillagt i version 215.

is-enabled UNIT...

Kontrollera om någon unit är aktiverad. Returnerar 0 om minst en är aktiverad.

Möjliga svar:

Status	Betydelse	Statuskod
enabled	Permanent aktiverad via wants/requires/Alias-länkar	0
enabled-runtime	Tillfälligt aktiverad under /run	0
linked	Länkad permanent från extern plats	inte 0
linked-runtime	Tillfälligt länkad	inte 0
alias	Namnet är ett alias	0
masked	Permanent maskerad	inte 0
masked-runtime	Tillfälligt maskerad	inte 0
static	Saknar möjlighet att aktiveras via [Install]	0
indirect	Aktiveras indirekt eller via annan instans	0
disabled	Inte aktiverad men har [Install]-information	inte 0
generated	Skapad av generator	0
transient	Skapad dynamiskt via runtime-API	0
bad	Ogiltig unit-fil eller annat fel	inte 0
not-found	Unit-filen saknas	4

Tillagt i version 238.

mask UNIT...

Maskera units genom att länka dem till:

/dev/null

Detta är starkare än disable och blockerar all aktivering, även manuell.

Med --runtime gäller maskeringen till nästa omstart. Med --now stoppas uniten också.

Kommandot tar unit-namn, inte sökvägar.

Maskering skapar länken under /etc/systemd/system eller /run/systemd/system. Den fungerar främst för leverantörsfiler under /usr/lib/systemd/system.

Tillagt i version 238.

unmask UNIT...

Ta bort maskeringen.

Tillagt i version 238.

link SÖKVÄG...

Länka in unit-filer utanför den normala sökvägen. Sökvägar måste vara absoluta.

Effekten kan tas bort med disable.

Tillagt i version 233.

revert UNIT...

Återställ units till leverantörens version.

Tar bort:

• drop-in-konfiguration
• lokala ersättningsfiler
• runtime-overrides
• maskering

Lokala units utan leverantörsversion under /usr tas inte bort.

Kommandot återställer i praktiken ändringar gjorda med edit, set-property och mask.

Tillagt i version 230.

add-wants TARGET UNIT...

Lägg till Wants=-beroenden från target till units.

add-requires TARGET UNIT...

Lägg till Requires=-beroenden.

Båda stöder omfattningsoptioner på samma sätt som enable.

Tillagt i version 217.

edit UNIT...

Redigera eller ersätt en drop-in eller huvudfil.

Med:

• --system – systemunits
• --user – aktuell användares units
• --global – globala användarunits
• --full – redigera fullständig ersättningsfil
• --drop-in=NAMN – välj drop-in-filnamn
• --force – tillåt ny unit eller drop-in för saknad unit
• --runtime – lagra tillfälligt under /run
• --stdin – läs nytt innehåll från standardindata

Editorn arbetar på en temporär fil. Om den sparas laddas konfigurationen om. En tom temporär fil avbryter ändringen.

Fjärrredigering stöds inte.

Tillagt i version 218.

get-default

Visa vilket target default.target pekar på.

Tillagt i version 205.

set-default TARGET

Ändra standardtarget genom att uppdatera länken default.target.

Tillagt i version 205.

Maskinkommandon

list-machines [MÖNSTER...]

Lista värdsystemet och alla lokala containrar som körs, tillsammans med deras tillstånd.

Tillagt i version 212.

Jobbkommandon

list-jobs [MÖNSTER...]

Lista pågående jobb. Med mönster visas bara jobb för matchande units.

--after och --before visar vilka jobb som väntar på varandra.

Tillagt i version 233.

cancel [JOBB...]

Avbryt angivna jobb-ID:n. Utan ID avbryts alla väntande jobb.

Tillagt i version 233.

Miljökommandon

Systemd har ett miljöblock som skickas till processer som tjänstehanteraren startar.

Variabelnamn får innehålla ASCII-bokstäver, siffror och understreck, men får inte vara tomma eller börja med en siffra.

Värden måste vara giltig UTF-8. Kontrolltecken som radbrytning, tabb och ESC är giltiga.

Den totala storleken begränsas av _SC_ARG_MAX från sysconf(3).

show-environment

Visa tjänstehanterarens effektiva miljöblock i ett format som kan läsas av de flesta skal.

Enkla värden skrivs:

VARIABEL=värde

Värden med specialtecken kan skrivas med dollar-enkelcitat:

VARIABEL=$'värde'

Denna syntax stöds av bash, zsh, ksh och BusyBox ash, men inte alltid av dash eller fish.

set-environment VARIABEL=VÄRDE...

Sätt variabler i manager-miljöblocket.

Variabelnamn och värden valideras enligt reglerna ovan.

unset-environment VARIABEL...

Ta bort angivna variabler från manager-miljön.

import-environment VARIABEL...

Importera angivna variabler från systemctl-processens miljö till manager-miljön.

Om inga namn anges importeras hela miljön. Detta rekommenderas inte eftersom variabler som är meningsfulla i ett skal kan vara olämpliga i tjänstehanteraren.

Manager-tillståndskommandon

daemon-reload

Läs om systemd:s manager-konfiguration.

Detta:

• kör om generatorer
• läser om samtliga unit-filer
• återskapar beroendeträdet

Använd efter ändringar av unit-filer.

daemon-reexec

Serialisera manager-tillståndet, kör om systemd-processen och återställ tillståndet.

Används främst för felsökning och paketuppgraderingar. En ny PID 1 skapas inte.

log-level [NIVÅ]

Visa eller ändra tjänstehanterarens loggnivå.

Möjliga nivåer är bland annat:

emerg alert crit err warning notice info debug

log-target [MÅL]

Visa eller ändra tjänstehanterarens loggmål.

Möjliga mål inkluderar:

console console-prefixed kmsg journal journal-or-kmsg null auto

service-watchdogs [yes|no]

Visa eller ändra om tjänsternas runtime-watchdogs ska aktiveras.

När watchdogs stängs av ignoreras WatchdogSec= tills de aktiveras igen.

Systemkommandon

is-system-running

Kontrollera systemets övergripande tillstånd.

Möjliga tillstånd omfattar:

Tillstånd	Betydelse
initializing	Tidig uppstart, innan grundläggande target nåtts.
starting	Systemet startar fortfarande.
running	Systemet är fullt igång utan misslyckade units.
degraded	Systemet körs men någon unit har misslyckats.
maintenance	Rescue- eller emergency-läge.
stopping	Systemet stängs av.
offline	Tjänstehanteraren körs inte.
unknown	Tillståndet kunde inte fastställas.

Med --wait väntar kommandot tills uppstarten slutförts.

default

Starta default.target. Detta motsvarar att starta systemets standardläge.

rescue

Växla till rescue.target. Normalt stoppas de flesta tjänster och en enkel administrativ miljö startas.

emergency

Växla till emergency.target, ett ännu mer minimalt felsökningsläge.

halt

Stoppa systemet utan att nödvändigtvis stänga av strömmen.

poweroff

Stäng av systemet.

reboot

Starta om systemet.

kexec

Starta om till en redan inläst kärna med kexec.

soft-reboot

Starta om användarutrymmet utan fullständig kärnomstart, om systemet stöder detta.

exit [STATUSKOD]

Be user manager att avsluta. För system manager används detta normalt endast i containrar.

Valfri statuskod kan anges.

switch-root [ROT [INIT]]

Byt till ett annat rotfilsystem och kör angiven init-process.

Används normalt i initrd-fasen.

sleep

Försätt systemet i det sömnläge som systemd väljer som lämpligt.

suspend

Försätt systemet i suspend.

hibernate

Spara minnet till disk och stäng av.

hybrid-sleep

Kombinera suspend och hibernate.

suspend-then-hibernate

Gå först till suspend och senare till hibernate.

Parametersyntax

Unit-kommandon tar antingen ett exakt unit-namn eller ett eller flera mönster.

Om suffix utelämnas lägger systemctl till ett lämpligt suffix, normalt .service.

Exempelvis är:

systemctl start sshd
systemctl start sshd.service

likvärdiga.

För kommandon som endast gäller en viss typ används motsvarande suffix automatiskt. Exempel:

systemctl isolate default
systemctl isolate default.target

Absoluta sökvägar till enhetsnoder konverteras till device-unitnamn. Andra absoluta sökvägar konverteras till mount-unitnamn.

Exempel:

systemctl status /dev/sda
systemctl status dev-sda.device

systemctl status /home
systemctl status home.mount

Globmönster matchas mot primärnamn på units i minnet. Exakta namn refererar alltid till en unit. Mönster som inte matchar något betraktas inte som fel.

Mönstren följer fnmatch(3) och stöder:

*
?
[]

Exempel:

systemctl stop "sshd@*.service"

stoppar alla inlästa instanser av sshd@.service.

Alias och units som inte finns i minnet används inte vid globexpansion.

Unitfilskommandon tar unitnamn eller, där det uttryckligen stöds, absoluta sökvägar.

OPTIONER

Följande optioner stöds.

-t, --type=

Filtrera eller begränsa operationen till vissa unit-typer.

Flera typer kan anges kommaseparerat.

Exempel:

systemctl --type=service
systemctl --type=service,socket

Med värdet help visas stödda typer.

--state=

Filtrera efter LOAD-, ACTIVE- eller SUB-tillstånd.

Flera värden kan anges kommaseparerat.

Exempel:

systemctl --state=failed
systemctl --state=running,exited

Med help visas möjliga tillstånd.

-p, --property=

Begränsa show till angivna egenskaper. Flera egenskaper kan anges kommaseparerat eller genom upprepning.

Om en egenskap anges med tomt värde kan det, beroende på kommando, återställa egenskapen.

-P

Motsvarar:

--value --property=

och visar endast värdet för en egenskap.

-a, --all

Visa även units, egenskaper eller objekt som normalt utelämnas.

Betydelsen varierar något mellan kommandon.

-r, --recursive

Visa även lokala containrar rekursivt där detta är relevant.

--reverse

Visa omvända beroenden, alltså vilka units som är beroende av den angivna uniten.

--after

Visa ordningsberoenden som startas efter den angivna uniten.

--before

Visa ordningsberoenden som startas före uniten.

--with-dependencies

Inkludera beroenden i vissa list- och statusoperationer.

-l, --full

Förkorta inte unitnamn, processrader eller beskrivningar med ellips.

--value

Visa endast värden, inte egenskapsnamn.

--show-types

Visa objekttyp i listor där detta stöds.

--job-mode=

Ange hur ett nytt jobb ska hanteras i förhållande till befintliga jobb.

Vanliga lägen inkluderar:

• fail
• replace
• replace-irreversibly
• isolate
• flush
• ignore-dependencies
• ignore-requirements
• trigger
• restart-dependencies

Visa tillgängliga lägen med:

systemctl --job-mode=help

-T, --show-transaction

Visa transaktionen och de jobb som skulle köas.

--fail

Misslyckas operationen om den begärda åtgärden inte kan utföras utan att ersätta ett befintligt jobb.

--check-inhibitors=

Styr hur inhibitor-lås kontrolleras för avstängning, omstart och sömn.

Typiska värden:

• auto
• yes
• no

-i

Ignorera inhibitor-lås i de systemkommandon där optionen stöds.

--dry-run

Visa eller validera vad som skulle göras utan att utföra operationen, när kommandot stöder detta.

-q, --quiet

Undertryck normal utmatning.

-v, --verbose

Visa mer utförlig information.

--no-warn

Undertryck varningar, exempelvis om aktiva utlösande units.

--no-block

Vänta inte på att köade jobb ska slutföras.

--wait

Vänta på att en operation eller unit ska slutföras, där kommandot stöder detta.

--user

Anslut till den anropande användarens tjänstehanterare.

--system

Anslut till systemets tjänstehanterare. Detta är standard.

--failed

Begränsa listning till misslyckade units.

--no-wall

Skicka inte wall-meddelande före avstängning, omstart eller liknande.

--global

Arbeta med globala användarinställningar som gäller alla användare vid framtida inloggningar.

--no-reload

Läs inte automatiskt om manager-konfigurationen efter ändring av unit-filer.

--kill-whom=

Välj vilka processer som ska få signalen.

Vanliga värden:

• main
• control
• all

--kill-value=HELTAL

Skicka ett värde tillsammans med en POSIX-realtidssignal.

--kill-subgroup=SÖKVÄG

Begränsa signalen till en viss under-cgroup i uniten.

-s, --signal=

Välj signal för kill.

Exempel:

systemctl kill --signal=SIGUSR1 foo.service

--what=

Välj resurser för clean eller andra kommandon.

-f, --force

Tvinga operationen. Den exakta effekten beror på kommandot.

Vid vissa systemkommandon kan upprepad --force kringgå fler säkerhetssteg och därför vara riskfylld.

--message=

Ange ett meddelande som registreras tillsammans med en systemåtgärd.

--now

Tillsammans med enable, disable, mask eller liknande startas eller stoppas uniten omedelbart.

--root=

Arbeta mot ett alternativt rotfilsystem i stället för det körande systemet.

--image=

Arbeta mot en diskavbildning.

--image-policy=

Ange policy för hur partitioner och filsystem i avbildningen ska väljas och valideras.

--runtime

Gör ändringen endast i runtime-konfigurationen under /run. Ändringen försvinner vid omstart.

--preset-mode=

Styr preset och preset-all.

Vanliga lägen:

• full
• enable-only
• disable-only

-n, --lines=

Ange hur många journalrader status ska visa.

-o, --output=

Ange format för journalutdata, enligt journalctl(1).

--firmware-setup

Vid nästa omstart, begär start till firmwareinställningar om detta stöds.

--boot-loader-menu=TIDSGRÄNS

Vid nästa omstart, visa boot loader-menyn under angiven tid.

--boot-loader-entry=ID

Välj en viss boot loader-post för nästa omstart.

--reboot-argument=

Skicka ett argument till reboot-systemanropet eller motsvarande mekanism.

--kernel-cmdline=

Ange eller ändra kärnkommandorad för nästa relevanta startoperation.

--plain

Visa listor utan trädstruktur, färg eller ytterligare grafiska markeringar där detta stöds.

--timestamp=

Välj tidsstämpelformat i utdata.

--mkdir

Skapa målsökvägen vid bind eller mount-image om den saknas.

--read-only

Skapa skrivskyddad bind- eller image-mount.

--drop-in=NAMN

Välj namn på drop-in-filen för edit.

--when=

Schemalägg vissa systemåtgärder till en angiven tidpunkt.

--stdin

Läs nytt innehåll från standardindata, exempelvis för edit.

-H, --host=

Utför operationen på en fjärrvärd via SSH.

Format kan vara:

värd
användare@värd
användare@värd:port
användare@värd/container

IPv6-adresser ska omges av hakparenteser.

-M, --machine=

Utför operationen i en lokal container eller mot en viss användares manager på värden.

-C, --capsule=

Utför operationen i en systemd-capsule.

--no-ask-password

Fråga inte interaktivt efter autentisering för privilegierade operationer.

--no-pager

Skicka inte utdata genom en sidvisare.

--legend=BOOL

Styr om kolumnrubriker och sammanfattningsrader ska visas.

-h, --help

Visa hjälptext och avsluta.

--version

Visa versionsinformation och avsluta.

AVSLUTNINGSSTATUS

Vid framgång returneras 0, annars en felkod som inte är noll.

systemctl använder i vissa sammanhang statuskoder enligt LSB 3.0.0.

Värde	LSB-beskrivning	Användning i systemd
0	Programmet körs eller tjänsten är OK	Uniten är aktiv
1	Programmet är dött och pid-fil finns	Uniten har inte misslyckats, används av is-failed
2	Programmet är dött och låsfil finns	Används inte
3	Programmet körs inte	Uniten är inte aktiv
4	Program- eller tjänstestatus är okänd	Uniten finns inte

Kopplingen mellan LSB-tillstånd och systemd-tillstånd är inte exakt. Skript bör därför helst kontrollera uttryckliga unit-tillstånd och undertillstånd.

MILJÖ

SYSTEMD_EDITOR

Anger editor för systemctl edit.

Om den inte är satt används i tur och ordning lämpliga standardvariabler och editorer.

SYSTEMD_LOG_LEVEL

Anger högsta loggnivå som systemctl ska skriva.

SYSTEMD_LOG_COLOR

Styr färgad loggutmatning.

SYSTEMD_LOG_TIME

Styr om tid ska visas i interna loggmeddelanden.

SYSTEMD_LOG_LOCATION

Styr om källkodsfil och radnummer ska visas.

SYSTEMD_LOG_TARGET

Anger mål för interna loggmeddelanden.

SYSTEMD_PAGER och PAGER

Anger sidvisare.

En tom sträng eller värdet cat kan användas för att stänga av sidvisning.

SYSTEMD_LESS

Anger optioner som skickas till less.

Systemd använder normalt en uppsättning optioner som gör att sidvisaren avslutas direkt om utmatningen ryms på skärmen och behåller färger.

SYSTEMD_LESSCHARSET

Anger teckenuppsättning för less.

SYSTEMD_PAGERSECURE

Styr om sidvisaren ska köras i säkert läge.

När privilegierna skiljer sig från den ursprungliga användaren bör ett säkert pagerläge användas för att förhindra körning av godtyckliga kommandon från sidvisaren.

SYSTEMD_COLORS

Styr färgad utmatning.

SYSTEMD_URLIFY

Styr klickbara terminallänkar.

SE ÄVEN

• systemd(1)
• systemctl(1)
• journalctl(1)
• loginctl(1)
• machinectl(1)
• systemd-run(1)
• systemd.unit(5)
• systemd.service(5)
• systemd.socket(5)
• systemd.timer(5)
• systemd.path(5)
• systemd.target(5)
• systemd.scope(5)
• systemd.slice(5)
• systemd.mount(5)
• systemd.automount(5)
• systemd.device(5)
• systemd.exec(5)
• systemd.kill(5)
• systemd.resource-control(5)
• systemd.preset(5)
• systemd.generator(7)
• org.freedesktop.systemd1(5)
• org.freedesktop.LogControl1(5)

ANMÄRKNINGAR

D-Bus Specification:

https://dbus.freedesktop.org/doc/dbus-specification.html

LSB 3.0.0:

https://refspecs.linuxfoundation.org/LSB_3.0.0/

KOLOFON

Denna sida är en del av projektet systemd, system- och tjänstehanteraren.

Projektinformation:

http://www.freedesktop.org/wiki/Software/systemd

Felrapporter:

http://www.freedesktop.org/wiki/Software/systemd/#bugreports

Sidan hämtades från projektets uppströms Git-förråd:

https://github.com/systemd/systemd.git

den 24 maj 2026.

Vid den tidpunkten var den senaste hittade commiten daterad den 24 maj 2026.

Renderingsproblem eller förbättringar av HTML-versionens kolofon kan rapporteras till:

man-pages@man7.org

KORT PRAKTISK ÖVERSIKT

Visa status:

systemctl status ssh.service

Starta, stoppa och starta om:

systemctl start ssh.service
systemctl stop ssh.service
systemctl restart ssh.service

Aktivera vid uppstart och starta direkt:

systemctl enable --now ssh.service

Inaktivera och stoppa:

systemctl disable --now ssh.service

Visa aktiva tjänster:

systemctl list-units --type=service

Visa installerade unit-filer:

systemctl list-unit-files

Visa misslyckade units:

systemctl --failed

Läs om ändrade unit-filer:

systemctl daemon-reload

Redigera en drop-in:

systemctl edit ssh.service

Visa fullständig unit-konfiguration:

systemctl cat ssh.service

Visa maskinläsbara egenskaper:

systemctl show ssh.service

Visa en egenskap:

systemctl show ssh.service -p MainPID --value

Ändra resursgräns:

systemctl set-property ssh.service MemoryMax=1G

Stäng av eller starta om:

systemctl poweroff
systemctl reboot

Sidslut

Orginalhemsidan på Engelska https://man7.org/linux/man-pages/man1/systemctl.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 Datorhjälp Stockholm som har sponsrat Linux.se med webbhotell.