usr.sbin/cron/lib/entry.c

   1 /* Copyright 1988,1990,1993,1994 by Paul Vixie
   2  * All rights reserved
   3  *
   4  * Distribute freely, except: don't remove my name from the source or
   5  * documentation (don't take credit for my work), mark your changes (don't
   6  * get me blamed for your possible bugs), don't alter or remove this
   7  * notice.  May be sold if buildable source is provided to buyer.  No
   8  * warrantee of any kind, express or implied, is included with this
   9  * software; use at your own risk, responsibility for damages (if any) to
  10  * anyone resulting from the use of this software rests entirely with the
  11  * user.
  12  *
  13  * Send bug reports, bug fixes, enhancements, requests, flames, etc., and
  14  * I'll try to keep a version up to date.  I can be reached as follows:
  15  * Paul Vixie          <paul@vix.com>          uunet!decwrl!vixie!paul
  16  */
  17
  18 #if !defined(lint) && !defined(LINT)
  19 static const char rcsid[] =
  20   "$FreeBSD$";
  21 #endif
  22
  23 /* vix 26jan87 [RCS'd; rest of log is in RCS file]
  24  * vix 01jan87 [added line-level error recovery]
  25  * vix 31dec86 [added /step to the from-to range, per bob@acornrc]
  26  * vix 30dec86 [written]
  27  */
  28
  29
  30 #include "cron.h"
  31 #include <grp.h>
  32 #ifdef LOGIN_CAP
  33 #include <login_cap.h>
  34 #endif
  35
  36 typedef enum ecode {
  37         e_none, e_minute, e_hour, e_dom, e_month, e_dow,
  38         e_cmd, e_timespec, e_username, e_group, e_mem
  39 #ifdef LOGIN_CAP
  40         , e_class
  41 #endif
  42 } ecode_e;
  43
  44 static char     get_list(bitstr_t *, int, int, char *[], int, FILE *),
  45                 get_range(bitstr_t *, int, int, char *[], int, FILE *),
  46                 get_number(int *, int, char *[], int, FILE *);
  47 static int      set_element(bitstr_t *, int, int, int);
  48
  49 static char *ecodes[] =
  50         {
  51                 "no error",
  52                 "bad minute",
  53                 "bad hour",
  54                 "bad day-of-month",
  55                 "bad month",
  56                 "bad day-of-week",
  57                 "bad command",
  58                 "bad time specifier",
  59                 "bad username",
  60                 "bad group name",
  61                 "out of memory",
  62 #ifdef LOGIN_CAP
  63                 "bad class name",
  64 #endif
  65         };
  66
  67
  68 void
  69 free_entry(e)
  70         entry   *e;
  71 {
  72 #ifdef LOGIN_CAP
  73         if (e->class != NULL)
  74                 free(e->class);
  75 #endif
  76         if (e->cmd != NULL)
  77                 free(e->cmd);
  78         if (e->envp != NULL)
  79                 env_free(e->envp);
  80         free(e);
  81 }
  82
  83
  84 /* return NULL if eof or syntax error occurs;
  85  * otherwise return a pointer to a new entry.
  86  */
  87 entry *
  88 load_entry(file, error_func, pw, envp)
  89         FILE            *file;
  90         void            (*error_func)(char *);
  91         struct passwd   *pw;
  92         char            **envp;
  93 {
  94         /* this function reads one crontab entry -- the next -- from a file.
  95          * it skips any leading blank lines, ignores comments, and returns
  96          * EOF if for any reason the entry can't be read and parsed.
  97          *
  98          * the entry is also parsed here.
  99          *
 100          * syntax:
 101          *   user crontab:
 102          *      minutes hours doms months dows cmd\n
 103          *   system crontab (/etc/crontab):
 104          *      minutes hours doms months dows USERNAME cmd\n
 105          */
 106
 107         ecode_e ecode = e_none;
 108         entry   *e;
 109         int     ch;
 110         char    cmd[MAX_COMMAND];
 111         char    envstr[MAX_ENVSTR];
 112         char    **prev_env;
 113
 114         Debug(DPARS, ("load_entry()...about to eat comments\n"))
 115
 116         skip_comments(file);
 117
 118         ch = get_char(file);
 119         if (ch == EOF)
 120                 return NULL;
 121
 122         /* ch is now the first useful character of a useful line.
 123          * it may be an @special or it may be the first character
 124          * of a list of minutes.
 125          */
 126
 127         e = (entry *) calloc(sizeof(entry), sizeof(char));
 128
 129         if (e == NULL) {
 130                 warn("load_entry: calloc failed");
 131                 return NULL;
 132         }
 133
 134         if (ch == '@') {
 135                 long interval;
 136                 char *endptr;
 137
 138                 /* all of these should be flagged and load-limited; i.e.,
 139                  * instead of @hourly meaning "0 * * * *" it should mean
 140                  * "close to the front of every hour but not 'til the
 141                  * system load is low".  Problems are: how do you know
 142                  * what "low" means? (save me from /etc/cron.conf!) and:
 143                  * how to guarantee low variance (how low is low?), which
 144                  * means how to we run roughly every hour -- seems like
 145                  * we need to keep a history or let the first hour set
 146                  * the schedule, which means we aren't load-limited
 147                  * anymore.  too much for my overloaded brain. (vix, jan90)
 148                  * HINT
 149                  */
 150                 Debug(DPARS, ("load_entry()...about to test shortcuts\n"))
 151                 ch = get_string(cmd, MAX_COMMAND, file, " \t\n");
 152                 if (!strcmp("reboot", cmd)) {
 153                         Debug(DPARS, ("load_entry()...reboot shortcut\n"))
 154                         e->flags |= WHEN_REBOOT;
 155                 } else if (!strcmp("yearly", cmd) || !strcmp("annually", cmd)){
 156                         Debug(DPARS, ("load_entry()...yearly shortcut\n"))
 157                         bit_set(e->second, 0);
 158                         bit_set(e->minute, 0);
 159                         bit_set(e->hour, 0);
 160                         bit_set(e->dom, 0);
 161                         bit_set(e->month, 0);
 162                         bit_nset(e->dow, 0, (LAST_DOW-FIRST_DOW+1));
 163                         e->flags |= DOW_STAR;
 164                 } else if (!strcmp("monthly", cmd)) {
 165                         Debug(DPARS, ("load_entry()...monthly shortcut\n"))
 166                         bit_set(e->second, 0);
 167                         bit_set(e->minute, 0);
 168                         bit_set(e->hour, 0);
 169                         bit_set(e->dom, 0);
 170                         bit_nset(e->month, 0, (LAST_MONTH-FIRST_MONTH+1));
 171                         bit_nset(e->dow, 0, (LAST_DOW-FIRST_DOW+1));
 172                         e->flags |= DOW_STAR;
 173                 } else if (!strcmp("weekly", cmd)) {
 174                         Debug(DPARS, ("load_entry()...weekly shortcut\n"))
 175                         bit_set(e->second, 0);
 176                         bit_set(e->minute, 0);
 177                         bit_set(e->hour, 0);
 178                         bit_nset(e->dom, 0, (LAST_DOM-FIRST_DOM+1));
 179                         e->flags |= DOM_STAR;
 180                         bit_nset(e->month, 0, (LAST_MONTH-FIRST_MONTH+1));
 181                         bit_set(e->dow, 0);
 182                 } else if (!strcmp("daily", cmd) || !strcmp("midnight", cmd)) {
 183                         Debug(DPARS, ("load_entry()...daily shortcut\n"))
 184                         bit_set(e->second, 0);
 185                         bit_set(e->minute, 0);
 186                         bit_set(e->hour, 0);
 187                         bit_nset(e->dom, 0, (LAST_DOM-FIRST_DOM+1));
 188                         bit_nset(e->month, 0, (LAST_MONTH-FIRST_MONTH+1));
 189                         bit_nset(e->dow, 0, (LAST_DOW-FIRST_DOW+1));
 190                 } else if (!strcmp("hourly", cmd)) {
 191                         Debug(DPARS, ("load_entry()...hourly shortcut\n"))
 192                         bit_set(e->second, 0);
 193                         bit_set(e->minute, 0);
 194                         bit_nset(e->hour, 0, (LAST_HOUR-FIRST_HOUR+1));
 195                         bit_nset(e->dom, 0, (LAST_DOM-FIRST_DOM+1));
 196                         bit_nset(e->month, 0, (LAST_MONTH-FIRST_MONTH+1));
 197                         bit_nset(e->dow, 0, (LAST_DOW-FIRST_DOW+1));
 198                 } else if (!strcmp("every_minute", cmd)) {
 199                         Debug(DPARS, ("load_entry()...every_minute shortcut\n"))
 200                         bit_set(e->second, 0);
 201                         bit_nset(e->minute, 0, (LAST_MINUTE-FIRST_MINUTE+1));
 202                         bit_nset(e->hour, 0, (LAST_HOUR-FIRST_HOUR+1));
 203                         bit_nset(e->dom, 0, (LAST_DOM-FIRST_DOM+1));
 204                         bit_nset(e->month, 0, (LAST_MONTH-FIRST_MONTH+1));
 205                         bit_nset(e->dow, 0, (LAST_DOW-FIRST_DOW+1));
 206                 } else if (!strcmp("every_second", cmd)) {
 207                         Debug(DPARS, ("load_entry()...every_second shortcut\n"))
 208                         e->flags |= SEC_RES;
 209                         bit_nset(e->second, 0, (LAST_SECOND-FIRST_SECOND+1));
 210                         bit_nset(e->minute, 0, (LAST_MINUTE-FIRST_MINUTE+1));
 211                         bit_nset(e->hour, 0, (LAST_HOUR-FIRST_HOUR+1));
 212                         bit_nset(e->dom, 0, (LAST_DOM-FIRST_DOM+1));
 213                         bit_nset(e->month, 0, (LAST_MONTH-FIRST_MONTH+1));
 214                         bit_nset(e->dow, 0, (LAST_DOW-FIRST_DOW+1));
 215                 } else if (*cmd != '\0' &&
 216                     (interval = strtol(cmd, &endptr, 10)) > 0 &&
 217                     *endptr == '\0') {
 218                         Debug(DPARS, ("load_entry()... %ld seconds "
 219                             "since last run\n", interval))
 220                         e->interval = interval;
 221                         e->flags = INTERVAL;
 222                 } else {
 223                         ecode = e_timespec;
 224                         goto eof;
 225                 }
 226                 /* Advance past whitespace between shortcut and
 227                  * username/command.
 228                  */
 229                 Skip_Blanks(ch, file);
 230                 if (ch == EOF) {
 231                         ecode = e_cmd;
 232                         goto eof;
 233                 }
 234         } else {
 235                 Debug(DPARS, ("load_entry()...about to parse numerics\n"))
 236                 bit_set(e->second, 0);
 237
 238                 ch = get_list(e->minute, FIRST_MINUTE, LAST_MINUTE,
 239                               PPC_NULL, ch, file);
 240                 if (ch == EOF) {
 241                         ecode = e_minute;
 242                         goto eof;
 243                 }
 244
 245                 /* hours
 246                  */
 247
 248                 ch = get_list(e->hour, FIRST_HOUR, LAST_HOUR,
 249                               PPC_NULL, ch, file);
 250                 if (ch == EOF) {
 251                         ecode = e_hour;
 252                         goto eof;
 253                 }
 254
 255                 /* DOM (days of month)
 256                  */
 257
 258                 if (ch == '*')
 259                         e->flags |= DOM_STAR;
 260                 ch = get_list(e->dom, FIRST_DOM, LAST_DOM,
 261                               PPC_NULL, ch, file);
 262                 if (ch == EOF) {
 263                         ecode = e_dom;
 264                         goto eof;
 265                 }
 266
 267                 /* month
 268                  */
 269
 270                 ch = get_list(e->month, FIRST_MONTH, LAST_MONTH,
 271                               MonthNames, ch, file);
 272                 if (ch == EOF) {
 273                         ecode = e_month;
 274                         goto eof;
 275                 }
 276
 277                 /* DOW (days of week)
 278                  */
 279
 280                 if (ch == '*')
 281                         e->flags |= DOW_STAR;
 282                 ch = get_list(e->dow, FIRST_DOW, LAST_DOW,
 283                               DowNames, ch, file);
 284                 if (ch == EOF) {
 285                         ecode = e_dow;
 286                         goto eof;
 287                 }
 288         }
 289
 290         /* make sundays equivalent */
 291         if (bit_test(e->dow, 0) || bit_test(e->dow, 7)) {
 292                 bit_set(e->dow, 0);
 293                 bit_set(e->dow, 7);
 294         }
 295
 296         /* ch is the first character of a command, or a username */
 297         unget_char(ch, file);
 298
 299         if (!pw) {
 300                 char            *username = cmd;        /* temp buffer */
 301                 char            *s;
 302                 struct group    *grp;
 303 #ifdef LOGIN_CAP
 304                 login_cap_t *lc;
 305 #endif
 306
 307                 Debug(DPARS, ("load_entry()...about to parse username\n"))
 308                 ch = get_string(username, MAX_COMMAND, file, " \t");
 309
 310                 Debug(DPARS, ("load_entry()...got %s\n",username))
 311                 if (ch == EOF) {
 312                         ecode = e_cmd;
 313                         goto eof;
 314                 }
 315
 316 #ifdef LOGIN_CAP
 317                 if ((s = strrchr(username, '/')) != NULL) {
 318                         *s = '\0';
 319                         e->class = strdup(s + 1);
 320                         if (e->class == NULL)
 321                                 warn("strdup(\"%s\")", s + 1);
 322                 } else {
 323                         e->class = strdup(RESOURCE_RC);
 324                         if (e->class == NULL)
 325                                 warn("strdup(\"%s\")", RESOURCE_RC);
 326                 }
 327                 if (e->class == NULL) {
 328                         ecode = e_mem;
 329                         goto eof;
 330                 }
 331                 if ((lc = login_getclass(e->class)) == NULL) {
 332                         ecode = e_class;
 333                         goto eof;
 334                 }
 335                 login_close(lc);
 336 #endif
 337                 grp = NULL;
 338                 if ((s = strrchr(username, ':')) != NULL) {
 339                         *s = '\0';
 340                         if ((grp = getgrnam(s + 1)) == NULL) {
 341                                 ecode = e_group;
 342                                 goto eof;
 343                         }
 344                 }
 345
 346                 pw = getpwnam(username);
 347                 if (pw == NULL) {
 348                         ecode = e_username;
 349                         goto eof;
 350                 }
 351                 if (grp != NULL)
 352                         pw->pw_gid = grp->gr_gid;
 353                 Debug(DPARS, ("load_entry()...uid %d, gid %d\n",pw->pw_uid,pw->pw_gid))
 354 #ifdef LOGIN_CAP
 355                 Debug(DPARS, ("load_entry()...class %s\n",e->class))
 356 #endif
 357         }
 358
 359 #ifndef PAM     /* PAM takes care of account expiration by itself */
 360         if (pw->pw_expire && time(NULL) >= pw->pw_expire) {
 361                 ecode = e_username;
 362                 goto eof;
 363         }
 364 #endif /* !PAM */
 365
 366         e->uid = pw->pw_uid;
 367         e->gid = pw->pw_gid;
 368
 369         /* copy and fix up environment.  some variables are just defaults and
 370          * others are overrides.
 371          */
 372         e->envp = env_copy(envp);
 373         if (e->envp == NULL) {
 374                 warn("env_copy");
 375                 ecode = e_mem;
 376                 goto eof;
 377         }
 378         if (!env_get("SHELL", e->envp)) {
 379                 prev_env = e->envp;
 380                 sprintf(envstr, "SHELL=%s", _PATH_BSHELL);
 381                 e->envp = env_set(e->envp, envstr);
 382                 if (e->envp == NULL) {
 383                         warn("env_set(%s)", envstr);
 384                         env_free(prev_env);
 385                         ecode = e_mem;
 386                         goto eof;
 387                 }
 388         }
 389         if (!env_get("HOME", e->envp)) {
 390                 prev_env = e->envp;
 391                 sprintf(envstr, "HOME=%s", pw->pw_dir);
 392                 e->envp = env_set(e->envp, envstr);
 393                 if (e->envp == NULL) {
 394                         warn("env_set(%s)", envstr);
 395                         env_free(prev_env);
 396                         ecode = e_mem;
 397                         goto eof;
 398                 }
 399         }
 400         if (!env_get("PATH", e->envp)) {
 401                 prev_env = e->envp;
 402                 sprintf(envstr, "PATH=%s", _PATH_DEFPATH);
 403                 e->envp = env_set(e->envp, envstr);
 404                 if (e->envp == NULL) {
 405                         warn("env_set(%s)", envstr);
 406                         env_free(prev_env);
 407                         ecode = e_mem;
 408                         goto eof;
 409                 }
 410         }
 411         prev_env = e->envp;
 412         sprintf(envstr, "%s=%s", "LOGNAME", pw->pw_name);
 413         e->envp = env_set(e->envp, envstr);
 414         if (e->envp == NULL) {
 415                 warn("env_set(%s)", envstr);
 416                 env_free(prev_env);
 417                 ecode = e_mem;
 418                 goto eof;
 419         }
 420 #if defined(BSD)
 421         prev_env = e->envp;
 422         sprintf(envstr, "%s=%s", "USER", pw->pw_name);
 423         e->envp = env_set(e->envp, envstr);
 424         if (e->envp == NULL) {
 425                 warn("env_set(%s)", envstr);
 426                 env_free(prev_env);
 427                 ecode = e_mem;
 428                 goto eof;
 429         }
 430 #endif
 431
 432         Debug(DPARS, ("load_entry()...about to parse command\n"))
 433
 434         /* Everything up to the next \n or EOF is part of the command...
 435          * too bad we don't know in advance how long it will be, since we
 436          * need to malloc a string for it... so, we limit it to MAX_COMMAND.
 437          * XXX - should use realloc().
 438          */
 439         ch = get_string(cmd, MAX_COMMAND, file, "\n");
 440
 441         /* a file without a \n before the EOF is rude, so we'll complain...
 442          */
 443         if (ch == EOF) {
 444                 ecode = e_cmd;
 445                 goto eof;
 446         }
 447
 448         /* got the command in the 'cmd' string; save it in *e.
 449          */
 450         e->cmd = strdup(cmd);
 451         if (e->cmd == NULL) {
 452                 warn("strdup(\"%s\")", cmd);
 453                 ecode = e_mem;
 454                 goto eof;
 455         }
 456         Debug(DPARS, ("load_entry()...returning successfully\n"))
 457
 458         /* success, fini, return pointer to the entry we just created...
 459          */
 460         return e;
 461
 462  eof:
 463         free_entry(e);
 464         if (ecode != e_none && error_func)
 465                 (*error_func)(ecodes[(int)ecode]);
 466         while (ch != EOF && ch != '\n')
 467                 ch = get_char(file);
 468         return NULL;
 469 }
 470
 471
 472 static char
 473 get_list(bits, low, high, names, ch, file)
 474         bitstr_t        *bits;          /* one bit per flag, default=FALSE */
 475         int             low, high;      /* bounds, impl. offset for bitstr */
 476         char            *names[];       /* NULL or *[] of names for these elements */
 477         int             ch;             /* current character being processed */
 478         FILE            *file;          /* file being read */
 479 {
 480         register int    done;
 481
 482         /* we know that we point to a non-blank character here;
 483          * must do a Skip_Blanks before we exit, so that the
 484          * next call (or the code that picks up the cmd) can
 485          * assume the same thing.
 486          */
 487
 488         Debug(DPARS|DEXT, ("get_list()...entered\n"))
 489
 490         /* list = range {"," range}
 491          */
 492
 493         /* clear the bit string, since the default is 'off'.
 494          */
 495         bit_nclear(bits, 0, (high-low+1));
 496
 497         /* process all ranges
 498          */
 499         done = FALSE;
 500         while (!done) {
 501                 ch = get_range(bits, low, high, names, ch, file);
 502                 if (ch == ',')
 503                         ch = get_char(file);
 504                 else
 505                         done = TRUE;
 506         }
 507
 508         /* exiting.  skip to some blanks, then skip over the blanks.
 509          */
 510         Skip_Nonblanks(ch, file)
 511         Skip_Blanks(ch, file)
 512
 513         Debug(DPARS|DEXT, ("get_list()...exiting w/ %02x\n", ch))
 514
 515         return ch;
 516 }
 517
 518
 519 static char
 520 get_range(bits, low, high, names, ch, file)
 521         bitstr_t        *bits;          /* one bit per flag, default=FALSE */
 522         int             low, high;      /* bounds, impl. offset for bitstr */
 523         char            *names[];       /* NULL or names of elements */
 524         int             ch;             /* current character being processed */
 525         FILE            *file;          /* file being read */
 526 {
 527         /* range = number | number "-" number [ "/" number ]
 528          */
 529
 530         register int    i;
 531         auto int        num1, num2, num3;
 532
 533         Debug(DPARS|DEXT, ("get_range()...entering, exit won't show\n"))
 534
 535         if (ch == '*') {
 536                 /* '*' means "first-last" but can still be modified by /step
 537                  */
 538                 num1 = low;
 539                 num2 = high;
 540                 ch = get_char(file);
 541                 if (ch == EOF)
 542                         return EOF;
 543         } else {
 544                 if (EOF == (ch = get_number(&num1, low, names, ch, file)))
 545                         return EOF;
 546
 547                 if (ch == '/')
 548                         num2 = high;
 549                 else if (ch != '-') {
 550                         /* not a range, it's a single number.
 551                          */
 552                         if (EOF == set_element(bits, low, high, num1))
 553                                 return EOF;
 554                         return ch;
 555                 } else {
 556                         /* eat the dash
 557                          */
 558                         ch = get_char(file);
 559                         if (ch == EOF)
 560                                 return EOF;
 561
 562                         /* get the number following the dash
 563                          */
 564                         ch = get_number(&num2, low, names, ch, file);
 565                         if (ch == EOF)
 566                                 return EOF;
 567                 }
 568         }
 569
 570         /* check for step size
 571          */
 572         if (ch == '/') {
 573                 /* eat the slash
 574                  */
 575                 ch = get_char(file);
 576                 if (ch == EOF)
 577                         return EOF;
 578
 579                 /* get the step size -- note: we don't pass the
 580                  * names here, because the number is not an
 581                  * element id, it's a step size.  'low' is
 582                  * sent as a 0 since there is no offset either.
 583                  */
 584                 ch = get_number(&num3, 0, PPC_NULL, ch, file);
 585                 if (ch == EOF || num3 == 0)
 586                         return EOF;
 587         } else {
 588                 /* no step.  default==1.
 589                  */
 590                 num3 = 1;
 591         }
 592
 593         /* range. set all elements from num1 to num2, stepping
 594          * by num3.  (the step is a downward-compatible extension
 595          * proposed conceptually by bob@acornrc, syntactically
 596          * designed then implmented by paul vixie).
 597          */
 598         for (i = num1;  i <= num2;  i += num3)
 599                 if (EOF == set_element(bits, low, high, i))
 600                         return EOF;
 601
 602         return ch;
 603 }
 604
 605
 606 static char
 607 get_number(numptr, low, names, ch, file)
 608         int     *numptr;        /* where does the result go? */
 609         int     low;            /* offset applied to result if symbolic enum used */
 610         char    *names[];       /* symbolic names, if any, for enums */
 611         int     ch;             /* current character */
 612         FILE    *file;          /* source */
 613 {
 614         char    temp[MAX_TEMPSTR], *pc;
 615         int     len, i, all_digits;
 616
 617         /* collect alphanumerics into our fixed-size temp array
 618          */
 619         pc = temp;
 620         len = 0;
 621         all_digits = TRUE;
 622         while (isalnum(ch)) {
 623                 if (++len >= MAX_TEMPSTR)
 624                         return EOF;
 625
 626                 *pc++ = ch;
 627
 628                 if (!isdigit(ch))
 629                         all_digits = FALSE;
 630
 631                 ch = get_char(file);
 632         }
 633         *pc = '\0';
 634         if (len == 0)
 635             return (EOF);
 636
 637         /* try to find the name in the name list
 638          */
 639         if (names) {
 640                 for (i = 0;  names[i] != NULL;  i++) {
 641                         Debug(DPARS|DEXT,
 642                                 ("get_num, compare(%s,%s)\n", names[i], temp))
 643                         if (!strcasecmp(names[i], temp)) {
 644                                 *numptr = i+low;
 645                                 return ch;
 646                         }
 647                 }
 648         }
 649
 650         /* no name list specified, or there is one and our string isn't
 651          * in it.  either way: if it's all digits, use its magnitude.
 652          * otherwise, it's an error.
 653          */
 654         if (all_digits) {
 655                 *numptr = atoi(temp);
 656                 return ch;
 657         }
 658
 659         return EOF;
 660 }
 661
 662
 663 static int
 664 set_element(bits, low, high, number)
 665         bitstr_t        *bits;          /* one bit per flag, default=FALSE */
 666         int             low;
 667         int             high;
 668         int             number;
 669 {
 670         Debug(DPARS|DEXT, ("set_element(?,%d,%d,%d)\n", low, high, number))
 671
 672         if (number < low || number > high)
 673                 return EOF;
 674
 675         bit_set(bits, (number-low));
 676         return OK;
 677 }