[ Previous | Next | Contents | Glossary | Home | Search ]
AIX Version 4.3 Commands Reference, Volume 1

bosdebug Command

Purpose

Enables, disables and/or displays the status information of the system

Syntax

bosdebug [-I | -D] [-M [-S | -s sizelist] [-n sizelist]]

bosdebug [-o]

bosdebug [-L]

Description

The bosdebug command enables, disables, and/or displays the status of debugging features of the system.

-I Causes the kernel debug program to be loaded and invoked on each subsequent reboot.
-D Causes the kernel debug program to be loaded on each subsequent reboot.
-M Causes the memory overlay detection system to be enabled. Memory overlays in kernel extensions and device drivers will cause a system crash.
-s sizelist
Causes the memory overlay detection system to promote each of the specified allocation sizes to a full page, and allocate and hide the next subsequent page after each allocation. This causes references beyond the end of the allocated memory to cause a system crash. sizelist is a list of memory sizes separated by commas. Each size must be in the range from 16 to 2048, and must be a power of 2.
-S Causes the memory overlay detection system to promote all allocation sizes to the next higher multiple of page size (4096), but does not hide subsequent pages. This improves the chances that references to freed memory will result in a crash, but it does not detect reads or writes beyond the end of allocated memory until that memory is freed.
-n sizelist
Has the same effect as the -s option, but works instead for network memory. Each size must be in the range from 32 to 2048, and must be a power of 2. This causes the net_malloc_frag_mask variable of the no command to be turned on during boot.
-o Turns off all debugging features of the system.
-L Displays the current settings for the kernel debug program and the memory overlay detection system. Note that the settings shown will not take effect until after the next time that the bosboot -a and shutdown -r commands are run. This is the default.
Any changes made by this command will not take effect until the bosboot -a and shutdown -r commands have been run.

Related Infomation

The bosboot command and shutdown command.

Memory Overlay Detection System (MODS) in the AIX Version 4.3 Kernel Extensions and Device Support Programming Concepts.


[ Previous | Next | Contents | Glossary | Home | Search ]