You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@httpd.apache.org by rb...@locus.apache.org on 2000/03/27 21:12:15 UTC
cvs commit: apache-2.0/src/lib/apr/dso/unix dso.c
rbb 00/03/27 11:12:14
Modified: src/lib/apr/dso/unix dso.c
Log:
Fix the docs for DSO handling in APR.
Revision Changes Path
1.3 +21 -36 apache-2.0/src/lib/apr/dso/unix/dso.c
Index: dso.c
===================================================================
RCS file: /home/cvs/apache-2.0/src/lib/apr/dso/unix/dso.c,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- dso.c 2000/03/27 19:02:16 1.2
+++ dso.c 2000/03/27 19:12:13 1.3
@@ -56,15 +56,10 @@
#include "dso.h"
-/*
- * ap_dso_init: Initialize the underlying DSO library
- *
- * Arguments: errstr = Location to store error result on failure.
- *
- * Return values: Returns APR_SUCCESS (on success), and APR_EINIT on failure.
- * on failure, *errstr is valid.
+/* ***APRDOC********************************************************
+ * ap_status_t ap_dso_init(void)
+ * Initialize the underlying DSO library.
*/
-
ap_status_t ap_dso_init(void){
if(lt_dlinit())
return APR_EINIT;
@@ -72,17 +67,14 @@
return APR_SUCCESS;
}
-/*
- * ap_dso_load: Load a DSO library.
- *
- * Arguments: path = Path to the DSO library
- * ctx = Context to use in allocation of the handle.
- * res_handle = Location to store new handle for the DSO
- * errstr = Location to store error string on failure.
- *
- * Return values: Returns APR_SUCCESS on success, else APR_EINIT
+/* ***APRDOC********************************************************
+ * ap_status_t ap_dso_load(ap_dso_handle_t **res_handle, const char *path,
+ * ap_context_t *ctx)
+ * Load a DSO library.
+ * arg 1) Location to store new handle for the DSO.
+ * arg 2) Path to the DSO library
+ * arg 3) Context to use.
*/
-
ap_status_t ap_dso_load(struct dso_handle_t **res_handle, const char *path,
ap_context_t *ctx)
{
@@ -97,15 +89,11 @@
return APR_SUCCESS;
}
-/*
- * ap_dso_unload: Unload a DSO library.
- *
- * Arguments: handle = Handle to unload
- * errstr = Location to store error string on failure.
- *
- * Return values: Returns APR_SUCCESS on success, else APR_EINIT
+/* ***APRDOC********************************************************
+ * ap_status_t ap_dso_unload(ap_dso_handle_t *handle)
+ * Close a DSO library.
+ * arg 1) handle to close.
*/
-
ap_status_t ap_dso_unload(struct dso_handle_t *handle)
{
if(lt_dlclose(handle->handle))
@@ -114,17 +102,14 @@
return APR_SUCCESS;
}
-/*
- * ap_dso_sym: Load a symbol from a DSO handle.
- *
- * Arguments: handle = DSO handle to load from
- * symname = Symbol name to load
- * ressym = Location to store pointer to the symbol
- * errstr = Location to store error string on failure.
- *
- * Return values: Returns APR_SUCCESS on success, else APR_EINIT
+/* ***APRDOC********************************************************
+ * ap_status_t ap_dso_sym(ap_dso_handle_sym_t *ressym, ap_dso_handle_t *handle
+ * const char *symname)
+ * Load a symbol from a DSO handle.
+ * arg 1) Location to store the loaded symbol
+ * arg 2) handle to load from.
+ * arg 3) Name of the symbol to load.
*/
-
ap_status_t ap_dso_sym(ap_dso_handle_sym_t *ressym,
struct dso_handle_t *handle,
const char *symname)