2020-08-21 19:54:36 +02:00
|
|
|
# SPDX-FileCopyrightText: no
|
|
|
|
# SPDX-License-Identifier: CC0-1.0
|
|
|
|
#
|
2018-01-10 14:58:15 +01:00
|
|
|
# Configuration for the shell process job.
|
|
|
|
#
|
|
|
|
# Executes a list of commands found under the key *script*.
|
|
|
|
# If the top-level key *dontChroot* is true, then the commands
|
|
|
|
# are executed in the context of the live system, otherwise
|
|
|
|
# in the context of the target system. In all of the commands,
|
2018-05-23 15:25:57 +02:00
|
|
|
# the following substitutions will take place:
|
|
|
|
# - `@@ROOT@@` is replaced by the root mount point of the **target**
|
|
|
|
# system from the point of view of the command (for chrooted
|
|
|
|
# commands, that will be */*).
|
|
|
|
# - `@@USER@@` is replaced by the username, set on the user page.
|
2018-01-10 14:58:15 +01:00
|
|
|
#
|
2018-01-29 22:08:12 +01:00
|
|
|
# The (global) timeout for the command list can be set with
|
|
|
|
# the *timeout* key. The value is a time in seconds, default
|
|
|
|
# is 10 seconds if not set.
|
|
|
|
#
|
2018-01-10 14:58:15 +01:00
|
|
|
# If a command starts with "-" (a single minus sign), then the
|
|
|
|
# return value of the command following the - is ignored; otherwise,
|
|
|
|
# a failing command will abort the installation. This is much like
|
|
|
|
# make's use of - in a command.
|
2018-01-29 15:49:21 +01:00
|
|
|
#
|
|
|
|
# The value of *script* may be:
|
|
|
|
# - a single string; this is one command that is executed.
|
2020-10-12 23:11:00 +02:00
|
|
|
# - a single object (this is not useful).
|
|
|
|
# - a list of items; these are executed one at a time, by
|
2018-01-29 15:49:21 +01:00
|
|
|
# separate shells (/bin/sh -c is invoked for each command).
|
2020-10-12 23:11:00 +02:00
|
|
|
# Each list item may be:
|
|
|
|
# - a single string; this is one command that is executed.
|
|
|
|
# - a single object, specifying a key *command* and (optionally)
|
|
|
|
# a key *timeout* to set the timeout for this specific
|
|
|
|
# command differently from the global setting.
|
|
|
|
#
|
|
|
|
# Using a single object is not useful because the same effect can
|
|
|
|
# be obtained with a single string and a global timeout, but when
|
|
|
|
# there are multiple commands to execute, one of them might have
|
|
|
|
# a different timeout than the others.
|
2018-01-10 14:58:15 +01:00
|
|
|
---
|
|
|
|
dontChroot: false
|
2018-01-29 22:08:12 +01:00
|
|
|
timeout: 10
|
2020-10-12 23:11:00 +02:00
|
|
|
|
|
|
|
# Script may be a single string (because false returns an error exit
|
|
|
|
# code, this will trigger a failure in the installation):
|
|
|
|
#
|
|
|
|
# script: "/usr/bin/false"
|
|
|
|
|
|
|
|
# Script may be a list of strings (because false returns an error exit
|
|
|
|
# code, **but** the command starts with a "-", the error exit is
|
|
|
|
# ignored and installation continues):
|
|
|
|
#
|
|
|
|
# script:
|
|
|
|
# - "-/usr/bin/false"
|
|
|
|
# - "/bin/ls"
|
|
|
|
# - "/usr/bin/true"
|
|
|
|
|
|
|
|
# Script may be a lit of items (if the touch command fails, it is
|
|
|
|
# ignored; the slowloris command has a different timeout from the
|
|
|
|
# other commands in the list):
|
2018-01-10 14:58:15 +01:00
|
|
|
script:
|
|
|
|
- "-touch @@ROOT@@/tmp/thingy"
|
2020-10-12 23:11:00 +02:00
|
|
|
- "/usr/bin/true"
|
2018-01-29 22:08:12 +01:00
|
|
|
- command: "/usr/local/bin/slowloris"
|
|
|
|
timeout: 3600
|