version 1.202, 2014/12/05 21:55:04 |
version 1.235, 2015/04/18 16:34:25 |
|
|
/* $Id$ */ |
/* $Id$ */ |
/* |
/* |
* Copyright (c) 2008-2012 Kristaps Dzonsons <kristaps@bsd.lv> |
* Copyright (c) 2008-2012 Kristaps Dzonsons <kristaps@bsd.lv> |
* Copyright (c) 2010, 2011, 2012, 2014 Ingo Schwarze <schwarze@openbsd.org> |
* Copyright (c) 2010-2012, 2014, 2015 Ingo Schwarze <schwarze@openbsd.org> |
* Copyright (c) 2010 Joerg Sonnenberger <joerg@netbsd.org> |
* Copyright (c) 2010 Joerg Sonnenberger <joerg@netbsd.org> |
* |
* |
* Permission to use, copy, modify, and distribute this software for any |
* Permission to use, copy, modify, and distribute this software for any |
* purpose with or without fee is hereby granted, provided that the above |
* purpose with or without fee is hereby granted, provided that the above |
* copyright notice and this permission notice appear in all copies. |
* copyright notice and this permission notice appear in all copies. |
* |
* |
* THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES |
* THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHORS DISCLAIM ALL WARRANTIES |
* WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF |
* WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF |
* MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR |
* MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR |
* ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES |
* ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES |
* WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN |
* WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN |
* ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF |
* ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF |
|
|
#include "config.h" |
#include "config.h" |
|
|
#include <sys/types.h> |
#include <sys/types.h> |
|
#include <sys/param.h> /* MACHINE */ |
|
#include <sys/wait.h> |
|
|
#include <assert.h> |
#include <assert.h> |
#include <ctype.h> |
#include <ctype.h> |
#include <errno.h> |
#include <errno.h> |
#include <fcntl.h> |
#include <fcntl.h> |
|
#include <glob.h> |
|
#include <signal.h> |
#include <stdio.h> |
#include <stdio.h> |
#include <stdint.h> |
#include <stdint.h> |
#include <stdlib.h> |
#include <stdlib.h> |
#include <string.h> |
#include <string.h> |
#include <unistd.h> |
#include <unistd.h> |
|
|
#include "mandoc.h" |
|
#include "mandoc_aux.h" |
#include "mandoc_aux.h" |
#include "main.h" |
#include "mandoc.h" |
|
#include "roff.h" |
#include "mdoc.h" |
#include "mdoc.h" |
#include "man.h" |
#include "man.h" |
#include "manpath.h" |
#include "main.h" |
|
#include "manconf.h" |
#include "mansearch.h" |
#include "mansearch.h" |
|
|
#if !defined(__GNUC__) || (__GNUC__ < 2) |
#if !defined(__GNUC__) || (__GNUC__ < 2) |
|
|
OUTMODE_ONE |
OUTMODE_ONE |
}; |
}; |
|
|
typedef void (*out_mdoc)(void *, const struct mdoc *); |
typedef void (*out_mdoc)(void *, const struct roff_man *); |
typedef void (*out_man)(void *, const struct man *); |
typedef void (*out_man)(void *, const struct roff_man *); |
typedef void (*out_free)(void *); |
typedef void (*out_free)(void *); |
|
|
enum outt { |
enum outt { |
Line 79 struct curparse { |
|
Line 84 struct curparse { |
|
out_man outman; /* man output ptr */ |
out_man outman; /* man output ptr */ |
out_free outfree; /* free output ptr */ |
out_free outfree; /* free output ptr */ |
void *outdata; /* data for output */ |
void *outdata; /* data for output */ |
char outopts[BUFSIZ]; /* buf of output opts */ |
struct manoutput *outopts; /* output options */ |
}; |
}; |
|
|
|
static int fs_lookup(const struct manpaths *, |
|
size_t ipath, const char *, |
|
const char *, const char *, |
|
struct manpage **, size_t *); |
|
static void fs_search(const struct mansearch *, |
|
const struct manpaths *, int, char**, |
|
struct manpage **, size_t *); |
|
static void handle_sigpipe(int); |
static int koptions(int *, char *); |
static int koptions(int *, char *); |
|
#if HAVE_SQLITE3 |
|
int mandocdb(int, char**); |
|
#endif |
static int moptions(int *, char *); |
static int moptions(int *, char *); |
static void mmsg(enum mandocerr, enum mandoclevel, |
static void mmsg(enum mandocerr, enum mandoclevel, |
const char *, int, int, const char *); |
const char *, int, int, const char *); |
static void parse(struct curparse *, int, |
static void parse(struct curparse *, int, const char *); |
const char *, enum mandoclevel *); |
static void passthrough(const char *, int, int); |
static enum mandoclevel passthrough(const char *, int, int); |
static pid_t spawn_pager(void); |
static void spawn_pager(void); |
|
static int toptions(struct curparse *, char *); |
static int toptions(struct curparse *, char *); |
static void usage(enum argmode) __attribute__((noreturn)); |
static void usage(enum argmode) __attribute__((noreturn)); |
static void version(void) __attribute__((noreturn)); |
|
static int woptions(struct curparse *, char *); |
static int woptions(struct curparse *, char *); |
|
|
static const int sec_prios[] = {1, 4, 5, 8, 6, 3, 7, 2, 9}; |
static const int sec_prios[] = {1, 4, 5, 8, 6, 3, 7, 2, 9}; |
static char help_arg[] = "help"; |
static char help_arg[] = "help"; |
static char *help_argv[] = {help_arg, NULL}; |
static char *help_argv[] = {help_arg, NULL}; |
static const char *progname; |
static const char *progname; |
|
static enum mandoclevel rc; |
|
|
|
|
int |
int |
main(int argc, char *argv[]) |
main(int argc, char *argv[]) |
{ |
{ |
|
struct manconf conf; |
struct curparse curp; |
struct curparse curp; |
struct mansearch search; |
struct mansearch search; |
struct manpaths paths; |
char *auxpaths; |
char *conf_file, *defpaths, *auxpaths; |
|
char *defos; |
char *defos; |
#if HAVE_SQLITE3 |
unsigned char *uc; |
struct manpage *res, *resp; |
struct manpage *res, *resp; |
|
char *conf_file, *defpaths; |
size_t isec, i, sz; |
size_t isec, i, sz; |
int prio, best_prio; |
int prio, best_prio; |
char sec; |
char sec; |
#endif |
enum mandoclevel rctmp; |
enum mandoclevel rc; |
|
enum outmode outmode; |
enum outmode outmode; |
int fd; |
int fd; |
int show_usage; |
int show_usage; |
int use_pager; |
|
int synopsis_only; |
|
int options; |
int options; |
int c; |
int c; |
|
pid_t pager_pid; /* 0: don't use; 1: not yet spawned. */ |
|
|
progname = strrchr(argv[0], '/'); |
if (argc < 1) |
if (progname == NULL) |
progname = "mandoc"; |
|
else if ((progname = strrchr(argv[0], '/')) == NULL) |
progname = argv[0]; |
progname = argv[0]; |
else |
else |
++progname; |
++progname; |
|
|
|
#if HAVE_SQLITE3 |
|
if (strcmp(progname, BINM_MAKEWHATIS) == 0) |
|
return(mandocdb(argc, argv)); |
|
#endif |
|
|
/* Search options. */ |
/* Search options. */ |
|
|
memset(&paths, 0, sizeof(struct manpaths)); |
memset(&conf, 0, sizeof(conf)); |
conf_file = defpaths = auxpaths = NULL; |
conf_file = defpaths = NULL; |
|
auxpaths = NULL; |
|
|
memset(&search, 0, sizeof(struct mansearch)); |
memset(&search, 0, sizeof(struct mansearch)); |
search.outkey = "Nd"; |
search.outkey = "Nd"; |
|
|
if (strcmp(progname, "man") == 0) |
if (strcmp(progname, BINM_MAN) == 0) |
search.argmode = ARG_NAME; |
search.argmode = ARG_NAME; |
else if (strncmp(progname, "apropos", 7) == 0) |
else if (strcmp(progname, BINM_APROPOS) == 0) |
search.argmode = ARG_EXPR; |
search.argmode = ARG_EXPR; |
else if (strncmp(progname, "whatis", 6) == 0) |
else if (strcmp(progname, BINM_WHATIS) == 0) |
search.argmode = ARG_WORD; |
search.argmode = ARG_WORD; |
else if (strncmp(progname, "help", 4) == 0) |
else if (strncmp(progname, "help", 4) == 0) |
search.argmode = ARG_NAME; |
search.argmode = ARG_NAME; |
Line 153 main(int argc, char *argv[]) |
|
Line 174 main(int argc, char *argv[]) |
|
|
|
memset(&curp, 0, sizeof(struct curparse)); |
memset(&curp, 0, sizeof(struct curparse)); |
curp.outtype = OUTT_LOCALE; |
curp.outtype = OUTT_LOCALE; |
curp.wlevel = MANDOCLEVEL_FATAL; |
curp.wlevel = MANDOCLEVEL_BADARG; |
|
curp.outopts = &conf.output; |
options = MPARSE_SO | MPARSE_UTF8 | MPARSE_LATIN1; |
options = MPARSE_SO | MPARSE_UTF8 | MPARSE_LATIN1; |
defos = NULL; |
defos = NULL; |
|
|
use_pager = 1; |
pager_pid = 1; |
show_usage = 0; |
show_usage = 0; |
synopsis_only = 0; |
|
outmode = OUTMODE_DEF; |
outmode = OUTMODE_DEF; |
|
|
while (-1 != (c = getopt(argc, argv, |
while (-1 != (c = getopt(argc, argv, |
Line 172 main(int argc, char *argv[]) |
|
Line 193 main(int argc, char *argv[]) |
|
conf_file = optarg; |
conf_file = optarg; |
break; |
break; |
case 'c': |
case 'c': |
use_pager = 0; |
pager_pid = 0; |
break; |
break; |
case 'f': |
case 'f': |
search.argmode = ARG_WORD; |
search.argmode = ARG_WORD; |
break; |
break; |
case 'h': |
case 'h': |
(void)strlcat(curp.outopts, "synopsis,", BUFSIZ); |
conf.output.synopsisonly = 1; |
synopsis_only = 1; |
pager_pid = 0; |
use_pager = 0; |
|
outmode = OUTMODE_ALL; |
outmode = OUTMODE_ALL; |
break; |
break; |
case 'I': |
case 'I': |
if (strncmp(optarg, "os=", 3)) { |
if (strncmp(optarg, "os=", 3)) { |
fprintf(stderr, |
fprintf(stderr, |
"%s: -I%s: Bad argument\n", |
"%s: -I %s: Bad argument\n", |
progname, optarg); |
progname, optarg); |
return((int)MANDOCLEVEL_BADARG); |
return((int)MANDOCLEVEL_BADARG); |
} |
} |
if (defos) { |
if (defos) { |
fprintf(stderr, |
fprintf(stderr, |
"%s: -I%s: Duplicate argument\n", |
"%s: -I %s: Duplicate argument\n", |
progname, optarg); |
progname, optarg); |
return((int)MANDOCLEVEL_BADARG); |
return((int)MANDOCLEVEL_BADARG); |
} |
} |
Line 220 main(int argc, char *argv[]) |
|
Line 240 main(int argc, char *argv[]) |
|
break; |
break; |
case 'O': |
case 'O': |
search.outkey = optarg; |
search.outkey = optarg; |
(void)strlcat(curp.outopts, optarg, BUFSIZ); |
while (optarg != NULL) |
(void)strlcat(curp.outopts, ",", BUFSIZ); |
manconf_output(&conf.output, |
|
strsep(&optarg, ",")); |
break; |
break; |
case 'S': |
case 'S': |
search.arch = optarg; |
search.arch = optarg; |
Line 240 main(int argc, char *argv[]) |
|
Line 261 main(int argc, char *argv[]) |
|
case 'w': |
case 'w': |
outmode = OUTMODE_FLN; |
outmode = OUTMODE_FLN; |
break; |
break; |
case 'V': |
|
version(); |
|
/* NOTREACHED */ |
|
default: |
default: |
show_usage = 1; |
show_usage = 1; |
break; |
break; |
Line 258 main(int argc, char *argv[]) |
|
Line 276 main(int argc, char *argv[]) |
|
switch (search.argmode) { |
switch (search.argmode) { |
case ARG_FILE: |
case ARG_FILE: |
outmode = OUTMODE_ALL; |
outmode = OUTMODE_ALL; |
use_pager = 0; |
pager_pid = 0; |
break; |
break; |
case ARG_NAME: |
case ARG_NAME: |
outmode = OUTMODE_ONE; |
outmode = OUTMODE_ONE; |
Line 271 main(int argc, char *argv[]) |
|
Line 289 main(int argc, char *argv[]) |
|
|
|
/* Parse arguments. */ |
/* Parse arguments. */ |
|
|
argc -= optind; |
if (argc > 0) { |
argv += optind; |
argc -= optind; |
#if HAVE_SQLITE3 |
argv += optind; |
|
} |
resp = NULL; |
resp = NULL; |
#endif |
|
|
|
/* |
/* |
* Quirks for help(1) |
* Quirks for help(1) |
Line 288 main(int argc, char *argv[]) |
|
Line 306 main(int argc, char *argv[]) |
|
argv = help_argv; |
argv = help_argv; |
argc = 1; |
argc = 1; |
} |
} |
} else if (argv[0] != NULL && |
} else if (argc > 1 && |
isdigit((unsigned char)argv[0][0]) && |
((uc = (unsigned char *)argv[0]) != NULL) && |
(argv[0][1] == '\0' || !strcmp(argv[0], "3p"))) { |
((isdigit(uc[0]) && (uc[1] == '\0' || |
search.sec = argv[0]; |
(isalpha(uc[1]) && uc[2] == '\0'))) || |
|
(uc[0] == 'n' && uc[1] == '\0'))) { |
|
search.sec = (char *)uc; |
argv++; |
argv++; |
argc--; |
argc--; |
} |
} |
|
if (search.arch == NULL) |
|
search.arch = getenv("MACHINE"); |
|
#ifdef MACHINE |
|
if (search.arch == NULL) |
|
search.arch = MACHINE; |
|
#endif |
} |
} |
|
|
rc = MANDOCLEVEL_OK; |
rc = MANDOCLEVEL_OK; |
Line 302 main(int argc, char *argv[]) |
|
Line 328 main(int argc, char *argv[]) |
|
/* man(1), whatis(1), apropos(1) */ |
/* man(1), whatis(1), apropos(1) */ |
|
|
if (search.argmode != ARG_FILE) { |
if (search.argmode != ARG_FILE) { |
#if HAVE_SQLITE3 |
|
if (argc == 0) |
if (argc == 0) |
usage(search.argmode); |
usage(search.argmode); |
|
|
Line 312 main(int argc, char *argv[]) |
|
Line 337 main(int argc, char *argv[]) |
|
|
|
/* Access the mandoc database. */ |
/* Access the mandoc database. */ |
|
|
manpath_parse(&paths, conf_file, defpaths, auxpaths); |
manconf_parse(&conf, conf_file, defpaths, auxpaths); |
|
#if HAVE_SQLITE3 |
mansearch_setup(1); |
mansearch_setup(1); |
if( ! mansearch(&search, &paths, argc, argv, &res, &sz)) |
if ( ! mansearch(&search, &conf.manpath, |
|
argc, argv, &res, &sz)) |
usage(search.argmode); |
usage(search.argmode); |
resp = res; |
#else |
|
if (search.argmode != ARG_NAME) { |
|
fputs("mandoc: database support not compiled in\n", |
|
stderr); |
|
return((int)MANDOCLEVEL_BADARG); |
|
} |
|
sz = 0; |
|
#endif |
|
|
|
if (sz == 0 && search.argmode == ARG_NAME) |
|
fs_search(&search, &conf.manpath, |
|
argc, argv, &res, &sz); |
|
|
if (sz == 0) { |
if (sz == 0) { |
if (search.argmode == ARG_NAME) |
|
fprintf(stderr, "%s: No entry for %s " |
|
"in the manual.\n", progname, argv[0]); |
|
rc = MANDOCLEVEL_BADARG; |
rc = MANDOCLEVEL_BADARG; |
goto out; |
goto out; |
} |
} |
Line 340 main(int argc, char *argv[]) |
|
Line 375 main(int argc, char *argv[]) |
|
|
|
/* Iterate all matching manuals. */ |
/* Iterate all matching manuals. */ |
|
|
|
resp = res; |
for (i = 0; i < sz; i++) { |
for (i = 0; i < sz; i++) { |
if (outmode == OUTMODE_FLN) |
if (outmode == OUTMODE_FLN) |
puts(res[i].file); |
puts(res[i].file); |
Line 369 main(int argc, char *argv[]) |
|
Line 405 main(int argc, char *argv[]) |
|
|
|
if (outmode == OUTMODE_FLN || outmode == OUTMODE_LST) |
if (outmode == OUTMODE_FLN || outmode == OUTMODE_LST) |
goto out; |
goto out; |
#else |
|
fputs("mandoc: database support not compiled in\n", |
|
stderr); |
|
return((int)MANDOCLEVEL_BADARG); |
|
#endif |
|
} |
} |
|
|
/* mandoc(1) */ |
/* mandoc(1) */ |
|
|
if ( ! moptions(&options, auxpaths)) |
if (search.argmode == ARG_FILE && ! moptions(&options, auxpaths)) |
return((int)MANDOCLEVEL_BADARG); |
return((int)MANDOCLEVEL_BADARG); |
|
|
if (use_pager && isatty(STDOUT_FILENO)) |
|
spawn_pager(); |
|
|
|
curp.mchars = mchars_alloc(); |
curp.mchars = mchars_alloc(); |
curp.mp = mparse_alloc(options, curp.wlevel, mmsg, |
curp.mp = mparse_alloc(options, curp.wlevel, mmsg, |
curp.mchars, defos); |
curp.mchars, defos); |
Line 394 main(int argc, char *argv[]) |
|
Line 422 main(int argc, char *argv[]) |
|
if (OUTT_MAN == curp.outtype) |
if (OUTT_MAN == curp.outtype) |
mparse_keep(curp.mp); |
mparse_keep(curp.mp); |
|
|
if (argc == 0) |
if (argc < 1) { |
parse(&curp, STDIN_FILENO, "<stdin>", &rc); |
if (pager_pid == 1 && isatty(STDOUT_FILENO)) |
|
pager_pid = spawn_pager(); |
|
parse(&curp, STDIN_FILENO, "<stdin>"); |
|
} |
|
|
while (argc) { |
while (argc > 0) { |
#if HAVE_SQLITE3 |
rctmp = mparse_open(curp.mp, &fd, |
if (resp != NULL) { |
resp != NULL ? resp->file : *argv); |
rc = mparse_open(curp.mp, &fd, resp->file); |
if (rc < rctmp) |
if (fd == -1) |
rc = rctmp; |
/* nothing */; |
|
|
if (fd != -1) { |
|
if (pager_pid == 1 && isatty(STDOUT_FILENO)) |
|
pager_pid = spawn_pager(); |
|
|
|
if (resp == NULL) |
|
parse(&curp, fd, *argv); |
else if (resp->form & FORM_SRC) { |
else if (resp->form & FORM_SRC) { |
/* For .so only; ignore failure. */ |
/* For .so only; ignore failure. */ |
chdir(paths.paths[resp->ipath]); |
chdir(conf.manpath.paths[resp->ipath]); |
parse(&curp, fd, resp->file, &rc); |
parse(&curp, fd, resp->file); |
} else |
} else |
rc = passthrough(resp->file, fd, |
passthrough(resp->file, fd, |
synopsis_only); |
conf.output.synopsisonly); |
resp++; |
|
} else |
|
#endif |
|
{ |
|
rc = mparse_open(curp.mp, &fd, *argv++); |
|
if (fd != -1) |
|
parse(&curp, fd, argv[-1], &rc); |
|
} |
|
|
|
if (mparse_wait(curp.mp) != MANDOCLEVEL_OK) |
rctmp = mparse_wait(curp.mp); |
rc = MANDOCLEVEL_SYSERR; |
if (rc < rctmp) |
|
rc = rctmp; |
|
|
|
if (argc > 1 && curp.outtype <= OUTT_UTF8) |
|
ascii_sepline(curp.outdata); |
|
} |
|
|
if (MANDOCLEVEL_OK != rc && curp.wstop) |
if (MANDOCLEVEL_OK != rc && curp.wstop) |
break; |
break; |
argc--; |
|
|
if (resp != NULL) |
|
resp++; |
|
else |
|
argv++; |
|
if (--argc) |
|
mparse_reset(curp.mp); |
} |
} |
|
|
if (curp.outfree) |
if (curp.outfree) |
Line 432 main(int argc, char *argv[]) |
|
Line 472 main(int argc, char *argv[]) |
|
mparse_free(curp.mp); |
mparse_free(curp.mp); |
mchars_free(curp.mchars); |
mchars_free(curp.mchars); |
|
|
#if HAVE_SQLITE3 |
|
out: |
out: |
if (search.argmode != ARG_FILE) { |
if (search.argmode != ARG_FILE) { |
manpath_free(&paths); |
manconf_free(&conf); |
|
#if HAVE_SQLITE3 |
mansearch_free(res, sz); |
mansearch_free(res, sz); |
mansearch_setup(0); |
mansearch_setup(0); |
} |
|
#endif |
#endif |
|
} |
|
|
free(defos); |
free(defos); |
|
|
return((int)rc); |
/* |
} |
* If a pager is attached, flush the pipe leading to it |
|
* and signal end of file such that the user can browse |
|
* to the end. Then wait for the user to close the pager. |
|
*/ |
|
|
static void |
if (pager_pid != 0 && pager_pid != 1) { |
version(void) |
fclose(stdout); |
{ |
waitpid(pager_pid, NULL, 0); |
|
} |
|
|
printf("mandoc %s\n", VERSION); |
return((int)rc); |
exit((int)MANDOCLEVEL_OK); |
|
} |
} |
|
|
static void |
static void |
Line 460 usage(enum argmode argmode) |
|
Line 503 usage(enum argmode argmode) |
|
|
|
switch (argmode) { |
switch (argmode) { |
case ARG_FILE: |
case ARG_FILE: |
fputs("usage: mandoc [-acfhklV] [-Ios=name] " |
fputs("usage: mandoc [-acfhkl] [-I os=name] " |
"[-Kencoding] [-mformat] [-Ooption]\n" |
"[-K encoding] [-mformat] [-O option]\n" |
"\t [-Toutput] [-Wlevel] [file ...]\n", stderr); |
"\t [-T output] [-W level] [file ...]\n", stderr); |
break; |
break; |
case ARG_NAME: |
case ARG_NAME: |
fputs("usage: man [-acfhklVw] [-C file] " |
fputs("usage: man [-acfhklw] [-C file] [-I os=name] " |
"[-M path] [-m path] [-S arch] [-s section]\n" |
"[-K encoding] [-M path] [-m path]\n" |
|
"\t [-O option=value] [-S subsection] [-s section] " |
|
"[-T output] [-W level]\n" |
"\t [section] name ...\n", stderr); |
"\t [section] name ...\n", stderr); |
break; |
break; |
case ARG_WORD: |
case ARG_WORD: |
fputs("usage: whatis [-acfhklVw] [-C file] " |
fputs("usage: whatis [-acfhklw] [-C file] " |
"[-M path] [-m path] [-O outkey] [-S arch]\n" |
"[-M path] [-m path] [-O outkey] [-S arch]\n" |
"\t [-s section] name ...\n", stderr); |
"\t [-s section] name ...\n", stderr); |
break; |
break; |
case ARG_EXPR: |
case ARG_EXPR: |
fputs("usage: apropos [-acfhklVw] [-C file] " |
fputs("usage: apropos [-acfhklw] [-C file] " |
"[-M path] [-m path] [-O outkey] [-S arch]\n" |
"[-M path] [-m path] [-O outkey] [-S arch]\n" |
"\t [-s section] expression ...\n", stderr); |
"\t [-s section] expression ...\n", stderr); |
break; |
break; |
Line 483 usage(enum argmode argmode) |
|
Line 528 usage(enum argmode argmode) |
|
exit((int)MANDOCLEVEL_BADARG); |
exit((int)MANDOCLEVEL_BADARG); |
} |
} |
|
|
|
static int |
|
fs_lookup(const struct manpaths *paths, size_t ipath, |
|
const char *sec, const char *arch, const char *name, |
|
struct manpage **res, size_t *ressz) |
|
{ |
|
glob_t globinfo; |
|
struct manpage *page; |
|
char *file; |
|
int form, globres; |
|
|
|
form = FORM_SRC; |
|
mandoc_asprintf(&file, "%s/man%s/%s.%s", |
|
paths->paths[ipath], sec, name, sec); |
|
if (access(file, R_OK) != -1) |
|
goto found; |
|
free(file); |
|
|
|
mandoc_asprintf(&file, "%s/cat%s/%s.0", |
|
paths->paths[ipath], sec, name); |
|
if (access(file, R_OK) != -1) { |
|
form = FORM_CAT; |
|
goto found; |
|
} |
|
free(file); |
|
|
|
if (arch != NULL) { |
|
mandoc_asprintf(&file, "%s/man%s/%s/%s.%s", |
|
paths->paths[ipath], sec, arch, name, sec); |
|
if (access(file, R_OK) != -1) |
|
goto found; |
|
free(file); |
|
} |
|
|
|
mandoc_asprintf(&file, "%s/man%s/%s.*", |
|
paths->paths[ipath], sec, name); |
|
globres = glob(file, 0, NULL, &globinfo); |
|
if (globres != 0 && globres != GLOB_NOMATCH) |
|
fprintf(stderr, "%s: %s: glob: %s\n", |
|
progname, file, strerror(errno)); |
|
free(file); |
|
if (globres == 0) |
|
file = mandoc_strdup(*globinfo.gl_pathv); |
|
globfree(&globinfo); |
|
if (globres != 0) |
|
return(0); |
|
|
|
found: |
|
#if HAVE_SQLITE3 |
|
fprintf(stderr, "%s: outdated mandoc.db lacks %s(%s) entry, run " |
|
"makewhatis %s\n", progname, name, sec, paths->paths[ipath]); |
|
#endif |
|
*res = mandoc_reallocarray(*res, ++*ressz, sizeof(struct manpage)); |
|
page = *res + (*ressz - 1); |
|
page->file = file; |
|
page->names = NULL; |
|
page->output = NULL; |
|
page->ipath = ipath; |
|
page->bits = NAME_FILE & NAME_MASK; |
|
page->sec = (*sec >= '1' && *sec <= '9') ? *sec - '1' + 1 : 10; |
|
page->form = form; |
|
return(1); |
|
} |
|
|
static void |
static void |
parse(struct curparse *curp, int fd, const char *file, |
fs_search(const struct mansearch *cfg, const struct manpaths *paths, |
enum mandoclevel *level) |
int argc, char **argv, struct manpage **res, size_t *ressz) |
{ |
{ |
enum mandoclevel rc; |
const char *const sections[] = |
struct mdoc *mdoc; |
{"1", "8", "6", "2", "3", "3p", "5", "7", "4", "9"}; |
struct man *man; |
const size_t nsec = sizeof(sections)/sizeof(sections[0]); |
|
|
|
size_t ipath, isec, lastsz; |
|
|
|
assert(cfg->argmode == ARG_NAME); |
|
|
|
*res = NULL; |
|
*ressz = lastsz = 0; |
|
while (argc) { |
|
for (ipath = 0; ipath < paths->sz; ipath++) { |
|
if (cfg->sec != NULL) { |
|
if (fs_lookup(paths, ipath, cfg->sec, |
|
cfg->arch, *argv, res, ressz) && |
|
cfg->firstmatch) |
|
return; |
|
} else for (isec = 0; isec < nsec; isec++) |
|
if (fs_lookup(paths, ipath, sections[isec], |
|
cfg->arch, *argv, res, ressz) && |
|
cfg->firstmatch) |
|
return; |
|
} |
|
if (*ressz == lastsz) |
|
fprintf(stderr, |
|
"%s: No entry for %s in the manual.\n", |
|
progname, *argv); |
|
lastsz = *ressz; |
|
argv++; |
|
argc--; |
|
} |
|
} |
|
|
|
static void |
|
parse(struct curparse *curp, int fd, const char *file) |
|
{ |
|
enum mandoclevel rctmp; |
|
struct roff_man *man; |
|
|
/* Begin by parsing the file itself. */ |
/* Begin by parsing the file itself. */ |
|
|
assert(file); |
assert(file); |
assert(fd >= -1); |
assert(fd >= -1); |
|
|
rc = mparse_readfd(curp->mp, fd, file); |
rctmp = mparse_readfd(curp->mp, fd, file); |
|
if (rc < rctmp) |
|
rc = rctmp; |
|
|
/* Stop immediately if the parse has failed. */ |
|
|
|
if (MANDOCLEVEL_FATAL <= rc) |
|
goto cleanup; |
|
|
|
/* |
/* |
* With -Wstop and warnings or errors of at least the requested |
* With -Wstop and warnings or errors of at least the requested |
* level, do not produce output. |
* level, do not produce output. |
*/ |
*/ |
|
|
if (MANDOCLEVEL_OK != rc && curp->wstop) |
if (rctmp != MANDOCLEVEL_OK && curp->wstop) |
goto cleanup; |
return; |
|
|
/* If unset, allocate output dev now (if applicable). */ |
/* If unset, allocate output dev now (if applicable). */ |
|
|
Line 579 parse(struct curparse *curp, int fd, const char *file, |
|
Line 719 parse(struct curparse *curp, int fd, const char *file, |
|
} |
} |
} |
} |
|
|
mparse_result(curp->mp, &mdoc, &man, NULL); |
mparse_result(curp->mp, &man, NULL); |
|
|
/* Execute the out device, if it exists. */ |
/* Execute the out device, if it exists. */ |
|
|
if (man && curp->outman) |
if (man == NULL) |
|
return; |
|
if (curp->outmdoc != NULL && man->macroset == MACROSET_MDOC) |
|
(*curp->outmdoc)(curp->outdata, man); |
|
if (curp->outman != NULL && man->macroset == MACROSET_MAN) |
(*curp->outman)(curp->outdata, man); |
(*curp->outman)(curp->outdata, man); |
if (mdoc && curp->outmdoc) |
|
(*curp->outmdoc)(curp->outdata, mdoc); |
|
|
|
cleanup: |
|
|
|
mparse_reset(curp->mp); |
|
|
|
if (*level < rc) |
|
*level = rc; |
|
} |
} |
|
|
static enum mandoclevel |
static void |
passthrough(const char *file, int fd, int synopsis_only) |
passthrough(const char *file, int fd, int synopsis_only) |
{ |
{ |
const char synb[] = "S\bSY\bYN\bNO\bOP\bPS\bSI\bIS\bS"; |
const char synb[] = "S\bSY\bYN\bNO\bOP\bPS\bSI\bIS\bS"; |
Line 609 passthrough(const char *file, int fd, int synopsis_onl |
|
Line 744 passthrough(const char *file, int fd, int synopsis_onl |
|
ssize_t nw; |
ssize_t nw; |
int print; |
int print; |
|
|
|
fflush(stdout); |
|
|
if ((stream = fdopen(fd, "r")) == NULL) { |
if ((stream = fdopen(fd, "r")) == NULL) { |
close(fd); |
close(fd); |
syscall = "fdopen"; |
syscall = "fdopen"; |
Line 652 passthrough(const char *file, int fd, int synopsis_onl |
|
Line 789 passthrough(const char *file, int fd, int synopsis_onl |
|
|
|
done: |
done: |
fclose(stream); |
fclose(stream); |
return(MANDOCLEVEL_OK); |
return; |
|
|
fail: |
fail: |
fprintf(stderr, "%s: %s: SYSERR: %s: %s", |
fprintf(stderr, "%s: %s: SYSERR: %s: %s", |
progname, file, syscall, strerror(errno)); |
progname, file, syscall, strerror(errno)); |
return(MANDOCLEVEL_SYSERR); |
if (rc < MANDOCLEVEL_SYSERR) |
|
rc = MANDOCLEVEL_SYSERR; |
} |
} |
|
|
static int |
static int |
Line 673 koptions(int *options, char *arg) |
|
Line 811 koptions(int *options, char *arg) |
|
} else if ( ! strcmp(arg, "us-ascii")) { |
} else if ( ! strcmp(arg, "us-ascii")) { |
*options &= ~(MPARSE_UTF8 | MPARSE_LATIN1); |
*options &= ~(MPARSE_UTF8 | MPARSE_LATIN1); |
} else { |
} else { |
fprintf(stderr, "%s: -K%s: Bad argument\n", |
fprintf(stderr, "%s: -K %s: Bad argument\n", |
progname, arg); |
progname, arg); |
return(0); |
return(0); |
} |
} |
Line 693 moptions(int *options, char *arg) |
|
Line 831 moptions(int *options, char *arg) |
|
else if (0 == strcmp(arg, "an")) |
else if (0 == strcmp(arg, "an")) |
*options |= MPARSE_MAN; |
*options |= MPARSE_MAN; |
else { |
else { |
fprintf(stderr, "%s: -m%s: Bad argument\n", |
fprintf(stderr, "%s: -m %s: Bad argument\n", |
progname, arg); |
progname, arg); |
return(0); |
return(0); |
} |
} |
Line 727 toptions(struct curparse *curp, char *arg) |
|
Line 865 toptions(struct curparse *curp, char *arg) |
|
else if (0 == strcmp(arg, "pdf")) |
else if (0 == strcmp(arg, "pdf")) |
curp->outtype = OUTT_PDF; |
curp->outtype = OUTT_PDF; |
else { |
else { |
fprintf(stderr, "%s: -T%s: Bad argument\n", |
fprintf(stderr, "%s: -T %s: Bad argument\n", |
progname, arg); |
progname, arg); |
return(0); |
return(0); |
} |
} |
|
|
woptions(struct curparse *curp, char *arg) |
woptions(struct curparse *curp, char *arg) |
{ |
{ |
char *v, *o; |
char *v, *o; |
const char *toks[6]; |
const char *toks[7]; |
|
|
toks[0] = "stop"; |
toks[0] = "stop"; |
toks[1] = "all"; |
toks[1] = "all"; |
toks[2] = "warning"; |
toks[2] = "warning"; |
toks[3] = "error"; |
toks[3] = "error"; |
toks[4] = "fatal"; |
toks[4] = "unsupp"; |
toks[5] = NULL; |
toks[5] = "fatal"; |
|
toks[6] = NULL; |
|
|
while (*arg) { |
while (*arg) { |
o = arg; |
o = arg; |
Line 763 woptions(struct curparse *curp, char *arg) |
|
Line 902 woptions(struct curparse *curp, char *arg) |
|
curp->wlevel = MANDOCLEVEL_ERROR; |
curp->wlevel = MANDOCLEVEL_ERROR; |
break; |
break; |
case 4: |
case 4: |
curp->wlevel = MANDOCLEVEL_FATAL; |
curp->wlevel = MANDOCLEVEL_UNSUPP; |
break; |
break; |
|
case 5: |
|
curp->wlevel = MANDOCLEVEL_BADARG; |
|
break; |
default: |
default: |
fprintf(stderr, "%s: -W%s: Bad argument\n", |
fprintf(stderr, "%s: -W %s: Bad argument\n", |
progname, o); |
progname, o); |
return(0); |
return(0); |
} |
} |
Line 798 mmsg(enum mandocerr t, enum mandoclevel lvl, |
|
Line 940 mmsg(enum mandocerr t, enum mandoclevel lvl, |
|
} |
} |
|
|
static void |
static void |
|
handle_sigpipe(int signum) |
|
{ |
|
|
|
exit((int)rc); |
|
} |
|
|
|
static pid_t |
spawn_pager(void) |
spawn_pager(void) |
{ |
{ |
#define MAX_PAGER_ARGS 16 |
#define MAX_PAGER_ARGS 16 |
Line 806 spawn_pager(void) |
|
Line 955 spawn_pager(void) |
|
char *cp; |
char *cp; |
int fildes[2]; |
int fildes[2]; |
int argc; |
int argc; |
|
pid_t pager_pid; |
|
|
if (pipe(fildes) == -1) { |
if (pipe(fildes) == -1) { |
fprintf(stderr, "%s: pipe: %s\n", |
fprintf(stderr, "%s: pipe: %s\n", |
progname, strerror(errno)); |
progname, strerror(errno)); |
return; |
return(0); |
} |
} |
|
|
switch (fork()) { |
switch (pager_pid = fork()) { |
case -1: |
case -1: |
fprintf(stderr, "%s: fork: %s\n", |
fprintf(stderr, "%s: fork: %s\n", |
progname, strerror(errno)); |
progname, strerror(errno)); |
exit((int)MANDOCLEVEL_SYSERR); |
exit((int)MANDOCLEVEL_SYSERR); |
case 0: |
case 0: |
|
break; |
|
default: |
close(fildes[0]); |
close(fildes[0]); |
if (dup2(fildes[1], STDOUT_FILENO) == -1) { |
if (dup2(fildes[1], STDOUT_FILENO) == -1) { |
fprintf(stderr, "%s: dup output: %s\n", |
fprintf(stderr, "%s: dup output: %s\n", |
progname, strerror(errno)); |
progname, strerror(errno)); |
exit((int)MANDOCLEVEL_SYSERR); |
exit((int)MANDOCLEVEL_SYSERR); |
} |
} |
return; |
close(fildes[1]); |
default: |
signal(SIGPIPE, handle_sigpipe); |
break; |
return(pager_pid); |
} |
} |
|
|
/* The original process becomes the pager. */ |
/* The child process becomes the pager. */ |
|
|
close(fildes[1]); |
close(fildes[1]); |
if (dup2(fildes[0], STDIN_FILENO) == -1) { |
if (dup2(fildes[0], STDIN_FILENO) == -1) { |
Line 838 spawn_pager(void) |
|
Line 990 spawn_pager(void) |
|
progname, strerror(errno)); |
progname, strerror(errno)); |
exit((int)MANDOCLEVEL_SYSERR); |
exit((int)MANDOCLEVEL_SYSERR); |
} |
} |
|
close(fildes[0]); |
|
|
pager = getenv("MANPAGER"); |
pager = getenv("MANPAGER"); |
if (pager == NULL || *pager == '\0') |
if (pager == NULL || *pager == '\0') |
pager = getenv("PAGER"); |
pager = getenv("PAGER"); |
if (pager == NULL || *pager == '\0') |
if (pager == NULL || *pager == '\0') |
pager = "/usr/bin/more -s"; |
pager = "more -s"; |
cp = mandoc_strdup(pager); |
cp = mandoc_strdup(pager); |
|
|
/* |
/* |