Dear Rodrigo, The C-API of NaviServer manifests itself through the external function definitions of libnsd other the other core libraries. The best sources are the naviserver/include/ns.h [1] and the source files (e.g. [2]). All public functions are described based on a standardized template (function description, results, side effects). However, so far there is currently no single document, that summarizes the C-API functions.
From my experience, C-developer get around quite well with the existing API descriptions. A good source for usage cases of the C-API are the 49 extra modules from [3], which are mostly written in C. Concerning the possible configuration parameters: NaviServer follows an open model, where the entries of the config files fill a kind of a database, where NaviServer itself or some NaviServer modules or applications (such as OpenACS) can read its config values from it. NaviServer offers in good Tcl tradition an introspection interface that allows you to see, what parameters with what values are currently in use. I would recommend to use the nsstats module [4], which offers a web interface to many of the configuration options and runtime statistics. The valid parameter options and their semantics are described in the various modules, such as e.g. in [5,6] and as well in the provided sample config files (e.g. [7,8]). hope this helps -gn [1] https://bitbucket.org/naviserver/naviserver/src/906257d0d90c8b71d323e61261c6515268397f8b/include/ns.h?at=default&fileviewer=file-view-default#ns.h-611 [2] https://bitbucket.org/naviserver/naviserver/src/906257d0d90c8b71d323e61261c6515268397f8b/nsd/set.c?at=default&fileviewer=file-view-default#set.c-442 [3] https://bitbucket.org/naviserver/ [4] https://bitbucket.org/naviserver/nsstats [5] http://naviserver.sourceforge.net/n/manual/files/admin-db.html#subsection2 [6] http://naviserver.sourceforge.net/n/nssock/files/nssock.html [7] https://bitbucket.org/naviserver/naviserver/src/906257d0d90c8b71d323e61261c6515268397f8b/sample-config.tcl.in?at=default&fileviewer=file-view-default [8] https://bitbucket.org/naviserver/naviserver/src/906257d0d90c8b71d323e61261c6515268397f8b/openacs-config.tcl?at=default&fileviewer=file-view-default Am 12.10.15 um 18:53 schrieb hru...@gmail.com: > Dear Sirs! > > I just installed naviserver and have some questions. I hope this is > the right place. > > http://naviserver.sourceforge.net/n/manual/files/main-features.html > > Speaks about a C api, but I dont find the documentation about it. > Where is it? > > And a much more elementary question about configuration: I dont know > where to get information about what parameters are possible for each > section. For example: what are the configurable parameters for the > section "ns/parameters"? Where I find it in the documentation? > > Thanks > Rodrigo. > ------------------------------------------------------------------------------ _______________________________________________ naviserver-devel mailing list naviserver-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/naviserver-devel
