[adns] / src / setup.c

/*
 * setup.c
 * - configuration file parsing
 * - management of global state
 */
/*
 *  This file is
 *    Copyright (C) 1997-1999 Ian Jackson <ian@davenant.greenend.org.uk>
 *
 *  It is part of adns, which is
 *    Copyright (C) 1997-2000 Ian Jackson <ian@davenant.greenend.org.uk>
 *    Copyright (C) 1999-2000 Tony Finch <dot@dotat.at>
 *  
 *  This program is free software; you can redistribute it and/or modify
 *  it under the terms of the GNU General Public License as published by
 *  the Free Software Foundation; either version 2, or (at your option)
 *  any later version.
 *  
 *  This program is distributed in the hope that it will be useful,
 *  but WITHOUT ANY WARRANTY; without even the implied warranty of
 *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 *  GNU General Public License for more details.
 *  
 *  You should have received a copy of the GNU General Public License
 *  along with this program; if not, write to the Free Software Foundation,
 *  Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. 
 */

#include <stdlib.h>
#include <errno.h>
#include <limits.h>
#include <unistd.h>
#include <fcntl.h>

#include <sys/types.h>
#include <netdb.h>
#include <sys/socket.h>
#include <netinet/in.h>
#include <arpa/inet.h>

#include "internal.h"

static void readconfig(adns_state ads, const char *filename, int warnmissing);

static void addserver(adns_state ads, struct in_addr addr) {
  int i;
  struct server *ss;
  
  for (i=0; i<ads->nservers; i++) {
    if (ads->servers[i].addr.s_addr == addr.s_addr) {
      adns__debug(ads,-1,0,"duplicate nameserver %s ignored",inet_ntoa(addr));
      return;
    }
  }
  
  if (ads->nservers>=MAXSERVERS) {
    adns__diag(ads,-1,0,"too many nameservers, ignoring %s",inet_ntoa(addr));
    return;
  }

  ss= ads->servers+ads->nservers;
  ss->addr= addr;
  ads->nservers++;
}

static void freesearchlist(adns_state ads) {
  if (ads->nsearchlist) free(*ads->searchlist);
  free(ads->searchlist);
}

static void saveerr(adns_state ads, int en) {
  if (!ads->configerrno) ads->configerrno= en;
}

static void configparseerr(adns_state ads, const char *fn, int lno,
			   const char *fmt, ...) {
  va_list al;

  saveerr(ads,EINVAL);
  if (!ads->diagfile || (ads->iflags & adns_if_noerrprint)) return;

  if (lno==-1) fprintf(ads->diagfile,"adns: %s: ",fn);
  else fprintf(ads->diagfile,"adns: %s:%d: ",fn,lno);
  va_start(al,fmt);
  vfprintf(ads->diagfile,fmt,al);
  va_end(al);
  fputc('\n',ads->diagfile);
}

static int nextword(const char **bufp_io, const char **word_r, int *l_r) {
  const char *p, *q;

  p= *bufp_io;
  while (ctype_whitespace(*p)) p++;
  if (!*p) return 0;

  q= p;
  while (*q && !ctype_whitespace(*q)) q++;

  *l_r= q-p;
  *word_r= p;
  *bufp_io= q;

  return 1;
}

static void ccf_nameserver(adns_state ads, const char *fn, int lno, const char *buf) {
  struct in_addr ia;
  
  if (!inet_aton(buf,&ia)) {
    configparseerr(ads,fn,lno,"invalid nameserver address `%s'",buf);
    return;
  }
  adns__debug(ads,-1,0,"using nameserver %s",inet_ntoa(ia));
  addserver(ads,ia);
}

static void ccf_search(adns_state ads, const char *fn, int lno, const char *buf) {
  const char *bufp, *word;
  char *newchars, **newptrs, **pp;
  int count, tl, l;

  if (!buf) return;

  bufp= buf;
  count= 0;
  tl= 0;
  while (nextword(&bufp,&word,&l)) { count++; tl += l+1; }

  newptrs= malloc(sizeof(char*)*count);  if (!newptrs) { saveerr(ads,errno); return; }
  newchars= malloc(tl);  if (!newchars) { saveerr(ads,errno); free(newptrs); return; }

  bufp= buf;
  pp= newptrs;
  while (nextword(&bufp,&word,&l)) {
    *pp++= newchars;
    memcpy(newchars,word,l);
    newchars += l;
    *newchars++ = 0;
  }

  freesearchlist(ads);
  ads->nsearchlist= count;
  ads->searchlist= newptrs;
}

static void ccf_sortlist(adns_state ads, const char *fn, int lno, const char *buf) {
  const char *word;
  char tbuf[200], *slash, *ep;
  struct in_addr base, mask;
  int l;
  unsigned long initial, baselocal;

  if (!buf) return;
  
  ads->nsortlist= 0;
  while (nextword(&buf,&word,&l)) {
    if (ads->nsortlist >= MAXSORTLIST) {
      adns__diag(ads,-1,0,"too many sortlist entries, ignoring %.*s onwards",l,word);
      return;
    }

    if (l >= sizeof(tbuf)) {
      configparseerr(ads,fn,lno,"sortlist entry `%.*s' too long",l,word);
      continue;
    }
    
    memcpy(tbuf,word,l); tbuf[l]= 0;
    slash= strchr(tbuf,'/');
    if (slash) *slash++= 0;
    
    if (!inet_aton(tbuf,&base)) {
      configparseerr(ads,fn,lno,"invalid address `%s' in sortlist",tbuf);
      continue;
    }

    if (slash) {
      if (strchr(slash,'.')) {
	if (!inet_aton(slash,&mask)) {
	  configparseerr(ads,fn,lno,"invalid mask `%s' in sortlist",slash);
	  continue;
	}
	if (base.s_addr & ~mask.s_addr) {
	  configparseerr(ads,fn,lno,
			 "mask `%s' in sortlist overlaps address `%s'",slash,tbuf);
	  continue;
	}
      } else {
	initial= strtoul(slash,&ep,10);
	if (*ep || initial>32) {
	  configparseerr(ads,fn,lno,"mask length `%s' invalid",slash);
	  continue;
	}
	mask.s_addr= htonl((0x0ffffffffUL) << (32-initial));
      }
    } else {
      baselocal= ntohl(base.s_addr);
      if (!baselocal & 0x080000000UL) /* class A */
	mask.s_addr= htonl(0x0ff000000UL);
      else if ((baselocal & 0x0c0000000UL) == 0x080000000UL)
	mask.s_addr= htonl(0x0ffff0000UL); /* class B */
      else if ((baselocal & 0x0f0000000UL) == 0x0e0000000UL)
	mask.s_addr= htonl(0x0ff000000UL); /* class C */
      else {
	configparseerr(ads,fn,lno,
		       "network address `%s' in sortlist is not in classed ranges,"
		       " must specify mask explicitly", tbuf);
	continue;
      }
    }

    ads->sortlist[ads->nsortlist].base= base;
    ads->sortlist[ads->nsortlist].mask= mask;
    ads->nsortlist++;
  }
}

static void ccf_options(adns_state ads, const char *fn, int lno, const char *buf) {
  const char *word;
  char *ep;
  unsigned long v;
  int l;

  if (!buf) return;

  while (nextword(&buf,&word,&l)) {
    if (l==5 && !memcmp(word,"debug",5)) {
      ads->iflags |= adns_if_debug;
      continue;
    }
    if (l>=6 && !memcmp(word,"ndots:",6)) {
      v= strtoul(word+6,&ep,10);
      if (l==6 || ep != word+l || v > INT_MAX) {
	configparseerr(ads,fn,lno,"option `%.*s' malformed or has bad value",l,word);
	continue;
      }
      ads->searchndots= v;
      continue;
    }
    if (l>=12 && !memcmp(word,"adns_checkc:",12)) {
      if (!strcmp(word+12,"none")) {
	ads->iflags &= ~adns_if_checkc_freq;
	ads->iflags |= adns_if_checkc_entex;
      } else if (!strcmp(word+12,"entex")) {
	ads->iflags &= ~adns_if_checkc_freq;
	ads->iflags |= adns_if_checkc_entex;
      } else if (!strcmp(word+12,"freq")) {
	ads->iflags |= adns_if_checkc_freq;
      } else {
	configparseerr(ads,fn,lno, "option adns_checkc has bad value `%s' "
		       "(must be none, entex or freq", word+12);
      }
      continue;
    }
    adns__diag(ads,-1,0,"%s:%d: unknown option `%.*s'", fn,lno, l,word);
  }
}

static void ccf_clearnss(adns_state ads, const char *fn, int lno, const char *buf) {
  ads->nservers= 0;
}

static void ccf_include(adns_state ads, const char *fn, int lno, const char *buf) {
  if (!*buf) {
    configparseerr(ads,fn,lno,"`include' directive with no filename");
    return;
  }
  readconfig(ads,buf,1);
}

static void ccf_lookup(adns_state ads, const char *fn, int lno,
		       const char *buf) {
  int found_bind=0;
  const char *word;
  int l;

  if (!*buf) {
    configparseerr(ads,fn,lno,"`lookup' directive with no databases");
    return;
  }

  while (nextword(&buf,&word,&l)) {
    if (l==4 && !memcmp(word,"bind",4)) {
      found_bind=1;
    } else if (l==4 && !memcmp(word,"file",4)) {
      /* ignore this and hope /etc/hosts is not essential */
    } else if (l==2 && !memcmp(word,"yp",2)) {
      adns__diag(ads,-1,0,"%s:%d: yp lookups not supported by adns", fn,lno);
      found_bind=-1;
    } else {
      adns__diag(ads,-1,0,"%s:%d: unknown `lookup' database `%.*s'",
		 fn,lno, l,word);
      found_bind=-1;
    }
  }
  if (!found_bind)
    adns__diag(ads,-1,0,"%s:%d: `lookup' specified, but not `bind'", fn,lno);
}

static const struct configcommandinfo {
  const char *name;
  void (*fn)(adns_state ads, const char *fn, int lno, const char *buf);
} configcommandinfos[]= {
  { "nameserver",        ccf_nameserver  },
  { "domain",            ccf_search      },
  { "search",            ccf_search      },
  { "sortlist",          ccf_sortlist    },
  { "options",           ccf_options     },
  { "clearnameservers",  ccf_clearnss    },
  { "include",           ccf_include     },
  { "lookup",            ccf_lookup      }, /* OpenBSD */
  {  0                                   }
};

typedef union {
  FILE *file;
  const char *text;
} getline_ctx;

static int gl_file(adns_state ads, getline_ctx *src_io, const char *filename,
		   int lno, char *buf, int buflen) {
  FILE *file= src_io->file;
  int c, i;
  char *p;

  p= buf;
  buflen--;
  i= 0;
    
  for (;;) { /* loop over chars */
    if (i == buflen) {
      adns__diag(ads,-1,0,"%s:%d: line too long, ignored",filename,lno);
      goto x_badline;
    }
    c= getc(file);
    if (!c) {
      adns__diag(ads,-1,0,"%s:%d: line contains nul, ignored",filename,lno);
      goto x_badline;
    } else if (c == '\n') {
      break;
    } else if (c == EOF) {
      if (ferror(file)) {
	saveerr(ads,errno);
	adns__diag(ads,-1,0,"%s:%d: read error: %s",filename,lno,strerror(errno));
	return -1;
      }
      if (!i) return -1;
      break;
    } else {
      *p++= c;
      i++;
    }
  }

  *p++= 0;
  return i;

 x_badline:
  saveerr(ads,EINVAL);
  while ((c= getc(file)) != EOF && c != '\n');
  return -2;
}

static int gl_text(adns_state ads, getline_ctx *src_io, const char *filename,
		   int lno, char *buf, int buflen) {
  const char *cp= src_io->text;
  int l;

  if (!cp || !*cp) return -1;

  if (*cp == ';' || *cp == '\n') cp++;
  l= strcspn(cp,";\n");
  src_io->text = cp+l;

  if (l >= buflen) {
    adns__diag(ads,-1,0,"%s:%d: line too long, ignored",filename,lno);
    saveerr(ads,EINVAL);
    return -2;
  }
    
  memcpy(buf,cp,l);
  buf[l]= 0;
  return l;
}

static void readconfiggeneric(adns_state ads, const char *filename,
			      int (*getline)(adns_state ads, getline_ctx*,
					     const char *filename, int lno,
					     char *buf, int buflen),
			      /* Returns >=0 for success, -1 for EOF or error
			       * (error will have been reported), or -2 for
			       * bad line was encountered, try again.
			       */
			      getline_ctx gl_ctx) {
  char linebuf[2000], *p, *q;
  int lno, l, dirl;
  const struct configcommandinfo *ccip;

  for (lno=1;
       (l= getline(ads,&gl_ctx, filename,lno, linebuf,sizeof(linebuf))) != -1;
       lno++) {
    if (l == -2) continue;
    while (l>0 && ctype_whitespace(linebuf[l-1])) l--;
    linebuf[l]= 0;
    p= linebuf;
    while (ctype_whitespace(*p)) p++;
    if (*p == '#' || !*p) continue;
    q= p;
    while (*q && !ctype_whitespace(*q)) q++;
    dirl= q-p;
    for (ccip=configcommandinfos;
	 ccip->name && !(strlen(ccip->name)==dirl && !memcmp(ccip->name,p,q-p));
	 ccip++);
    if (!ccip->name) {
      adns__diag(ads,-1,0,"%s:%d: unknown configuration directive `%.*s'",
		 filename,lno,q-p,p);
      continue;
    }
    while (ctype_whitespace(*q)) q++;
    ccip->fn(ads,filename,lno,q);
  }
}

static const char *instrum_getenv(adns_state ads, const char *envvar) {
  const char *value;

  value= getenv(envvar);
  if (!value) adns__debug(ads,-1,0,"environment variable %s not set",envvar);
  else adns__debug(ads,-1,0,"environment variable %s set to `%s'",envvar,value);
  return value;
}

static void readconfig(adns_state ads, const char *filename, int warnmissing) {
  getline_ctx gl_ctx;
  
  gl_ctx.file= fopen(filename,"r");
  if (!gl_ctx.file) {
    if (errno == ENOENT) {
      if (warnmissing)
	adns__debug(ads,-1,0,"configuration file `%s' does not exist",filename);
      return;
    }
    saveerr(ads,errno);
    adns__diag(ads,-1,0,"cannot open configuration file `%s': %s",
	       filename,strerror(errno));
    return;
  }

  readconfiggeneric(ads,filename,gl_file,gl_ctx);
  
  fclose(gl_ctx.file);
}

static void readconfigtext(adns_state ads, const char *text, const char *showname) {
  getline_ctx gl_ctx;
  
  gl_ctx.text= text;
  readconfiggeneric(ads,showname,gl_text,gl_ctx);
}
  
static void readconfigenv(adns_state ads, const char *envvar) {
  const char *filename;

  if (ads->iflags & adns_if_noenv) {
    adns__debug(ads,-1,0,"not checking environment variable `%s'",envvar);
    return;
  }
  filename= instrum_getenv(ads,envvar);
  if (filename) readconfig(ads,filename,1);
}

static void readconfigenvtext(adns_state ads, const char *envvar) {
  const char *textdata;

  if (ads->iflags & adns_if_noenv) {
    adns__debug(ads,-1,0,"not checking environment variable `%s'",envvar);
    return;
  }
  textdata= instrum_getenv(ads,envvar);
  if (textdata) readconfigtext(ads,textdata,envvar);
}


int adns__setnonblock(adns_state ads, int fd) {
  int r;
  
  r= fcntl(fd,F_GETFL,0); if (r<0) return errno;
  r |= O_NONBLOCK;
  r= fcntl(fd,F_SETFL,r); if (r<0) return errno;
  return 0;
}

static int init_begin(adns_state *ads_r, adns_initflags flags, FILE *diagfile) {
  adns_state ads;
  
  ads= malloc(sizeof(*ads)); if (!ads) return errno;

  ads->iflags= flags;
  ads->diagfile= diagfile;
  ads->configerrno= 0;
  LIST_INIT(ads->udpw);
  LIST_INIT(ads->tcpw);
  LIST_INIT(ads->childw);
  LIST_INIT(ads->output);
  ads->forallnext= 0;
  ads->nextid= 0x311f;
  ads->udpsocket= ads->tcpsocket= -1;
  adns__vbuf_init(&ads->tcpsend);
  adns__vbuf_init(&ads->tcprecv);
  ads->tcprecv_skip= 0;
  ads->nservers= ads->nsortlist= ads->nsearchlist= ads->tcpserver= 0;
  ads->searchndots= 1;
  ads->tcpstate= server_disconnected;
  timerclear(&ads->tcptimeout);
  ads->searchlist= 0;

  *ads_r= ads;
  return 0;
}

static int init_finish(adns_state ads) {
  struct in_addr ia;
  struct protoent *proto;
  int r;
  
  if (!ads->nservers) {
    if (ads->diagfile && ads->iflags & adns_if_debug)
      fprintf(ads->diagfile,"adns: no nameservers, using localhost\n");
    ia.s_addr= htonl(INADDR_LOOPBACK);
    addserver(ads,ia);
  }

  proto= getprotobyname("udp"); if (!proto) { r= ENOPROTOOPT; goto x_free; }
  ads->udpsocket= socket(AF_INET,SOCK_DGRAM,proto->p_proto);
  if (ads->udpsocket<0) { r= errno; goto x_free; }

  r= adns__setnonblock(ads,ads->udpsocket);
  if (r) { r= errno; goto x_closeudp; }
  
  return 0;

 x_closeudp:
  close(ads->udpsocket);
 x_free:
  free(ads);
  return r;
}

static void init_abort(adns_state ads) {
  if (ads->nsearchlist) {
    free(ads->searchlist[0]);
    free(ads->searchlist);
  }
  free(ads);
}

int adns_init(adns_state *ads_r, adns_initflags flags, FILE *diagfile) {
  adns_state ads;
  const char *res_options, *adns_res_options;
  int r;
  
  r= init_begin(&ads, flags, diagfile ? diagfile : stderr);
  if (r) return r;
  
  res_options= instrum_getenv(ads,"RES_OPTIONS");
  adns_res_options= instrum_getenv(ads,"ADNS_RES_OPTIONS");
  ccf_options(ads,"RES_OPTIONS",-1,res_options);
  ccf_options(ads,"ADNS_RES_OPTIONS",-1,adns_res_options);

  readconfig(ads,"/etc/resolv.conf",1);
  readconfig(ads,"/etc/resolv-adns.conf",0);
  readconfigenv(ads,"RES_CONF");
  readconfigenv(ads,"ADNS_RES_CONF");

  readconfigenvtext(ads,"RES_CONF_TEXT");
  readconfigenvtext(ads,"ADNS_RES_CONF_TEXT");

  ccf_options(ads,"RES_OPTIONS",-1,res_options);
  ccf_options(ads,"ADNS_RES_OPTIONS",-1,adns_res_options);

  ccf_search(ads,"LOCALDOMAIN",-1,instrum_getenv(ads,"LOCALDOMAIN"));
  ccf_search(ads,"ADNS_LOCALDOMAIN",-1,instrum_getenv(ads,"ADNS_LOCALDOMAIN"));

  if (ads->configerrno && ads->configerrno != EINVAL) {
    r= ads->configerrno;
    init_abort(ads);
    return r;
  }

  r= init_finish(ads);
  if (r) return r;

  adns__consistency(ads,0,cc_entex);
  *ads_r= ads;
  return 0;
}

int adns_init_strcfg(adns_state *ads_r, adns_initflags flags,
		     FILE *diagfile, const char *configtext) {
  adns_state ads;
  int r;

  r= init_begin(&ads, flags, diagfile);  if (r) return r;

  readconfigtext(ads,configtext,"<supplied configuration text>");
  if (ads->configerrno) {
    r= ads->configerrno;
    init_abort(ads);
    return r;
  }

  r= init_finish(ads);  if (r) return r;
  adns__consistency(ads,0,cc_entex);
  *ads_r= ads;
  return 0;
}


void adns_finish(adns_state ads) {
  adns__consistency(ads,0,cc_entex);
  for (;;) {
    if (ads->udpw.head) adns_cancel(ads->udpw.head);
    else if (ads->tcpw.head) adns_cancel(ads->tcpw.head);
    else if (ads->childw.head) adns_cancel(ads->childw.head);
    else if (ads->output.head) adns_cancel(ads->output.head);
    else break;
  }
  close(ads->udpsocket);
  if (ads->tcpsocket >= 0) close(ads->tcpsocket);
  adns__vbuf_free(&ads->tcpsend);
  adns__vbuf_free(&ads->tcprecv);
  freesearchlist(ads);
  free(ads);
}

void adns_forallqueries_begin(adns_state ads) {
  adns__consistency(ads,0,cc_entex);
  ads->forallnext=
    ads->udpw.head ? ads->udpw.head :
    ads->tcpw.head ? ads->tcpw.head :
    ads->childw.head ? ads->childw.head :
    ads->output.head;
}
  
adns_query adns_forallqueries_next(adns_state ads, void **context_r) {
  adns_query qu, nqu;

  adns__consistency(ads,0,cc_entex);
  nqu= ads->forallnext;
  for (;;) {
    qu= nqu;
    if (!qu) return 0;
    if (qu->next) {
      nqu= qu->next;
    } else if (qu == ads->udpw.tail) {
      nqu=
	ads->tcpw.head ? ads->tcpw.head :
	ads->childw.head ? ads->childw.head :
	ads->output.head;
    } else if (qu == ads->tcpw.tail) {
      nqu=
	ads->childw.head ? ads->childw.head :
	ads->output.head;
    } else if (qu == ads->childw.tail) {
      nqu= ads->output.head;
    } else {
      nqu= 0;
    }
    if (!qu->parent) break;
  }
  ads->forallnext= nqu;
  if (context_r) *context_r= qu->ctx.ext;
  return qu;
}
Commit	Line	Data
e576be50	1	/*
	2	* setup.c
	3	* - configuration file parsing
	4	* - management of global state
	5	*/
	6	/*
d942707d	7	* This file is
	8	* Copyright (C) 1997-1999 Ian Jackson <ian@davenant.greenend.org.uk>
	9	*
	10	* It is part of adns, which is
3d5cde09	11	* Copyright (C) 1997-2000 Ian Jackson <ian@davenant.greenend.org.uk>
bef232ae	12	* Copyright (C) 1999-2000 Tony Finch <dot@dotat.at>
e576be50	13	*
	14	* This program is free software; you can redistribute it and/or modify
	15	* it under the terms of the GNU General Public License as published by
	16	* the Free Software Foundation; either version 2, or (at your option)
	17	* any later version.
	18	*
	19	* This program is distributed in the hope that it will be useful,
	20	* but WITHOUT ANY WARRANTY; without even the implied warranty of
	21	* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
	22	* GNU General Public License for more details.
	23	*
	24	* You should have received a copy of the GNU General Public License
	25	* along with this program; if not, write to the Free Software Foundation,
	26	* Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
	27	*/
656b2da9	28
4353a5c4	29	#include <stdlib.h>
4353a5c4	30	#include <errno.h>
78bcc172	31	#include <limits.h>
4353a5c4	32	#include <unistd.h>
4353a5c4	33	#include <fcntl.h>
656b2da9	34
5aabad0d	35	#include <sys/types.h>
4353a5c4	36	#include <netdb.h>
71a6ff46	37	#include <sys/socket.h>
71a6ff46	38	#include <netinet/in.h>
4353a5c4	39	#include <arpa/inet.h>
	40
	41	#include "internal.h"
	42
fb7fbb66	43	static void readconfig(adns_state ads, const char *filename, int warnmissing);
36369543	44
656b2da9	45	static void addserver(adns_state ads, struct in_addr addr) {
	46	int i;
	47	struct server *ss;
	48
	49	for (i=0; i<ads->nservers; i++) {
	50	if (ads->servers[i].addr.s_addr == addr.s_addr) {
3955725c	51	adns__debug(ads,-1,0,"duplicate nameserver %s ignored",inet_ntoa(addr));
656b2da9	52	return;
	53	}
	54	}
	55
	56	if (ads->nservers>=MAXSERVERS) {
3955725c	57	adns__diag(ads,-1,0,"too many nameservers, ignoring %s",inet_ntoa(addr));
656b2da9	58	return;
	59	}
	60
	61	ss= ads->servers+ads->nservers;
	62	ss->addr= addr;
656b2da9	63	ads->nservers++;
	64	}
	65
914a5ff5	66	static void freesearchlist(adns_state ads) {
	67	if (ads->nsearchlist) free(*ads->searchlist);
	68	free(ads->searchlist);
	69	}
	70
36369543	71	static void saveerr(adns_state ads, int en) {
	72	if (!ads->configerrno) ads->configerrno= en;
	73	}
	74
656b2da9	75	static void configparseerr(adns_state ads, const char *fn, int lno,
	76	const char *fmt, ...) {
	77	va_list al;
36369543	78
	79	saveerr(ads,EINVAL);
	80	if (!ads->diagfile \|\| (ads->iflags & adns_if_noerrprint)) return;
	81
	82	if (lno==-1) fprintf(ads->diagfile,"adns: %s: ",fn);
	83	else fprintf(ads->diagfile,"adns: %s:%d: ",fn,lno);
656b2da9	84	va_start(al,fmt);
36369543	85	vfprintf(ads->diagfile,fmt,al);
656b2da9	86	va_end(al);
36369543	87	fputc('\n',ads->diagfile);
656b2da9	88	}
656b2da9	89
32af6b2a	90	static int nextword(const char bufp_io, const char word_r, int *l_r) {
	91	const char p, q;
	92
	93	p= *bufp_io;
	94	while (ctype_whitespace(*p)) p++;
	95	if (!*p) return 0;
	96
	97	q= p;
	98	while (q && !ctype_whitespace(q)) q++;
	99
	100	*l_r= q-p;
	101	*word_r= p;
	102	*bufp_io= q;
	103
	104	return 1;
	105	}
	106
656b2da9	107	static void ccf_nameserver(adns_state ads, const char fn, int lno, const char buf) {
	108	struct in_addr ia;
	109
	110	if (!inet_aton(buf,&ia)) {
	111	configparseerr(ads,fn,lno,"invalid nameserver address `%s'",buf);
	112	return;
	113	}
3955725c	114	adns__debug(ads,-1,0,"using nameserver %s",inet_ntoa(ia));
656b2da9	115	addserver(ads,ia);
	116	}
	117
	118	static void ccf_search(adns_state ads, const char fn, int lno, const char buf) {
32af6b2a	119	const char bufp, word;
	120	char newchars, newptrs, *pp;
	121	int count, tl, l;
	122
656b2da9	123	if (!buf) return;
32af6b2a	124
	125	bufp= buf;
	126	count= 0;
	127	tl= 0;
	128	while (nextword(&bufp,&word,&l)) { count++; tl += l+1; }
	129
	130	newptrs= malloc(sizeof(char)count); if (!newptrs) { saveerr(ads,errno); return; }
	131	newchars= malloc(tl); if (!newchars) { saveerr(ads,errno); free(newptrs); return; }
	132
	133	bufp= buf;
	134	pp= newptrs;
	135	while (nextword(&bufp,&word,&l)) {
	136	*pp++= newchars;
	137	memcpy(newchars,word,l);
	138	newchars += l;
	139	*newchars++ = 0;
	140	}
	141
914a5ff5	142	freesearchlist(ads);
32af6b2a	143	ads->nsearchlist= count;
32af6b2a	144	ads->searchlist= newptrs;
656b2da9	145	}
656b2da9	146
32af6b2a	147	static void ccf_sortlist(adns_state ads, const char fn, int lno, const char buf) {
32af6b2a	148	const char *word;
09957b1c	149	char tbuf[200], slash, ep;
	150	struct in_addr base, mask;
	151	int l;
	152	unsigned long initial, baselocal;
	153
32af6b2a	154	if (!buf) return;
32af6b2a	155
09957b1c	156	ads->nsortlist= 0;
32af6b2a	157	while (nextword(&buf,&word,&l)) {
09957b1c	158	if (ads->nsortlist >= MAXSORTLIST) {
32af6b2a	159	adns__diag(ads,-1,0,"too many sortlist entries, ignoring %.*s onwards",l,word);
09957b1c	160	return;
	161	}
	162
	163	if (l >= sizeof(tbuf)) {
32af6b2a	164	configparseerr(ads,fn,lno,"sortlist entry `%.*s' too long",l,word);
09957b1c	165	continue;
	166	}
	167
78bcc172	168	memcpy(tbuf,word,l); tbuf[l]= 0;
09957b1c	169	slash= strchr(tbuf,'/');
	170	if (slash) *slash++= 0;
	171
	172	if (!inet_aton(tbuf,&base)) {
	173	configparseerr(ads,fn,lno,"invalid address `%s' in sortlist",tbuf);
	174	continue;
	175	}
	176
	177	if (slash) {
	178	if (strchr(slash,'.')) {
	179	if (!inet_aton(slash,&mask)) {
	180	configparseerr(ads,fn,lno,"invalid mask `%s' in sortlist",slash);
	181	continue;
	182	}
	183	if (base.s_addr & ~mask.s_addr) {
	184	configparseerr(ads,fn,lno,
	185	"mask `%s' in sortlist overlaps address `%s'",slash,tbuf);
	186	continue;
	187	}
	188	} else {
	189	initial= strtoul(slash,&ep,10);
	190	if (*ep \|\| initial>32) {
	191	configparseerr(ads,fn,lno,"mask length `%s' invalid",slash);
	192	continue;
	193	}
	194	mask.s_addr= htonl((0x0ffffffffUL) << (32-initial));
	195	}
	196	} else {
	197	baselocal= ntohl(base.s_addr);
	198	if (!baselocal & 0x080000000UL) /* class A */
	199	mask.s_addr= htonl(0x0ff000000UL);
	200	else if ((baselocal & 0x0c0000000UL) == 0x080000000UL)
	201	mask.s_addr= htonl(0x0ffff0000UL); /* class B */
	202	else if ((baselocal & 0x0f0000000UL) == 0x0e0000000UL)
	203	mask.s_addr= htonl(0x0ff000000UL); /* class C */
	204	else {
	205	configparseerr(ads,fn,lno,
	206	"network address `%s' in sortlist is not in classed ranges,"
	207	" must specify mask explicitly", tbuf);
	208	continue;
	209	}
	210	}
	211
	212	ads->sortlist[ads->nsortlist].base= base;
	213	ads->sortlist[ads->nsortlist].mask= mask;
	214	ads->nsortlist++;
	215	}
656b2da9	216	}
	217
	218	static void ccf_options(adns_state ads, const char fn, int lno, const char buf) {
78bcc172	219	const char *word;
	220	char *ep;
	221	unsigned long v;
	222	int l;
	223
656b2da9	224	if (!buf) return;
78bcc172	225
	226	while (nextword(&buf,&word,&l)) {
	227	if (l==5 && !memcmp(word,"debug",5)) {
	228	ads->iflags \|= adns_if_debug;
	229	continue;
	230	}
	231	if (l>=6 && !memcmp(word,"ndots:",6)) {
	232	v= strtoul(word+6,&ep,10);
	233	if (l==6 \|\| ep != word+l \|\| v > INT_MAX) {
	234	configparseerr(ads,fn,lno,"option `%.*s' malformed or has bad value",l,word);
	235	continue;
	236	}
	237	ads->searchndots= v;
	238	continue;
	239	}
3e2e5fab	240	if (l>=12 && !memcmp(word,"adns_checkc:",12)) {
	241	if (!strcmp(word+12,"none")) {
	242	ads->iflags &= ~adns_if_checkc_freq;
	243	ads->iflags \|= adns_if_checkc_entex;
	244	} else if (!strcmp(word+12,"entex")) {
	245	ads->iflags &= ~adns_if_checkc_freq;
	246	ads->iflags \|= adns_if_checkc_entex;
	247	} else if (!strcmp(word+12,"freq")) {
	248	ads->iflags \|= adns_if_checkc_freq;
	249	} else {
	250	configparseerr(ads,fn,lno, "option adns_checkc has bad value `%s' "
	251	"(must be none, entex or freq", word+12);
	252	}
	253	continue;
	254	}
78bcc172	255	adns__diag(ads,-1,0,"%s:%d: unknown option `%.*s'", fn,lno, l,word);
78bcc172	256	}
656b2da9	257	}
	258
	259	static void ccf_clearnss(adns_state ads, const char fn, int lno, const char buf) {
	260	ads->nservers= 0;
	261	}
	262
36369543	263	static void ccf_include(adns_state ads, const char fn, int lno, const char buf) {
	264	if (!*buf) {
	265	configparseerr(ads,fn,lno,"`include' directive with no filename");
	266	return;
	267	}
fb7fbb66	268	readconfig(ads,buf,1);
36369543	269	}
36369543	270
0f15dd7b	271	static void ccf_lookup(adns_state ads, const char *fn, int lno,
	272	const char *buf) {
	273	int found_bind=0;
	274	const char *word;
	275	int l;
	276
	277	if (!*buf) {
	278	configparseerr(ads,fn,lno,"`lookup' directive with no databases");
	279	return;
	280	}
	281
	282	while (nextword(&buf,&word,&l)) {
	283	if (l==4 && !memcmp(word,"bind",4)) {
	284	found_bind=1;
	285	} else if (l==4 && !memcmp(word,"file",4)) {
	286	/* ignore this and hope /etc/hosts is not essential */
	287	} else if (l==2 && !memcmp(word,"yp",2)) {
	288	adns__diag(ads,-1,0,"%s:%d: yp lookups not supported by adns", fn,lno);
	289	found_bind=-1;
	290	} else {
	291	adns__diag(ads,-1,0,"%s:%d: unknown `lookup' database `%.*s'",
	292	fn,lno, l,word);
	293	found_bind=-1;
	294	}
	295	}
	296	if (!found_bind)
	297	adns__diag(ads,-1,0,"%s:%d: `lookup' specified, but not `bind'", fn,lno);
	298	}
	299
656b2da9	300	static const struct configcommandinfo {
	301	const char *name;
	302	void (fn)(adns_state ads, const char fn, int lno, const char *buf);
	303	} configcommandinfos[]= {
	304	{ "nameserver", ccf_nameserver },
	305	{ "domain", ccf_search },
	306	{ "search", ccf_search },
	307	{ "sortlist", ccf_sortlist },
	308	{ "options", ccf_options },
	309	{ "clearnameservers", ccf_clearnss },
36369543	310	{ "include", ccf_include },
0f15dd7b	311	{ "lookup", ccf_lookup }, /* OpenBSD */
656b2da9	312	{ 0 }
	313	};
	314
36369543	315	typedef union {
656b2da9	316	FILE *file;
36369543	317	const char *text;
36369543	318	} getline_ctx;
656b2da9	319
36369543	320	static int gl_file(adns_state ads, getline_ctx src_io, const char filename,
	321	int lno, char *buf, int buflen) {
	322	FILE *file= src_io->file;
	323	int c, i;
	324	char *p;
	325
	326	p= buf;
	327	buflen--;
	328	i= 0;
	329
	330	for (;;) { /* loop over chars */
	331	if (i == buflen) {
	332	adns__diag(ads,-1,0,"%s:%d: line too long, ignored",filename,lno);
	333	goto x_badline;
	334	}
	335	c= getc(file);
	336	if (!c) {
	337	adns__diag(ads,-1,0,"%s:%d: line contains nul, ignored",filename,lno);
	338	goto x_badline;
	339	} else if (c == '\n') {
	340	break;
	341	} else if (c == EOF) {
	342	if (ferror(file)) {
	343	saveerr(ads,errno);
	344	adns__diag(ads,-1,0,"%s:%d: read error: %s",filename,lno,strerror(errno));
	345	return -1;
	346	}
	347	if (!i) return -1;
	348	break;
	349	} else {
	350	*p++= c;
	351	i++;
656b2da9	352	}
656b2da9	353	}
656b2da9	354
36369543	355	*p++= 0;
	356	return i;
	357
	358	x_badline:
	359	saveerr(ads,EINVAL);
	360	while ((c= getc(file)) != EOF && c != '\n');
	361	return -2;
	362	}
	363
	364	static int gl_text(adns_state ads, getline_ctx src_io, const char filename,
	365	int lno, char *buf, int buflen) {
09957b1c	366	const char *cp= src_io->text;
36369543	367	int l;
36369543	368
09957b1c	369	if (!cp \|\| !*cp) return -1;
36369543	370
09957b1c	371	if (cp == ';' \|\| cp == '\n') cp++;
	372	l= strcspn(cp,";\n");
	373	src_io->text = cp+l;
36369543	374
	375	if (l >= buflen) {
	376	adns__diag(ads,-1,0,"%s:%d: line too long, ignored",filename,lno);
	377	saveerr(ads,EINVAL);
	378	return -2;
	379	}
	380
	381	memcpy(buf,cp,l);
	382	buf[l]= 0;
	383	return l;
	384	}
	385
	386	static void readconfiggeneric(adns_state ads, const char *filename,
	387	int (getline)(adns_state ads, getline_ctx,
	388	const char *filename, int lno,
	389	char *buf, int buflen),
	390	/* Returns >=0 for success, -1 for EOF or error
	391	* (error will have been reported), or -2 for
	392	* bad line was encountered, try again.
	393	*/
	394	getline_ctx gl_ctx) {
	395	char linebuf[2000], p, q;
	396	int lno, l, dirl;
	397	const struct configcommandinfo *ccip;
	398
	399	for (lno=1;
	400	(l= getline(ads,&gl_ctx, filename,lno, linebuf,sizeof(linebuf))) != -1;
	401	lno++) {
	402	if (l == -2) continue;
656b2da9	403	while (l>0 && ctype_whitespace(linebuf[l-1])) l--;
	404	linebuf[l]= 0;
	405	p= linebuf;
	406	while (ctype_whitespace(*p)) p++;
36369543	407	if (p == '#' \|\| !p) continue;
656b2da9	408	q= p;
656b2da9	409	while (q && !ctype_whitespace(q)) q++;
36369543	410	dirl= q-p;
656b2da9	411	for (ccip=configcommandinfos;
36369543	412	ccip->name && !(strlen(ccip->name)==dirl && !memcmp(ccip->name,p,q-p));
656b2da9	413	ccip++);
656b2da9	414	if (!ccip->name) {
3955725c	415	adns__diag(ads,-1,0,"%s:%d: unknown configuration directive `%.*s'",
4353a5c4	416	filename,lno,q-p,p);
656b2da9	417	continue;
	418	}
	419	while (ctype_whitespace(*q)) q++;
	420	ccip->fn(ads,filename,lno,q);
	421	}
656b2da9	422	}
	423
	424	static const char instrum_getenv(adns_state ads, const char envvar) {
	425	const char *value;
	426
	427	value= getenv(envvar);
3955725c	428	if (!value) adns__debug(ads,-1,0,"environment variable %s not set",envvar);
3955725c	429	else adns__debug(ads,-1,0,"environment variable %s set to `%s'",envvar,value);
656b2da9	430	return value;
	431	}
	432
fb7fbb66	433	static void readconfig(adns_state ads, const char *filename, int warnmissing) {
36369543	434	getline_ctx gl_ctx;
	435
	436	gl_ctx.file= fopen(filename,"r");
	437	if (!gl_ctx.file) {
	438	if (errno == ENOENT) {
fb7fbb66	439	if (warnmissing)
fb7fbb66	440	adns__debug(ads,-1,0,"configuration file `%s' does not exist",filename);
36369543	441	return;
	442	}
	443	saveerr(ads,errno);
	444	adns__diag(ads,-1,0,"cannot open configuration file `%s': %s",
	445	filename,strerror(errno));
	446	return;
	447	}
	448
	449	readconfiggeneric(ads,filename,gl_file,gl_ctx);
	450
	451	fclose(gl_ctx.file);
	452	}
	453
	454	static void readconfigtext(adns_state ads, const char text, const char showname) {
	455	getline_ctx gl_ctx;
	456
	457	gl_ctx.text= text;
	458	readconfiggeneric(ads,showname,gl_text,gl_ctx);
	459	}
	460
656b2da9	461	static void readconfigenv(adns_state ads, const char *envvar) {
	462	const char *filename;
	463
	464	if (ads->iflags & adns_if_noenv) {
3955725c	465	adns__debug(ads,-1,0,"not checking environment variable `%s'",envvar);
656b2da9	466	return;
	467	}
	468	filename= instrum_getenv(ads,envvar);
fb7fbb66	469	if (filename) readconfig(ads,filename,1);
656b2da9	470	}
4353a5c4	471
09957b1c	472	static void readconfigenvtext(adns_state ads, const char *envvar) {
	473	const char *textdata;
	474
	475	if (ads->iflags & adns_if_noenv) {
	476	adns__debug(ads,-1,0,"not checking environment variable `%s'",envvar);
	477	return;
	478	}
	479	textdata= instrum_getenv(ads,envvar);
	480	if (textdata) readconfigtext(ads,textdata,envvar);
	481	}
	482
4353a5c4	483
	484	int adns__setnonblock(adns_state ads, int fd) {
	485	int r;
656b2da9	486
4353a5c4	487	r= fcntl(fd,F_GETFL,0); if (r<0) return errno;
	488	r \|= O_NONBLOCK;
	489	r= fcntl(fd,F_SETFL,r); if (r<0) return errno;
	490	return 0;
	491	}
	492
36369543	493	static int init_begin(adns_state ads_r, adns_initflags flags, FILE diagfile) {
656b2da9	494	adns_state ads;
656b2da9	495
656b2da9	496	ads= malloc(sizeof(*ads)); if (!ads) return errno;
36369543	497
656b2da9	498	ads->iflags= flags;
36369543	499	ads->diagfile= diagfile;
d855b532	500	ads->configerrno= 0;
f7f83b4a	501	LIST_INIT(ads->udpw);
f7f83b4a	502	LIST_INIT(ads->tcpw);
4353a5c4	503	LIST_INIT(ads->childw);
4353a5c4	504	LIST_INIT(ads->output);
8ce38e76	505	ads->forallnext= 0;
4353a5c4	506	ads->nextid= 0x311f;
4353a5c4	507	ads->udpsocket= ads->tcpsocket= -1;
4353a5c4	508	adns__vbuf_init(&ads->tcpsend);
4353a5c4	509	adns__vbuf_init(&ads->tcprecv);
70ad7a2a	510	ads->tcprecv_skip= 0;
32af6b2a	511	ads->nservers= ads->nsortlist= ads->nsearchlist= ads->tcpserver= 0;
660d7d3b	512	ads->searchndots= 1;
d855b532	513	ads->tcpstate= server_disconnected;
4353a5c4	514	timerclear(&ads->tcptimeout);
d855b532	515	ads->searchlist= 0;
656b2da9	516
36369543	517	*ads_r= ads;
	518	return 0;
	519	}
656b2da9	520
36369543	521	static int init_finish(adns_state ads) {
	522	struct in_addr ia;
	523	struct protoent *proto;
	524	int r;
	525
656b2da9	526	if (!ads->nservers) {
36369543	527	if (ads->diagfile && ads->iflags & adns_if_debug)
36369543	528	fprintf(ads->diagfile,"adns: no nameservers, using localhost\n");
09957b1c	529	ia.s_addr= htonl(INADDR_LOOPBACK);
656b2da9	530	addserver(ads,ia);
	531	}
	532
	533	proto= getprotobyname("udp"); if (!proto) { r= ENOPROTOOPT; goto x_free; }
	534	ads->udpsocket= socket(AF_INET,SOCK_DGRAM,proto->p_proto);
8402e34c	535	if (ads->udpsocket<0) { r= errno; goto x_free; }
4bec51a4	536
94436798	537	r= adns__setnonblock(ads,ads->udpsocket);
94436798	538	if (r) { r= errno; goto x_closeudp; }
656b2da9	539
656b2da9	540	return 0;
656b2da9	541
94436798	542	x_closeudp:
94436798	543	close(ads->udpsocket);
656b2da9	544	x_free:
	545	free(ads);
	546	return r;
	547	}
	548
32af6b2a	549	static void init_abort(adns_state ads) {
	550	if (ads->nsearchlist) {
	551	free(ads->searchlist[0]);
	552	free(ads->searchlist);
	553	}
	554	free(ads);
	555	}
	556
e563872a	557	int adns_init(adns_state ads_r, adns_initflags flags, FILE diagfile) {
36369543	558	adns_state ads;
	559	const char res_options, adns_res_options;
	560	int r;
	561
	562	r= init_begin(&ads, flags, diagfile ? diagfile : stderr);
	563	if (r) return r;
	564
	565	res_options= instrum_getenv(ads,"RES_OPTIONS");
	566	adns_res_options= instrum_getenv(ads,"ADNS_RES_OPTIONS");
	567	ccf_options(ads,"RES_OPTIONS",-1,res_options);
	568	ccf_options(ads,"ADNS_RES_OPTIONS",-1,adns_res_options);
	569
fb7fbb66	570	readconfig(ads,"/etc/resolv.conf",1);
fb7fbb66	571	readconfig(ads,"/etc/resolv-adns.conf",0);
36369543	572	readconfigenv(ads,"RES_CONF");
	573	readconfigenv(ads,"ADNS_RES_CONF");
	574
09957b1c	575	readconfigenvtext(ads,"RES_CONF_TEXT");
	576	readconfigenvtext(ads,"ADNS_RES_CONF_TEXT");
	577
36369543	578	ccf_options(ads,"RES_OPTIONS",-1,res_options);
	579	ccf_options(ads,"ADNS_RES_OPTIONS",-1,adns_res_options);
	580
	581	ccf_search(ads,"LOCALDOMAIN",-1,instrum_getenv(ads,"LOCALDOMAIN"));
	582	ccf_search(ads,"ADNS_LOCALDOMAIN",-1,instrum_getenv(ads,"ADNS_LOCALDOMAIN"));
	583
32af6b2a	584	if (ads->configerrno && ads->configerrno != EINVAL) {
	585	r= ads->configerrno;
	586	init_abort(ads);
	587	return r;
	588	}
	589
36369543	590	r= init_finish(ads);
	591	if (r) return r;
	592
28de6442	593	adns__consistency(ads,0,cc_entex);
36369543	594	*ads_r= ads;
	595	return 0;
	596	}
	597
e563872a	598	int adns_init_strcfg(adns_state *ads_r, adns_initflags flags,
36369543	599	FILE diagfile, const char configtext) {
	600	adns_state ads;
	601	int r;
	602
	603	r= init_begin(&ads, flags, diagfile); if (r) return r;
	604
	605	readconfigtext(ads,configtext,"<supplied configuration text>");
	606	if (ads->configerrno) {
	607	r= ads->configerrno;
32af6b2a	608	init_abort(ads);
36369543	609	return r;
	610	}
	611
	612	r= init_finish(ads); if (r) return r;
28de6442	613	adns__consistency(ads,0,cc_entex);
36369543	614	*ads_r= ads;
	615	return 0;
	616	}
	617
3e2e5fab	618
9ec44266	619	void adns_finish(adns_state ads) {
28de6442	620	adns__consistency(ads,0,cc_entex);
9ec44266	621	for (;;) {
f7f83b4a	622	if (ads->udpw.head) adns_cancel(ads->udpw.head);
f7f83b4a	623	else if (ads->tcpw.head) adns_cancel(ads->tcpw.head);
9ec44266	624	else if (ads->childw.head) adns_cancel(ads->childw.head);
	625	else if (ads->output.head) adns_cancel(ads->output.head);
	626	else break;
	627	}
	628	close(ads->udpsocket);
	629	if (ads->tcpsocket >= 0) close(ads->tcpsocket);
	630	adns__vbuf_free(&ads->tcpsend);
	631	adns__vbuf_free(&ads->tcprecv);
914a5ff5	632	freesearchlist(ads);
9ec44266	633	free(ads);
656b2da9	634	}
8ce38e76	635
8ce38e76	636	void adns_forallqueries_begin(adns_state ads) {
28de6442	637	adns__consistency(ads,0,cc_entex);
8ce38e76	638	ads->forallnext=
f7f83b4a	639	ads->udpw.head ? ads->udpw.head :
f7f83b4a	640	ads->tcpw.head ? ads->tcpw.head :
8ce38e76	641	ads->childw.head ? ads->childw.head :
	642	ads->output.head;
	643	}
	644
	645	adns_query adns_forallqueries_next(adns_state ads, void **context_r) {
	646	adns_query qu, nqu;
	647
28de6442	648	adns__consistency(ads,0,cc_entex);
8ce38e76	649	nqu= ads->forallnext;
	650	for (;;) {
	651	qu= nqu;
	652	if (!qu) return 0;
4218fb9a	653	if (qu->next) {
4218fb9a	654	nqu= qu->next;
f7f83b4a	655	} else if (qu == ads->udpw.tail) {
	656	nqu=
	657	ads->tcpw.head ? ads->tcpw.head :
	658	ads->childw.head ? ads->childw.head :
	659	ads->output.head;
	660	} else if (qu == ads->tcpw.tail) {
	661	nqu=
	662	ads->childw.head ? ads->childw.head :
	663	ads->output.head;
4218fb9a	664	} else if (qu == ads->childw.tail) {
	665	nqu= ads->output.head;
	666	} else {
	667	nqu= 0;
	668	}
8ce38e76	669	if (!qu->parent) break;
	670	}
	671	ads->forallnext= nqu;
	672	if (context_r) *context_r= qu->ctx.ext;
	673	return qu;
	674	}