/* Copyright (c) 1997 Silicon Graphics, Inc. */

#ifndef lint
static char SCCSid[] = "$SunId$ SGI";
#endif

/*
 * Routines for managing holodeck files
 *
 *	9/30/97	GWLarson
 */

#include "holo.h"

#ifndef CACHESIZE
#define CACHESIZE	16	/* default cache size (Mbytes, 0==inf) */
#endif
#ifndef FREEBEAMS
#define FREEBEAMS	512	/* maximum beams to free at a time */
#endif
#ifndef PCTFREE
#define PCTFREE		20	/* maximum fraction to free (%) */
#endif
#ifndef MAXFRAG
#define MAXFRAG		32767	/* maximum fragments/file to track (0==inf) */
#endif

#ifndef BSD
#define write	writebuf	/* safe i/o routines */
#define read	readbuf
#endif

#define FRAGBLK		256	/* number of fragments to allocate at a time */

unsigned	hdcachesize = CACHESIZE*1024*1024;	/* target cache size */
unsigned long	hdclock;	/* clock value */

HOLO	*hdlist[HDMAX+1];	/* holodeck pointers (NULL term.) */

static struct fraglist {
	short	nlinks;		/* number of holodeck sections using us */
	short	writerr;	/* write error encountered */
	int	nfrags;		/* number of known fragments */
	BEAMI	*fi;		/* fragments, descending file position */
	long	flen;		/* last known file length */
} *hdfragl;		/* fragment lists, indexed by file descriptor */

static int	nhdfragls;	/* size of hdfragl array */


hdattach(fd)		/* start tracking file fragments for some section */
register int	fd;
{
	if (fd >= nhdfragls) {
		if (nhdfragls)
			hdfragl = (struct fraglist *)realloc((char *)hdfragl,
					(fd+1)*sizeof(struct fraglist));
		else
			hdfragl = (struct fraglist *)malloc(
					(fd+1)*sizeof(struct fraglist));
		if (hdfragl == NULL)
			error(SYSTEM, "out of memory in hdattach");
		bzero((char *)(hdfragl+nhdfragls),
				(fd+1-nhdfragls)*sizeof(struct fraglist));
		nhdfragls = fd+1;
	}
	hdfragl[fd].nlinks++;
	hdfragl[fd].flen = lseek(fd, 0L, 2);	/* get file length */
}


/* Do we need a routine to locate file fragments given known occupants? */


hdrelease(fd)		/* stop tracking file fragments for some section */
register int	fd;
{
	if (fd < 0 | fd >= nhdfragls || !hdfragl[fd].nlinks)
		return;
	if (!--hdfragl[fd].nlinks && hdfragl[fd].nfrags) {
		free((char *)hdfragl[fd].fi);
		hdfragl[fd].fi = NULL;
		hdfragl[fd].nfrags = 0;
	}
}


markdirty(hp)			/* mark holodeck section directory dirty */
register HOLO	*hp;
{
	static BEAMI	smudge = {0, -1};

	if (hp->dirty)		/* already marked? */
		return;
	hp->dirty = 1;
	if (lseek(hp->fd, biglob(hp)->fo+(nbeams(hp)-1)*sizeof(BEAMI), 0) < 0
			|| write(hp->fd, (char *)&smudge,
					sizeof(BEAMI)) != sizeof(BEAMI))
		error(SYSTEM, "seek/write error in markdirty");
}


HOLO *
hdinit(fd, hproto)	/* initialize a holodeck section in a file */
int	fd;			/* corresponding file descriptor */
HDGRID	*hproto;		/* holodeck section grid */
{
	long	fpos;
	register HOLO	*hp;
	register int	n;
					/* prepare for system errors */
	errno = 0;
	if ((fpos = lseek(fd, 0L, 1)) < 0)
		error(SYSTEM, "cannot determine holodeck file position");
	if (hproto == NULL) {		/* assume we're loading it */
		HDGRID	hpr;
						/* load header */
		if (read(fd, (char *)&hpr, sizeof(HDGRID)) != sizeof(HDGRID))
			error(SYSTEM, "cannot load holodeck header");
						/* allocate grid */
		if ((hp = hdalloc(&hpr)) == NULL)
			goto memerr;
						/* load beam directory */
		n = nbeams(hp)*sizeof(BEAMI);
		if (read(fd, (char *)(hp->bi+1), n) != n)
			error(SYSTEM, "failure loading holodeck directory");
						/* check that it's clean */
		if (hp->bi[nbeams(hp)].fo < 0)
			error(USER, "dirty holodeck section");
	} else {			/* assume we're creating it */
		if ((hp = hdalloc(hproto)) == NULL)
			goto memerr;
						/* write header and skeleton */
		n = nbeams(hp)*sizeof(BEAMI);
		if (write(fd, (char *)hproto, sizeof(HDGRID)) !=
					sizeof(HDGRID) ||
				write(fd, (char *)(hp->bi+1), n) != n)
			error(SYSTEM, "cannot write header to holodeck file");
	}
	hp->fd = fd;	
	hp->dirty = 0;
	biglob(hp)->fo = fpos + sizeof(HDGRID);
					/* start tracking fragments */
	hdattach(fd);
					/* check rays on disk */
	fpos = hdfilen(fd);
	biglob(hp)->nrd = 0;
	for (n = hproto == NULL ? nbeams(hp) : 0; n > 0; n--)
		if (hp->bi[n].nrd)
			if (hp->bi[n].fo + hp->bi[n].nrd > fpos)
				hp->bi[n].nrd = 0;	/* off end */
			else
				biglob(hp)->nrd += hp->bi[n].nrd;
					/* add to holodeck list */
	for (n = 0; n < HDMAX; n++)
		if (hdlist[n] == NULL) {
			hdlist[n] = hp;
			break;
		}
					/* all done */
	return(hp);
memerr:
	error(SYSTEM, "cannot allocate holodeck grid");
}


int
hdsync(hp, all)			/* update beams and directory on disk */
register HOLO	*hp;
int	all;
{
	register int	j, n;

	if (hp == NULL) {		/* do all holodecks */
		n = 0;
		for (j = 0; hdlist[j] != NULL; j++)
			n += hdsync(hdlist[j], all);
		return(n);
	}
					/* sync the beams */
	for (j = (all ? nbeams(hp) : 0); j > 0; j--)
		if (hp->bl[j] != NULL)
			hdsyncbeam(hp, j);
	if (!hp->dirty)			/* directory clean? */
		return(0);
	errno = 0;
	if (lseek(hp->fd, biglob(hp)->fo, 0) < 0)
		error(SYSTEM, "cannot seek on holodeck file");
	n = nbeams(hp)*sizeof(BEAMI);
	if (write(hp->fd, (char *)(hp->bi+1), n) != n)
		error(SYSTEM, "cannot update holodeck section directory");
	hp->dirty = 0;
	return(1);
}


unsigned
hdmemuse(all)		/* return memory usage (in bytes) */
int	all;			/* include overhead (painful) */
{
	long	total = 0;
	register int	i, j;

	for (j = 0; hdlist[j] != NULL; j++) {
		total += blglob(hdlist[j])->nrm * sizeof(RAYVAL);
		if (all) {
			total += sizeof(HOLO) + sizeof(BEAM *) +
					nbeams(hdlist[j]) *
						(sizeof(BEAM *)+sizeof(BEAMI));
			for (i = nbeams(hdlist[j]); i > 0; i--)
				if (hdlist[j]->bl[i] != NULL)
					total += sizeof(BEAM);
		}
	}
	if (all)
		for (j = 0; j < nhdfragls; j++) {
			total += sizeof(struct fraglist);
			if (hdfragl[j].nfrags)
				total += FRAGBLK*sizeof(BEAMI) *
					((hdfragl[j].nfrags-1)/FRAGBLK + 1) ;
		}
	return(total);
}


long
hdfilen(fd)		/* return file length for fd */
int	fd;
{
	long	fpos, flen;

	if (fd < 0)
		return(-1);
	if (fd >= nhdfragls || !hdfragl[fd].nlinks) {
		if ((fpos = lseek(fd, 0L, 1)) < 0)
			return(-1);
		flen = lseek(fd, 0L, 2);
		lseek(fd, fpos, 0);
		return(flen);
	}
	return(hdfragl[fd].flen);
}


long
hdfiluse(fd, all)	/* compute file usage (in bytes) */
int	fd;			/* open file descriptor to check */
int	all;			/* include overhead and unflushed data */
{
	long	total = 0;
	register int	i, j;

	for (j = 0; hdlist[j] != NULL; j++) {
		if (hdlist[j]->fd != fd)
			continue;
		total += biglob(hdlist[j])->nrd * sizeof(RAYVAL);
		if (all) {
			for (i = nbeams(hdlist[j]); i > 0; i--)
				if (hdlist[j]->bl[i] != NULL)
					total += sizeof(RAYVAL) *
						(hdlist[j]->bl[i]->nrm -
						hdlist[j]->bi[i].nrd);
			total += sizeof(HDGRID) +
					nbeams(hdlist[j])*sizeof(BEAMI);
		}
	}
	return(total);		/* does not include fragments */
}


RAYVAL *
hdnewrays(hp, i, nr)	/* allocate space for add'l rays and return pointer */
register HOLO	*hp;
register int	i;
int	nr;			/* number of new rays desired */
{
	RAYVAL	*p;
	int	n;

	if (nr <= 0)
		return(NULL);
	if (i < 1 | i > nbeams(hp))
		error(CONSISTENCY, "bad beam index given to hdnewrays");
	if (hp->bl[i] != NULL)
		hp->bl[i]->tick = hdclock;	/* preempt swap */
	if (hdcachesize > 0 && hdmemuse(0) >= hdcachesize)
		hdfreecache(PCTFREE, NULL);	/* free some space */
	errno = 0;
	if (hp->bl[i] == NULL) {		/* allocate (and load) */
		n = hp->bi[i].nrd + nr;
		if ((hp->bl[i] = (BEAM *)malloc(hdbsiz(n))) == NULL)
			goto memerr;
		blglob(hp)->nrm += n;
		if (n = hp->bl[i]->nrm = hp->bi[i].nrd) {
			if (lseek(hp->fd, hp->bi[i].fo, 0) < 0)
				error(SYSTEM, "seek error on holodeck file");
			n *= sizeof(RAYVAL);
			if (read(hp->fd, (char *)hdbray(hp->bl[i]), n) != n)
				error(SYSTEM,
				"error reading beam from holodeck file");
		}
	} else {				/* just grow in memory */
		hp->bl[i] = (BEAM *)realloc( (char *)hp->bl[i],
				hdbsiz(hp->bl[i]->nrm + nr) );
		if (hp->bl[i] == NULL)
			goto memerr;
		blglob(hp)->nrm += nr;
	}
	p = hdbray(hp->bl[i]) + hp->bl[i]->nrm;
	hp->bl[i]->nrm += nr;			/* update in-core structure */
	bzero((char *)p, nr*sizeof(RAYVAL));
	hp->bl[i]->tick = hdclock;		/* update LRU clock */
	blglob(hp)->tick = hdclock++;
	return(p);				/* point to new rays */
memerr:
	error(SYSTEM, "out of memory in hdnewrays");
}


BEAM *
hdgetbeam(hp, i)	/* get beam (from file if necessary) */
register HOLO	*hp;
register int	i;
{
	register int	n;

	if (i < 1 | i > nbeams(hp))
		error(CONSISTENCY, "bad beam index given to hdgetbeam");
	if (hp->bl[i] == NULL) {		/* load from disk */
		if (!(n = hp->bi[i].nrd))
			return(NULL);
		if (hdcachesize > 0 && hdmemuse(0) >= hdcachesize)
			hdfreecache(PCTFREE, NULL);	/* get free space */
		errno = 0;
		if ((hp->bl[i] = (BEAM *)malloc(hdbsiz(n))) == NULL)
			error(SYSTEM, "cannot allocate memory for beam");
		blglob(hp)->nrm += hp->bl[i]->nrm = n;
		if (lseek(hp->fd, hp->bi[i].fo, 0) < 0)
			error(SYSTEM, "seek error on holodeck file");
		n *= sizeof(RAYVAL);
		if (read(hp->fd, (char *)hdbray(hp->bl[i]), n) != n)
			error(SYSTEM, "error reading beam from holodeck file");
	}
	hp->bl[i]->tick = hdclock;	/* update LRU clock */
	blglob(hp)->tick = hdclock++;
	return(hp->bl[i]);
}


int
hdfilord(hb1, hb2)	/* order beams for quick loading */
register HDBEAMI	*hb1, *hb2;
{
	register long	c;
				/* residents go first */
	if (hb2->h->bl[hb2->b] != NULL)
		return(hb1->h->bl[hb1->b] == NULL);
	if (hb1->h->bl[hb1->b] != NULL)
		return(-1);
				/* otherwise sort by file descriptor */
	if ((c = hb1->h->fd - hb2->h->fd))
		return(c);
				/* then by position in file */
	c = hb1->h->bi[hb1->b].fo - hb2->h->bi[hb2->b].fo;
	return(c > 0 ? 1 : c < 0 ? -1 : 0);
}


hdloadbeams(hb, n, bf)	/* load a list of beams in optimal order */
register HDBEAMI	*hb;	/* list gets sorted by hdfilord() */
int	n;			/* list length */
int	(*bf)();		/* callback function (optional) */
{
	unsigned	origcachesize, memuse;
	register BEAM	*bp;
	int	bytesloaded, needbytes, bytes2free;
	register int	i;
					/* precheck consistency */
	for (i = n; i--; )
		if (hb[i].h == NULL || hb[i].b < 1 | hb[i].b > nbeams(hb[i].h))
			error(CONSISTENCY, "bad beam in hdloadbeams");
					/* sort list for optimal access */
	qsort((char *)hb, n, sizeof(HDBEAMI), hdfilord);
	bytesloaded = 0;		/* run through loaded beams */
	for ( ; n && (bp = hb->h->bl[hb->b]) != NULL; n--, hb++) {
		bp->tick = hdclock;		/* preempt swap */
		bytesloaded += bp->nrm;
		if (bf != NULL)
			(*bf)(bp, hb->h, hb->b);
	}
	bytesloaded *= sizeof(RAYVAL);
	if ((origcachesize = hdcachesize) > 0) {
		needbytes = 0;		/* figure out memory needs */
		for (i = n; i--; )
			needbytes += hb[i].h->bi[hb[i].b].nrd;
		needbytes *= sizeof(RAYVAL);
		do {				/* free enough memory */
			memuse = hdmemuse(0);
			bytes2free = needbytes - (int)(hdcachesize-memuse);
			if (bytes2free > (int)(memuse - bytesloaded))
				bytes2free = memuse - bytesloaded;
		} while (bytes2free > 0 &&
				hdfreecache(100*bytes2free/memuse, NULL) < 0);
		hdcachesize = 0;		/* load beams w/o swap */
	}
	for (i = 0; i < n; i++)
		if ((bp = hdgetbeam(hb[i].h, hb[i].b)) != NULL && bf != NULL)
			(*bf)(bp, hb[i].h, hb[i].b);
	hdcachesize = origcachesize;	/* resume dynamic swapping */
}


hdfreefrag(fd, bi)			/* free a file fragment */
int	fd;
register BEAMI	*bi;
{
	register struct fraglist	*f;
	register int	j, k;

	if (bi->nrd == 0)
		return;
#ifdef DEBUG
	if (fd < 0 | fd >= nhdfragls || !hdfragl[fd].nlinks)
		error(CONSISTENCY, "bad file descriptor in hdfreefrag");
#endif
	f = &hdfragl[fd];
	if (f->nfrags % FRAGBLK == 0) {	/* delete empty remnants */
		for (j = k = 0; k < f->nfrags; j++, k++) {
			while (f->fi[k].nrd == 0)
				if (++k >= f->nfrags)
					goto endloop;
			if (k > j)
				copystruct(f->fi+j, f->fi+k);
		}
	endloop:
		f->nfrags = j;
	}
	j = f->nfrags++;		/* allocate a slot in free list */
#if MAXFRAG
	if (j >= MAXFRAG-1)
		f->nfrags--;
#endif
	if (j % FRAGBLK == 0) {		/* more free list space */
		if (f->fi == NULL)
			f->fi = (BEAMI *)malloc(FRAGBLK*sizeof(BEAMI));
		else
			f->fi = (BEAMI *)realloc((char *)f->fi,
					(j+FRAGBLK)*sizeof(BEAMI));
		if (f->fi == NULL)
			error(SYSTEM, "out of memory in hdfreefrag");
	}
	for ( ; ; j--) {		/* insert in descending list */
		if (!j || bi->fo < f->fi[j-1].fo) {
			f->fi[j].fo = bi->fo;
			f->fi[j].nrd = bi->nrd;
			break;
		}
		copystruct(f->fi+j, f->fi+(j-1));
	}
					/* coalesce adjacent fragments */
						/* successors never empty */
	if (j && f->fi[j-1].fo == f->fi[j].fo + f->fi[j].nrd*sizeof(RAYVAL)) {
		f->fi[j].nrd += f->fi[j-1].nrd;
		f->fi[j-1].nrd = 0;
	}
	for (k = j+1; k < f->nfrags; k++)	/* get non-empty predecessor */
		if (f->fi[k].nrd) {
			if (f->fi[j].fo == f->fi[k].fo +
					f->fi[k].nrd*sizeof(RAYVAL)) {
				f->fi[k].nrd += f->fi[j].nrd;
				f->fi[j].nrd = 0;
			}
			break;
		}
}


long
hdallocfrag(fd, nrays)		/* allocate a file fragment */
int	fd;
unsigned int4	nrays;
{
	register struct fraglist	*f;
	register int	j, k;
	long	nfo;

	if (nrays == 0)
		return(-1L);
#ifdef DEBUG
	if (fd < 0 | fd >= nhdfragls || !hdfragl[fd].nlinks)
		error(CONSISTENCY, "bad file descriptor in hdallocfrag");
#endif
	f = &hdfragl[fd];
	k = -1;				/* find closest-sized fragment */
	for (j = f->nfrags; j-- > 0; )
		if (f->fi[j].nrd >= nrays &&
				(k < 0 || f->fi[j].nrd < f->fi[k].nrd))
			if (f->fi[k=j].nrd == nrays)
				break;
	if (k < 0) {			/* no fragment -- extend file */
		nfo = f->flen;
		f->flen += nrays*sizeof(RAYVAL);
	} else {			/* else use fragment */
		nfo = f->fi[k].fo;
		f->fi[k].fo += nrays*sizeof(RAYVAL);
		f->fi[k].nrd -= nrays;
	}
	return(nfo);
}


int
hdsyncbeam(hp, i)		/* sync beam in memory with beam on disk */
register HOLO	*hp;
register int	i;
{
	unsigned int4	nrays;
	unsigned int	n;
	long	nfo;
					/* check file status */
	if (hdfragl[hp->fd].writerr)
		return(-1);
#ifdef DEBUG
	if (i < 1 | i > nbeams(hp))
		error(CONSISTENCY, "bad beam index in hdsyncbeam");
#endif
					/* is current fragment OK? */
	if (hp->bl[i] == NULL || (nrays = hp->bl[i]->nrm) == hp->bi[i].nrd)
		return(0);
	if (hp->bi[i].nrd)		/* relinquish old fragment */
		hdfreefrag(hp->fd, &hp->bi[i]);
	if (nrays) {			/* get and write new fragment */
		nfo = hdallocfrag(hp->fd, nrays);
		errno = 0;
		if (lseek(hp->fd, nfo, 0) < 0)
			error(SYSTEM, "cannot seek on holodeck file");
		n = hp->bl[i]->nrm * sizeof(RAYVAL);
		if (write(hp->fd, (char *)hdbray(hp->bl[i]), n) != n) {
			hdfragl[hp->fd].writerr++;
			hdsync(NULL, 0);	/* sync directories */
			error(SYSTEM, "write error in hdsyncbeam");
		}
		hp->bi[i].fo = nfo;
	} else
		hp->bi[i].fo = 0L;
	biglob(hp)->nrd += nrays - hp->bi[i].nrd;
	hp->bi[i].nrd = nrays;
	markdirty(hp);			/* section directory now out of date */
	return(1);
}


int
hdfreebeam(hp, i)		/* free beam, writing if dirty */
register HOLO	*hp;
register int	i;
{
	int	nchanged;

	if (hp == NULL) {		/* clear all holodecks */
		nchanged = 0;
		for (i = 0; hdlist[i] != NULL; i++)
			nchanged += hdfreebeam(hdlist[i], 0);
		return(nchanged);
	}
	if (hdfragl[hp->fd].writerr)	/* check for file error */
		return(0);
	if (i == 0) {			/* clear entire holodeck */
		nchanged = 0;
		for (i = nbeams(hp); i > 0; i--)
			if (hp->bl[i] != NULL)
				nchanged += hdfreebeam(hp, i);
		return(nchanged);
	}
#ifdef DEBUG
	if (i < 1 | i > nbeams(hp))
		error(CONSISTENCY, "bad beam index to hdfreebeam");
#endif
	if (hp->bl[i] == NULL)
		return(0);
					/* check for additions */
	nchanged = hp->bl[i]->nrm - hp->bi[i].nrd;
	if (nchanged)
		hdsyncbeam(hp, i);		/* write new fragment */
	blglob(hp)->nrm -= hp->bl[i]->nrm;
	free((char *)hp->bl[i]);		/* free memory */
	hp->bl[i] = NULL;
	return(nchanged);
}


int
hdkillbeam(hp, i)		/* delete beam from holodeck */
register HOLO	*hp;
register int	i;
{
	static BEAM	emptybeam;
	int	nchanged;

	if (hp == NULL) {		/* clobber all holodecks */
		nchanged = 0;
		for (i = 0; hdlist[i] != NULL; i++)
			nchanged += hdkillbeam(hdlist[i], 0);
		return(nchanged);
	}
	if (i == 0) {			/* clobber entire holodeck */
		nchanged = 0;
		for (i = nbeams(hp); i > 0; i--)
			if (hp->bi[i].nrd > 0 || hp->bl[i] != NULL)
				nchanged += hdkillbeam(hp, i);
#ifdef DEBUG
		if (biglob(hp)->nrd != 0 | blglob(hp)->nrm != 0)
			error(CONSISTENCY, "bad beam count in hdkillbeam");
#endif
		return(nchanged);
	}
#ifdef DEBUG
	if (i < 1 | i > nbeams(hp))
		error(CONSISTENCY, "bad beam index to hdkillbeam");
#endif
	if (hp->bl[i] != NULL) {	/* free memory */
		blglob(hp)->nrm -= nchanged = hp->bl[i]->nrm;
		free((char *)hp->bl[i]);
	} else
		nchanged = hp->bi[i].nrd;
	if (hp->bi[i].nrd) {		/* free file fragment */
		hp->bl[i] = &emptybeam;
		hdsyncbeam(hp, i);
	}
	hp->bl[i] = NULL;
	return(nchanged);
}


int
hdlrulist(hb, nents, n, hp)	/* add beams from holodeck to LRU list */
register HDBEAMI	*hb;		/* beam list */
int	nents;				/* current list length */
int	n;				/* maximum list length */
register HOLO	*hp;			/* section we're adding from */
{
	register int	i, j;
					/* insert each beam from hp */
	for (i = nbeams(hp); i > 0; i--) {
		if (hp->bl[i] == NULL)		/* check if loaded */
			continue;
#if 0
		if (hp->bl[i]->tick == hdclock)	/* preempt swap? */
			continue;
#endif
		if ((j = ++nents) >= n)		/* grow list if we can */
			nents--;
		for ( ; ; ) {			/* bubble into place */
			if (!--j || hp->bl[i]->tick >=
					hb[j-1].h->bl[hb[j-1].b]->tick) {
				hb[j].h = hp;
				hb[j].b = i;
				break;
			}
			copystruct(hb+j, hb+(j-1));
		}
	}
	return(nents);			/* return new list length */
}


int
hdfreecache(pct, honly)		/* free up cache space, writing changes */
int	pct;				/* maximum percentage to free */
register HOLO	*honly;			/* NULL means check all */
{
	HDBEAMI	hb[FREEBEAMS];
	int	freetarget;
	int	n;
	register int	i;
						/* compute free target */
	freetarget = (honly != NULL) ? blglob(honly)->nrm :
			hdmemuse(0)/sizeof(RAYVAL) ;
	freetarget = freetarget*pct/100;
	if (freetarget <= 0)
		return(0);
						/* find least recently used */
	n = 0;
	if (honly != NULL)
		n = hdlrulist(hb, n, FREEBEAMS, honly);
	else
		for (i = 0; hdlist[i] != NULL; i++)
			n = hdlrulist(hb, n, FREEBEAMS, hdlist[i]);
						/* free LRU beams */
	for (i = 0; i < n; i++) {
		hdfreebeam(hb[i].h, hb[i].b);
		if ((freetarget -= hb[i].h->bi[hb[i].b].nrd) <= 0)
			break;
	}
	hdsync(honly, 0);	/* synchronize directories as necessary */
	return(-freetarget);	/* return how far past goal we went */
}


hddone(hp)		/* clean up holodeck section and free */
register HOLO	*hp;		/* NULL means clean up all */
{
	register int	i;

	if (hp == NULL) {		/* NULL means clean up everything */
		while (hdlist[0] != NULL)
			hddone(hdlist[0]);
		return;
	}
					/* flush all data and free memory */
	hdflush(hp);
					/* release fragment resources */
	hdrelease(hp->fd);
					/* remove hp from active list */
	for (i = 0; hdlist[i] != NULL; i++)
		if (hdlist[i] == hp) {
			while ((hdlist[i] = hdlist[i+1]) != NULL)
				i++;
			break;
		}
	free((char *)hp->bl);		/* free beam list */
	free((char *)hp);		/* free holodeck struct */
}