MirOS Manual: startuphook_disestablish(9), startuphook_establish(9)

STARTUPHOOK_ESTABLISH(9)      BSD Kernel Manual       STARTUPHOOK_ESTABLISH(9)

NAME

     startuphook_establish, startuphook_disestablish - add or remove a startup
     hook

SYNOPSIS

     #include <sys/types.h>
     #include <sys/systm.h>

     void *
     startuphook_establish(void (*fn)(void *), void *arg);

     void
     startuphook_disestablish(void *cookie);

DESCRIPTION

     The startuphook_establish() function adds fn to the list of hooks invoked
     by dostartuphooks(9) at startup. When invoked, the hook function fn will
     be passed arg as its only argument.

     The startuphook_disestablish() function removes the hook described by the
     opaque pointer cookie from the list of hooks to be invoked at startup. If
     cookie is invalid, the result of startuphook_disestablish() is undefined.

     Startup hooks should be used to perform one-time activities that must
     happen immediately before the root and swap devices are configured, but
     after normal device autoconfiguration.

     Startup hooks are, like shutdown hooks, implemented via the more general
     dohooks(9) API.

RETURN VALUES

     If successful, startuphook_establish() returns an opaque pointer describ-
     ing the newly established startup hook. Otherwise, it returns NULL.

EXAMPLES

     It may be appropriate to use a startup hook to provide potential root or
     swap devices that have delayed configuration. The iop(4) shows an example
     of this usage.

SEE ALSO

     dohooks(9), doshutdownhooks(9), dostartuphooks(9)

BUGS

     The names are clumsy, at best.

MirOS BSD #10-current           July 27, 2001                                1

Generated on 2014-07-04 21:17:45 by $MirOS: src/scripts/roff2htm,v 1.79 2014/02/10 00:36:11 tg Exp $

These manual pages and other documentation are copyrighted by their respective writers; their source is available at our CVSweb, AnonCVS, and other mirrors. The rest is Copyright © 2002‒2014 The MirOS Project, Germany.
This product includes material provided by Thorsten Glaser.

This manual page’s HTML representation is supposed to be valid XHTML/1.1; if not, please send a bug report – diffs preferred.