git.gag.com Git - debian/amanda/blob - common-src/amanda.h

   1 /*
   2  * Amanda, The Advanced Maryland Automatic Network Disk Archiver
   3  * Copyright (c) 1991-1998 University of Maryland at College Park
   4  * All Rights Reserved.
   5  *
   6  * Permission to use, copy, modify, distribute, and sell this software and its
   7  * documentation for any purpose is hereby granted without fee, provided that
   8  * the above copyright notice appear in all copies and that both that
   9  * copyright notice and this permission notice appear in supporting
  10  * documentation, and that the name of U.M. not be used in advertising or
  11  * publicity pertaining to distribution of the software without specific,
  12  * written prior permission.  U.M. makes no representations about the
  13  * suitability of this software for any purpose.  It is provided "as is"
  14  * without express or implied warranty.
  15  *
  16  * U.M. DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING ALL
  17  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO EVENT SHALL U.M.
  18  * BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
  19  * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION
  20  * OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN
  21  * CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  22  *
  23  * Authors: the Amanda Development Team.  Its members are listed in a
  24  * file named AUTHORS, in the root directory of this distribution.
  25  */
  26 /*
  27  * $Id: amanda.h,v 1.66.2.7.4.5.2.12.2.4 2004/08/02 18:56:32 martinea Exp $
  28  *
  29  * the central header file included by all amanda sources
  30  */
  31 #ifndef AMANDA_H
  32 #define AMANDA_H
  33
  34 #ifdef HAVE_CONFIG_H
  35 #include "config.h"
  36 #endif
  37
  38 /*
  39  * I would prefer that each Amanda module include only those system headers
  40  * that are locally needed, but on most Unixes the system header files are not
  41  * protected against multiple inclusion, so this can lead to problems.
  42  *
  43  * Also, some systems put key files in different places, so by including
  44  * everything here the rest of the system is isolated from such things.
  45  */
  46 #ifdef HAVE_ALLOCA_H
  47 #  include <alloca.h>
  48 #endif
  49
  50 #if 0
  51 /* an explanation for this is available in the CHANGES file for
  52    amanda-2.4.0b5 */
  53 #ifdef HAVE_ASM_BYTEORDER_H
  54 #  include <asm/byteorder.h>
  55 #endif
  56 #endif
  57
  58 #ifdef HAVE_SYS_TYPES_H
  59 #  include <sys/types.h>
  60 #endif
  61
  62 /* from the autoconf documentation */
  63 #ifdef HAVE_DIRENT_H
  64 #  include <dirent.h>
  65 #  define NAMLEN(dirent) strlen((dirent)->d_name)
  66 #else
  67 #  define dirent direct
  68 #  define NAMLEN(dirent) (dirent)->d_namlen
  69 #  if HAVE_SYS_NDIR_H
  70 #    include <sys/ndir.h>
  71 #  endif
  72 #  if HAVE_SYS_DIR_H
  73 #    include <sys/dir.h>
  74 #  endif
  75 #  if HAVE_NDIR_H
  76 #    include <ndir.h>
  77 #  endif
  78 #endif
  79
  80 #ifdef HAVE_FCNTL_H
  81 #  include <fcntl.h>
  82 #endif
  83
  84 #ifdef HAVE_GRP_H
  85 #  include <grp.h>
  86 #endif
  87
  88 #if defined(USE_DB_H)
  89 #  include <db.h>
  90 #else
  91 #if defined(USE_DBM_H)
  92 #  include <dbm.h>
  93 #else
  94 #if defined(USE_GDBM_H)
  95 #  include <gdbm.h>
  96 #else
  97 #if defined(USE_NDBM_H)
  98 #  include <ndbm.h>
  99 #endif
 100 #endif
 101 #endif
 102 #endif
 103
 104 #ifdef HAVE_NETDB_H
 105 #  include <netdb.h>
 106 #endif
 107
 108 #ifdef TIME_WITH_SYS_TIME
 109 #  include <sys/time.h>
 110 #  include <time.h>
 111 #else
 112 #  ifdef HAVE_SYS_TIME_H
 113 #    include <sys/time.h>
 114 #  else
 115 #    include <time.h>
 116 #  endif
 117 #endif
 118
 119 #ifdef HAVE_LIBC_H
 120 #  include <libc.h>
 121 #endif
 122
 123 #ifdef HAVE_STDLIB_H
 124 #  include <stdlib.h>
 125 #endif
 126
 127 #ifdef HAVE_STRING_H
 128 #  include <string.h>
 129 #endif
 130
 131 #ifdef HAVE_STRINGS_H
 132 #  include <strings.h>
 133 #endif
 134
 135 #ifdef HAVE_SYSLOG_H
 136 #  include <syslog.h>
 137 #endif
 138
 139 #ifdef HAVE_SYS_FILE_H
 140 #  include <sys/file.h>
 141 #endif
 142
 143 #ifdef HAVE_SYS_IOCTL_H
 144 #  include <sys/ioctl.h>
 145 #endif
 146
 147 #ifdef HAVE_SYS_PARAM_H
 148 #  include <sys/param.h>
 149 #endif
 150
 151 #if defined(HAVE_SYS_IPC_H) && defined(HAVE_SYS_SHM_H)
 152 #  include <sys/ipc.h>
 153 #  include <sys/shm.h>
 154 #else
 155 #  ifdef HAVE_SYS_MMAN_H
 156 #    include <sys/mman.h>
 157 #  endif
 158 #endif
 159
 160 #ifdef HAVE_SYS_SELECT_H
 161 #  include <sys/select.h>
 162 #endif
 163
 164 #ifdef HAVE_SYS_STAT_H
 165 #  include <sys/stat.h>
 166 #endif
 167
 168 #ifdef HAVE_WAIT_H
 169 #  include <wait.h>
 170 #endif
 171
 172 #ifdef HAVE_SYS_WAIT_H
 173 #  include <sys/wait.h>
 174 #endif
 175
 176 #ifdef WAIT_USES_INT
 177   typedef int amwait_t;
 178 # ifndef WEXITSTATUS
 179 #  define WEXITSTATUS(stat_val) (*(unsigned*)&(stat_val) >> 8)
 180 # endif
 181 # ifndef WTERMSIG
 182 #  define WTERMSIG(stat_val) (*(unsigned*)&(stat_val) & 0x7F)
 183 # endif
 184 # ifndef WIFEXITED
 185 #  define WIFEXITED(stat_val) ((*(unsigned*)&(stat_val) & 255) == 0)
 186 # endif
 187 #else
 188 # ifdef WAIT_USES_UNION
 189    typedef union wait amwait_t;
 190 #  ifndef WEXITSTATUS
 191 #  define WEXITSTATUS(stat_val) (((amwait_t*)&(stat_val))->w_retcode)
 192 #  endif
 193 #  ifndef WTERMSIG
 194 #   define WTERMSIG(stat_val) (((amwait_t*)&(stat_val))->w_termsig)
 195 #  endif
 196 #  ifndef WIFEXITED
 197 #   define WIFEXITED(stat_val) (WTERMSIG(stat_val) == 0)
 198 #  endif
 199 # else
 200    typedef int amwait_t;
 201 #  ifndef WEXITSTATUS
 202 #   define WEXITSTATUS(stat_val) (*(unsigned*)&(stat_val) >> 8)
 203 #  endif
 204 #  ifndef WTERMSIG
 205 #   define WTERMSIG(stat_val) (*(unsigned*)&(stat_val) & 0x7F)
 206 #  endif
 207 #  ifndef WIFEXITED
 208 #   define WIFEXITED(stat_val) ((*(unsigned*)&(stat_val) & 255) == 0)
 209 #  endif
 210 # endif
 211 #endif
 212
 213 #ifdef HAVE_UNISTD_H
 214 #  include <unistd.h>
 215 #endif
 216
 217 /*
 218  * At present, the kerberos routines require atexit(), or equivilent.  If
 219  * you're not using kerberos, you don't need it at all.  If you just null
 220  * out the definition, you'll end up with ticket files hanging around in
 221  * /tmp.
 222  */
 223 #if defined(KRB4_SECURITY)
 224 #   if !defined(HAVE_ATEXIT)
 225 #      if defined(HAVE_ON_EXIT)
 226 #          define atexit(func) on_exit(func, 0)
 227 #      else
 228 #          define atexit(func) (you must to resolve lack of atexit in amanda.h)
 229 #      endif
 230 #   endif
 231 #endif
 232
 233 #include <ctype.h>
 234 #include <errno.h>
 235 #include <netinet/in.h>
 236 #include <pwd.h>
 237 #include <signal.h>
 238 #include <setjmp.h>
 239 #include <stdio.h>
 240 #include <sys/resource.h>
 241 #include <sys/socket.h>
 242
 243 #if !defined(CONFIGURE_TEST)
 244 #  include "amanda-int.h"
 245 #endif
 246
 247 #ifdef HAVE_ARPA_INET_H
 248 #include <arpa/inet.h>
 249 #endif
 250
 251 #ifdef KRB4_SECURITY
 252 #  include <des.h>
 253 #  include <krb.h>
 254 #endif
 255
 256 /*
 257  * The dbmalloc package comes from:
 258  *
 259  *  http://www.clark.net/pub/dickey/dbmalloc/dbmalloc.tar.gz
 260  *
 261  * or
 262  *
 263  *  ftp://gatekeeper.dec.com/pub/usenet/comp.sources.misc/volume32/dbmalloc/
 264  *
 265  * The following functions are sprinkled through the code, but are
 266  * disabled unless USE_DBMALLOC is defined:
 267  *
 268  *  malloc_enter(char *) -- stack trace for malloc reports
 269  *  malloc_leave(char *) -- stack trace for malloc reports
 270  *  malloc_mark(void *) -- mark an area as never to be free-d
 271  *  malloc_chain_check(void) -- check the malloc area now
 272  *  malloc_dump(int fd) -- report the malloc contents to a file descriptor
 273  *  malloc_list(int fd, ulong a, ulong b) -- report memory activated since
 274  *      history stamp a that is still active as of stamp b (leak check)
 275  *  malloc_inuse(ulong *h) -- create history stamp h and return the amount
 276  *      of memory currently in use.
 277  */
 278
 279 #ifdef USE_DBMALLOC
 280 #include "dbmalloc.h"
 281 #else
 282 #define malloc_enter(func)
 283 #define malloc_leave(func)
 284 #define malloc_mark(ptr)
 285 #define malloc_chain_check()
 286 #define malloc_dump(fd)
 287 #define malloc_list(a,b,c)
 288 #define malloc_inuse(hist)              (*(hist) = 0, 0)
 289 #define dbmalloc_caller_loc(x,y)        (x)
 290 #endif
 291
 292 #if !defined(HAVE_SIGACTION) && defined(HAVE_SIGVEC)
 293 /* quick'n'dirty hack for NextStep31 */
 294 #  define sa_flags sv_flags
 295 #  define sa_handler sv_handler
 296 #  define sa_mask sv_mask
 297 #  define sigaction sigvec
 298 #  define sigemptyset(mask) /* no way to clear pending signals */
 299 #endif
 300
 301 /*
 302  * Most Unixen declare errno in <errno.h>, some don't.  Some multithreaded
 303  * systems have errno as a per-thread macro.  So, we have to be careful.
 304  */
 305 #ifndef errno
 306 extern int errno;
 307 #endif
 308
 309
 310 /*
 311  * Some older BSD systems don't have these FD_ macros, so if not, provide them.
 312  */
 313 #ifndef FD_SET
 314 #  define FD_SETSIZE      (sizeof(fd_set) * 8)
 315 #  define FD_SET(n, p)    (((fd_set *) (p))->fds_bits[0] |= (1 << ((n) % 32)))
 316 #  define FD_CLR(n, p)    (((fd_set *) (p))->fds_bits[0] &= ~(1 << ((n) % 32)))
 317 #  define FD_ISSET(n, p)  (((fd_set *) (p))->fds_bits[0] & (1 << ((n) % 32)))
 318 #  define FD_ZERO(p)      memset((p), 0, sizeof(*(p)))
 319 #endif
 320
 321
 322 /*
 323  * Define MAX_HOSTNAME_LENGTH as the size of arrays to hold hostname's.
 324  */
 325 #undef  MAX_HOSTNAME_LENGTH
 326 #define MAX_HOSTNAME_LENGTH 1025
 327
 328 /*
 329  * If void is broken, substitute char.
 330  */
 331 #ifdef BROKEN_VOID
 332 #  define void char
 333 #endif
 334
 335 /*
 336  * define prototype macro so that prototypes can be declared in both ANSI
 337  * and classic C environments.
 338  */
 339 #if STDC_HEADERS
 340 #  define P(parms)      parms
 341 #  define stringize(x) #x
 342 #else
 343 #  define P(parms)      ()
 344 #  define stringize(x) "x"
 345 #endif
 346
 347 /*
 348  * So that we can use GNUC attributes (such as to get -Wall warnings
 349  * for printf-like functions).  Only do this in gcc 2.7 or later ...
 350  * it may work on earlier stuff, but why chance it.
 351  */
 352 #if !defined(__GNUC__) || __GNUC__ < 2 || __GNUC_MINOR__ < 7
 353 #define __attribute__(__x)
 354 #endif
 355
 356 /*
 357  * assertions, but call error() instead of abort
 358  */
 359 #ifndef ASSERTIONS
 360
 361 #define assert(exp) ((void)0)
 362
 363 #else   /* ASSERTIONS */
 364
 365 #define assert(exp) {if(!(exp)) error("assert: %s false, file %s, line %d", \
 366                                    stringize(exp), __FILE__, __LINE__);}
 367
 368 #endif  /* ASSERTIONS */
 369
 370 /*
 371  * print debug output, else compile to nothing.
 372  */
 373
 374 #ifdef DEBUG_CODE                                                       /* { */
 375 #   define dbopen()     debug_open()
 376 #   define dbclose()    debug_close()
 377 #   define dbprintf(p)  (debug? (debug_printf p, 0) : 0)
 378 #   define dbfd()       debug_fd()
 379 #   define dbfp()       debug_fp()
 380 #   define dbfn()       debug_fn()
 381
 382 extern void debug_open P((void));
 383 extern void debug_close P((void));
 384 extern void debug_printf P((char *format, ...))
 385     __attribute__ ((format (printf, 1, 2)));
 386 extern int  debug_fd P((void));
 387 extern FILE *  debug_fp P((void));
 388 extern char *  debug_fn P((void));
 389 extern void set_debug_prefix_pid P((pid_t));
 390 extern char *debug_prefix P((char *));
 391 extern char *debug_prefix_time P((char *));
 392 #else                                                                   /* }{ */
 393 #   define dbopen()
 394 #   define dbclose()
 395 #   define dbprintf(p)
 396 #   define dbfd()       (-1)
 397 #   define dbfp()       NULL
 398 #   define dbfn()       NULL
 399 #   define set_debug_prefix_pid(x)
 400 #   define debug_prefix(x) get_pname()
 401 #   define debug_prefix_time(x) get_pname()
 402 #endif                                                                  /* } */
 403
 404 /* amanda #days calculation, with roundoff */
 405
 406 #define SECS_PER_DAY    (24*60*60)
 407 #define days_diff(a, b) (((b) - (a) + SECS_PER_DAY/2) / SECS_PER_DAY)
 408
 409 /* Global constants.  */
 410 #ifndef AMANDA_SERVICE_NAME
 411 #define AMANDA_SERVICE_NAME "amanda"
 412 #endif
 413 #ifndef KAMANDA_SERVICE_NAME
 414 #define KAMANDA_SERVICE_NAME "kamanda"
 415 #endif
 416 #ifndef SERVICE_SUFFIX
 417 #define SERVICE_SUFFIX ""
 418 #endif
 419 #ifndef AMANDA_SERVICE_DEFAULT
 420 #define AMANDA_SERVICE_DEFAULT  10080
 421 #endif
 422 #ifndef KAMANDA_SERVICE_DEFAULT
 423 #define KAMANDA_SERVICE_DEFAULT 10081
 424 #endif
 425
 426 #define am_round(v,u)   ((((v) + (u) - 1) / (u)) * (u))
 427 #define am_floor(v,u)   (((v) / (u)) * (u))
 428
 429 /* Holding disk block size.  Do not even think about changing this!  :-) */
 430 #define DISK_BLOCK_KB           32
 431 #define DISK_BLOCK_BYTES        (DISK_BLOCK_KB * 1024)
 432
 433 /* Maximum size of a tape block */
 434 /* MAX_TAPE_BLOCK_KB is defined in config.h */
 435 /* by configure --with-maxtapeblocksize     */
 436 #define MAX_TAPE_BLOCK_BYTES (MAX_TAPE_BLOCK_KB*1024)
 437
 438 /* Define miscellaneous amanda functions.  */
 439 #define ERR_INTERACTIVE 1
 440 #define ERR_SYSLOG      2
 441 #define ERR_AMANDALOG   4
 442
 443 /* For static buffer manager [alloc.c:sbuf_man()] */
 444 #define SBUF_MAGIC 42
 445 #define SBUF_DEF(name, len) static SBUF2_DEF(len) name = {SBUF_MAGIC, len, -1}
 446 #define SBUF2_DEF(len)          \
 447     struct {                    \
 448         int magic;              \
 449         int max, cur;           \
 450         void *bufp[len];        \
 451     }
 452
 453 extern void   set_logerror P((void (*f)(char *)));
 454 extern void   set_pname P((char *pname));
 455 extern char  *get_pname P((void));
 456 extern int    erroutput_type;
 457 extern void   error     P((char *format, ...))
 458     __attribute__ ((format (printf, 1, 2)));
 459 extern void   errordump P((char *format, ...))
 460     __attribute__ ((format (printf, 1, 2)));
 461 extern int    onerror         P((void (*errf)(void)));
 462
 463 extern void  *debug_alloc           P((char *c, int l, size_t size));
 464 extern void  *debug_newalloc        P((char *c, int l, void *old, size_t size));
 465 extern char  *debug_stralloc        P((char *c, int l, const char *str));
 466 extern char  *debug_newstralloc     P((char *c, int l, char *oldstr, const char *newstr));
 467 extern char  *debug_caller_loc      P((char *file, int line));
 468
 469 extern int   debug_alloc_push       P((char *file, int line));
 470 extern void  debug_alloc_pop        P((void));
 471
 472 #define alloc(s)                debug_alloc(__FILE__, __LINE__, (s))
 473 #define newalloc(p,s)           debug_newalloc(__FILE__, __LINE__, (p), (s))
 474 #define stralloc(s)             debug_stralloc(__FILE__, __LINE__, (s))
 475 #define newstralloc(p,s)        debug_newstralloc(__FILE__, __LINE__, (p), (s))
 476
 477 /*
 478  * Voodoo time.  We want to be able to mark these calls with the source
 479  * line, but CPP does not handle variable argument lists so we cannot
 480  * do what we did above (e.g. for alloc()).
 481  *
 482  * What we do is call a function to save the file and line number
 483  * and have it return "false".  That triggers the "?" operator to
 484  * the right side of the ":" which is a call to the debug version of
 485  * vstralloc/newvstralloc but without parameters.  The compiler gets
 486  * those from the next input tokens:
 487  *
 488  *  xx = vstralloc(a,b,NULL);
 489  *
 490  * becomes:
 491  *
 492  *  xx = debug_alloc_push(__FILE__,__LINE__)?0:debug_vstralloc(a,b,NULL);
 493  *
 494  * This works as long as vstralloc/newvstralloc are not part of anything
 495  * very complicated.  Assignment is fine, as is an argument to another
 496  * function (but you should not do that because it creates a memory leak).
 497  * This will not work in arithmetic or comparison, but it is unlikely
 498  * they are used like that.
 499  *
 500  *  xx = vstralloc(a,b,NULL);                   OK
 501  *  return vstralloc(j,k,NULL);                 OK
 502  *  sub(a, vstralloc(g,h,NULL), z);             OK, but a leak
 503  *  if(vstralloc(s,t,NULL) == NULL) { ...       NO, but unneeded
 504  *  xx = vstralloc(x,y,NULL) + 13;              NO, but why do it?
 505  */
 506
 507 #define vstralloc debug_alloc_push(__FILE__,__LINE__)?0:debug_vstralloc
 508 #define newvstralloc debug_alloc_push(__FILE__,__LINE__)?0:debug_newvstralloc
 509
 510 extern char  *debug_vstralloc       P((const char *str, ...));
 511 extern char  *debug_newvstralloc    P((char *oldstr, const char *newstr, ...));
 512
 513 #define stralloc2(s1,s2)      vstralloc((s1),(s2),NULL)
 514 #define newstralloc2(p,s1,s2) newvstralloc((p),(s1),(s2),NULL)
 515
 516 extern char  *debug_agets     P((char *c, int l, FILE *file));
 517 extern char  *debug_areads    P((char *c, int l, int fd));
 518 #define agets(f)              debug_agets(__FILE__,__LINE__,(f))
 519 #define areads(f)             debug_areads(__FILE__,__LINE__,(f))
 520
 521 extern int debug_amtable_alloc P((char *file,
 522                                   int line,
 523                                   void **table,
 524                                   int *current,
 525                                   size_t elsize,
 526                                   int count,
 527                                   int bump,
 528                                   void (*init_func)(void *)));
 529 #define amtable_alloc(t,c,s,n,b,f) debug_amtable_alloc(__FILE__,        \
 530                                                        __LINE__,        \
 531                                                        (t),             \
 532                                                        (c),             \
 533                                                        (s),             \
 534                                                        (n),             \
 535                                                        (b),             \
 536                                                        (f))
 537 extern void amtable_free      P((void **table, int *current));
 538
 539 extern void  *sbuf_man        P((void *bufs, void *ptr));
 540 extern uid_t  client_uid;
 541 extern gid_t  client_gid;
 542 extern void   safe_cd         P((void));
 543 extern void   save_core       P((void));
 544 extern char **safe_env        P((void));
 545 extern char  *validate_regexp P((char *regex));
 546 extern char  *validate_glob   P((char *glob));
 547 extern char  *clean_regex     P((char *regex));
 548 extern int    match           P((char *regex, char *str));
 549 extern int    match_glob      P((char *glob, char *str));
 550 extern char  *glob_to_regex   P((char *glob));
 551 extern int    match_tar       P((char *glob, char *str));
 552 extern char  *tar_to_regex    P((char *glob));
 553 extern int    match_host      P((char *glob, char *host));
 554 extern int    match_disk      P((char *glob, char *disk));
 555 extern int    match_datestamp P((char *dateexp, char *datestamp));
 556 extern time_t unctime         P((char *timestr));
 557 extern ssize_t  areads_dataready  P((int fd));
 558 extern void     areads_relbuf     P((int fd));
 559
 560 /*
 561  * amfree(ptr) -- if allocated, release space and set ptr to NULL.
 562  *
 563  * In general, this should be called instead of just free(), unless
 564  * the very next source line sets the pointer to a new value.
 565  */
 566
 567 #define amfree(ptr) do {                                                \
 568     if(ptr) {                                                           \
 569         int e__errno = errno;                                           \
 570         free(ptr);                                                      \
 571         (ptr) = NULL;                                                   \
 572         errno = e__errno;                                               \
 573     }                                                                   \
 574 } while(0)
 575
 576 #define strappend(s1,s2) do {                                           \
 577     char *t_t_t = (s1) ? stralloc2((s1),(s2)) : stralloc((s2));         \
 578     amfree((s1));                                                       \
 579     (s1) = t_t_t;                                                       \
 580 } while(0)
 581
 582 /*
 583  * "Safe" close macros.  Close the object then set it to a value that
 584  * will cause an error if referenced.
 585  *
 586  * aclose(fd) -- close a file descriptor and set it to -1.
 587  * afclose(f) -- close a stdio file and set it to NULL.
 588  * apclose(p) -- close a stdio pipe file and set it to NULL.
 589  *
 590  * Note: be careful not to do the following:
 591  *
 592  *  for(fd = low; fd < high; fd++) {
 593  *      aclose(fd);
 594  *  }
 595  *
 596  * Since aclose() sets the argument to -1, this will loop forever.
 597  * Just copy fd to a temp variable and use that with aclose().
 598  *
 599  * Aclose() interacts with areads() to inform it to release any buffer
 600  * it has outstanding on the file descriptor.
 601  */
 602
 603 #define aclose(fd) do {                                                 \
 604     if((fd) >= 0) {                                                     \
 605         close(fd);                                                      \
 606         areads_relbuf(fd);                                              \
 607     }                                                                   \
 608     (fd) = -1;                                                          \
 609 } while(0)
 610
 611 #define afclose(f) do {                                                 \
 612     if((f) != NULL) {                                                   \
 613         fclose(f);                                                      \
 614     }                                                                   \
 615     (f) = NULL;                                                         \
 616 } while(0)
 617
 618 #define apclose(p) do {                                                 \
 619     if((p) != NULL) {                                                   \
 620         pclose(p);                                                      \
 621     }                                                                   \
 622     (p) = NULL;                                                         \
 623 } while(0)
 624
 625 /*
 626  * Return the number of elements in an array.
 627  */
 628 #define am_countof(a)        (sizeof(a) / sizeof((a)[0]))
 629
 630 /*
 631  * min/max.  Don't do something like
 632  *
 633  *    x = min(y++, z);
 634  *
 635  * because the increment will be duplicated.
 636  */
 637 #undef min
 638 #undef max
 639 #define min(a, b)       ((a) < (b) ? (a) : (b))
 640 #define max(a, b)       ((a) > (b) ? (a) : (b))
 641
 642 /*
 643  * Utility string macros.  All assume a variable holds the current
 644  * character and the string pointer points to the next character to
 645  * be processed.  Typical setup is:
 646  *
 647  *  s = buffer;
 648  *  ch = *s++;
 649  *  skip_whitespace(s, ch);
 650  *  ...
 651  *
 652  * If you advance the pointer "by hand" to skip over something, do
 653  * it like this:
 654  *
 655  *  s += some_amount;
 656  *  ch = s[-1];
 657  *
 658  * Note that ch has the character at the end of the just skipped field.
 659  * It is often useful to terminate a string, make a copy, then restore
 660  * the input like this:
 661  *
 662  *  skip_whitespace(s, ch);
 663  *  fp = s-1;                   ## save the start
 664  *  skip_nonwhitespace(s, ch);  ## find the end
 665  *  p[-1] = '\0';               ## temporary terminate
 666  *  field = stralloc(fp);       ## make a copy
 667  *  p[-1] = ch;                 ## restore the input
 668  *
 669  * The scanning macros are:
 670  *
 671  *  skip_whitespace (ptr, var)
 672  *    -- skip whitespace, but stops at a newline
 673  *  skip_non_whitespace (ptr, var)
 674  *    -- skip non whitespace
 675  *  skip_non_whitespace_cs (ptr, var)
 676  *    -- skip non whitespace, stop at comment
 677  *  skip_integer (ptr, var)
 678  *    -- skip an integer field
 679  *  skip_line (ptr, var)
 680  *    -- skip just past the next newline
 681  *
 682  * where:
 683  *
 684  *  ptr -- string pointer
 685  *  var -- current character
 686  *
 687  * These macros copy a non-whitespace field to a new buffer, and should
 688  * only be used if dynamic allocation is impossible (fixed size buffers
 689  * are asking for trouble):
 690  *
 691  *  copy_string (ptr, var, field, len, fldptr)
 692  *    -- copy a non-whitespace field
 693  *  copy_string_cs (ptr, var, field, len, fldptr)
 694  *    -- copy a non-whitespace field, stop at comment
 695  *
 696  * where:
 697  *
 698  *  ptr -- string pointer
 699  *  var -- current character
 700  *  field -- area to copy to
 701  *  len -- length of area (needs room for null byte)
 702  *  fldptr -- work pointer used in move
 703  *            if NULL on exit, the field was too small for the input
 704  */
 705
 706 #define STR_SIZE        1024            /* a generic string buffer size */
 707 #define NUM_STR_SIZE    32              /* a generic number buffer size */
 708
 709 #define skip_whitespace(ptr,c) do {                                     \
 710     while((c) != '\n' && isspace(c)) (c) = *(ptr)++;                    \
 711 } while(0)
 712
 713 #define skip_non_whitespace(ptr,c) do {                                 \
 714     while((c) != '\0' && !isspace(c)) (c) = *(ptr)++;                   \
 715 } while(0)
 716
 717 #define skip_non_whitespace_cs(ptr,c) do {                              \
 718     while((c) != '\0' && (c) != '#' && !isspace(c)) (c) = *(ptr)++;     \
 719 } while(0)
 720
 721 #define skip_non_integer(ptr,c) do {                                    \
 722     while((c) != '\0' && !isdigit(c)) (c) = *(ptr)++;                   \
 723 } while(0)
 724
 725 #define skip_integer(ptr,c) do {                                        \
 726     if((c) == '+' || (c) == '-') (c) = *(ptr)++;                        \
 727     while(isdigit(c)) (c) = *(ptr)++;                                   \
 728 } while(0)
 729
 730 #define skip_line(ptr,c) do {                                           \
 731     while((c) && (c) != '\n') (c) = *(ptr)++;                           \
 732     if(c) (c) = *(ptr)++;                                               \
 733 } while(0)
 734
 735 #define copy_string(ptr,c,f,l,fp) do {                                  \
 736     (fp) = (f);                                                         \
 737     while((c) != '\0' && !isspace(c)) {                                 \
 738         if((fp) >= (f) + (l) - 1) {                                     \
 739             *(fp) = '\0';                                               \
 740             (fp) = NULL;                                                \
 741             break;                                                      \
 742         }                                                               \
 743         *(fp)++ = (c);                                                  \
 744         (c) = *(ptr)++;                                                 \
 745     }                                                                   \
 746     if(fp) *fp = '\0';                                                  \
 747 } while(0)
 748
 749 #define copy_string_cs(ptr,c,f,l,fp) do {                               \
 750     (fp) = (f);                                                         \
 751     while((c) != '\0' && (c) != '#' && !isspace(c)) {                   \
 752         if((fp) >= (f) + (l) - 1) {                                     \
 753             *(fp) = '\0';                                               \
 754             (fp) = NULL;                                                \
 755             break;                                                      \
 756         }                                                               \
 757         *(fp)++ = (c);                                                  \
 758         (c) = *(ptr)++;                                                 \
 759     }                                                                   \
 760     if(fp) *fp = '\0';                                                  \
 761 } while(0)
 762
 763 #define is_dot_or_dotdot(s)                                             \
 764     ((s)[0] == '.'                                                      \
 765      && ((s)[1] == '\0'                                                 \
 766          || ((s)[1] == '.' && (s)[2] == '\0')))
 767
 768 /* from amflock.c */
 769 extern int    amflock   P((int fd, char *resource));
 770 extern int    amroflock P((int fd, char *resource));
 771 extern int    amfunlock P((int fd, char *resource));
 772
 773 /* from file.c */
 774 extern int    mkpdir    P((char *file, int mode, uid_t uid, gid_t gid));
 775 extern int    rmpdir    P((char *file, char *topdir));
 776 extern char  *sanitise_filename P((char *inp));
 777
 778 extern int debug;
 779 extern char *version_info[];
 780
 781 /* from security.c */
 782 extern int security_ok P((struct sockaddr_in *addr,
 783                           char *str, uint32_t cksum, char **errstr));
 784 extern char *get_bsd_security P((void));
 785
 786 /*
 787  * Handle functions which are not always declared on all systems.  This
 788  * stops gcc -Wall and lint from complaining.
 789  */
 790
 791 /* AIX #defines accept, and provides a prototype for the alternate name */
 792 #if !defined(HAVE_ACCEPT_DECL) && !defined(accept)
 793 extern int accept P((int s, struct sockaddr *addr, int *addrlen));
 794 #endif
 795
 796 #ifndef HAVE_ATOF_DECL
 797 extern double atof P((const char *ptr));
 798 #endif
 799
 800 #ifndef HAVE_BCOPY
 801 # define bcopy(from,to,n) ((void)memmove((to), (from), (n)))
 802 #else
 803 # ifndef HAVE_BCOPY_DECL
 804 extern void bcopy P((const void *s1, void *s2, size_t n));
 805 # endif
 806 #endif
 807
 808 #ifndef HAVE_BIND_DECL
 809 extern int bind P((int s, const struct sockaddr *name, int namelen));
 810 #endif
 811
 812 #ifndef HAVE_BZERO
 813 #define bzero(s,n) ((void)memset((s),0,(n)))
 814 #else
 815 # ifndef HAVE_BZERO_DECL
 816 extern void bzero P((void *s, size_t n));
 817 # endif
 818 #endif
 819
 820 #ifndef HAVE_CLOSELOG_DECL
 821 extern void closelog P((void));
 822 #endif
 823
 824 #ifndef HAVE_CONNECT_DECL
 825 extern int connect P((int s, struct sockaddr *name, int namelen));
 826 #endif
 827
 828 #if !defined(TEXTDB) && !defined(HAVE_DBM_OPEN_DECL)
 829 #undef   DBM_INSERT
 830 #define  DBM_INSERT  0
 831
 832 #undef   DBM_REPLACE
 833 #define  DBM_REPLACE 1
 834
 835     typedef struct {
 836         int dummy[10];
 837     } DBM;
 838
 839 #ifndef HAVE_STRUCT_DATUM
 840     typedef struct {
 841         char    *dptr;
 842         int     dsize;
 843     } datum;
 844 #endif
 845
 846     extern DBM   *dbm_open     P((char *file, int flags, int mode));
 847     extern void   dbm_close    P((DBM *db));
 848     extern datum  dbm_fetch    P((DBM *db, datum key));
 849     extern datum  dbm_firstkey P((DBM *db));
 850     extern datum  dbm_nextkey  P((DBM *db));
 851     extern int    dbm_delete   P((DBM *db, datum key));
 852     extern int    dbm_store    P((DBM *db, datum key, datum content, int flg));
 853 #endif
 854
 855 #ifndef HAVE_FCLOSE_DECL
 856 extern int fclose P((FILE *stream));
 857 #endif
 858
 859 #ifndef HAVE_FFLUSH_DECL
 860 extern int fflush P((FILE *stream));
 861 #endif
 862
 863 #ifndef HAVE_FPRINTF_DECL
 864 extern int fprintf P((FILE *stream, const char *format, ...));
 865 #endif
 866
 867 #ifndef HAVE_FPUTC_DECL
 868 extern int fputc P((int c, FILE *stream));
 869 #endif
 870
 871 #ifndef HAVE_FPUTS_DECL
 872 extern int fputs P((const char *s, FILE *stream));
 873 #endif
 874
 875 #ifndef HAVE_FREAD_DECL
 876 extern size_t fread P((void *ptr, size_t size, size_t nitems, FILE *stream));
 877 #endif
 878
 879 #ifndef HAVE_FSEEK_DECL
 880 extern int fseek P((FILE *stream, long offset, int ptrname));
 881 #endif
 882
 883 #ifndef HAVE_FWRITE_DECL
 884 extern size_t fwrite P((const void *ptr, size_t size, size_t nitems,
 885                         FILE *stream));
 886 #endif
 887
 888 #ifndef HAVE_GETHOSTNAME_DECL
 889 extern int gethostname P((char *name, int namelen));
 890 #endif
 891
 892 #ifndef HAVE_GETOPT_DECL
 893 extern char *optarg;
 894 extern int getopt P((int argc, char * const *argv, const char *optstring));
 895 #endif
 896
 897 /* AIX #defines getpeername, and provides a prototype for the alternate name */
 898 #if !defined(HAVE_GETPEERNAME_DECL) && !defined(getpeername)
 899 extern int getpeername P((int s, struct sockaddr *name, int *namelen));
 900 #endif
 901
 902 /* AIX #defines getsockname, and provides a prototype for the alternate name */
 903 #if !defined(HAVE_GETSOCKNAME_DECL) && !defined(getsockname)
 904 extern int getsockname P((int s, struct sockaddr *name, int *namelen));
 905 #endif
 906
 907 #ifndef HAVE_GETSOCKOPT_DECL
 908 extern int getsockopt P((int s, int level, int optname, char *optval,
 909                          int *optlen));
 910 #endif
 911
 912 #ifndef HAVE_GETTIMEOFDAY_DECL
 913 # ifdef HAVE_TWO_ARG_GETTIMEOFDAY
 914 extern int gettimeofday P((struct timeval *tp, struct timezone *tzp));
 915 # else
 916 extern int gettimeofday P((struct timeval *tp));
 917 # endif
 918 #endif
 919
 920 #ifndef HAVE_INITGROUPS
 921 # define initgroups(name,basegid) 0
 922 #else
 923 # ifndef HAVE_INITGROUPS_DECL
 924 /* modification by BIS@BBN 5/20/2003:
 925  * In some Unix systems, basegid is defined as a gid_t; in others
 926  * it is defined as an int.  On Mac OS X, there is a "pre-compiled"
 927  * unistd.h which causes the gcc -E command in the ICE_CHECK_DECL
 928  * autoconf macro to not succeed.  Thus, on Mac OS X, configure thinks
 929  * we don't have this declaration when we actually do.  Since Mac OS X
 930  * defines basegid as an int, this declaration causes a compilation
 931  * failure.  The path of least resistance for fixing this problem
 932  * is to just change the basegid declaration from gid_t to int, since
 933  * other (but not all) UNIX flavors also defined basegid as an int.
 934 extern int initgroups P((const char *name, gid_t basegid));
 935  */
 936 extern int initgroups P((const char *name, int basegid));
 937 # endif
 938 #endif
 939
 940 #ifndef HAVE_IOCTL_DECL
 941 extern int ioctl P((int fildes, int request, ...));
 942 #endif
 943
 944 #ifndef HAVE_LISTEN_DECL
 945 extern int listen P((int s, int backlog));
 946 #endif
 947
 948 #ifndef HAVE_LSTAT_DECL
 949 extern int lstat P((const char *path, struct stat *buf));
 950 #endif
 951
 952 #ifndef HAVE_MALLOC_DECL
 953 extern void *malloc P((size_t size));
 954 #endif
 955
 956 #ifndef HAVE_MEMMOVE_DECL
 957 #ifdef HAVE_MEMMOVE
 958 extern void *memmove P((void *to, const void *from, size_t n));
 959 #else
 960 extern char *memmove P((char *to, /*const*/ char *from, size_t n));
 961 #endif
 962 #endif
 963
 964 #ifndef HAVE_MEMSET_DECL
 965 extern void *memset P((void *s, int c, size_t n));
 966 #endif
 967
 968 #ifndef HAVE_MKTEMP_DECL
 969 extern char *mktemp P((char *template));
 970 #endif
 971
 972 #ifndef HAVE_MKTIME_DECL
 973 extern time_t mktime P((struct tm *timeptr));
 974 #endif
 975
 976 #ifndef HAVE_OPENLOG_DECL
 977 #ifdef LOG_AUTH
 978 extern void openlog P((const char *ident, int logopt, int facility));
 979 #else
 980 extern void openlog P((const char *ident, int logopt));
 981 #endif
 982 #endif
 983
 984 #ifndef HAVE_PCLOSE_DECL
 985 extern int pclose P((FILE *stream));
 986 #endif
 987
 988 #ifndef HAVE_PERROR_DECL
 989 extern void perror P((const char *s));
 990 #endif
 991
 992 #ifndef HAVE_PRINTF_DECL
 993 extern int printf P((const char *format, ...));
 994 #endif
 995
 996 #ifndef HAVE_PUTS_DECL
 997 extern int puts P((const char *s));
 998 #endif
 999
1000 #ifndef HAVE_REALLOC_DECL
1001 extern void *realloc P((void *ptr, size_t size));
1002 #endif
1003
1004 /* AIX #defines recvfrom, and provides a prototype for the alternate name */
1005 #if !defined(HAVE_RECVFROM_DECL) && !defined(recvfrom)
1006 extern int recvfrom P((int s, char *buf, int len, int flags,
1007                        struct sockaddr *from, int *fromlen));
1008 #endif
1009
1010 #ifndef HAVE_REMOVE_DECL
1011 extern int remove P((const char *path));
1012 #endif
1013
1014 #ifndef HAVE_RENAME_DECL
1015 extern int rename P((const char *old, const char *new));
1016 #endif
1017
1018 #ifndef HAVE_REWIND_DECL
1019 extern void rewind P((FILE *stream));
1020 #endif
1021
1022 #ifndef HAVE_RUSEROK_DECL
1023 extern int ruserok P((const char *rhost, int suser,
1024                       const char *ruser, const char *luser));
1025 #endif
1026
1027 #ifndef HAVE_SELECT_DECL
1028 extern int select P((int nfds,
1029                      SELECT_ARG_TYPE *readfds,
1030                      SELECT_ARG_TYPE *writefds,
1031                      SELECT_ARG_TYPE *exceptfds,
1032                      struct timeval *timeout));
1033 #endif
1034
1035 #ifndef HAVE_SENDTO_DECL
1036 extern int sendto P((int s, const char *msg, int len, int flags,
1037                      const struct sockaddr *to, int tolen));
1038 #endif
1039
1040 #ifdef HAVE_SETRESGID
1041 #define setegid(x)      setresgid(-1,(x),-1)
1042 #ifndef HAVE_SETRESGID_DECL
1043 extern int setresgid P((gid_t rgid, gid_t egid, gid_t sgid));
1044 #endif
1045 #else
1046 #ifndef HAVE_SETEGID_DECL
1047 extern int setegid P((gid_t egid));
1048 #endif
1049 #endif
1050
1051 #ifdef HAVE_SETRESUID
1052 #define seteuid(x)      setresuid(-1,(x),-1)
1053 #ifndef HAVE_SETRESUID_DECL
1054 extern int setresuid P((uid_t ruid, uid_t euid, uid_t suid));
1055 #endif
1056 #else
1057 #ifndef HAVE_SETEUID_DECL
1058 extern int seteuid P((uid_t euid));
1059 #endif
1060 #endif
1061
1062 #ifndef HAVE_SETPGID_DECL
1063 #ifdef HAVE_SETPGID
1064 extern int setpgid P((int pid, int pgid));
1065 #endif
1066 #endif
1067
1068 #ifndef HAVE_SETPGRP_DECL
1069 #ifdef SETPGRP_VOID
1070 extern pid_t setpgrp P((void));
1071 #else
1072 extern pid_t setpgrp P((int pgrp, int pid));
1073 #endif
1074 #endif
1075
1076 #ifndef HAVE_SETSOCKOPT_DECL
1077 extern int setsockopt P((int s, int level, int optname,
1078                          const char *optval, int optlen));
1079 #endif
1080
1081 #ifdef HAVE_SHMGET
1082 #ifndef HAVE_SHMAT_DECL
1083 extern void *shmat P((int shmid, const SHM_ARG_TYPE *shmaddr, int shmflg));
1084 #endif
1085
1086 #ifndef HAVE_SHMCTL_DECL
1087 extern int shmctl P((int shmid, int cmd, struct shmid_ds *buf));
1088 #endif
1089
1090 #ifndef HAVE_SHMDT_DECL
1091 extern int shmdt P((SHM_ARG_TYPE *shaddr));
1092 #endif
1093
1094 #ifndef HAVE_SHMGET_DECL
1095 extern int shmget P((key_t key, size_t size, int shmflg));
1096 #endif
1097 #endif
1098
1099 #if defined(HAVE_SNPRINTF) && defined(HAVE_VSNPRINTF)
1100 #define ap_snprintf     snprintf
1101 #define ap_vsnprintf    vsnprintf
1102 #endif
1103 #ifndef HAVE_SNPRINTF_DECL
1104 #include "arglist.h"
1105 int ap_snprintf  P((char *buf, size_t len, const char *format,...))
1106                     __attribute__((format(printf,3,4)));
1107 #endif
1108 #ifndef HAVE_VSNPRINTF_DECL
1109 #include "arglist.h"
1110 int ap_vsnprintf P((char *buf, size_t len, const char *format, va_list ap));
1111 #endif
1112
1113 #ifndef HAVE_SOCKET_DECL
1114 extern int socket P((int domain, int type, int protocol));
1115 #endif
1116
1117 #ifndef HAVE_SOCKETPAIR_DECL
1118 extern int socketpair P((int domain, int type, int protocol, int sv[2]));
1119 #endif
1120
1121 #ifndef HAVE_SSCANF_DECL
1122 extern int sscanf P((const char *s, const char *format, ...));
1123 #endif
1124
1125 #ifndef HAVE_STRCASECMP_DECL
1126 extern int strcasecmp P((const char *s1, const char *s2));
1127 #endif
1128
1129 #ifndef HAVE_STRERROR_DECL
1130 extern char *strerror P((int errnum));
1131 #endif
1132
1133 #ifndef HAVE_STRFTIME_DECL
1134 extern size_t strftime P((char *s, size_t maxsize, const char *format,
1135                           const struct tm *timeptr));
1136 #endif
1137
1138 #ifndef HAVE_STRNCASECMP_DECL
1139 extern int strncasecmp P((const char *s1, const char *s2, int n));
1140 #endif
1141
1142 #ifndef HAVE_SYSLOG_DECL
1143 extern void syslog P((int priority, const char *logstring, ...))
1144     __attribute__ ((format (printf, 2, 3)));
1145 #endif
1146
1147 #ifndef HAVE_SYSTEM_DECL
1148 extern int system P((const char *string));
1149 #endif
1150
1151 #ifndef HAVE_TIME_DECL
1152 extern time_t time P((time_t *tloc));
1153 #endif
1154
1155 #ifndef HAVE_TOLOWER_DECL
1156 extern int tolower P((int c));
1157 #endif
1158
1159 #ifndef HAVE_TOUPPER_DECL
1160 extern int toupper P((int c));
1161 #endif
1162
1163 #ifndef HAVE_UNGETC_DECL
1164 extern int ungetc P((int c, FILE *stream));
1165 #endif
1166
1167 #ifndef HAVE_VFPRINTF_DECL
1168 #include "arglist.h"
1169 extern int vfprintf P((FILE *stream, const char *format, va_list ap));
1170 #endif
1171
1172 #ifndef HAVE_VPRINTF_DECL
1173 #include "arglist.h"
1174 extern int vprintf P((const char *format, va_list ap));
1175 #endif
1176
1177 #if !defined(S_ISCHR) && defined(_S_IFCHR) && defined(_S_IFMT)
1178 #define S_ISCHR(mode) (((mode) & _S_IFMT) == _S_IFCHR)
1179 #endif
1180
1181 #if !defined(S_ISREG) && defined(_S_IFREG) && defined(_S_IFMT)
1182 #define S_ISREG(mode) (((mode) & _S_IFMT) == _S_IFREG)
1183 #endif
1184
1185 #ifndef HAVE_WAITPID
1186 #ifdef HAVE_WAIT4
1187 #define waitpid(pid,status,options) wait4(pid,status,options,0)
1188 #else
1189 extern pid_t waitpid P((pid_t pid, amwait_t *stat_loc, int options));
1190 #endif
1191 #endif
1192
1193 #ifndef STDIN_FILENO
1194 #define STDIN_FILENO 0
1195 #endif
1196
1197 #ifndef STDOUT_FILENO
1198 #define STDOUT_FILENO 1
1199 #endif
1200
1201 #ifndef STDERR_FILENO
1202 #define STDERR_FILENO 2
1203 #endif
1204
1205 /* S_ISDIR is not defined on Nextstep */
1206 #ifndef S_ISDIR
1207 #if defined(_S_IFMT) && defined(_S_IFDIR)
1208 #define S_ISDIR(mode)   (((mode) & (_S_IFMT)) == (_S_IFDIR))
1209 #else
1210 error: Don t know how to define S_ISDIR
1211 #endif
1212 #endif
1213
1214 #endif  /* !AMANDA_H */