From 09750ce3525129a676dec4f579aea3ad2eca1b19 Mon Sep 17 00:00:00 2001 From: Laurent Bercot Date: Mon, 9 Jan 2023 11:09:14 +0000 Subject: Add instances implementation (still needs testing) Signed-off-by: Laurent Bercot --- doc/s6-instance-delete.html | 72 +++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 72 insertions(+) create mode 100644 doc/s6-instance-delete.html (limited to 'doc/s6-instance-delete.html') diff --git a/doc/s6-instance-delete.html b/doc/s6-instance-delete.html new file mode 100644 index 0000000..28eca9c --- /dev/null +++ b/doc/s6-instance-delete.html @@ -0,0 +1,72 @@ + + + + + + s6: the s6-instance-delete program + + + + + + +

+s6
+Software
+skarnet.org +

+ +

The s6-instance-delete program

+ +

+s6-instance-delete deletes an existing instance of a currently supervised +instanced service. +

+ +

Interface

+ +

+     s6-instance-delete [ -X ] [ -t timeout ] servicedir name
+

+ +

s6-instance-delete expects a running, supervised +instanced service in servicedir, +as well as an existing instance of this service named name +(it doesn't matter if the instance is up or down).
It deletes the name instance.
It exits 0.

+ +

Exit codes

+ +

0: success
100: wrong usage
111: system call failed

+ +

Options

+ +

-X : don't wait. s6-instance-delete will exit right away, +without waiting for the instance (and its supervisor) to properly disappear.
-t timeout : if the instance supervisor has not exited +after timeout milliseconds, s6-instance-delete will still exit. +By default, timeout is 0, which means no time limit.

+ +

Notes

+ +

s6-instance-delete is similar to +s6-svunlink, because it uses the same underlying +library functions. Under the hood, an instance is a regular service running +on a supervision tree that is specific to the instanced service, and +s6-instance-delete removes a service directory from that tree.
If the template for the service is logged, then s6-instance-delete will +delete both the instance and its logger.

+ + + -- cgit v1.2.3