ns_skipurl(3aolserv) [debian man page]

Ns_Url(3aolserver)					   AOLserver Library Procedures 					Ns_Url(3aolserver)

__________________________________________________________________________________________________________________________________________________

NAME

       Ns_AbsoluteUrl, Ns_ParseUrl, Ns_RelativeUrl, Ns_SkipUrl - URL manipulation routines

SYNOPSIS

       #include "ns.h"

       int
       Ns_AbsoluteUrl(Ns_DString *pds, char *url, char *baseurl)

       int
       Ns_ParseUrl(char *url, char **pprotocol, char **phost,
		   char **pport, char **ppath, char **ptail)

       char *
       Ns_RelativeUrl(char *url, char *location)

       char *
       Ns_SkipUrl(Ns_Request *request, int n)
_________________________________________________________________

DESCRIPTION

       Ns_AbsoluteUrl(pds, url, baseurl)

	      Construct an URL based on baseurl but with as many parts of the incomplete url as possible. Return NS_OK or NS_ERROR.

       Ns_ParseUrl(url, pprotocol, phost, pport, ppath, ptail)

	      Parse a URL into its component parts. Pointers to the protocol, host, port, path, and "tail" (last path element) will be set by ref-
	      erence in the passed-in pointers. The passed-in url will be modified.

       Ns_RelativeUrl(url, location)

	      If the url passed in is for this server, then the initial part of the URL is stripped off. e.g.,	on  a  server  whose  location	is
	      http://www.foo.com,  Ns_RelativeUrl  of  "http://www.foo.com/hello" will return "/hello".  Returns a pointer to the beginning of the
	      relative url in the passed-in url, or NULL if error. Will set errno on error.

       Ns_SkipUrl(request, n)

	      Return a pointer n elements into the request's url.

SEE ALSO

       nsd(1), info(n)

KEYWORDS

AOLserver								4.0							Ns_Url(3aolserver)

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)