<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::register</title><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="context_stp.html" title="Chapter 2. Context Functions"><link rel="prev" href="API-pstrace.html" title="function::pstrace"><link rel="next" href="API-registers-valid.html" title="function::registers_valid"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center"><span>function::register</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-pstrace.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-registers-valid.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::register"><a name="API-register"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::register —
Return the signed value of the named CPU register
</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
register:long(name:string)
</pre></div><div class="refsect1" title="Arguments"><a name="idp3027352"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
Name of the register to return
</p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp3028928"></a><h2>Description</h2><p>
Return the value of the named CPU register,
as it was saved when the current probe point was hit.
If the register is 32 bits, it is sign-extended to 64 bits.
</p><p>
For the i386 architecture, the following names are recognized.
(name1/name2 indicates that name1 and name2 are alternative names
for the same register.)
eax/ax, ebp/bp, ebx/bx, ecx/cx, edi/di, edx/dx, eflags/flags,
eip/ip, esi/si, esp/sp, orig_eax/orig_ax,
xcs/cs, xds/ds, xes/es, xfs/fs, xss/ss.
</p><p>
For the x86_64 architecture, the following names are recognized:
64-bit registers:
r8, r9, r10, r11, r12, r13, r14, r15,
rax/ax, rbp/bp, rbx/bx, rcx/cx, rdi/di, rdx/dx,
rip/ip, rsi/si, rsp/sp;
32-bit registers:
eax, ebp, ebx, ecx, edx, edi, edx, eip, esi, esp, flags/eflags,
orig_eax; segment registers: xcs/cs, xss/ss.
</p><p>
For powerpc, the following names are recognized:
r0, r1, ... r31, nip, msr, orig_gpr3, ctr, link, xer, ccr, softe, trap,
dar, dsisr, result.
</p><p>
For s390x, the following names are recognized:
r0, r1, ... r15, args, psw.mask, psw.addr, orig_gpr2, ilc, trap.
</p><p>
For AArch64, the following names are recognized:
x0, x1, ... x30, fp, lr, sp, pc, and orig_x0.
</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-pstrace.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="context_stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-registers-valid.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::pstrace</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>function::registers_valid</span></td></tr></table></div></body></html>
y~or5J ={Eeu磝Qk ᯘG{?+]ן?wM3X^歌>{7پK>on\jy R g/=fOroNVv~Y+ NGuÝHWyw[eQʨSb> >}Gmx[o[<{Ϯ_qF vM IENDB`
