1/* $NetBSD: rf_shutdown.h,v 1.7 2005/12/11 12:23:37 christos Exp $ */
2/*
3 * rf_shutdown.h
4 */
5/*
6 * Copyright (c) 1996 Carnegie-Mellon University.
7 * All rights reserved.
8 *
9 * Author: Jim Zelenka
10 *
11 * Permission to use, copy, modify and distribute this software and
12 * its documentation is hereby granted, provided that both the copyright
13 * notice and this permission notice appear in all copies of the
14 * software, derivative works or modified versions, and any portions
15 * thereof, and that both notices appear in supporting documentation.
16 *
17 * CARNEGIE MELLON ALLOWS FREE USE OF THIS SOFTWARE IN ITS "AS IS"
18 * CONDITION. CARNEGIE MELLON DISCLAIMS ANY LIABILITY OF ANY KIND
19 * FOR ANY DAMAGES WHATSOEVER RESULTING FROM THE USE OF THIS SOFTWARE.
20 *
21 * Carnegie Mellon requests users of this software to return to
22 *
23 * Software Distribution Coordinator or Software.Distribution@CS.CMU.EDU
24 * School of Computer Science
25 * Carnegie Mellon University
26 * Pittsburgh PA 15213-3890
27 *
28 * any improvements or extensions that they make and grant Carnegie the
29 * rights to redistribute these changes.
30 */
31/*
32 * Maintain lists of cleanup functions. Also, mechanisms for coordinating
33 * thread startup and shutdown.
34 */
35
36#ifndef _RF__RF_SHUTDOWN_H_
37#define _RF__RF_SHUTDOWN_H_
38
39#include <dev/raidframe/raidframevar.h>
40
41#include "rf_threadstuff.h"
42
43/*
44 * Important note: the shutdown list is run like a stack, new
45 * entries pushed on top. Therefore, the most recently added
46 * entry (last started) is the first removed (stopped). This
47 * should handle system-dependencies pretty nicely- if a system
48 * is there when you start another, it'll be there when you
49 * shut down another. Hopefully, this subsystem will remove
50 * more complexity than it introduces.
51 */
52
53struct RF_ShutdownList_s {
54 void (*cleanup) (void *arg);
55 void *arg;
56#if RF_DEBUG_SHUTDOWN
57 char *file;
58 int line;
59#endif
60 RF_ShutdownList_t *next;
61};
62#if RF_DEBUG_SHUTDOWN
63#define rf_ShutdownCreate(_listp_,_func_,_arg_) \
64 _rf_ShutdownCreate(_listp_,_func_,_arg_,__FILE__,__LINE__)
65void _rf_ShutdownCreate(RF_ShutdownList_t **, void (*cleanup) (void *),
66 void *, char *, int);
67#else
68#define rf_ShutdownCreate(_listp_,_func_,_arg_) \
69 _rf_ShutdownCreate(_listp_,_func_,_arg_)
70void _rf_ShutdownCreate(RF_ShutdownList_t **, void (*cleanup) (void *),
71 void *);
72#endif
73void rf_ShutdownList(RF_ShutdownList_t **);
74
75#endif /* !_RF__RF_SHUTDOWN_H_ */
76