xref: /dflybsd-src/sys/kern/tty_subr.c (revision 22ff886e5769d1e8d4bf7faa7bdb9f608ede1714)

/*
 * (MPSAFE)
 *
 * Copyright (c) 1994, David Greenman
 * All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 * 1. Redistributions of source code must retain the above copyright
 *    notice unmodified, this list of conditions, and the following
 *    disclaimer.
 * 2. Redistributions in binary form must reproduce the above copyright
 *    notice, this list of conditions and the following disclaimer in the
 *    documentation and/or other materials provided with the distribution.
 *
 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
 * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 * SUCH DAMAGE.
 *
 * $FreeBSD: src/sys/kern/tty_subr.c,v 1.32 1999/08/28 00:46:21 peter Exp $
 * $DragonFly: src/sys/kern/tty_subr.c,v 1.10 2006/12/23 00:35:04 swildner Exp $
 */

/*
 * MPSAFE NOTE:
 * Most functions here could use a separate lock to deal with concurrent
 * access to the cblocks and cblock_*_list.
 *
 * Right now the tty_token must be held for all this.
 */

/*
 * clist support routines
 *
 * NOTE on cblock->c_cf:	This pointer may point at the base of a cblock,
 *				which is &cblock->c_info[0], but will never
 *				point at the end of a cblock (char *)(cblk + 1)
 *
 * NOTE on cblock->c_cl:	This pointer will never point at the base of
 *				a block but may point at the end of one.
 *
 * These routines may be used by more then just ttys, so a critical section
 * must be used to access the free list, and for general safety.
 */

#include <sys/param.h>
#include <sys/kernel.h>
#include <sys/systm.h>
#include <sys/malloc.h>
#include <sys/tty.h>
#include <sys/clist.h>
#include <sys/thread2.h>

static void clist_init (void *);
SYSINIT(clist, SI_SUB_CLIST, SI_ORDER_FIRST, clist_init, NULL)

static struct cblock *cfreelist = 0;
int cfreecount = 0;
static int cslushcount;
static int ctotcount;

#ifndef INITIAL_CBLOCKS
#define	INITIAL_CBLOCKS 50
#endif

static struct cblock *cblock_alloc (void);
static void cblock_alloc_cblocks (int number);
static void cblock_free (struct cblock *cblockp);
static void cblock_free_cblocks (int number);

#include "opt_ddb.h"
#ifdef DDB
#include <ddb/ddb.h>

DB_SHOW_COMMAND(cbstat, cbstat)
{
	int cbsize = CBSIZE;

	kprintf(
	"tot = %d (active = %d, free = %d (reserved = %d, slush = %d))\n",
	       ctotcount * cbsize, ctotcount * cbsize - cfreecount, cfreecount,
	       cfreecount - cslushcount * cbsize, cslushcount * cbsize);
}
#endif /* DDB */

/*
 * Called from init_main.c
 */
/* ARGSUSED*/
static void
clist_init(void *dummy)
{
	/*
	 * Allocate an initial base set of cblocks as a 'slush'.
	 * We allocate non-slush cblocks with each initial ttyopen() and
	 * deallocate them with each ttyclose().
	 * We should adjust the slush allocation.  This can't be done in
	 * the i/o routines because they are sometimes called from
	 * interrupt handlers when it may be unsafe to call kmalloc().
	 */
	lwkt_gettoken(&tty_token);
	cblock_alloc_cblocks(cslushcount = INITIAL_CBLOCKS);
	lwkt_reltoken(&tty_token);
	KKASSERT(sizeof(struct cblock) == CBLOCK);
}

/*
 * Remove a cblock from the cfreelist queue and return a pointer
 * to it.
 *
 * May not block.
 *
 * NOTE: Must be called with tty_token held
 */
static struct cblock *
cblock_alloc(void)
{
	struct cblock *cblockp;

	ASSERT_LWKT_TOKEN_HELD(&tty_token);

	cblockp = cfreelist;
	if (cblockp == NULL)
		panic("clist reservation botch");
	KKASSERT(cblockp->c_head.ch_magic == CLIST_MAGIC_FREE);
	cfreelist = cblockp->c_head.ch_next;
	cblockp->c_head.ch_next = NULL;
	cblockp->c_head.ch_magic = CLIST_MAGIC_USED;
	cfreecount -= CBSIZE;
	return (cblockp);
}

/*
 * Add a cblock to the cfreelist queue.
 *
 * May not block, must be called in a critical section
 *
 * NOTE: Must be called with tty_token held
 */
static void
cblock_free(struct cblock *cblockp)
{
	ASSERT_LWKT_TOKEN_HELD(&tty_token);

	if (isset(cblockp->c_quote, CBQSIZE * NBBY - 1))
		bzero(cblockp->c_quote, sizeof cblockp->c_quote);
	KKASSERT(cblockp->c_head.ch_magic == CLIST_MAGIC_USED);
	cblockp->c_head.ch_next = cfreelist;
	cblockp->c_head.ch_magic = CLIST_MAGIC_FREE;
	cfreelist = cblockp;
	cfreecount += CBSIZE;
}

/*
 * Allocate some cblocks for the cfreelist queue.
 *
 * This routine may block, but still must be called in a critical section
 *
 * NOTE: Must be called with tty_token held
 */
static void
cblock_alloc_cblocks(int number)
{
	int i;
	struct cblock *cbp;

	ASSERT_LWKT_TOKEN_HELD(&tty_token);

	for (i = 0; i < number; ++i) {
		cbp = kmalloc(sizeof *cbp, M_TTYS, M_NOWAIT);
		if (cbp == NULL) {
			kprintf(
"clist_alloc_cblocks: M_NOWAIT kmalloc failed, trying M_WAITOK\n");
			cbp = kmalloc(sizeof *cbp, M_TTYS, M_WAITOK);
		}
		KKASSERT(((intptr_t)cbp & CROUND) == 0);
		/*
		 * Freed cblocks have zero quotes and garbage elsewhere.
		 * Set the may-have-quote bit to force zeroing the quotes.
		 */
		setbit(cbp->c_quote, CBQSIZE * NBBY - 1);
		cbp->c_head.ch_magic = CLIST_MAGIC_USED;
		cblock_free(cbp);
	}
	ctotcount += number;
}

/*
 * Set the cblock allocation policy for a clist.
 */
void
clist_alloc_cblocks(struct clist *clistp, int ccmax, int ccreserved)
{
	int dcbr;

	/*
	 * Allow for wasted space at the head.
	 */
	if (ccmax != 0)
		ccmax += CBSIZE - 1;
	if (ccreserved != 0)
		ccreserved += CBSIZE - 1;

	crit_enter();
	lwkt_gettoken(&tty_token);
	clistp->c_cbmax = roundup(ccmax, CBSIZE) / CBSIZE;
	dcbr = roundup(ccreserved, CBSIZE) / CBSIZE - clistp->c_cbreserved;
	if (dcbr >= 0) {
		clistp->c_cbreserved += dcbr;	/* atomic w/c_cbmax */
		cblock_alloc_cblocks(dcbr);	/* may block */
	} else {
		KKASSERT(clistp->c_cbcount <= clistp->c_cbreserved);
		if (clistp->c_cbreserved + dcbr < clistp->c_cbcount)
			dcbr = clistp->c_cbcount - clistp->c_cbreserved;
		clistp->c_cbreserved += dcbr;	/* atomic w/c_cbmax */
		cblock_free_cblocks(-dcbr);	/* may block */
	}
	KKASSERT(clistp->c_cbreserved >= 0);
	lwkt_reltoken(&tty_token);
	crit_exit();
}

/*
 * Free some cblocks from the cfreelist queue back to the
 * system malloc pool.
 *
 * Must be called from within a critical section.  May block.
 */
static void
cblock_free_cblocks(int number)
{
	int i;

	lwkt_gettoken(&tty_token);
	for (i = 0; i < number; ++i)
		kfree(cblock_alloc(), M_TTYS);
	ctotcount -= number;
	lwkt_reltoken(&tty_token);
}

/*
 * Free the cblocks reserved for a clist.
 */
void
clist_free_cblocks(struct clist *clistp)
{
	int cbreserved;

	crit_enter();
	lwkt_gettoken(&tty_token);
	if (clistp->c_cbcount != 0)
		panic("freeing active clist cblocks");
	cbreserved = clistp->c_cbreserved;
	clistp->c_cbmax = 0;
	clistp->c_cbreserved = 0;
	cblock_free_cblocks(cbreserved); /* may block */
	lwkt_reltoken(&tty_token);
	crit_exit();
}

/*
 * Get a character from the head of a clist.
 */
int
clist_getc(struct clist *clistp)
{
	int chr = -1;
	struct cblock *cblockp;

	crit_enter();
	lwkt_gettoken(&tty_token);
	if (clistp->c_cc) {
		KKASSERT(((intptr_t)clistp->c_cf & CROUND) != 0);
		cblockp = (struct cblock *)((intptr_t)clistp->c_cf & ~CROUND);
		chr = (u_char)*clistp->c_cf;

		/*
		 * If this char is quoted, set the flag.
		 */
		if (isset(cblockp->c_quote, clistp->c_cf - (char *)cblockp->c_info))
			chr |= TTY_QUOTE;

		/*
		 * Advance to next character.
		 */
		clistp->c_cf++;
		clistp->c_cc--;
		/*
		 * If we have advanced the 'first' character pointer
		 * past the end of this cblock, advance to the next one.
		 * If there are no more characters, set the first and
		 * last pointers to NULL. In either case, free the
		 * current cblock.
		 */
		KKASSERT(clistp->c_cf <= (char *)(cblockp + 1));
		if ((clistp->c_cf == (char *)(cblockp + 1)) ||
		    (clistp->c_cc == 0)) {
			if (clistp->c_cc > 0) {
				clistp->c_cf = cblockp->c_head.ch_next->c_info;
			} else {
				clistp->c_cf = clistp->c_cl = NULL;
			}
			cblock_free(cblockp);
			if (--clistp->c_cbcount >= clistp->c_cbreserved)
				++cslushcount;
		}
	}
	lwkt_reltoken(&tty_token);
	crit_exit();
	return (chr);
}

/*
 * Copy 'amount' of chars, beginning at head of clist 'clistp' to
 * destination linear buffer 'dest'. Return number of characters
 * actually copied.
 */
int
q_to_b(struct clist *clistp, char *dest, int amount)
{
	struct cblock *cblockp;
	struct cblock *cblockn;
	char *dest_orig = dest;
	int numc;

	crit_enter();
	lwkt_gettoken(&tty_token);
	while (clistp && amount && (clistp->c_cc > 0)) {
		KKASSERT(((intptr_t)clistp->c_cf & CROUND) != 0);
		cblockp = (struct cblock *)((intptr_t)clistp->c_cf & ~CROUND);
		cblockn = cblockp + 1; /* pointer arithmetic! */
		numc = min(amount, (char *)cblockn - clistp->c_cf);
		numc = min(numc, clistp->c_cc);
		bcopy(clistp->c_cf, dest, numc);
		amount -= numc;
		clistp->c_cf += numc;
		clistp->c_cc -= numc;
		dest += numc;
		/*
		 * If this cblock has been emptied, advance to the next
		 * one. If there are no more characters, set the first
		 * and last pointer to NULL. In either case, free the
		 * current cblock.
		 */
		KKASSERT(clistp->c_cf <= (char *)cblockn);
		if ((clistp->c_cf == (char *)cblockn) || (clistp->c_cc == 0)) {
			if (clistp->c_cc > 0) {
				KKASSERT(cblockp->c_head.ch_next != NULL);
				clistp->c_cf = cblockp->c_head.ch_next->c_info;
			} else {
				clistp->c_cf = clistp->c_cl = NULL;
			}
			cblock_free(cblockp);
			if (--clistp->c_cbcount >= clistp->c_cbreserved)
				++cslushcount;
		}
	}
	lwkt_reltoken(&tty_token);
	crit_exit();
	return (dest - dest_orig);
}

/*
 * Flush 'amount' of chars, beginning at head of clist 'clistp'.
 */
void
ndflush(struct clist *clistp, int amount)
{
	struct cblock *cblockp;
	struct cblock *cblockn;
	int numc;

	crit_enter();
	lwkt_gettoken(&tty_token);
	while (amount && (clistp->c_cc > 0)) {
		KKASSERT(((intptr_t)clistp->c_cf & CROUND) != 0);
		cblockp = (struct cblock *)((intptr_t)clistp->c_cf & ~CROUND);
		cblockn = cblockp + 1; /* pointer arithmetic! */
		numc = min(amount, (char *)cblockn - clistp->c_cf);
		numc = min(numc, clistp->c_cc);
		amount -= numc;
		clistp->c_cf += numc;
		clistp->c_cc -= numc;
		/*
		 * If this cblock has been emptied, advance to the next
		 * one. If there are no more characters, set the first
		 * and last pointer to NULL. In either case, free the
		 * current cblock.
		 */
		KKASSERT(clistp->c_cf <= (char *)cblockn);
		if (clistp->c_cf == (char *)cblockn || clistp->c_cc == 0) {
			if (clistp->c_cc > 0) {
				KKASSERT(cblockp->c_head.ch_next != NULL);
				clistp->c_cf = cblockp->c_head.ch_next->c_info;
			} else {
				clistp->c_cf = clistp->c_cl = NULL;
			}
			cblock_free(cblockp);
			if (--clistp->c_cbcount >= clistp->c_cbreserved)
				++cslushcount;
		}
	}
	lwkt_reltoken(&tty_token);
	crit_exit();
}

/*
 * Add a character to the end of a clist. Return -1 is no
 * more clists, or 0 for success.
 */
int
clist_putc(int chr, struct clist *clistp)
{
	struct cblock *cblockp;

	crit_enter();
	lwkt_gettoken(&tty_token);

	/*
	 * Note: this section may point c_cl at the base of a cblock.  This
	 * is a temporary violation of the requirements for c_cl, we
	 * increment it before returning.
	 */
	if (clistp->c_cl == NULL) {
		if (clistp->c_cbreserved < 1) {
			lwkt_reltoken(&tty_token);
			crit_exit();
			kprintf("putc to a clist with no reserved cblocks\n");
			return (-1);		/* nothing done */
		}
		cblockp = cblock_alloc();
		clistp->c_cbcount = 1;
		clistp->c_cf = clistp->c_cl = cblockp->c_info;
		clistp->c_cc = 0;
	} else {
		cblockp = (struct cblock *)((intptr_t)clistp->c_cl & ~CROUND);
		if (((intptr_t)clistp->c_cl & CROUND) == 0) {
			struct cblock *prev = (cblockp - 1);

			if (clistp->c_cbcount >= clistp->c_cbreserved) {
				if (clistp->c_cbcount >= clistp->c_cbmax
				    || cslushcount <= 0) {
					lwkt_reltoken(&tty_token);
					crit_exit();
					return (-1);
				}
				--cslushcount;
			}
			cblockp = cblock_alloc();
			clistp->c_cbcount++;
			prev->c_head.ch_next = cblockp;
			clistp->c_cl = cblockp->c_info;
		}
	}

	/*
	 * If this character is quoted, set the quote bit, if not, clear it.
	 */
	if (chr & TTY_QUOTE) {
		setbit(cblockp->c_quote, clistp->c_cl - (char *)cblockp->c_info);
		/*
		 * Use one of the spare quote bits to record that something
		 * may be quoted.
		 */
		setbit(cblockp->c_quote, CBQSIZE * NBBY - 1);
	} else {
		clrbit(cblockp->c_quote, clistp->c_cl - (char *)cblockp->c_info);
	}

	*clistp->c_cl++ = chr;
	clistp->c_cc++;

	lwkt_reltoken(&tty_token);
	crit_exit();
	return (0);
}

/*
 * Copy data from linear buffer to clist chain. Return the
 * number of characters not copied.
 */
int
b_to_q(char *src, int amount, struct clist *clistp)
{
	struct cblock *cblockp;
	char *firstbyte, *lastbyte;
	u_char startmask, endmask;
	int startbit, endbit, num_between, numc;

	/*
	 * Avoid allocating an initial cblock and then not using it.
	 * c_cc == 0 must imply c_cbount == 0.
	 */
	if (amount <= 0)
		return (amount);

	crit_enter();
	lwkt_gettoken(&tty_token);

	/*
	 * Note: this section may point c_cl at the base of a cblock.  This
	 * is a temporary violation of the requirements for c_cl.  Since
	 * amount is non-zero we will not return with it in that state.
	 */
	if (clistp->c_cl == NULL) {
		if (clistp->c_cbreserved < 1) {
			lwkt_reltoken(&tty_token);
			crit_exit();
			kprintf("b_to_q to a clist with no reserved cblocks.\n");
			return (amount);	/* nothing done */
		}
		cblockp = cblock_alloc();
		clistp->c_cbcount = 1;
		clistp->c_cf = clistp->c_cl = cblockp->c_info;
		clistp->c_cc = 0;
	} else {
		/*
		 * c_cl may legally point past the end of the block, which
		 * falls through to the 'get another cblock' code below.
		 */
		cblockp = (struct cblock *)((intptr_t)clistp->c_cl & ~CROUND);
	}

	while (amount) {
		/*
		 * Get another cblock if needed.
		 */
		if (((intptr_t)clistp->c_cl & CROUND) == 0) {
			struct cblock *prev = cblockp - 1;

			if (clistp->c_cbcount >= clistp->c_cbreserved) {
				if (clistp->c_cbcount >= clistp->c_cbmax
				    || cslushcount <= 0) {
					lwkt_reltoken(&tty_token);
					crit_exit();
					return (amount);
				}
				--cslushcount;
			}
			cblockp = cblock_alloc();
			clistp->c_cbcount++;
			prev->c_head.ch_next = cblockp;
			clistp->c_cl = cblockp->c_info;
		}

		/*
		 * Copy a chunk of the linear buffer up to the end
		 * of this cblock.
		 */
		numc = min(amount, (char *)(cblockp + 1) - clistp->c_cl);
		bcopy(src, clistp->c_cl, numc);

		/*
		 * Clear quote bits if they aren't known to be clear.
		 * The following could probably be made into a separate
		 * "bitzero()" routine, but why bother?
		 */
		if (isset(cblockp->c_quote, CBQSIZE * NBBY - 1)) {
			startbit = clistp->c_cl - (char *)cblockp->c_info;
			endbit = startbit + numc - 1;

			firstbyte = (u_char *)cblockp->c_quote + (startbit / NBBY);
			lastbyte = (u_char *)cblockp->c_quote + (endbit / NBBY);

			/*
			 * Calculate mask of bits to preserve in first and
			 * last bytes.
			 */
			startmask = NBBY - (startbit % NBBY);
			startmask = 0xff >> startmask;
			endmask = (endbit % NBBY);
			endmask = 0xff << (endmask + 1);

			if (firstbyte != lastbyte) {
				*firstbyte &= startmask;
				*lastbyte &= endmask;

				num_between = lastbyte - firstbyte - 1;
				if (num_between)
					bzero(firstbyte + 1, num_between);
			} else {
				*firstbyte &= (startmask | endmask);
			}
		}

		/*
		 * ...and update pointer for the next chunk.
		 */
		src += numc;
		clistp->c_cl += numc;
		clistp->c_cc += numc;
		amount -= numc;
		/*
		 * If we go through the loop again, it's always
		 * for data in the next cblock, so by adding one (cblock),
		 * (which makes the pointer 1 beyond the end of this
		 * cblock) we prepare for the assignment of 'prev'
		 * above.
		 */
		++cblockp;
	}
	lwkt_reltoken(&tty_token);
	crit_exit();
	return (amount);
}

/*
 * Get the next character in the clist. Store it at dst. Don't
 * advance any clist pointers, but return a pointer to the next
 * character position.
 *
 * Must be called at spltty().  This routine may not run in a critical
 * section and so may not call the cblock allocator/deallocator.
 */
char *
nextc(struct clist *clistp, char *cp, int *dst)
{
	struct cblock *cblockp;

	++cp;
	/*
	 * See if the next character is beyond the end of
	 * the clist.
	 */
	lwkt_gettoken(&tty_token);
	if (clistp->c_cc && (cp != clistp->c_cl)) {
		/*
		 * If the next character is beyond the end of this
		 * cblock, advance to the next cblock.
		 */
		if (((intptr_t)cp & CROUND) == 0)
			cp = ((struct cblock *)cp - 1)->c_head.ch_next->c_info;
		cblockp = (struct cblock *)((intptr_t)cp & ~CROUND);

		/*
		 * Get the character. Set the quote flag if this character
		 * is quoted.
		 */
		*dst = (u_char)*cp | (isset(cblockp->c_quote, cp - (char *)cblockp->c_info) ? TTY_QUOTE : 0);

		lwkt_reltoken(&tty_token);
		return (cp);
	}

	lwkt_reltoken(&tty_token);
	return (NULL);
}

/*
 * "Unput" a character from a clist.
 */
int
clist_unputc(struct clist *clistp)
{
	struct cblock *cblockp = 0, *cbp = 0;
	int chr = -1;

	crit_enter();
	lwkt_gettoken(&tty_token);

	if (clistp->c_cc) {
		/*
		 * note that clistp->c_cl will never point at the base
		 * of a cblock (cblock->c_info) (see assert this later on),
		 * but it may point past the end of one.  We temporarily
		 * violate this in the decrement below but then we fix it up.
		 */
		--clistp->c_cc;
		--clistp->c_cl;

		chr = (u_char)*clistp->c_cl;

		cblockp = (struct cblock *)((intptr_t)clistp->c_cl & ~CROUND);

		/*
		 * Set quote flag if this character was quoted.
		 */
		if (isset(cblockp->c_quote, (u_char *)clistp->c_cl - cblockp->c_info))
			chr |= TTY_QUOTE;

		/*
		 * If all of the characters have been unput in this
		 * cblock, then find the previous one and free this
		 * one.
		 *
		 * if c_cc is 0 clistp->c_cl may end up pointing at
		 * cblockp->c_info, which is illegal, but the case will be
		 * taken care of near the end of the routine.  Otherwise
		 * there *MUST* be another cblock, find it.
		 */
		KKASSERT(clistp->c_cl >= (char *)cblockp->c_info);
		if (clistp->c_cc && (clistp->c_cl == (char *)cblockp->c_info)) {
			cbp = (struct cblock *)((intptr_t)clistp->c_cf & ~CROUND);

			while (cbp->c_head.ch_next != cblockp)
				cbp = cbp->c_head.ch_next;
			cbp->c_head.ch_next = NULL;

			/*
			 * When the previous cblock is at the end, the 'last'
			 * pointer always points (invalidly) one past.
			 */
			clistp->c_cl = (char *)(cbp + 1);
			cblock_free(cblockp);
			if (--clistp->c_cbcount >= clistp->c_cbreserved)
				++cslushcount;
		}
	}

	/*
	 * If there are no more characters on the list, then
	 * free the last cblock.   It should not be possible for c->cl
	 * to be pointing past the end of a block due to our decrement
	 * of it way above.
	 */
	if (clistp->c_cc == 0 && clistp->c_cl) {
		KKASSERT(((intptr_t)clistp->c_cl & CROUND) != 0);
		cblockp = (struct cblock *)((intptr_t)clistp->c_cl & ~CROUND);
		cblock_free(cblockp);
		if (--clistp->c_cbcount >= clistp->c_cbreserved)
			++cslushcount;
		clistp->c_cf = clistp->c_cl = NULL;
	}

	lwkt_reltoken(&tty_token);
	crit_exit();
	return (chr);
}

/*
 * Move characters in source clist to destination clist,
 * preserving quote bits.
 */
void
catq(struct clist *src_clistp, struct clist *dest_clistp)
{
	int chr;

	lwkt_gettoken(&tty_token);
	crit_enter();
	/*
	 * If the destination clist is empty (has no cblocks atttached),
	 * and there are no possible complications with the resource counters,
	 * then we simply assign the current clist to the destination.
	 */
	if (!dest_clistp->c_cf
	    && src_clistp->c_cbcount <= src_clistp->c_cbmax
	    && src_clistp->c_cbcount <= dest_clistp->c_cbmax) {
		dest_clistp->c_cf = src_clistp->c_cf;
		dest_clistp->c_cl = src_clistp->c_cl;
		src_clistp->c_cf = src_clistp->c_cl = NULL;

		dest_clistp->c_cc = src_clistp->c_cc;
		src_clistp->c_cc = 0;
		dest_clistp->c_cbcount = src_clistp->c_cbcount;
		src_clistp->c_cbcount = 0;

		crit_exit();
		lwkt_reltoken(&tty_token);
		return;
	}
	crit_exit();

	/*
	 * XXX  This should probably be optimized to more than one
	 * character at a time.
	 */
	while ((chr = clist_getc(src_clistp)) != -1)
		clist_putc(chr, dest_clistp);
	lwkt_reltoken(&tty_token);
}