freebsd-dev/sys/ddb/db_output.h

/*-
 * SPDX-License-Identifier: MIT-CMU
 *
 * Mach Operating System
 * Copyright (c) 1991,1990 Carnegie Mellon University
 * All Rights Reserved.
 *
 * Permission to use, copy, modify and distribute this software and its
 * documentation is hereby granted, provided that both the copyright
 * notice and this permission notice appear in all copies of the
 * software, derivative works or modified versions, and any portions
 * thereof, and that both notices appear in supporting documentation.
 *
 * CARNEGIE MELLON ALLOWS FREE USE OF THIS SOFTWARE IN ITS
 * CONDITION.  CARNEGIE MELLON DISCLAIMS ANY LIABILITY OF ANY KIND FOR
 * ANY DAMAGES WHATSOEVER RESULTING FROM THE USE OF THIS SOFTWARE.
 *
 * Carnegie Mellon requests users of this software to return to
 *
 *  Software Distribution Coordinator  or  Software.Distribution@CS.CMU.EDU
 *  School of Computer Science
 *  Carnegie Mellon University
 *  Pittsburgh PA 15213-3890
 *
 * any improvements or extensions that they make and grant Carnegie the
 * rights to redistribute these changes.
 *
 * $FreeBSD$
 */

#ifndef _DDB_DB_OUTPUT_H_
#define	_DDB_DB_OUTPUT_H_

/*
 *	Author: David B. Golub, Carnegie Mellon University
 *	Date:	8/90
 */

/*
 * Printing routines for kernel debugger.
 */

void	db_disable_pager(void);
void	db_enable_pager(void);
void	db_end_line(int);
void	db_force_whitespace(void);
int	db_print_position(void);

#endif /* !_DDB_DB_OUTPUT_H_ */
Start each of the license/copyright comments with /*- 2005-01-06 01:34:41 +00:00			`/*-`
SPDX: Consider code from Carnegie-Mellon University. Interesting cases, most likely from CMU Mach sources. 2017-11-30 15:48:35 +00:00			`* SPDX-License-Identifier: MIT-CMU`
			`*`
Initial import, 0.1 + pk 0.2.4-B1 1993-06-12 14:58:17 +00:00			`* Mach Operating System`
			`* Copyright (c) 1991,1990 Carnegie Mellon University`
			`* All Rights Reserved.`
Remove trailing whitespace. 1995-05-30 08:16:23 +00:00			`*`
Initial import, 0.1 + pk 0.2.4-B1 1993-06-12 14:58:17 +00:00			`* Permission to use, copy, modify and distribute this software and its`
			`* documentation is hereby granted, provided that both the copyright`
			`* notice and this permission notice appear in all copies of the`
			`* software, derivative works or modified versions, and any portions`
			`* thereof, and that both notices appear in supporting documentation.`
Remove trailing whitespace. 1995-05-30 08:16:23 +00:00			`*`
			`* CARNEGIE MELLON ALLOWS FREE USE OF THIS SOFTWARE IN ITS`
Initial import, 0.1 + pk 0.2.4-B1 1993-06-12 14:58:17 +00:00			`* CONDITION. CARNEGIE MELLON DISCLAIMS ANY LIABILITY OF ANY KIND FOR`
			`* ANY DAMAGES WHATSOEVER RESULTING FROM THE USE OF THIS SOFTWARE.`
Remove trailing whitespace. 1995-05-30 08:16:23 +00:00			`*`
Initial import, 0.1 + pk 0.2.4-B1 1993-06-12 14:58:17 +00:00			`* Carnegie Mellon requests users of this software to return to`
Remove trailing whitespace. 1995-05-30 08:16:23 +00:00			`*`
Initial import, 0.1 + pk 0.2.4-B1 1993-06-12 14:58:17 +00:00			`* Software Distribution Coordinator or Software.Distribution@CS.CMU.EDU`
			`* School of Computer Science`
			`* Carnegie Mellon University`
			`* Pittsburgh PA 15213-3890`
Remove trailing whitespace. 1995-05-30 08:16:23 +00:00			`*`
Initial import, 0.1 + pk 0.2.4-B1 1993-06-12 14:58:17 +00:00			`* any improvements or extensions that they make and grant Carnegie the`
			`* rights to redistribute these changes.`
			`*`
$Id$ -> $FreeBSD$ 1999-08-28 01:08:13 +00:00			`* $FreeBSD$`
Initial import, 0.1 + pk 0.2.4-B1 1993-06-12 14:58:17 +00:00			`*/`
Removed all patch kit headers, sccsid and rcsid strings, put $Id$ in, some minor cleanup. Added $Id$ to files that did not have any version info, etc 1993-10-16 16:47:35 +00:00
Make all headers idempotent. All incorrect common data moved out of header files and into a related source file. 1993-11-07 17:39:25 +00:00			`#ifndef _DDB_DB_OUTPUT_H_`
Completed function declarations and/or added prototypes. Removed `extern' from prototypes. Sorted prototypes. Uniformized idempotency ifdefs. 1995-11-24 13:53:05 +00:00			`#define _DDB_DB_OUTPUT_H_`
Make all headers idempotent. All incorrect common data moved out of header files and into a related source file. 1993-11-07 17:39:25 +00:00
Initial import, 0.1 + pk 0.2.4-B1 1993-06-12 14:58:17 +00:00			`/*`
ddb: space/tab fixes. No functional change. MFC after: 3 days 2014-10-11 20:25:19 +00:00			`* Author: David B. Golub, Carnegie Mellon University`
Initial import, 0.1 + pk 0.2.4-B1 1993-06-12 14:58:17 +00:00			`* Date: 8/90`
			`*/`

			`/*`
			`* Printing routines for kernel debugger.`
			`*/`

Simplify the pager support in DDB. Allowing different db commands to install custom pager functions didn't actually happen in practice (they all just used the simple pager and passed in a local quit pointer). So, just hardcode the simple pager as the only pager and make it set a global db_pager_quit flag that db commands can check when the user hits 'q' (or a suitable variant) at the pager prompt. Also, now that it's easy to do so, enable paging by default for all ddb commands. Any command that wishes to honor the quit flag can do so by checking db_pager_quit. Note that the pager can also be effectively disabled by setting $lines to 0. Other fixes: - 'show idt' on i386 and pc98 now actually checks the quit flag and terminates early. - 'show intr' now actually checks the quit flag and terminates early. 2006-07-12 21:22:44 +00:00			`void db_disable_pager(void);`
			`void db_enable_pager(void);`
Fixed formatting of printing of command tables. WIth the default max output width of 79, only 6 columns of width 12 each fit, but 7 columns were printed. The fix is to pass the width of the next output to db_end_line() and not assume there that this width is always 1. Related unfixed bugs: - 1 character is wasted for a space after the last column - suppression of trailing spaces used to limit the misformatting, but seems to have been lost - in db_examine(), the width of the next output is not know and is still assumed to be 1. 2006-10-08 18:15:08 +00:00			`void db_end_line(int);`
Remove __P. 2002-03-20 05:14:42 +00:00			`void db_force_whitespace(void);`
			`int db_print_position(void);`
Completed function declarations and/or added prototypes. Removed `extern' from prototypes. Sorted prototypes. Uniformized idempotency ifdefs. 1995-11-24 13:53:05 +00:00
			`#endif /* !_DDB_DB_OUTPUT_H_ */`