module.h revision 40137
125537Sdfr/*-
225537Sdfr * Copyright (c) 1997 Doug Rabson
325537Sdfr * All rights reserved.
425537Sdfr *
525537Sdfr * Redistribution and use in source and binary forms, with or without
625537Sdfr * modification, are permitted provided that the following conditions
725537Sdfr * are met:
825537Sdfr * 1. Redistributions of source code must retain the above copyright
925537Sdfr *    notice, this list of conditions and the following disclaimer.
1025537Sdfr * 2. Redistributions in binary form must reproduce the above copyright
1125537Sdfr *    notice, this list of conditions and the following disclaimer in the
1225537Sdfr *    documentation and/or other materials provided with the distribution.
1325537Sdfr *
1425537Sdfr * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
1525537Sdfr * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
1625537Sdfr * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
1725537Sdfr * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
1825537Sdfr * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
1925537Sdfr * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
2025537Sdfr * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
2125537Sdfr * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
2225537Sdfr * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
2325537Sdfr * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
2425537Sdfr * SUCH DAMAGE.
2525537Sdfr *
2640137Speter *	$Id: module.h,v 1.3 1998/06/10 10:57:29 dfr Exp $
2725537Sdfr */
2825537Sdfr
2925537Sdfr#ifndef _SYS_MODULE_H_
3025537Sdfr#define _SYS_MODULE_H_
3125537Sdfr
3225537Sdfrtypedef enum {
3325537Sdfr    MOD_LOAD,
3425537Sdfr    MOD_UNLOAD,
3525537Sdfr    MOD_SHUTDOWN
3625537Sdfr} modeventtype_t;
3725537Sdfr
3825537Sdfrstruct module;
3925537Sdfrtypedef struct module *module_t;
4025537Sdfr
4125537Sdfrtypedef int (*modeventhand_t)(module_t mod, modeventtype_t what, void *arg);
4225537Sdfr
4325537Sdfr/*
4425537Sdfr * Struct for registering modules statically via SYSINIT.
4525537Sdfr */
4625537Sdfrtypedef struct moduledata {
4725537Sdfr    char*		name;	/* module name */
4825537Sdfr    modeventhand_t	evhand;	/* event handler */
4925537Sdfr    void*		priv;	/* extra data */
5040137Speter    void*		_file;	/* private; used by linker */
5125537Sdfr} moduledata_t;
5225537Sdfr
5340137Speter#ifdef KERNEL
5440137Speter
5525537Sdfr#define DECLARE_MODULE(name, data, sub, order) \
5636849SdfrSYSINIT(name##module, sub, order, module_register_init, &data) \
5736849Sdfrstruct __hack
5825537Sdfr
5930683Sjmgvoid module_register_init(void *data);
6040137Speterint module_register(const char *name, modeventhand_t callback, void *arg,
6140137Speter		    void *file);
6225537Sdfrmodule_t module_lookupbyname(const char *name);
6325537Sdfrmodule_t module_lookupbyid(int modid);
6425537Sdfrvoid module_reference(module_t mod);
6525537Sdfrvoid module_release(module_t mod);
6625537Sdfrint module_unload(module_t mod);
6725537Sdfrint module_getid(module_t mod);
6825537Sdfrmodule_t module_getfnext(module_t mod);
6925537Sdfr
7025537Sdfr#ifdef MOD_DEBUG
7125537Sdfr
7225537Sdfrextern int mod_debug;
7325537Sdfr#define MOD_DEBUG_REFS	1
7425537Sdfr
7525537Sdfr#define MOD_DPF(cat, args)					\
7625537Sdfr	do {							\
7725537Sdfr		if (mod_debug & MOD_DEBUG_##cat) printf args;	\
7825537Sdfr	} while (0)
7925537Sdfr
8025537Sdfr#else
8125537Sdfr
8225537Sdfr#define MOD_DPF(cat, args)
8325537Sdfr
8425537Sdfr#endif
8525537Sdfr
8625537Sdfr#endif /* KERNEL */
8725537Sdfr
8825537Sdfr#define MAXMODNAME	32
8925537Sdfr
9025537Sdfrstruct module_stat {
9125537Sdfr    int		version;	/* set to sizeof(struct module_stat) */
9225537Sdfr    char	name[MAXMODNAME];
9325537Sdfr    int		refs;
9425537Sdfr    int		id;
9525537Sdfr};
9625537Sdfr
9725537Sdfr#ifndef KERNEL
9825537Sdfr
9925537Sdfr#include <sys/cdefs.h>
10025537Sdfr
10125537Sdfr__BEGIN_DECLS
10225537Sdfrint	modnext(int modid);
10325537Sdfrint	modfnext(int modid);
10425537Sdfrint	modstat(int modid, struct module_stat* stat);
10525537Sdfrint	modfind(char *name);
10625537Sdfr__END_DECLS
10725537Sdfr
10825537Sdfr#endif
10925537Sdfr
11025537Sdfr#endif	/* !_SYS_MODULE_H_ */
111