Loading...
gen/stack_logging_disk.c Libc-498 /dev/null
--- Libc/Libc-498/gen/stack_logging_disk.c
+++ /dev/null
@@ -1,1674 +0,0 @@
-/*
- * Copyright (c) 2007 Apple Inc. All rights reserved.
- *
- * @APPLE_LICENSE_HEADER_START@
- * 
- * This file contains Original Code and/or Modifications of Original Code
- * as defined in and that are subject to the Apple Public Source License
- * Version 2.0 (the 'License'). You may not use this file except in
- * compliance with the License. Please obtain a copy of the License at
- * http://www.opensource.apple.com/apsl/ and read it before using this
- * file.
- * 
- * The Original Code and all software distributed under the License are
- * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
- * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
- * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
- * Please see the License for the specific language governing rights and
- * limitations under the License.
- * 
- * @APPLE_LICENSE_HEADER_END@
- */
-
-#include <stdio.h>
-#include <stdlib.h>
-#include <string.h>
-#include <limits.h>
-#include <unistd.h>
-#include <fcntl.h>
-#include <dirent.h>
-#include <libkern/OSAtomic.h>
-#include <mach/mach.h>
-#include <mach/mach_vm.h>
-#include <sys/sysctl.h>
-#include <sys/stat.h>
-#include <sys/mman.h>
-#include <pthread.h>
-#include <errno.h>
-#include "stack_logging.h"
-#include "malloc_printf.h"
-#include "_simple.h"		// as included by malloc.c, this defines ASL_LEVEL_INFO
-
-#pragma mark -
-#pragma mark Defines
-
-#ifdef TEST_DISK_STACK_LOGGING
-#define _malloc_printf fprintf
-#undef ASL_LEVEL_INFO
-#define ASL_LEVEL_INFO stderr
-#endif
-
-#define STACK_LOGGING_THREAD_HASH_SIZE 2048 // must be an even power of two
-#define STACK_LOGGING_MAX_STACK_SIZE 512
-#define STACK_LOGGING_BLOCK_WRITING_SIZE 8192
-#define STACK_LOGGING_NUMBER_RECENT_BACKTRACES 50
-#define STACK_LOGGING_FORCE_FULL_BACKTRACE_EVERY 100
-#define STACK_LOGGING_MAX_THREAD_COLLISIONS 3
-#define STACK_LOGGING_MIN_SAME_FRAMES 3
-#define STACK_LOGGING_MAX_SIMUL_REMOTE_TASKS_INSPECTED 3
-#define STACK_LOGGING_REMOTE_CACHE_DEFAULT_COLLISION_ALLOWANCE 5
-#define STACK_LOGGING_REMOTE_CACHE_DEFAULT_NODE_CAPACITY 1 << 14 // <2mb for 32->32, ~3mb for (32->64 || 64->32), ~4mb for 64->64
-#define STACK_LOGGING_REMOTE_CACHE_COLLISION_GROWTH_RATE 3
-#define STACK_LOGGING_REMOTE_LINKS_PER_BLOCK (1 << 20) // this sets a maximum number of malloc/frees that can be read in to: 1^30;
-							// this means if the .index file is >24gb, remote access will start to fail.
-							// note: at this point, the .stack file will probably be ~56gb on top of that and
-							// it'll also be using around 20 gb of memory in the analyzing process...
-							// all of these are 64-bit stats; the 32-bit analyzing process limits are lower.
-							// in short, if you want to analyze a process making > 1 billion malloc/frees 
-							// (after compaction), bump this number slightly.
-
-#pragma mark -
-#pragma mark Macros
-
-#define STACK_LOGGING_FLAGS(longlongvar) (uint8_t)((uint64_t)(longlongvar) >> 56)
-#define STACK_LOGGING_OFFSET(longlongvar) ((longlongvar) & 0x00FFFFFFFFFFFFFFull)
-#define STACK_LOGGING_OFFSET_AND_FLAGS(longlongvar, realshortvar) (((uint64_t)(longlongvar) & 0x00FFFFFFFFFFFFFFull) | ((uint64_t)(realshortvar) << 56))
-
-#pragma mark -
-#pragma mark Types
-
-#pragma mark - stack_logging_backtrace_event
-typedef struct {
-	int16_t		offset_delta; // may want to expand this one; should always be < 0.
-	uint16_t	num_identical_frames;
-	uint16_t	num_new_hot_frames; // count of backtrace[]
-} stack_logging_backtrace_event;
-
-#pragma mark - stack_logging_index_event
-typedef struct {
-	uintptr_t	argument;
-	uintptr_t	address;
-	uint64_t	offset_and_flags; // top 8 bits are actually the flags!
-} stack_logging_index_event;
-
-#pragma mark - stack_logging_index_event32
-typedef struct {
-	uint32_t	argument;
-	uint32_t	address;
-	uint64_t	offset_and_flags; // top 8 bits are actually the flags!
-} stack_logging_index_event32;
-
-#pragma mark - stack_logging_index_event64
-typedef struct {
-	uint64_t	argument;
-	uint64_t	address;
-	uint64_t	offset_and_flags; // top 8 bits are actually the flags!
-} stack_logging_index_event64;
-
-#pragma mark - thread_backtrace_history
-// for management of previous backtraces (by thread):
-typedef struct {
-	vm_address_t		thread;
-	uint32_t			hash_pos;
-	uint64_t		logging_index;
-	int64_t			logging_offset;
-	uint32_t		full_backtrace_countdown;
-	uint32_t		backtrace_length;
-	uintptr_t		*backtrace;
-} thread_backtrace_history;
-
-#pragma mark - stack_buffer_shared_memory
-// for storing/looking up allocations that haven't yet be written to disk; consistent size across 32/64-bit processes.
-// It's important that these fields don't change alignment due to the architecture because they may be accessed from an
-// analyzing process with a different arch - hence the pragmas.
-#pragma pack(push,4)
-typedef struct {
-	uint64_t		start_index_offset;
-	uint64_t		start_stack_offset;
-	uint32_t		next_free_index_buffer_offset;
-	uint32_t		next_free_stack_buffer_offset;
-	char			index_buffer[STACK_LOGGING_BLOCK_WRITING_SIZE];
-	char			stack_buffer[STACK_LOGGING_BLOCK_WRITING_SIZE];
-} stack_buffer_shared_memory;
-#pragma pack(pop)
-
-#pragma mark - index_ll_node
-// linked-list node in table for allocations of a single address
-typedef struct index_ll_node {
-	struct index_ll_node	*next;
-	uint64_t		index_file_offset;
-} index_ll_node;
-
-#pragma mark - remote_index_node32
-// 32-bit target process address slot in table
-typedef struct {
-	uint32_t		address;
-	index_ll_node		*linked_list;
-	index_ll_node		*last_link;
-} remote_index_node32;
-
-#pragma mark - remote_index_node64
-// 64-bit target process variant
-typedef struct {
-	uint64_t		address;
-	index_ll_node		*linked_list;
-	index_ll_node		*last_link;
-} remote_index_node64;
-
-#pragma mark - remote_index_cache
-// for caching index information client-side:
-typedef struct {
-	size_t			cache_size;
-	size_t			cache_node_capacity;
-	uint32_t		collision_allowance;
-	uint64_t		cache_node_count; // Debug only.
-	uint64_t		cache_llnode_count; // Debug only.
-	size_t			in_use_node_size; // sizeof(remote_index_node32) || sizeof(remote_index_node64)
-	void			*table_memory; // this can be malloced; it's on the client side.
-	remote_index_node32	*casted_table32; // represents table memory as 32-bit.
-	remote_index_node64	*casted_table64; // ditto, 64-bit
-	stack_buffer_shared_memory *shmem; // shared memory
-	stack_buffer_shared_memory snapshot; // memory snapshot of the remote process' shared memory
-	uint32_t		last_pre_written_index_size;
-	uint64_t		last_index_file_offset;
-	index_ll_node		*blocks[1024];
-	uint32_t		current_block;
-	uint32_t		next_block_index;
-} remote_index_cache;
-
-#pragma mark - remote_task_file_streams
-// for reading stack history information from remote processes:
-typedef struct {
-	task_t			remote_task;
-	pid_t			remote_pid;
-	int32_t			task_is_64_bit;
-	int32_t			in_use_count;
-	FILE			*index_file_stream;
-	FILE			*stack_file_stream;
-	remote_index_cache	*cache;
-} remote_task_file_streams;
-
-#pragma mark -
-#pragma mark Constants
-
-static stack_buffer_shared_memory *pre_write_buffers;
-static char *pre_write_backtrace_event_buffer = NULL;
-static char *pre_write_index_buffer = NULL;
-
-static OSSpinLock stack_logging_lock = OS_SPINLOCK_INIT;
-static uint64_t current_logging_index = 0;
-static int64_t total_offset = 0;
-
-// single-thread access variables
-static vm_address_t stack_buffer[STACK_LOGGING_NUMBER_RECENT_BACKTRACES][STACK_LOGGING_MAX_STACK_SIZE];
-static thread_backtrace_history thread_buffer[STACK_LOGGING_THREAD_HASH_SIZE];
-static int32_t current_stack_buffer = 0;
-static uintptr_t last_logged_malloc_address = 0;
-static uint32_t last_logged_backtrace_offset_diff = 0;
-static thread_backtrace_history compaction_saved_differencing_history;
-
-// Constants to define stack logging directory and path names.
-// Files will get written to /tmp/stack-logs.<pid>.<progname>.XXXXXX/stack-logs.{index,stacks}
-// The directory is securely created with mkdtemp() and the files inside it just have static names for simplicity.
-static const char *temporary_directory = "/tmp";
-static const char *stack_logging_directory_base_name = "stack-logs.";
-static const char *index_file_name = "stack-logs.index";
-static const char *stack_file_name = "stack-logs.stacks";
-
-static char stack_logs_directory[PATH_MAX];
-static char index_file_path[PATH_MAX];
-static char stack_file_path[PATH_MAX];
-static int index_file_descriptor = -1;
-static int stack_file_descriptor = -1;
-
-// for accessing remote log files
-static remote_task_file_streams remote_fds[STACK_LOGGING_MAX_SIMUL_REMOTE_TASKS_INSPECTED];
-static uint32_t next_remote_task_fd = 0;
-static uint32_t remote_task_fd_count = 0;
-static OSSpinLock remote_fd_list_lock = OS_SPINLOCK_INIT;
-
-// activation variables
-
-static int logging_use_compaction = 1; // set this to zero to always disable compaction.
-
-// We set malloc_logger to NULL to disable logging, if we encounter errors
-// during file writing
-typedef void (malloc_logger_t)(uint32_t type, uintptr_t arg1, uintptr_t arg2, uintptr_t arg3, uintptr_t result, uint32_t num_hot_frames_to_skip);
-extern malloc_logger_t *malloc_logger;
-
-#pragma mark -
-#pragma mark Disk Stack Logging
-
-static void delete_log_files(void);		// pre-declare
-
-static void
-append_int(char * filename, pid_t pid)
-{
-	unsigned int value;
-	size_t len;
-	unsigned int i;
-	unsigned int count;
-	
-	len = strlen(filename);
-	
-	count = 0;
-	value = pid;
-	while (value > 0) {
-		value /= 10;
-		count ++;
-	}
-	
-	filename[len + count] = 0;
-	
-	value = pid;
-	for(i = 0 ; i < count ; i ++) {
-		filename[len + count - 1 - i] = '0' + value % 10;
-		value /= 10;
-	}
-}
-
-// If successful, returns path to directory that was created.  Otherwise returns NULL.
-static char *
-create_log_files(void)
-{
-	pid_t pid = getpid();
-	const char *progname = getprogname();
-	char path_name[PATH_MAX];
-	char *created_directory = NULL;
-
-	// WARNING! use of snprintf can induce malloc() calls 
-	strlcpy(stack_logs_directory, temporary_directory, PATH_MAX);
-	strlcat(stack_logs_directory, "/", PATH_MAX);
-	strlcat(stack_logs_directory, stack_logging_directory_base_name, PATH_MAX);
-	append_int(stack_logs_directory, pid);
-	if (progname && progname[0] != '\0') {
-		strlcat(stack_logs_directory, ".", PATH_MAX);
-		strlcat(stack_logs_directory, progname, PATH_MAX);
-	}
-	strlcat(stack_logs_directory, ".XXXXXX", PATH_MAX);
-
-	// Securely make temporary directory for the log files, then create the files.
-	if (mkdtemp(stack_logs_directory) == stack_logs_directory) {
-		strlcpy(path_name, stack_logs_directory, PATH_MAX);
-		strlcat(path_name, "/", PATH_MAX);
-		strlcat(path_name, index_file_name, PATH_MAX);
-		strlcpy(index_file_path, path_name, PATH_MAX);
-		index_file_descriptor = open(path_name, O_WRONLY | O_TRUNC | O_CREAT, 0600);
-
-		strlcpy(path_name, stack_logs_directory, PATH_MAX);
-		strlcat(path_name, "/", PATH_MAX);
-		strlcat(path_name, stack_file_name, PATH_MAX);
-		strlcpy(stack_file_path, path_name, PATH_MAX);
-		stack_file_descriptor = open(path_name, O_WRONLY | O_TRUNC | O_CREAT, 0600);
-
-		if (index_file_descriptor == -1 || stack_file_descriptor == -1) {
-			_malloc_printf(ASL_LEVEL_INFO, "unable to create stack log files in directory %s\n", stack_logs_directory);
-			delete_log_files();
-			created_directory = NULL;
-		} else {
-			_malloc_printf(ASL_LEVEL_INFO, "stack logs being written into %s\n", stack_logs_directory);
-			created_directory = stack_logs_directory;
-		}
-	} else {
-		_malloc_printf(ASL_LEVEL_INFO, "unable to create stack log directory %s\n", stack_logs_directory);
-		created_directory = NULL;
-	}
-	return created_directory;
-}
-
-// This function may be called from either the target process when exiting, or from either the the target process or 
-// a stack log analysis process, when reaping orphaned stack log files.
-// Returns -1 if the files exist and they couldn't be removed, returns 0 otherwise.
-static int
-delete_log_files_in_directory(char *logdir)
-{
-	char path_name[PATH_MAX];
-	int unlink_count = 0;
-	int failure_count = 0;
-	struct stat statbuf;
-
-	if (logdir == NULL || logdir[0] == '\0') return 0;
-
-	strlcpy(path_name, logdir, PATH_MAX);
-	strlcat(path_name, "/", PATH_MAX);
-	strlcat(path_name, index_file_name, PATH_MAX);
-	if (unlink(path_name) == 0) {
-		unlink_count++;
-	} else if (stat(path_name, &statbuf) == 0) {
-		failure_count++;
-	}
-
-	strlcpy(path_name, logdir, PATH_MAX);
-	strlcat(path_name, "/", PATH_MAX);
-	strlcat(path_name, stack_file_name, PATH_MAX);
-	if (unlink(path_name) == 0) {
-		unlink_count++;
-	} else if (stat(path_name, &statbuf) == 0) {
-		failure_count++;
-	}
-
-	if (rmdir(logdir) == -1) failure_count++;
-
-	return (failure_count > 0) ? -1 : 0;
-}
-
-// This function will be called from atexit() in the target process.
-static void
-delete_log_files(void)
-{
-	if (stack_logs_directory == NULL || stack_logs_directory[0] == '\0') return;
-
-	if (delete_log_files_in_directory(stack_logs_directory) == 0) {
-		_malloc_printf(ASL_LEVEL_INFO, "stack logs deleted from %s\n", stack_logs_directory);
-		stack_file_path[0] = '\0';
-		index_file_path[0] = '\0';
-	} else {
-		_malloc_printf(ASL_LEVEL_INFO, "unable to delete stack logs from %s\n", stack_logs_directory);
-	}
-}
-
-static bool
-is_process_running(pid_t pid)
-{
-	struct kinfo_proc kpt[1];
-	size_t size = sizeof(struct kinfo_proc);
-	int mib[] = {CTL_KERN, KERN_PROC, KERN_PROC_PID, pid};
-
-	sysctl(mib, 4, kpt, &size, NULL, 0); // size is either 1 or 0 entries when we ask for a single pid
-    
-	return (size==sizeof(struct kinfo_proc));
-}
-
-// The log files can be quite large and aren't too useful after the process that created them no longer exists.
-// Normally they should get removed when the process exits, but if the process crashed the log files might remain.
-// So, reap any stack log files for processes that no longer exist.
-//
-// lf the remove_for_this_pid flag is set, then any log files that already exist for the current process will also be deleted.
-// Those log files are probably the result of this process having been exec'ed from another one (without a fork()).
-// The remove_for_this_pid flag is only set for a target process (one just starting logging);  a stack logging "client"
-// process reaps log files too, but if we're using stack logging on the client process itself, then we don't want to remove
-// its own log files.
-static void
-reap_orphaned_log_files(bool remove_for_this_pid)
-{
-	DIR *dp;
-	struct dirent *entry;
-	int prefix_length;
-	char prefix_name[PATH_MAX];
-	char pathname[PATH_MAX];
-	pid_t current_pid = getpid();
-
-	if ((dp = opendir(temporary_directory)) == NULL) {
-		return;
-	}
-
-	strlcpy(prefix_name, stack_logging_directory_base_name, PATH_MAX);
-	prefix_length = strlen(prefix_name);
-
-	while ( (entry = readdir(dp)) != NULL ) {
-		if ( entry->d_type == DT_DIR && ( strncmp( entry->d_name, prefix_name, prefix_length) == 0 ) ) {
-			long pid = strtol(&entry->d_name[prefix_length], (char **)NULL, 10);
-			if ( (! is_process_running(pid)) || (remove_for_this_pid && pid == current_pid) ) {
-				strlcpy(pathname, temporary_directory, PATH_MAX);
-				strlcat(pathname, "/", PATH_MAX);
-				strlcat(pathname, entry->d_name, PATH_MAX);
-				if (delete_log_files_in_directory(pathname) == 0) {
-					if (remove_for_this_pid && pid == current_pid) {
-						_malloc_printf(ASL_LEVEL_INFO, "stack logs deleted from %s\n", pathname);
-					} else {
-						_malloc_printf(ASL_LEVEL_INFO, "process %d no longer exists, stack logs deleted from %s\n", pid, pathname);
-					}
-				}
-			}
-		}
-	}
-	closedir(dp);
-}	
-
-/*
- * Since there a many errors that could cause stack logging to get disabled, this is a convenience method
- * for disabling any future logging in this process and for informing the user.
- */
-static void
-disable_stack_logging(void)
-{	
-	_malloc_printf(ASL_LEVEL_INFO, "stack logging disabled due to previous errors.\n");
-	stack_logging_enable_logging = 0;
-	malloc_logger = NULL;
-}
-
-/* A wrapper around write() that will try to reopen the index/stack file and
- * write to it if someone closed it underneath us (e.g. the process we just
- * started decide to close all file descriptors except stin/err/out). Some
- * programs like to do that and calling abort() on them is rude.
- */
-static ssize_t
-robust_write(int fd, const void *buf, size_t nbyte) {
-	extern int errno;
-	ssize_t written = write(fd, buf, nbyte);
-	if (written == -1 && errno == EBADF) {
-		char *file_to_reopen = NULL;
-		int *fd_to_reset = NULL;
-
-		// descriptor was closed on us. We need to reopen it
-		if (fd == index_file_descriptor) {
-			file_to_reopen = index_file_path;
-			fd_to_reset = &index_file_descriptor;
-		}
-		else if (fd == stack_file_descriptor) {
-			file_to_reopen = stack_file_path;
-			fd_to_reset = &stack_file_descriptor;
-		} else {
-			// We don't know about this file. Return (and abort()).
-			_malloc_printf(ASL_LEVEL_INFO, "Unknown file descriptor (it's neither the index file, nor the stacks file)\n");
-			return -1;
-		}
-
-		// The file *should* already exist. If not, fail.
-		fd = open(file_to_reopen, O_WRONLY | O_APPEND);
-		if (fd < 3) {
-			// If we somehow got stdin/out/err, we need to relinquish them and
-			// get another fd.
-			int fds_to_close[3] = { 0 };
-			while (fd < 3) {
-				if (fd == -1) {
-					_malloc_printf(ASL_LEVEL_INFO, "unable to re-open stack log file %s\n", file_to_reopen);
-					delete_log_files();
-					return -1;
-				}
-				fds_to_close[fd] = 1;
-				fd = dup(fd);
-			}
-
-			// We have an fd we like. Close the ones we opened.
-			if (fds_to_close[0]) close(0);
-			if (fds_to_close[1]) close(1);
-			if (fds_to_close[2]) close(2);
-		}
-
-		*fd_to_reset = fd;
-		written = write(fd, buf, nbyte);
-	}
-	return written;
-}
-
-static void
-flush_data(void)
-{
-	ssize_t written; // signed size_t
-	size_t remaining;
-	char * p;
-	
-	if (index_file_descriptor == -1) {
-		if (create_log_files() == NULL) {
-			return;
-		}
-	}
-	
-	// Write the events before the index so that hopefully the events will be on disk if the index refers to them.
-	p = pre_write_backtrace_event_buffer;
-	remaining = (size_t)pre_write_buffers->next_free_stack_buffer_offset;
-	while (remaining > 0) {
-		written = robust_write(stack_file_descriptor, p, remaining);
-		if (written == -1) {
-			_malloc_printf(ASL_LEVEL_INFO, "Unable to write to stack logging file %s (%s)\n", stack_file_path, strerror(errno));
-			disable_stack_logging();
-			return;
-		}
-		p += written;
-		remaining -= written;
-	}
-	p = pre_write_index_buffer;
-	remaining = (size_t)pre_write_buffers->next_free_index_buffer_offset;
-	while (remaining > 0) {
-		written = robust_write(index_file_descriptor, p, remaining);
-		if (written == -1) {
-			_malloc_printf(ASL_LEVEL_INFO, "Unable to write to stack logging file %s (%s)\n", index_file_path, strerror(errno));
-			disable_stack_logging();
-			return;
-		}
-		p += written;
-		remaining -= written;
-	}
-	
-	pre_write_buffers->start_stack_offset += pre_write_buffers->next_free_stack_buffer_offset;
-	pre_write_buffers->start_index_offset += pre_write_buffers->next_free_index_buffer_offset;
-	pre_write_buffers->next_free_index_buffer_offset = pre_write_buffers->next_free_stack_buffer_offset = 0;
-}
-
-static void
-prepare_to_log_stacks(void)
-{
-	if (!pre_write_buffers) {
-		last_logged_malloc_address = 0ul;
-		logging_use_compaction = (stack_logging_dontcompact ? 0 : logging_use_compaction);
-		
-		// Create a shared memory region to hold the pre-write index and stack buffers. This will allow remote analysis processes to access
-		// these buffers to get logs for even the most recent allocations. The remote process will need to pause this process to assure that
-		// the contents of these buffers don't change while being inspected.
-		char shmem_name_string[PATH_MAX];
-		strlcpy(shmem_name_string, stack_logging_directory_base_name, (size_t)PATH_MAX);
-		append_int(shmem_name_string, getpid());
-		
-		int shmid = shm_open(shmem_name_string, O_RDWR | O_CREAT, S_IRUSR | S_IWUSR);
-		if (shmid < 0) {
-			// Failed to create shared memory region; turn off stack logging.
-			_malloc_printf(ASL_LEVEL_INFO, "error while allocating shared memory for disk-based stack logging output buffers\n");
-			disable_stack_logging();
-			return;
-		}
-		
-		size_t full_shared_mem_size = sizeof(stack_buffer_shared_memory);
-		ftruncate(shmid, (off_t)full_shared_mem_size);
-		pre_write_buffers = (stack_buffer_shared_memory*)mmap(0, full_shared_mem_size, PROT_READ | PROT_WRITE, MAP_SHARED, shmid, (off_t)0);
-		close(shmid);
-		
-		if (!pre_write_buffers) {
-			_malloc_printf(ASL_LEVEL_INFO, "error mapping in shared memory for disk-based stack logging output buffers\n");
-			disable_stack_logging();
-			return;
-		}
-		
-		// Store and use the buffer offsets in shared memory so that they can be accessed remotely
-		pre_write_buffers->start_index_offset = pre_write_buffers->start_stack_offset = 0ull;
-		pre_write_buffers->next_free_index_buffer_offset = pre_write_buffers->next_free_stack_buffer_offset = 0;
-		pre_write_backtrace_event_buffer = pre_write_buffers->stack_buffer;
-		pre_write_index_buffer = pre_write_buffers->index_buffer;
-		
-		// malloc() can be called by the following, so these need to be done outside the stack_logging_lock but after the buffers have been set up.
-		atexit(delete_log_files);		// atexit() can call malloc()
-		reap_orphaned_log_files(true);		// this calls opendir() which calls malloc()
-		
-		// this call to flush data ensures that the log files (while possibly empty) exist; analyzing processes will rely on this assumption.
-		flush_data();
-	}
-}
-
-void
-__disk_stack_logging_log_stack(uint32_t type_flags, uintptr_t zone_ptr, uintptr_t size, uintptr_t ptr_arg, uintptr_t return_val, uint32_t num_hot_to_skip)
-{
-	if (!stack_logging_enable_logging) return;
-	
-	// check incoming data
-	if (type_flags & stack_logging_type_alloc && type_flags & stack_logging_type_dealloc) {
-		uintptr_t swapper = size;
-		size = ptr_arg;
-		ptr_arg = swapper;
-		if (ptr_arg == return_val) return; // realloc had no effect, skipping
-		
-		if (ptr_arg == 0) { // realloc(NULL, size) same as malloc(size)
-			type_flags ^= stack_logging_type_dealloc;
-		} else {
-			// realloc(arg1, arg2) -> result is same as free(arg1); malloc(arg2) -> result
-			__disk_stack_logging_log_stack(stack_logging_type_dealloc, zone_ptr, ptr_arg, (uintptr_t)0, (uintptr_t)0, num_hot_to_skip + 1);
-			__disk_stack_logging_log_stack(stack_logging_type_alloc, zone_ptr, size, (uintptr_t)0, return_val, num_hot_to_skip + 1);
-			return;
-		}
-	}
-	if (type_flags & stack_logging_type_dealloc) {
-		if (size) {
-			ptr_arg = size;
-			size = 0;
-		} else return; // free(nil)
-	}
-	if (type_flags & stack_logging_type_alloc && return_val == 0) return; // alloc that failed
-	
-	type_flags &= 0x7;
-	
-	// now actually begin
-	prepare_to_log_stacks();
-
-	// since there could have been a fatal (to stack logging) error such as the log files not being created, check this variable before continuing
-	if (!stack_logging_enable_logging) return;
-	vm_address_t self_thread = (vm_address_t)pthread_self();	// use pthread_self() rather than mach_thread_self() to avoid system call
-	
-	// lock and enter
-	OSSpinLockLock(&stack_logging_lock);
-	
-	// compaction
-	if (last_logged_malloc_address && (type_flags & stack_logging_type_dealloc) && STACK_LOGGING_DISGUISE(ptr_arg) == last_logged_malloc_address) {
-		// *waves hand* the last allocation never occurred
-		pre_write_buffers->next_free_index_buffer_offset -= (uint32_t)sizeof(stack_logging_index_event);
-		pre_write_buffers->next_free_stack_buffer_offset -= last_logged_backtrace_offset_diff;
-		total_offset -= (int64_t)last_logged_backtrace_offset_diff;
-		last_logged_malloc_address = 0ul;
-		
-		// not going to subtract from the current_stack_buffer or current_logging_index indecies; 
-		// there is no intention to restore the previously held stack. the differencing history
-		// must be reset to its previous value, though.
-		thread_buffer[compaction_saved_differencing_history.hash_pos] = compaction_saved_differencing_history;
-		
-		OSSpinLockUnlock(&stack_logging_lock);
-		return;
-	}
-		
-	// locate previous backtrace for this thread
-	short difference = 1;
-	
-	uint32_t collisions = STACK_LOGGING_MAX_THREAD_COLLISIONS;
-	uint32_t hashed_thread = self_thread & (STACK_LOGGING_THREAD_HASH_SIZE-1);
-	while (thread_buffer[hashed_thread].thread && thread_buffer[hashed_thread].thread != self_thread) {
-		if (--collisions == 0) {
-			difference = 0;
-			break;
-		}
-		hashed_thread++;
-	}
-	
-	// gather stack
-	uint32_t count;
-	thread_stack_pcs(stack_buffer[current_stack_buffer], STACK_LOGGING_MAX_STACK_SIZE, &count);
-	stack_buffer[current_stack_buffer][count++] = self_thread + 1;		// stuffing thread # in the coldest slot.  Add 1 to match what the old stack logging did.
-	num_hot_to_skip += 2;
-	if (count <= num_hot_to_skip) {
-		// Oops!  Didn't get a valid backtrace from thread_stack_pcs().
-		OSSpinLockUnlock(&stack_logging_lock);
-		return;
-        }
-	
-	// easy access variables
-	thread_backtrace_history *historical = &thread_buffer[hashed_thread];
-	vm_address_t *frames = stack_buffer[current_stack_buffer];
-	
-	// increment as necessary
-	current_logging_index++;
-	current_stack_buffer++;
-	if (current_stack_buffer == STACK_LOGGING_NUMBER_RECENT_BACKTRACES) current_stack_buffer = 0;
-	
-	// difference (if possible)
-	if (historical->logging_index + STACK_LOGGING_NUMBER_RECENT_BACKTRACES <= current_logging_index) difference = 0;
-	else if (historical->full_backtrace_countdown == 0) difference = 0;
-	
-	uint32_t sameness = 0;
-	if (difference) {
-		uint32_t old_count = historical->backtrace_length;
-		int32_t new_count = (int32_t)count;
-		while (old_count-- && new_count-- > (int32_t)num_hot_to_skip) {
-			if (historical->backtrace[old_count] == frames[new_count]) sameness++;
-			else break;
-		}
-		
-		if (sameness < STACK_LOGGING_MIN_SAME_FRAMES) { // failure; pretend nothing was the same
-			difference = 0;
-		}
-	}
-	
-	// create events for byte storage
-	count -= num_hot_to_skip;
-	stack_logging_backtrace_event current_event;
-	current_event.num_identical_frames = (difference ? sameness : 0);
-	current_event.num_new_hot_frames = (difference ? count - sameness : count);
-	current_event.offset_delta = (difference ? historical->logging_offset - total_offset : 0);
-	int64_t this_offset_change = sizeof(stack_logging_backtrace_event) + (current_event.num_new_hot_frames * sizeof(uintptr_t));
-	
-	stack_logging_index_event current_index;
-	if (type_flags & stack_logging_type_alloc) {
-		current_index.address = STACK_LOGGING_DISGUISE(return_val);
-		current_index.argument = size;
-		if (logging_use_compaction) {
-			last_logged_malloc_address = current_index.address; // disguised
-			last_logged_backtrace_offset_diff = (uint32_t)this_offset_change;
-			compaction_saved_differencing_history = *historical;
-		}
-	} else {
-		current_index.address = STACK_LOGGING_DISGUISE(ptr_arg);
-		current_index.argument = 0ul;
-		last_logged_malloc_address = 0ul;
-	}
-	current_index.offset_and_flags = STACK_LOGGING_OFFSET_AND_FLAGS(total_offset, type_flags);
-	
-	// prepare for differencing next time
-	historical->backtrace = (uintptr_t*)(frames + num_hot_to_skip);
-	historical->backtrace_length = count;
-	if (difference) historical->full_backtrace_countdown--;
-	else historical->full_backtrace_countdown = STACK_LOGGING_FORCE_FULL_BACKTRACE_EVERY;
-	historical->logging_index = current_logging_index;
-	historical->logging_offset = total_offset;
-	historical->thread = self_thread;
-	historical->hash_pos = hashed_thread;
-	
-	// flush the data buffer to disk if necessary
-	if (pre_write_buffers->next_free_stack_buffer_offset + this_offset_change >= STACK_LOGGING_BLOCK_WRITING_SIZE) {
-		flush_data();
-	} else if (pre_write_buffers->next_free_index_buffer_offset + sizeof(stack_logging_index_event) >= STACK_LOGGING_BLOCK_WRITING_SIZE) {
-		flush_data();
-	}
-	
-	// store bytes in buffers
-	memcpy(pre_write_index_buffer+pre_write_buffers->next_free_index_buffer_offset, &current_index, sizeof(stack_logging_index_event));
-	memcpy(pre_write_backtrace_event_buffer+pre_write_buffers->next_free_stack_buffer_offset, &current_event, sizeof(stack_logging_backtrace_event));
-	memcpy(pre_write_backtrace_event_buffer+pre_write_buffers->next_free_stack_buffer_offset+sizeof(stack_logging_backtrace_event), frames+num_hot_to_skip, (size_t)this_offset_change - sizeof(stack_logging_backtrace_event));
-	pre_write_buffers->next_free_index_buffer_offset += (uint32_t)sizeof(stack_logging_index_event);
-	pre_write_buffers->next_free_stack_buffer_offset += (uint32_t)this_offset_change;
-	total_offset += this_offset_change;
-	
-	OSSpinLockUnlock(&stack_logging_lock);
-}
-
-#pragma mark -
-#pragma mark Remote Stack Log Access
-
-#pragma mark - Design notes:
-
-/*
-
-this first one will look through the index, find the "stack_identifier" (i.e. the offset in the log file), and call the third function listed here.
-extern kern_return_t __mach_stack_logging_get_frames(task_t task, mach_vm_address_t address, mach_vm_address_t *stack_frames_buffer, uint32_t max_stack_frames, uint32_t *num_frames);
-    //  Gets the last allocation record about address
-	
-if !address, will load both index and stack logs and iterate through (expensive)
-else will load just index, search for stack, and then use third function here to retrieve. (also expensive)
-extern kern_return_t __mach_stack_logging_enumerate_records(task_t task, mach_vm_address_t address, void enumerator(mach_stack_logging_record_t, void *), void *context);
-    // Applies enumerator to all records involving address sending context as enumerator's second parameter; if !address, applies enumerator to all records 
-
-this function will load the stack file, look for the stack, and follow up to STACK_LOGGING_FORCE_FULL_BACKTRACE_EVERY references to reconstruct.
-extern kern_return_t __mach_stack_logging_frames_for_uniqued_stack(task_t task, uint64_t stack_identifier, mach_vm_address_t *stack_frames_buffer, uint32_t max_stack_frames, uint32_t *count);
-    // Given a uniqued_stack fills stack_frames_buffer
-
-*/
-
-#pragma mark - caching
-
-static inline size_t hash_index_32(uint32_t address, size_t max_pos) __attribute__((always_inline));
-static inline size_t hash_index_32(uint32_t address, size_t max_pos) {
-//	return (((OSSwapInt32(address >> 2) << 3) & 0x96AAAA98) ^ (address >> 2)) % (max_pos-1);
-	return (address >> 2) % (max_pos-1); // simplicity rules.
-}
-
-static inline size_t hash_index_64(uint64_t address, size_t max_pos) __attribute__((always_inline));
-static inline size_t hash_index_64(uint64_t address, size_t max_pos) {
-//	return (size_t)((((OSSwapInt64(address >> 3) << 2) & 0x54AA0A0AAA54ull) ^ (address >> 3)) % (max_pos - 1));
-	return (size_t)((address >> 3) % (max_pos-1)); // simplicity rules.
-}
-
-static void
-transfer_node_ll32(remote_index_cache *cache, remote_index_node32 *old_node)
-{
-	uint32_t collisions = 0;
-	size_t pos = hash_index_32(old_node->address, cache->cache_node_capacity);
-	do {
-		if (cache->casted_table32[pos].address == old_node->address) { // hit like this shouldn't happen.
-			fprintf(stderr, "impossible collision! two address==address lists! (transfer_node_ll32)\n");
-			break;
-		} else if (cache->casted_table32[pos].address == 0) { // empty
-			cache->casted_table32[pos] = *old_node;
-			break;
-		} else {
-			pos++;
-			if (pos >= cache->cache_node_capacity) pos = 0;
-		}
-		collisions++;
-	} while (collisions <= cache->collision_allowance);
-	
-	if (collisions > cache->collision_allowance) {
-		fprintf(stderr, "reporting bad hash function! disk stack logging reader %lu bit. (transfer_node_ll32)\n", sizeof(void*)*8);
-	}
-}
-
-static void
-transfer_node_ll64(remote_index_cache *cache, remote_index_node64 *old_node)
-{
-	uint32_t collisions = 0;
-	size_t pos = hash_index_64(old_node->address, cache->cache_node_capacity);
-	do {
-		if (cache->casted_table64[pos].address == old_node->address) { // hit!
-			fprintf(stderr, "impossible collision! two address==address lists! (transfer_node_ll64)\n");
-			break;
-		} else if (cache->casted_table64[pos].address == 0) { // empty
-			cache->casted_table64[pos] = *old_node;
-			break;
-		} else {
-			pos++;
-			if (pos >= cache->cache_node_capacity) pos = 0;
-		}
-		collisions++;
-	} while (collisions <= cache->collision_allowance);
-	
-	if (collisions > cache->collision_allowance) {
-		fprintf(stderr, "reporting bad hash function! disk stack logging reader %lu bit. (transfer_node_ll64)\n", sizeof(void*)*8);
-	}
-}
-
-static void
-expand_cache(remote_index_cache *cache)
-{
-	// keep old stats
-	size_t old_node_capacity = cache->cache_node_capacity;
-	uint64_t old_node_count = cache->cache_node_count;
-	uint64_t old_llnode_count = cache->cache_llnode_count;
-	void *old_table = cache->table_memory;
-	
-	// double size
-	cache->cache_size <<= 1;
-	cache->cache_node_capacity <<= 1;
-	cache->collision_allowance += STACK_LOGGING_REMOTE_CACHE_COLLISION_GROWTH_RATE;
-	cache->table_memory = (void*)calloc(cache->cache_node_capacity, cache->in_use_node_size);
-	if (cache->casted_table32) cache->casted_table32 = cache->table_memory;
-	else cache->casted_table64 = cache->table_memory;
-	
-	// repopulate (expensive!)
-	size_t i;
-	if (cache->casted_table32) { // if target is 32-bit
-		remote_index_node32 *casted_old_table = (remote_index_node32*)old_table;
-		for (i = 0; i < old_node_capacity; i++) {
-			if (casted_old_table[i].address) {
-				transfer_node_ll32(cache, &casted_old_table[i]);
-			}
-		}
-	} else {
-		remote_index_node64 *casted_old_table = (remote_index_node64*)old_table;
-		for (i = 0; i < old_node_capacity; i++) {
-			if (casted_old_table[i].address) {
-				transfer_node_ll64(cache, &casted_old_table[i]);
-			}
-		}
-	}
-	
-	cache->cache_node_count = old_node_count;
-	cache->cache_llnode_count = old_llnode_count;
-	free(old_table);
-//	printf("cache expanded to %0.2f mb (eff: %3.0f%%, capacity: %lu, nodes: %llu, llnodes: %llu)\n", ((float)(cache->cache_size))/(1 << 20), ((float)(cache->cache_node_count)*100.0)/((float)(cache->cache_node_capacity)), cache->cache_node_capacity, cache->cache_node_count, cache->cache_llnode_count);
-}
-
-static void
-insert_node32(remote_index_cache *cache, uint32_t address, uint64_t index_file_offset)
-{
-	uint32_t collisions = 0;
-	size_t pos = hash_index_32(address, cache->cache_node_capacity);
-	
-	if (cache->next_block_index >= STACK_LOGGING_REMOTE_LINKS_PER_BLOCK) {
-		cache->next_block_index = 0;
-		cache->current_block++;
-		cache->blocks[cache->current_block] = (index_ll_node*)malloc(STACK_LOGGING_REMOTE_LINKS_PER_BLOCK*sizeof(index_ll_node));
-/*		printf("node buffer added. total nodes: %ul (%u buffers, %0.2f mb)\n", STACK_LOGGING_REMOTE_LINKS_PER_BLOCK*(cache->current_block+1),
-				cache->current_block+1, ((float)(STACK_LOGGING_REMOTE_LINKS_PER_BLOCK*sizeof(index_ll_node)*(cache->current_block+1)))/(1 << 20));
-*/
-	}
-	index_ll_node *new_node = &cache->blocks[cache->current_block][cache->next_block_index++];
-	new_node->index_file_offset = index_file_offset;
-	new_node->next = NULL;
-	
-	bool inserted = false;
-	while (!inserted) {
-		if (cache->casted_table32[pos].address == address) { // hit!
-			cache->casted_table32[pos].last_link->next = new_node; // insert at end
-			cache->casted_table32[pos].last_link = new_node;
-			inserted = true;
-			break;
-		} else if (cache->casted_table32[pos].address == 0) { // empty
-			cache->casted_table32[pos].address = address;
-			cache->casted_table32[pos].linked_list = new_node;
-			cache->casted_table32[pos].last_link = new_node;
-			cache->cache_node_count++;
-			inserted = true;
-			break;
-		} else {
-			pos++;
-			if (pos >= cache->cache_node_capacity) pos = 0;
-		}
-		collisions++;
-		if (collisions > cache->collision_allowance) {
-			expand_cache(cache);
-			pos = hash_index_32(address, cache->cache_node_capacity);
-			collisions = 0;
-		}
-	}
-	
-	cache->cache_llnode_count++;
-	
-}
-
-static void
-insert_node64(remote_index_cache *cache, uint64_t address, uint64_t index_file_offset)
-{
-	uint32_t collisions = 0;
-	size_t pos = hash_index_64(address, cache->cache_node_capacity);
-	
-	if (cache->next_block_index >= STACK_LOGGING_REMOTE_LINKS_PER_BLOCK) {
-		cache->next_block_index = 0;
-		cache->current_block++;
-		cache->blocks[cache->current_block] = (index_ll_node*)malloc(STACK_LOGGING_REMOTE_LINKS_PER_BLOCK*sizeof(index_ll_node));
-	}
-	index_ll_node *new_node = &cache->blocks[cache->current_block][cache->next_block_index++];
-	new_node->index_file_offset = index_file_offset;
-	new_node->next = NULL;
-	
-	bool inserted = false;
-	while (!inserted) {
-		if (cache->casted_table64[pos].address == address) { // hit!
-			cache->casted_table64[pos].last_link->next = new_node; // insert at end
-			cache->casted_table64[pos].last_link = new_node;
-			inserted = true;
-			break;
-		} else if (cache->casted_table64[pos].address == 0) { // empty
-			cache->casted_table64[pos].address = address;
-			cache->casted_table64[pos].linked_list = new_node;
-			cache->casted_table64[pos].last_link = new_node;
-			inserted = true;
-			break;
-		} else {
-			pos++;
-			if (pos >= cache->cache_node_capacity) pos = 0;
-		}
-		collisions++;
-		if (collisions > cache->collision_allowance) {
-			expand_cache(cache);
-			pos = hash_index_64(address, cache->cache_node_capacity);
-			collisions = 0;
-		}
-	}
-	
-}
-
-static void
-update_cache_for_file_streams(remote_task_file_streams *descriptors)
-{
-	remote_index_cache *cache = descriptors->cache;
-	
-	// create from scratch if necessary.
-	if (!cache) {
-		descriptors->cache = cache = (remote_index_cache*)calloc((size_t)1, sizeof(remote_index_cache));
-		cache->cache_node_capacity = STACK_LOGGING_REMOTE_CACHE_DEFAULT_NODE_CAPACITY;
-		cache->collision_allowance = STACK_LOGGING_REMOTE_CACHE_DEFAULT_COLLISION_ALLOWANCE;
-		cache->cache_node_count = cache->cache_llnode_count = 0;
-		cache->last_index_file_offset = 0;
-		cache->next_block_index = 0;
-		cache->current_block = 0;
-		cache->blocks[0] = (index_ll_node*)malloc(STACK_LOGGING_REMOTE_LINKS_PER_BLOCK*sizeof(index_ll_node));
-		cache->in_use_node_size = (descriptors->task_is_64_bit ? sizeof(remote_index_node64) : sizeof(remote_index_node32));
-		cache->cache_size = cache->cache_node_capacity*cache->in_use_node_size;
-		cache->table_memory = (void*)calloc(cache->cache_node_capacity, cache->in_use_node_size);
-		if (descriptors->task_is_64_bit) cache->casted_table64 = (remote_index_node64*)(cache->table_memory);
-		else cache->casted_table32 = (remote_index_node32*)(cache->table_memory);
-		
-		// now map in the shared memory, if possible
-		char shmem_name_string[PATH_MAX];
-		strlcpy(shmem_name_string, stack_logging_directory_base_name, (size_t)PATH_MAX);
-		append_int(shmem_name_string, descriptors->remote_pid);
-		
-		int shmid = shm_open(shmem_name_string, O_RDWR, S_IRUSR | S_IWUSR);
-		if (shmid >= 0) {
-			cache->shmem = mmap(0, sizeof(stack_buffer_shared_memory), PROT_READ | PROT_WRITE, MAP_SHARED, shmid, (off_t)0);
-			close(shmid);
-		}
-		
-		if (shmid < 0 || cache->shmem == NULL) {
-			// failed to connect to the shared memory region; warn and continue.
-			_malloc_printf(ASL_LEVEL_INFO, "warning: unable to connect to remote process' shared memory; allocation histories may not be up-to-date.\n");
-		}
-	}
-	
-	// suspend and see how much updating there is to do. there are three scenarios, listed below
-	bool update_snapshot = false;
-	if (descriptors->remote_task != mach_task_self()) {
-		task_suspend(descriptors->remote_task);
-	}
-		
-	struct stat file_statistics;
-	fstat(fileno(descriptors->index_file_stream), &file_statistics);
-	size_t read_size = (descriptors->task_is_64_bit ? sizeof(stack_logging_index_event64) : sizeof(stack_logging_index_event32));
-	uint64_t read_this_update = 0;
-	
-	// the delta indecies is a complex number; there are three cases:
-	// 1. there is no shared memory (or we can't connect); diff the last_index_file_offset from the filesize.
-	// 2. the only updates have been in shared memory; disk file didn't change at all. delta_indecies should be zero, scan snapshot only.
-	// 3. the updates have flushed to disk, meaning that most likely there is new data on disk that wasn't read from shared memory.
-	//    correct delta_indecies for the pre-scanned amount and read the new data from disk and shmem.
-	uint64_t delta_indecies = (file_statistics.st_size - cache->last_index_file_offset) / read_size;
-	uint32_t last_snapshot_scan_index = 0;
-	if (delta_indecies && cache->shmem) { 
-		// case 3: add cache scanned to known from disk and recalc
-		cache->last_index_file_offset += cache->snapshot.next_free_index_buffer_offset;
-		delta_indecies = (file_statistics.st_size - cache->last_index_file_offset) / read_size;
-		update_snapshot = true;
-	} else if (cache->shmem) {
-		// case 2: set the last snapshot scan count so we don't rescan something we've seen.
-		last_snapshot_scan_index = cache->snapshot.next_free_index_buffer_offset / (uint32_t)read_size;
-	}
-	
-	// no update necessary for the file; check if need a snapshot.
-	if (delta_indecies == 0) {
-		if (cache->shmem && !update_snapshot) {
-			update_snapshot = (cache->shmem->next_free_index_buffer_offset != cache->snapshot.next_free_index_buffer_offset);
-		}
-	}
-	
-	// if a snapshot is necessary, memcpy from remote frozen process' memory 
-	// note: there were two ways to do this Ð spin lock or suspend. suspend allows us to
-	// analyze processes even if they were artificially suspended. with a lock, there'd be
-	// worry that the target was suspended with the lock taken.
-	if (update_snapshot) {
-		memcpy(&cache->snapshot, cache->shmem, sizeof(stack_buffer_shared_memory));
-	}
-	
-	// resume
-	if (descriptors->remote_task != mach_task_self()) {
-		task_resume(descriptors->remote_task);
-	}
-	
-	if (!update_snapshot && delta_indecies == 0) return; // absolutely no updating needed.
-	
-	FILE *the_index = (descriptors->index_file_stream);
-	
-	// prepare for the read; target process could be 32 or 64 bit.
-
-	stack_logging_index_event32 *target_32_index = NULL;
-	stack_logging_index_event64 *target_64_index = NULL;
-	
-	// perform the update from the file
-	uint32_t i;
-	if (delta_indecies) {
-		char bufferSpace[4096]; // 4 kb
-		target_32_index = (stack_logging_index_event32*)bufferSpace;
-		target_64_index = (stack_logging_index_event64*)bufferSpace;
-		size_t number_slots = (size_t)(4096/read_size);
-	
-		size_t read_count = 0;
-		if (fseeko(the_index, (off_t)(cache->last_index_file_offset), SEEK_SET)) {
-			fprintf(stderr, "error while attempting to cache information from remote stack index file. (update_cache_for_file_streams)\n");
-		}
-		off_t current_index_position = cache->last_index_file_offset;
-		do {
-			number_slots = MIN(delta_indecies - read_this_update, number_slots);
-			read_count = fread(bufferSpace, read_size, number_slots, the_index);
-			if (descriptors->task_is_64_bit) {
-				for (i = 0; i < read_count; i++) {
-					insert_node64(cache, STACK_LOGGING_DISGUISE(target_64_index[i].address), (uint64_t)current_index_position);
-					read_this_update++;
-					current_index_position += read_size;
-				}
-			} else {
-				for (i = 0; i < read_count; i++) {
-					insert_node32(cache, STACK_LOGGING_DISGUISE(target_32_index[i].address), (uint64_t)current_index_position);
-					read_this_update++;
-					current_index_position += read_size;
-				}
-			}
-		} while (read_count);
-
-		if (read_this_update < delta_indecies) {
-			fprintf(stderr, "insufficient data in remote stack index file; expected more records.\n");
-		}
-		cache->last_index_file_offset += read_this_update * read_size;
-	}
-	
-	if (update_snapshot) {
-		target_32_index = (stack_logging_index_event32*)(cache->snapshot.index_buffer);
-		target_64_index = (stack_logging_index_event64*)(cache->snapshot.index_buffer);
-		
-		uint32_t free_snapshot_scan_index = cache->snapshot.next_free_index_buffer_offset / (uint32_t)read_size;
-		off_t current_index_position = cache->snapshot.start_index_offset;
-		if (descriptors->task_is_64_bit) {
-			for (i = last_snapshot_scan_index; i < free_snapshot_scan_index; i++) {
-				insert_node64(cache, STACK_LOGGING_DISGUISE(target_64_index[i].address), (uint64_t)(current_index_position + (i * read_size))); 
-			}
-		} else {
-			for (i = last_snapshot_scan_index; i < free_snapshot_scan_index; i++) {
-				insert_node32(cache, STACK_LOGGING_DISGUISE(target_32_index[i].address), (uint64_t)(current_index_position + (i * read_size)));
-			}
-		}
-	}
-	
-}
-
-static void
-destroy_cache_for_file_streams(remote_task_file_streams *descriptors)
-{
-	uint32_t i;
-	for (i = 0; i <= descriptors->cache->current_block; i++) {
-		free(descriptors->cache->blocks[i]); // clears the linked list nodes.
-	}
-	if (descriptors->cache->shmem) {
-		munmap(descriptors->cache->shmem, sizeof(stack_buffer_shared_memory));
-	}
-	free(descriptors->cache->table_memory);
-	free(descriptors->cache);
-	descriptors->cache = NULL;
-}
-
-#pragma mark - internal
-
-// In the stack log analysis process, find the stack logging files for target process <pid>
-// by scanning the temporary directory for directory entries with names of the form "stack-logs.<pid>."
-// If we find such a directory then open the stack logging files in there.
-static void
-open_log_files(pid_t pid, remote_task_file_streams *this_task_streams)
-{
-	DIR *dp;
-	struct dirent *entry;
-	int prefix_length;
-	char prefix_name[PATH_MAX];
-	char pathname[PATH_MAX];
-
-	reap_orphaned_log_files(false);		// reap any left-over log files (for non-existant processes, but not for this analysis process)
-
-	if ((dp = opendir(temporary_directory)) == NULL) {
-		return;
-	}
-
-	// It's OK to use snprintf in this routine since it should only be called by the clients
-	// of stack logging, and thus calls to malloc are OK.
-	snprintf(prefix_name, PATH_MAX, "%s%d.", stack_logging_directory_base_name, pid);	// make sure to use "%s%d." rather than just "%s%d" to match the whole pid
-	prefix_length = strlen(prefix_name);
-
-	while ( (entry = readdir(dp)) != NULL ) {
-		if ( strncmp( entry->d_name, prefix_name, prefix_length) == 0 ) {
-			snprintf(pathname, PATH_MAX, "%s/%s/%s", temporary_directory, entry->d_name, index_file_name);
-			this_task_streams->index_file_stream = fopen(pathname, "r");
-
-			snprintf(pathname, PATH_MAX, "%s/%s/%s", temporary_directory, entry->d_name, stack_file_name);
-			this_task_streams->stack_file_stream = fopen(pathname, "r");
-
-			break;
-		}
-	}
-	closedir(dp);
-}	
-
-static remote_task_file_streams*
-retain_file_streams_for_task(task_t task)
-{
-	OSSpinLockLock(&remote_fd_list_lock);
-	
-	// see if they're already in use
-	uint32_t i = 0;
-	for (i = 0; i < remote_task_fd_count; i++) {
-		if (remote_fds[i].remote_task == task) {
-			remote_fds[i].in_use_count++;
-			OSSpinLockUnlock(&remote_fd_list_lock);
-			return &remote_fds[i];
-		}
-	}
-	
-	// open them
-	uint32_t failures = 0;
-	if (remote_task_fd_count == STACK_LOGGING_MAX_SIMUL_REMOTE_TASKS_INSPECTED) {
-		while (remote_fds[next_remote_task_fd].in_use_count > 0) {
-			next_remote_task_fd++;
-			if (next_remote_task_fd == STACK_LOGGING_MAX_SIMUL_REMOTE_TASKS_INSPECTED) next_remote_task_fd = 0;
-			failures++;
-			if (failures >= STACK_LOGGING_MAX_SIMUL_REMOTE_TASKS_INSPECTED) {
-				OSSpinLockUnlock(&remote_fd_list_lock);
-				return NULL;
-			}
-		}
-		fclose(remote_fds[next_remote_task_fd].index_file_stream);
-		fclose(remote_fds[next_remote_task_fd].stack_file_stream);
-		destroy_cache_for_file_streams(&remote_fds[next_remote_task_fd]);
-	}
-	
-	pid_t pid;
-	kern_return_t err = pid_for_task(task, &pid);
-	if (err != KERN_SUCCESS) {
-		OSSpinLockUnlock(&remote_fd_list_lock);
-		return NULL;
-	}
-	
-	remote_task_file_streams *this_task_streams = &remote_fds[next_remote_task_fd];
-	
-	open_log_files(pid, this_task_streams);
-
-	// check if opens failed
-	if (this_task_streams->index_file_stream == NULL || this_task_streams->stack_file_stream == NULL) {
-		if (this_task_streams->index_file_stream) fclose(this_task_streams->index_file_stream);
-		if (this_task_streams->stack_file_stream) fclose(this_task_streams->stack_file_stream);
-		OSSpinLockUnlock(&remote_fd_list_lock);
-		return NULL;
-	}
-	
-	// check if target pid is running 64-bit
-	int mib[] = { CTL_KERN, KERN_PROC, KERN_PROC_PID, pid };
-	struct kinfo_proc processInfo;
-	size_t bufsize = sizeof(processInfo);
-	if (sysctl(mib, (unsigned)(sizeof(mib)/sizeof(int)), &processInfo, &bufsize, NULL, (size_t)0) == 0 && bufsize > 0) {
-		this_task_streams->task_is_64_bit = processInfo.kp_proc.p_flag & P_LP64;
-	} else {
-		this_task_streams->task_is_64_bit = 0;
-	}
-	
-	// otherwise set vars and go
-	this_task_streams->in_use_count = 1;
-	this_task_streams->remote_task = task;
-	this_task_streams->remote_pid = pid;
-	next_remote_task_fd++;
-	if (next_remote_task_fd == STACK_LOGGING_MAX_SIMUL_REMOTE_TASKS_INSPECTED) next_remote_task_fd = 0;
-	remote_task_fd_count = MIN(remote_task_fd_count + 1, STACK_LOGGING_MAX_SIMUL_REMOTE_TASKS_INSPECTED);
-	
-	OSSpinLockUnlock(&remote_fd_list_lock);
-	return this_task_streams;
-}
-
-static void
-release_file_streams_for_task(task_t task)
-{
-	OSSpinLockLock(&remote_fd_list_lock);
-	
-	// decrement in-use count
-	uint32_t i = 0;
-	for (i = 0; i < remote_task_fd_count; i++) {
-		if (remote_fds[i].remote_task == task) {
-			remote_fds[i].in_use_count--;
-			break;
-		}
-	}
-	
-	OSSpinLockUnlock(&remote_fd_list_lock);
-}
-
-#pragma mark - extern
-
-kern_return_t
-__mach_stack_logging_get_frames(task_t task, mach_vm_address_t address, mach_vm_address_t *stack_frames_buffer, uint32_t max_stack_frames, uint32_t *count)
-{
-	remote_task_file_streams *remote_fd = retain_file_streams_for_task(task);
-	if (remote_fd == NULL) {
-		return KERN_FAILURE;
-	}
-	
-	update_cache_for_file_streams(remote_fd);
-	
-	uint32_t collisions = 0;
-	uint64_t located_file_position = 0;
-	bool found = false;
-	size_t hash = 0;
-	if (remote_fd->task_is_64_bit) {
-		hash = hash_index_64(address, remote_fd->cache->cache_node_capacity);
-		do {
-			if (remote_fd->cache->casted_table64[hash].address == address) { // hit!
-				located_file_position = remote_fd->cache->casted_table64[hash].last_link->index_file_offset;
-				found = true;
-				break;
-			} else if (remote_fd->cache->casted_table64[hash].address == 0) { // failure!
-				break;
-			}
-			hash++;
-			if (hash >= remote_fd->cache->cache_node_capacity) hash = 0;
-		} while (collisions <= remote_fd->cache->collision_allowance);
-	} else {
-		hash = hash_index_32((uint32_t)address, remote_fd->cache->cache_node_capacity);
-		do {
-			if (remote_fd->cache->casted_table32[hash].address == (uint32_t)address) { // hit!
-				located_file_position = remote_fd->cache->casted_table32[hash].last_link->index_file_offset;
-				found = true;
-				break;
-			} else if (remote_fd->cache->casted_table32[hash].address == 0) { // failure!
-				break;
-			}
-			hash++;
-			if (hash >= remote_fd->cache->cache_node_capacity) hash = 0;
-		} while (collisions <= remote_fd->cache->collision_allowance);
-	}
-	
-	if (found) {
-		// prepare for the read; target process could be 32 or 64 bit.
-		stack_logging_index_event32 *target_32_index = NULL;
-		stack_logging_index_event64 *target_64_index = NULL;
-		
-		if (located_file_position >= remote_fd->cache->last_index_file_offset) {
-			// must be in shared memory
-			if (remote_fd->cache->shmem) {
-				if (remote_fd->task_is_64_bit) {
-					target_64_index = (stack_logging_index_event64*)(remote_fd->cache->snapshot.index_buffer + (located_file_position - remote_fd->cache->snapshot.start_index_offset));
-					located_file_position = STACK_LOGGING_OFFSET(target_64_index->offset_and_flags);
-				} else {
-					target_32_index = (stack_logging_index_event32*)(remote_fd->cache->snapshot.index_buffer + (located_file_position - remote_fd->cache->snapshot.start_index_offset));
-					located_file_position = STACK_LOGGING_OFFSET(target_32_index->offset_and_flags);				
-				}
-			} else {
-				found = false;
-			}
-		
-		} else {
-			// it's written to disk
-			char bufferSpace[128];
-			
-			size_t read_size = (remote_fd->task_is_64_bit ? sizeof(stack_logging_index_event64) : sizeof(stack_logging_index_event32));
-			fseeko(remote_fd->index_file_stream, (off_t)located_file_position, SEEK_SET);
-			size_t read_count = fread(bufferSpace, read_size, (size_t)1, remote_fd->index_file_stream);
-			if (read_count) {
-				if (remote_fd->task_is_64_bit) {
-					target_64_index = (stack_logging_index_event64*)bufferSpace;
-					located_file_position = STACK_LOGGING_OFFSET(target_64_index->offset_and_flags);
-				} else {
-					target_32_index = (stack_logging_index_event32*)bufferSpace;
-					located_file_position = STACK_LOGGING_OFFSET(target_32_index->offset_and_flags);
-				}
-			} else {
-				found = false;
-			}
-		}
-	}
-	
-	release_file_streams_for_task(task);
-	
-	if (!found) {
-		return KERN_FAILURE;
-	}
-	
-	return __mach_stack_logging_frames_for_uniqued_stack(task, located_file_position, stack_frames_buffer, max_stack_frames, count);
-}
-
-
-kern_return_t
-__mach_stack_logging_enumerate_records(task_t task, mach_vm_address_t address, void enumerator(mach_stack_logging_record_t, void *), void *context)
-{
-	remote_task_file_streams *remote_fd = retain_file_streams_for_task(task);
-	if (remote_fd == NULL) {
-		return KERN_FAILURE;
-	}
-	
-	bool reading_all_addresses = (address == 0 ? true : false);
-	mach_stack_logging_record_t pass_record;
-	kern_return_t err = KERN_SUCCESS;
-	
-	if (reading_all_addresses) { // just stupidly read the index file from disk
-	
-		// update (read index file once and only once)
-		update_cache_for_file_streams(remote_fd);
-	
-		FILE *the_index = (remote_fd->index_file_stream);
-		
-		// prepare for the read; target process could be 32 or 64 bit.
-		char bufferSpace[2048]; // 2 kb
-		stack_logging_index_event32 *target_32_index = (stack_logging_index_event32*)bufferSpace;
-		stack_logging_index_event64 *target_64_index = (stack_logging_index_event64*)bufferSpace;
-		uint32_t target_addr_32 = (uint32_t)STACK_LOGGING_DISGUISE((uint32_t)address);
-		uint64_t target_addr_64 = STACK_LOGGING_DISGUISE((uint64_t)address);
-		size_t read_size = (remote_fd->task_is_64_bit ? sizeof(stack_logging_index_event64) : sizeof(stack_logging_index_event32));
-		size_t number_slots = (size_t)(2048/read_size);
-		uint64_t total_slots = remote_fd->cache->last_index_file_offset / read_size;
-		
-		// perform the search
-		size_t read_count = 0;
-		int64_t current_file_offset = 0;
-		uint32_t i;
-		do {
-			// at this point, we need to read index events; read them from the file until it's necessary to grab them from the shared memory snapshot
-			// and crop file reading to the point where we last scanned
-			number_slots = (size_t)MIN(number_slots, total_slots);
-			
-			// if out of file to read (as of the time we entered this function), try to use shared memory snapshot
-			if (number_slots == 0) {
-				if (remote_fd->cache->shmem && remote_fd->cache->snapshot.start_index_offset + remote_fd->cache->snapshot.next_free_index_buffer_offset > (uint64_t)current_file_offset) {
-					// use shared memory
-					target_32_index = (stack_logging_index_event32*)remote_fd->cache->snapshot.index_buffer;
-					target_64_index = (stack_logging_index_event64*)remote_fd->cache->snapshot.index_buffer;
-					read_count = (uint32_t)(remote_fd->cache->snapshot.start_index_offset + remote_fd->cache->snapshot.next_free_index_buffer_offset - current_file_offset) / read_size;
-					current_file_offset += read_count * read_size;
-				} else {
-					break;
-				}
-			} else {
-				// get and save index (enumerator could modify)
-				fseeko(the_index, current_file_offset, SEEK_SET);
-				read_count = fread(bufferSpace, read_size, number_slots, the_index);
-				current_file_offset = ftello(the_index);
-				total_slots -= read_count;
-			}
-			
-			if (remote_fd->task_is_64_bit) {
-				for (i = 0; i < read_count; i++) {
-					if (reading_all_addresses || target_64_index[i].address == target_addr_64) {
-						pass_record.address = STACK_LOGGING_DISGUISE(target_64_index[i].address);
-						pass_record.argument = target_64_index[i].argument;
-						pass_record.stack_identifier = STACK_LOGGING_OFFSET(target_64_index[i].offset_and_flags);
-						pass_record.type_flags = STACK_LOGGING_FLAGS(target_64_index[i].offset_and_flags);
-						enumerator(pass_record, context);
-					}
-				}
-			} else {
-				for (i = 0; i < read_count; i++) {
-					if (reading_all_addresses || target_32_index[i].address == target_addr_32) {
-						pass_record.address = STACK_LOGGING_DISGUISE(target_32_index[i].address);
-						pass_record.argument = target_32_index[i].argument;
-						pass_record.stack_identifier = STACK_LOGGING_OFFSET(target_32_index[i].offset_and_flags);
-						pass_record.type_flags = STACK_LOGGING_FLAGS(target_32_index[i].offset_and_flags);
-						enumerator(pass_record, context);
-					}
-				}
-			}
-		} while (read_count);
-	
-	} else { // searching for a single address' history
-		
-		// update (read index file once and only once)
-		update_cache_for_file_streams(remote_fd);
-		
-		// get linked-list of events
-		uint32_t collisions = 0;
-		uint64_t located_file_position = 0;
-		size_t hash = 0;
-		index_ll_node *index_position_linked_list = NULL;
-		if (remote_fd->task_is_64_bit) {
-			hash = hash_index_64(address, remote_fd->cache->cache_node_capacity);
-			do {
-				if (remote_fd->cache->casted_table64[hash].address == address) { // hit!
-					index_position_linked_list = remote_fd->cache->casted_table64[hash].linked_list;
-					break;
-				} else if (remote_fd->cache->casted_table64[hash].address == 0) { // failure!
-					break;
-				}
-				hash++;
-				if (hash >= remote_fd->cache->cache_node_capacity) hash = 0;
-			} while (collisions <= remote_fd->cache->collision_allowance);
-		} else {
-			hash = hash_index_32((uint32_t)address, remote_fd->cache->cache_node_capacity);
-			do {
-				if (remote_fd->cache->casted_table32[hash].address == (uint32_t)address) { // hit!
-					index_position_linked_list = remote_fd->cache->casted_table32[hash].linked_list;
-					break;
-				} else if (remote_fd->cache->casted_table32[hash].address == 0) { // failure!
-					break;
-				}
-				hash++;
-				if (hash >= remote_fd->cache->cache_node_capacity) hash = 0;
-			} while (collisions <= remote_fd->cache->collision_allowance);
-		}
-		
-		// if we got something, run it
-		char bufferSpace[128];
-		size_t read_count = 0;
-		stack_logging_index_event32 *target_32_index = (stack_logging_index_event32*)bufferSpace;
-		stack_logging_index_event64 *target_64_index = (stack_logging_index_event64*)bufferSpace;
-		size_t read_size = (remote_fd->task_is_64_bit ? sizeof(stack_logging_index_event64) : sizeof(stack_logging_index_event32));
-		while (index_position_linked_list) {
-			located_file_position = index_position_linked_list->index_file_offset;
-			
-			if (located_file_position >= remote_fd->cache->snapshot.start_index_offset) {
-				if (remote_fd->cache->shmem && located_file_position >= remote_fd->cache->snapshot.start_index_offset && remote_fd->cache->snapshot.start_index_offset + remote_fd->cache->snapshot.next_free_index_buffer_offset > (uint64_t)located_file_position) {
-					// use shared memory
-					target_32_index = (stack_logging_index_event32*)(remote_fd->cache->snapshot.index_buffer + located_file_position - remote_fd->cache->snapshot.start_index_offset);
-					target_64_index = (stack_logging_index_event64*)target_32_index;
-					read_count = 1;
-				} else {
-					err = KERN_FAILURE;
-					break;
-				}
-			} else {
-				fseeko(remote_fd->index_file_stream, (off_t)located_file_position, SEEK_SET);
-				read_count = fread(bufferSpace, read_size, (size_t)1, remote_fd->index_file_stream);
-				if (!read_count) {
-					err = KERN_FAILURE;
-					break;
-				}
-			}
-			if (remote_fd->task_is_64_bit) {
-				pass_record.address = STACK_LOGGING_DISGUISE(target_64_index[0].address);
-				pass_record.argument = target_64_index[0].argument;
-				pass_record.stack_identifier = STACK_LOGGING_OFFSET(target_64_index[0].offset_and_flags);
-				pass_record.type_flags = STACK_LOGGING_FLAGS(target_64_index[0].offset_and_flags);
-				enumerator(pass_record, context);
-			} else {
-				pass_record.address = STACK_LOGGING_DISGUISE(target_32_index[0].address);
-				pass_record.argument = target_32_index[0].argument;
-				pass_record.stack_identifier = STACK_LOGGING_OFFSET(target_32_index[0].offset_and_flags);
-				pass_record.type_flags = STACK_LOGGING_FLAGS(target_32_index[0].offset_and_flags);
-				enumerator(pass_record, context);
-			}
-			index_position_linked_list = index_position_linked_list->next;
-		}
-		
-	}
-
-	release_file_streams_for_task(task);
-	return err;
-}
-
-
-kern_return_t
-__mach_stack_logging_frames_for_uniqued_stack(task_t task, uint64_t stack_identifier, mach_vm_address_t *stack_frames_buffer, uint32_t max_stack_frames, uint32_t *count)
-{
-	remote_task_file_streams *remote_fd = retain_file_streams_for_task(task);
-	if (remote_fd == NULL) {
-		return KERN_FAILURE;
-	}
-	
-	// prepare for initial read
-	FILE *stack_fd;
-	stack_fd = (remote_fd->stack_file_stream);
-	char bytes_buffer[16];
-	stack_logging_backtrace_event *target_stack_event = (stack_logging_backtrace_event*)bytes_buffer;
-	size_t read_size = sizeof(stack_logging_backtrace_event);
-	size_t read_count = 0;
-	off_t reading_offset = (off_t)stack_identifier;
-	
-	// get a temporary spot for the backtrace frames to go and reference the stack space such that the reference
-	// can be later pointed at the shared memory snapshot and data read from there.
-	uint64_t temp_frames_buffer[STACK_LOGGING_MAX_STACK_SIZE];
-	uint64_t *big_frames = (uint64_t*)temp_frames_buffer;
-	uint32_t *small_frames = (uint32_t*)temp_frames_buffer;
-	size_t target_frame_size = (remote_fd->task_is_64_bit ? sizeof(uint64_t) : sizeof(uint32_t));
-	char *snapshot_backtrace_location = NULL;
-	
-	int done = 0;
-	int32_t total_frames = -1;
-	int32_t hot_frames_read = 0;
-	size_t new_hot_frames = 0;
-	int32_t number_needed_hot_frames_in_event;
-	size_t number_hot_frames_to_skip;
-	int32_t i;
-	bool skip_file_read;
-	
-	while (!done) {
-	
-		// not in cache; read record Ð from disk if possible, shared memory snapshot if necessary.
-		if (remote_fd->cache->shmem && reading_offset >= (off_t)(remote_fd->cache->snapshot.start_stack_offset)) {
-			// must read from shared memory; the record isn't on disk yet
-			snapshot_backtrace_location = (remote_fd->cache->snapshot.stack_buffer + (reading_offset - remote_fd->cache->snapshot.start_stack_offset));
-			*target_stack_event = *(stack_logging_backtrace_event*)snapshot_backtrace_location;
-			big_frames = (uint64_t*)(snapshot_backtrace_location + sizeof(stack_logging_backtrace_event));
-			small_frames = (uint32_t*)big_frames;
-			skip_file_read = true;
-		} else {
-			// the record's on disk
-			i = fseeko(stack_fd, reading_offset, SEEK_SET);
-			if (i != 0) break; // unable to seek to the target position
-			read_count = fread(target_stack_event, read_size, (size_t)1, stack_fd);
-			if (read_count == 0) break;
-			
-			big_frames = (uint64_t*)temp_frames_buffer;
-			small_frames = (uint32_t*)temp_frames_buffer;
-			skip_file_read = false;
-		}
-		
-		if (total_frames < 0) {
-			total_frames = target_stack_event->num_new_hot_frames + target_stack_event->num_identical_frames;
-			if (total_frames > (int32_t)max_stack_frames) break; // don't know what to do with this; we'll just KERN_FAILURE.
-		}
-		
-		// do the math to find how many frames to apply from previous event
-		new_hot_frames = target_stack_event->num_new_hot_frames;
-		number_needed_hot_frames_in_event = total_frames - hot_frames_read - target_stack_event->num_identical_frames;
-		number_hot_frames_to_skip = new_hot_frames - number_needed_hot_frames_in_event;
-		
-		// read and apply the important frames of this one
-		if (number_needed_hot_frames_in_event > 0) {
-			if (!skip_file_read) {
-				read_count = fread(temp_frames_buffer, target_frame_size, new_hot_frames, stack_fd);
-				if (read_count < new_hot_frames) break;
-			}
-			
-			if (remote_fd->task_is_64_bit) {
-				for (i = 0; i < number_needed_hot_frames_in_event; i++) {
-					stack_frames_buffer[hot_frames_read++] = big_frames[i+number_hot_frames_to_skip];
-				}
-			} else {
-				for (i = 0; i < number_needed_hot_frames_in_event; i++) {
-					stack_frames_buffer[hot_frames_read++] = small_frames[i+number_hot_frames_to_skip];
-				}
-			}
-		}
-		
-		reading_offset += target_stack_event->offset_delta;
-		
-		if (hot_frames_read == total_frames) done = 1;
-		else if (target_stack_event->offset_delta == 0) {
-			fprintf(stderr, "incomplete stack record (identifier: 0x%qx)\n", reading_offset);
-			break;
-		}   
-	}
-	
-	release_file_streams_for_task(task);
-	
-	if (done) {
-		*count = hot_frames_read; 
-		return KERN_SUCCESS;
-	} else {
-		return KERN_FAILURE;
-	}
-}
-
-
-#ifdef TEST_DISK_STACK_LOGGING
-
-// cc -o stack_logging_disk stack_logging_disk.c -DTEST_DISK_STACK_LOGGING
-
-#include <sys/wait.h>
-
-main()
-{
-  int status;
-  int i;
-
-  fprintf(stderr, "master test process is %d\n", getpid());
-  fprintf(stderr, "sizeof stack_buffer: %d\n", sizeof(stack_buffer));
-  fprintf(stderr, "sizeof thread_buffer: %d\n", sizeof(thread_buffer));
-  fprintf(stderr, "sizeof stack_logs_directory: %d\n", sizeof(stack_logs_directory));
-  fprintf(stderr, "sizeof remote_fds: %d\n", sizeof(remote_fds));
-  fprintf(stderr, "address of pre_write_backtrace_event_buffer: %p\n", &pre_write_backtrace_event_buffer);
-  fprintf(stderr, "address of logging_use_compaction: %p\n", &logging_use_compaction);
-  //  fprintf(stderr, "size of all global data:  %d\n", (logging_use_compaction) - (pre_write_backtrace_event_buffer) + sizeof(logging_use_compaction));
-
-  create_log_files();
-
-  // create a few child processes and exit them cleanly so their logs should get cleaned up
-  fprintf(stderr, "\ncreating child processes and exiting cleanly\n");
-  for (i = 0; i < 3; i++) {
-    if (fork() == 0) {
-      fprintf(stderr, "\nin child processes %d\n", getpid());
-      create_log_files();
-      fprintf(stderr, "exiting child processes %d\n", getpid());
-      exit(1);
-    }
-    wait(&status);
-  }
-
-  // create a few child processes and abruptly _exit them, leaving their logs around
-  fprintf(stderr, "\ncreating child processes and exiting abruptly, leaving logs around\n");
-  for (i = 0; i < 3; i++) {
-    if (fork() == 0) {
-      fprintf(stderr, "\nin child processes %d\n", getpid());
-      create_log_files();
-      fprintf(stderr, "exiting child processes %d\n", getpid());
-      _exit(1);
-    }
-    wait(&status);
-  }
-
-  // this should reap any remaining logs
-  fprintf(stderr, "\nexiting master test process %d\n", getpid());
-  delete_log_files();
-}
-
-#endif