task.h File Reference

(/usr/bin/git 2025-03-27, commit: 9ebccc0)

Header defining the data structures belonging to a single task and related functions. More...

#include <sys/types.h>
#include <time.h>
#include "confparse.h"
#include "crinit-sdefs.h"
#include "envset.h"
#include "ioredir.h"

Include dependency graph for task.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Data Structures
struct	crinitTaskCmd_t
struct	crinitTaskDep_t
struct	crinitTaskPrv_t
struct	crinitTask_t

Macros
#define	CRINIT_TASK_OPT_RESPAWN   (1 << 0)
#define	CRINIT_TASK_OPT_RESPAWN_DEFAULT   false
#define	CRINIT_TASK_EVENT_RUNNING   "spawn"
#define	CRINIT_TASK_EVENT_DONE   "wait"
#define	CRINIT_TASK_EVENT_FAILED   "fail"
#define	CRINIT_TASK_EVENT_NOTIFY_SUFFIX   "-notified"
#define	crinitTaskForEachDep(task, dep)   for ((dep) = (task)->deps; (dep) != (task)->deps + (task)->depsSize; (dep)++)

Typedefs
typedef unsigned long	crinitTaskOpts_t
typedef enum crinitTaskType_t	crinitTaskType_t
typedef enum crinitTaskTimestampType_t	crinitTaskTimestampType_t
typedef struct crinitTaskCmd_t	crinitTaskCmd_t
typedef struct crinitTaskDep_t	crinitTaskDep_t
typedef struct crinitTaskPrv_t	crinitTaskPrv_t
typedef struct crinitTask_t	crinitTask_t

Enumerations
enum	crinitTaskType_t { CRINIT_TASK_TYPE_STANDARD , CRINIT_TASK_TYPE_INCLUDE }
enum	crinitTaskTimestampType_t { CRINIT_TASK_TS_CREATION , CRINIT_TASK_TS_START , CRINIT_TASK_TS_END }

Functions
int	crinitTaskCreateFromConfKvList (crinitTask_t **out, const crinitConfKvList_t *in)
void	crinitFreeTask (crinitTask_t *t)
void	crinitDestroyTask (crinitTask_t *t)
int	crinitTaskDup (crinitTask_t **out, const crinitTask_t *orig)
int	crinitTaskCopy (crinitTask_t *out, const crinitTask_t *orig)
int	crinitTaskMergeInclude (crinitTask_t *tgt, const char *src, char *importList)

Detailed Description

Header defining the data structures belonging to a single task and related functions.

Macro Definition Documentation

CRINIT_TASK_EVENT_DONE

#define CRINIT_TASK_EVENT_DONE   "wait"

Dependency event that fires when a task reaches the DONE state.

CRINIT_TASK_EVENT_FAILED

#define CRINIT_TASK_EVENT_FAILED   "fail"

Dependency event that fires when a task reaches the FAILED state.

CRINIT_TASK_EVENT_NOTIFY_SUFFIX

#define CRINIT_TASK_EVENT_NOTIFY_SUFFIX   "-notified"

Dependency event suffix to indicate the event needs to be generated by sd-notify.

CRINIT_TASK_EVENT_RUNNING

#define CRINIT_TASK_EVENT_RUNNING   "spawn"

Dependency event that fires when a task reaches the RUNNING state.

CRINIT_TASK_OPT_RESPAWN

#define CRINIT_TASK_OPT_RESPAWN   (1 << 0)

RESPAWN task option bitmask.

CRINIT_TASK_OPT_RESPAWN_DEFAULT

#define CRINIT_TASK_OPT_RESPAWN_DEFAULT   false

Default value for RESPAWN option.

crinitTaskForEachDep

#define crinitTaskForEachDep	(		task,
			dep
	)		for ((dep) = (task)->deps; (dep) != (task)->deps + (task)->depsSize; (dep)++)

Given a crinitTask_t, iterate over all dependencies of this task.

Parameters

task	Pointer to the task.
dep	Pointer to the current dependency.

Typedef Documentation

crinitTask_t

typedef struct crinitTask_t crinitTask_t

Type to store a single task.

crinitTaskCmd_t

typedef struct crinitTaskCmd_t crinitTaskCmd_t

Type to store a single command within a task.

crinitTaskDep_t

typedef struct crinitTaskDep_t crinitTaskDep_t

Type to store a single dependency within a task.

crinitTaskOpts_t

typedef unsigned long crinitTaskOpts_t

Type to store Task option bitmask.

crinitTaskPrv_t

typedef struct crinitTaskPrv_t crinitTaskPrv_t

Type to store a single provided feature within a task.

crinitTaskTimestampType_t

typedef enum crinitTaskTimestampType_t crinitTaskTimestampType_t

The type of a task timestamp.

crinitTaskType_t

typedef enum crinitTaskType_t crinitTaskType_t

The type of the crinit task object.

Enumeration Type Documentation

crinitTaskTimestampType_t

enum crinitTaskTimestampType_t

The type of a task timestamp.

Enumerator
CRINIT_TASK_TS_CREATION	Creation timestamp, i.e. when the task was done loading/parsing.
CRINIT_TASK_TS_START	Start timestamp, i.e. when the first command of the task was last started.
CRINIT_TASK_TS_END	End timestamp, i.e. the last time the task either failed or was completed.

crinitTaskType_t

enum crinitTaskType_t

The type of the crinit task object.

Enumerator
CRINIT_TASK_TYPE_STANDARD	A standard in-memory representation of a task.
CRINIT_TASK_TYPE_INCLUDE	An in-memory representation of an include file after parsing.

Function Documentation

crinitDestroyTask()

void crinitDestroyTask

(

crinitTask_t *

t

)

Frees memory for internal members of an crinitTask_t.

Parameters

t	The task whose members shall be freed.

crinitFreeTask()

void crinitFreeTask

(

crinitTask_t *

t

)

Frees memory associated with an crinitTask created by crinitTaskCreateFromConfKvList() or crinitTaskDup().

Uses crinitDestroyTask() internally and then frees the given pointer.

Parameters

t	Pointer to the crinitTask to free.

crinitTaskCopy()

int crinitTaskCopy	(	crinitTask_t *	out,
		const crinitTask_t *	orig
	)

Copies the conents from one task to another.

Parameters

out	Pointer to copy of orig.
orig	The original task to copy.

Returns

0 on success, -1 on error

crinitTaskCreateFromConfKvList()

int crinitTaskCreateFromConfKvList	(	crinitTask_t **	out,
		const crinitConfKvList_t *	in
	)

Given an crinitConfKvList_t created from a task config, build an equivalent crinitTask.

The crinitTask returned via out is dynamically allocated and should be freed using crinitFreeTask if no longer needed.

Parameters

out	The return pointer for the newly created task.
in	The crinitConfKvList_t from which to build the task.

Returns

0 on success, -1 on error

crinitTaskDup()

int crinitTaskDup	(	crinitTask_t **	out,
		const crinitTask_t *	orig
	)

Duplicates an crinitTask.

The copy returned via out is dynamically allocated and should be freed using crinitFreeTask() if no longer needed.

Parameters

out	Double pointer to return a dynamically allocated copy of orig.
orig	The original task to copy.

Returns

0 on success, -1 on error

crinitTaskMergeInclude()

int crinitTaskMergeInclude	(	crinitTask_t *	tgt,
		const char *	src,
		char *	importList
	)

Merges the options set in a given include file into the target crinitTask_t.

Uses the same parser handlers as regular task files but will fail if configuration options are encountered where crinitConfigMapping_t::includeSafe is false. Optionally a comma-separated importList can be specified. If given, only the configuration options in the list will be merged. If not given, everything in the include file will be imported.

Parameters

tgt	The target crinitTask_t which will be modified.
src	Name of the include file to parse/merge (filename without leading path and ending).
importList	A comma-separated list which configs to merge from the include file. NULL means everything.

Returns

0 on success, -1 on failure