simple-cache.c 63 KB
Newer Older
Linus Tolke Y's avatar
Linus Tolke Y committed
1
/*
2
 * $Id: simple-cache.c,v 0.93 2001/11/04 21:03:47 ceder Exp $
Per Cederqvist's avatar
Per Cederqvist committed
3
 * Copyright (C) 1991-2000  Lysator Academic Computer Association.
Linus Tolke Y's avatar
Linus Tolke Y committed
4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24
 *
 * This file is part of the LysKOM server.
 * 
 * LysKOM 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 1, or (at your option) 
 * any later version.
 * 
 * LysKOM 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 LysKOM; see the file COPYING.  If not, write to
 * Lysator, c/o ISY, Linkoping University, S-581 83 Linkoping, SWEDEN,
 * or the Free Software Foundation, Inc., 675 Mass Ave, Cambridge, 
 * MA 02139, USA.
 *
 * Please mail bug reports to bug-lyskom@lysator.liu.se. 
 */
Per Cederqvist's avatar
Per Cederqvist committed
25 26 27 28 29 30 31 32 33
/*
 * This module contains some simple simulations of the routines in
 * cache.c.
 *
 * Extracted from ram-cache.c and rewritten by ceder.
 *
 * New database format with texts in their own file by Inge Wallin.
 *
 * New save algorithm by ceder.
David Byers's avatar
David Byers committed
34
 * Attempt at newer algorithm by byers (FASTSAVE)
Per Cederqvist's avatar
Per Cederqvist committed
35 36
 */

David Byers's avatar
David Byers committed
37 38 39 40 41

#ifdef HAVE_CONFIG_H
#  include <config.h>
#endif

Per Cederqvist's avatar
Per Cederqvist committed
42 43
#include <errno.h>
#include <stdio.h>
David Byers's avatar
Server:  
David Byers committed
44 45 46
#ifdef HAVE_STDLIB_H
#   include <stdlib.h>
#endif
Per Cederqvist's avatar
Per Cederqvist committed
47
#include <sys/types.h>
48 49 50
#ifdef HAVE_UNISTD_H
#   include <unistd.h>
#endif
51 52 53
#ifdef HAVE_STRING_H
#  include <string.h>
#endif
Per Cederqvist's avatar
Per Cederqvist committed
54 55 56 57
#ifndef SEEK_END
#  include <fcntl.h>
#endif
#ifndef SEEK_END
Per Cederqvist's avatar
Per Cederqvist committed
58 59 60
#  define SEEK_SET 0
#  define SEEK_END 2
#endif
Per Cederqvist's avatar
Per Cederqvist committed
61 62 63
#include <time.h>
#include <setjmp.h>

64
#include "ldifftime.h"
Per Cederqvist's avatar
Per Cederqvist committed
65 66
#include "exp.h"
#include "misc-types.h"
67
#include "s-string.h"
Per Cederqvist's avatar
Per Cederqvist committed
68 69 70 71 72 73 74 75 76 77 78 79 80
#include "kom-types.h"
#include "cache-node.h"
#include "cache.h"
#include "parser.h"
#include "ram-parse.h"
#include "ram-output.h"
#include "server/smalloc.h"
#include "kom-memory.h"
#include "lyskomd.h"
#include "debug.h"
#include "kom-errno.h"
#include "log.h"
#include "com.h"
81
#include "async.h"
Per Cederqvist's avatar
Per Cederqvist committed
82 83
#include "connections.h"
#include "send-async.h"
84
#include "param.h"
David Byers's avatar
David Byers committed
85
#include "kom-config.h"
David Byers's avatar
David Byers committed
86
#include "admin.h"
87
#include "unused.h"
88
#include "local-to-global.h"
89
#include "server-time.h"
Per Cederqvist's avatar
Per Cederqvist committed
90 91

/*
92
 * Possible improvements:
Per Cederqvist's avatar
Per Cederqvist committed
93
 *
94 95 96
 *  FIXME (bug 167): When there are consecutive items in file A that
 *  shall be copied to file B, copy them in one transfer (up to a
 *  certain limit).
Per Cederqvist's avatar
Per Cederqvist committed
97 98 99 100 101 102 103
 */

/*
 * All functions that can fail sets kom_errno to a suitable value
 * if they fail.
 */

David Byers's avatar
David Byers committed
104
static Small_conf      ** small_conf_arr;
105 106
static Cache_node_mcb	* pers_mcb;
static Cache_node_mcb 	* conf_mcb;
107
static Conf_no		  next_free_num = 1;
Per Cederqvist's avatar
Per Cederqvist committed
108

109
static Cache_node_mcb 	* text_mcb;
110
static Text_no		  next_text_num = 1;
Per Cederqvist's avatar
Per Cederqvist committed
111 112 113 114 115 116 117 118 119 120 121

/*
 * The elements in the following lists with same index refers to the same
 * conference.
 */
static int    no_of_match_info;
EXPORT Matching_info *match_table = NULL;

static FILE	*text_file= NULL;
static FILE	*file_a = NULL;	/* Current file. */
static FILE	*file_b = NULL;	/* File under construction. */
David Byers's avatar
David Byers committed
122 123 124
#ifdef FASTSAVE
static FILE     *file_b_r = NULL; /* Read from file under construction */
#endif
Per Cederqvist's avatar
Per Cederqvist committed
125 126 127 128 129

/*
 * Four state variables for the background save.
 */
static enum {
130
    sync_idle,
Per Cederqvist's avatar
Per Cederqvist committed
131 132 133 134 135 136 137 138
    sync_save_conf,
    sync_save_pers,
    sync_save_text,
    sync_error,
    sync_wait,
    sync_ready
} sync_state;

139 140 141 142 143 144 145 146 147 148 149 150 151 152 153
/* The state machine sync_state works like this:
 *
 *  Old state              action           new state
 *  none               sync_part called     sync_idle
 *                     for the first time
 *  sync_idle	       SYNC_INTERVAL        sync_save_conf
 *  sync_save_conf     all confs saved      sync_save_pers
 *  sync_save_pers     all persons saved    sync_save_text
 *  sync_save_text     all texts saved      sync_ready
 *  sync_ready         sync_part called     sync_idle
 *  any                error occurs         sync_error
 *  sync_error         sync_part called     sync_wait
 *  sync_wait          SYNC_RETRY_INTERVAL  sync_save_conf
 */

David Byers's avatar
David Byers committed
154
#ifndef FASTSAVE
155 156 157 158 159
/* sync_next should be split in next_text_to_sync and
   next_conf_to_sync to avoid warnings about the different sizes of
   Conf_no and Text_no.  Since that is indeed done if FASTSAVE is set,
   don't bother doing it in the old code that will anyhow soon be
   replaced. */
160
static unsigned long sync_next;
David Byers's avatar
David Byers committed
161
#endif
Per Cederqvist's avatar
Per Cederqvist committed
162 163 164 165 166 167

static Conf_no highest_conf_no;
static Text_no highest_text_no;

BUGDECL;

168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207
/* Define LOGACCESSES if you want to be able to log all accesses to
   the data base. */

#ifdef LOGACCESSES
typedef enum {
    lt_restart,
    lt_text_stat,
    lt_text_mass,
    lt_conf_stat,
    lt_pers_stat,
    
    lt_text_def,
    lt_conf_def,
    lt_pers_def,

    lt_create_text,
    lt_garb_text,
    lt_delete_text,
    lt_create_conf,
    lt_delete_conf,
    lt_create_pers,
    lt_delete_pers,

    lt_lock_conf,
    lt_unlock_conf,
    lt_lock_pers,
    lt_unlock_pers,

    lt_get_highest,		/* Get highest Local_text_no for a conf. */
    lt_get_conf_type
    /* Note: mark_*_as_changed is not logged. */
} Log_type;

static FILE *logfile = NULL;
static int syncing_or_saving = 0;
static int garb_running = 0;

static void log_access(Log_type t,
		       int id)
{
208 209
    extern int putw(int, FILE *);

210 211 212 213 214 215 216 217 218 219 220
    if (garb_running + syncing_or_saving == 0)
    {
	putc(t, logfile);
	putw(id, logfile);
    }
}
#define LOGACC(a,b) {if (logfile) log_access(a, b);}
#else
#define LOGACC(a,b)
#endif

David Byers's avatar
Server:  
David Byers committed
221 222 223 224 225 226 227 228 229

/* Local functions */

static Success build_matching_info(void);
static Success rebuild_matching_info_entry(Conf_no conf_no);
static Matching_info *find_matching_info(Conf_no conf_no);



Per Cederqvist's avatar
Per Cederqvist committed
230 231 232 233 234 235 236 237 238 239 240

/* Macros */

#define TRACE2(format, arg) if ( buglevel > 2 ) printf(format, arg)
#define TRACE1(format) if ( buglevel > 2 ) printf(format)
#define TRACESTR(str)  if ( buglevel > 2 ) s_puts(str)


static Person *
read_person(FILE *fp,
	    long pos,
241
	    long UNUSED(size))	/* FIXME (bug 168): sanity-check the size */
Per Cederqvist's avatar
Per Cederqvist committed
242 243
{
    Person *p;
David Byers's avatar
David Byers committed
244
    long dummy;
Per Cederqvist's avatar
Per Cederqvist committed
245 246

    p = alloc_person();
247
    fseek(fp, pos+1, SEEK_SET);	/* Skip 'P' */
David Byers's avatar
David Byers committed
248
    dummy = fparse_long(fp);
Per Cederqvist's avatar
Per Cederqvist committed
249 250 251 252 253 254 255 256 257 258 259 260 261 262
    if ( fparse_person(fp, p) != OK )
    {
	free_person(p);
	return NULL;
    }
    else
	return p;
}



static Conference *
read_conference(FILE *fp,
		long pos,
263
		long UNUSED(size)) /* FIXME (bug 169): sanity-check the size */
Per Cederqvist's avatar
Per Cederqvist committed
264 265
{
    Conference *c;
David Byers's avatar
David Byers committed
266
    long dummy;
Per Cederqvist's avatar
Per Cederqvist committed
267 268

    c = alloc_conference();
269
    fseek(fp, pos+1, SEEK_SET);	/* Skip 'C' */
David Byers's avatar
David Byers committed
270
    dummy = fparse_long(fp);
Per Cederqvist's avatar
Per Cederqvist committed
271 272 273 274 275 276 277 278 279 280 281 282 283
    if ( fparse_conference(fp, c) != OK )
    {
	free_conference(c);
	return NULL;
    }
    else
	return c;
}
	

static Text_stat *
read_text_stat(FILE *fp,
	       long pos,
284
	       long UNUSED(size)) /* FIXME (bug 170): sanity-check the size */
Per Cederqvist's avatar
Per Cederqvist committed
285 286
{
    Text_stat *t;
David Byers's avatar
David Byers committed
287
    long dummy;
Per Cederqvist's avatar
Per Cederqvist committed
288 289

    t = alloc_text_stat();
290
    fseek(fp, pos+1, SEEK_SET);	/* Skip 'T' */
David Byers's avatar
David Byers committed
291
    dummy = fparse_long(fp);
Per Cederqvist's avatar
Per Cederqvist committed
292 293 294 295 296 297 298 299 300 301
    if ( fparse_text_stat(fp, t) != OK )
    {
	free_text_stat(t);
	return NULL;
    }
    else
	return t;
}

static void
302
pers_set_mru(Pers_no pers_no)
Per Cederqvist's avatar
Per Cederqvist committed
303
{
304
    set_mru(pers_mcb, pers_no);
Per Cederqvist's avatar
Per Cederqvist committed
305 306 307
}

static void
308
text_set_mru(Text_no text_no)
Per Cederqvist's avatar
Per Cederqvist committed
309
{
310
    set_mru(text_mcb, text_no);
Per Cederqvist's avatar
Per Cederqvist committed
311 312 313
}

static void
314
conf_set_mru(Conf_no conf_no)
Per Cederqvist's avatar
Per Cederqvist committed
315
{
316 317
    set_mru(conf_mcb, conf_no);
}
Per Cederqvist's avatar
Per Cederqvist committed
318

319 320 321
static Cache_node *
get_pers_node(Pers_no pers_no)
{
322
    if (pers_no >= next_free_num || pers_no < 1)
323 324
	return NULL;

325
    return get_cache_node(pers_mcb, pers_no);
Per Cederqvist's avatar
Per Cederqvist committed
326 327 328
}

static void
329
unlink_text_lru (Cache_node *node)
Per Cederqvist's avatar
Per Cederqvist committed
330
{
331
    unlink_lru (node, &text_mcb->lru, &text_mcb->mru);
Per Cederqvist's avatar
Per Cederqvist committed
332 333
}

334 335 336 337 338
static void
unlink_conf_lru (Cache_node *node)
{
    unlink_lru (node, &conf_mcb->lru, &conf_mcb->mru);
}
Per Cederqvist's avatar
Per Cederqvist committed
339 340

static void
341
unlink_pers_lru (Cache_node *node)
Per Cederqvist's avatar
Per Cederqvist committed
342
{
343 344
    unlink_lru (node, &pers_mcb->lru, &pers_mcb->mru);
}
Per Cederqvist's avatar
Per Cederqvist committed
345

346 347 348
static Cache_node *
get_conf_node(Conf_no conf_no)
{
349
    if (conf_no >= next_free_num || conf_no < 1)
350 351
	return NULL;

352 353
    return get_cache_node(conf_mcb, conf_no);
}
Per Cederqvist's avatar
Per Cederqvist committed
354

355 356 357
static Cache_node *
get_text_node(Text_no text_no)
{
358
    if (text_no >= next_text_num || text_no < 1)
359 360
	return NULL;

361
    return get_cache_node(text_mcb, text_no);
Per Cederqvist's avatar
Per Cederqvist committed
362 363 364 365 366 367 368 369 370 371 372 373 374 375 376 377
}

	
/*
 * Name caching routines
 */

/*
 * change_name changes the cached conference name. It is only called when
 * a conference name is changed or a conference is deleted.
 */
void
cached_change_name( Conf_no name_num,
		    String new_name )
{
    if ( name_num < 1 || name_num >= next_free_num )
378
	restart_kom("cached_change_name(%d, ----): next_free_num==%d\n",
Per Cederqvist's avatar
Per Cederqvist committed
379 380 381 382
		    name_num, next_free_num);

    s_clear( &small_conf_arr[name_num]->name );
    s_strcpy( &small_conf_arr[name_num]->name, new_name);
David Byers's avatar
Server:  
David Byers committed
383
    rebuild_matching_info_entry(name_num);
Per Cederqvist's avatar
Per Cederqvist committed
384 385 386 387 388 389 390 391 392
}


extern Conf_type
cached_get_conf_type (Conf_no conf_no)
{
    if ( conf_no < 1 || conf_no >= next_free_num )
	restart_kom("cached_get_conf_type(%d): next_free_num==%d",
		    conf_no, next_free_num);
393 394 395 396 397

    if ( small_conf_arr [ conf_no ] == NULL )
	restart_kom("cached_get_conf_type(%d): conference does not exist.\n",
		    conf_no);

398 399
    LOGACC(lt_get_conf_type, conf_no);

Per Cederqvist's avatar
Per Cederqvist committed
400 401 402
    return small_conf_arr [ conf_no ]->type;
}

403 404 405 406 407 408 409 410 411 412 413 414 415 416 417 418
extern Conf_no
cached_get_conf_supervisor(Conf_no conf_no)
{
    if (conf_no < 1 || conf_no >= next_free_num)
	restart_kom("cached_get_conf_supervisor(%d): next_free_num==%d\n",
		    conf_no, next_free_num);

    if (small_conf_arr[conf_no] == NULL)
	restart_kom("cached_get_conf_supervisor(%d):"
		    " conference does not exist.\n", conf_no);

    LOGACC(lt_get_conf_supervisor, conf_no);

    return small_conf_arr[conf_no]->supervisor;
}

419 420 421 422 423 424 425 426
/*
 * Return number of conferences present.  (Actually, return a number
 * at least as large as the number of conferences present).
 */
extern Conf_no
cached_no_of_existing_conferences(void)
{
    return next_free_num;	/* This is too large, but who cares? */
427 428 429 430
    /* Actually, this is used in lookup_regexp (and maybe other
       places) to allocate an array this large, and that is pretty
       stupid if many conferences have been deleted.  But it is no big
       deal.  Not yet, anyhow...  */
431
    /* FIXME (bug 164): We should return a better estimate. */
432
}
Per Cederqvist's avatar
Per Cederqvist committed
433 434 435 436 437 438 439 440

/*
 * Various function calls to tell the cache that something is changed.
 */

void
mark_person_as_changed(Pers_no	pers_no)
{
441 442 443 444
    Cache_node *node;

    node = get_pers_node(pers_no);
    
Per Cederqvist's avatar
Per Cederqvist committed
445
    TRACE2("Person %d is changed\n", pers_no);
446
    if ( node == NULL || node->s.exists == 0)
Per Cederqvist's avatar
Per Cederqvist committed
447 448
	restart_kom("mark_person_as_changed(%d): nonexistent.\n", pers_no);

449
    node->s.dirty = 1;
Per Cederqvist's avatar
Per Cederqvist committed
450 451 452
    pers_set_mru( pers_no );
}

453 454 455 456 457 458 459 460 461 462 463
/*
 * Mark the conference as dirty, so that it will be written to
 * the disk.
 *
 * Also update all fields in the Small_conf except then name, so that
 * they are always current.
 *
 * NOTE: You must call cached_change_name when the name changes.
 *       It is not necessary to call cached_change_name after
 *       cached_create_conf.
 */
Per Cederqvist's avatar
Per Cederqvist committed
464 465 466 467

void
mark_conference_as_changed(Conf_no	conf_no)
{
468
    Cache_node *node;
469
    Conference *conf_c;
470 471 472

    node = get_conf_node (conf_no);

Per Cederqvist's avatar
Per Cederqvist committed
473
    TRACE2("Conf.  %d is changed\n", conf_no);
474
    if ( node == NULL || node->s.exists == 0)
Per Cederqvist's avatar
Per Cederqvist committed
475 476
	restart_kom("mark_conference_as_changed(%d): nonexistent.\n", conf_no);

477
    node->s.dirty = 1;
Per Cederqvist's avatar
Per Cederqvist committed
478
    conf_set_mru( conf_no );
479 480 481

    conf_c = (Conference *) node->ptr;

482
    small_conf_arr[conf_no]->highest_local_no
483
	= l2g_first_appendable_key(&conf_c->texts) - 1;
484

485 486 487
    small_conf_arr[conf_no]->nice = conf_c->nice;
    small_conf_arr[conf_no]->type = conf_c->type;
    small_conf_arr[conf_no]->supervisor = conf_c->supervisor;
Per Cederqvist's avatar
Per Cederqvist committed
488 489 490 491 492
}

void
mark_text_as_changed( Text_no text_no )
{
493 494 495 496
    Cache_node *node;

    node = get_text_node (text_no);

497
    TRACE2("Text %lu is changed.\n", text_no);
Per Cederqvist's avatar
Per Cederqvist committed
498
    if ( text_no < 1 || text_no >= next_text_num
499
	|| node == NULL || node->s.exists == 0)
Per Cederqvist's avatar
Per Cederqvist committed
500
    {
501
	restart_kom("mark_text_as_changed(%lu): nonexistent.\n", text_no);
Per Cederqvist's avatar
Per Cederqvist committed
502 503
    }

504 505
    node->s.dirty = 1;
    text_set_mru (text_no);
Per Cederqvist's avatar
Per Cederqvist committed
506 507 508 509 510 511 512 513 514 515 516 517
}    



/*
 * Person-related calls
 */


extern Success
cached_create_person( Pers_no person )
{
518 519
    Cache_node *node;

Per Cederqvist's avatar
Per Cederqvist committed
520 521 522 523 524 525 526 527
    TRACE2("Person %d is being created.\n", person);

    if ( person < 1 || person >= next_free_num )
    {
	restart_kom("cached_create_person(%d): next_free_num == %d.\n",
		    person, next_free_num);
    }

528
    if ( get_pers_node(person) != NULL )
Per Cederqvist's avatar
Per Cederqvist committed
529 530 531 532 533
    {
	restart_kom("cached_create_person(%d): Person existed.\n",
		    person);
    }

534 535 536 537 538
    create_cache_node (pers_mcb, person);
    node = get_pers_node (person);

    if ( node == NULL )
	restart_kom("cached_create_person(): couldn't get cache_node.\n");
539

540 541 542
    node->ptr = alloc_person();
    node->s.dirty = 1;
    node->s.exists = 1;
Per Cederqvist's avatar
Per Cederqvist committed
543
    pers_set_mru( person );
544 545 546

    LOGACC(lt_create_pers, person);

Per Cederqvist's avatar
Per Cederqvist committed
547 548 549 550 551 552 553
    return OK;
}


extern Person *
cached_get_person_stat( Pers_no	person )
{
554 555
    Cache_node *node;

Per Cederqvist's avatar
Per Cederqvist committed
556 557 558 559
    TRACE2("cached_get_person_stat %d\n", person);

    if ( person == 0 )
    {
560
        err_stat = 0;
Per Cederqvist's avatar
Per Cederqvist committed
561 562 563
	kom_errno = KOM_CONF_ZERO;
	return NULL;
    }
564

565 566
    if ( person >= next_free_num )
    {
567
        err_stat = person;
568 569 570 571
	kom_errno = KOM_UNDEF_PERS;
	return NULL;
    }

572 573
    node = get_pers_node (person);

574
    if ( node == NULL || node->s.exists == 0 )
Per Cederqvist's avatar
Per Cederqvist committed
575
    {
576
        err_stat = person;
Per Cederqvist's avatar
Per Cederqvist committed
577 578 579 580
	kom_errno = KOM_UNDEF_PERS;
	return NULL;
    }

581 582
    LOGACC(lt_pers_stat, person);

583
    if ( node->ptr != NULL )
Per Cederqvist's avatar
Per Cederqvist committed
584 585
    {
	pers_set_mru( person );
586
	++pers_mcb->hits;
587
	return node->ptr;
Per Cederqvist's avatar
Per Cederqvist committed
588 589
    }

590
    if ( node->snap_shot != NULL )
Per Cederqvist's avatar
Per Cederqvist committed
591
    {
592
	node->ptr = copy_person (node->snap_shot);
Per Cederqvist's avatar
Per Cederqvist committed
593
	pers_set_mru (person);
594
	++pers_mcb->hits;
595
	return node->ptr;
Per Cederqvist's avatar
Per Cederqvist committed
596 597
    }

598
    node->ptr = read_person(file_a, node->pos, node->size);
Per Cederqvist's avatar
Per Cederqvist committed
599

600
    ++pers_mcb->misses;
Per Cederqvist's avatar
Per Cederqvist committed
601
    pers_set_mru (person);
602
    return node->ptr;
Per Cederqvist's avatar
Per Cederqvist committed
603 604 605 606 607 608
}


/*
 * Conference-related calls
 */
609 610 611 612 613 614 615 616 617 618 619 620 621 622 623 624


static int no_of_allocated_small_confs = 0;

static void
free_small_conf (Small_conf *sc)
{
    if ( sc != NULL )
    {
	--no_of_allocated_small_confs;
	s_clear ( &sc->name );
	sfree (sc);
    }
}


625 626 627 628 629
static void
init_small_conf(Small_conf *sc)
{
    sc->name = EMPTY_STRING;
    init_conf_type(&sc->type);
630
    sc->supervisor = 0;
631 632 633 634
    sc->highest_local_no = 0;
    sc->nice = param.default_nice;
}

635 636 637 638 639
static Small_conf *
alloc_small_conf(void)
{
    Small_conf *s;
    s = smalloc(sizeof(Small_conf));
640
    init_small_conf(s);
641 642 643 644 645 646
    ++no_of_allocated_small_confs;

    return s;
}


647 648 649 650 651 652
/*
 * Create a conference.
 *
 * Set up a Conference and cache the name in the small_conf_array.
 */
extern Conf_no
Per Cederqvist's avatar
Per Cederqvist committed
653 654 655 656
cached_create_conf (String  name)
{
    Conference * conf_c;
    Conf_no	 conf_no;
657
    Cache_node  *node;
Per Cederqvist's avatar
Per Cederqvist committed
658 659 660 661 662

    TRACE1("cached_create_conf( ");
    TRACESTR(name);
    TRACE1(" )\n");

David Byers's avatar
David Byers committed
663
    if ( next_free_num >= param.max_conf )
Per Cederqvist's avatar
Per Cederqvist committed
664
    {
665
        err_stat = next_free_num;
Per Cederqvist's avatar
Per Cederqvist committed
666 667 668 669 670 671
	kom_errno = KOM_INDEX_OUT_OF_RANGE;
	return 0;
    }
    
    conf_no = next_free_num++;

672 673 674 675 676 677 678 679 680
    create_cache_node (conf_mcb, conf_no);
    node = get_conf_node (conf_no);

    if ( node == NULL )
	restart_kom("cached_create_conf(): failed to allocate cache_node.\n");
    
    node->s.exists = 1;
    node->s.dirty = 1;
    node->ptr = conf_c = alloc_conference();
Per Cederqvist's avatar
Per Cederqvist committed
681 682
    conf_set_mru(conf_no);    

683
    zero_init_cache_node (pers_mcb, conf_no);
Per Cederqvist's avatar
Per Cederqvist committed
684 685 686 687 688 689
    small_conf_arr[ conf_no ] = alloc_small_conf();

    conf_c->name = EMPTY_STRING;
    s_strcpy(&conf_c->name, name);
    cached_change_name( conf_no, name);

690
    TRACE2("Created conference number %d\n", conf_no);
691 692 693

    LOGACC(lt_create_conf, conf_no);

Per Cederqvist's avatar
Per Cederqvist committed
694 695 696 697 698 699 700
    return conf_no;
}


extern Success
cached_delete_conf( Conf_no	conf )
{
701 702
    Cache_node *node;

Per Cederqvist's avatar
Per Cederqvist committed
703 704
    if ( conf == 0 )
    {
705
        err_stat = conf;
Per Cederqvist's avatar
Per Cederqvist committed
706 707 708
	kom_errno = KOM_CONF_ZERO;
	return FAILURE;
    }
709

710 711
    if ( conf >= next_free_num )
    {
712
        err_stat = conf;
713 714 715 716
	kom_errno = KOM_UNDEF_CONF;
	return FAILURE;
    }

717 718
    node = get_conf_node (conf);

719
    if ( node == NULL || node->s.exists == 0 )
Per Cederqvist's avatar
Per Cederqvist committed
720
    {
721
        err_stat = conf;
Per Cederqvist's avatar
Per Cederqvist committed
722 723 724 725
	kom_errno = KOM_UNDEF_CONF;
	return FAILURE;
    }

726
    if ( node->lock_cnt > 0 )
David Byers's avatar
David Byers committed
727
	kom_log("WNG: cached_delete_conf(%d): lock_cnt === %d\n",
728
	    conf, node->lock_cnt);
Per Cederqvist's avatar
Per Cederqvist committed
729

David Byers's avatar
David Byers committed
730 731 732
    free_small_conf(small_conf_arr[conf]);
    small_conf_arr[conf] = NULL;

733 734 735
    free_conference(node->ptr);
    node->ptr = NULL;
    node->s.exists = 0;
Per Cederqvist's avatar
Per Cederqvist committed
736

737 738
    LOGACC(lt_delete_conf, conf);

David Byers's avatar
Server:  
David Byers committed
739
    rebuild_matching_info_entry(conf);
Per Cederqvist's avatar
Per Cederqvist committed
740 741 742 743 744 745
    return OK;
}

Success
cached_delete_person(Pers_no pers)
{
746 747
    Cache_node *node;

Per Cederqvist's avatar
Per Cederqvist committed
748 749
    if ( pers == 0 )
    {
750
        err_stat = pers;
Per Cederqvist's avatar
Per Cederqvist committed
751 752 753
	kom_errno = KOM_CONF_ZERO;
	return FAILURE;
    }
754

755 756
    if ( pers >= next_free_num )
    {
David Byers's avatar
David Byers committed
757
	kom_log("cached_delete_person(%lu): next_free_num == %lu\n",
Per Cederqvist's avatar
Per Cederqvist committed
758
	    (unsigned long)pers, (unsigned long)next_free_num);
759
        err_stat = pers;
760 761 762 763
	kom_errno = KOM_UNDEF_PERS;
	return FAILURE;
    }

764 765 766
    node = get_pers_node (pers);

    if ( pers >= next_free_num || node == NULL || node->s.exists == 0 )
Per Cederqvist's avatar
Per Cederqvist committed
767
    {
David Byers's avatar
David Byers committed
768
	kom_log("cached_delete_person(): attempt to delete void person.\n");
769
        err_stat = pers;
Per Cederqvist's avatar
Per Cederqvist committed
770 771 772 773
	kom_errno = KOM_UNDEF_PERS;
	return FAILURE;
    }

774
    if ( node->lock_cnt > 0 )
David Byers's avatar
David Byers committed
775
	kom_log("cached_delete_pers(%lu): lock_cnt === %lu\n",
Per Cederqvist's avatar
Per Cederqvist committed
776
	    (unsigned long)pers, (unsigned long)node->lock_cnt);
Per Cederqvist's avatar
Per Cederqvist committed
777

778 779
    LOGACC(lt_delete_pers, pers);

780 781 782
    free_person (node->ptr);
    node->ptr = NULL;
    node->s.exists = 0;
Per Cederqvist's avatar
Per Cederqvist committed
783 784 785 786 787 788
    return OK;
}

Success
cached_delete_text(Text_no text)
{
789 790
    Cache_node *node;

Per Cederqvist's avatar
Per Cederqvist committed
791 792
    if ( text == 0 )
    {
793
        err_stat = text;
Per Cederqvist's avatar
Per Cederqvist committed
794 795 796
	kom_errno = KOM_TEXT_ZERO;
	return FAILURE;
    }
797 798 799 800 801

    node = get_text_node (text);

    if ( text >= next_text_num || node == NULL
	|| node->s.exists == 0 )
Per Cederqvist's avatar
Per Cederqvist committed
802
    {
David Byers's avatar
David Byers committed
803
	kom_log("cached_delete_text(): attempt to delete void text %lu.\n", text);
804
        err_stat = text;
Per Cederqvist's avatar
Per Cederqvist committed
805 806 807 808
	kom_errno = KOM_NO_SUCH_TEXT;
	return FAILURE;
    }

809
    if ( node->lock_cnt > 0 )
David Byers's avatar
David Byers committed
810
	kom_log("cached_delete_text(%lu): lock_cnt === %d\n",
811
	    text, node->lock_cnt);
Per Cederqvist's avatar
Per Cederqvist committed
812 813


814 815 816
    free_text_stat(node->ptr);
    node->ptr = NULL;
    node->s.exists = 0;
Per Cederqvist's avatar
Per Cederqvist committed
817

818 819 820
#ifdef LOGACCESSES
    if (garb_running)
    {
821
	LOGACC(lt_garb_text, text);
822 823
    }
    else
824
	LOGACC(lt_delete_text, text);
825
#endif
Per Cederqvist's avatar
Per Cederqvist committed
826 827 828 829 830
    return OK;
}


extern Conference *
831
cached_get_conf_stat (Conf_no   conf_no)
Per Cederqvist's avatar
Per Cederqvist committed
832
{
833 834
    Cache_node *node;

Per Cederqvist's avatar
Per Cederqvist committed
835 836 837 838
    TRACE2("cached_get_conf_stat %d\n", conf_no);

    if ( conf_no == 0 )
    {
839
        err_stat = conf_no;
Per Cederqvist's avatar
Per Cederqvist committed
840 841 842
	kom_errno = KOM_CONF_ZERO;
	return NULL;
    }
843 844 845 846

    node = get_conf_node (conf_no);

    if ( conf_no >= next_free_num || node == NULL || node->s.exists == 0 )
Per Cederqvist's avatar
Per Cederqvist committed
847
    {
848
        err_stat = conf_no;
Per Cederqvist's avatar
Per Cederqvist committed
849 850 851 852
	kom_errno = KOM_UNDEF_CONF;
	return NULL;
    }

853 854
    LOGACC(lt_conf_stat, conf_no);

855
    if ( node->ptr != NULL )
Per Cederqvist's avatar
Per Cederqvist committed
856
    {
857
	conf_set_mru (conf_no);
858
	++conf_mcb->hits;
859
	return node->ptr;
Per Cederqvist's avatar
Per Cederqvist committed
860 861
    }

862
    if ( node->snap_shot != NULL )
Per Cederqvist's avatar
Per Cederqvist committed
863
    {
864
	node->ptr = copy_conference (node->snap_shot);
Per Cederqvist's avatar
Per Cederqvist committed
865
	conf_set_mru (conf_no);
866
	++conf_mcb->hits;
867
	return node->ptr;
Per Cederqvist's avatar
Per Cederqvist committed
868 869
    }

870
    node->ptr = read_conference(file_a, node->pos, node->size);
871
    ++conf_mcb->misses;
Per Cederqvist's avatar
Per Cederqvist committed
872 873

    conf_set_mru (conf_no);
874
    return node->ptr;
Per Cederqvist's avatar
Per Cederqvist committed
875 876 877 878 879 880 881 882
}

/*
 * Return TRUE if conf_no exists.
 */
Bool
cached_conf_exists(Conf_no conf_no)
{
883 884 885
    if (conf_no == 0 || conf_no >= next_free_num )
	return FALSE;

David Byers's avatar
David Byers committed
886
    return small_conf_arr[conf_no] != NULL ? TRUE : FALSE;
Per Cederqvist's avatar
Per Cederqvist committed
887 888 889 890 891 892 893 894
}

    
/*
 * Calls to handle texts
 */

/*
895
 * FIXME (bug 171): cached_get_text() should return Success.
Per Cederqvist's avatar
Per Cederqvist committed
896 897 898 899 900 901 902
 */
extern String
cached_get_text( Text_no text )
{
    String  the_string;
    Text_stat *t_stat;

903
    TRACE2("cached_get_text %lu\n", text);
Per Cederqvist's avatar
Per Cederqvist committed
904 905 906 907 908

    if ( (t_stat = cached_get_text_stat (text)) == NULL )
	return EMPTY_STRING;
    else
    {
909
	LOGACC(lt_text_mass, text);
Per Cederqvist's avatar
Per Cederqvist committed
910 911 912 913 914
	the_string.string = tmp_alloc( t_stat->no_of_chars );
	the_string.len = t_stat->no_of_chars;
	fseek(text_file, t_stat->file_pos, SEEK_SET);

	if ( fread(the_string.string, sizeof(char), the_string.len, text_file)
David Byers's avatar
David Byers committed
915
	    != (size_t)the_string.len )
Per Cederqvist's avatar
Per Cederqvist committed
916
	{
David Byers's avatar
David Byers committed
917
	    kom_log("WARNING: cached_get_text: premature end on text %lu\n",
Per Cederqvist's avatar
Per Cederqvist committed
918 919 920 921 922 923 924 925 926 927 928 929
		text);
	    return EMPTY_STRING;
	}
		    
	return the_string;
    }
}


extern Text_stat *	/* NULL on error */
cached_get_text_stat(	Text_no		text )
{
930 931
    Cache_node *node;

932
    TRACE2("cached_get_text_stat(%lu);  next_text_num == ", text);
933
    TRACE2("%lu\n", (unsigned long)next_text_num);
Per Cederqvist's avatar
Per Cederqvist committed
934 935 936

    if ( text == 0 )
    {
937
        err_stat = text;
Per Cederqvist's avatar
Per Cederqvist committed
938 939 940
	kom_errno = KOM_TEXT_ZERO;
	return NULL;
    }
941 942 943 944

    node = get_text_node (text);

    if ( text >= next_text_num || node == NULL || node->s.exists == 0 )
Per Cederqvist's avatar
Per Cederqvist committed
945 946
    {
	TRACE1("cached_get_text_stat: no such text.\n");
947
        err_stat = text;
Per Cederqvist's avatar
Per Cederqvist committed
948 949 950 951
	kom_errno = KOM_NO_SUCH_TEXT;
	return NULL;
    }

952 953
    LOGACC(lt_text_stat, text);

954
    if ( node->ptr != NULL )
Per Cederqvist's avatar
Per Cederqvist committed
955 956 957
    {
	TRACE1("Found in ptr.\n");
	text_set_mru( text );
958
	++text_mcb->hits;
959
	return node->ptr;
Per Cederqvist's avatar
Per Cederqvist committed
960 961
    }

962
    if ( node->snap_shot != NULL )
Per Cederqvist's avatar
Per Cederqvist committed
963 964
    {
	TRACE1("Found in snap_shot\n");
965
	node->ptr = copy_text_stat(node->snap_shot);
Per Cederqvist's avatar
Per Cederqvist committed
966
	text_set_mru (text);
967
	++text_mcb->hits;
968
	return node->ptr;
Per Cederqvist's avatar
Per Cederqvist committed
969 970 971
    }

    TRACE1("Found in file A.\n");
972
    node->ptr = read_text_stat(file_a, node->pos, node->size);
Per Cederqvist's avatar
Per Cederqvist committed
973 974

    text_set_mru (text);
975
    ++text_mcb->misses;
976
    return node->ptr;
Per Cederqvist's avatar
Per Cederqvist committed
977 978 979 980 981 982
}



/*
 * The text is set up with an empty misc-field. The misc field is
983
 * then initialized by create_text.
Per Cederqvist's avatar
Per Cederqvist committed
984 985 986
 */

extern Text_no
987
cached_create_text(const String message)
Per Cederqvist's avatar
Per Cederqvist committed
988 989
{
    Text_no tno;
990
    Cache_node *node;
991
    long file_pos;
Per Cederqvist's avatar
Per Cederqvist committed
992 993 994

    tno = next_text_num++;

995
    TRACE2("cached_create_text (len=%lu)\n", message.len);
Per Cederqvist's avatar
Per Cederqvist committed
996

David Byers's avatar
David Byers committed
997
    if ( tno >= param.max_text )
Per Cederqvist's avatar
Per Cederqvist committed
998
    {