version 1.202, 2018/12/13 11:55:47 |
version 1.205, 2018/12/14 02:16:21 |
|
|
struct roff *roff; /* roff parser (!NULL) */ |
struct roff *roff; /* roff parser (!NULL) */ |
struct roff_man *man; /* man parser */ |
struct roff_man *man; /* man parser */ |
char *sodest; /* filename pointed to by .so */ |
char *sodest; /* filename pointed to by .so */ |
const char *file; /* filename of current input file */ |
|
struct buf *primary; /* buffer currently being parsed */ |
struct buf *primary; /* buffer currently being parsed */ |
struct buf *secondary; /* copy of top level input */ |
struct buf *secondary; /* copy of top level input */ |
struct buf *loop; /* open .while request line */ |
struct buf *loop; /* open .while request line */ |
const char *os_s; /* default operating system */ |
const char *os_s; /* default operating system */ |
mandocmsg mmsg; /* warning/error message handler */ |
|
enum mandoclevel file_status; /* status of current parse */ |
|
enum mandocerr mmin; /* ignore messages below this */ |
|
int options; /* parser options */ |
int options; /* parser options */ |
int gzip; /* current input file is gzipped */ |
int gzip; /* current input file is gzipped */ |
int filenc; /* encoding of the current file */ |
int filenc; /* encoding of the current file */ |
Line 67 static void choose_parser(struct mparse *); |
|
Line 63 static void choose_parser(struct mparse *); |
|
static void free_buf_list(struct buf *); |
static void free_buf_list(struct buf *); |
static void resize_buf(struct buf *, size_t); |
static void resize_buf(struct buf *, size_t); |
static int mparse_buf_r(struct mparse *, struct buf, size_t, int); |
static int mparse_buf_r(struct mparse *, struct buf, size_t, int); |
static int read_whole_file(struct mparse *, const char *, int, |
static int read_whole_file(struct mparse *, int, struct buf *, int *); |
struct buf *, int *); |
|
static void mparse_end(struct mparse *); |
static void mparse_end(struct mparse *); |
static void mparse_parse_buffer(struct mparse *, struct buf, |
|
const char *); |
|
|
|
static const enum mandocerr mandoclimits[MANDOCLEVEL_MAX] = { |
|
MANDOCERR_OK, |
|
MANDOCERR_OK, |
|
MANDOCERR_WARNING, |
|
MANDOCERR_ERROR, |
|
MANDOCERR_UNSUPP, |
|
MANDOCERR_MAX, |
|
MANDOCERR_MAX |
|
}; |
|
|
|
static const char * const mandocerrs[MANDOCERR_MAX] = { |
|
"ok", |
|
|
|
"base system convention", |
|
|
|
"Mdocdate found", |
|
"Mdocdate missing", |
|
"unknown architecture", |
|
"operating system explicitly specified", |
|
"RCS id missing", |
|
"referenced manual not found", |
|
|
|
"generic style suggestion", |
|
|
|
"legacy man(7) date format", |
|
"normalizing date format to", |
|
"lower case character in document title", |
|
"duplicate RCS id", |
|
"possible typo in section name", |
|
"unterminated quoted argument", |
|
"useless macro", |
|
"consider using OS macro", |
|
"errnos out of order", |
|
"duplicate errno", |
|
"trailing delimiter", |
|
"no blank before trailing delimiter", |
|
"fill mode already enabled, skipping", |
|
"fill mode already disabled, skipping", |
|
"verbatim \"--\", maybe consider using \\(em", |
|
"function name without markup", |
|
"whitespace at end of input line", |
|
"bad comment style", |
|
|
|
"generic warning", |
|
|
|
/* related to the prologue */ |
|
"missing manual title, using UNTITLED", |
|
"missing manual title, using \"\"", |
|
"missing manual section, using \"\"", |
|
"unknown manual section", |
|
"missing date, using today's date", |
|
"cannot parse date, using it verbatim", |
|
"date in the future, using it anyway", |
|
"missing Os macro, using \"\"", |
|
"late prologue macro", |
|
"prologue macros out of order", |
|
|
|
/* related to document structure */ |
|
".so is fragile, better use ln(1)", |
|
"no document body", |
|
"content before first section header", |
|
"first section is not \"NAME\"", |
|
"NAME section without Nm before Nd", |
|
"NAME section without description", |
|
"description not at the end of NAME", |
|
"bad NAME section content", |
|
"missing comma before name", |
|
"missing description line, using \"\"", |
|
"description line outside NAME section", |
|
"sections out of conventional order", |
|
"duplicate section title", |
|
"unexpected section", |
|
"cross reference to self", |
|
"unusual Xr order", |
|
"unusual Xr punctuation", |
|
"AUTHORS section without An macro", |
|
|
|
/* related to macros and nesting */ |
|
"obsolete macro", |
|
"macro neither callable nor escaped", |
|
"skipping paragraph macro", |
|
"moving paragraph macro out of list", |
|
"skipping no-space macro", |
|
"blocks badly nested", |
|
"nested displays are not portable", |
|
"moving content out of list", |
|
"first macro on line", |
|
"line scope broken", |
|
"skipping blank line in line scope", |
|
|
|
/* related to missing macro arguments */ |
|
"skipping empty request", |
|
"conditional request controls empty scope", |
|
"skipping empty macro", |
|
"empty block", |
|
"empty argument, using 0n", |
|
"missing display type, using -ragged", |
|
"list type is not the first argument", |
|
"missing -width in -tag list, using 6n", |
|
"missing utility name, using \"\"", |
|
"missing function name, using \"\"", |
|
"empty head in list item", |
|
"empty list item", |
|
"missing argument, using next line", |
|
"missing font type, using \\fR", |
|
"unknown font type, using \\fR", |
|
"nothing follows prefix", |
|
"empty reference block", |
|
"missing section argument", |
|
"missing -std argument, adding it", |
|
"missing option string, using \"\"", |
|
"missing resource identifier, using \"\"", |
|
"missing eqn box, using \"\"", |
|
|
|
/* related to bad macro arguments */ |
|
"duplicate argument", |
|
"skipping duplicate argument", |
|
"skipping duplicate display type", |
|
"skipping duplicate list type", |
|
"skipping -width argument", |
|
"wrong number of cells", |
|
"unknown AT&T UNIX version", |
|
"comma in function argument", |
|
"parenthesis in function name", |
|
"unknown library name", |
|
"invalid content in Rs block", |
|
"invalid Boolean argument", |
|
"argument contains two font escapes", |
|
"unknown font, skipping request", |
|
"odd number of characters in request", |
|
|
|
/* related to plain text */ |
|
"blank line in fill mode, using .sp", |
|
"tab in filled text", |
|
"new sentence, new line", |
|
"invalid escape sequence", |
|
"undefined string, using \"\"", |
|
|
|
/* related to tables */ |
|
"tbl line starts with span", |
|
"tbl column starts with span", |
|
"skipping vertical bar in tbl layout", |
|
|
|
"generic error", |
|
|
|
/* related to tables */ |
|
"non-alphabetic character in tbl options", |
|
"skipping unknown tbl option", |
|
"missing tbl option argument", |
|
"wrong tbl option argument size", |
|
"empty tbl layout", |
|
"invalid character in tbl layout", |
|
"unmatched parenthesis in tbl layout", |
|
"tbl without any data cells", |
|
"ignoring data in spanned tbl cell", |
|
"ignoring extra tbl data cells", |
|
"data block open at end of tbl", |
|
|
|
/* related to document structure and macros */ |
|
NULL, |
|
"duplicate prologue macro", |
|
"skipping late title macro", |
|
"input stack limit exceeded, infinite loop?", |
|
"skipping bad character", |
|
"skipping unknown macro", |
|
"ignoring request outside macro", |
|
"skipping insecure request", |
|
"skipping item outside list", |
|
"skipping column outside column list", |
|
"skipping end of block that is not open", |
|
"fewer RS blocks open, skipping", |
|
"inserting missing end of block", |
|
"appending missing end of block", |
|
|
|
/* related to request and macro arguments */ |
|
"escaped character not allowed in a name", |
|
"using macro argument outside macro", |
|
"argument number is not numeric", |
|
"NOT IMPLEMENTED: Bd -file", |
|
"skipping display without arguments", |
|
"missing list type, using -item", |
|
"argument is not numeric, using 1", |
|
"argument is not a character", |
|
"missing manual name, using \"\"", |
|
"uname(3) system call failed, using UNKNOWN", |
|
"unknown standard specifier", |
|
"skipping request without numeric argument", |
|
"excessive shift", |
|
"NOT IMPLEMENTED: .so with absolute path or \"..\"", |
|
".so request failed", |
|
"skipping all arguments", |
|
"skipping excess arguments", |
|
"divide by zero", |
|
|
|
"unsupported feature", |
|
"input too large", |
|
"unsupported control character", |
|
"unsupported roff request", |
|
"nested .while loops", |
|
"end of scope with open .while loop", |
|
"end of .while loop in inner scope", |
|
"cannot continue this .while loop", |
|
"eqn delim option in tbl", |
|
"unsupported tbl layout modifier", |
|
"ignoring macro in table", |
|
}; |
|
|
|
static const char * const mandoclevels[MANDOCLEVEL_MAX] = { |
|
"SUCCESS", |
|
"STYLE", |
|
"WARNING", |
|
"ERROR", |
|
"UNSUPP", |
|
"BADARG", |
|
"SYSERR" |
|
}; |
|
|
|
|
|
static void |
static void |
resize_buf(struct buf *buf, size_t initial) |
resize_buf(struct buf *buf, size_t initial) |
{ |
{ |
Line 370 mparse_buf_r(struct mparse *curp, struct buf blk, size |
|
Line 146 mparse_buf_r(struct mparse *curp, struct buf blk, size |
|
{ |
{ |
struct buf ln; |
struct buf ln; |
struct buf *firstln, *lastln, *thisln, *loop; |
struct buf *firstln, *lastln, *thisln, *loop; |
const char *save_file; |
|
char *cp; |
char *cp; |
size_t pos; /* byte number in the ln buffer */ |
size_t pos; /* byte number in the ln buffer */ |
int line_result, result; |
int line_result, result; |
|
|
curp->sodest = mandoc_strdup(ln.buf + of); |
curp->sodest = mandoc_strdup(ln.buf + of); |
goto out; |
goto out; |
} |
} |
save_file = curp->file; |
|
if ((fd = mparse_open(curp, ln.buf + of)) != -1) { |
if ((fd = mparse_open(curp, ln.buf + of)) != -1) { |
mparse_readfd(curp, fd, ln.buf + of); |
mparse_readfd(curp, fd, ln.buf + of); |
close(fd); |
close(fd); |
curp->file = save_file; |
|
} else { |
} else { |
curp->file = save_file; |
|
mandoc_vmsg(MANDOCERR_SO_FAIL, |
mandoc_vmsg(MANDOCERR_SO_FAIL, |
curp, curp->line, pos, |
curp, curp->line, pos, |
".so %s", ln.buf + of); |
".so %s", ln.buf + of); |
|
|
} |
} |
|
|
static int |
static int |
read_whole_file(struct mparse *curp, const char *file, int fd, |
read_whole_file(struct mparse *curp, int fd, struct buf *fb, int *with_mmap) |
struct buf *fb, int *with_mmap) |
|
{ |
{ |
struct stat st; |
struct stat st; |
gzFile gz; |
gzFile gz; |
Line 765 mparse_end(struct mparse *curp) |
|
Line 536 mparse_end(struct mparse *curp) |
|
roff_endparse(curp->roff); |
roff_endparse(curp->roff); |
} |
} |
|
|
static void |
/* |
mparse_parse_buffer(struct mparse *curp, struct buf blk, const char *file) |
* Read the whole file into memory and call the parsers. |
|
* Called recursively when an .so request is encountered. |
|
*/ |
|
void |
|
mparse_readfd(struct mparse *curp, int fd, const char *filename) |
{ |
{ |
struct buf *svprimary; |
|
const char *svfile; |
|
size_t offset; |
|
static int recursion_depth; |
static int recursion_depth; |
|
|
if (64 < recursion_depth) { |
struct buf blk; |
|
struct buf *save_primary; |
|
const char *save_filename; |
|
size_t offset; |
|
int save_filenc, save_lineno; |
|
int with_mmap; |
|
|
|
if (recursion_depth > 64) { |
mandoc_msg(MANDOCERR_ROFFLOOP, curp, curp->line, 0, NULL); |
mandoc_msg(MANDOCERR_ROFFLOOP, curp, curp->line, 0, NULL); |
return; |
return; |
} |
} |
|
if (read_whole_file(curp, fd, &blk, &with_mmap) == 0) |
|
return; |
|
|
/* Line number is per-file. */ |
/* |
svfile = curp->file; |
* Save some properties of the parent file. |
curp->file = file; |
*/ |
svprimary = curp->primary; |
|
|
save_primary = curp->primary; |
|
save_filenc = curp->filenc; |
|
save_lineno = curp->line; |
|
save_filename = mandoc_msg_getinfilename(); |
|
|
curp->primary = &blk; |
curp->primary = &blk; |
|
curp->filenc = curp->options & (MPARSE_UTF8 | MPARSE_LATIN1); |
curp->line = 1; |
curp->line = 1; |
recursion_depth++; |
mandoc_msg_setinfilename(filename); |
|
|
/* Skip an UTF-8 byte order mark. */ |
/* Skip an UTF-8 byte order mark. */ |
if (curp->filenc & MPARSE_UTF8 && blk.sz > 2 && |
if (curp->filenc & MPARSE_UTF8 && blk.sz > 2 && |
Line 796 mparse_parse_buffer(struct mparse *curp, struct buf bl |
|
Line 583 mparse_parse_buffer(struct mparse *curp, struct buf bl |
|
} else |
} else |
offset = 0; |
offset = 0; |
|
|
|
recursion_depth++; |
mparse_buf_r(curp, blk, offset, 1); |
mparse_buf_r(curp, blk, offset, 1); |
|
|
if (--recursion_depth == 0) |
if (--recursion_depth == 0) |
mparse_end(curp); |
mparse_end(curp); |
|
|
curp->primary = svprimary; |
/* |
curp->file = svfile; |
* Clean up and restore saved parent properties. |
} |
*/ |
|
|
enum mandoclevel |
if (with_mmap) |
mparse_readmem(struct mparse *curp, void *buf, size_t len, |
munmap(blk.buf, blk.sz); |
const char *file) |
else |
{ |
free(blk.buf); |
struct buf blk; |
|
|
|
blk.buf = buf; |
curp->primary = save_primary; |
blk.sz = len; |
curp->filenc = save_filenc; |
|
curp->line = save_lineno; |
mparse_parse_buffer(curp, blk, file); |
if (save_filename != NULL) |
return curp->file_status; |
mandoc_msg_setinfilename(save_filename); |
} |
} |
|
|
/* |
|
* Read the whole file into memory and call the parsers. |
|
* Called recursively when an .so request is encountered. |
|
*/ |
|
enum mandoclevel |
|
mparse_readfd(struct mparse *curp, int fd, const char *file) |
|
{ |
|
struct buf blk; |
|
int with_mmap; |
|
int save_filenc; |
|
|
|
if (read_whole_file(curp, file, fd, &blk, &with_mmap)) { |
|
save_filenc = curp->filenc; |
|
curp->filenc = curp->options & |
|
(MPARSE_UTF8 | MPARSE_LATIN1); |
|
mparse_parse_buffer(curp, blk, file); |
|
curp->filenc = save_filenc; |
|
if (with_mmap) |
|
munmap(blk.buf, blk.sz); |
|
else |
|
free(blk.buf); |
|
} |
|
return curp->file_status; |
|
} |
|
|
|
int |
int |
mparse_open(struct mparse *curp, const char *file) |
mparse_open(struct mparse *curp, const char *file) |
{ |
{ |
char *cp; |
char *cp; |
int fd; |
int fd; |
|
|
curp->file = file; |
|
cp = strrchr(file, '.'); |
cp = strrchr(file, '.'); |
curp->gzip = (cp != NULL && ! strcmp(cp + 1, "gz")); |
curp->gzip = (cp != NULL && ! strcmp(cp + 1, "gz")); |
|
|
Line 880 mparse_open(struct mparse *curp, const char *file) |
|
Line 640 mparse_open(struct mparse *curp, const char *file) |
|
} |
} |
|
|
struct mparse * |
struct mparse * |
mparse_alloc(int options, enum mandocerr mmin, mandocmsg mmsg, |
mparse_alloc(int options, enum mandoc_os os_e, const char *os_s) |
enum mandoc_os os_e, const char *os_s) |
|
{ |
{ |
struct mparse *curp; |
struct mparse *curp; |
|
|
curp = mandoc_calloc(1, sizeof(struct mparse)); |
curp = mandoc_calloc(1, sizeof(struct mparse)); |
|
|
curp->options = options; |
curp->options = options; |
curp->mmin = mmin; |
|
curp->mmsg = mmsg; |
|
curp->os_s = os_s; |
curp->os_s = os_s; |
|
|
curp->roff = roff_alloc(curp, options); |
curp->roff = roff_alloc(curp, options); |
Line 916 mparse_reset(struct mparse *curp) |
|
Line 673 mparse_reset(struct mparse *curp) |
|
roff_man_reset(curp->man); |
roff_man_reset(curp->man); |
free_buf_list(curp->secondary); |
free_buf_list(curp->secondary); |
curp->secondary = NULL; |
curp->secondary = NULL; |
|
|
free(curp->sodest); |
free(curp->sodest); |
curp->sodest = NULL; |
curp->sodest = NULL; |
|
|
curp->file_status = MANDOCLEVEL_OK; |
|
curp->gzip = 0; |
curp->gzip = 0; |
} |
} |
|
|
Line 947 mparse_result(struct mparse *curp, struct roff_man **m |
|
Line 701 mparse_result(struct mparse *curp, struct roff_man **m |
|
} |
} |
if (man) |
if (man) |
*man = curp->man; |
*man = curp->man; |
} |
|
|
|
void |
|
mparse_updaterc(struct mparse *curp, enum mandoclevel *rc) |
|
{ |
|
if (curp->file_status > *rc) |
|
*rc = curp->file_status; |
|
} |
|
|
|
void |
|
mandoc_vmsg(enum mandocerr t, struct mparse *m, |
|
int ln, int pos, const char *fmt, ...) |
|
{ |
|
char buf[256]; |
|
va_list ap; |
|
|
|
va_start(ap, fmt); |
|
(void)vsnprintf(buf, sizeof(buf), fmt, ap); |
|
va_end(ap); |
|
|
|
mandoc_msg(t, m, ln, pos, buf); |
|
} |
|
|
|
void |
|
mandoc_msg(enum mandocerr er, struct mparse *m, |
|
int ln, int col, const char *msg) |
|
{ |
|
enum mandoclevel level; |
|
|
|
if (er < m->mmin && er != MANDOCERR_FILE) |
|
return; |
|
|
|
level = MANDOCLEVEL_UNSUPP; |
|
while (er < mandoclimits[level]) |
|
level--; |
|
|
|
if (m->mmsg) |
|
(*m->mmsg)(er, level, m->file, ln, col, msg); |
|
|
|
if (m->file_status < level) |
|
m->file_status = level; |
|
} |
|
|
|
const char * |
|
mparse_strerror(enum mandocerr er) |
|
{ |
|
|
|
return mandocerrs[er]; |
|
} |
|
|
|
const char * |
|
mparse_strlevel(enum mandoclevel lvl) |
|
{ |
|
return mandoclevels[lvl]; |
|
} |
} |
|
|
void |
void |