File Manager

X7ROOT File Manager

Current Path: /usr/include/bind9/isc

📁 ..
📄 aes.h(1.05 KB)
📄 app.h(10.23 KB)
📄 assertions.h(2.84 KB)
📄 atomic.h(4.07 KB)
📄 backtrace.h(3.8 KB)
📄 base32.h(4.35 KB)
📄 base64.h(2.8 KB)
📄 bind9.h(830 B)
📄 boolean.h(594 B)
📄 buffer.h(25.65 KB)
📄 bufferlist.h(1.42 KB)
📄 cmocka.h(1.35 KB)
📄 commandline.h(1.67 KB)
📄 condition.h(1.44 KB)
📄 counter.h(1.88 KB)
📄 crc64.h(998 B)
📄 deprecated.h(623 B)
📄 dir.h(1.56 KB)
📄 endian.h(4.67 KB)
📄 entropy.h(10.13 KB)
📄 errno.h(659 B)
📄 errno2result.h(902 B)
📄 error.h(1.4 KB)
📄 event.h(2.98 KB)
📄 eventclass.h(1.35 KB)
📄 file.h(11.39 KB)
📄 formatcheck.h(893 B)
📄 fsaccess.h(7.27 KB)
📄 hash.h(7.48 KB)
📄 heap.h(5.14 KB)
📄 hex.h(2.74 KB)
📄 hmacmd5.h(1.75 KB)
📄 hmacsha.h(4.41 KB)
📄 ht.h(4.29 KB)
📄 httpd.h(2.26 KB)
📄 int.h(1.06 KB)
📄 interfaceiter.h(3.05 KB)
📄 iterated_hash.h(1.02 KB)
📄 json.h(1.42 KB)
📄 keyboard.h(989 B)
📄 lang.h(637 B)
📄 lex.h(9.54 KB)
📄 lfsr.h(2.89 KB)
📄 lib.h(1.04 KB)
📄 likely.h(818 B)
📄 list.h(5.62 KB)
📄 log.h(28.06 KB)
📄 magic.h(994 B)
📄 md5.h(2.32 KB)
📄 mem.h(20.62 KB)
📄 meminfo.h(710 B)
📄 msgcat.h(2.66 KB)
📄 msgs.h(8.22 KB)
📄 mutex.h(3.44 KB)
📄 mutexblock.h(1.34 KB)
📄 net.h(10.29 KB)
📄 netaddr.h(4.48 KB)
📄 netdb.h(863 B)
📄 netscope.h(967 B)
📄 offset.h(700 B)
📄 once.h(983 B)
📄 ondestroy.h(2.73 KB)
📄 os.h(671 B)
📄 parseint.h(1.51 KB)
📄 platform.h(9.49 KB)
📄 pool.h(3.42 KB)
📄 portset.h(3.22 KB)
📄 print.h(2.42 KB)
📄 queue.h(5.08 KB)
📄 quota.h(2.38 KB)
📄 radix.h(6.34 KB)
📄 random.h(3.5 KB)
📄 ratelimiter.h(3.42 KB)
📄 refcount.h(8 KB)
📄 regex.h(767 B)
📄 region.h(1.99 KB)
📄 resource.h(2.79 KB)
📄 result.h(4.87 KB)
📄 resultclass.h(1.56 KB)
📄 rwlock.h(3.72 KB)
📄 safe.h(1.32 KB)
📄 serial.h(1.34 KB)
📄 sha1.h(1.52 KB)
📄 sha2.h(5.6 KB)
📄 siphash.h(734 B)
📄 sockaddr.h(5.9 KB)
📄 socket.h(35.8 KB)
📄 stat.h(806 B)
📄 stats.h(3.62 KB)
📄 stdatomic.h(5.13 KB)
📄 stdio.h(1.75 KB)
📄 stdlib.h(704 B)
📄 stdtime.h(1.04 KB)
📄 strerror.h(777 B)
📄 string.h(5.88 KB)
📄 symtab.h(4.22 KB)
📄 syslog.h(844 B)
📄 task.h(21.04 KB)
📄 taskpool.h(3.62 KB)
📄 thread.h(1.47 KB)
📄 time.h(8.67 KB)
📄 timer.h(10.54 KB)
📄 tm.h(895 B)
📄 types.h(5.64 KB)
📄 utf8.h(928 B)
📄 util.h(10.29 KB)
📄 version.h(689 B)
📄 xml.h(1.07 KB)

Editing: backtrace.h

/*
 * Copyright (C) Internet Systems Consortium, Inc. ("ISC")
 *
 * This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this
 * file, you can obtain one at https://mozilla.org/MPL/2.0/.
 *
 * See the COPYRIGHT file distributed with this work for additional
 * information regarding copyright ownership.
 */

/*! \file isc/backtrace.h
 * \brief provide a back trace of the running process to help debug problems.
 *
 * This module tries to get a back trace of the process using some platform
 * dependent way when available.  It also manages an internal symbol table
 * that maps function addresses used in the process to their textual symbols.
 * This module is expected to be used to help debug when some fatal error
 * happens.
 *
 * IMPORTANT NOTE: since the (major) intended use case of this module is
 * dumping a back trace on a fatal error, normally followed by self termination,
 * functions defined in this module generally doesn't employ assertion checks
 * (if it did, a program bug could cause infinite recursive calls to a
 * backtrace function).  These functions still perform minimal checks and return
 * ISC_R_FAILURE if they detect an error, but the caller should therefore be
 * very careful about the use of these functions, and generally discouraged to
 * use them except in an exit path.  The exception is
 * isc_backtrace_getsymbolfromindex(), which is expected to be used in a
 * non-error-handling context and validates arguments with assertion checks.
 */

#ifndef ISC_BACKTRACE_H
#define ISC_BACKTRACE_H 1

/***
 ***	Imports
 ***/

#include <isc/types.h>

/***
 *** Types
 ***/
struct isc_backtrace_symmap {
	void		*addr;
	const char	*symbol;
};

LIBISC_EXTERNAL_DATA extern const int isc__backtrace_nsymbols;
LIBISC_EXTERNAL_DATA extern const
	isc_backtrace_symmap_t isc__backtrace_symtable[];

/***
 *** Functions
 ***/

ISC_LANG_BEGINDECLS
isc_result_t
isc_backtrace_gettrace(void **addrs, int maxaddrs, int *nframes);
/*%<
 * Get a back trace of the running process above this function itself.  On
 * success, addrs[i] will store the address of the call point of the i-th
 * stack frame (addrs[0] is the caller of this function).  *nframes will store
 * the total number of frames.
 *
 * Requires (note that these are not ensured by assertion checks, see above):
 *
 *\li	'addrs' is a valid array containing at least 'maxaddrs' void * entries.
 *
 *\li	'nframes' must be non NULL.
 *
 * Returns:
 *
 *\li	#ISC_R_SUCCESS
 *\li	#ISC_R_FAILURE
 *\li	#ISC_R_NOTFOUND
 *\li	#ISC_R_NOTIMPLEMENTED
 */

isc_result_t
isc_backtrace_getsymbolfromindex(int index, const void **addrp,
				 const char **symbolp);
/*%<
 * Returns the content of the internal symbol table of the given index.
 * On success, *addrsp and *symbolp point to the address and the symbol of
 * the 'index'th entry of the table, respectively.  If 'index' is not in the
 * range of the symbol table, ISC_R_RANGE will be returned.
 *
 * Requires
 *
 *\li	'addrp' must be non NULL && '*addrp' == NULL.
 *
 *\li	'symbolp' must be non NULL && '*symbolp' == NULL.
 *
 * Returns:
 *
 *\li	#ISC_R_SUCCESS
 *\li	#ISC_R_RANGE
 */

isc_result_t
isc_backtrace_getsymbol(const void *addr, const char **symbolp,
			unsigned long *offsetp);
/*%<
 * Searches the internal symbol table for the symbol that most matches the
 * given 'addr'.  On success, '*symbolp' will point to the name of function
 * to which the address 'addr' belong, and '*offsetp' will store the offset
 * from the function's entry address to 'addr'.
 *
 * Requires (note that these are not ensured by assertion checks, see above):
 *
 *\li	'symbolp' must be non NULL && '*symbolp' == NULL.
 *
 *\li	'offsetp' must be non NULL.
 *
 * Returns:
 *
 *\li	#ISC_R_SUCCESS
 *\li	#ISC_R_FAILURE
 *\li	#ISC_R_NOTFOUND
 */
ISC_LANG_ENDDECLS

#endif	/* ISC_BACKTRACE_H */

X7ROOT File Manager

Editing: backtrace.h

Upload File

Create Folder