Ubuntu Manpages

Ns_SetUrlToFileProc, Ns_UrlIsDir, Ns_UrlIsFile, Ns_UrlToFile

URL to file mapping procedures






#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)









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.



  

  

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

  

  

  

    
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.

  

  

  

    
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;
}





  

  

    
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;
}








nsd(1), info(n)