File: [cvsweb.bsd.lv] / mandoc / Attic / apropos.c (download)
Revision 1.15, Sun Nov 20 15:43:14 2011 UTC (12 years, 5 months ago) by kristaps
Branch: MAIN
Changes since 1.14: +90 -20 lines
Integrate a moderately-patched version of schwarze@'s support for multiple
directories containing mandocdb(8) databases. Some changes follow:
(1) don't support -M yet;
(2) fall back to cwd if no prior manpath has been specified;
(3) resolve manpages using realpath() to prevent consecutive chdir()'s
over relative paths;
(4) note where further error-reporting is required;
(5) fix leaking memory on exit in several cases.
|
/* $Id: apropos.c,v 1.15 2011/11/20 15:43:14 kristaps Exp $ */
/*
* Copyright (c) 2011 Kristaps Dzonsons <kristaps@bsd.lv>
* Copyright (c) 2011 Ingo Schwarze <schwarze@openbsd.org>
*
* 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 <assert.h>
#include <getopt.h>
#include <limits.h>
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include "apropos_db.h"
#include "mandoc.h"
/*
* List of paths to be searched for manual databases.
*/
struct manpaths {
int sz;
char **paths;
};
static int cmp(const void *, const void *);
static void list(struct res *, size_t, void *);
static int manpath_add(struct manpaths *, const char *);
static int manpath_parse(struct manpaths *, char *);
static void usage(void);
static char *progname;
int
main(int argc, char *argv[])
{
int i, ch, rc;
struct manpaths paths;
size_t terms;
struct opts opts;
struct expr *e;
extern int optind;
extern char *optarg;
progname = strrchr(argv[0], '/');
if (progname == NULL)
progname = argv[0];
else
++progname;
memset(&paths, 0, sizeof(struct manpaths));
memset(&opts, 0, sizeof(struct opts));
e = NULL;
rc = 0;
while (-1 != (ch = getopt(argc, argv, "m:S:s:")))
switch (ch) {
case ('m'):
if ( ! manpath_parse(&paths, optarg))
goto out;
break;
case ('S'):
opts.arch = optarg;
break;
case ('s'):
opts.cat = optarg;
break;
default:
usage();
goto out;
}
argc -= optind;
argv += optind;
if (0 == argc) {
rc = 1;
goto out;
}
if (0 == paths.sz && ! manpath_add(&paths, "."))
goto out;
if (NULL == (e = exprcomp(argc, argv, &terms))) {
/* FIXME: be more specific about this. */
fprintf(stderr, "Bad expression\n");
goto out;
}
rc = apropos_search
(paths.sz, paths.paths,
&opts, e, terms, NULL, list);
/* FIXME: report an error based on ch. */
out:
for (i = 0; i < paths.sz; i++)
free(paths.paths[i]);
free(paths.paths);
exprfree(e);
return(rc ? EXIT_SUCCESS : EXIT_FAILURE);
}
/* ARGSUSED */
static void
list(struct res *res, size_t sz, void *arg)
{
int i;
qsort(res, sz, sizeof(struct res), cmp);
for (i = 0; i < (int)sz; i++)
printf("%s(%s%s%s) - %s\n", res[i].title,
res[i].cat,
*res[i].arch ? "/" : "",
*res[i].arch ? res[i].arch : "",
res[i].desc);
}
static int
cmp(const void *p1, const void *p2)
{
return(strcmp(((const struct res *)p1)->title,
((const struct res *)p2)->title));
}
static void
usage(void)
{
fprintf(stderr, "usage: %s "
"[-m dirs] "
"[-S arch] "
"[-s section] "
"expression...\n", progname);
}
/*
* Parse a FULL pathname from a colon-separated list of arrays.
*/
static int
manpath_parse(struct manpaths *dirs, char *path)
{
char *dir;
for (dir = strtok(path, ":"); dir; dir = strtok(NULL, ":"))
if ( ! manpath_add(dirs, dir))
return(0);
return(1);
}
/*
* Add a directory to the array.
* Grow the array one-by-one for simplicity's sake.
* Return 0 if the directory is not a real path.
*/
static int
manpath_add(struct manpaths *dirs, const char *dir)
{
char buf[PATH_MAX];
char *cp;
if (NULL == (cp = realpath(dir, buf))) {
fprintf(stderr, "%s: Invalid path\n", dir);
return(0);
}
dirs->paths = mandoc_realloc
(dirs->paths,
((size_t)dirs->sz + 1) * sizeof(char *));
dirs->paths[dirs->sz++] = mandoc_strdup(cp);
return(1);
}