apps/silcd/server_util.h

   1 /*
   2
   3   server_util.h
   4
   5   Author: Pekka Riikonen <priikone@silcnet.org>
   6
   7   Copyright (C) 1997 - 2001 Pekka Riikonen
   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; version 2 of the License.
  12
  13   This program is distributed in the hope that it will be useful,
  14   but WITHOUT ANY WARRANTY; without even the implied warranty of
  15   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  16   GNU General Public License for more details.
  17
  18 */
  19
  20 #ifndef SERVER_UTIL_H
  21 #define SERVER_UTIL_H
  22
  23 /* This function is used to remove all client entries by the server `entry'.
  24    This is called when the connection is lost to the server. In this case
  25    we must invalidate all the client entries owned by the server `entry'.
  26    If the `server_signoff' is TRUE then the SERVER_SIGNOFF notify is
  27    distributed to our local clients. */
  28 bool silc_server_remove_clients_by_server(SilcServer server,
  29                                           SilcServerEntry entry,
  30                                           bool server_signoff);
  31
  32 /* Updates the clients that are originated from the `from' to be originated
  33    from the `to'. If the `resolve_real_server' is TRUE then this will
  34    attempt to figure out which clients really are originated from the
  35    `from' and which are originated from a server that we have connection
  36    to, when we've acting as backup router. If it is FALSE the `to' will
  37    be the new source. This function also removes the clients that are
  38    *really* originated from `from' if `remove_from' is TRUE. These are
  39    clients that the `from' owns, and not just clients that are behind
  40    the `from'. */
  41 void silc_server_update_clients_by_server(SilcServer server,
  42                                           SilcServerEntry from,
  43                                           SilcServerEntry to,
  44                                           bool resolve_real_server,
  45                                           bool remove_from);
  46
  47 /* Updates servers that are from `from' to be originated from `to'.  This
  48    will also update the server's connection to `to's connection. */
  49 void silc_server_update_servers_by_server(SilcServer server,
  50                                           SilcServerEntry from,
  51                                           SilcServerEntry to);
  52
  53 /* Removes channels that are from `from. */
  54 void silc_server_remove_channels_by_server(SilcServer server,
  55                                            SilcServerEntry from);
  56
  57 /* Updates channels that are from `from' to be originated from `to'.  */
  58 void silc_server_update_channels_by_server(SilcServer server,
  59                                            SilcServerEntry from,
  60                                            SilcServerEntry to);
  61
  62 /* Checks whether given channel has global users.  If it does this returns
  63    TRUE and FALSE if there is only locally connected clients on the channel. */
  64 bool silc_server_channel_has_global(SilcChannelEntry channel);
  65
  66 /* Checks whether given channel has locally connected users.  If it does this
  67    returns TRUE and FALSE if there is not one locally connected client. */
  68 bool silc_server_channel_has_local(SilcChannelEntry channel);
  69
  70 /* Returns TRUE if the given client is on the channel.  FALSE if not.
  71    This works because we assure that the user list on the channel is
  72    always in up to date thus we can only check the channel list from
  73    `client' which is faster than checking the user list from `channel'. */
  74 bool silc_server_client_on_channel(SilcClientEntry client,
  75                                    SilcChannelEntry channel);
  76
  77 /* Checks string for bad characters and returns TRUE if they are found. */
  78 bool silc_server_name_bad_chars(const char *name, SilcUInt32 name_len);
  79
  80 /* Modifies the `nick' if it includes bad characters and returns new
  81    allocated nickname that does not include bad characters. */
  82 char *silc_server_name_modify_bad(const char *name, SilcUInt32 name_len);
  83
  84 /* Find number of sockets by IP address indicated by `ip'. Returns 0 if
  85    socket connections with the IP address does not exist. */
  86 SilcUInt32 silc_server_num_sockets_by_ip(SilcServer server, const char *ip);
  87
  88 #endif /* SERVER_UTIL_H */