NAME

rc_runlevel_get, rc_runlevel_exists, rc_runlevel_list, rc_runlevel_set, rc_runlevel_starting, rc_runlevel_stopping — RC runlevel functions

LIBRARY

Run Command library (librc, -lrc)

SYNOPSIS

#include <rc.h>

char *
rc_runlevel_get(void);

bool
rc_runlevel_exists();

RC_STRINGLIST *
rc_runlevel_list(void);

bool
rc_runlevel_set(const char *runlevel);

bool
rc_runlevel_starting(void);

bool
rc_runlevel_stopping(void);

DESCRIPTION

These functions provide a means of querying OpenRC to find out which runlevel we are in and what services are in which runlevel.

IMPLEMENTATION NOTES

Each function that returns char * returns a malloced NULL terminated string that should be freed when done.

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

FILES

/etc/init.d/functions.sh is provided by OpenRC, which allows shell scripts to use the above functions. For historical reasons our verbose functions are prefixed with v instead of suffixed. So einfov becomes veinfo, einfovn becomes veinfon. Rinse and repeat for the other verbose functions.

SEE ALSO

malloc(3), free(3) rc_stringlist_free(3)

AUTHORS

Roy Marples <roy@marples.name>