user-ml

The user-ml program

user-ml automatically creates logging service source directories for longrun services of the user configuration directory. To create the logging service source directories, user-ml uses longrun-make internally.

Interface

     user-ml

user-ml takes no arguments.
It reads the USER environment variable, if it is empty it exits 100.
It reads the USERTREE environment variable, if it is empty it exits 100.
It reads the HOME environment variable, if it is empty it exits 100.
It deletes the ${USERTREE}/src/generated-logger subdirectory of the user configuration subdirectory.
It scans the ${USERTREE}/src subdirectory of the user configuration subdirectory for longrun services.
It checks for each longrun it detects, whether its source directory contains a file no-ml. If this file exits, this longrun is skipped in the subsequent logger generation.
It generates a logging service source directory ${USERTREE}/src/generated-logger/@longrun@-log in parallel for each longrun @longrun@-srv it found in the user configuration subdirectory.

100 if a critical environment variable is missing.
Since user-ml is an execline script, it exits with an approximation of employed program that failed.
user-ml mostly uses execline and s6 software, the exit behaviour of which can be looked up on their respective pages.
See also: execline exit code handling.