snd_card_create(9) [suse man page]

SND_CARD_CREATE(9)						   Sound Devices						SND_CARD_CREATE(9)

NAME

       snd_card_create - create and initialize a soundcard structure

SYNOPSIS

       int snd_card_create(int idx, const char * xid, struct module * module, int extra_size, struct snd_card ** card_ret);

ARGUMENTS

       idx
	   card index (address) [0 ... (SNDRV_CARDS-1)]

       xid
	   card identification (ASCII string)

       module
	   top level module for locking

       extra_size
	   allocate this extra size after the main soundcard structure

       card_ret
	   the pointer to store the created card instance

DESCRIPTION

       Creates and initializes a soundcard structure.

       The function allocates snd_card instance via kzalloc with the given space for the driver to use freely. The allocated struct is stored in
       the given card_ret pointer.

       Returns zero if successful or a negative error code.

COPYRIGHT

Kernel Hackers Manual 2.6.					     July 2010							SND_CARD_CREATE(9)

INIT_MODULE(2)						       Linux Module Support						    INIT_MODULE(2)

NAME

       init_module - initialize a loadable module entry

SYNOPSIS

       #include <linux/module.h>

       int init_module(const char *name, struct module *image);

DESCRIPTION

       init_module loads the relocated module image into kernel space and runs the module's init function.

       The  module  image begins with a module structure and is followed by code and data as appropriate.  The module structure is defined as fol-
       lows:

	      struct module
	      {
		unsigned long size_of_struct;
		struct module *next;
		const char *name;
		unsigned long size;
		long usecount;
		unsigned long flags;
		unsigned int nsyms;
		unsigned int ndeps;
		struct module_symbol *syms;
		struct module_ref *deps;
		struct module_ref *refs;
		int (*init)(void);
		void (*cleanup)(void);
		const struct exception_table_entry *ex_table_start;
		const struct exception_table_entry *ex_table_end;
	      #ifdef __alpha__
		unsigned long gp;
	      #endif
	      };

       All of the pointer fields, with the exception of next and refs, are expected to point within the module body and be initialized	as  appro-
       priate for kernel space, i.e. relocated with the rest of the module.

       This system call is only open to the superuser.

RETURN VALUE

       On success, zero is returned.  On error, -1 is returned and errno is set appropriately.

ERRORS

       EPERM  The user is not the superuser.

       ENOENT No module by that name exists.

       EINVAL Some  image slot filled in incorrectly, image->name does not correspond to the original module name, some image->deps entry does not
	      correspond to a loaded module, or some other similar inconsistency.

       EBUSY  The module's initialization routine failed.

       EFAULT name or image is outside the program's accessible address space.

SEE ALSO

       create_module(2), delete_module(2), query_module(2).

Linux 2.1.17							    26 Dec 1996 						    INIT_MODULE(2)