Man page - start-stop-daemon(8)

Packages contains this manual

Available languages:

en fr pt nl sv de

Manual

start-stop-daemon

NAMN
SYNOPS
BESKRIVNING
KOMMANDON
FLAGGOR
Matchingsflaggor
Generiska flaggor
RETURVÄRDE
EXEMPEL
ÖVERSÄTTNING

NAMN

start-stop-daemon - startar och stoppar bakgrundsprocesser

SYNOPS

start-stop-daemon [ flagga ...] ÄtgÀrd

BESKRIVNING

start-stop-daemon anvÀnds för att styra hur processer pÄ systemnivÄ skapas och avslutas. Med hjÀlp av en av sökflaggorna kan start-stop-daemon stÀllas in att hitta befintliga instanser av en körande process.

Observera : Om inte --pid eller --pidfile anges kommer start-stop-daemon att jobba pÄ ett sÀtt som liknar killall (1). start-stop-daemon kommer att söka i processtabellen efter processer med motsvarande namn pÄ processen, anvÀndar-id och/eller grupp-id (om sÄdant anges). Alla processer som stÀmmer överens kommer tillsÀndas signalen TERM (eller den som anges med --signal eller --retry ) om --stop anges. För processer som har lÄnglivade barn som mÄste överleva en --stop , mÄste du ange en pidfil.

KOMMANDON

-S , --start [ -- ] argument

Se om en angiven process existerar, och om sÄ Àr fallet gör start-stop-daemon ingenting och avslutar med status 1 (0 om --oknodo anges). Om en sÄdan process inte existerar startas en instans, antingen med programfilen som anges med --exec eller, om den anges, med --startas . Eventuella argument som ges efter -- pÄ kommandoraden skickas utan Àndring till programmet som startas.

-K , --stop

Testa om den angivna processen existerar. Om sÄ Àr fallet sÀnder start-stop-daemon den signal som anges av --signal till processen, och avslutar med status 0. Om processen inte finns avslutar start-stop-daemon med status 1 (0 om --oknodo anges). Om --retry anges kommer start-stop-daemon kontrollera att processen har avslutats.

-T , --status

Se om den angivna processen existerar, och returnerar en statuskod i enlighet med LBS Init Script Actions (sedan version 1.16.1).

-H , --help

Visa hjÀlpskÀrm och avsluta.

-V , --version

Visa programversion och avsluta.

FLAGGOR

Matchingsflaggor

--pid pid

Se efter en process med angiven pid (sedan version 1.17.6). pid mÄste vara ett tal större Àn 0.

--ppid ppid

Se efter en process med angiven förÀldra-pid ppid (sedan version 1.17.7). ppid mÄste vara ett tal större Àn 0.

-p , --pidfile pidfil

Kontrollera om en process har skapat filen pidfil .

Observera : Om flaggan anvÀnds pÄ egen hand kan den orsaka att oönskade processer berörs, om den gamla processen avslutats utan att kunna ta bort pidfil .

Varning : Om flaggan anvÀnds med en pidfil som kan skrivas av alla eller om den anvÀnds ensam tillsammans med en serverprocess som skriver pidfilen som en icke-privilegierad anvÀndare (icke-root) kommer det att avvisas med ett felmeddelande (sedan version 1.19.3) eftersom det Àr en sÀkerhetsrisk, dÄ antingen alla anvÀndare kan skriva filen, eller om serverprocessen komprometteras och inte innehÄllet i pidfilen inte Àr betrott, sÄ kan en privilegiserad körprocess (till exempel ett init-skript som körs som root) kunna arbeta mot vilken som helst systemprocess. /dev/null Àr undantaget frÄn dessa kontroller.

-x , --exec programfil

Se efter processer som Àr instanser av programfil . Flaggan programfil bör vara en absolut sökvÀg.

Observera : Detta fungerar kanske inte som det ska för tolkade skript eftersom programfilen kommer peka pÄ tolken. Notera att processer som körs inuti en chroot ocksÄ kommer att trÀffas, sÄ andra begrÀnsningar kan behövas.

-n , --name processnamn

Se efter processer med namnet processnamn . Processnamn Àr vanligtvis processens filnamn, men kan ha Àndrats av processen sjÀlv.

Observera : PÄ de flesta system hÀmtas informationen frÄn processens comm-namn frÄn kÀrnan, vilket ofta har en relativt kort lÀngdbegrÀnsning (det Àr inte portablet att anta fler Àn 15 tecken).

-u , --user anvÀndarnamn | anvÀndar-id

Sök efter processer som Àgs av den anvÀndare som anges med anvÀndarnamn eller anvÀndar-id .

Observera : Om den hÀr flaggan anvÀnds pÄ egen hand trÀffas alla processer som motsvarar anvÀndaren.

Generiska flaggor

-g , --group grupp | grupp-id

Byt till grupp eller grupp-id nÀr processen startas.

-s , --signal signal

Tillsammans med --stop anger detta den signal som ska sÀndas till processen som stoppas (förval Àr TERM).

-R , --retry tidsgrÀns | schema

Tillsammans med --stop anger detta att start-stop-daemon ska kontrollera att processen avslutas. Den testar flera gÄnger efter matchande processer som körs, tills ingen lÀngre finns kvar. Om processerna inte avslutar kommer programmet utföra ytterligare kommandon enligt schemat.

Om tidsgrÀns anges istÀllet för schema kommer schemat signal / timeout /KILL/ timeout att anvÀndas, dÀr signal Àr den signal som anges med --signal .

schema Àr den lista med Ätminstone tvÄ poster avdelade med snedstreck ( / ); varje post Àr antingen - signalnummer eller [ - ] signalnamn , vilket betyder att signalen ska sÀndas, eller timeout , vilket anger det antal sekunder programmet ska vÀnta pÄ att processen avslutar, eller forever , vilket betyder att resten av schemat ska repetera för evigt om sÄ behövs.

Om slutet pÄ schemat nÄs och forever inte anges kommer start-stop-daemon avslutas med felkod 2. Om ett schema anges kommer eventuell signal angiven med --signal att ignoreras.

-a , --startas sökvÀg

Tillsammans med --start anger detta att processen som anges med sökvÀg ska startas. Om den inte anges anvÀnds argumentet som gavs till --exec .

-t , --test

Skriver ut vad som skulle ha utförts och sÀtter returvÀrdet, men utför ingenting.

-o , --oknodo

Returnerar felstatus 0 i stÀllet för 1 om ingen ÄtgÀrd utförs/skulle utförts.

-q , --quiet

Skriv inte informationsmeddelanden; visa endast felmeddelanden.

-c , --chuid anvÀndarnamn | anvÀndar-id [ : grupp | grupp-id ]

Byt till anvÀndarnamnet/anvÀndar-id:t innan processen startas. Du kan Àven ange en grupp genom att lÀgga till ett kolontecken, : , följt av gruppnamnet eller grupp-id pÄ samma sÀtt som du skull gjort till kommandot chown (1) ( anvÀndare : grupp ). Om du anger en anvÀndare utan att ange en grupp kommer anvÀndarens primÀra grupp-id att anvÀndas. NÀr du anvÀnder alternativet mÄste du ha i Ätanke att Àven bÄde primÀr- och tillÀggsgrupp sÀtts, Àven om --group -flaggan inte anges. --group -flaggan Àr bara till för grupper som anvÀndaren normalt inte Àr en medlem i (t.ex för att lÀgga till gruppmedlemskap för enskilda processer för standardanvÀndare sÄsom nobody ).

-r , --chroot rot

Byt katalog och rot till rot innan processen startas. Observera att Àven pidfilen skrivs efter chroot har utförts.

-d , --chdir sökvÀg

Byt katalog till sökvÀg innan processen startas. Detta görs efter byte av rot om -r | --chroot -flaggan anges. Om flaggan inte anges kommer start-stop-daemon byta till rotkatalogen innan processen startas.

-b , --background

AnvÀnds typiskt med program som inte kopplar loss sig av sig sjÀlva. Flaggan tvingar start-stop-daemon att förgrena sig (fork) innan processen startar, och tvinga den grenen att köra i bakgrunden.

Varning : start-stop-daemon kan inte kontrollera felstatus för processer som av nÄgon som helst anledning misslyckas med att exekvera. Detta Àr en sista utvÀg, och Àr endast avsett för program som det antingen inte Àr nÄgon mening att förgrena pÄ egen hand, eller dÀr det inte Àr möjligt att lÀgga till kod för det pÄ egen hand.

--notify-await

VÀnta pÄ att bakgrundsprocessen sÀnder en bekrÀftelse pÄ att den Àr redo innan tjÀnsten anses vara startad (sedan version 1.19.3). Detta implementar delar av systemd:s beredskapsprotokoll, sÄ som det anges i manualsidan sd_notify (3). Följande variabler stöds:
READY=1

Programmet Àr redo att tillhandahÄlla sin tjÀnst, sÄ vi kan avsluta pÄ ett sÀkert sÀtt.

EXTEND_TIMEOUT_USEC= antal

Programmet ber om att utöka tidsgrÀnsen med antal mikrosekunder. Detta kommer ÄterstÀlla den aktuella tidsgrÀnsen till det angivna vÀrdet.

ERRNO= vÀrde

Programmet avslutar med en felkod. Gör detsamma och skriv ut den anvÀndarvÀnliga strÀngen för errno -vÀrdet.

--notify-timeout tidsgrÀns

SÀtt en tidsgrÀns för flaggan --notify-await (sedan version 1.19.3). NÀr tidsgrÀnsen nÄs kommer start-stop-daemon avslutas med en felkod, och ingen beredskapsinformation kommer vÀntas pÄ. Förvalet Àr 60 sekunder.

-C , --no-close

StÀng inte filbeskrivare nÀr serverprocessen tvingas till bakgrunden (sedan version 1.16.5). AnvÀnd för felsöknignssyften för att se processutdata, eller för att omdirigera filbeskrivare för att logga processutdata. Endast relevant nÀr --background anvÀnds.

-O , --output sökvÀg

Omdirigera standard ut och standard fel till sökvÀg nÀr serverprocessen tvingas till bakgrunden (sedan version 1.20.6). Endast relevant nÀr --background anvÀnds.

-N , --nicelevel heltal

Ändrar prioriteten pĂ„ processen innan den startas.

-P , --procsched policy : prioritet

Ändrar processschemalĂ€ggarens policy och prioritet för processen innan den startas (sedan version 1.15.0). Prioriteten Ă€r valfri och anges genom att lĂ€gga till ett : följt av vĂ€rdet. StandardvĂ€rdet för prioritet Ă€r 0. För nĂ€rvarande stöds vĂ€rdena other , fifo och rr för policy .

Det Àr möjligt att flaggan inte gör nÄgot pÄ system dÀr POSIX-processschemalÀggning inte stöds.

-I , --iosched klass : prioritet

Ändrar I/O-schemalĂ€ggarens klass och -prioritet för processen innan den startas (sedan version 1.15.0). Prioriteten Ă€r valfri och anges genom att lĂ€gga till ett : följt av vĂ€rdet. StandardvĂ€rdet för prioritet Ă€r 4, sĂ„vida inte klass Ă€r idle , dĂ„ Ă€r prioritet alltid 7. För nĂ€rvarande stöds vĂ€rdena idle , best-effort och real-time för klass .

Det Àr möjligt att flaggan inte gör nÄgot pÄ system dÀr Linux-I/O-schemalÀggning inte stöds.

-k , --umask maskvÀrde

StÀller in umaskvÀrdet pÄ processen innan den startas (sedan version 1.13.22).

-m , --make-pidfile

AnvÀnds nÀr ett program som inte skapar sin egen pidfil startas. Flaggan kommer att fÄ start-stop-daemon att skapa filen som anges med --pidfile och lÀgga process-id i den precis innan processen startas. Observera att den endast kommer att tas bort nÀr programmet stoppas om --remove-pidfile anvÀnds.

Observera : Funktionen kanske inte alltid fungerar. Framförallt inte nÀr programmet som startas förgrenar sig (fork) frÄn sin huvudprocess. DÀrför Àr flaggan oftast bara anvÀndbar i samband med flaggan --background .

--remove-pidfile

AnvÀnds nÀr ett program som inte tar bort sin egen pid-fil stoppas (sedan version 1.17.19). Flaggan gör att start-stop-daemon tar bort filen som anges med --pidfile efter att processen stoppats.

-v , --verbose

Skriv ut pratsamma informationsmeddelanden.

RETURVÄRDE

0

EfterfrÄgad ÄtgÀrd utfördes. Om --oknodo angavs Àr det Àven möjligt att ingenting behövde utföras. Det kan hÀnda nÀr --start angavs och en motsvarande process redan körde, eller nÀr --stop angavs och det inte fanns nÄgon motsvarande process.

1

Om --oknodo inte angavs och ingenting gjordes.

2

Om --stop och --retry angavs, men slutet pÄ tidtabellen nÄddes och processen fortfarande kördes.

3

Alla andra fel.

Med --status -ÄtgÀrden returneras följande statuskoder:

0

Programmet kör.

1

Programmet kör inte och pid-filen finns.

3

Programmet kör inte.

4

Kan inte ta reda pÄ programmets status.

EXEMPEL

Starta serverprocessen food , sÄvida inte en redan kör (en process med namnet food, som körs som anvÀndaren food, med process-id i food.pid):

start-stop-daemon --start --oknodo --user food --name food \
--pidfile /run/food.pid --startas /usr/sbin/food \
--chuid food -- --daemon

SÀnd SIGTERM till food och vÀnta upp till fem sekunder pÄ att den ska avslutas:

start-stop-daemon --stop --oknodo --user food --name food \
--pidfile /run/food.pid --retry 5

Demonstration av ett skrÀddarsytt schema för att avsluta food :

start-stop-daemon --stop --oknodo --user food --name food \
--pidfile /run/food.pid --retry=TERM/30/KILL/5

ÖVERSÄTTNING

Peter Krefting och Daniel Nylander.