modlib.h: Improve comments

This commit is contained in:
YAMAMOTO Takashi 2020-04-06 11:34:33 +09:00 committed by Xiang Xiao
parent a48c784cc4
commit 70b1b51ac9

View File

@ -104,7 +104,7 @@
/* This is the type of the function that is called to uninitialize the /* This is the type of the function that is called to uninitialize the
* the loaded module. This may mean, for example, un-registering a device * the loaded module. This may mean, for example, un-registering a device
* driver. If the module is successfully initialized, its memory will be * driver. If the module is successfully uninitialized, its memory will be
* deallocated. * deallocated.
* *
* Input Parameters: * Input Parameters:
@ -113,7 +113,7 @@
* *
* Returned Value: * Returned Value:
* Zero (OK) on success; a negated errno value on any failure to * Zero (OK) on success; a negated errno value on any failure to
* initialize the module. If zero is returned, then the module memory * uninitialize the module. If zero is returned, then the module memory
* will be deallocated. If the module is still in use (for example with * will be deallocated. If the module is still in use (for example with
* open driver instances), the uninitialization function should fail with * open driver instances), the uninitialization function should fail with
* -EBUSY * -EBUSY
@ -121,10 +121,10 @@
typedef CODE int (*mod_uninitializer_t)(FAR void *arg); typedef CODE int (*mod_uninitializer_t)(FAR void *arg);
/* The contect of this structure is returned by module_initialize(). /* The content of this structure is filled by module_initialize().
* *
* uninitializer - The pointer to the uninitialization function. NULL may * uninitializer - The pointer to the uninitialization function. NULL may
* be returned if no uninitialization is needed (i.e, the * be specified if no uninitialization is needed (i.e, the
* the module memory can be deallocated at any time). * the module memory can be deallocated at any time).
* arg - An argument that will be passed to the uninitialization * arg - An argument that will be passed to the uninitialization
* function. * function.
@ -142,11 +142,11 @@ struct mod_info_s
/* A NuttX module is expected to export a function called module_initialize() /* A NuttX module is expected to export a function called module_initialize()
* that has the following function prototype. This function should appear as * that has the following function prototype. This function should appear as
* the entry point in the ELF module file and will be called by the binfmt * the entry point in the ELF module file and will be called by the loader
* logic after the module has been loaded into kernel memory. * logic after the module has been loaded into memory.
* *
* Input Parameters: * Input Parameters:
* modinfo - Module information returned by modlib_initialize(). * modinfo - Module information to be filled by the initializer.
* *
* Returned Value: * Returned Value:
* Zero (OK) on success; a negated errno value on any failure to * Zero (OK) on success; a negated errno value on any failure to