JavaScript is required to for searching.
跳过导航链接
退出打印视图
手册页第 1 部分:用户命令     Oracle Solaris 11 Information Library (简体中文)
search filter icon
search icon

文档信息

前言

简介

用户命令

acctcom(1)

adb(1)

addbib(1)

admin(1)

alias(1)

allocate(1)

amt(1)

appcert(1)

apptrace(1)

apropos(1)

ar(1)

arch(1)

as(1)

asa(1)

at(1)

atq(1)

atrm(1)

audioconvert(1)

audioctl(1)

audioplay(1)

audiorecord(1)

audiotest(1)

auths(1)

auto_ef(1)

awk(1)

banner(1)

basename(1)

basename(1B)

batch(1)

bc(1)

bdiff(1)

bfs(1)

bg(1)

biff(1B)

break(1)

builtin(1)

cal(1)

calendar(1)

case(1)

cat(1)

cd(1)

cdc(1)

cdrw(1)

chdir(1)

checkeq(1)

checknr(1)

chgrp(1)

chkey(1)

chmod(1)

chown(1)

chown(1B)

ckdate(1)

ckgid(1)

ckint(1)

ckitem(1)

ckkeywd(1)

ckpath(1)

ckrange(1)

ckstr(1)

cksum(1)

cktime(1)

ckuid(1)

ckyorn(1)

clear(1)

cmp(1)

col(1)

comb(1)

comm(1)

command(1)

compress(1)

continue(1)

cp(1)

cpio(1)

cpp(1)

cputrack(1)

crle(1)

crontab(1)

csh(1)

csplit(1)

ct(1C)

ctags(1)

ctrun(1)

ctstat(1)

ctwatch(1)

cu(1C)

cut(1)

date(1)

dc(1)

deallocate(1)

decrypt(1)

delta(1)

deroff(1)

df(1B)

dhcpinfo(1)

diff(1)

diff3(1)

diffmk(1)

digest(1)

digestp(1)

dircmp(1)

dirname(1)

dirs(1)

dis(1)

disown(1)

dispgid(1)

dispuid(1)

dos2unix(1)

dpost(1)

du(1)

du(1B)

dump(1)

dumpcs(1)

dumpkeys(1)

echo(1)

echo(1B)

ed(1)

edit(1)

egrep(1)

eject(1)

elfdump(1)

elfedit(1)

elffile(1)

elfsign(1)

elfwrap(1)

encrypt(1)

enhance(1)

env(1)

eqn(1)

errange(1)

errdate(1)

errgid(1)

errint(1)

erritem(1)

error(1)

errpath(1)

errstr(1)

errtime(1)

erruid(1)

erryorn(1)

eval(1)

ex(1)

exec(1)

exit(1)

expand(1)

export(1)

exportfs(1B)

expr(1)

expr(1B)

exstr(1)

factor(1)

false(1)

fastboot(1B)

fasthalt(1B)

fc(1)

fg(1)

fgrep(1)

file(1)

file(1B)

filebench(1)

filep(1)

filesync(1)

filofaxp(1)

find(1)

finger(1)

fmt(1)

fmtmsg(1)

fold(1)

for(1)

foreach(1)

franklinp(1)

from(1B)

ftp(1)

function(1)

gcore(1)

gencat(1)

geniconvtbl(1)

genmsg(1)

get(1)

getconf(1)

getfacl(1)

getlabel(1)

getopt(1)

getoptcvt(1)

getopts(1)

gettext(1)

gettxt(1)

getzonepath(1)

glob(1)

goto(1)

gprof(1)

grep(1)

groups(1)

groups(1B)

grpck(1B)

hash(1)

hashcheck(1)

hashmake(1)

hashstat(1)

head(1)

helpdate(1)

helpgid(1)

helpint(1)

helpitem(1)

helppath(1)

helprange(1)

helpstr(1)

helptime(1)

helpuid(1)

helpyorn(1)

hist(1)

history(1)

hostid(1)

hostname(1)

i386(1)

i486(1)

iconv(1)

idnconv(1)

if(1)

indxbib(1)

install(1B)

ipcrm(1)

ipcs(1)

isainfo(1)

isalist(1)

jobs(1)

join(1)

jsh(1)

kbd(1)

kdestroy(1)

keylogin(1)

keylogout(1)

kill(1)

kinit(1)

klist(1)

kmdb(1)

kmfcfg(1)

kpasswd(1)

krb5-config(1)

ksh(1)

ksh88(1)

ksh93(1)

ktutil(1)

lari(1)

last(1)

lastcomm(1)

ld(1)

ldapadd(1)

ldapdelete(1)

ldaplist(1)

ldapmodify(1)

ldapmodrdn(1)

ldapsearch(1)

ldd(1)

ld.so.1(1)

let(1)

lex(1)

lgrpinfo(1)

limit(1)

line(1)

list_devices(1)

listusers(1)

llc2_autoconfig(1)

llc2_config(1)

llc2_stats(1)

ln(1)

ln(1B)

loadkeys(1)

locale(1)

localedef(1)

logger(1)

logger(1B)

login(1)

logname(1)

logout(1)

look(1)

lookbib(1)

lorder(1)

ls(1)

ls(1B)

m4(1)

mac(1)

mach(1)

machid(1)

madv.so.1(1)

mail(1)

Mail(1B)

mail(1B)

mailcompat(1)

mailp(1)

mailq(1)

mailstats(1)

mailx(1)

make(1S)

makekey(1)

man(1)

mconnect(1)

mcs(1)

mdb(1)

mesg(1)

mkdir(1)

mkmsgs(1)

mkstr(1B)

mktemp(1)

moe(1)

more(1)

mp(1)

mpss.so.1(1)

msgcc(1)

msgcpp(1)

msgcvt(1)

msgfmt(1)

msggen(1)

msgget(1)

mt(1)

mv(1)

nawk(1)

nc(1)

ncab2clf(1)

ncakmod(1)

neqn(1)

netcat(1)

newform(1)

newgrp(1)

newsp(1)

newtask(1)

nice(1)

nl(1)

nm(1)

nohup(1)

notify(1)

nroff(1)

od(1)

on(1)

onintr(1)

optisa(1)

pack(1)

page(1)

pagesize(1)

pam_tty_tickets.so(1)

pargs(1)

passwd(1)

paste(1)

patch(1)

pathchk(1)

pax(1)

pcat(1)

pcred(1)

perl(1)

pfbash(1)

pfcsh(1)

pfexec(1)

pfiles(1)

pfksh(1)

pflags(1)

pfsh(1)

pftcsh(1)

pfzsh(1)

pg(1)

pgrep(1)

pkcs11_inspect(1)

pkginfo(1)

pkgmk(1)

pkgparam(1)

pkgproto(1)

pkgtrans(1)

pkill(1)

pklogin_finder(1)

pktool(1)

plabel(1)

pldd(1)

plgrp(1)

plimit(1)

pmadvise(1)

pmap(1)

popd(1)

ppgsz(1)

ppriv(1)

pr(1)

praliases(1)

prctl(1)

preap(1)

print(1)

printenv(1B)

printf(1)

priocntl(1)

proc(1)

prof(1)

profiles(1)

projects(1)

prs(1)

prt(1)

prun(1)

ps(1)

ps(1B)

psig(1)

pstack(1)

pstop(1)

ptime(1)

ptree(1)

pushd(1)

pvs(1)

pwait(1)

pwd(1)

pwdx(1)

ranlib(1)

rcapstat(1)

rcp(1)

read(1)

readonly(1)

red(1)

refer(1)

regcmp(1)

rehash(1)

remote_shell(1)

remsh(1)

renice(1)

repeat(1)

reset(1B)

return(1)

rksh(1)

rksh88(1)

rlogin(1)

rm(1)

rmail(1)

rmdel(1)

rmdir(1)

rmformat(1)

rmmount(1)

rmumount(1)

roffbib(1)

roles(1)

rpcgen(1)

rpm2cpio(1)

rsh(1)

runat(1)

rup(1)

rup(1C)

ruptime(1)

rusage(1B)

rusers(1)

rwho(1)

sact(1)

sar(1)

sccs(1)

sccs-admin(1)

sccs-cdc(1)

sccs-comb(1)

sccs-delta(1)

sccsdiff(1)

sccs-get(1)

sccs-help(1)

sccshelp(1)

sccs-prs(1)

sccs-prt(1)

sccs-rmdel(1)

sccs-sact(1)

sccs-sccsdiff(1)

sccs-unget(1)

sccs-val(1)

scp(1)

script(1)

sdiff(1)

sed(1)

sed(1B)

select(1)

set(1)

setenv(1)

setfacl(1)

setlabel(1)

setpgrp(1)

settime(1)

sftp(1)

sh(1)

shcomp(1)

shell_builtins(1)

shift(1)

shutdown(1B)

size(1)

sleep(1)

soelim(1)

sort(1)

sortbib(1)

sotruss(1)

source(1)

sparc(1)

spell(1)

spellin(1)

split(1)

srchtxt(1)

ssh(1)

ssh-add(1)

ssh-agent(1)

ssh-http-proxy-connect(1)

ssh-keygen(1)

ssh-keyscan(1)

ssh-socks5-proxy-connect(1)

stop(1)

strchg(1)

strconf(1)

strings(1)

strip(1)

stty(1)

stty(1B)

sum(1)

sum(1B)

sun(1)

suspend(1)

svcprop(1)

svcs(1)

switch(1)

symorder(1)

sys-suspend(1)

sysV-make(1)

t300(1)

t300s(1)

t4014(1)

t450(1)

tabs(1)

tail(1)

talk(1)

tar(1)

tbl(1)

tcopy(1)

tee(1)

tek(1)

telnet(1)

test(1)

test(1B)

tftp(1)

time(1)

timemanp(1)

times(1)

timesysp(1)

timex(1)

tip(1)

touch(1)

touch(1B)

tplot(1)

tput(1)

tr(1)

tr(1B)

trap(1)

troff(1)

true(1)

truss(1)

tset(1B)

tsort(1)

tty(1)

type(1)

typeset(1)

ul(1)

ulimit(1)

umask(1)

unalias(1)

uname(1)

uncompress(1)

unexpand(1)

unget(1)

unhash(1)

unifdef(1)

uniq(1)

units(1)

unix2dos(1)

unlimit(1)

unpack(1)

unset(1)

unsetenv(1)

until(1)

updatehome(1)

uptime(1)

userattr(1)

users(1B)

uucp(1C)

uudecode(1C)

uuencode(1C)

uuglist(1C)

uulog(1C)

uuname(1C)

uupick(1C)

uustat(1C)

uuto(1C)

uux(1C)

vacation(1)

val(1)

valdate(1)

valgid(1)

valint(1)

valpath(1)

valrange(1)

valstr(1)

valtime(1)

valuid(1)

valyorn(1)

vc(1)

vedit(1)

ver(1)

vgrind(1)

vi(1)

view(1)

vipw(1B)

volcheck(1)

volrmmount(1)

w(1)

wait(1)

wc(1)

what(1)

whatis(1)

whence(1)

whereis(1B)

which(1)

while(1)

who(1)

whoami(1B)

whocalls(1)

whois(1)

write(1)

xargs(1)

xgettext(1)

xstr(1)

yacc(1)

yes(1)

ypcat(1)

ypmatch(1)

yppasswd(1)

ypwhich(1)

zcat(1)

zlogin(1)

zonename(1)

zonestat(1)

kmdb

- 现场内核调试器中

用法概要

引导时装入

SPARC

ok boot [device-specifier] -k [-d] [boot-flags]
ok boot [device-specifier] kmdb [-d] [boot-flags]

x86

kernel$ /platform/i86pc/kernel/$ISADIR/unix -k [-d] [boot-flags]

运行时装入

mdb -K

描述

kmdb 是一个交互式内核调试器,可在即时内核上下文中实现 mdb(1) 的用户界面和功能。kmdb 提供允许控制内核执行以及检查与修改即时内核状态的功能。kmdb 可在引导会话开始时装入或者在引导系统之后装入。

本手册页介绍 kmdb 独有的特性和功能、或者与 mdb(1) 相比 kmdb 中不同的特性和功能。有关 mdb(1) 的更多信息,或者有关 kmdb 所实现特性和功能的更多详细信息,请参见 mdb(1) 手册页和《Oracle Solaris Modular Debugger Guide》

装入和卸载

引导时装入

被请求时,内核运行时链接程序 (krtld) 会在将控制权传送给内核之前先装入 kmdb。如果使用 -d 标志,调试器会在执行 unix 对象中的初始函数之前获取对系统的控制权。如果未使用 -d,会装入 kmdb,但要等到显式进入它时才会获取控制权。请参见下面的“调试器输入”一节。有关导致在引导时装入 kmdb 的引导命令列表,请参见上面的“说明”一节。有关在 SPARC 计算机上使用该命令指定在引导时始终装入 kmbd 的示例,请参见 eeprom(1M)

只能以系统重新引导的方式卸载在引导时装入的 kmdb

kmdb 的一些功能依赖于内核服务的存在,并且不会立即可供引导时装入的 kmdb 使用。特别是,直到初始化模块子系统后,dmod 的装入和卸载才可用。在得到处理前,请求会一直排队。同样,初始化 VM 系统之后,才可将虚拟地址转换为物理地址。尝试的转换将失败,直到转换工具可用。

运行时装入

mdb(1) 使用 -K 标志,还可在引导系统后装入 kmdb。以这种方式装入时,它会立即获取对系统的控制权。可对 mdb(1) 使用 -U 标志卸载 运行时装入的 kmdb,或者对 ::quit dcmd 使用 -u 标志将其从调试器内卸载。

终端类型

装入时,kmdb 尝试确定系统控制台上使用中的正确终端类型。如果正在调试的系统连接了同时用于系统控制台的键盘和本地显示器,kmdb 会使用适用于计算机的终端类型:对于 SPARC 使用 'sun';对于 x86 使用 'sun-color'。串行控制台处于使用中时,引导时装入的 kmdb 缺省为终端类型 'vt100'。运行时装入的 kmdb 缺省为由mdb(1) 请求的终端类型。mdb(1) 请求由 TERM 环境变量的值指定的终端类型,除非被 -T 标志覆盖。::term 可用于查看当前的终端类型。

调试器输入

可以显式或隐式请求调试器输入。“执行控制”一节中将讨论在使用断点或其他执行控制功能时遇到的隐式输入。

显式调试器输入的主要方式是对于具有本地控制台的系统使用键盘中止序列,对于具有串行控制台的系统使用 BREAK 字符。具有本地控制台的 SPARC 系统的中止序列是 STOP-A 或 Shift-Pause,具有本地控制台的 x86 系统的中止序列是 F1A 或 Shift-Pause。有关中止序列的讨论以及有关禁用中止序列的说明,请参见 kbd(1)

请求输入到调试器中的第二种方式是使用 mdb(1) 命令。在装入调试器后使用 -K 标志调用mdb(1) 会触发调试器输入。

如果内核出现紧急情况并且装入了 kmdb,缺省情况下,panic 例程会进入 kmdb 以进行即时调试。如果指定了转储设备,并且您输入了 ::cont,则调试器会退出并且会执行故障转储。要在遇到紧急情况时阻止内核进入 kmdb,可将 nopanicdebug 变量设置为 1。使用 kmdb 或在 /etc/system 中包含以下一行,将 nopanicdebug 变量设置为 1

set nopanicdebug = 1

如果您希望确保保持装入 kmdb 但又始终希望紧急情况在不进入调试器的情况下触发故障转储,则这样做会很有帮助。

执行控制

在大多数情况下,kmdb 为内核提供的执行控制功能会镜像由 mdb(1) 进程目标提供的那些执行控制功能。可使用断点 (::bp)、监视点 (::wp)、::continue 以及各种类型的 ::step

与内核提供的无限制用户进程监视点相反,kmdb 仅限于一组 CPU 监视点,用于对允许的监视点数量、大小和类型进行限制。如果某个监视点与硬件支持的监视点不兼容,::wp 命令不允许创建该监视点。

调试程序模块 (dmods)

mdb(1) 一样,kmdb 随许多特定于子系统的调试器模块或 dmod 一起安装。dmod 会随着它们支持的子系统的装入和卸载而自动装入和卸载。还可以使用 ::load::unload 显式装入和卸载 dmod。

kmdb 使用内核功能装入和卸载 dmod,并且必须恢复系统执行才能执行每个请求的操作。dmod 装入或卸载完成时,系统会停止,而且会自动重新进入调试器。对于 dmod 装入,会在请求的 dmod 装入成功或失败时完成处理。在任一情况中都会提供状态消息。

特定于处理器的功能

某些功能是个别处理器类型所特有的。此类功能的一个示例就是各种 x86 处理器提供的分支跟踪。随特定于处理器的 dcmd 一起提供对这些处理器特定功能的访问权限,这些 dcmd 只存在于支持它们的系统上。::status dcmd 的输出中指明了特定于处理器的支持的可用性。调试器依赖于内核来确定处理器类型。即使调试器可能为某个给定处理器类型提供支持,但此支持要到内核前进到处理器标识完成时才会公开。

内核宏

调试器提供对一组预编译到调试器中的宏的访问权限。只有预编译的宏可用。与 mdb(1) 不同,$< dcmd 可能无法用于从任意位置装入宏。使用 $M 命令列出可用的宏。

内置 dcmd

本节列出对于 kmdb 唯一的 dcmd,或与 mdb(1) 相比在 kmdb 中具有不同行为的 dcmd。

[address]::bp [+/-dDestT] [-c cmd] [-n count] sym ...
address :b [cmd ...]

在指定位置设置断点。::bp dcmd 在每个指定的地址或符号处设置断点,包括 dcmd 前某个显式表达式指定的可选位置,以及 dcmd 之后的每个字符串或即时值。参数可能是符号名称或表示关注的特定虚拟地址的即时值。

如果指定了符号名称,此名称可能是指某个还无法被计算的符号。它可能包含某个尚未打开的装入对象中的对象名称和函数名称。在这种情况下,断点会被延迟,而且直到装入了与给定名称匹配的对象时断点才会在目标中处于活动状态。打开装入对象时会自动启用断点。

-d-D-e-s-t-T-c-n 选项具有与用于 ::evset dcmd 时的相同意义。有关 ::evset 的说明,请参见 mdb(1)。如果使用 :b 形式的 dcmd,则仅会在由 dcmd 之前的表达式指定的虚拟地址处设置断点。:b dcmd 之后的参数会串联在一起形成回调字符串。如果此字符串包含元字符,必须引用该字符串。

::branches [-v]
(仅适用于 x86)

显示 CPU 采取的最后分支。此 dcmd 只在 x86 系统上受支持,而且仅当检测到并启用了特定于处理器的支持时才可用。显示的分支数量和类型取决于 CPU 提供的分支跟踪工具的功能。使用 -v 选项时,会显示给定分支之前的指令。

[function] ::call [arg [arg ...]]

使用指定参数调用指定函数。被调用的函数必须列出为装入模块的符号表中的函数。字符串参数是通过引用传递的。调用完成时,会显示该函数的返回值。

使用此 dcmd 时务必格外谨慎。进行调用时将不会恢复内核。被调用的函数可能无法就任何内核服务的可用性做出任何假设,而且不能执行可能阻塞的操作或调用。用户还必须知晓被调用函数导致的任何负面影响,如内核稳定性可能受到影响。

[addr] ::cpuregs [-c cpuid]

::regs 使用的格式显示为指定 CPU 设置的当前通用暂存器。

[addr] ::cpustack [-c cpuid]

为指定 CPU 输出 C 栈回溯。显示的回溯针对进入指定 CPU 或该 CPU 被调试器停止时的点。

addr[,len] ::in [-L len]
(仅适用于 x86)

addr 指定的 I/O 端口读取 len 字节。-L 选项的值(如果提供)优先于重复计数的值。读取长度必须为 1、2 或 4 字节,端口地址的对齐方式必须与长度相同。

addr[,len] ::out [-L len] value
(仅适用于 x86)

将值写入 addr 指定的 len-byte I/O 端口。-L 选项的值(如果提供)优先于重复计数的值。写入长度必须为 1、2 或 4 字节,端口地址的对齐方式必须与长度相同。

::quit [-u]
$q

导致调试器退出。使用 -u 选项时,会恢复系统,并且会卸载调试器。如果调试器是在引导时装入的,-u 选项可能无法使用。不使用 -u 选项时,SPARC 系统将退出以引导 PROM ok 提示。go 命令可用于重新进入调试器。在 x86 系统上,会显示提示来请求重新引导计算机的权限。

::step [over|out|branch]

将目标步进一个指令。可选的 over 参数用于步过子例程调用。指定了可选 out 参数时,目标程序会继续,直到从当前函数返回控制权。

仅当检测到并启用了特定于处理器的支持时,才能在 x86 系统上使用可选的 branch 参数。指定了 ::step branch 时,目标程序会继续,直到遇到下个分支指令。

在 SPARC 系统上,::step dcmd 可能无法用于步进 'ta' 指令。同样,它可能无法用于在 x86 系统上步进 'int' 指令。如果步进导致调试器无法解析的陷阱,会输出有关该影响的消息,然后步进将失败。

cpuid::switch
cpuid:x

将指定 CPU 用作代表。栈跟踪、通用暂存器转储和类似功能会将新的代表 CPU 用作数据源。完全执行控制功能可用于新的代表 CPU 上。

::term

显示当前终端类型。

addr[,len]::wp [+/-dDestT] [-rwx] [-pi] [-n count] [-c cmd]
addr[,len]:a [cmd ...]
addr[,len]:p [cmd ...]
addr[,len]:w [cmd ...]

在指定地址设置监视点,缺省情况下被解释为虚拟地址。如果使用 -p 选项,该地址被解释为物理地址。在 x86 平台上,可使用 -i 选项在 I/O 端口上设置监视点。使用 -i 选项时,该地址被解释为 I/O 端口的地址。

可通过在 dcmd 之前指定可选的重复计数来设置被监视区域的长度(以字节为单位)。如果没有显式设置长度,缺省值为一个字节。::wp dcmd 允许将监视点配置为在存在任何读取(-r 选项)、写入(-w 选项)或执行(-x 选项)访问的组合时触发。

-d-D-e-s-t-T-c-n 选项具有与用于 ::evset dcmd 时的相同意义。有关 ::evset 的说明,请参见 mdb(1):a dcmd 可在指定地址处设置读取访问监视点。:p dcmd 可在指定地址处设置执行访问监视点。:w dcmd 可在指定地址处设置写入访问监视点。:a:p:w dcmd 之后的参数会串联在一起形成回调字符串。如果此字符串包含元字符,必须引用该字符串。

属性

有关下列属性的描述,请参见 attributes(5)

属性类型
属性值
可用性
system/kernel
developer/debug/mdb
接口稳定性
Committed(已确定)

另请参见

mdb(1)boot(1M)dumpadm(1M)eeprom(1M)kernel(1M)system(4)attributes(5)

《Oracle Solaris Modular Debugger Guide》

仅适用于 SPARC

kbd(1)

附注

对可供调试器使用的内存的限制

装入调试器时,会分配可供调试器使用的内存区域,并在此时固定该区域。如果 dcmd 尝试分配超过可用量的内存,将终止这些 dcmd(如果可能)。调试器将尝试从内存不足的情况中正常恢复,但可能无法或者被强制终止系统。此约束在 32 位的 x86 系统上尤为严格。

性能影响

装入 kmdb 会对系统性能造成负面影响,因为调试器会消耗内核内存以及其他有限的系统资源。

引导到 kmdb 中以捕获 panic()

要对 SPARC 计算机上的 panic() 进行故障排除,使用 eeprom(1M) 指定系统始终在引导时装入 kmdb 可能会很有用。紧急情况后,系统会开始重新引导,从而清除控制台中的 panic 栈。通过引导到 kmdb 中,可捕获和解释 panic 栈。有关指定在引导时装入 kmdb 的示例,请参见 eeprom(1M)