mem.c 38.1 KB
Newer Older
Bob Halley's avatar
base  
Bob Halley committed
1
/*
Brian Wellington's avatar
Brian Wellington committed
2
 * Copyright (C) 1997-2001  Internet Software Consortium.
3
 *
Bob Halley's avatar
base  
Bob Halley committed
4 5 6
 * Permission to use, copy, modify, and distribute this software for any
 * purpose with or without fee is hereby granted, provided that the above
 * copyright notice and this permission notice appear in all copies.
7
 *
8 9 10 11 12 13 14 15
 * THE SOFTWARE IS PROVIDED "AS IS" AND INTERNET SOFTWARE CONSORTIUM
 * DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL
 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL
 * INTERNET SOFTWARE CONSORTIUM BE LIABLE FOR ANY SPECIAL, DIRECT,
 * INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING
 * FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT,
 * NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION
 * WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
Bob Halley's avatar
base  
Bob Halley committed
16 17
 */

18
/* $Id: mem.c,v 1.82 2001/02/09 18:51:18 gson Exp $ */
David Lawrence's avatar
David Lawrence committed
19

Bob Halley's avatar
Bob Halley committed
20
#include <config.h>
Bob Halley's avatar
base  
Bob Halley committed
21 22 23

#include <stdio.h>
#include <stdlib.h>
Bob Halley's avatar
Bob Halley committed
24
#include <stddef.h>
Bob Halley's avatar
base  
Bob Halley committed
25

Michael Graff's avatar
Michael Graff committed
26 27
#include <limits.h>

Bob Halley's avatar
Bob Halley committed
28
#include <isc/mem.h>
29
#include <isc/msgs.h>
30
#include <isc/ondestroy.h>
31
#include <isc/string.h>
Bob Halley's avatar
Bob Halley committed
32

Bob Halley's avatar
update  
Bob Halley committed
33
#include <isc/mutex.h>
Michael Graff's avatar
Michael Graff committed
34
#include <isc/util.h>
Bob Halley's avatar
update  
Bob Halley committed
35

36
unsigned int isc_mem_debugging = 0;
37

38 39 40 41 42 43 44 45 46 47
/*
 * Define ISC_MEM_USE_INTERNAL_MALLOC=1 to use the internal malloc()
 * implementation in preference to the system one.  The internal malloc()
 * is very space-efficient, and quite fast on uniprocessor systems.  It
 * performs poorly on multiprocessor machines.
 */
#ifndef ISC_MEM_USE_INTERNAL_MALLOC
#define ISC_MEM_USE_INTERNAL_MALLOC 0
#endif

48 49 50 51 52 53
/*
 * Constants.
 */

#define DEF_MAX_SIZE		1100
#define DEF_MEM_TARGET		4096
54 55
#define ALIGNMENT_SIZE		8		/* must be a power of 2 */
#define NUM_BASIC_BLOCKS	64		/* must be > 1 */
56
#define TABLE_INCREMENT		1024
Michael Graff's avatar
Michael Graff committed
57
#define DEBUGLIST_COUNT		1024
58

Bob Halley's avatar
base  
Bob Halley committed
59 60 61
/*
 * Types.
 */
62
#if ISC_MEM_TRACKLINES
Michael Graff's avatar
Michael Graff committed
63 64 65 66 67 68 69 70
typedef struct debuglink debuglink_t;
struct debuglink {
	ISC_LINK(debuglink_t)	link;
	const void	       *ptr[DEBUGLIST_COUNT];
	const char	       *file[DEBUGLIST_COUNT];
	unsigned int		line[DEBUGLIST_COUNT];
	unsigned int		count;
};
Bob Halley's avatar
base  
Bob Halley committed
71

Michael Graff's avatar
Michael Graff committed
72 73 74 75 76 77
#define FLARG_PASS	, file, line
#define FLARG		, const char *file, int line
#else
#define FLARG_PASS
#define FLARG
#endif
78

Michael Graff's avatar
Michael Graff committed
79
typedef struct element element;
80 81 82
struct element {
	element *		next;
};
Bob Halley's avatar
base  
Bob Halley committed
83 84 85 86 87

typedef struct {
	/*
	 * This structure must be ALIGNMENT_SIZE bytes.
	 */
88 89 90 91
	union {
		size_t		size;
		char		bytes[ALIGNMENT_SIZE];
	} u;
Bob Halley's avatar
Bob Halley committed
92
} size_info;
Bob Halley's avatar
base  
Bob Halley committed
93 94

struct stats {
Bob Halley's avatar
Bob Halley committed
95 96
	unsigned long		gets;
	unsigned long		totalgets;
97
#if ISC_MEM_USE_INTERNAL_MALLOC
Bob Halley's avatar
Bob Halley committed
98 99
	unsigned long		blocks;
	unsigned long		freefrags;
100
#endif /* ISC_MEM_USE_INTERNAL_MALLOC */
Bob Halley's avatar
base  
Bob Halley committed
101 102
};

103 104
#define MEM_MAGIC		0x4D656d43U	/* MemC. */
#define VALID_CONTEXT(c)	((c) != NULL && (c)->magic == MEM_MAGIC)
Bob Halley's avatar
Bob Halley committed
105

106
struct isc_mem {
Bob Halley's avatar
Bob Halley committed
107
	unsigned int		magic;
108
	isc_ondestroy_t		ondestroy;
Bob Halley's avatar
Bob Halley committed
109
	isc_mutex_t		lock;
110 111 112
	isc_memalloc_t		memalloc;
	isc_memfree_t		memfree;
	void *			arg;
Bob Halley's avatar
base  
Bob Halley committed
113
	size_t			max_size;
114
	isc_boolean_t		checkfree;
Bob Halley's avatar
base  
Bob Halley committed
115
	struct stats *		stats;
116
	unsigned int		references;
117
	size_t			quota;
Bob Halley's avatar
Bob Halley committed
118
	size_t			total;
119
	size_t			inuse;
120 121 122 123 124
	size_t			hi_water;
	size_t			lo_water;
	isc_boolean_t		hi_called;
	isc_mem_water_t		water;
	void *			water_arg;
Michael Graff's avatar
Michael Graff committed
125
	ISC_LIST(isc_mempool_t)	pools;
126 127 128 129 130 131 132 133 134 135 136 137 138

#if ISC_MEM_USE_INTERNAL_MALLOC
	size_t			mem_target;
	element **		freelists;
	element *		basic_blocks;
	unsigned char **	basic_table;
	unsigned int		basic_table_count;
	unsigned int		basic_table_size;
	unsigned char *		lowest;
	unsigned char *		highest;
	isc_boolean_t		trysplit;
#endif /* ISC_MEM_USE_INTERNAL_MALLOC */

139
#if ISC_MEM_TRACKLINES
Michael Graff's avatar
Michael Graff committed
140 141
	ISC_LIST(debuglink_t)	debuglist;
#endif
Michael Graff's avatar
Michael Graff committed
142 143 144 145 146 147
};

#define MEMPOOL_MAGIC		0x4D454d70U	/* MEMp. */
#define VALID_MEMPOOL(c)	((c) != NULL && (c)->magic == MEMPOOL_MAGIC)

struct isc_mempool {
Michael Graff's avatar
Michael Graff committed
148
	/* always unlocked */
Michael Graff's avatar
Michael Graff committed
149
	unsigned int	magic;		/* magic number */
Michael Graff's avatar
Michael Graff committed
150
	isc_mutex_t    *lock;		/* optional lock */
Michael Graff's avatar
Michael Graff committed
151
	isc_mem_t      *mctx;		/* our memory context */
Michael Graff's avatar
Michael Graff committed
152 153 154
	/* locked via the memory context's lock */
	ISC_LINK(isc_mempool_t)	link;	/* next pool in this mem context */
	/* optionally locked from here down */
Michael Graff's avatar
Michael Graff committed
155 156 157 158 159 160 161 162 163
	element	       *items;		/* low water item list */
	size_t		size;		/* size of each item on this pool */
	unsigned int	maxalloc;	/* max number of items allowed */
	unsigned int	allocated;	/* # of items currently given out */
	unsigned int	freecount;	/* # of items on reserved list */
	unsigned int	freemax;	/* # of items allowed on free list */
	unsigned int	fillcount;	/* # of items to fetch on each fill */
	/* Stats only. */
	unsigned int	gets;		/* # of requests to this pool */
Michael Graff's avatar
Michael Graff committed
164
	/* Debugging only. */
165
#if ISC_MEMPOOL_NAMES
Michael Graff's avatar
Michael Graff committed
166 167
	char		name[16];	/* printed name in stats reports */
#endif
Bob Halley's avatar
base  
Bob Halley committed
168 169
};

170 171 172
/*
 * Private Inline-able.
 */
Bob Halley's avatar
base  
Bob Halley committed
173

174
#if ! ISC_MEM_TRACKLINES
Michael Graff's avatar
Michael Graff committed
175 176 177 178 179 180 181 182 183 184 185 186 187 188
#define ADD_TRACE(a, b, c, d, e)
#define DELETE_TRACE(a, b, c, d, e)
#else
#define ADD_TRACE(a, b, c, d, e)	add_trace_entry(a, b, c, d, e)
#define DELETE_TRACE(a, b, c, d, e)	delete_trace_entry(a, b, c, d, e)

#define MEM_TRACE	((isc_mem_debugging & ISC_MEM_DEBUGTRACE) != 0)
#define MEM_RECORD	((isc_mem_debugging & ISC_MEM_DEBUGRECORD) != 0)

/*
 * mctx must be locked.
 */
static inline void
add_trace_entry(isc_mem_t *mctx, const void *ptr, unsigned int size
Michael Graff's avatar
pasto  
Michael Graff committed
189
		FLARG)
Michael Graff's avatar
Michael Graff committed
190 191 192 193 194
{
	debuglink_t *dl;
	unsigned int i;

	if (MEM_TRACE)
195 196 197 198
		fprintf(stderr, isc_msgcat_get(isc_msgcat, ISC_MSGSET_MEM,
					       ISC_MSG_ADDTRACE,
					       "add %p size %u "
					       "file %s line %u mctx %p\n"),
199
			ptr, size, file, line, mctx);
Michael Graff's avatar
Michael Graff committed
200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246

	if (!MEM_RECORD)
		return;

	dl = ISC_LIST_HEAD(mctx->debuglist);
	while (dl != NULL) {
		if (dl->count == DEBUGLIST_COUNT)
			goto next;
		for (i = 0 ; i < DEBUGLIST_COUNT ; i++) {
			if (dl->ptr[i] == NULL) {
				dl->ptr[i] = ptr;
				dl->file[i] = file;
				dl->line[i] = line;
				dl->count++;
				return;
			}
		}
	next:
		dl = ISC_LIST_NEXT(dl, link);
	}

	dl = malloc(sizeof(debuglink_t));
	INSIST(dl != NULL);

	ISC_LINK_INIT(dl, link);
	for (i = 1 ; i < DEBUGLIST_COUNT ; i++) {
		dl->ptr[i] = NULL;
		dl->file[i] = NULL;
		dl->line[i] = 0;
	}

	dl->ptr[0] = ptr;
	dl->file[0] = file;
	dl->line[0] = line;
	dl->count = 1;

	ISC_LIST_PREPEND(mctx->debuglist, dl, link);
}

static inline void
delete_trace_entry(isc_mem_t *mctx, const void *ptr, unsigned int size,
		   const char *file, unsigned int line)
{
	debuglink_t *dl;
	unsigned int i;

	if (MEM_TRACE)
247 248 249 250
		fprintf(stderr, isc_msgcat_get(isc_msgcat, ISC_MSGSET_MEM,
					       ISC_MSG_DELTRACE,
					       "del %p size %u "
					       "file %s line %u mctx %p\n"),
251
			ptr, size, file, line, mctx);
Michael Graff's avatar
Michael Graff committed
252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284

	if (!MEM_RECORD)
		return;

	dl = ISC_LIST_HEAD(mctx->debuglist);
	while (dl != NULL) {
		for (i = 0 ; i < DEBUGLIST_COUNT ; i++) {
			if (dl->ptr[i] == ptr) {
				dl->ptr[i] = NULL;
				dl->file[i] = NULL;
				dl->line[i] = 0;

				INSIST(dl->count > 0);
				dl->count--;
				if (dl->count == 0) {
					ISC_LIST_UNLINK(mctx->debuglist,
							dl, link);
					free(dl);
				}
				return;
			}
		}
		dl = ISC_LIST_NEXT(dl, link);
	}

	/*
	 * If we get here, we didn't find the item on the list.  We're
	 * screwed.
	 */
	INSIST(dl != NULL);
}
#endif /* ISC_MEM_TRACKLINES */

285
#if ISC_MEM_USE_INTERNAL_MALLOC
286 287 288 289 290
static inline size_t
rmsize(size_t size) {
	/*
 	 * round down to ALIGNMENT_SIZE
	 */
291
	return (size & (~(ALIGNMENT_SIZE - 1)));
292 293
}

294
static inline size_t
Bob Halley's avatar
base  
Bob Halley committed
295 296
quantize(size_t size) {
	/*
297
	 * Round up the result in order to get a size big
Bob Halley's avatar
base  
Bob Halley committed
298 299 300
	 * enough to satisfy the request and be aligned on ALIGNMENT_SIZE
	 * byte boundaries.
	 */
301

302 303
	if (size == 0)
		return (ALIGNMENT_SIZE);
304
	return ((size + ALIGNMENT_SIZE - 1) & (~(ALIGNMENT_SIZE - 1)));
Bob Halley's avatar
base  
Bob Halley committed
305 306
}

David Lawrence's avatar
David Lawrence committed
307 308 309 310
static inline void
split(isc_mem_t *ctx, size_t size, size_t new_size) {
	unsigned char *ptr;
	size_t remaining_size;
Michael Graff's avatar
Michael Graff committed
311

David Lawrence's avatar
David Lawrence committed
312 313 314 315 316 317
	/*
	 * Unlink a frag of size 'size'.
	 */
	ptr = (unsigned char *)ctx->freelists[size];
	ctx->freelists[size] = ctx->freelists[size]->next;
	ctx->stats[size].freefrags--;
Michael Graff's avatar
Michael Graff committed
318

David Lawrence's avatar
David Lawrence committed
319 320 321 322 323 324
	/*
	 * Create a frag of size 'new_size' and link it in.
	 */
	((element *)ptr)->next = ctx->freelists[new_size];
	ctx->freelists[new_size] = (element *)ptr;
	ctx->stats[new_size].freefrags++;
Bob Halley's avatar
base  
Bob Halley committed
325

David Lawrence's avatar
David Lawrence committed
326 327 328 329 330 331 332 333
	/*
	 * Create a frag of size 'size - new_size' and link it in.
	 */
	remaining_size = size - new_size;
	ptr += new_size;
	((element *)ptr)->next = ctx->freelists[remaining_size];
	ctx->freelists[remaining_size] = (element *)ptr;
	ctx->stats[remaining_size].freefrags++;
334 335
}

David Lawrence's avatar
David Lawrence committed
336 337 338
static inline isc_boolean_t
try_split(isc_mem_t *ctx, size_t new_size) {
	size_t i, doubled_size;
339

David Lawrence's avatar
David Lawrence committed
340 341
	if (!ctx->trysplit)
		return (ISC_FALSE);
Michael Graff's avatar
Michael Graff committed
342

David Lawrence's avatar
David Lawrence committed
343 344 345 346 347 348 349 350 351 352 353 354
	/*
	 * Try splitting a frag that's at least twice as big as the size
	 * we want.
	 */
	doubled_size = new_size * 2;
	for (i = doubled_size;
	     i < ctx->max_size;
	     i += ALIGNMENT_SIZE) {
		if (ctx->freelists[i] != NULL) {
			split(ctx, i, new_size);
			return (ISC_TRUE);
		}
355 356
	}

357
	/*
David Lawrence's avatar
David Lawrence committed
358
	 * No luck.  Try splitting any frag bigger than the size we need.
359
	 */
David Lawrence's avatar
David Lawrence committed
360 361 362 363 364 365 366 367
	for (i = new_size + ALIGNMENT_SIZE;
	     i < doubled_size;
	     i += ALIGNMENT_SIZE) {
		if (ctx->freelists[i] != NULL) {
			split(ctx, i, new_size);
			return (ISC_TRUE);
		}
	}
368

David Lawrence's avatar
David Lawrence committed
369
	return (ISC_FALSE);
370 371
}

372
static inline isc_boolean_t
373
more_basic_blocks(isc_mem_t *ctx) {
374 375 376 377 378
	void *new;
	unsigned char *curr, *next;
	unsigned char *first, *last;
	unsigned char **table;
	unsigned int table_size;
Bob Halley's avatar
Bob Halley committed
379
	size_t increment;
380 381 382 383
	int i;

	/* Require: we hold the context lock. */

384 385 386
	/*
	 * Did we hit the quota for this context?
	 */
Bob Halley's avatar
Bob Halley committed
387 388
	increment = NUM_BASIC_BLOCKS * ctx->mem_target;
	if (ctx->quota != 0 && ctx->total + increment > ctx->quota)
389
		return (ISC_FALSE);
390 391 392

	INSIST(ctx->basic_table_count <= ctx->basic_table_size);
	if (ctx->basic_table_count == ctx->basic_table_size) {
393
		table_size = ctx->basic_table_size + TABLE_INCREMENT;
394 395
		table = (ctx->memalloc)(ctx->arg,
					table_size * sizeof (unsigned char *));
396
		if (table == NULL)
397
			return (ISC_FALSE);
398 399 400 401
		if (ctx->basic_table_size != 0) {
			memcpy(table, ctx->basic_table,
			       ctx->basic_table_size *
			       sizeof (unsigned char *));
402
			(ctx->memfree)(ctx->arg, ctx->basic_table);
403
		}
404 405
		ctx->basic_table = table;
		ctx->basic_table_size = table_size;
406
	}
407

408
	new = (ctx->memalloc)(ctx->arg, NUM_BASIC_BLOCKS * ctx->mem_target);
409
	if (new == NULL)
410
		return (ISC_FALSE);
Bob Halley's avatar
Bob Halley committed
411
	ctx->total += increment;
412 413
	ctx->basic_table[ctx->basic_table_count] = new;
	ctx->basic_table_count++;
414

415 416 417
	curr = new;
	next = curr + ctx->mem_target;
	for (i = 0; i < (NUM_BASIC_BLOCKS - 1); i++) {
418
		((element *)curr)->next = (element *)next;
419 420 421 422 423 424 425
		curr = next;
		next += ctx->mem_target;
	}
	/*
	 * curr is now pointing at the last block in the
	 * array.
	 */
Bob Halley's avatar
Bob Halley committed
426
	((element *)curr)->next = NULL;
427 428 429 430 431 432 433
	first = new;
	last = first + NUM_BASIC_BLOCKS * ctx->mem_target - 1;
	if (first < ctx->lowest || ctx->lowest == NULL)
		ctx->lowest = first;
	if (last > ctx->highest)
		ctx->highest = last;
	ctx->basic_blocks = new;
434 435

	return (ISC_TRUE);
436 437
}

438 439 440 441 442 443 444 445 446 447 448 449 450 451 452 453 454 455
static inline isc_boolean_t
more_frags(isc_mem_t *ctx, size_t new_size) {
	int i, frags;
	size_t total_size;
	void *new;
	unsigned char *curr, *next;

	/*
	 * Try to get more fragments by chopping up a basic block.
	 */

	if (ctx->basic_blocks == NULL) {
		if (!more_basic_blocks(ctx)) {
			/*
			 * We can't get more memory from the OS, or we've
			 * hit the quota for this context.
			 */
			/*
456
			 * XXXRTH  "At quota" notification here.
457 458 459 460 461 462 463 464 465 466 467 468 469 470 471 472 473 474 475 476 477
			 */
			/*
			 * Maybe we can split one of our existing
			 * list frags.
			 */
			return (try_split(ctx, new_size));
		}
	}

	total_size = ctx->mem_target;
	new = ctx->basic_blocks;
	ctx->basic_blocks = ctx->basic_blocks->next;
	frags = total_size / new_size;
	ctx->stats[new_size].blocks++;
	ctx->stats[new_size].freefrags += frags;
	/*
	 * Set up a linked-list of blocks of size
	 * "new_size".
	 */
	curr = new;
	next = curr + new_size;
478
	total_size -= new_size;
479 480 481 482
	for (i = 0; i < (frags - 1); i++) {
		((element *)curr)->next = (element *)next;
		curr = next;
		next += new_size;
483 484 485 486 487 488 489 490 491 492
		total_size -= new_size;
	}
	/*
	 * Add the remaining fragment of the basic block to a free list.
	 */
	total_size = rmsize(total_size);
	if (total_size > 0) {
		((element *)next)->next = ctx->freelists[total_size];
		ctx->freelists[total_size] = (element *)next;
		ctx->stats[total_size].freefrags++;
493 494 495 496 497 498 499 500 501 502 503
	}
	/*
	 * curr is now pointing at the last block in the
	 * array.
	 */
	((element *)curr)->next = NULL;
	ctx->freelists[new_size] = new;

	return (ISC_TRUE);
}

Michael Graff's avatar
Michael Graff committed
504
static inline void *
505
mem_getunlocked(isc_mem_t *ctx, size_t size) {
Michael Graff's avatar
Michael Graff committed
506 507
	size_t new_size = quantize(size);
	void *ret;
Bob Halley's avatar
base  
Bob Halley committed
508 509

	if (size >= ctx->max_size || new_size >= ctx->max_size) {
510 511 512
		/*
		 * memget() was called on something beyond our upper limit.
		 */
Bob Halley's avatar
Bob Halley committed
513 514 515 516
		if (ctx->quota != 0 && ctx->total + size > ctx->quota) {
			ret = NULL;
			goto done;
		}
Mark Andrews's avatar
Mark Andrews committed
517
		ret = (ctx->memalloc)(ctx->arg, size);
Bob Halley's avatar
base  
Bob Halley committed
518
		if (ret != NULL) {
Bob Halley's avatar
Bob Halley committed
519
			ctx->total += size;
520
			ctx->inuse += size;
Bob Halley's avatar
base  
Bob Halley committed
521 522
			ctx->stats[ctx->max_size].gets++;
			ctx->stats[ctx->max_size].totalgets++;
Mark Andrews's avatar
Mark Andrews committed
523 524 525 526 527 528
			/*
			 * If we don't set new_size to size, then the
			 * ISC_MEM_FILL code might write over bytes we
			 * don't own.
			 */
			new_size = size;
Bob Halley's avatar
base  
Bob Halley committed
529 530 531 532
		}
		goto done;
	}

533
	/*
Bob Halley's avatar
base  
Bob Halley committed
534 535 536 537
	 * If there are no blocks in the free list for this size, get a chunk
	 * of memory and then break it up into "new_size"-sized blocks, adding
	 * them to the free list.
	 */
538 539
	if (ctx->freelists[new_size] == NULL && !more_frags(ctx, new_size))
		return (NULL);
Bob Halley's avatar
base  
Bob Halley committed
540

541 542 543
	/*
	 * The free list uses the "rounded-up" size "new_size".
	 */
Bob Halley's avatar
base  
Bob Halley committed
544 545 546
	ret = ctx->freelists[new_size];
	ctx->freelists[new_size] = ctx->freelists[new_size]->next;

547
	/*
Bob Halley's avatar
base  
Bob Halley committed
548 549 550 551 552 553 554 555
	 * The stats[] uses the _actual_ "size" requested by the
	 * caller, with the caveat (in the code above) that "size" >= the
	 * max. size (max_size) ends up getting recorded as a call to
	 * max_size.
	 */
	ctx->stats[size].gets++;
	ctx->stats[size].totalgets++;
	ctx->stats[new_size].freefrags--;
556
	ctx->inuse += new_size;
Bob Halley's avatar
base  
Bob Halley committed
557 558 559

 done:

560
#if ISC_MEM_FILL
561 562
	if (ret != NULL)
		memset(ret, 0xbe, new_size); /* Mnemonic for "beef". */
David Lawrence's avatar
David Lawrence committed
563 564 565
#endif

	return (ret);
Michael Graff's avatar
Michael Graff committed
566 567
}

568 569 570 571 572 573 574 575 576 577 578 579 580 581 582
#if ISC_MEM_FILL && ISC_MEM_CHECKOVERRUN
static inline void
check_overrun(void *mem, size_t size, size_t new_size) {
	unsigned char *cp;

	cp = (unsigned char *)mem;
	cp += size;
	while (size < new_size) {
		INSIST(*cp == 0xbe);
		cp++;
		size++;
	}
}
#endif

Michael Graff's avatar
Michael Graff committed
583
static inline void
584
mem_putunlocked(isc_mem_t *ctx, void *mem, size_t size) {
Michael Graff's avatar
Michael Graff committed
585
	size_t new_size = quantize(size);
Bob Halley's avatar
base  
Bob Halley committed
586

587
	if (size == ctx->max_size || new_size >= ctx->max_size) {
588 589 590
		/*
		 * memput() called on something beyond our upper limit.
		 */
591
#if ISC_MEM_FILL
Mark Andrews's avatar
Mark Andrews committed
592 593
		memset(mem, 0xde, size); /* Mnemonic for "dead". */
#endif
594
		(ctx->memfree)(ctx->arg, mem);
Bob Halley's avatar
base  
Bob Halley committed
595 596
		INSIST(ctx->stats[ctx->max_size].gets != 0);
		ctx->stats[ctx->max_size].gets--;
Bob Halley's avatar
Bob Halley committed
597
		INSIST(size <= ctx->total);
598
		ctx->inuse -= size;
Bob Halley's avatar
Bob Halley committed
599
		ctx->total -= size;
Michael Graff's avatar
Michael Graff committed
600
		return;
Bob Halley's avatar
base  
Bob Halley committed
601 602
	}

603 604
#if ISC_MEM_FILL
#if ISC_MEM_CHECKOVERRUN
605 606
	check_overrun(mem, size, new_size);
#endif
Mark Andrews's avatar
Mark Andrews committed
607 608
	memset(mem, 0xde, new_size); /* Mnemonic for "dead". */
#endif
609

610 611 612
	/*
	 * The free list uses the "rounded-up" size "new_size".
	 */
Mark Andrews's avatar
Mark Andrews committed
613 614
	((element *)mem)->next = ctx->freelists[new_size];
	ctx->freelists[new_size] = (element *)mem;
Bob Halley's avatar
base  
Bob Halley committed
615

616
	/*
Bob Halley's avatar
base  
Bob Halley committed
617 618 619 620 621 622 623 624
	 * The stats[] uses the _actual_ "size" requested by the
	 * caller, with the caveat (in the code above) that "size" >= the
	 * max. size (max_size) ends up getting recorded as a call to
	 * max_size.
	 */
	INSIST(ctx->stats[size].gets != 0);
	ctx->stats[size].gets--;
	ctx->stats[new_size].freefrags++;
625
	ctx->inuse -= new_size;
Bob Halley's avatar
base  
Bob Halley committed
626 627
}

628 629 630 631 632 633 634 635 636 637 638 639 640 641 642 643 644 645 646 647 648 649 650 651 652 653 654 655 656 657 658 659 660 661
#else /* ISC_MEM_USE_INTERNAL_MALLOC */

/*
 * Perform a malloc, doing memory filling and overrun detection as necessary.
 */
static inline void *
mem_get(isc_mem_t *ctx, size_t size) {
	char *ret;

#if ISC_MEM_CHECKOVERRUN
	size += 1;
#endif

	ret = (ctx->memalloc)(ctx->arg, size);

#if ISC_MEM_FILL
	if (ret != NULL)
		memset(ret, 0xbe, size); /* Mnemonic for "beef". */
#else
#  if ISC_MEM_CHECKOVERRUN
	if (ret != NULL)
		ret[size-1] = 0xbe;
#  endif
#endif

	return (ret);
}

/*
 * Perform a free, doing memory filling and overrun detection as necessary.
 */
static inline void
mem_put(isc_mem_t *ctx, void *mem, size_t size) {
#if ISC_MEM_CHECKOVERRUN
662
	INSIST(((unsigned char *)mem)[size] == 0xbe);
663 664 665 666 667 668 669 670 671 672 673 674 675 676 677 678 679 680 681 682 683 684 685 686 687 688 689 690 691 692 693 694 695 696 697 698 699 700 701 702 703 704 705 706 707 708
#endif
#if ISC_MEM_FILL
	memset(mem, 0xde, size); /* Mnemonic for "dead". */
#endif

	(ctx->memfree)(ctx->arg, mem);
}

/*
 * Update internal counters after a memory get.
 */
static inline void
mem_getstats(isc_mem_t *ctx, size_t size) {
	ctx->total += size;
	ctx->inuse += size;

	if (size > ctx->max_size) {
		ctx->stats[ctx->max_size].gets++;
		ctx->stats[ctx->max_size].totalgets++;
	} else {
		ctx->stats[size].gets++;
		ctx->stats[size].totalgets++;
	}
}

/*
 * Update internal counters after a memory put.
 */
static inline void
mem_putstats(isc_mem_t *ctx, void *ptr, size_t size) {
	UNUSED(ptr);

	INSIST(ctx->inuse >= size);
	ctx->inuse -= size;

	if (size > ctx->max_size) {
		INSIST(ctx->stats[ctx->max_size].gets > 0);
		ctx->stats[ctx->max_size].gets--;
	} else {
		INSIST(ctx->stats[size].gets > 0);
		ctx->stats[size].gets--;
	}
}

#endif /* ISC_MEM_USE_INTERNAL_MALLOC */

David Lawrence's avatar
David Lawrence committed
709 710 711 712 713 714 715 716 717 718 719 720 721 722 723 724 725 726 727 728 729 730 731 732 733 734
/*
 * Private.
 */

static void *
default_memalloc(void *arg, size_t size) {
	UNUSED(arg);
	return (malloc(size));
}

static void
default_memfree(void *arg, void *ptr) {
	UNUSED(arg);
	free(ptr);
}

/*
 * Public.
 */

isc_result_t
isc_mem_createx(size_t init_max_size, size_t target_size,
		isc_memalloc_t memalloc, isc_memfree_t memfree, void *arg,
		isc_mem_t **ctxp)
{
	isc_mem_t *ctx;
735
	isc_result_t result;
David Lawrence's avatar
David Lawrence committed
736 737 738 739 740

	REQUIRE(ctxp != NULL && *ctxp == NULL);
	REQUIRE(memalloc != NULL);
	REQUIRE(memfree != NULL);

741 742
	INSIST((ALIGNMENT_SIZE & (ALIGNMENT_SIZE - 1)) == 0);

743 744 745 746
#if !ISC_MEM_USE_INTERNAL_MALLOC
	UNUSED(target_size);
#endif

David Lawrence's avatar
David Lawrence committed
747 748 749 750 751 752 753 754
	ctx = (memalloc)(arg, sizeof *ctx);
	if (ctx == NULL)
		return (ISC_R_NOMEMORY);

	if (init_max_size == 0)
		ctx->max_size = DEF_MAX_SIZE;
	else
		ctx->max_size = init_max_size;
755 756 757 758 759 760 761 762 763 764 765 766 767 768 769
	ctx->references = 1;
	ctx->quota = 0;
	ctx->total = 0;
	ctx->inuse = 0;
	ctx->hi_water = 0;
	ctx->lo_water = 0;
	ctx->hi_called = ISC_FALSE;
	ctx->water = NULL;
	ctx->water_arg = NULL;
	ctx->magic = MEM_MAGIC;
	isc_ondestroy_init(&ctx->ondestroy);
	ctx->memalloc = memalloc;
	ctx->memfree = memfree;
	ctx->arg = arg;
	ctx->stats = NULL;
770
	ctx->checkfree = ISC_TRUE;
771 772 773 774 775 776 777 778 779 780 781 782 783 784 785
	ISC_LIST_INIT(ctx->pools);

#if ISC_MEM_USE_INTERNAL_MALLOC
	ctx->freelists = NULL;
#endif /* ISC_MEM_USE_INTERNAL_MALLOC */

	ctx->stats = (memalloc)(arg,
				(ctx->max_size+1) * sizeof (struct stats));
	if (ctx->stats == NULL) {
		result = ISC_R_NOMEMORY;
		goto error;
	}
	memset(ctx->stats, 0, (ctx->max_size + 1) * sizeof (struct stats));

#if ISC_MEM_USE_INTERNAL_MALLOC
David Lawrence's avatar
David Lawrence committed
786 787 788 789 790 791
	if (target_size == 0)
		ctx->mem_target = DEF_MEM_TARGET;
	else
		ctx->mem_target = target_size;
	ctx->freelists = (memalloc)(arg, ctx->max_size * sizeof (element *));
	if (ctx->freelists == NULL) {
792 793
		result = ISC_R_NOMEMORY;
		goto error;
David Lawrence's avatar
David Lawrence committed
794 795 796 797 798 799 800 801 802 803
	}
	ctx->trysplit = ISC_FALSE;
	memset(ctx->freelists, 0,
	       ctx->max_size * sizeof (element *));
	ctx->basic_blocks = NULL;
	ctx->basic_table = NULL;
	ctx->basic_table_count = 0;
	ctx->basic_table_size = 0;
	ctx->lowest = NULL;
	ctx->highest = NULL;
804 805
#endif /* ISC_MEM_USE_INTERNAL_MALLOC */

David Lawrence's avatar
David Lawrence committed
806 807
	if (isc_mutex_init(&ctx->lock) != ISC_R_SUCCESS) {
		UNEXPECTED_ERROR(__FILE__, __LINE__,
808 809 810
				 "isc_mutex_init() %s",
				 isc_msgcat_get(isc_msgcat, ISC_MSGSET_GENERAL,
						ISC_MSG_FAILED, "failed"));
811 812
		result = ISC_R_UNEXPECTED;
		goto error;
David Lawrence's avatar
David Lawrence committed
813
	}
814

815
#if ISC_MEM_TRACKLINES
Michael Graff's avatar
Michael Graff committed
816 817
	ISC_LIST_INIT(ctx->debuglist);
#endif
David Lawrence's avatar
David Lawrence committed
818 819 820

	*ctxp = ctx;
	return (ISC_R_SUCCESS);
821 822 823 824 825 826 827 828 829 830 831 832 833

  error:
	if (ctx) {
		if (ctx->stats)
			(memfree)(arg, ctx->stats);
#if ISC_MEM_USE_INTERNAL_MALLOC
		if (ctx->freelists)
			(memfree)(arg, ctx->freelists);
#endif /* ISC_MEM_USE_INTERNAL_MALLOC */
		(memfree)(arg, ctx);
	}

	return (result);
David Lawrence's avatar
David Lawrence committed
834 835 836 837 838 839 840 841 842 843 844 845 846 847 848 849 850 851
}

isc_result_t
isc_mem_create(size_t init_max_size, size_t target_size,
	       isc_mem_t **ctxp)
{
	return (isc_mem_createx(init_max_size, target_size,
				default_memalloc, default_memfree, NULL,
				ctxp));
}

static void
destroy(isc_mem_t *ctx) {
	unsigned int i;
	isc_ondestroy_t ondest;

	ctx->magic = 0;

852
#if ISC_MEM_USE_INTERNAL_MALLOC
David Lawrence's avatar
David Lawrence committed
853
	INSIST(ISC_LIST_EMPTY(ctx->pools));
854 855
#endif /* ISC_MEM_USE_INTERNAL_MALLOC */

856
#if ISC_MEM_TRACKLINES
857 858
	if (ctx->checkfree)
		INSIST(ISC_LIST_EMPTY(ctx->debuglist));
859 860 861 862 863 864 865 866 867 868
	else {
		debuglink_t *dl;

		for (dl = ISC_LIST_HEAD(ctx->debuglist);
		     dl != NULL;
		     dl = ISC_LIST_HEAD(ctx->debuglist)) {
			ISC_LIST_UNLINK(ctx->debuglist, dl, link);
			free(dl);
		}
	}
Michael Graff's avatar
Michael Graff committed
869
#endif
David Lawrence's avatar
David Lawrence committed
870 871 872 873 874 875 876
	INSIST(ctx->references == 0);

	if (ctx->checkfree) {
		for (i = 0; i <= ctx->max_size; i++)
			INSIST(ctx->stats[i].gets == 0);
	}

877
	(ctx->memfree)(ctx->arg, ctx->stats);
David Lawrence's avatar
David Lawrence committed
878

879
#if ISC_MEM_USE_INTERNAL_MALLOC
David Lawrence's avatar
David Lawrence committed
880 881 882 883
	for (i = 0; i < ctx->basic_table_count; i++)
		(ctx->memfree)(ctx->arg, ctx->basic_table[i]);
	(ctx->memfree)(ctx->arg, ctx->freelists);
	(ctx->memfree)(ctx->arg, ctx->basic_table);
884
#endif /* ISC_MEM_USE_INTERNAL_MALLOC */
David Lawrence's avatar
David Lawrence committed
885 886 887

	ondest = ctx->ondestroy;

888
	DESTROYLOCK(&ctx->lock);
David Lawrence's avatar
David Lawrence committed
889 890 891 892 893 894 895 896 897 898 899 900 901 902 903 904 905 906 907 908 909 910 911 912 913 914 915 916 917 918 919 920 921 922 923 924 925 926 927
	(ctx->memfree)(ctx->arg, ctx);

	isc_ondestroy_notify(&ondest, ctx);
}

void
isc_mem_attach(isc_mem_t *source, isc_mem_t **targetp) {
	REQUIRE(VALID_CONTEXT(source));
	REQUIRE(targetp != NULL && *targetp == NULL);

	LOCK(&source->lock);
	source->references++;
	UNLOCK(&source->lock);

	*targetp = source;
}

void
isc_mem_detach(isc_mem_t **ctxp) {
	isc_mem_t *ctx;
	isc_boolean_t want_destroy = ISC_FALSE;

	REQUIRE(ctxp != NULL);
	ctx = *ctxp;
	REQUIRE(VALID_CONTEXT(ctx));

	LOCK(&ctx->lock);
	INSIST(ctx->references > 0);
	ctx->references--;
	if (ctx->references == 0)
		want_destroy = ISC_TRUE;
	UNLOCK(&ctx->lock);

	if (want_destroy)
		destroy(ctx);

	*ctxp = NULL;
}

928 929 930 931 932 933 934 935 936 937 938 939 940 941 942 943 944 945 946 947 948 949 950 951 952 953
/*
 * isc_mem_putanddetach() is the equivalent of:
 *
 * mctx = NULL;
 * isc_mem_attach(ptr->mctx, &mctx);
 * isc_mem_detach(&ptr->mctx);
 * isc_mem_put(mctx, ptr, sizeof(*ptr);
 * isc_mem_detach(&mctx);
 */

void
isc__mem_putanddetach(isc_mem_t **ctxp, void *ptr, size_t size FLARG) {
	isc_mem_t *ctx;
	isc_boolean_t want_destroy = ISC_FALSE;

	REQUIRE(ctxp != NULL);
	ctx = *ctxp;
	REQUIRE(VALID_CONTEXT(ctx));
	REQUIRE(ptr != NULL);

	/*
	 * Must be before mem_putunlocked() as ctxp is usually within
	 * [ptr..ptr+size).
	 */
	*ctxp = NULL;

954
#if ISC_MEM_USE_INTERNAL_MALLOC
955 956
	LOCK(&ctx->lock);
	mem_putunlocked(ctx, ptr, size);
957 958 959 960 961 962 963
#else /* ISC_MEM_USE_INTERNAL_MALLOC */
	mem_put(ctx, ptr, size);
	LOCK(&ctx->lock);
	mem_putstats(ctx, ptr, size);
#endif /* ISC_MEM_USE_INTERNAL_MALLOC */

	DELETE_TRACE(ctx, ptr, size, file, line);
964 965 966 967
	INSIST(ctx->references > 0);
	ctx->references--;
	if (ctx->references == 0)
		want_destroy = ISC_TRUE;
968

969 970 971 972 973 974
	UNLOCK(&ctx->lock);

	if (want_destroy)
		destroy(ctx);
}

David Lawrence's avatar
David Lawrence committed
975 976 977 978 979 980 981 982 983 984 985 986 987 988 989 990 991 992
void
isc_mem_destroy(isc_mem_t **ctxp) {
	isc_mem_t *ctx;

	/*
	 * This routine provides legacy support for callers who use mctxs
	 * without attaching/detaching.
	 */

	REQUIRE(ctxp != NULL);
	ctx = *ctxp;
	REQUIRE(VALID_CONTEXT(ctx));

	LOCK(&ctx->lock);
	REQUIRE(ctx->references == 1);
	ctx->references--;
	UNLOCK(&ctx->lock);

Brian Wellington's avatar
Brian Wellington committed
993
	destroy(ctx);
David Lawrence's avatar
David Lawrence committed
994 995 996 997 998 999 1000

	*ctxp = NULL;
}

isc_result_t
isc_mem_ondestroy(isc_mem_t *ctx, isc_task_t *task, isc_event_t **event) {
	isc_result_t res;
1001

David Lawrence's avatar
David Lawrence committed
1002 1003 1004 1005 1006 1007 1008 1009 1010 1011 1012 1013
	LOCK(&ctx->lock);
	res = isc_ondestroy_register(&ctx->ondestroy, task, event);
	UNLOCK(&ctx->lock);

	return (res);
}


isc_result_t
isc_mem_restore(isc_mem_t *ctx) {
	isc_result_t result;

1014
	result = isc_mutex_init(&ctx->lock);
David Lawrence's avatar
David Lawrence committed
1015 1016 1017 1018 1019 1020
	if (result != ISC_R_SUCCESS)
		ctx->magic = 0;

	return (result);
}

Michael Graff's avatar
Michael Graff committed
1021 1022 1023
void *
isc__mem_get(isc_mem_t *ctx, size_t size FLARG) {
	void *ptr;
1024
	isc_boolean_t call_water = ISC_FALSE;
Michael Graff's avatar
Michael Graff committed
1025

David Lawrence's avatar
David Lawrence committed
1026 1027
	REQUIRE(VALID_CONTEXT(ctx));

1028
#if ISC_MEM_USE_INTERNAL_MALLOC
David Lawrence's avatar
David Lawrence committed
1029
	LOCK(&ctx->lock);
Michael Graff's avatar
Michael Graff committed
1030
	ptr = mem_getunlocked(ctx, size);
1031 1032 1033 1034 1035 1036
#else /* ISC_MEM_USE_INTERNAL_MALLOC */
	ptr = mem_get(ctx, size);
	LOCK(&ctx->lock);
	mem_getstats(ctx, size);
#endif /* ISC_MEM_USE_INTERNAL_MALLOC */

Michael Graff's avatar
Michael Graff committed
1037
	ADD_TRACE(ctx, ptr, size, file, line);
1038 1039 1040 1041 1042
	if (ctx->hi_water != 0 && !ctx->hi_called &&
	    ctx->inuse > ctx->hi_water) {
		ctx->hi_called = ISC_TRUE;
		call_water = ISC_TRUE;
	}
David Lawrence's avatar
David Lawrence committed
1043
	UNLOCK(&ctx->lock);
1044 1045 1046 1047 1048

	if (call_water) {
		(ctx->water)(ctx->water_arg, ISC_MEM_HIWATER);
	}

Bob Halley's avatar
base  
Bob Halley committed
1049 1050 1051 1052
	return (ptr);
}

void
Michael Graff's avatar
Michael Graff committed
1053
isc__mem_put(isc_mem_t *ctx, void *ptr, size_t size FLARG)
Bob Halley's avatar
base  
Bob Halley committed
1054
{
1055 1056
	isc_boolean_t call_water = ISC_FALSE;

Michael Graff's avatar
Michael Graff committed
1057 1058 1059
	REQUIRE(VALID_CONTEXT(ctx));
	REQUIRE(ptr != NULL);

1060
#if ISC_MEM_USE_INTERNAL_MALLOC
Michael Graff's avatar
Michael Graff committed
1061 1062
	LOCK(&ctx->lock);
	mem_putunlocked(ctx, ptr, size);
1063 1064 1065 1066 1067 1068 1069
#else /* ISC_MEM_USE_INTERNAL_MALLOC */
	mem_put(ctx, ptr, size);
	LOCK(&ctx->lock);
	mem_putstats(ctx, ptr, size);
#endif /* ISC_MEM_USE_INTERNAL_MALLOC */

	DELETE_TRACE(ctx, ptr, size, file, line);
1070 1071 1072 1073
	if (ctx->hi_called && ctx->inuse < ctx->lo_water) {
		ctx->hi_called = ISC_FALSE;
		call_water = ISC_TRUE;
	}
Michael Graff's avatar
Michael Graff committed
1074
	UNLOCK(&ctx->lock);
1075 1076 1077 1078

	if (call_water) {
		(ctx->water)(ctx->water_arg, ISC_MEM_LOWATER);
	}
Bob Halley's avatar
base  
Bob Halley committed
1079 1080
}

1081 1082
isc_result_t
isc_mem_preallocate(isc_mem_t *ctx) {
1083 1084
#if ISC_MEM_USE_INTERNAL_MALLOC

1085 1086 1087 1088 1089 1090 1091 1092 1093 1094 1095 1096 1097 1098 1099 1100
	size_t i;
	isc_result_t result = ISC_R_SUCCESS;
	void *ptr;

	REQUIRE(VALID_CONTEXT(ctx));

	LOCK(&ctx->lock);

	for (i = 0; i < ctx->max_size; i += ALIGNMENT_SIZE) {
		ptr = mem_getunlocked(ctx, i);
		if (ptr == NULL) {
			result = ISC_R_NOMEMORY;
			break;
		}
		mem_putunlocked(ctx, ptr, i);
	}
1101

1102 1103 1104
	UNLOCK(&ctx->lock);

	return (result);
1105 1106 1107 1108 1109 1110 1111

#else /* ISC_MEM_USE_INTERNAL_MALLOC */

	UNUSED(ctx);
	return (ISC_R_SUCCESS);

#endif /* ISC_MEM_USE_INTERNAL_MALLOC */
1112 1113
}

Bob Halley's avatar
base  
Bob Halley committed
1114
void
1115
isc_mem_stats(isc_mem_t *ctx, FILE *out) {
Bob Halley's avatar
base  
Bob Halley committed
1116
	size_t i;
Michael Graff's avatar
Michael Graff committed
1117 1118
	const struct stats *s;
	const isc_mempool_t *pool;
Bob Halley's avatar
base  
Bob Halley committed
1119

Bob Halley's avatar
Bob Halley committed
1120 1121
	REQUIRE(VALID_CONTEXT(ctx));
	LOCK(&ctx->lock);
Bob Halley's avatar
base  
Bob Halley committed
1122

1123
	if (ctx->inuse > 0) {
1124
		for (i = 0; i <= ctx->max_size; i++) {
Michael Graff's avatar
Michael Graff committed
1125 1126 1127 1128
			s = &ctx->stats[i];

			if (s->totalgets == 0 && s->gets == 0)
				continue;
1129
			fprintf(out, "%s%5lu: %11lu gets, %11lu rem",
Michael Graff's avatar
Michael Graff committed
1130
				(i == ctx->max_size) ? ">=" : "  ",
1131
				(unsigned long) i, s->totalgets, s->gets);
1132
#if ISC_MEM_USE_INTERNAL_MALLOC
1133
			if (s->blocks != 0 || s->freefrags != 0)
Michael Graff's avatar
Michael Graff committed
1134 1135
				fprintf(out, " (%lu bl, %lu ff)",
					s->blocks, s->freefrags);
1136
#endif /* ISC_MEM_USE_INTERNAL_MALLOC */
Michael Graff's avatar
Michael Graff committed
1137 1138 1139 1140
			fputc('\n', out);
		}
	}

Michael Graff's avatar
Michael Graff committed
1141 1142 1143 1144 1145 1146 1147
	/*
	 * Note that since a pool can be locked now, these stats might be
	 * somewhat off if the pool is in active use at the time the stats
	 * are dumped.  The link fields are protected by the isc_mem_t's
	 * lock, however, so walking this list and extracting integers from
	 * stats fields is always safe.
	 */
Michael Graff's avatar
Michael Graff committed
1148 1149
	pool = ISC_LIST_HEAD(ctx->pools);
	if (pool != NULL) {
1150 1151 1152
		fprintf(out, isc_msgcat_get(isc_msgcat, ISC_MSGSET_MEM,
					    ISC_MSG_POOLSTATS,
					    "[Pool statistics]\n"));
Michael Graff's avatar
Michael Graff committed
1153
		fprintf(out, "%15s %10s %10s %10s %10s %10s %10s %10s %1s\n",
1154 1155 1156 1157 1158 1159 1160 1161 1162 1163 1164 1165 1166 1167 1168 1169 1170
			isc_msgcat_get(isc_msgcat, ISC_MSGSET_MEM,
				       ISC_MSG_POOLNAME, "name"),