Man page - rc_deptree(3)

Packages contains this manual

Manual


RC_DEPTREE (3) System Manager’s Manual RC_DEPTREE (3)

NAME

rc_deptree_update, rc_deptree_update_needed, rc_deptree_load, rc_deptree_depend, rc_deptree_depends, rc_deptree_order, rc_deptree_free — RC dependency tree functions

LIBRARY

Run Command library (librc, -lrc)

SYNOPSIS

#include <rc.h>

bool

rc_deptree_update ( void );

bool

rc_deptree_update_needed ( void );

RC_DEPTREE

rc_deptree_load ( void );

RC_STRINGLIST *

rc_deptree_depend ( constĀ RC_DEPTREEĀ *deptree , constĀ charĀ *type , constĀ charĀ *service );

bool

rc_deptree_depends ( constĀ RC_DEPTREEĀ *deptree , constĀ charĀ *constĀ *types , constĀ charĀ *constĀ *services , constĀ charĀ *runlevel , intĀ options );

RC_STRINGLIST *

rc_deptree_order ( constĀ RC_DEPTREEĀ *deptree , constĀ charĀ *runlevel , intĀ options );

void

rc_deptree_free ( RC_DEPTREEĀ *deptree );

DESCRIPTION

These functions provide a means of querying the dependencies of OpenRC services.

rc_deptree_update () updates the service dependency tree, normally /run/openrc/deptree . rc_deptree_update_needed () checks to see if the dependency tree needs updated based on the mtime of it compared to /etc/init.d , /etc/conf.d , /usr/local/etc/init.d , /usr/local/etc/conf.d , /etc/rc.conf and any files specified by a service.

rc_deptree_load () loads the deptree and returns a pointer to it which needs to be freed by rc_deptree_free () when done.

rc_deptree_depend (), rc_deptree_depends () and rc_deptree_order () return a list of services from the deptree based on the type or types of dependency. options can be a bitmask of RC_DEP_TRACE and RC_DEP_STRICT . RC_DEP_TRACE follows each services dependencies right down to the first service needed and RC_DEP_STRICT only lists services actually needed or in the runlevel .

IMPLEMENTATION NOTES

Each function that returns RC_STRINGLIST * should be freed by calling rc_stringlist_free () when done.

SEE ALSO

malloc (3), free (3), rc_stringlist_free (3), openrc-run (8)

AUTHORS

Roy Marples <roy@marples.name> OpenRC Mar 16, 2008 RC_DEPTREE (3)