ns_homepath(3aolserv) [debian man page]

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)

Check Out this Related Man Page

Ns_UrlToFile(3aolserver)				   AOLserver Library Procedures 				  Ns_UrlToFile(3aolserver)

__________________________________________________________________________________________________________________________________________________

NAME

       Ns_SetUrlToFileProc, Ns_UrlIsDir, Ns_UrlIsFile, Ns_UrlToFile - URL to file mapping procedures

SYNOPSIS

       #include "ns.h"

       void
       Ns_SetUrlToFileProc(char *server, Ns_UrlToFileProc *procPtr)

       int
       Ns_UrlIsDir(char *server, char *url)

       int
       Ns_UrlIsFile(char *server, char *url)

       int
       Ns_UrlToFile(Ns_DString *dsPtr, char *server, char *url)
_________________________________________________________________

DESCRIPTION

       These  functions  map  URL paths to real files and directories. They are normally used to determine whether a given URL has a corresponding
       file or directory and to return the real filesystem path that corresponds to the URL.

       Ns_SetUrlToFileProc(server, procPtr)

	      Set a pointer to a custom routine to use in place of Ns_UrlToFile.

       Ns_UrlIsDir(server, url)

	      Construct a directory name by appending the URL to the current AOLserver pages directory for the specified server. Return NS_TRUE if
	      the directory exists; NS_FALSE otherwise.

       Ns_UrlIsFile(server, url)

	      Construct  a file name by appending the URL to the current AOLserver pages directory for the specified server. Return NS_TRUE if the
	      file exists and is a regular file; NS_FALSE otherwise.

	      Example:

	      /* IsFile - Simple request to determine if an URL is a file. */
	      int
	      IsFile(Ns_Conn *conn, void *ctx)
	      {
		  int isfile;
		  char *server;

		  server = Ns_ConnServer(conn);
		  isfile = Ns_UrlIsFile(server, conn->request->url);
		  if (isfile) {
		      Ns_ConnReturnNotice(conn, 200, "File", NULL);
		  } else {
		      Ns_ConnReturnNotice(conn, 200, "Not a File", NULL);
		  }
		  return NS_OK;
	      }

       Ns_UrlToFile(dsPtr, server, url)

	      The Ns_UrlToFile function writes the full path name of the file corresponding to the given  URL.	The  result  is  appended  to  the
	      Ns_DString. The function does not check that the file exists or is readable by the AOLserver process. This function returns a status
	      of NS_OK or NS_ERROR.

	      Normally this prepends the pageroot to the URL path. If you have created your own custom routine	and  used  Ns_SetUrlToFileProc	to
	      point  to  it, your routine is called instead. This could be used to create, for example, a module that takes the given URL and maps
	      it to a file in a different way than the default Ns_UrlToFile routine.

	      Example:

	      /* A simple page fetch request function. */
	      int
	      SimpleFetch(Ns_Conn *conn, void *ctx)
	      {
		  Ns_DString ds;
		  FILE fp;
		  char *server;
		  Ns_DStringInit(&ds);

		  server = Ns_ConnServer(conn);
		  Ns_UrlToFile(&ds, server, conn->request->url);
		  fp = fopen(ds.string, "r");
		  Ns_ConnSendOpenFp(conn, fp, -1);
		  fclose(fp);
		  Ns_DStringFree(&ds);
		  return NS_OK;
	      }

SEE ALSO

       nsd(1), info(n)

KEYWORDS

AOLserver								4.0						  Ns_UrlToFile(3aolserver)

Linux and UNIX Man Pages

ns_homepath(3aolserv) [debian man page]

Check Out this Related Man Page