]> git.cameronkatri.com Git - mandoc.git/blobdiff - cgi.c
If no man.cgi `whatis' results are found, offer a quick link to the apropos
[mandoc.git] / cgi.c
diff --git a/cgi.c b/cgi.c
index b6ded9ff57af692fc3661877d0cae19a79c7fd79..755318b94d83c6c95b0ccc1fed18e93b8fcd54cc 100644 (file)
--- a/cgi.c
+++ b/cgi.c
-/*     $Id: cgi.c,v 1.4 2011/11/13 10:49:57 schwarze Exp $ */
+/*     $Id: cgi.c,v 1.19 2011/12/08 22:47:09 kristaps Exp $ */
+/*
+ * Copyright (c) 2011 Kristaps Dzonsons <kristaps@bsd.lv>
+ *
+ * Permission to use, copy, modify, and distribute this software for any
+ * purpose with or without fee is hereby granted, provided that the above
+ * copyright notice and this permission notice appear in all copies.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+ * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+ * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+ * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+ * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+ */
+#ifdef HAVE_CONFIG_H
+#include "config.h"
+#endif
+
+#include <sys/param.h>
+#include <sys/wait.h>
+
 #include <assert.h>
+#include <ctype.h>
+#include <errno.h>
 #include <fcntl.h>
+#include <limits.h>
 #include <regex.h>
 #include <stdio.h>
 #include <stdarg.h>
+#include <stdint.h>
 #include <stdlib.h>
 #include <string.h>
+#include <unistd.h>
 
-#include "mandoc.h"
-#include "mandocdb.h"
 #include "apropos_db.h"
+#include "mandoc.h"
+#include "mdoc.h"
+#include "man.h"
+#include "main.h"
+#include "manpath.h"
+
+#ifdef __linux__
+# include <db_185.h>
+#else
+# include <db.h>
+#endif
 
-/*
- * The page a request is trying to make.
- */
 enum   page {
        PAGE_INDEX,
        PAGE_SEARCH,
+       PAGE_SHOW,
        PAGE__MAX
 };
 
-/*
- * Key-value pair.  
- * Both key and val are on the heap.
- */
 struct kval {
        char            *key;
        char            *val;
 };
 
-/*
- * The media type, determined by suffix, of the requesting or responding
- * context.
- */
-enum   media {
-       MEDIA_HTML,
-       MEDIA__MAX
-};
-
-/*
- * An HTTP request.
- */
 struct req {
-       struct kval     *fields; /* query fields */
+       struct kval     *fields;
        size_t           fieldsz;
-       enum media       media;
        enum page        page;
 };
 
-#if 0
-static void             html_printtext(const char *);
-#endif
+static int              atou(const char *, unsigned *);
+static void             catman(const char *);
+static int              cmp(const void *, const void *);
+static void             format(const char *);
+static void             html_print(const char *);
+static void             html_putchar(char);
 static int              kval_decode(char *);
 static void             kval_parse(struct kval **, size_t *, char *);
 static void             kval_free(struct kval *, size_t);
-static void             pg_index(const struct req *, char *);
-static void             pg_search(const struct req *, char *);
-#if 0
-static void             pg_searchres(struct rec *, size_t, void *);
-#endif
+static void             pg_index(const struct manpaths *,
+                               const struct req *, char *);
+static void             pg_search(const struct manpaths *,
+                               const struct req *, char *);
+static void             pg_show(const struct manpaths *,
+                               const struct req *, char *);
+static void             resp_bad(void);
+static void             resp_baddb(void);
+static void             resp_error400(void);
+static void             resp_error404(const char *);
+static void             resp_begin_html(int, const char *);
+static void             resp_begin_http(int, const char *);
+static void             resp_end_html(void);
+static void             resp_index(const struct req *);
+static void             resp_search(struct res *, size_t, void *);
+static void             resp_searchform(const struct req *);
+
+static const char       *progname;
+static const char       *cache;
+static const char       *host;
 
 static const char * const pages[PAGE__MAX] = {
        "index", /* PAGE_INDEX */ 
        "search", /* PAGE_SEARCH */
+       "show", /* PAGE_SHOW */
 };
 
-static const char * const medias[MEDIA__MAX] = {
-       "html", /* MEDIA_HTML */
-};
+/*
+ * This is just OpenBSD's strtol(3) suggestion.
+ * I use it instead of strtonum(3) for portability's sake.
+ */
+static int
+atou(const char *buf, unsigned *v)
+{
+       char            *ep;
+       long             lval;
+
+       errno = 0;
+       lval = strtol(buf, &ep, 10);
+       if (buf[0] == '\0' || *ep != '\0')
+               return(0);
+       if ((errno == ERANGE && (lval == LONG_MAX || 
+                                       lval == LONG_MIN)) ||
+                       (lval > UINT_MAX || lval < 0))
+               return(0);
+
+       *v = (unsigned int)lval;
+       return(1);
+}
 
-#if 0
 static void
-html_printtext(const char *p)
+html_putchar(char c)
 {
-       char             c;
 
+       switch (c) {
+       case ('"'):
+               printf("&quote;");
+               break;
+       case ('&'):
+               printf("&amp;");
+               break;
+       case ('>'):
+               printf("&gt;");
+               break;
+       case ('<'):
+               printf("&lt;");
+               break;
+       default:
+               putchar((unsigned char)c);
+               break;
+       }
+}
+
+/*
+ * Print a word, escaping HTML along the way.
+ * This will pass non-ASCII straight to output: be warned!
+ */
+static void
+html_print(const char *p)
+{
+       
+       if (NULL == p)
+               return;
        while ('\0' != *p)
-               switch ((c = *p++)) {
-               case ('"'):
-                       printf("&quote;");
-                       break;
-               case ('&'):
-                       printf("&amp;");
-                       break;
-               case ('>'):
-                       printf("&gt;");
-                       break;
-               case ('<'):
-                       printf("&lt;");
-                       break;
-               default:
-                       putchar((unsigned char)c);
-                       break;
-               }
+               html_putchar(*p++);
 }
-#endif
 
 static void
 kval_free(struct kval *p, size_t sz)
@@ -110,7 +175,8 @@ kval_free(struct kval *p, size_t sz)
 
 /*
  * Parse out key-value pairs from an HTTP request variable.
- * This can be either a cookie or a POST/GET string.
+ * This can be either a cookie or a POST/GET string, although man.cgi
+ * uses only GET for simplicity.
  */
 static void
 kval_parse(struct kval **kv, size_t *kvsz, char *p)
@@ -171,9 +237,9 @@ kval_parse(struct kval **kv, size_t *kvsz, char *p)
 }
 
 /*
- * In-place HTTP-decode a string.  The standard explanation is that this
- * turns "%4e+foo" into "n foo" in the regular way.  This is done
- * in-place over the allocated string.
+ * HTTP-decode a string.  The standard explanation is that this turns
+ * "%4e+foo" into "n foo" in the regular way.  This is done in-place
+ * over the allocated string.
  */
 static int
 kval_decode(char *p)
@@ -204,51 +270,603 @@ kval_decode(char *p)
        return(1);
 }
 
+static void
+resp_begin_http(int code, const char *msg)
+{
+
+       if (200 != code)
+               printf("Status: %d %s\n", code, msg);
+
+       puts("Content-Type: text/html; charset=utf-8"           "\n"
+            "Cache-Control: no-cache"                          "\n"
+            "Pragma: no-cache"                                 "\n"
+            "");
+
+       fflush(stdout);
+}
 
-/* ARGSUSED */
 static void
-pg_index(const struct req *req, char *path)
+resp_begin_html(int code, const char *msg)
 {
 
+       resp_begin_http(code, msg);
+
+       puts("<!DOCTYPE HTML PUBLIC "                           "\n"
+            " \"-//W3C//DTD HTML 4.01//EN\""                   "\n"
+            " \"http://www.w3.org/TR/html4/strict.dtd\">"      "\n"
+            "<HTML>"                                           "\n"
+            " <HEAD>"                                          "\n"
+            "  <META HTTP-EQUIV=\"Content-Type\" "             "\n"
+            "        CONTENT=\"text/html; charset=utf-8\">"    "\n"
+            "  <LINK REL=\"stylesheet\" HREF=\"/man.cgi.css\"" "\n"
+            "        TYPE=\"text/css\" media=\"all\">"         "\n"
+            "  <TITLE>System Manpage Reference</TITLE>"        "\n"
+            " </HEAD>"                                         "\n"
+            " <BODY>"                                          "\n"
+            "<!-- Begin page content. //-->");
 }
 
-#if 0
 static void
-pg_searchres(struct rec *recs, size_t sz, void *arg)
+resp_end_html(void)
 {
-       int              i;
-       const char      *pg;
 
-       if (NULL == (pg = getenv("SCRIPT_NAME")))
-               pg = "";
+       puts(" </BODY>\n</HTML>");
+}
+
+static void
+resp_searchform(const struct req *req)
+{
+       int              i;
+       const char      *expr, *sec, *arch;
+
+       expr = sec = arch = "";
+
+       for (i = 0; i < (int)req->fieldsz; i++)
+               if (0 == strcmp(req->fields[i].key, "expr"))
+                       expr = req->fields[i].val;
+               else if (0 == strcmp(req->fields[i].key, "query"))
+                       expr = req->fields[i].val;
+               else if (0 == strcmp(req->fields[i].key, "sec"))
+                       sec = req->fields[i].val;
+               else if (0 == strcmp(req->fields[i].key, "sektion"))
+                       sec = req->fields[i].val;
+               else if (0 == strcmp(req->fields[i].key, "arch"))
+                       arch = req->fields[i].val;
+
+       if (NULL != sec && 0 == strcmp(sec, "0"))
+               sec = NULL;
+
+       puts("<!-- Begin search form. //-->");
+       printf("<FORM ACTION=\"");
+       html_print(progname);
+       printf("/search.html\" METHOD=\"get\">\n");
+       printf("<FIELDSET>\n"
+              "<LEGEND>Search Parameters</LEGEND>\n"
+              "<INPUT TYPE=\"submit\" NAME=\"op\" "
+               "VALUE=\"Whatis\"> or \n"
+              "<INPUT TYPE=\"submit\" NAME=\"op\" "
+               "VALUE=\"apropos\"> for manuals satisfying \n"
+              "<INPUT TYPE=\"text\" NAME=\"expr\" VALUE=\"");
+       html_print(expr);
+       printf("\">, section "
+              "<INPUT TYPE=\"text\" "
+               "SIZE=\"4\" NAME=\"sec\" VALUE=\"");
+       html_print(sec);
+       printf("\">, arch "
+              "<INPUT TYPE=\"text\" "
+               "SIZE=\"8\" NAME=\"arch\" VALUE=\"");
+       html_print(arch);
+       puts("\">.\n"
+            "<INPUT TYPE=\"reset\" VALUE=\"Reset\">\n"
+            "</FIELDSET>\n"
+            "</FORM>\n"
+            "<!-- End search form. //-->");
+}
+
+static void
+resp_index(const struct req *req)
+{
+
+       resp_begin_html(200, NULL);
+       resp_searchform(req);
+       resp_end_html();
+}
+
+static void
+resp_error400(void)
+{
+
+       resp_begin_html(400, "Query Malformed");
+       printf("<H1>Malformed Query</H1>\n"
+              "<P>\n"
+              "  The query your entered was malformed.\n"
+              "  Try again from the\n"
+              "  <A HREF=\"%s/index.html\">main page</A>\n"
+              "</P>", progname);
+       resp_end_html();
+}
+
+static void
+resp_error404(const char *page)
+{
+
+       resp_begin_html(404, "Not Found");
+       puts("<H1>Page Not Found</H1>\n"
+            "<P>\n"
+            "  The page you're looking for, ");
+       printf("  <B>");
+       html_print(page);
+       printf("</B>,\n"
+              "  could not be found.\n"
+              "  Try searching from the\n"
+              "  <A HREF=\"%s/index.html\">main page</A>\n"
+              "</P>", progname);
+       resp_end_html();
+}
+
+static void
+resp_bad(void)
+{
+       resp_begin_html(500, "Internal Server Error");
+       puts("<P>Generic badness happened.</P>");
+       resp_end_html();
+}
+
+static void
+resp_baddb(void)
+{
+
+       resp_begin_html(500, "Internal Server Error");
+       puts("<P>Your database is broken.</P>");
+       resp_end_html();
+}
+
+static void
+resp_search(struct res *r, size_t sz, void *arg)
+{
+       int              i, whatis;
+       const char      *ep, *sec, *arch;
+       const struct req *req;
+
+       whatis = 1;
+       ep = sec = arch = NULL;
+
+       if (1 == sz) {
+               /*
+                * If we have just one result, then jump there now
+                * without any delay.
+                */
+               puts("Status: 303 See Other");
+               printf("Location: http://%s%s/show/%u/%u.html\n",
+                               host, progname,
+                               r[0].volume, r[0].rec);
+               puts("Content-Type: text/html; charset=utf-8\n");
+               return;
+       }
+
+       req = (const struct req *)arg;
+
+       for (i = 0; i < (int)req->fieldsz; i++)
+               if (0 == strcmp(req->fields[i].key, "expr"))
+                       ep = req->fields[i].val;
+               else if (0 == strcmp(req->fields[i].key, "query"))
+                       ep = req->fields[i].val;
+               else if (0 == strcmp(req->fields[i].key, "sec"))
+                       sec = req->fields[i].val;
+               else if (0 == strcmp(req->fields[i].key, "sektion"))
+                       sec = req->fields[i].val;
+               else if (0 == strcmp(req->fields[i].key, "arch"))
+                       arch = req->fields[i].val;
+               else if (0 == strcmp(req->fields[i].key, "apropos"))
+                       whatis = 0 == strcmp
+                               (req->fields[i].val, "0");
+               else if (0 == strcmp(req->fields[i].key, "op"))
+                       whatis = 0 == strcasecmp
+                               (req->fields[i].val, "whatis");
+
+       qsort(r, sz, sizeof(struct res), cmp);
+
+       resp_begin_html(200, NULL);
+       resp_searchform(req);
+
+       if (0 == sz) {
+               puts("<P>\n"
+                    "No results found.");
+               if (whatis) {
+                       printf("(Try <A HREF=\"");
+                       html_print(progname);
+                       printf("/search.html?op=apropos&amp;expr=");
+                       html_print(ep ? ep : "");
+                       printf("&amp;sec=");
+                       html_print(sec ? sec : "");
+                       printf("&amp;arch=");
+                       html_print(arch ? arch : "");
+                       puts("\">apropos</A>?)");
+               }
+               puts("</P>");
+               resp_end_html();
+               return;
+       }
+
+       puts("<P></P>\n"
+            "<TABLE>");
 
        for (i = 0; i < (int)sz; i++) {
-               printf("<A HREF=\"%s/show/%u.html\">", 
-                               pg, recs[i].rec);
-               html_printtext(recs[i].title);
+               printf("<TR><TD CLASS=\"title\"><A HREF=\"");
+               html_print(progname);
+               printf("/show/%u/%u.html\">", r[i].volume, r[i].rec);
+               html_print(r[i].title);
                putchar('(');
-               html_printtext(recs[i].cat);
-               puts(")</A>");
+               html_print(r[i].cat);
+               if (r[i].arch && '\0' != *r[i].arch) {
+                       putchar('/');
+                       html_print(r[i].arch);
+               }
+               printf(")</A></TD><TD CLASS=\"desc\">");
+               html_print(r[i].desc);
+               puts("</TD></TR>");
        }
+
+       puts("</TABLE>");
+
+       resp_end_html();
+}
+
+/* ARGSUSED */
+static void
+pg_index(const struct manpaths *ps, const struct req *req, char *path)
+{
+
+       resp_index(req);
 }
-#endif
 
 static void
-pg_search(const struct req *req, char *path)
+catman(const char *file)
 {
+       FILE            *f;
+       size_t           len;
        int              i;
-       struct opts      opt;
+       char            *p;
+       int              italic, bold;
 
-       for (i = 0; i < (int)req->fieldsz; i++)
-               if (0 == strcmp(req->fields[i].key, "key"))
-                       break;
+       if (NULL == (f = fopen(file, "r"))) {
+               resp_baddb();
+               return;
+       }
+
+       resp_begin_http(200, NULL);
+       puts("<!DOCTYPE HTML PUBLIC "                           "\n"
+            " \"-//W3C//DTD HTML 4.01//EN\""                   "\n"
+            " \"http://www.w3.org/TR/html4/strict.dtd\">"      "\n"
+            "<HTML>"                                           "\n"
+            " <HEAD>"                                          "\n"
+            "  <META HTTP-EQUIV=\"Content-Type\" "             "\n"
+            "        CONTENT=\"text/html; charset=utf-8\">"    "\n"
+            "  <LINK REL=\"stylesheet\" HREF=\"/catman.css\""  "\n"
+            "        TYPE=\"text/css\" media=\"all\">"         "\n"
+            "  <TITLE>System Manpage Reference</TITLE>"        "\n"
+            " </HEAD>"                                         "\n"
+            " <BODY>"                                          "\n"
+            "<!-- Begin page content. //-->");
+
+       puts("<PRE>");
+       while (NULL != (p = fgetln(f, &len))) {
+               bold = italic = 0;
+               for (i = 0; i < (int)len - 1; i++) {
+                       /* 
+                        * This means that the catpage is out of state.
+                        * Ignore it and keep going (although the
+                        * catpage is bogus).
+                        */
+
+                       if ('\b' == p[i] || '\n' == p[i])
+                               continue;
+
+                       /*
+                        * Print a regular character.
+                        * Close out any bold/italic scopes.
+                        * If we're in back-space mode, make sure we'll
+                        * have something to enter when we backspace.
+                        */
+
+                       if ('\b' != p[i + 1]) {
+                               if (italic)
+                                       printf("</I>");
+                               if (bold)
+                                       printf("</B>");
+                               italic = bold = 0;
+                               html_putchar(p[i]);
+                               continue;
+                       } else if (i + 2 >= (int)len)
+                               continue;
+
+                       /* Italic mode. */
+
+                       if ('_' == p[i]) {
+                               if (bold)
+                                       printf("</B>");
+                               if ( ! italic)
+                                       printf("<I>");
+                               bold = 0;
+                               italic = 1;
+                               i += 2;
+                               html_putchar(p[i]);
+                               continue;
+                       }
+
+                       /* 
+                        * Handle funny behaviour troff-isms.
+                        * These grok'd from the original man2html.c.
+                        */
+
+                       if (('+' == p[i] && 'o' == p[i + 2]) ||
+                                       ('o' == p[i] && '+' == p[i + 2]) ||
+                                       ('|' == p[i] && '=' == p[i + 2]) ||
+                                       ('=' == p[i] && '|' == p[i + 2]) ||
+                                       ('*' == p[i] && '=' == p[i + 2]) ||
+                                       ('=' == p[i] && '*' == p[i + 2]) ||
+                                       ('*' == p[i] && '|' == p[i + 2]) ||
+                                       ('|' == p[i] && '*' == p[i + 2]))  {
+                               if (italic)
+                                       printf("</I>");
+                               if (bold)
+                                       printf("</B>");
+                               italic = bold = 0;
+                               putchar('*');
+                               i += 2;
+                               continue;
+                       } else if (('|' == p[i] && '-' == p[i + 2]) ||
+                                       ('-' == p[i] && '|' == p[i + 1]) ||
+                                       ('+' == p[i] && '-' == p[i + 1]) ||
+                                       ('-' == p[i] && '+' == p[i + 1]) ||
+                                       ('+' == p[i] && '|' == p[i + 1]) ||
+                                       ('|' == p[i] && '+' == p[i + 1]))  {
+                               if (italic)
+                                       printf("</I>");
+                               if (bold)
+                                       printf("</B>");
+                               italic = bold = 0;
+                               putchar('+');
+                               i += 2;
+                               continue;
+                       }
+
+                       /* Bold mode. */
+                       
+                       if (italic)
+                               printf("</I>");
+                       if ( ! bold)
+                               printf("<B>");
+                       bold = 1;
+                       italic = 0;
+                       i += 2;
+                       html_putchar(p[i]);
+               }
+
+               /* 
+                * Clean up the last character.
+                * We can get to a newline; don't print that. 
+                */
+
+               if (italic)
+                       printf("</I>");
+               if (bold)
+                       printf("</B>");
 
-       if (i == (int)req->fieldsz)
+               if (i == (int)len - 1 && '\n' != p[i])
+                       html_putchar(p[i]);
+
+               putchar('\n');
+       }
+
+       puts("</PRE>\n"
+            "</BODY>\n"
+            "</HTML>");
+
+       fclose(f);
+}
+
+static void
+format(const char *file)
+{
+       struct mparse   *mp;
+       int              fd;
+       struct mdoc     *mdoc;
+       struct man      *man;
+       void            *vp;
+       enum mandoclevel rc;
+       char             opts[MAXPATHLEN + 128];
+
+       if (-1 == (fd = open(file, O_RDONLY, 0))) {
+               resp_baddb();
                return;
+       }
+
+       mp = mparse_alloc(MPARSE_AUTO, MANDOCLEVEL_FATAL, NULL, NULL);
+       rc = mparse_readfd(mp, fd, file);
+       close(fd);
+
+       if (rc >= MANDOCLEVEL_FATAL) {
+               resp_baddb();
+               return;
+       }
+
+       snprintf(opts, sizeof(opts), "style=/man.css,"
+                       "man=%s/search.html?sec=%%S&expr=%%N,"
+                       /*"includes=/cgi-bin/man.cgi/usr/include/%%I"*/,
+                       progname);
+
+       mparse_result(mp, &mdoc, &man);
+       vp = html_alloc(opts);
+
+       if (NULL != mdoc) {
+               resp_begin_http(200, NULL);
+               html_mdoc(vp, mdoc);
+       } else if (NULL != man) {
+               resp_begin_http(200, NULL);
+               html_man(vp, man);
+       } else
+               resp_baddb();
+
+       html_free(vp);
+       mparse_free(mp);
+}
+
+static void
+pg_show(const struct manpaths *ps, const struct req *req, char *path)
+{
+       char            *sub;
+       char             file[MAXPATHLEN];
+       const char      *fn, *cp;
+       int              rc;
+       unsigned int     vol, rec;
+       DB              *idx;
+       DBT              key, val;
+
+       if (NULL == path) {
+               resp_error400();
+               return;
+       } else if (NULL == (sub = strrchr(path, '/'))) {
+               resp_error400();
+               return;
+       } else
+               *sub++ = '\0';
+
+       if ( ! (atou(path, &vol) && atou(sub, &rec))) {
+               resp_error400();
+               return;
+       } else if (vol >= (unsigned int)ps->sz) {
+               resp_error400();
+               return;
+       }
+
+       strlcpy(file, ps->paths[vol], MAXPATHLEN);
+       strlcat(file, "/mandoc.index", MAXPATHLEN);
+
+       /* Open the index recno(3) database. */
+
+       idx = dbopen(file, O_RDONLY, 0, DB_RECNO, NULL);
+       if (NULL == idx) {
+               resp_baddb();
+               return;
+       }
+
+       key.data = &rec;
+       key.size = 4;
+
+       if (0 != (rc = (*idx->get)(idx, &key, &val, 0))) {
+               rc < 0 ? resp_baddb() : resp_error400();
+               goto out;
+       } 
+
+       cp = (char *)val.data;
+
+       if (NULL == (fn = memchr(cp, '\0', val.size)))
+               resp_baddb();
+       else if (++fn - cp >= (int)val.size)
+               resp_baddb();
+       else if (NULL == memchr(fn, '\0', val.size - (fn - cp)))
+               resp_baddb();
+       else {
+               strlcpy(file, cache, MAXPATHLEN);
+               strlcat(file, "/", MAXPATHLEN);
+               strlcat(file, fn, MAXPATHLEN);
+               if (0 == strcmp(cp, "cat"))
+                       catman(file);
+               else
+                       format(file);
+       }
+out:
+       (*idx->close)(idx);
+}
+
+static void
+pg_search(const struct manpaths *ps, const struct req *req, char *path)
+{
+       size_t            tt;
+       int               i, sz, rc, whatis;
+       const char       *ep, *start;
+       char            **cp;
+       struct opts       opt;
+       struct expr      *expr;
+
+       expr = NULL;
+       cp = NULL;
+       ep = NULL;
+       sz = 0;
+       whatis = 1;
 
        memset(&opt, 0, sizeof(struct opts));
-       /*opt.types = TYPE_NAME | TYPE_DESC;
-       apropos_search(&opt, req->fields[i].val, NULL, pg_searchres);*/
+
+       for (sz = i = 0; i < (int)req->fieldsz; i++)
+               if (0 == strcmp(req->fields[i].key, "expr"))
+                       ep = req->fields[i].val;
+               else if (0 == strcmp(req->fields[i].key, "query"))
+                       ep = req->fields[i].val;
+               else if (0 == strcmp(req->fields[i].key, "sec"))
+                       opt.cat = req->fields[i].val;
+               else if (0 == strcmp(req->fields[i].key, "sektion"))
+                       opt.cat = req->fields[i].val;
+               else if (0 == strcmp(req->fields[i].key, "arch"))
+                       opt.arch = req->fields[i].val;
+               else if (0 == strcmp(req->fields[i].key, "apropos"))
+                       whatis = 0 == strcmp
+                               (req->fields[i].val, "0");
+               else if (0 == strcmp(req->fields[i].key, "op"))
+                       whatis = 0 == strcasecmp
+                               (req->fields[i].val, "whatis");
+
+       if (NULL != opt.cat && 0 == strcmp(opt.cat, "0"))
+               opt.cat = NULL;
+
+       /*
+        * Poor man's tokenisation.
+        * Just break apart by spaces.
+        * Yes, this is half-ass.  But it works for now.
+        */
+
+       while (ep && isspace((unsigned char)*ep))
+               ep++;
+
+       while (ep && '\0' != *ep) {
+               cp = mandoc_realloc(cp, (sz + 1) * sizeof(char *));
+               start = ep;
+               while ('\0' != *ep && ! isspace((unsigned char)*ep))
+                       ep++;
+               cp[sz] = mandoc_malloc((ep - start) + 1);
+               memcpy(cp[sz], start, ep - start);
+               cp[sz++][ep - start] = '\0';
+               while (isspace((unsigned char)*ep))
+                       ep++;
+       }
+
+       rc = -1;
+
+       /*
+        * Pump down into apropos backend.
+        * The resp_search() function is called with the results.
+        */
+
+       expr = whatis ? termcomp(sz, cp, &tt) :
+                       exprcomp(sz, cp, &tt);
+
+       if (NULL != expr)
+               rc = apropos_search
+                       (ps->sz, ps->paths, &opt,
+                        expr, tt, (void *)req, resp_search);
+
+       /* ...unless errors occured. */
+
+       if (0 == rc)
+               resp_baddb();
+       else if (-1 == rc)
+               resp_search(NULL, 0, (void *)req);
+
+       for (i = 0; i < sz; i++)
+               free(cp[i]);
+
+       free(cp);
+       exprfree(expr);
 }
 
 int
@@ -256,37 +874,56 @@ main(void)
 {
        int              i;
        struct req       req;
-       char            *p;
-       char            *path, *subpath, *suffix;
+       char            *p, *path, *subpath;
+       struct manpaths  paths;
+
+       /* HTTP init: read and parse the query string. */
+
+       progname = getenv("SCRIPT_NAME");
+       if (NULL == progname)
+               progname = "";
+
+       cache = getenv("CACHE_DIR");
+       if (NULL == cache)
+               cache = "/cache/man.cgi";
+
+       if (-1 == chdir(cache)) {
+               resp_bad();
+               return(EXIT_FAILURE);
+       }
+
+       host = getenv("HTTP_HOST");
+       if (NULL == host)
+               host = "localhost";
 
        memset(&req, 0, sizeof(struct req));
 
        if (NULL != (p = getenv("QUERY_STRING")))
                kval_parse(&req.fields, &req.fieldsz, p);
 
-       suffix = subpath = path = NULL;
+       /* Resolve leading subpath component. */
 
-       req.media = MEDIA_HTML;
+       subpath = path = NULL;
        req.page = PAGE__MAX;
 
        if (NULL == (path = getenv("PATH_INFO")) || '\0' == *path)
                req.page = PAGE_INDEX;
+
        if (NULL != path && '/' == *path && '\0' == *++path)
                req.page = PAGE_INDEX;
 
-       if (NULL != path && NULL != (suffix = strrchr(path, '.')))
-               if (NULL != suffix && NULL == strchr(suffix, '/'))
-                       *suffix++ = '\0';
+       /* Strip file suffix. */
+
+       if (NULL != path && NULL != (p = strrchr(path, '.')))
+               if (NULL != p && NULL == strchr(p, '/'))
+                       *p++ = '\0';
+
+       /* Resolve subpath component. */
 
        if (NULL != path && NULL != (subpath = strchr(path, '/')))
-                       *subpath++ = '\0';
+               *subpath++ = '\0';
 
-       if (NULL != suffix && '\0' != *suffix)
-               for (i = 0; i < (int)MEDIA__MAX; i++)
-                       if (0 == strcmp(medias[i], suffix)) {
-                               req.media = (enum media)i;
-                               break;
-                       }
+       /* Map path into one we recognise. */
 
        if (NULL != path && '\0' != *path)
                for (i = 0; i < (int)PAGE__MAX; i++) 
@@ -295,18 +932,39 @@ main(void)
                                break;
                        }
 
+       /* Initialise MANPATH. */
+
+       memset(&paths, 0, sizeof(struct manpaths));
+       manpath_manconf("etc/catman.conf", &paths);
+
+       /* Route pages. */
+
        switch (req.page) {
        case (PAGE_INDEX):
-               pg_index(&req, subpath);
+               pg_index(&paths, &req, subpath);
                break;
        case (PAGE_SEARCH):
-               pg_search(&req, subpath);
+               pg_search(&paths, &req, subpath);
+               break;
+       case (PAGE_SHOW):
+               pg_show(&paths, &req, subpath);
                break;
        default:
-               /* Blah */
+               resp_error404(path);
                break;
        }
 
+       manpath_free(&paths);
        kval_free(req.fields, req.fieldsz);
+
        return(EXIT_SUCCESS);
 }
+
+static int
+cmp(const void *p1, const void *p2)
+{
+
+       return(strcasecmp(((const struct res *)p1)->title,
+                               ((const struct res *)p2)->title));
+}
+