ns_configgetbool(3aolserv) [debian man page]

Ns_Config(3aolserver)					   AOLserver Library Procedures 				     Ns_Config(3aolserver)

__________________________________________________________________________________________________________________________________________________

NAME

       Ns_ConfigGetBool, Ns_ConfigGetInt, Ns_ConfigGetInt64, Ns_ConfigGetPath, Ns_ConfigGetSection, Ns_ConfigGetSections, Ns_ConfigGetValue,
       Ns_ConfigGetValueExact - Extract information from the server configuration files

SYNOPSIS

       #include "ns.h"

       int
       Ns_ConfigGetBool(char *section, char *key, int *valuePtr)

       int
       Ns_ConfigGetInt(char *section, char *key, int *valuePtr)

       int
       Ns_ConfigGetInt64(char *section, char *key, INT64 *valuePtr)

       char *
       Ns_ConfigGetPath(char *server, char *module, ...)

       Ns_Set *
       Ns_ConfigGetSection(char *section)

       Ns_Set **
       Ns_ConfigGetSections(void)

       char *
       Ns_ConfigGetValue(char *section, char *key)

       char *
       Ns_ConfigGetValueExact(char *section, char *key)
_________________________________________________________________

DESCRIPTION

       These functions allow you to extract information from the server config files.

       Ns_ConfigGetBool(section, key, valuePtr)

	      Examines key in section and returns NS_TRUE for values 1, y, yes, on, t, or true, case insensitive, and sets valuePtr to 1.  Returns
	      NS_FALSE for values 0, n, no, off, f, false, case insensitive, and sets valuePtr to 0.

       Ns_ConfigGetInt(section, key, valuePtr)

	      Examines key in section and attempts to convert to an integer value.  On success, returns NS_TRUE, otherwise NS_FALSE. The value	of
	      the integer is placed into valuePtr.

       Ns_ConfigGetInt64(section, key, valuePtr)

	      Like Ns_ConfigGetInt, but with INT64 data instead of system-native int types.  This function isn't available on WIN32.

       Ns_ConfigGetPath(server, module, ...)

	      Get  the full name of a config file section if it exists. Returns a pointer to to an ASCIIZ string of the full path name, or NULL if
	      that path is not in the config file. The server and/or module parameters may be NULL and must be followed a variable list  of  addi-
	      tional parameters, the last element of which must be NULL.

	      Examples:
	      Ns_ConfigGetPath("server1", "nscp", NULL)
	       returns	"ns/server/server1/module/nscp"
	      Ns_ConfigGetPath("server1", "nscp", "users", NULL)
	       returns	"ns/server/server1/module/nscp/users"
	      Ns_ConfigGetPath(NULL, "globalmod", "subsect1", "subsect2", NULL)
	       returns	"ns/module/globalmod/subsect1/subsect2"

       Ns_ConfigGetSection(section)

	      Returns an Ns_Set of the section's parameters, or NULL if the section does not exist.

       Ns_ConfigGetSections()

	      Returns a pointer to an array of pointers to Ns_Sets, one for each config section. The result is a malloc'ed copy of the config sec-
	      tions.

       Ns_ConfigGetValue(section, key)

	      Returns a pointer to the value of the key in section, or NULL if the key doesn't exist.

       Ns_ConfigGetValueExact(section, key)

	      Case sensitive equivalent of Ns_ConfigGetValue.

SEE ALSO

       nsd(1), info(n)

KEYWORDS

AOLserver								4.0						     Ns_Config(3aolserver)

Ns_Pathname(3aolserver) 				   AOLserver Library Procedures 				   Ns_Pathname(3aolserver)

__________________________________________________________________________________________________________________________________________________

NAME

       Ns_HomePath, Ns_LibPath, Ns_MakePath, Ns_ModulePath, Ns_NormalizePath, Ns_PathIsAbsolute - Pathname procedures

SYNOPSIS

       #include "ns.h"

       char *
       Ns_HomePath(Ns_DString *dest, ...)

       char *
       Ns_LibPath(Ns_DString *dest, ...)

       char *
       Ns_MakePath(Ns_DString *dest, ...)

       char *
       Ns_ModulePath(Ns_DString *dest, char *server, char *module, ...)

       char *
       Ns_NormalizePath(Ns_DString *dsPtr, char *path)

       int
       Ns_PathIsAbsolute(char *path)
_________________________________________________________________

DESCRIPTION

       These functions operate on file pathnames. They work with Unix and Windows pathnames on their respective hosts.

       Ns_HomePath(dest, ...)
	      Construct a path name relative to the home directory of the server.  The full path is constructed by appending the library directory
	      followed by each of the variable number of string elements after the dest argument.  The elements will be separated by a	/  charac-
	      ter.  The list must be terminated with a NULL string.

       Ns_LibPath(dest, ...)
	      Construct  a  path  name relative to the library directory of the server, normally the lib/ subdirectory of the home directory.  The
	      full path is constructed by appending the library directory followed by each of the variable number of  string  elements	after  the
	      dest argument.  The elements will be separated by a / character.	The list must be terminated with a NULL string.

       Ns_MakePath(dest, ...)
	      Construct a path name from a list of path elements. The Ns_MakePath function constructs a path name by appending a list of path ele-
	      ments to the given Ns_DString. The path elements are separated by single slashes, and the resulting path name  is  appended  to  the
	      given Ns_DString. The last argument needs to be NULL to indicate the end of the argument list.

       Ns_ModulePath(dest, char *server, char *module, ...)
	      Construct  a server and/or module specific pathname relative to the server home directory.  The path in constructed by first append-
	      ing the server home directory.  Next, if the server argument is not NULL, "server/servere appended to the  destination  and  if  the
	      module  argument is not NULL, "module/module" will be appended.  Finally, all other string elements, if any, will be appended to the
	      destination with separating / characters.  The list must be terminated with a NULL string.

       Ns_NormalizePath(dsPtr, path)
	      Normalize a path name. This function removes any extraneous slashes from the path and resolves "." and ".."  references. The  result
	      is appended to the given Ns_DString. The following code appends "/dog" to the Ns_DString:

	      Ns_NormalizePath(&ds,
		  "/dog/cat/../../rat/../../dog//mouse/..");

       Ns_PathIsAbsolute(path)
	      Check  for an absolute path name. Return NS_TRUE if the path is absolute and NS_FALSE otherwise. Under Unix, an absolute path starts
	      with a "/". On Windows, it starts with a drive letter followed immediately by a ":".

SEE ALSO

       nsd(1), info(n)

KEYWORDS

AOLserver								4.0						   Ns_Pathname(3aolserver)