include/motd.h

   1 #ifndef INCLUDED_motd_h
   2 #define INCLUDED_motd_h
   3 /*
   4  * IRC - Internet Relay Chat, include/motd.h
   5  * Copyright (C) 1990 Jarkko Oikarinen and
   6  *                    University of Oulu, Computing Center
   7  * Copyright (C) 2000 Kevin L. Mitchell <klmitch@mit.edu>
   8  *
   9  * This program is free software; you can redistribute it and/or modify
  10  * it under the terms of the GNU General Public License as published by
  11  * the Free Software Foundation; either version 2, or (at your option)
  12  * any later version.
  13  *
  14  * This program is distributed in the hope that it will be useful,
  15  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  16  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  17  * GNU General Public License for more details.
  18  *
  19  * You should have received a copy of the GNU General Public License
  20  * along with this program; if not, write to the Free Software
  21  * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  22  *
  23  * $Id$
  24  */
  25 #ifndef INCLUDED_time_h
  26 #include <time.h>               /* struct tm */
  27 #define INCLUDED_time_h
  28 #endif
  29 #ifndef INCLUDED_sys_types_h
  30 #include <sys/types.h>
  31 #define INCLUDED_sys_types_h
  32 #endif
  33
  34
  35 struct Client;
  36 struct TRecord;
  37
  38 struct Motd {
  39   struct Motd*          next;
  40   int                   type;
  41   /* Used for classname if it is a class. */
  42   char*         hostmask;
  43   char*                 path;
  44   int                   maxcount;
  45   struct MotdCache*     cache;
  46 };
  47
  48 #define MOTD_UNIVERSAL  0       /* MOTD selected by no criteria */
  49 #define MOTD_HOSTMASK   1       /* MOTD selected by hostmask */
  50 #define MOTD_CLASS      2       /* MOTD selected by connection class */
  51
  52 #define MOTD_LINESIZE   81      /* 80 chars + '\0' */
  53 #define MOTD_MAXLINES   100
  54 #define MOTD_MAXREMOTE  3
  55
  56 struct MotdCache {
  57   struct MotdCache*     next; /* these fields let us read MOTDs only once */
  58   struct MotdCache**    prev_p;
  59   int                   ref;
  60   char*                 path;
  61   int                   maxcount;
  62   struct tm             modtime;
  63   int                   count;
  64   char                  motd[1][MOTD_LINESIZE];
  65 };
  66
  67 /* motd_send sends a MOTD off to a user */
  68 int motd_send(struct Client* cptr);
  69
  70 /* motd_signon sends a MOTD off to a newly-registered user */
  71 void motd_signon(struct Client* cptr);
  72
  73 /* motd_recache causes all the MOTD caches to be cleared */
  74 void motd_recache(void);
  75
  76 /* motd_init initializes the MOTD routines, including reading the
  77  * ircd.motd and remote.motd files into cache
  78  */
  79 void motd_init(void);
  80
  81 /* This routine adds a MOTD */
  82 void motd_add(const char *hostmask, const char *path);
  83
  84 /* This routine clears the list of MOTDs */
  85 void motd_clear(void);
  86
  87 /* This is called to report T-lines */
  88 void motd_report(struct Client *to);
  89
  90 #endif /* INCLUDED_motd_h */