From ed9dadb2778ab4ff7683622907e22ed8c561bfda Mon Sep 17 00:00:00 2001 From: Laurent Bercot Date: Mon, 30 Dec 2019 23:27:32 +0000 Subject: Initial commit. --- doc/s6-frontend-config-preprocess.html | 87 ++++++++++++++++++++++++++++++++++ 1 file changed, 87 insertions(+) create mode 100644 doc/s6-frontend-config-preprocess.html (limited to 'doc/s6-frontend-config-preprocess.html') diff --git a/doc/s6-frontend-config-preprocess.html b/doc/s6-frontend-config-preprocess.html new file mode 100644 index 0000000..f58ff7c --- /dev/null +++ b/doc/s6-frontend-config-preprocess.html @@ -0,0 +1,87 @@ + + + + + + s6-frontend: the s6-frontend-config-preprocess program + + + + + + +

+s6
+Software
+skarnet.org +

+ +

The s6-frontend-config-preprocess program

+ +

+ s6-frontend-config-preprocess reads a s6-frontend configuration +file and executes all its inclusion directives, also preprocessing the +included files. It streams the result to stdout, which is a complete +configuration file without inclusions. +

+ +

Interface

+ +
+     s6-frontend-config-preprocess file
+
+ +

+ s6-frontend-config-preprocess reads file and prints it +to stdout. It removes lines starting with !!. +

+ +

+ When it finds a !include or !includeonce directive +in file, it replaces it with the contents of the included +file - recursively preprocessed. +

+ +

+ When it finds a !includedir or !includedironce +directive in file, it replaces it with the recursively +preprocessed contents of every file present in the included +directory. The files are sorted alphabetically according to the +C locale. +

+ +

+ !includeonce and !includedironce only print +a file (resp. a directory) the first time they encounter it, and +silently ignore subsequent instances. !include and +!includedir directives will happily include the same +files several times. +

+ +

+ To avoid loops, a nesting limit exists. s6-frontend-config-preprocess +will fail if there are too many nested inclusions. +

+ +

Exit codes

+ + + +

Notes

+ + + + + -- cgit v1.3.1