s6-svdt.html (2515B)
1 <html> 2 <head> 3 <meta name="viewport" content="width=device-width, initial-scale=1.0" /> 4 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> 5 <meta http-equiv="Content-Language" content="en" /> 6 <title>s6: the s6-svdt program</title> 7 <meta name="Description" content="s6: the s6-svdt program" /> 8 <meta name="Keywords" content="s6 command s6-svdt servicedir death tally process supervision s6-supervise" /> 9 <!-- <link rel="stylesheet" type="text/css" href="//skarnet.org/default.css" /> --> 10 </head> 11 <body> 12 13 <p> 14 <a href="index.html">s6</a><br /> 15 <a href="//skarnet.org/software/">Software</a><br /> 16 <a href="//skarnet.org/">skarnet.org</a> 17 </p> 18 19 <h1> The <tt>s6-svdt</tt> program </h1> 20 21 <p> 22 <tt>s6-svdt</tt> prints the recorded death tally of a service, i.e. a list of the times 23 the process died, with the cause of death. 24 </p> 25 26 <h2> Interface </h2> 27 28 <pre> 29 s6-svdt [ -S | -s ] [ -n <em>maxlines</em> ] <em>servicedir</em> 30 </pre> 31 32 <p> 33 <tt>s6-svdt</tt> prints the contents of the recorded death tally of the service being 34 currently supervised at the <em>servicedir</em> 35 <a href="servicedir.html">service directory</a>, then exits 0. 36 </p> 37 38 <p> 39 For each recorded death, s6-svdt prints one line. This line contains the 40 following fields, separated with spaces: 41 </p> 42 43 <ul> 44 <li> A <a href="https://cr.yp.to/daemontools/tai64n.html">TAI64N</a> 45 timestamp .</li> 46 <li> The word "signal" if the death was caused by a signal, or the word 47 "exitcode" if the death was a normal exit. </li> 48 <li> The name of the signal that caused the death, or the exit code 49 of the process. </li> 50 </ul> 51 52 <h2> Options </h2> 53 54 <ul> 55 <li> <tt>-S</tt> : print signal names. This is the default. </li> 56 <li> <tt>-s</tt> : print signal numbers. The numerical value of the signal 57 will be printed instead of the signal name. </li> 58 <li> <tt>-n <em>maxlines</em></tt> : limit the output to at most 59 the latest <em>maxlines</em> deaths. </li> 60 </ul> 61 62 <h2> Exit codes </h2> 63 64 <ul> 65 <li> 0: success </li> 66 <li> 100: wrong usage </li> 67 <li> 111: system call failed </li> 68 </ul> 69 70 <h2> Notes </h2> 71 72 <ul> 73 <li> To obtain human-readable local time or GMT time instead of TAI64N timestamps, 74 simply pipe s6-svdt's output into <a href="s6-tai64nlocal.html">s6-tai64nlocal</a>. </li> 75 <li> Process deaths are recorded up to a default maximum of 100. This default can 76 be modified via the <tt>max-death-tally</tt> file in the 77 <a href="servicedir.html">service directory</a>. </li> 78 </ul> 79 80 </body> 81 </html>