[BACK]Return to tag.c CVS log [TXT][DIR] Up to [cvsweb.bsd.lv] / mandoc

Diff for /mandoc/tag.c between version 1.27 and 1.28

version 1.27, 2020/01/20 10:37:15 version 1.28, 2020/03/13 15:32:29
Line 1 
Line 1 
 /*      $Id$ */  /* $Id$ */
 /*  /*
  * Copyright (c) 2015,2016,2018,2019,2020 Ingo Schwarze <schwarze@openbsd.org>   * Copyright (c) 2015,2016,2018,2019,2020 Ingo Schwarze <schwarze@openbsd.org>
  *   *
Line 13 
Line 13 
  * 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
  * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.   * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
    *
    * Functions to tag syntax tree nodes.
    * For internal use by mandoc(1) validation modules only.
  */   */
 #include "config.h"  #include "config.h"
   
 #include <sys/types.h>  #include <sys/types.h>
   
 #include <assert.h>  #include <assert.h>
 #include <errno.h>  
 #include <limits.h>  #include <limits.h>
 #include <signal.h>  
 #include <stddef.h>  #include <stddef.h>
 #include <stdint.h>  
 #include <stdio.h>  
 #include <stdlib.h>  #include <stdlib.h>
 #include <string.h>  #include <string.h>
 #include <unistd.h>  
   
 #include "mandoc_aux.h"  #include "mandoc_aux.h"
 #include "mandoc_ohash.h"  #include "mandoc_ohash.h"
 #include "mandoc.h"  #include "roff.h"
 #include "tag.h"  #include "tag.h"
   
 struct tag_entry {  struct tag_entry {
         size_t  *lines;          struct roff_node **nodes;
         size_t   maxlines;          size_t   maxnodes;
         size_t   nlines;          size_t   nnodes;
         int      prio;          int      prio;
         char     s[];          char     s[];
 };  };
   
 static  void     tag_signal(int) __attribute__((__noreturn__));  
   
 static struct ohash      tag_data;  static struct ohash      tag_data;
 static struct tag_files  tag_files;  
   
   
 /*  /*
  * Prepare for using a pager.   * Set up the ohash table to collect nodes
  * Not all pagers are capable of using a tag file,   * where various marked-up terms are documented.
  * but for simplicity, create it anyway.  
  */   */
 struct tag_files *  void
 tag_init(char *tagname)  tag_alloc(void)
 {  {
         struct sigaction         sa;          mandoc_ohash_init(&tag_data, 4, offsetof(struct tag_entry, s));
         int                      ofd;  }
   
         ofd = -1;  void
         tag_files.tfd = -1;  tag_free(void)
         tag_files.tcpgid = -1;  {
         tag_files.tagname = tagname;          struct tag_entry        *entry;
           unsigned int             slot;
   
         /* Clean up when dying from a signal. */          entry = ohash_first(&tag_data, &slot);
           while (entry != NULL) {
         memset(&sa, 0, sizeof(sa));                  free(entry->nodes);
         sigfillset(&sa.sa_mask);                  free(entry);
         sa.sa_handler = tag_signal;                  entry = ohash_next(&tag_data, &slot);
         sigaction(SIGHUP, &sa, NULL);  
         sigaction(SIGINT, &sa, NULL);  
         sigaction(SIGTERM, &sa, NULL);  
   
         /*  
          * POSIX requires that a process calling tcsetpgrp(3)  
          * from the background gets a SIGTTOU signal.  
          * In that case, do not stop.  
          */  
   
         sa.sa_handler = SIG_IGN;  
         sigaction(SIGTTOU, &sa, NULL);  
   
         /* Save the original standard output for use by the pager. */  
   
         if ((tag_files.ofd = dup(STDOUT_FILENO)) == -1) {  
                 mandoc_msg(MANDOCERR_DUP, 0, 0, "%s", strerror(errno));  
                 goto fail;  
         }          }
           ohash_delete(&tag_data);
         /* Create both temporary output files. */  
   
         (void)strlcpy(tag_files.ofn, "/tmp/man.XXXXXXXXXX",  
             sizeof(tag_files.ofn));  
         (void)strlcpy(tag_files.tfn, "/tmp/man.XXXXXXXXXX",  
             sizeof(tag_files.tfn));  
         if ((ofd = mkstemp(tag_files.ofn)) == -1) {  
                 mandoc_msg(MANDOCERR_MKSTEMP, 0, 0,  
                     "%s: %s", tag_files.ofn, strerror(errno));  
                 goto fail;  
         }  
         if ((tag_files.tfd = mkstemp(tag_files.tfn)) == -1) {  
                 mandoc_msg(MANDOCERR_MKSTEMP, 0, 0,  
                     "%s: %s", tag_files.tfn, strerror(errno));  
                 goto fail;  
         }  
         if (dup2(ofd, STDOUT_FILENO) == -1) {  
                 mandoc_msg(MANDOCERR_DUP, 0, 0, "%s", strerror(errno));  
                 goto fail;  
         }  
         close(ofd);  
   
         /*  
          * Set up the ohash table to collect output line numbers  
          * where various marked-up terms are documented.  
          */  
   
         mandoc_ohash_init(&tag_data, 4, offsetof(struct tag_entry, s));  
         return &tag_files;  
   
 fail:  
         tag_unlink();  
         if (ofd != -1)  
                 close(ofd);  
         if (tag_files.ofd != -1)  
                 close(tag_files.ofd);  
         if (tag_files.tfd != -1)  
                 close(tag_files.tfd);  
         *tag_files.ofn = '\0';  
         *tag_files.tfn = '\0';  
         tag_files.ofd = -1;  
         tag_files.tfd = -1;  
         tag_files.tagname = NULL;  
         return NULL;  
 }  }
   
 /*  /*
  * Set the line number where a term is defined,   * Set a node where a term is defined,
  * unless it is already defined at a lower priority.   * unless it is already defined at a lower priority.
  */   */
 void  void
 tag_put(const char *s, int prio, size_t line)  tag_put(const char *s, int prio, struct roff_node *n)
 {  {
         struct tag_entry        *entry;          struct tag_entry        *entry;
         const char              *se;          const char              *se;
Line 148  tag_put(const char *s, int prio, size_t line)
Line 81  tag_put(const char *s, int prio, size_t line)
         unsigned int             slot;          unsigned int             slot;
   
         assert(prio <= TAG_FALLBACK);          assert(prio <= TAG_FALLBACK);
         if (tag_files.tfd <= 0)  
                 return;  
   
         if (s[0] == '\\' && (s[1] == '&' || s[1] == 'e'))          if (s == NULL) {
                 s += 2;                  if (n->child == NULL || n->child->type != ROFFT_TEXT)
                           return;
                   s = n->child->string;
                   if (s[0] == '\\' && (s[1] == '&' || s[1] == 'e'))
                           s += 2;
           }
   
         /*          /*
          * Skip whitespace and escapes and whatever follows,           * Skip whitespace and escapes and whatever follows,
Line 170  tag_put(const char *s, int prio, size_t line)
Line 106  tag_put(const char *s, int prio, size_t line)
         slot = ohash_qlookupi(&tag_data, s, &se);          slot = ohash_qlookupi(&tag_data, s, &se);
         entry = ohash_find(&tag_data, slot);          entry = ohash_find(&tag_data, slot);
   
         if (entry == NULL) {          /* Build a new entry. */
   
                 /* Build a new entry. */          if (entry == NULL) {
   
                 entry = mandoc_malloc(sizeof(*entry) + len + 1);                  entry = mandoc_malloc(sizeof(*entry) + len + 1);
                 memcpy(entry->s, s, len);                  memcpy(entry->s, s, len);
                 entry->s[len] = '\0';                  entry->s[len] = '\0';
                 entry->lines = NULL;                  entry->nodes = NULL;
                 entry->maxlines = entry->nlines = 0;                  entry->maxnodes = entry->nnodes = 0;
                 ohash_insert(&tag_data, slot, entry);                  ohash_insert(&tag_data, slot, entry);
           }
   
         } else {          /*
            * Lower priority numbers take precedence.
            * If a better entry is already present, ignore the new one.
            */
   
                 /*          else if (entry->prio < prio)
                  * Lower priority numbers take precedence,  
                  * but TAG_FALLBACK is special.  
                  * A tag with priority TAG_FALLBACK is only used  
                  * if the tag occurs exactly once.  
                  */  
   
                 if (prio == TAG_FALLBACK) {  
                         if (entry->prio == TAG_FALLBACK)  
                                 entry->prio = TAG_DELETE;  
                         return;                          return;
                 }  
   
                 /* A better entry is already present, ignore the new one. */          /*
            * If the existing entry is worse, clear it.
            * In addition, a tag with priority TAG_FALLBACK
            * is only used if the tag occurs exactly once.
            */
   
                 if (entry->prio < prio)          else if (entry->prio > prio || prio == TAG_FALLBACK) {
                         return;                  while (entry->nnodes > 0)
                           entry->nodes[--entry->nnodes]->flags &= ~NODE_ID;
   
                 /* The existing entry is worse, clear it. */                  if (prio == TAG_FALLBACK) {
                           entry->prio = TAG_DELETE;
                 if (entry->prio > prio)                          return;
                         entry->nlines = 0;                  }
         }          }
   
         /* Remember the new line. */          /* Remember the new node. */
   
         if (entry->maxlines == entry->nlines) {          if (entry->maxnodes == entry->nnodes) {
                 entry->maxlines += 4;                  entry->maxnodes += 4;
                 entry->lines = mandoc_reallocarray(entry->lines,                  entry->nodes = mandoc_reallocarray(entry->nodes,
                     entry->maxlines, sizeof(*entry->lines));                      entry->maxnodes, sizeof(*entry->nodes));
         }          }
         entry->lines[entry->nlines++] = line;          entry->nodes[entry->nnodes++] = n;
         entry->prio = prio;          entry->prio = prio;
 }          n->flags |= NODE_ID;
           if (n->child == NULL || n->child->string != s || *se != '\0') {
 /*                  assert(n->string == NULL);
  * Write out the tags file using the previously collected                  n->string = mandoc_strndup(s, len);
  * information and clear the ohash table while going along.  
  */  
 void  
 tag_write(void)  
 {  
         FILE                    *stream;  
         struct tag_entry        *entry;  
         size_t                   i;  
         unsigned int             slot;  
         int                      empty;  
   
         if (tag_files.tfd <= 0)  
                 return;  
         if (tag_files.tagname != NULL && ohash_find(&tag_data,  
             ohash_qlookup(&tag_data, tag_files.tagname)) == NULL) {  
                 mandoc_msg(MANDOCERR_TAG, 0, 0, "%s", tag_files.tagname);  
                 tag_files.tagname = NULL;  
         }          }
         if ((stream = fdopen(tag_files.tfd, "w")) == NULL)  
                 mandoc_msg(MANDOCERR_FDOPEN, 0, 0, "%s", strerror(errno));  
         empty = 1;  
         entry = ohash_first(&tag_data, &slot);  
         while (entry != NULL) {  
                 if (stream != NULL && entry->prio < TAG_DELETE) {  
                         for (i = 0; i < entry->nlines; i++) {  
                                 fprintf(stream, "%s %s %zu\n",  
                                     entry->s, tag_files.ofn, entry->lines[i]);  
                                 empty = 0;  
                         }  
                 }  
                 free(entry->lines);  
                 free(entry);  
                 entry = ohash_next(&tag_data, &slot);  
         }  
         ohash_delete(&tag_data);  
         if (stream != NULL)  
                 fclose(stream);  
         else  
                 close(tag_files.tfd);  
         tag_files.tfd = -1;  
         if (empty) {  
                 unlink(tag_files.tfn);  
                 *tag_files.tfn = '\0';  
         }  
 }  }
   
 void  enum tag_result
 tag_unlink(void)  tag_check(const char *test_tag)
 {  {
         pid_t    tc_pgid;          unsigned int slot;
   
         if (tag_files.tcpgid != -1) {          if (ohash_first(&tag_data, &slot) == NULL)
                 tc_pgid = tcgetpgrp(tag_files.ofd);                  return TAG_EMPTY;
                 if (tc_pgid == tag_files.pager_pid ||          else if (test_tag != NULL && ohash_find(&tag_data,
                     tc_pgid == getpgid(0) ||              ohash_qlookup(&tag_data, test_tag)) == NULL)
                     getpgid(tc_pgid) == -1)                  return TAG_MISS;
                         (void)tcsetpgrp(tag_files.ofd, tag_files.tcpgid);          else
         }                  return TAG_OK;
         if (*tag_files.ofn != '\0')  
                 unlink(tag_files.ofn);  
         if (*tag_files.tfn != '\0')  
                 unlink(tag_files.tfn);  
 }  
   
 static void  
 tag_signal(int signum)  
 {  
         struct sigaction         sa;  
   
         tag_unlink();  
         memset(&sa, 0, sizeof(sa));  
         sigemptyset(&sa.sa_mask);  
         sa.sa_handler = SIG_DFL;  
         sigaction(signum, &sa, NULL);  
         kill(getpid(), signum);  
         /* NOTREACHED */  
         _exit(1);  
 }  }

Legend:
Removed from v.1.27  
changed lines
  Added in v.1.28

CVSweb